Facturación asincrónica por Lotes (encolada)
TusFacturasAPP: Solución SaaS líder en facturación electrónica para empresas. Integra nuestra API y emití comprobantes por lote asincrónicos desde tu plataforma.
Last updated
TusFacturasAPP: Solución SaaS líder en facturación electrónica para empresas. Integra nuestra API y emití comprobantes por lote asincrónicos desde tu plataforma.
Last updated
TusFacturasAPP es un proveedor SaaS líder de servicios de facturación electrónica en Argentina, que permite a empresas de todos los tamaños emitir comprobantes fiscales válidos de manera rápida, segura y cumpliendo con todas las regulaciones de la AFIP.
Integra fácilmente la facturación electrónica en tu software con la API de TusFacturasAPP. Emite comprobantes fiscales válidos desde tu sistema y obtén respuestas inmediatas de la AFIP.
Te sugerimos revisar la guia de ¿Cómo empiezo? . Una vez configurada tu cuenta y creado tu CUIT+Punto de venta (PDV) en TusFacturasAPP, podrás comenzar a emitir facturas electrónicas AFIP Argentina válidas.
Comenza ya a cumplir con las regulaciones fiscales y brinda una experiencia de facturación digital eficiente a tus clientes. Solicita acceso a nuestra API de facturación electrónica.
Podes enviar a facturar comprobantes de tipo A,B,C, M y comprobantes de tipo Factura de crédito electrónica MiPyme; ya sean facturas, notas de crédito, notas de débito y hasta facturas-recibos, pero no podrás enviar comprobantes de tipo E en ésta modalidad.
¿No sabes qué tipo de comprobante debes emitir? Consultalo desde aquí
Tenés alguna duda del servicio? chequea las API FAQs, y si no encontrás lo que buscabas, contáctanos por los canales de atención que tenemos disponibles en la plataforma web www.tusfacturas.app
Al utilizar éste servicio los comprobantes que envíes quedarán en una cola de procesamiento. A medida que se van procesando, se te enviará un webhook para que puedas obtener la información generada.
La documentación de "API Facturación AFIP", para conocer cómo debe componerse el request que envíes
La documentación "Webhooks (notificaciones)" para conocer cómo funciona el servicio de notificaciones.
Distribuí tu facturación en múltiples puntos de venta, de modo que cada uno se procese en paralelo y así optimizarás la emisión de las facturas.
Cantidad estimada de comprobantes que se emiten por hora, dependiendo del día y horario: entre 600 y 900 por hora y punto de venta.
Consulta nuestra guía detallada "API Facturación AFIP" para conocer a profundidad el servicio, los requerimientos de cada solicitud y los datos específicos que debes enviar para generar nuevos comprobantes de venta. Nuestra documentación completa y ejemplos de código te facilitarán una integración rápida y eficiente de la facturación electrónica en tu sistema actual.
POST https://www.tusfacturas.app/app/api/v2/facturacion/lotes_encola
💡 El uso de éste método contabiliza como "n" request en tu suscripción, dependiendo de la cantidad de comprobantes que se facturen
Charset: UTF-8
Formato esperado: JSON
Máximo: 100 comprobantes por lote.
| Name | Type | Description |
|---|---|---|
requests | array | Lista de comprobantes a enviar , segun estructura se detalla en API Facturacion AFIP. |
usertoken | string | Tus credenciales de acceso |
apitoken | string | Tus credenciales de acceso |
apikey | string | Tus credenciales de acceso |
"requests" debe ser un array (en JSON) que contiene cada uno de los comprobantes a emitir, según se define en la documentación de "API Facturación AFIP".
La cantidad máxima de requests por lote es de 100 comprobantes, pero debes tener en cuenta que por cuestiones de seguridad, nuestra plataforma funciona limitando su tiempo de procesamiento y podes llegar a obtener una respuesta de timeout (524). En caso de recibir un 524, los requests que enviaste, seguirán siendo procesados en background, y recibirás un hook con la respuesta de éxito o error de su encolamiento.
Podes enviar en un mismo lote comprobantes de diferente tipo de comprobante. Ej: Podes enviar en el mismo lote Facturas A Y FACTURAS B.
La fecha que envíes en cada comprobante determina cuándo será enviado a procesar, por lo que puedes enviar comprobantes a la cola de procesamiento con fecha posterior a hoy.
Los request deben venir con el campo número en cero (0).
Debes enviar un "external_reference" de manera obligatoria y debería ser único. TusFacturasAPP no realiza ésta validación, por lo que si envias +1 request con el mismo external_reference, tendrás problemas de tu lado para procesar las respuestas.
Tu CUIT + PDV, debe tener una dirección de webhook definida, de manera obligatoria, ya que sin ella, no se podrán enviar a procesar los lotes y serán rechazados de manera instantánea.
No podrás enviar comprobantes de tipo E en ésta modalidad.
Al momento del envío del lote, la suscripción de tu espacio de trabajo debe encontrarse vigente, activa y con cupo disponible para emitir la cantidad de comprobante que estás enviando en el lote.
Si se detecta al menos un (1) error de validación de datos, el lote se procesará parcialmente. De aquellos comprobantes con error obtendrás la respuesta al instante, no por un webhook.
La estructura de cada "{objeto_comprobante}" debe ser acorde a los siguientes tipos de comprobante a generar:
Comprobantes de tipo Factura de crédito electrónica MiPyme
Revisa nuestra guía "API Facturación AFIP" para conocer a fondo el servicio y los requerimientos de cada solicitud.
Si enviasjsonsons un lote que no cumple con los requisitos básicos, detallados a continuación:
La cantidad de requests supera el máximo permitido.
No has enviado ningún request a procesar en el bloque de "requests"
Tu CUIT+PDV no posee una dirección de webhook válida
Ten en cuenta que el lote no se procesará, obtendrás la respuesta al instante y no se te notificará vía webhook.
Ejemplo de una llamada con 300 requests, que superan el máximo establecido:
En cambio, si existen errores en algunos requests, el lote se procesará parcialmente y se te irá notificando vía webhook de su procesamiento.
Ej: un lote con 3 requests, donde el primero no tiene una external_reference definida, puede arrojarte una respuesta al instante, de éste estilo:
y a su vez, enviarte los siguientes webhooks:
En caso que no se detecten errores tempranos en la etapa de validación de los datos enviados en el lote, obtendrás la respuesta a cada request enviado, en su mismo orden y luego de enviarte ésta información, recibirás un webhook por cada request enviado, para informarte que se ha encolado, como se explica a continuación.
Ejemplo de un lote enviado con 3 requests:
Existen 3 tipos de evento posible, para el recurso de facturación que podes recibir en ésta instancia: "encolado", "emitido" y "error". Te sugerimos conocer más sobre los webhooks, en la documentación de Webhooks (notificaciones).
| recurso | evento |
|---|---|
facturacion | encolado |
El hook de "encolado", te informa que el request ha sido aceptado para su procesamiento. Mientras un comprobante se encuentre dentro de la cola de procesamiento, puedes realizar las siguientes operaciones: Cambiar fecha del comprobante o eliminar el comprobante de la cola de procesamiento.
El JSON que recibirás será similar al siguiente ejemplo:
| recurso | evento |
|---|---|
facturacion | emitido |
El hook de "emido", te informa que el request ha sido procesado con éxito y se ha emitido el comprobante correctamente. Una vez recibido éste hook, podrás realizar una consulta avanzada por external_reference, para obtener los datos generados de éste comprobante.
El JSON que recibirás será similar al siguiente ejemplo:
| recurso | evento |
|---|---|
facturacion | error |
El hook de "error", te informa que el request ha sido procesado, pero se han detectado errores y no se podrá facturar. Si un comprobante se encuentra procesado con error dentro de la cola de procesamiento, puedes realizar las siguientes operaciones: Cambiar fecha del comprobante, re-enviar el comprobante a la cola de procesamiento o eliminar el comprobante de la cola de procesamiento.
El JSON que recibirás será similar al siguiente ejemplo y a diferencia de los anteriores, obtendrás la lista de errores detectados, dentro del campo "msg".
En caso que requieras asistencia o tengas alguna duda relacionada con tu plan API DEV, envíanos un mensaje a api@tusfacturas.app o contactanos por el chat que tenemos disponible en la web www.tusfacturas.app.
