# Berlinesa Developers

> API REST para emitir y constatar comprobantes electrónicos de ARCA/AFIP (facturas, notas de débito y crédito; locales A/B/C/M, exportación E y turismo T) sin manejar certificados ni integraciones propias con ARCA.

Convenciones clave: JSON en snake_case; montos enteros en centavos; fechas yyyy-mm-dd; autenticación con `Authorization: Bearer <JWT>` (sesión de usuario o API Client con client_credentials); errores RFC 7807 con un `code` numérico estable.

## Empezar

- [Introducción](https://dev-developers.berlinesa.com.ar/docs/index.md): Qué es la API de facturación electrónica de Berlinesa y cómo está organizada esta documentación.
- [Primeros pasos](https://dev-developers.berlinesa.com.ar/docs/primeros-pasos.md): De cero a tu primera factura electrónica con la API de Berlinesa, en modo plataforma.
- [Autenticación](https://dev-developers.berlinesa.com.ar/docs/autenticacion.md): Cómo autenticarse contra la API con una sesión de usuario o con un API Client (client_credentials).
- [Ambientes](https://dev-developers.berlinesa.com.ar/docs/ambientes.md): URLs de la API, del servidor de autenticación y de la app web de Berlinesa.
- [Recursos para IA](https://dev-developers.berlinesa.com.ar/docs/recursos-para-ia.md): llms.txt, llms-full.txt, copias en Markdown y el spec OpenAPI para usar esta documentación desde un asistente de código.

## Conceptos

- [Modos de facturación](https://dev-developers.berlinesa.com.ar/docs/conceptos/modos-de-facturacion.md): Plataforma, contador y autoservicio. Quién es dueño del certificado y en nombre de qué CUIT se factura.
- [Convenciones de la API](https://dev-developers.berlinesa.com.ar/docs/conceptos/convenciones.md): Formato de datos, montos, fechas, paginación, creación de recursos, errores y rate limiting.

## Guías

- [Emitir comprobantes](https://dev-developers.berlinesa.com.ar/docs/guias/emitir-factura.md): Facturas, notas de crédito y débito, servicios, RG 2904, exportación y turismo con POST /invoices.
- [Certificado propio (modo contador)](https://dev-developers.berlinesa.com.ar/docs/guias/certificado-propio.md): Cómo dar de alta un certificado de ARCA propio y facturar en nombre de clientes delegados.
- [Constatar comprobantes](https://dev-developers.berlinesa.com.ar/docs/guias/constatacion.md): Verificar contra ARCA que un comprobante autorizado es válido, propio o de terceros.

## Referencia

- [Catálogos por campo](https://dev-developers.berlinesa.com.ar/docs/referencia/catalogos-por-campo.md): Qué endpoint de /catalogs consultar para completar cada campo codificado de una factura.
- [Catálogo de errores](https://dev-developers.berlinesa.com.ar/docs/referencia/errores.md): Todos los códigos de error que puede devolver la API, con su status HTTP.

## Referencia de la API

- [Referencia completa en Markdown](https://dev-developers.berlinesa.com.ar/api/reference.md): todos los endpoints, parámetros, bodies, ejemplos y errores.
- [OpenAPI 3.0 (JSON)](https://dev-developers.berlinesa.com.ar/openapi/arca-invoicing.json): el spec, para generar clientes tipados.

## Optional

- [llms-full.txt](https://dev-developers.berlinesa.com.ar/llms-full.txt): todas las guías y la referencia de la API en un solo archivo.