TusFacturasAPP - API Facturación Electrónica AFIP
  • API Factura electrónica AFIP/ARCA Argentina fácil.
  • 🎯¿Cómo empiezo?
    • Autenticación
    • SDK AFIP/ARCA
  • Ejemplos API AFIP/ARCA
    • Factura A
    • Factura B
    • Factura C
    • Factura E
    • Factura MiPyme A
    • Factura MiPyme B
    • Nota de crédito A
    • Nota de crédito B
    • Nota de crédito C
    • Nota de crédito E
    • Nota de crédito MiPyme A
    • Nota de débito A
    • Nota de débito B
    • Nota de débito C
    • Nota de débito E
    • Factura A - RG5329
    • Factura A en dólares
    • Factura A con bonificaciones
    • Factura B sin especificar datos del comprador
    • Consulta por external reference
    • Consulta por tipo y número de comprobante
    • Consulta por fecha de comprobante
    • Consulta por rango numérico de comprobantes
    • ¿Debo emitir una MiPyme?
    • Estado de los servicios AFIP/ARCA
  • 📗Documentación API Facturación AFIP/ARCA
    • Referencia API AFIP ARCA
    • Facturación instantánea e individual
    • Facturación asincrónica e individual
    • Facturación instantánea por Lotes
    • Webhooks (notificaciones)
    • Notas de crédito / Notas de débito
    • Ejemplos de comprobantes
    • Comprobantes "A"
    • Comprobantes "B"
    • Comprobantes "C"
    • Comprobantes "E" de exportación
    • Comprobantes MiPyme: Factura de Crédito Electrónica FCE
    • Ejemplos con bonificaciones
    • Facturas a consumidor final, sin especificar datos
    • ¿Factura MiPyme o Factura común?
    • Comprobantes MiPyme: ¿Debo emitirla?
    • Consulta simple
    • Consulta avanzada
    • Consultar numeración de comprobantes.
    • Eliminar comprobantes encolados
    • Cambiar fecha a comprobante encolado
    • Re-enviar a procesar ventas AFIP/ARCA asincrónicas con error
    • Regenerar el archivo PDF
    • Reenviar comprobante a un cliente
    • Consultar el tope para ventas a consumidor final
    • Guía de migración a facturación asincrónico (encolado)
    • ¿Qué tipos de comprobante debo/puedo emitir?
  • 🚀¿Cómo paso a producción?
  • 🛍️API Compras
    • Compras: Eliminación de comprobantes
  • 💵Recibos de cobro y órdenes de pago
    • Ingresar pago a un comprobante emitido
    • Generar un recibo de cobro
    • Generar una orden de pago
  • 📓Cuentas corrientes de clientes
    • Consulta de Cuentas Corrientes
  • 💎Productos
    • Administrar productos
    • Consultar productos
    • Gestión de stock
  • Consultas varias a servicios AFIP/ARCA
    • Consultar las cotizaciones AFIP
    • Consultar datos de un CUIT, desde la constancia de inscripción
  • Consultas a padrones
    • Consultar las alícuotas, en el padrón ARBA sujetos recaudación
    • Consultar las alícuotas, en padrón AGIP
  • 👩‍💻Mi cuenta
    • Agregar o modificar puntos de venta (PDV)
    • Solicitar certificado de enlace con AFIP
    • Predeterminar CUIT + Punto de venta
    • Mi Cuenta - consumo
  • Reportes
    • Solicitar reporte IVA compras-ventas
  • Parámetros
    • Consulta de Países en AFIP
    • Consulta de unidades de medida AFIP
    • Consulta de CUITs País en AFIP
    • Consulta de Incoterms
    • Tablas de referencia
  • FAQs | Preguntas generales
  • FAQs | Ventas asincrónicas
  • FAQs | RG5329
  • Changelog
  • TusFacturasAPP
  • Creá tu cuenta ahora
  • Planes API
  • Ayuda
  • Contactános
  • Términos y condiciones
Powered by GitBook
On this page
  • ¿Cómo empiezo?
  • Facturación asincrónica e individual
  • ¿Cómo funciona el modo asincrónico de facturación individual?
  • Tiempos de procesamiento
  • ¿Qué dato adicional debe tener el request para ser procesado?
  • ¿Cómo generar una venta asincrónica?
  • ¿Que te retornaremos ?
  • Webhooks de respuesta
  • Hook de "encolado"
  • Hook de "emitido"
  • Hook de "error"
  • ¿Aún te quedan dudas? ¡Contactános!
  1. Documentación API Facturación AFIP/ARCA

Facturación asincrónica e individual

TusFacturasAPP: La solución SaaS líder para automatizar tu facturación electrónica. Integración API AFIP/ARCA asincrónica.

PreviousFacturación instantánea e individualNextFacturación instantánea por Lotes

Last updated 1 day ago

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/ARCA.

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.

¿Cómo empiezo?

Te sugerimos leer primero:

Facturación asincrónica e individual

¿Cómo funciona el modo asincrónico de facturación individual?

  1. Tu servidor envía el request a TusFacturasAPP y éste queda en cola de procesamiento.

  2. A medida que TusFacturasAPP va procesando de acuerdo al estado de los servicios de AFIP, se envía un webhook con la respuesta de ese procesamiento (puede ser de éxito o error)

Datos a tener en cuenta:

  • El 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.

  • Si creas abonos, tené en cuenta que no recibirás un hook por cada vez que el abono se emita, solo con la primera emisión. (funcionalidad en desarrollo)

  • Al momento del envío del request, la suscripción de tu espacio de trabajo debe encontrarse vigente, activa y con cupo de facturación disponible para emitir el comprobante (aunque no se emita hoy).

  • Si se detecta al menos un (1) error de validación de datos, no se mandará a procesar y obtendrás la respuesta al instante, no por un webhook.

Tiempos de procesamiento

Nuestros tiempos de procesamiento varían según múltiples factores:

  • El volumen de facturación programada

  • El tipo de comprobante que emitas

  • El estado de los servicios de AFIP/ARCA

Para las facturas A y B asincrónicas, procesamos hasta 144.000 facturas por tipo de comprobante y punto de venta en 24 horas. Para los demás tipos de comprobantes, el límite es de 14.000 comprobantes en 24 horas por punto de venta.

Para acelerar la facturación podrías distribuir la carga de facturación en múltiples puntos de venta. Sin embargo, no podemos garantizar que todo el volumen se emita en un solo día, por lo que recomendamos enviar la facturación con antelación para evitar inconvenientes.

¿Qué dato adicional debe tener el request para ser procesado?

 "comprobante":{
      "external_reference":"ABC123",
      ...
}

¿Cómo generar una venta asincrónica?

POST

https://www.tusfacturas.app/app/api/v2/facturacion/nuevo_encola

💡 Cada vez que utilices este método, se contará como un request en tu suscripción. Los requests se cuentan por cada método que uses.

Charset: UTF-8

Tipo de dato esperado: JSON

Request Body

Name
Type
Description

usertoken

string

Tus credenciales de acceso

apitoken

string

Tus credenciales de acceso

apikey

string

Tus credenciales de acceso

comprobante

object

cliente

object

¿Que te retornaremos ?

Si el request que enviaste posee errores de formato de los campos enviados, pero cumple con los siguientes requisitos básicos:

  • Tu CUIT/PDV tiene una dirección de webhook valida

  • Tu request cuenta con el campo "external_reference"

Ese comprobante sera rechazado y recibirás una respuesta al instante ademas de recibir un webhook con el error.

Ejemplo de un request, cuya external_reference no es válida:

JSON
{
	"error": "S",
	"errores": [
		"La external reference enviada, posee caracteres no validos.",
		"Error al crear al cliente . No se podra generar el comprobante. Revise los datos enviados."
	],
	"error_cod": [],
	"error_details": [
		{
			"code": "TFC-8002",
			"text": "La external reference enviada, posee caracteres no validos."
		},
		{
			"code": "TFC-6001",
			"text": "Error al crear al cliente . No se podra generar el comprobante. Revise los datos enviados."
		}
	],
	"external_reference": "1%'703"
}

Ejemplo del hook que recibirás:

{
	"creado": "24\/05\/2022 16:58:51",
	"evento": "error",
	"recurso": "facturacion",
	"external_reference": "1%'703",
	"intento": 1,
	"msg": ["La external reference enviada, posee caracteres no validos.", "Error al crear al cliente . No se podra generar el comprobante. Revise los datos enviados."],
	"hook_id": "xxxx"
}

Ejemplo :

{
	"error": "N",
	"errores": [],
	"error_cod": [],
	"error_details": [],
	"external_reference": "ex_rf1",
	"requiere_fec": "NO",
	"observaciones": "",
	"rta": "El comprobante  se ha guardado correctamente ",
	"cae": " ",
	"vencimiento_cae": "01\/01\/2000",
	"vencimiento_pago": "21\/03\/2022",
	"comprobante_nro": "00010-00000000",
	"comprobante_tipo": "FACTURA A",
	"afip_codigo_barras": "",
	"afip_qr": "",
	"envio_x_mail": "N",
	"envio_x_mail_direcciones": "",
	"micrositios": {
			"cliente": "",
			"descarga":""
		     },
	"comprobante_pdf_url": ""
}

Webhooks de respuesta

Existen 3 tipos de eventos posibles para el recurso de facturación que podes recibir en ésta instancia: "encolado", "emitido" y "error".

recurso
evento

facturacion

encolado

El JSON que recibirás será similar al siguiente ejemplo:

{
	"creado": "18/03/2022 15:58:11",
	"evento": "encolado",
	"recurso": "facturacion",
	"external_reference": "17032",
	"intento": 1,
	"msg": [],
	"hook_id": "xxxxx"
}
recurso
evento

facturacion

emitido

El JSON que recibirás será similar al siguiente ejemplo:

{
	"creado": "18/03/2022 15:58:11",
	"evento": "emitido",
	"recurso": "facturacion",
	"external_reference": "17032",
	"intento": 1,
	"msg": [],
	"hook_id": "xxx"
} 
recurso
evento

facturacion

error

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

{
	"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!

Te sugerimos revisar la guia de . Una vez configurada tu cuenta y creado tu CUIT+Punto de venta (PDV) en , podrás comenzar a emitir facturas electrónicas AFIP Argentina válidas.

La documentación de "", para conocer cómo debe componerse el request que envíes

La documentación "" para conocer cómo funciona el servicio de notificaciones.

Al utilizar nuestro servicio API de facturación AFIP/ARCA asincrónica e individual, los comprobantes que emitas quedarán en una cola de procesamiento de TusFacturasAPP. A medida que se van procesando, se te enviará un para que puedas obtener la información generada, de ésta manera no se traban tus procesos de facturación si los servicios de AFIP no se encuentran disponibles.

En caso que recibas una respuesta exitosa, deberás consultar el comprobante usando el método de

La fecha que envíes en el comprobante, determina cuándo será enviado a procesar, por lo que puedes enviar comprobantes a la cola de procesamiento con fecha posterior a hoy. Te sugerimos leer el apartado de "".

Tu CUIT + PDV, debe tener una definida, de manera obligatoria, ya que sin ella, no se podrán enviar a procesar los requests y serán rechazados de manera instantánea.

No podrás enviar comprobantes de en ésta modalidad.

Los request que se envíen de manera asincrónica deben contar con el campo de "external_reference" presente dentro del bloque de "comprobante" , como se visualiza en éste ejemplo de código capturado . Ej:

Consulta nuestra guía detallada "" 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.

Estructura de "comprobante" según se informa en el apartado de

Estructura de "Cliente", según se informa en el apartado de

ERROR: Error de validación de los datos enviados :

ACEPTADO: Cuando el request se ha aceptado para su procesamiento:

En caso que no se detecten errores de formato básico en la validación inicial, obtendrás la siguiente respuesta de manera instantánea, ademas de recibir un para informarte que se ha encolado, cómo se explica a continuación.

Te sugerimos conocer más sobre los webhooks, en la documentación de .

Hook de "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: o .

Hook de "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 , para obtener la información de éste comprobante generado.

Hook de "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: o .

En caso que requieras asistencia o tengas alguna duda relacionada con tu plan API DEV, envíanos un mensaje a api@tusfacturas.app o por el chat que tenemos disponible en la web .

📗
🔴
🟢
🟣
🟢
🔴
¿Cómo empiezo?
TusFacturasAPP
API de Facturación AFIP
Webhooks (notificaciones)
FAQs sobre la cola de procesamiento
webhook
consulta avanzada por external_reference
FAQs sobre la cola de procesamiento
dirección de webhook
tipo E
API Facturación AFIP
webhook
Webhooks (notificaciones)
Cambiar fecha del comprobante
eliminar el comprobante de la cola de procesamiento
Cambiar fecha del comprobante,
re-enviar el comprobante a la cola de procesamiento
eliminar el comprobante de la cola de procesamiento
contactanos
www.tusfacturas.app
"facturacion"
"facturacion"
desde aquí
SDK AFIP. TusFacturasAPP API Factura Electronica AFIP. AFIP WS
consulta avanzada por external_reference