Preguntas frecuentes
¿Cuánto cuesta usar la API?
La API está incluida en el plan Premium. No se cobra aparte ni por llamada: el plan incluye 250 comprobantes por mes, y podés ampliarlos por $12 cada uno si necesitás más. El detalle está en Precios.
Podés arrancar con la prueba gratuita de 14 días y probar la integración completa.
Podés probar con el entorno de homologación, donde los comprobantes no tienen validez fiscal y podés equivocarte sin consecuencias. Luego pasás a producción.
¿Por qué usar esta API en vez de integrarme directamente con ARCA?
Porque la parte difícil no es la primera factura: es todo lo que viene después.
Una integración propia funciona el día uno y empieza a costar el día treinta. Lo que tenés que resolver y mantener vos:
| Integración propia | Con NanoFactura | |
|---|---|---|
| Cambios de normativa | Cada resolución de ARCA es un cambio en tu código, con fecha límite | Lo actualizamos nosotros. Tu código no cambia |
| Certificados y firma | Renovar, firmar, cachear y renovar tokens de autenticación | Automático |
| Casos borde | Notas de crédito, moneda extranjera, percepciones, tributos, comprobantes asociados, cada uno con sus reglas | Un campo del JSON |
| Numeración | Llevar contadores correlativos por punto de venta y tipo, manejar concurrencia, problemas de red y de ARCA | Lo resuelve la API |
| Cortes de red | Si se corta al pedir el CAE, no sabés si el comprobante existe. Reconciliarlo es delicado y hay que hacerlo bien | Reintentás con la misma clave de idempotencia |
| Redondeo de importes | ARCA rechaza el comprobante si los totales no cierran al centavo | Los calcula la API |
| Almacenar comprobantes | Base de datos, backups, retención, y responder consultas históricas | Consulta por API o desde la app |
| Diseñar la plantilla, generar el archivo, guardarlo, servirlo | Se genera solo | |
| Envío al cliente | Servidor de correo, plantillas, entregabilidad, rebotes | Un campo del JSON. Desde la app ves los rebotes. |
Ese trabajo no se hace una vez: se mantiene para siempre, y las fechas las pone ARCA, no tu equipo. La pregunta no es si podés hacerlo —claro que podés—, es si querés que ese sea tu problema.
¿Para quién está pensada la API?
Para empresas, SaaS y sistemas que ya tienen dónde ocurre la venta y no quieren que alguien la vuelva a cargar a mano en otro lado.
Va bien si:
- Tenés un e-commerce, ERP, sistema de gestión o SaaS y querés que la factura salga sola cuando se concreta la venta.
- Facturás volumen y cargar los comprobantes a mano ya no es viable.
- Querés que tu producto facture en nombre de tus clientes, sin construir facturación electrónica desde cero.
- Necesitás que la facturación sea confiable y auditable, no un paso manual que alguien puede olvidarse.
Lo que te ahorrás: tablas nuevas en tu base de datos, pantallas de consulta, almacenamiento de PDFs, plantillas de email, y la mitad de un equipo mirando cuándo cambia la normativa.
Si en cambio facturás poco y a mano, probablemente te convenga la extensión de Chrome, que automatiza la carga en Comprobantes en Línea sin que programes nada.
¿Con qué lenguajes de programación me puedo integrar?
Con cualquiera. Es una API REST sobre HTTP con JSON: si tu lenguaje puede hacer un POST, puede facturar.
Tenemos ejemplos completos en JavaScript, PHP y Python, pero funciona igual desde C#, Java, Go, Ruby, Kotlin, Rust o lo que uses.
También desde plataformas que no son un lenguaje:
- Google Apps Script — facturar desde una hoja de cálculo.
- n8n, Make, Zapier y otras herramientas no-code: alcanza con un nodo de petición HTTP.
- Clientes como Postman o Insomnia, para probar antes de escribir nada.
No hay SDK obligatorio ni librería que instalar. Los ejemplos son eso: ejemplos.
¿Dónde veo los comprobantes generados?
De dos formas:
- Por API, con
GET /:id-empresa/invoices— con filtros por fecha, cliente, importe o tu propia referencia externa. - En la app web:
https://asistentefacturaelectronica.com/app/comprobantes/<id-empresa>
Los comprobantes que emitís por API y los que emitís desde la app aparecen en el mismo listado. El campo source te dice de dónde vino cada uno.
Si emitiste con una clave TEST_, tenés que activar la vista de homologación en el listado de la app. Sin eso sólo se muestran los comprobantes con validez fiscal, y vas a creer que la emisión no funcionó.
¿Los comprobantes tienen validez fiscal?
Sí, los emitidos con una clave PROD_. Son comprobantes electrónicos autorizados por ARCA, con su CAE, tal como si emitirías desde Comprobantes en Línea.
Los emitidos con una clave TEST_ van contra el entorno de homologación de ARCA y no tienen validez fiscal: son para probar.
¿Necesito mi propio certificado de ARCA?
Sí. El certificado digital es lo que autoriza a facturar en tu nombre y es tuyo, tramitado con tu Clave Fiscal. Es un trámite de una sola vez por entorno, y tiene validez dos años.
La app te genera el pedido de certificado y te guía en el trámite: ver Vincular tu certificado.
¿Puedo usar la API y la extensión de Chrome a la vez?
Sí. Comparten la misma cuenta, empresa y la misma suscripción.
Es habitual: la API factura las ventas del sistema, y la extensión cubre lo que se factura a mano. Tené en cuenta que ARCA define puntos de venta distintos para cada canal, es decir que tenés que crear un punto de venta del tipo webservice para facturar con la API.
¿Qué pasa si ARCA se cae?
La emisión responde 502 ARCA_CONNECTION_ERROR y el comprobante no se emite. Es transitorio: reintentá con backoff, y con la misma clave de idempotencia para no duplicar nada si el pedido llegó a pasar.
Para saber si el problema es de ARCA o tuyo, consultá GET /:id-empresa/arca/dummy: te dice si los servidores de ARCA están arriba.
¿Puedo anular una factura ya emitida?
No se puede borrar ni modificar un comprobante autorizado — eso es así por diseño fiscal, no una limitación nuestra. Lo que se hace es emitir una nota de crédito que lo compensa. Ver cómo.
¿Cuántas empresas puedo facturar con una misma cuenta?
Las que quieras, cada una con su plan. Cada empresa tiene su propio id-empresa, su certificado, sus puntos de venta y sus API Keys. Podés hacer un solo pago para todas tus empresas vinculándolas a la misma cuenta de facturación.
Una API Key opera sólo sobre la empresa que aparece en su URL. Si facturás para varias, necesitás una clave por empresa.
¿Tienen soporte?
Sí. Escribinos a [email protected].
Si tu consulta es sobre una emisión que falló, mandanos el code, el error completo y —si lo hay— el contenido de details: con eso lo resolvemos mucho más rápido.
¿No encontraste tu pregunta? Escribinos a [email protected] o empezá por Primeros pasos.