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


JSON PARA EMITIR RETENCION

* "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

* "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 NOTA DE CREDITO

* "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


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.


Preguntas Frecuentes



Sí, el sistema es accesible desde cualquier dispositivo( computadoras de escritorio, laptops, tabletas y teléfonos inteligentes).

No, para emitir comprobantes electrónicos es necesario tener la firma electrónica cargada en la plataforma como uno de los requisitos obligatorios.

Sí, el sistema de facturación electrónica de Azur está disponible las 24 horas del día para emitir comprobantes.

Sí, nuestro sistema de facturación electrónica ofrece varias opciones de integración con diversos tipos de software.



Somos el mejor Proveedor de facturación electrónica del ecuador, Autorizado por el SRI

Contamos con más de 10000 clientes a nivel nacional