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.
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?
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.
¿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.
¿No sabes qué tipo de comprobante debes emitir? Consultalo desde aquí
Tenés alguna duda del servicio? checkea las API FAQs, y si no encontrás lo que buscabas, contactanos por los canales de atención que tenemos disponibles en la plataforma web www.tusfacturas.app
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).
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 facturación por lotes asincrónica (encolada)
Es necesario leer primero, la documentación de "Facturación", para conocer cómo debe componerse cada request que envíes.
¿Cómo generar una venta por lotes instantáneos?
Consulta nuestra guía detallada "Referencia API AFIP ARCA" 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.
Charset: UTF-8
Formato esperado: JSON
Request Body
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"
"requests" debe ser un array que contiene cada uno de los comprobantes a emitir, según se define en la Referencia a la API de Facturación.
La estructura de cada "{objeto_comprobante}" debe ser acorde a los siguientes tipos de comprobante a generar, incluyendo todos sus campos:
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.
Ejemplo de JSON a enviar
{
"apitoken": "xxxx",
"apikey": "xxxx",
"usertoken": "xxxxx",
"requests": [
{objeto_comprobante},
{objeto_comprobante},
{objeto_comprobante}
]
}Ejemplo de como invocarlo desde 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);
🟢 ¿Qué te retornaremos en caso de exito?
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"
}]
}🔴 ¿Que te retornaremos en caso de error ?
Error de validación de datos / formato:
Ej: una llamada con 3 requests, donde segundo el comprobante enviado tiene un tipo de comprobante diferente.
{
"error": "S",
"errores": ["El comprobante enviado en la fila 1 (comenzando en 0) tiene un tipo de comprobante diferente."]
}🔴 Error de Procesamiento parcial:
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.
{
"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:
Mismo tipo de comprobante
Fecha (ascendente)
Número de comprobante (ascendente)
¿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 [email protected] o contactanos por el chat que tenemos disponible en la web www.tusfacturas.app.
Last updated