Recursos para IA
Si integrás la API con la ayuda de un asistente de código (Claude Code, Cursor, Copilot, ChatGPT), dale como contexto alguno de estos archivos en lugar de pegar páginas sueltas. Se regeneran en cada publicación del portal, así que siempre coinciden con la API.
| Archivo | Qué tiene | Cuándo usarlo |
|---|---|---|
/llms-full.txt | Todas las guías y la referencia completa de la API en un solo Markdown. | La opción más simple: descargalo y agregalo al contexto del asistente. |
/llms.txt | Índice en formato llmstxt.org con links a la versión Markdown de cada página. | Para herramientas que leen llms.txt y bajan solo lo que necesitan. |
/openapi/arca-invoicing.json | El spec OpenAPI 3.0. | Para generar un cliente tipado (openapi-generator, openapi-typescript, etc.) o importar en Postman/Insomnia. |
Además, cada página de guías tiene su copia en Markdown en la misma URL con .md al final. Por ejemplo, /docs/primeros-pasos.md.
Ejemplo con un asistente de código
curl -o berlinesa-api.md "https://<este portal>/llms-full.txt"
Después, en tu asistente:
Usando
berlinesa-api.md, escribí una función en TypeScript que emita una factura B por un monto en pesos, con reintento si quedaREJECTED.
Generar un cliente tipado
# TypeScript
npx openapi-typescript "https://<este portal>/openapi/arca-invoicing.json" -o src/berlinesa-api.d.ts
Tené en cuenta que el spec describe el wire format real: todo en snake_case y montos en centavos (ver Convenciones).