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
  • ¿Qué podes hacer con la API para facturación AFIP?
  • ¿Cómo empiezo?
  • ¿Qué puedo facturar por lote?
  • Facturación instantánea por Lote
  • ¿Cómo generar una venta por lotes instantáneos?
  • ¿Qué te retornaremos en caso de exito?
  • ¿Que te retornaremos en caso de error ?
  • FAQs
  • ¿Aún te quedan dudas? ¡Contactános!
  1. Documentación API Facturación AFIP/ARCA

Facturación instantánea por Lotes

TusFacturasAPP: Solución SaaS líder en facturación electrónica para empresas. Integra nuestra API y emití comprobantes por lote desde tu plataforma.

PreviousFacturación asincrónica e individualNextWebhooks (notificaciones)

Last updated 7 months 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.

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

¿Cómo empiezo?

¿Qué puedo facturar por lote?

Podes enviar a facturar comprobantes de tipo A,B,C y M; ya sean facturas, notas de crédito, notas de débito y hasta facturas-recibos. No podrás enviar comprobantes de tipo E ni de Factura de crédito electrónica (FEC) en ésta modalidad.

Facturación instantánea por Lote

Al utilizar éste servicio, los comprobantes que emitas impactarán de inmediato en nuestra plataforma y obtendrás la respuesta al instante, ya que utiliza el servicio de facturación por lotes de AFIP (siempre y cuando los servicios de dicho organismo se encuentren funcionando).

¿Cómo generar una venta por lotes instantáneos?

POST https://www.tusfacturas.app/app/api/v2/facturacion/lotes

💡 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

Request Body

Name
Type
Description

requests

array

Según estructura de de cada item (detallado abajo).

usertoken

string

Tus credenciales de acceso

apitoken

string

Tus credenciales de acceso

apikey

string

Tus credenciales de acceso

Estructura del bloque: "requests"

Datos a tener en cuenta

  • Todos los requests de ésta llamada, deben ser del mismo tipo de comprobante. Ej: todos deben ser FACTURA A

  • Los request deben venir ordenados por número ascendente, de la misma manera que si los enviarás a procesar uno por uno.

  • Si se detecta al menos un (1) error de validación de datos de nuestro lado, el lote no se mandará a procesar.

La estructura de cada "{objeto_comprobante}" debe ser acorde a los siguientes tipos de comprobante a generar:

Ejemplo de JSON a enviar

JSON
{
	"apitoken": "xxxx",
	"apikey": "xxxx",
	"usertoken": "xxxxx",
	"requests": [
			{objeto_comprobante}, 
			{objeto_comprobante}, 
			{objeto_comprobante}
		    ]
}

Ejemplo de como invocarlo desde PHP

PHP
// ENVIO REQUEST
$url ="https://www.tusfacturas.app/api/v2/facturacion/lotes" ;

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_POSTFIELDS,  json_encode($facturacion_json) );
curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

$json_rta_curl =  json_decode(  curl_exec($ch) ) ;  
curl_close($ch);
​

Ej: una llamada con 2 requests.


{
"error": "N",
"errores": [],
"response": [
   {
    "error": "N",
    "errores": [],
    "response": [{
        "error": "N",
        "errores": [],
        "cae": "68466696512853 ",
        "comprobante_nro": "00003-00000074",
        "cae_vencimiento": "26\/11\/2018",
        "observaciones": "AFIP genero el comprobante pero lo ha marcado como observado por los siguientes motivos: Observacion: Factura individual, DocTipo: 80, DocNro 22222222222 no se encuentra inscripto en condicion ACTIVA en el impuesto (IVA). [ codigo: 10063 ]. Dichas observaciones no requieren accion de su parte.",
        "envio_x_mail": "N",
        "envio_x_mail_direcciones": "",
        "rta": "El comprobante FACTURA A 00003-00000074 (XXXXXX) se ha guardado correctamente ",
        "vencimiento_cae": "26\/11\/2018",
        "vencimiento_pago": "16\/11\/2018",
        "comprobante_tipo": "FACTURA A",
        "afip_codigo_barras": "111111111110010000368466696512853201811262 ",
        "comprobante_pdf_url": "https:\/\/www.dominio.com\/00000074.pdf"
    }, {
        "error": "N",
        "errores": [],
        "cae": "68466696512866 ",
        "comprobante_nro": "00003-00000075",
        "cae_vencimiento": "26\/11\/2018",
        "observaciones": "AFIP genero el comprobante pero lo ha marcado como observado por los siguientes motivos: Observacion: Factura individual, DocTipo: 80, DocNro 22222222222 no se encuentra inscripto en condicion ACTIVA en el impuesto (IVA). [ codigo: 10063 ]. Dichas observaciones no requieren accion de su parte.",
        "envio_x_mail": "N",
        "envio_x_mail_direcciones": "",
        "rta": "El comprobante FACTURA A 00003-00000075 (XXXXXX) se ha guardado correctamente ",
        "vencimiento_cae": "26\/11\/2018",
        "vencimiento_pago": "16\/11\/2018",
        "comprobante_tipo": "FACTURA A",
        "afip_codigo_barras": "111111111110010000368466696512866201811266 ",
        "comprobante_pdf_url": "https:\/\/www.dominio.com\/00000075.pdf"
    }]
}

Error de validación de datos / formato:

Ej: una llamada con 3 requests, donde segundo el comprobante enviado tiene un tipo de comprobante diferente.

JSON
{
    "error": "S",
    "errores": ["El comprobante enviado en la fila 1 (comenzando en 0) tiene un tipo de comprobante diferente."]
}

En el caso que se envíe a AFIP el lote a procesar y un comprobante venga rechazado, todos los comprobantes subsiguientes del lote, vendrán rechazados. Ésta funcionalidad está determinada por AFIP.

JSON
 {
    "error": "S",
    "errores": [],
    "response": [{
        "error": "N",
        "errores": [],
        "cae": "68466696512853 ",
        "comprobante_nro": "00003-00000074",
        "cae_vencimiento": "26\/11\/2018",
        "observaciones": "AFIP genero el comprobante pero lo ha marcado como observado por los siguientes motivos: Observacion: Factura individual, DocTipo: 80, DocNro 22222222222 no se encuentra inscripto en condicion ACTIVA en el impuesto (IVA). [ codigo: 10063 ]. Dichas observaciones no requieren accion de su parte.",
        "envio_x_mail": "N",
        "envio_x_mail_direcciones": "",
        "rta": "El comprobante FACTURA A 00003-00000074 (XXXXXX) se ha guardado correctamente ",
        "vencimiento_cae": "26\/11\/2018",
        "vencimiento_pago": "16\/11\/2018",
        "comprobante_tipo": "FACTURA A",
        "afip_codigo_barras": "111111111110010000368466696512853201811262 ",
        "comprobante_pdf_url": "https:\/\/www.dominio.com\/074.pdf",
        "comprobante_ticket_url": "https://www.dominio.com/url",
           "micrositios": {
			"cliente": "url-del-micrositio",
			"descarga":"url-del-micrositio"
		     },
        "external_reference":"AAAA"
    }, {
        "error": "S",
        "errores": [" AFIP Factura electronica, rechazo el comprobante - ERROR: AFIP rechazo la generacion del comprobante Cod: 0", " AFIP Factura electronica, rechazo el comprobante - ERROR: El campo FchServDesde no puede ser posterior al campo FchServHasta. Cod: 10032"],
        "cae": "",
        "comprobante_nro": "00003-00000082",
        "external_reference":"ABC124",
        "cae_vencimiento": "",
        "observaciones": "",
        "envio_x_mail": "",
        "envio_x_mail_direcciones": ""
    }, {
        "error": "S",
        "errores": [" AFIP Factura electronica, rechazo el comprobante - ERROR: AFIP rechazo la generacion del comprobante Cod: 0"],
        "cae": "",
        "comprobante_nro": "00003-00000083",
        "external_reference":"ABC125",
        "cae_vencimiento": "",
        "observaciones": "",
        "envio_x_mail": "",
        "envio_x_mail_direcciones": ""
    }]
}

FAQs

Si falla una emisión del comprobante de un lote, ¿se realiza un rollback de las emitidas hasta el momento en ese lote? ¿Se emite hasta dicha factura? ¿Saltea el comprobante y continúa con el siguiente?

No se realiza rollback, ya que se utiliza el método por lotes provisto por AFIP. Si un comprobante tiene error, ese comprobante y los siguientes vendrán rechazados.

¿Hay una reducción de tiempo considerable al emitir los comprobantes de esta forma?

Si.

¿Puedo enviar la información sin algún criterio de ordenamiento?

No, los comprobantes deben ser enviados bajo el criterio de:

  1. Mismo tipo de comprobante

  2. Fecha (ascendente)

  3. Número de comprobante (ascendente)

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

Comenza ya a cumplir con las regulaciones fiscales y brinda una experiencia de facturación digital eficiente a tus clientes. a nuestra API de facturación electrónica.

¿No sabes qué ? Consultalo

Tenés alguna duda del servicio? checkea las , y si no encontrás lo que buscabas, contactanos por los canales de atención que tenemos disponibles en la plataforma web

Es importante que controles los errores, dado que los servicios de AFIP se caen muy seguido y según funcionen sus servicios, la generación de un comprobante puede llegar a demorar hasta 1,30 minutos 😰. Para evitar éste tipo de problemas, te sugerimos utilizar la

Es necesario leer primero, la documentación de "", para conocer cómo debe componerse cada request que envíes.

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.

"requests debe ser un array, que contiene cada uno de los comprobantes a emitir, según se define en la documentación de "".

La cantidad máxima de requests (por lote) debe ser de 20, pero debes tener en cuenta que por cuestiones de seguridad, nuestra plataforma funciona limitando su tiempo de procesamiento y según funcionen los servicios de AFIP, puedes obtener una respuesta de timeout (524). En caso de recibir un 524, ten en cuenta que los comprobantes que enviaste, seguirán siendo procesados en background, pero no recibirás la respuesta. Te sugerimos utilizar la modalidad de para evitar éste tipo de errores.

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

Revisa nuestra guía "" para conocer a fondo el servicio y los requerimientos de cada solicitud.

¿Qué te retornaremos en caso de exito?

¿Que te retornaremos en caso de error ?

Error de Procesamiento parcial:

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
Solicita acceso
tipo de comprobante debes emitir
desde aquí
API FAQs
www.tusfacturas.app
facturación por lotes asincrónica (encolada)
Facturación
API Facturación AFIP
Facturación
Facturación encolada por lotes
tipo E
Factura de crédito electrónica (FEC)
comprobantes de tipo A
comprobantes de tipo B
comprobantes de tipo C
Comprobantes de tipo Factura de crédito electrónica MiPyme
API Facturación AFIP
contactanos
www.tusfacturas.app
TusFacturasAPP API Factura Electronica AFIP. SDK AFIP