Cómo está organizada esta documentación

Esta guía está estructurada en 15 partes:

1. Fundamentos — qué es la API y cómo empezar en 15 minutos.
2. Conceptos del dominio — qué es un comprobante electrónico y cómo funciona Hacienda CR.
3. Autenticación y seguridad — API keys, scopes, rotación.
4. Convenciones generales — URLs, headers, fechas, paginación.
5. Referencia de endpoints — cada endpoint con todos sus detalles.
6. Modelo de datos — todos los DTOs campo por campo.
7. Reglas de negocio — cálculos de IVA, descuentos, exoneraciones.
8. Confiabilidad — idempotencia, rate limit, reintentos.
9. Webhooks — recepción de estado de Hacienda.
10. Errores — referencia completa de errores.
11. Catálogos Hacienda — todos los códigos oficiales.
12. Cookbook — recetas para casos comunes.
13. Ejemplos completos por lenguaje — Node, Python, C#, PHP, Go, Ruby.
14. Operación — testing, observabilidad, migración.
15. Apéndices — glosario, FAQ, changelog, soporte.

📖 Cómo leerla:

• Primera vez: lee la Parte I y salta al Quickstart; luego revisa la sección de webhooks.
• Ya integrando: usa la tabla de contenidos y busca el endpoint o concepto específico.
• Debugging: ve directo a la referencia de errores y a Troubleshooting.