API REST para Facturacion Electronica

Ponemos a su disposicion nuesta API REST para sus desarrollos e integraciones con sistemas externos (sistemas contables, crm, erp, sistemas de facturación, tiendas online, paginas web, aplicaciones), está desarrollada en PHP Laravel 7 de tipo API REST HTTP, la cual recibe un JSON para generar los comprobantes. Una vez el JSON es enviado a la plataforma en su cuenta se cargarán los comprobantes donde usted podrá ver el estado de los mismos y verificar que estén autorizados y en el caso de ser rechazados corregir el comprobante. Los métodos están disponibles solo por POST y son autenticados por la API-KEY.

Existen 7 direcciones de comunicación entre su sistema y Azur

Facturas
https://azur.com.ec/plataforma/api/v2/factura/emision
Liquidacion de Compras
https://azur.com.ec/plataforma/api/v2/liquidacion/emision
Retenciones
https://azur.com.ec/plataforma/api/v2/retencion/emision
Retenciones ATS
https://azur.com.ec/plataforma/api/v2/retencionats/emision
Notas de Crédito
https://azur.com.ec/plataforma/api/v2/credito/emision
Guías
https://azur.com.ec/plataforma/api/v2/guia/emision
Notas de Debito
https://azur.com.ec/plataforma/api/v2/debito/emision
Consultas de Estado del Comprobante
https://azur.com.ec/plataforma/api/v2/consulta/comprobante
Eliminar Comprobante
https://azur.com.ec/plataforma/api/v2/eliminar/comprobante

api_key Clave única del usuario esta clave es generada desde el sistema y controla los datos de la empresa, establecimiento, punto de emisión, ambiente (Pruebas y Producción).
ClavedeAcceso Código único que se generar por cada comprobante este mismo servirá para las consultas del estado del comprobante, el API devuelve esta clave al momento de recibir el comprobante.

La ficha técnica del SRI para facturación electrónica la puede encontrar en Enlace

JSON PARA EMITIR FACTURAS

* "manejo_interno_secuencia" (SI/NO) OPCIONAL solo es obligatorio cuando nosotros manejamos la secuencia de la factura.
* Solo Cantidad y Precio Unitario permite máximo 5 decimales el resto de valores solo deben tener máximo 2 decimales
*"pagos" Pagos no es obligatorio por defecto se selecciona Otros con utilización del sistema financiero código 20 y se genera el total, si gusta solo puede enviar solo el tipo y dejar en blanco el total para que el sistema lo calcule automáticamente
*"informacion_adicional" No es Obligatorio, pero si se envía debe de llenar el nombre y detalle, ambos campos no deben de quedar vacíos

JSON PARA EMITIR LIQUIDACION DE COMPRA

{
                    "api_key": "API_1_1_5a4492f2d5137G",
                    "codigoDoc": "03",
                    "emisor": {
                    "manejo_interno_secuencia": "NO",
                    "secuencial": "000000002",
                    "fecha_emision": "2018/01/10"
                    },
                    "proveedor": {
                    "tipo_identificacion": "04",
                    "identificacion": "0990004196001",
                    "razon_social": "CORPORACION EL ROSADO S.A.",
                    "direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
                    "telefono": "2 322555",
                    "celular": null,
                    "correo": "facturacion@e-elrosado.com"
                    },
                    "items": [
                    {
                    "codigo_principal": "900053",
                    "codigo_auxiliar": null,
                    "descripcion": "FRESSITA AMBIENTAL FRUTILLA",
                    "tipoproducto": 2,
                    "tipo_iva": 4,
                    "precio_unitario": 1.08,
                    "cantidad": 24,
                    "descuento": 0,
                    "tipo_ice": 2034,
                    "valor_ice": 2.34,
                    "tarifa_ice": 15
                    }
                    ],
                    "pagos":[
                    {
                    "tipo": "20",
                    "total": "29.03"
                    }
                    ],
                    "informacion_adicional": [
                    {
                    "nombre": "Observaciones",
                    "detalle": "4604159084 - FERRISARIATO ORELLANA"
                    }
                    ]
                    }

JSON PARA EMITIR RETENCION

{
	"api_key": "API_1_1_5a4492f2d5137G",
	"codigoDoc": "07",
	"emisor": {
                             "manejo_interno_secuencia": "NO",
		"secuencial": "000000001",
		"fecha_emision": "2018/01/27"
	},
	"proveedor": {
		"tipo_identificacion": "04",
		"identificacion": "0990004196001",
		"razon_social": "CORPORACION EL ROSADO S.A.",
		"direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"telefono": "2 322555",
		"celular": null,
		"correo": "alejandropulley@gmail.com"
	},
	"retenciones": [
		{
			"base_imponible": 300.80,
			"codigoimpuesto": 1,
			"codigo_retencion": 344,
			"porcentaje_retencion": 2,
			"valor_retenido": 6.02,
			"codigo_documento_sustento": "01",
			"numero_documento_sustento": "001001000000332",
			"fecha_documento_sustento": "2018/01/09"
		},
		{
			"base_imponible": 36.10,
			"codigoimpuesto": 2,
			"codigo_retencion": 2,
			"porcentaje_retencion": 70,
			"valor_retenido": 25.27,
			"codigo_documento_sustento": "01",
			"numero_documento_sustento": "001001000000332",
			"fecha_documento_sustento": "2018/01/09"
		}
	],
	"informacion_adicional": [
		{
			"nombre": "Observaciones",
			"detalle": "4604159084 - FERRISARIATO ORELLANA"
		}
	]
}

* "numero_documento_sustento" Obligatorio 15 dígitos en el documento sustento
* "informacion_adicional" No es Obligatorio, pero si se envía debe de llenar el nombre y detalle, ambos campos no deben de quedar vacíos

JSON PARA EMITIR RETENCIONES VERSION 2.0

{
	"api_key": "API_1_1_5a4492f2d5137G",
	"codigoDoc": "07",
	"emisor": {
		"manejo_interno_secuencia": "NO",
		"secuencial": "000000001",
		"fecha_emision": "2018/01/27"
	},
	"proveedor": {
		"tipo_identificacion": "04",
		"identificacion": "0990004196001",
		"razon_social": "CORPORACION EL ROSADO S.A.",
		"direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"telefono": "2 322555",
		"celular": null,
		"correo": "alejandropulley@gmail.com"
	},
	"sustento": {
                        "numero_autorizacion": "2310202301095107267700110018880000007601234567815",
		"codigo_sustento_tributario": "10",
		"codigo_documento_sustento": "01",
		"numero_documento_sustento": "001001000000001",
		"fecha_documento_sustento": "2022/12/01",
		"fecha_registro_contable": "2022/12/01",
		"items": [
			{
				"codigo_principal": "900053",
				"codigo_auxiliar": null,
				"descripcion": "FRESSITA AMBIENTAL FRUTILLA",
				"tipoproducto": 2,
				"tipo_iva": 4,
				"precio_unitario": 1,
				"cantidad": 1,
				"descuento": 0,
				"tipo_ice": 2034,
				"valor_ice": 2.34,
				"tarifa_ice": 15
			}
		]
	},
	"retenciones": [
		{
			"base_imponible": 500,
			"codigoimpuesto": 1,
			"codigo_retencion": 344,
			"porcentaje_retencion": 2,
			"valor_retenido": 10
		},
		{
			"base_imponible": 60,
			"codigoimpuesto": 2,
			"codigo_retencion": 2,
			"porcentaje_retencion": 70,
			"valor_retenido": 42
		}
	],
	"informacion_adicional": [
		{
			"nombre": "Observaciones",
			"detalle": "4604159084 - FERRISARIATO ORELLANA"
		}
	]
}

JSON PARA EMITIR NOTA DE CREDITO

{

"api_key": "API_1_1_5a4492f2d5137G",
	"codigoDoc": "04",
	"emisor": {
		"manejo_interno_secuencia": "NO",
		"secuencial": "000000002",
		"fecha_emision": "2018/01/10"
	},
	"comprador": {
		"tipo_identificacion": "04",
		"identificacion": "0990004196001",
		"razon_social": "CORPORACION EL ROSADO S.A.",
		"direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"telefono": "2 322555",
		"celular": null,
		"correo": "facturacion@e-elrosado.com"
	},
	"items": [
		{
			"codigo_principal": "900053",
			"codigo_auxiliar": null,
			"descripcion": "FRESSITA AMBIENTAL FRUTILLA",
			"tipoproducto": 2,
			"tipo_iva": 4,
			"precio_unitario": 1.08,
			"cantidad": 24,
			"descuento": 0,
			"tipo_ice": 2034,
			"valor_ice": 2.34
		}
	],
	"documento_modificado":
		{
			"codigo_documento_sustento": "01",
			"numero_documento_sustento": "001001000000332",
			"fecha_documento_sustento": "2018/01/09",
"motivo": "ANULACION DE FACTURAS / QUITAMOS UN PRODUCTO",
	"anula_comprobante": "SI"
		}
	,
	"informacion_adicional": [
		{
			"nombre": "Observaciones",
			"detalle": "4604159084 - FERRISARIATO ORELLANA"
		}
	]
}

* "manejo_interno_secuencia" (SI/NO) OPCIONAL solo es obligatorio cuando nosotros manejamos la secuencia de la factura.
* "informacion_adicional": No es Obligatorio, pero si se envía debe de llenar el nombre y detalle, ambos campos no deben de quedar vacíos * Solo Cantidad y Precio Unitario permite máximo 5 decimales el resto de valores solo deben tener máximo 2 decimales
* "anula_comprobante" (SI/NO) Anula comprobante es opcional solo es para control interno * "informacion_adicional" No es Obligatorio, pero si se envía debe de llenar el nombre y detalle, ambos campos no deben de quedar vacíos

JSON PARA EMITIR NOTA DE DEBITO

* "manejo_interno_secuencia" (SI/NO) OPCIONAL solo es obligatorio cuando nosotros manejamos la secuencia de la factura.
* El valor del ice y el código de ice es Opcional se debe llenar ambos cuando corresponda. * "tipo_modificacion" Tipo de modificación según tabla *"pagos" Pagos no es obligatorio por defecto se selecciona Otros con utilización del sistema financiero código 20 y se genera el total, si gusta solo puede enviar solo el tipo y dejar en blanco el total para que el sistema lo calcule automáticamente

JSON PARA EMITIR GUIAS DE REMISION

{
	"api_key": "API_1_1_5a4492f2d5137G",
	"codigoDoc": "06",
	"emisor": {
		"manejo_interno_secuencia": "NO",
		"secuencial": "000000006",
		"fecha_emision": "2018/01/28"
	},
	"transportista": {
		"tipo_identificacion": "04",
		"identificacion": "0990004196001",
		"razon_social": "CORPORACION EL ROSADO S.A.",
		"direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"telefono": "2322555",
		"celular": null,
		"correo": "alejandropulley@gmail.com",
		"placa": "tdh-0955"
	},
	"destinatario": {
		"tipo_identificacion": "04",
		"identificacion": "0990004196001",
		"razon_social": "CORPORACION EL ROSADO S.A.",
		"direccion": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"telefono": "2322555",
		"celular": null,
		"correo": "alejandropulley@gmail.com"
	},
	"traslado": {
		"fecha_inicio_transporte": "2018/01/28",
		"fecha_fin_transporte": "2018/01/28",
		"punto_partida": "Garcia Avilez",
		"direccion_destino": "AV. 9 DE OCTUBRE 729 Y BOYACA - GARCIA AVILES",
		"ruta": "gye - panamericana - cuenca",
		"motivo_traslado": "compra de productos",
		"codigo_establecimiento_destino": "001"
	},
	"documento_sustento": {
		"codigo_documento_sustento": "01",
		"numero_documento_sustento": "001001000000332",
		"fecha_emision_documento_sustento": "2018/01/28",
		"autorizacion_documento_sustento": "001001000000332",
		"documento_aduanero": "001001000000332"
	},
	"items": [
		{
			"cantidad": 1.0,
			"codigo_principal": "AX1",
			"codigo_auxiliar": null,
			"descripcion": "Mueble",
			"detalles_adicionales": [
				{
					"nombre": "Color",
					"detalle": "Rojo"
				}
			]
		}
	],
	"informacion_adicional": [
		{
			"nombre": "Observaciones",
			"detalle": "4604159084-FERRISARIATOORELLANA"
		}
	]
}

JSON PARA CONSULTA (PDF - XML)

JSON PARA ELIMINAR COMPROBANTE

Para el desarrollo de esta API se tomaron en consideración las siguiente tablas las mismas que tienen que ser revisadas para el Envió del JSON.

Tipo de productos
Codigo	Nombre
1	BIEN
2	SERVICIO

Código del tipo de Comprobante
No.	Nombre Comprobante	Codigo
1	FACTURA	01
2	LIQUIDACION DE COMPRA	03
3	NOTA DE CREDITO	04
4	NOTA DE DEBITO	05
5	GUIA DE REMISION	06
6	COMPROBANTE DE RETENCION	07

Tipo de Cliente, Sujeto Retenido o Destinatario
No.	Nombre Comprobante	Codigo
1	RUC	04
2	CEDULA	05
3	PASAPORTE	06
4	CONSUMIDOR FINAL	07
5	IDENTIFICACION DEL EXTERIOR	08
6	PLACA	09

Códigos Tipos de Impuestos
Codigo	Nombre
1	BIEN
2	SERVICIO

Códigos Tipos de Impuestos
Codigo	Nombre
IVA	2
ICE	3
IRBPNR	5

Código Tarifa del IVA
Porcentaje de IVA	Código
0%	0
5%	5
12%	2
13%	10
14%	3
15%	4
No objeto de impuesto	6
Excento de Iva	7
Iva diferenciado	8

CODIGO DE TARIFA DEL ICE * según tabla del SRI en el Manual

Códigos para Retención de Impuestos
Impuestos a Retener	Codigo
RENTA	1
IVA	2
ISD	6

Códigos Retención del IVA
Porcentaje Iva	Codigo
10%	9
20%	10
30%	1
50%	11
70%	2
100%	3
Retencion en cero 0%	7
No Procede Retencion 0%	8
Retencion de ISD 5%	4580

Código Retención A LA RENTA *sacar de la tabla del SRI en el Manual

TIPOS DE PAGOS DISPONIBLES
Codigo	Nombre
01	Sin utilización del sistema financiero (EFECTIVO)
16	Tarjetas de Debito
17	Dinero Electrónico
18	Tarjeta Prepago
19	Tarjeta de Crédito
20	Otros con Utilización del Sistema Financiero
21	Endoso de Títulos

Tipos de modificación notas de debito
Codigo	Detalle
1	Subtotal 12%
2	Subtotal 14%
3	Subtotal 0%
4	Subtotal No Objeto del IVA
5	Subtotal Exento del Iva

ESTADOS EN AZUR
Borrador	El Comprobante fue Recibido y aun no ah sido generado el XML
Generado	El Comprobante XML se generó y está a la espera que se firme
Firmado	El comprobante fue firmado y está a la espera de ser enviado al SRI
Recibido	El comprobante fue recibido por el SRI y está a la espera de ser consultado para ver si el SRI ya dio la Autorización.
Autorizado	El Comprobante fue Autorizado, Enviado el XML y PDF al Cliente Final
No Autorizado	El comprobante no fue Autorizado , en este caso se reflejara el Motivo de Rechazo
Devuelto	El comprobante no cumple con los parámetros suficientes para que el SRI lo Autorice , se reflejara el Motivo de Rechazo
Error en Firmado	Problemas con la Firma Electrónica, se reflejara el Error
En Procesamiento	El comprobante fue Aceptado por el SRI y está a la Espera de ser Autorizado en este paso puede pasar hasta 24 horas en procesar esa Autorización, pocos son los comprobantes que entran a este estado por lo general al ser Recibido lo Autoriza el SRI al Instante

Cuando un comprobante es enviado correctamente a nuestra API el sistema devolverá Caso contrario devolverá un JSON con todos los errores encontrados Error más común cuando un comprobante ya ha sido registrado

Reglas
Los consumidores finales en sus facturas no pueden pasar mas de $200 en el total
Solo se puede utilizar maximo 6 decimales para el precio y cantidad, el resto de valores solo permite 2 decimales.