Pase a producción

Tu integración ya emite bien en el modo pruebas. Para que tus comprobantes valgan ante SUNAT, la empresa tiene que estar en producción y tu sistema tiene que usar su clave real. Todo se configura en el sistema, en Configuración › Empresa › Datos y facturación SUNAT, y cada credencial tiene su botón Probar conexión.

1. La empresa en SUNAT

En Entorno y envío a SUNAT elige el entorno Producción y por dónde salen tus comprobantes:

Envío	Qué necesitas
Directo a SUNAT (lo más común)	Certificado digital y usuario secundario SOL
OSE	Certificado digital, usuario secundario SOL / OSE y la URL del OSE
PSE	Un proveedor (PSE) firma y envía por ti: no necesitas certificado ni usuario SOL

Certificado digital

• Un archivo .pfx con su clave privada y su contraseña, emitido a nombre de tu RUC.
• Súbelo en Configuración › Empresa › Certificado. Sin él, la API responde 422 certificado_faltante al emitir.
• Anota su fecha de vencimiento: un certificado vencido detiene la emisión.

Usuario secundario SOL

• Créalo en SUNAT Operaciones en Línea con tu Clave SOL, con el perfil para emitir comprobantes electrónicos.
• En el sistema escribes ese usuario y su clave, en Usuario secundario SOL.
• Usa un usuario secundario, no el principal (SUNAT responde 0112). Si le falta el perfil de emisión, 0111; si la clave está mal, 0102 a 0104. Ver los errores de SUNAT.

Credenciales de guías de remisión (GRE)

Solo si emites guías. La API de guías de SUNAT pide dos cosas:

• un usuario secundario SOL con su clave (aquí va como RUC + usuario, por ejemplo 20123456789MIUSUARIO);
• un Client ID y su Client secret, que creas en SUNAT Operaciones en Línea › Empresas › Credenciales de API SUNAT.

Se guardan en Guías de remisión electrónicas (GRE), en la misma pantalla. Si usas un PSE, él también puede enviar tus guías.

Ficha RUC y régimen

Toda empresa nueva emite recién cuando su Ficha RUC queda verificada (Configuración › Empresa › Régimen tributario): así nadie emite lo que SUNAT no le permite a su régimen. Mientras tanto la API responde 422 ficha_ruc_pendiente. Un contribuyente del Nuevo RUS no emite facturas (regimen_no_permite).

2. Tu sistema

1. Crea la clave real en Configuración › Sistema › Integraciones › API: sfp_live_…, con solo los alcances que usas y, si quieres, un local fijo.
2. Cambia la dirección de https://pruebas.sistemafacturacionperu.com/api/v1 a https://<tu-subdominio>.sistemafacturacionperu.com/api/v1.
3. Revisa las series de producción con GET /establecimientos: pueden no ser las mismas que en pruebas.
4. Si usas webhooks, crea el webhook de producción con la clave real (los de pruebas solo avisan de lo de pruebas) y guarda su secreto whsec_….
5. Llama a GET /yo y comprueba "modo": "produccion" y "sunat": "produccion".

Lista de verificación

• La empresa está en el Plan PRO o Empresa (o conecta con el botón en el Básico, solo para emitir).
• Entorno Producción y envío elegido (Directo a SUNAT, OSE o PSE).
• Certificado digital subido y vigente (si no usas PSE).
• Usuario secundario SOL con perfil de emisión y su clave, probados con Probar conexión.
• Credenciales de guías (usuario SOL, Client ID y Client secret), si emites guías.
• Ficha RUC verificada.
• Clave sfp_live_ con los alcances justos, guardada en una variable de entorno.
• Dirección de producción y series de producción en tu sistema.
• Idempotency-Key en cada emisión, guardada junto a tu venta.
• Webhook de producción creado y firma verificada (o consulta periódica del estado).
• Manejo de errores por code, reintentos con espera para 429 y 5xx.
• Primera factura real emitida y revisada: estado aceptado, PDF y CDR descargados.

Después del pase

• Mira el Registro de llamadas los primeros días (Configuración › Sistema › Integraciones › API › Registro): ahí ves cada llamada con su resultado y, en los errores, lo que enviaste (sin contraseñas ni claves).
• Revoca las claves de pruebas que ya no uses.
• Si cambias de certificado o de usuario SOL, vuelve a usar Probar conexión.