Documentación de API externa de EWÁ.

  2. Home
  4. Docs
  6. Documentación de API externa de EWÁ.
  8. Recepción de documentos electrónicos.
  10. Enviar facturas:

Enviar facturas:

Este endpoint permite el envío de los documentos electrónicos al Ministerio de Hacienda por medio de un proceso asincrónico o bien llamado; cola, que permite dejarlo en ejecución en dadas situaciones, Hacienda Caído y cuando la respuesta de Hacienda esté en procesando, van a quedar en cola los procesos hasta que el servidor de Hacienda devuelva una respuesta concreta la cual va ser almacenada por EWÁ.

Especificaciones:

  • receiver_data: Datos del receptor con el formato necesario para FintechCR.
  • transmitter_data: Datos del emisor con el formato necesario para FintechCR.
  • phone: Teléfono personal de 8 dígitos.
  • consecutive_number: Número de 10 dígitos.
  • id_type: Tipo de identificación (cédula). Hacienda las identifica como cédula física (01), cédula jurídica (02), DIMEX (03) y NITE (04).
  • id: Número de cédula del contribuyente, en formato de 12 dígitos con ceros a la izquierda (ejemplo: 000111111111)
  • state: Estado o Provincia del lugar de residencia.
  • postcode: Código postal de la residencia dado por Correos de Costa Rica de 5 dígitos (https://www.correos.go.cr/nosotros/codigopostal/busqueda.html)
  • resumen_factura: Resumen de totales de la factura.
  • products: Listado de productos facturados.
  • license: Provista por FintechCR.
  • domain: Dominio de la aplicación, sitio web del cliente.
  • unimedida: especificar (sp – unid – otros)
  • nota_credito: Si es nota de crédito. (True o False)
  • ticket: Si es tiquete electrónico. (True o False)
  • exportacion: Si es una factura de exportación. (True o False)
  • compra: Si es una factura de compra.  (True o False)
  • cod_actividad: Es el código de la actividad económica inscrita ante el ministerio de Hacienda, dato obtenido del Ministerio de Hacienda.
  • flag_wp: Flag interno para la obtención de la información en tiempo real, en caso de necesitar la información en tiempo real no se envía dicho valor. Nota: Hacienda en algunas ocasiones no genera una respuesta en tiempo real en el ambiente de pruebas, por lo que esta bandera es exclusiva del Sistema de producción.
  • razon: En caso de ser nota de crédito se adjunta el motivo de porque anulo la factura.

order_id: Número de orden en el Sistema del cliente, el cual puede ser usado para control cruzado de información.

En caso de ser nota de crédito

  • tipo_comprobante_nc: Tipo de comprobante de la orden a anular en la nota de crédito.
  • clave_nc: Clave generada por Hacienda, dentro de la factura electrónica a anular con la nota de crédito.
  • fecha_nc: Fecha de la nota de factura electrónica de referencia en la nota de crédito.

Notas:

Cuando nota_Crédito, compra, exportación y ticket están en false se hace referencia a factura electrónica.

Una vez procesado un documento electrónico en tiempo real (usando flag_wp), se debe de realizar el cambio en el consecutivo, esto se sabe una vez que el json de respuesta provee un valor en el campo de estado.

Licencia básica

Ejemplos de json:

Sintaxis JSON para factura electrónica:

{
	"order_id": "487",
	"receiver_data": {
		"id_type": "01",
		"id": "115340289",
		"first_name": "name",
		"last_name": "last name",
		"phone": "88888888",
		"state": "Heredia",
		"city": "heredia",
		"address1": "Heredia, centro",
		"country": "CR",
		"email": "test @test.com",
		"postcode": "40112",
		"provincia": "4",
		"canton": "01",
		"distrito": "12"
	},
	"transmitter_data": {
		"name": "name",
		"id_type": "02",
		"id": "003100888888",
		"phone": "88888888",
		"state": true,
		"city": "San Jose",
		"address1": "\"COSTA RICA\\rCOSTA RICA",
		"country": "CR",
		"email": "test@test.com",
		"postcode": "11301",
		"provincia": "1",
		"canton": "13",
		"distrito": "01"
	},
	"consecutive_number": "0000000005",
	"resumen_factura": {
		"total_serv_gravados": 0,
		"total_serv_exentos": 0,
		"total_mercancias_gravadas": 9000,
		"total_mercancias_exentas": 0,
		"total_gravado": 9000,
		"total_excento": 0,
		"total_venta": 9000,
		"total_descuentos": 0,
		"total_venta_neta": 9000,
		"total_impuesto": 1170,
		"total_comprobante": 10170,
		"codigo_moneda": "CRC",
		"tipo_cambio": 614.87
	},
	"tipo_comprobante": "01",
	"products": {
		"406": {
			"tipocod": "01",
			"codigo_cabys": "4292199010000",
			"codigo": 68,
			"partida_arancelaria": "",
			"cantidad": 1,
			"unimedida": "Unid",
			"detalle": "Producto",
			"preciounit": "9000.0",
			"montototal": 9000,
			"montodesc": 0,
			"natdesc": "",
			"subtotal": 9000,
			"tipodoc": "01",
			"numdoc": "",
			"nominsti": "",
			"fechaemision": "",
			"montoimpexo": "",
			"porccompra": "",
			"codigoimpuesto": "01",
			"codigoTarifa": "08",
			"tarifaimpuesto": 13,
			"montoimpuesto": 1170,
			"montolinea": 10170,
			"base_imponible": ""
		}
	},
	"license": "3dea3b41bd1553cc8cdc98c6",
	"domain": "dev-facturacioncliente.pantheonsite.io",
	"nota_credito": false,
	"ticket": false,
	"exportacion": false,
	"compra": false,
	"order_timestamp": 1622231424,
	"flag_wp": true,
	"cod_actividad": "924104"
}

Sintaxis JSON para Tiquete electrónico:

{  
   "order_id":"583",
   "transmitter_data":{  
      "name":"Juan Carlos Arce Cruz",
      "id_type":"01",
      "id":"000504120984",
      "phone":"20980223",
      "state":"Guanacaste",
      "city":"Liberia",
      "address1":"75 metros este del arenal country club",
      "email":"juan@hotmail.com",
      "postcode":"50803"
   },
   "consecutive_number":"0000015216",
   "resumen_factura":{  
      "total_serv_gravados":0,
      "total_serv_exentos":0,
      "total_mercancias_gravadas":1,
      "total_mercancias_exentas":1,
      "total_gravado":1,
      "total_excento":1,
      "total_venta":1,
      "total_descuentos":0,
      "total_venta_neta":1,
      "total_impuesto":0,
      "total_comprobante":1,
      "codigo_moneda":"CRC",
      "tipo_cambio":568
   },
   "products":{  
      "297":{  
         "tipocod":"01",
         "codigo":297,
         "cantidad":1,
         "unimedida":"Unid",
         "detalle":"Prueba",
         "preciounit":"1.00",
         "montototal":1,
         "montodesc":0,
         "natdesc":"",
         "subtotal":1,
         "tipodoc":"01",
         "numdoc":"",
         "nominsti":"",
         "fechaemision":"",
         "montoimpexo":"",
         "porccompra":"",
         "codigoimpuesto":"01",
         "codigoTarifa":"01",
         "tarifaimpuesto":0,
         "montoimpuesto":0,
         "montolinea":1
      }
   },
   "license":"7889ed934869f0f253d66497",
   "domain":"facturacioncliente.lndo.site",
   "nota_credito":false,
   "ticket":true
}{
	"order_id": "487",
	"receiver_data": {
		"id_type": "01",
		"id": "115340289",
		"first_name": "name",
		"last_name": "last name",
		"phone": "88888888",
		"state": "Heredia",
		"city": "heredia",
		"address1": "Heredia, centro",
		"country": "CR",
		"email": "test @test.com",
		"postcode": "40112",
		"provincia": "4",
		"canton": "01",
		"distrito": "12"
	},
	"transmitter_data": {
		"name": "name",
		"id_type": "02",
		"id": "003100888888",
		"phone": "88888888",
		"state": true,
		"city": "San Jose",
		"address1": "\"COSTA RICA\\rCOSTA RICA",
		"country": "CR",
		"email": "test@test.com",
		"postcode": "11301",
		"provincia": "1",
		"canton": "13",
		"distrito": "01"
	},
	"consecutive_number": "0000000005",
	"resumen_factura": {
		"total_serv_gravados": 0,
		"total_serv_exentos": 0,
		"total_mercancias_gravadas": 9000,
		"total_mercancias_exentas": 0,
		"total_gravado": 9000,
		"total_excento": 0,
		"total_venta": 9000,
		"total_descuentos": 0,
		"total_venta_neta": 9000,
		"total_impuesto": 1170,
		"total_comprobante": 10170,
		"codigo_moneda": "CRC",
		"tipo_cambio": 614.87
	},
	"tipo_comprobante": "01",
	"products": {
		"406": {
			"tipocod": "01",
			"codigo_cabys": "4292199010000",
			"codigo": 68,
			"partida_arancelaria": "",
			"cantidad": 1,
			"unimedida": "Unid",
			"detalle": "Producto",
			"preciounit": "9000.0",
			"montototal": 9000,
			"montodesc": 0,
			"natdesc": "",
			"subtotal": 9000,
			"tipodoc": "01",
			"numdoc": "",
			"nominsti": "",
			"fechaemision": "",
			"montoimpexo": "",
			"porccompra": "",
			"codigoimpuesto": "01",
			"codigoTarifa": "08",
			"tarifaimpuesto": 13,
			"montoimpuesto": 1170,
			"montolinea": 10170,
			"base_imponible": ""
		}
	},
	"license": "3dea3b41bd1553cc8cdc98c6",
	"domain": "dev-facturacioncliente.pantheonsite.io",
	"nota_credito": false,
	"ticket": TRUE,
	"exportacion": false,
	"compra": false,
	"order_timestamp": 1622231424,
	"flag_wp": true,
	"cod_actividad": "924104"
}
{  
   "order_id":"583",
   "transmitter_data":{  
      "name":"Juan Carlos Arce Cruz",
      "id_type":"01",
      "id":"000504120984",
      "phone":"20980223",
      "state":"Guanacaste",
      "city":"Liberia",
      "address1":"75 metros este del arenal country club",
      "email":"juan@hotmail.com",
      "postcode":"50803"
   },
   "consecutive_number":"0000015216",
   "resumen_factura":{  
      "total_serv_gravados":0,
      "total_serv_exentos":0,
      "total_mercancias_gravadas":1,
      "total_mercancias_exentas":1,
      "total_gravado":1,
      "total_excento":1,
      "total_venta":1,
      "total_descuentos":0,
      "total_venta_neta":1,
      "total_impuesto":0,
      "total_comprobante":1,
      "codigo_moneda":"CRC",
      "tipo_cambio":568
   },
   "products":{  
      "297":{  
         "tipocod":"01",
         "codigo":297,
         "cantidad":1,
         "unimedida":"Unid",
         "detalle":"Prueba",
         "preciounit":"1.00",
         "montototal":1,
         "montodesc":0,
         "natdesc":"",
         "subtotal":1,
         "tipodoc":"01",
         "numdoc":"",
         "nominsti":"",
         "fechaemision":"",
         "montoimpexo":"",
         "porccompra":"",
         "codigoimpuesto":"01",
         "codigoTarifa":"01",
         "tarifaimpuesto":0,
         "montoimpuesto":0,
         "montolinea":1
      }
   },
   "license":"7889ed934869f0f253d66497",
   "domain":"facturacioncliente.lndo.site",
   "nota_credito":false,
   "ticket":true
}

Sintaxis para nota de credito:

{
	"order_id": "487",
	"receiver_data": {
		"id_type": "01",
		"id": "115340289",
		"first_name": "name",
		"last_name": "last name",
		"phone": "88888888",
		"state": "Heredia",
		"city": "heredia",
		"address1": "Heredia, centro",
		"country": "CR",
		"email": "test @test.com",
		"postcode": "40112",
		"provincia": "4",
		"canton": "01",
		"distrito": "12"
	},
	"transmitter_data": {
		"name": "name",
		"id_type": "02",
		"id": "003100888888",
		"phone": "88888888",
		"state": true,
		"city": "San Jose",
		"address1": "\"COSTA RICA\\rCOSTA RICA",
		"country": "CR",
		"email": "test@test.com",
		"postcode": "11301",
		"provincia": "1",
		"canton": "13",
		"distrito": "01"
	},
	"consecutive_number": "0000000005",
	"resumen_factura": {
		"total_serv_gravados": 0,
		"total_serv_exentos": 0,
		"total_mercancias_gravadas": 9000,
		"total_mercancias_exentas": 0,
		"total_gravado": 9000,
		"total_excento": 0,
		"total_venta": 9000,
		"total_descuentos": 0,
		"total_venta_neta": 9000,
		"total_impuesto": 1170,
		"total_comprobante": 10170,
		"codigo_moneda": "CRC",
		"tipo_cambio": 614.87
	},
	"tipo_comprobante": "01",
	"products": {
		"406": {
			"tipocod": "01",
			"codigo_cabys": "4292199010000",
			"codigo": 68,
			"partida_arancelaria": "",
			"cantidad": 1,
			"unimedida": "Unid",
			"detalle": "Producto",
			"preciounit": "9000.0",
			"montototal": 9000,
			"montodesc": 0,
			"natdesc": "",
			"subtotal": 9000,
			"tipodoc": "01",
			"numdoc": "",
			"nominsti": "",
			"fechaemision": "",
			"montoimpexo": "",
			"porccompra": "",
			"codigoimpuesto": "01",
			"codigoTarifa": "08",
			"tarifaimpuesto": 13,
			"montoimpuesto": 1170,
			"montolinea": 10170,
			"base_imponible": ""
		}
	},
	"license": "3dea3b41bd1553cc8cdc98c6",
	"domain": "dev-facturacioncliente.pantheonsite.io",
	"nota_credito": TRUE,
	"ticket": false,
	"exportacion": false,
	"compra": false,
	"order_timestamp": 1622231424,
	"flag_wp": true,
"tipo_comprobante_nc": 01,
          	"clave_nc":  "",
          	"fecha_nc": 1624627038,
	"cod_actividad": "924104"
}

Respuesta sin el flag_wp:

Respuesta con el flag_wp:

Was this article helpful to you? Yes 1 No 1

How can we help?