# Facturación asincrónica por Lotes (encolada) {% hint style="warning" %} Éste método dejará de estar disponible a partir del 01/03/2026 {% endhint %} 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. ### ¿Qué podes hacer con la API para facturación 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.
SDK AFIP. TusFacturasAPP API Factura Electronica AFIP. AFIP WS
### ¿Cómo empiezo? Te sugerimos revisar la guia de [¿Cómo empiezo?](https://developers.tusfacturas.app/como-empiezo) . Una vez configurada tu cuenta y creado tu CUIT+Punto de venta (PDV) en [TusFacturasAPP](https://www.tusfacturas.app), 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](https://www.tusfacturas.app/quiero-probar-api-factura-electronica.html) a nuestra API de facturación electrónica. ### ¿Cómo funciona el modo asincrónico de facturación API por lote? ![](https://3289426737-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCB9rRBemGwnJNermQn-887967055%2Fuploads%2Fgit-blob-8b711e0ec3a50cc19e13acf2fcb1e9174c8d2c88%2Fimage.png?alt=media) ### ¿Qué puedo facturar con la API por lote asincró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](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/que-tipos-de-comprobante-debo-puedo-emitir)? Consultalo [desde aquí](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/que-tipos-de-comprobante-debo-puedo-emitir) Tenés alguna duda del servicio? chequea las [API FAQs](https://developers.tusfacturas.app/faqs-or-preguntas-frecuentes), 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](https://www.tusfacturas.app) ### **Facturación asincrónica por Lote** 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](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/webhooks-notificaciones) para que puedas obtener la información generada. #### Antes de comenzar, te sugerimos leer : 1. La documentación de "[API Facturación AFIP](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas)", para conocer cómo debe componerse el request que envíes 2. La documentación "[Webhooks (notificaciones)](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/webhooks-notificaciones)" para conocer cómo funciona el servicio de notificaciones. 3. [FAQs sobre la cola de procesamiento](https://developers.tusfacturas.app/faqs-or-ventas-asincronicas) {% hint style="info" %} ### Sugerencias para grandes volúmenes de facturación * 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. {% endhint %} ### ¿A dónde debes enviar el request? Consulta nuestra guía detallada "[API Facturación AFIP](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas)" 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. {% hint style="info" %} `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 envies en cada lote. Ejemplo: Si envias un lote con 5 comprobantes, descontará 5. {% endhint %} Charset: UTF-8 Formato esperado: JSON {% hint style="warning" %} Máximo: 20 comprobantes por lote. {% endhint %} #### Request Body | Name | Type | Description | | --------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | requests | array | Lista de comprobantes a enviar , segun estructura se detalla en [API Facturacion AFIP](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas). | | usertoken | string | Tus credenciales de acceso | | apitoken | string | Tus credenciales de acceso | | apikey | string | Tus credenciales de acceso | ### Estructura del bloque: "requests" "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](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas)". {% hint style="info" %} ### Datos a tener en cuenta: * **La cantidad máxima de requests por lote es de 20 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**](https://developers.tusfacturas.app/mi-cuenta/agregar-o-modificar-puntos-de-venta-pdv) 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**](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-electronica-afip-exportacion) **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. {% endhint %} La estructura de cada "{objeto\_comprobante}" debe ser acorde a los siguientes tipos de comprobante a generar: [comprobantes de tipo A](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-a-nota-de-debito-a-nota-de-credito-a) [comprobantes de tipo B](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-nota-de-debito-b-nota-de-credito-bb) [comprobantes de tipo C](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-c-nota-de-debito-c-nota-de-credito-c)[ ](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-electronica-afip-exportacion) [Comprobantes de tipo Factura de crédito electrónica MiPyme](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/api-factura-electronica-afip-factura-de-credito-electronica-mipyme-fce) Revisa nuestra guía "[API Facturación AFIP](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas)" para conocer a fondo el servicio y los requerimientos de cada solicitud. #### Ejemplo de JSON a enviar {% code title="JSON" %} ```json { "apitoken": "xxxx", "apikey": "xxxx", "usertoken": "xxxxx", "requests": [ {objeto_comprobante}, {objeto_comprobante}, {objeto_comprobante} ] } ``` {% endcode %} ### **¿Que te retornaremos ?** #### :red\_circle: ERROR: Error de validación de los datos enviados en el lote: Si envias 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: {% code title="JSON" %} ```json { "error": "S", "errores": [ "Esta enviando 300 requests, cuando el limite permitido. El lote no se procesara.", "El lote no se procesara ya que contiene errores en todos sus requests. Se enviaron a procesar: 3 requests y se aceptaron procesar: 0. " ], "error_cod": [], "error_details": [], "response": [] } ``` {% endcode %} 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: ```json { "error": "S", "errores": [ "El lote se procesara parcialmente ya que contiene errores en alguno de sus requests. Se enviaron a procesar: 3 requests y se aceptaron procesar: 2. " ], "error_cod": [], "error_details": [], "response": [ { "error": "N", "errores": [], "cae": " ", "cae_vencimiento": null, "observaciones": "", "envio_x_mail": "N", "envio_x_mail_direcciones": "", "external_reference": "M170_502", "rta": "El comprobante se ha guardado correctamente ", "vencimiento_cae": "01\/01\/2000", "vencimiento_pago": "13\/05\/2022", "comprobante_nro": "00010-00000000", "comprobante_tipo": "FACTURA B", "afip_codigo_barras": "", "afip_qr": "", "comprobante_pdf_url": "" }, { "error": "N", "errores": [], "cae": " ", "cae_vencimiento": null, "observaciones": "", "envio_x_mail": "N", "envio_x_mail_direcciones": "", "external_reference": "M170503", "rta": "El comprobante se ha guardado correctamente ", "vencimiento_cae": "01\/01\/2000", "vencimiento_pago": "11\/04\/2022", "comprobante_nro": "00010-00000000", "comprobante_tipo": "FACTURA A", "micrositios": { "cliente": "url-del-micrositio", "descarga":"url-del-micrositio" }, "afip_codigo_barras": "", "afip_qr": "", "comprobante_pdf_url": "" }, { "error": "S", "errores": [ "El request enviado en el orden 0 (comenzando en 0) incluye un comprobante con un external_reference no valido. Este request no se procesara." ], "external_reference": "% 'M17051", "rta": "Eror. No se procesara" } ] } ``` y a su vez, enviarte los siguientes webhooks: ```json { "creado": "24\/05\/2022 16:46:39", "evento": "encolado", "recurso": "facturacion", "external_reference": "M170_502", "intento": 1, "msg": [], "hook_id": "xxxx" } ``` ``` { "creado": "24\/05\/2022 16:46:39", "evento": "error", "recurso": "facturacion", "external_reference": "% 'M17051", "intento": 1, "msg": ["El request enviado en el orden 0 (comenzando en 0) incluye un comprobante con un external_reference no valido. Este request no se procesara."], "hook_id": "xxxx" } ``` ```json { "creado": "24\/05\/2022 16:46:39", "evento": "encolado", "recurso": "facturacion", "external_reference": "M170503", "intento": 1, "msg": [], "hook_id": "xxxx" } ``` ```json { "creado": "24\/05\/2022 16:47:06", "evento": "error", "recurso": "facturacion", "external_reference": "M170503", "intento": 1, "msg": [" AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.10016 - El numero o fecha del comprobante no se corresponde con el proximo a autorizar. Consultar metodo FECompUltimoAutorizado. Si necesitas ayuda, contactanos", " AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.0 - AFIP rechazo la generacion del comprobante Si necesitas ayuda, contactanos ", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1254)", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1278)"], "hook_id": "xxxx" } ``` ```json { "creado": "24\/05\/2022 16:47:10", "evento": "error", "recurso": "facturacion", "external_reference": "M170_502", "intento": 1, "msg": [" AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.10016 - El numero o fecha del comprobante no se corresponde con el proximo a autorizar. Consultar metodo FECompUltimoAutorizado. Si necesitas ayuda, contactanos", " AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.0 - AFIP rechazo la generacion del comprobante Si necesitas ayuda, contactanos", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1254)", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1278)"], "hook_id": "xxxx" } ``` #### :green\_circle: ACEPTADO: Cuando el lote se ha aceptado para su procesamiento: 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](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/webhooks-notificaciones) por cada request enviado, para informarte que se ha encolado, como se explica a continuación. Ejemplo de un lote enviado con 3 requests: ```json { "error": "N", "errores": [], "response": [ { "error": "N", "errores": [], "cae": " ", "cae_vencimiento": null, "observaciones": "", "envio_x_mail": "N", "envio_x_mail_direcciones": "", "external_reference": 17032, "rta": "El comprobante se ha guardado correctamente ", "vencimiento_cae": "01\/01\/2000", "vencimiento_pago": "16\/03\/2022", "comprobante_nro": "00010-00000000", "comprobante_tipo": "FACTURA A", "afip_codigo_barras": "", "micrositios": { "cliente": "url-del-micrositio", "descarga":"url-del-micrositio" }, "afip_qr": "", "comprobante_pdf_url": "" }, { "error": "N", "errores": [], "cae": " ", "cae_vencimiento": null, "observaciones": "", "envio_x_mail": "N", "envio_x_mail_direcciones": "", "external_reference": "1453_01", "rta": "El comprobante se ha guardado correctamente ", "vencimiento_cae": "01\/01\/2000", "vencimiento_pago": "18\/03\/2022", "comprobante_nro": "00010-00000000", "comprobante_tipo": "FACTURA B", "micrositios": { "cliente": "url-del-micrositio", "descarga":"url-del-micrositio" }, "afip_codigo_barras": "", "afip_qr": "", "comprobante_pdf_url": "" }, { "error": "N", "errores": [], "cae": " ", "cae_vencimiento": null, "observaciones": "", "envio_x_mail": "N", "envio_x_mail_direcciones": "", "external_reference": "1453_02", "rta": "El comprobante se ha guardado correctamente ", "vencimiento_cae": "01\/01\/2000", "vencimiento_pago": "18\/03\/2022", "comprobante_nro": "00010-00000000", "comprobante_tipo": "FACTURA A", "micrositios": { "cliente": "url-del-micrositio", "descarga":"url-del-micrositio" }, "afip_codigo_barras": "", "afip_qr": "", "comprobante_pdf_url": "" } ] } ``` ## Webhooks de respuesta 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)](https://developers.tusfacturas.app/api-factura-electronica-afip-facturacion-ventas/webhooks-notificaciones). ### :purple\_circle: Hook de "encolado" | 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](https://developers.tusfacturas.app/web-services-afip-api-arca/cambiar-fecha-a-comprobante-encolado) o [eliminar el comprobante de la cola de procesamiento](https://developers.tusfacturas.app/web-services-afip-api-arca/eliminar-comprobantes-encolados). El JSON que recibirás será similar al siguiente ejemplo: ```json { "creado": "18/03/2022 15:58:11", "evento": "encolado", "recurso": "facturacion", "external_reference": "17032", "intento": 1, "msg": [], "hook_id": "xxxxx" } ``` ### :green\_circle: Hook de "emitido" | 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](https://developers.tusfacturas.app/consulta-avanzada#como-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: ```json { "creado": "18/03/2022 15:58:11", "evento": "emitido", "recurso": "facturacion", "external_reference": "17032", "intento": 1, "msg": [], "hook_id": "xxx" } ``` ### :red\_circle: Hook de "error" | 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,](https://developers.tusfacturas.app/web-services-afip-api-arca/cambiar-fecha-a-comprobante-encolado) [re-enviar el comprobante a la cola de procesamiento](https://developers.tusfacturas.app/web-services-afip-api-arca/reenvio-de-comprobantes-encolados-con-error) o [eliminar el comprobante de la cola de procesamiento](https://developers.tusfacturas.app/web-services-afip-api-arca/eliminar-comprobantes-encolados). 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". ```json { "creado": "18/03/2022 15:58:11", "evento": "error", "recurso": "facturacion", "external_reference": "17032", "intento": 1, "msg": [ " AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.0 - AFIP rechazo la generacion del comprobante Si necesitas ayuda, contactanos en hola@tusfacturas.app", " AFIP Factura electronica, informa el siguiente error: Cod. Error: #6661145.10036 - El campo FchVtoPago no puede ser anterior a la fecha del comprobante. Si necesitas ayuda, contactanos en hola@tusfacturas.app", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1254)", "AFIP No devolvio el CAE asociado. (Cod. Error #6661141.S1278)" ], "hook_id": "xxx" } ``` ### ¿Aún te quedan dudas? ¡Contactános! En caso que requieras asistencia o tengas alguna duda relacionada con tu plan API DEV, envíanos un mensaje a o [contactanos](https://www.tusfacturas.app/contacto.html) por el chat que tenemos disponible en la web [www.tusfacturas.app](https://www.tusfacturas.app/quiero-probar-api-factura-electronica.html).