FAQ

How long does Hacienda take to validate a document? 30 seconds to 3 minutes under normal conditions. At month-end close it can take up to 10 minutes. The integration must be asynchronous.

What happens if Hacienda is unavailable? LX CloudPos automatically retries with backoff. The status remains procesando or error. The same document must not be reissued.

Is contingency (offline issuance) supported? Partially. Hacienda allows situacion=3 for documents issued offline. For now it must be configured manually; in the next version it will be a request field.

How are USD transactions handled? moneda: "USD" must be sent. If tipoCambio is not sent, the day’s BCCR rate is used. For transactional accuracy, it is recommended to send it explicitly.

Can the same key be used in sandbox and production? No. Production keys have the lxs_live_ prefix. For sandbox, the lxs_test_* prefix is planned (upcoming versions).

Is there an official SDK? Not officially. The examples in the corresponding section serve as reference. If an integrator publishes one, they can let us know so it can be linked from this documentation.

Can issuance be done from the end customer’s browser? Not directly: the key would be exposed in the frontend. The integrator’s backend must call LX, and the frontend should communicate only with that backend.

Do documents issued from the web POS show up via the API? Yes, they can be queried with GET /facturas/{clave}. However, they do not trigger webhooks — only those issued via the API do.

Can the customer’s email be changed after issuing? Yes. The customer must be edited in the web POS. The next PDF generated will use the new email. The issued XML does not change (it is immutable).

How long are documents kept? Indefinitely. Hacienda requires at least 5 years of retention.

Is the XML versioned? Yes. Currently v4.4. If Hacienda releases v4.5+, LX CloudPos migrates transparently and maintains compatibility with the existing integration.

Can credit notes be issued for a different amount than the original invoice? Yes. An NC can be partial — it includes only the corresponding lines or amounts.

What happens if the customer has no email? Issuance still works, but no automatic email is sent. The PDF can be downloaded and sent through another channel.

Does the API support multiple economic activities? Yes. codigoActividad must be sent with the relevant activity. If omitted, the tenant’s primary activity is used.