v1.5 · Stable
The LX CloudPos REST API
Invoices, tickets, credit and debit notes and purchase invoices filed with Costa Rica’s Ministry of Finance — with webhooks, idempotency and rate limiting built in.
Where to start
15 minutes
Quickstart
From zero to your first electronic invoice, signed and accepted by Hacienda.
Get started →
Concepts
How Hacienda works
Documents, keys, consecutive numbers, multi-tenancy and the lifecycle of a document.
Read →
Your language
Complete examples
Node.js, Python, .NET, Java, Go, PHP and Ruby — production code ready to reuse.
See examples →
Documentation by area
Fundamentals
Who this API is for, prerequisites, quickstart.
Domain concepts
Documents, key/consecutive number, multi-tenancy, lifecycle.
Authentication and security
API keys, scopes, rotation, tenant isolation.
General conventions
URLs, headers, dates, pagination, versioning.
Endpoint reference
Issue, query, download PDF/XML, resend email, void, purchase invoice.
Data model
Request and response DTOs — fields, types, validations.
Business rules
Totals, VAT, discounts, tax exemptions, multi-currency.
Reliability
Idempotency, rate limiting, retries, timeouts.
Webhooks
Configuration, HMAC, retries, dedupe, events.
Errors
HTTP status codes, domain errors, retry strategies.
Hacienda catalogs
ID types, payment conditions, currencies, CAByS.
Cookbook
Simple FE, TE, discounts, voiding, batches, multi-currency.
Operations
Testing, logging, observability, monitoring, performance.
Appendices
Glossary, FAQs, production checklist, changelog.
If you find outdated or incomplete information, please report it to info@lxsyscr.com.