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. La integración debe ser asíncrona.

¿Qué ocurre si Hacienda no está disponible? LX CloudPos reintenta automáticamente con backoff. El estado queda en procesando o error. No debe reemitirse el mismo comprobante.

¿Se soporta contingencia (emisión sin conexión a 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 se manejan las operaciones en USD? Debe enviarse moneda: "USD". Si no se envía tipoCambio, se consulta el del BCCR del día. Para precisión transaccional, se recomienda enviarlo de forma explícita.

¿Puede usarse la misma key en sandbox y producción? No. Las keys productivas tienen prefix lxs_live_. Para sandbox está previsto el prefix lxs_test_* (próximas versiones).

¿Hay SDK oficial? No oficialmente. Los ejemplos en la sección correspondiente sirven de referencia. Si un integrador publica uno, puede comunicarlo para enlazarlo desde esta documentación.

¿Puede emitirse desde el navegador del cliente final? No directamente: la key quedaría expuesta en el frontend. El backend del integrador debe llamar a LX, y el frontend debe comunicarse únicamente con ese backend.

¿Los 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.

¿Puede cambiarse el correo del cliente después de emitir? Sí. Debe editarse 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 la compatibilidad con la integración existente.

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

¿Qué ocurre si el cliente no tiene correo? La emisión funciona, pero no se envía email automático. El PDF puede descargarse y remitirse por otro medio.

¿La API soporta múltiples actividades económicas? Sí. Debe enviarse codigoActividad con la actividad relevante. Si se omite, se utiliza la actividad principal del tenant.