How this documentation is organized

This guide is structured into 15 parts:

1. Fundamentals — what the API is and how to get started in 15 minutes.
2. Domain concepts — what an electronic tax document (comprobante electrónico) is and how Hacienda CR (Costa Rica’s tax authority) works.
3. Authentication and security — API keys, scopes, rotation.
4. General conventions — URLs, headers, dates, pagination.
5. Endpoint reference — every endpoint with full detail.
6. Data model — every DTO, field by field.
7. Business rules — VAT calculations, discounts, tax exemptions.
8. Reliability — idempotency, rate limiting, retries.
9. Webhooks — receiving status updates from Hacienda.
10. Errors — complete error reference.
11. Hacienda catalogs — all official codes.
12. Cookbook — recipes for common cases.
13. Complete examples by language — Node, Python, C#, PHP, Go, Ruby.
14. Operations — testing, observability, migration.
15. Appendices — glossary, FAQ, changelog, support.

How to read it:

• First read: read Part I and continue with the Quickstart; afterward, review the webhooks section.
• Ongoing integration: use the table of contents to find the specific endpoint or concept.
• Debugging: go directly to the error reference and Troubleshooting.