FAQ

¿Cuánto tarda Hacienda en validar un comprobante? 30 segundos a 3 minutos en condiciones normales. En cierre de mes puede llegar a 10 min. Tu integración debe ser asíncrona.

¿Qué pasa si Hacienda está caído? LX CloudPos reintenta automáticamente con backoff. El estado queda en procesando o error. No reemitas el mismo comprobante.

¿Soportan contingencia (emisión sin internet)? Parcialmente. Hacienda permite situacion=3 para comprobantes emitidos offline. Por ahora se debe configurar manualmente; en la próxima versión será un campo del request.

¿Cómo manejo USD? Envía moneda: "USD". Si no envías tipoCambio, consultamos el BCCR del día. Para precisión transaccional, envíalo tú.

¿Puedo usar la misma key en sandbox y producción? No. Keys productivas tienen prefix lxs_live_. Para sandbox planeamos lxs_test_* (próximas versiones).

¿Hay SDK oficial? No oficialmente. Los ejemplos en la sección correspondiente sirven de referencia. Si construyes uno público, avísanos para enlazarlo.

¿Puedo emitir desde el navegador del cliente final? No directamente — la key viviría en el frontend, vulnerable. Tu backend debe llamar a LX, el frontend habla con tu backend.

¿Mis comprobantes emitidos desde el POS web aparecen vía API? Sí, son consultables con GET /facturas/{clave}. Sin embargo, no disparan webhooks — solo los emitidos vía API lo hacen.

¿Puedo cambiar el correo del cliente después de emitir? Sí, edita el cliente en el POS web. El próximo PDF generado usará el nuevo correo. El XML emitido no cambia (es inmutable).

¿Cuánto tiempo se guardan los comprobantes? Indefinidamente. Hacienda exige al menos 5 años de retención.

¿Hay versionado del XML? Sí. Actualmente v4.4. Si Hacienda libera v4.5+, LX CloudPos migra transparentemente y mantiene compatibilidad con tu integración.

¿Puedo emitir notas de crédito por monto distinto a la factura original? Sí. Una NC puede ser parcial — incluye solo las líneas o montos correspondientes.

¿Qué pasa si el cliente no tiene correo? La emisión funciona, pero no se envía email automático. Puedes descargar el PDF y enviarlo por otro medio.

¿La API soporta múltiples actividades económicas? Sí. Envía codigoActividad con la actividad relevante. Si no lo envías, usamos la actividad principal del tenant.