Introducción
La API de Berlinesa emite y constata comprobantes electrónicos de ARCA/AFIP: facturas, notas de débito y notas de crédito, en sus variantes local (letras A, B, C y M), de exportación (E) y de turismo (T).
Es una API REST con JSON. Declarás qué comprobante querés emitir con letter y kind en POST /invoices, y la API resuelve toda la comunicación con ARCA.
Qué te resuelve
- Sin certificados de tu lado. En el modo por defecto, tu usuario le delega Facturación Electrónica al CUIT de la plataforma en ARCA y listo: no generás claves, CSR ni certificados.
- Sin integraciones propias con ARCA. La autenticación contra ARCA y la numeración de comprobantes las maneja la API.
- Un solo formato para todos los comprobantes. Local, exportación y turismo usan el mismo endpoint y el mismo shape de respuesta.
- Reintentos y constatación. Un comprobante rechazado se reintenta con un solo request, y cualquier comprobante autorizado (incluso uno emitido fuera de Berlinesa) se puede constatar contra ARCA.
- PDF listo para entregar.
GET /invoices/{id}/pdfdevuelve el comprobante con su código QR.
Cómo está organizada esta documentación
| Sección | Para qué |
|---|---|
| Primeros pasos | De cero a tu primera factura. |
| Autenticación | Cómo conseguir un token: sesión de usuario o API Client. |
| Ambientes | URLs de la API y del servidor de autenticación. |
| Conceptos | Modos de facturación y convenciones de la API (snake_case, paginación, errores, montos). |
| Guías | Paso a paso de los flujos más comunes. |
| Referencia de la API | Todos los endpoints, con schemas y ejemplos. |
| Recursos para IA | llms.txt, OpenAPI y cómo usar esta documentación desde un asistente de código. |