Configuración SUNAT (paso a producción): antes de empezar
Deja la empresa lista para emitir comprobantes electrónicos en producción (con validez legal ante SUNAT). Todo es solo para administradores.
Paso a paso
- Subir el certificado digital (Subir certificado digital): archivo
.pfx/.p12y su contraseña. Se valida que la contraseña lo abra, que esté vigente y que sea del RUC de la empresa. Con PSE no hace falta: firma el proveedor. - Configurar el modo de envío y las credenciales:
- Directo a SUNAT (
soap_send_id = 01): usuario secundario SOL (RUC + usuario) y su clave (Configurar envío directo a SUNAT). - OSE (
02/04): usuario, clave y URL del OSE (Configurar envío por OSE). - PSE: proveedor, usuario y contraseña (Proveedores PSE y Configurar PSE).
- Directo a SUNAT (
- Revisar
ready_for_production(Ver configuración SUNAT):ok: trueymissing: []. Atiende tambiénwarnings(certificado por vencer, documentos de prueba creados en demo). - Probar la conexión (Probar conexión): valida el certificado y pide tokens a SUNAT/PSE sin enviar comprobantes.
- Pasar a producción (Pasar a producción) con
"confirm_production": true. Si algo falta responde409con la listamissing.
Seguridad
- Usa un usuario administrador dedicado para la integración y guarda su token en un lugar seguro: con él se cambia a dónde y con qué credenciales se envían los comprobantes.
- Los secretos son de solo escritura: claves SOL, OSE y PSE, Client Secret y el certificado nunca se devuelven; la respuesta solo indica si existen (
has_sol_password,has_password,has_certificate...). - Cada cambio queda auditado (usuario, fecha, IP y campos modificados, sin valores secretos).
- Si
editableesfalse, el proveedor del sistema bloqueó estos cambios para tu empresa: entorno, modo de envío, credenciales SOL/OSE y certificado responden403. Solicítalo a tu proveedor.
Al pasar a producción
- Los comprobantes que emitas desde ese momento se envían a SUNAT (u OSE/PSE) con validez legal: anularlos requiere comunicaciones de baja o notas de crédito.
- Los documentos creados en demo no se envían a producción: bórralos antes para evitar conflictos de numeración (
warnings→demo_documents). - Estando en producción no se acepta un cambio que deje a la empresa sin poder emitir (quitar el certificado, pasar a OSE sin URL, desactivar el PSE sin certificado): responde
409. - Volver a demo también es explícito (
"confirm_demo": true).
Vencimiento del certificado
- El certificado tiene fecha de vencimiento (
certificate.valid_to,days_to_expire). Vencido, no se puede emitir. - Desde 30 días antes aparece el aviso
certificate_expiring. Renueva con tu entidad certificadora y súbelo con Subir certificado digital (reemplaza al actual sin pasar por demo).