Entornos

Hay dos ejes, y confundirlos es la fuente de casi todas las sorpresas.

Una empresa en BETA dentro del edge de producción es perfectamente normal: es exactamente lo que usas mientras desarrollas. Lo que decide contra qué SUNAT se emite es el entorno de la empresa, no la URL.

BETA

Homologación de SUNAT. El comprobante se firma, se comprime, se envía por SOAP y vuelve con un CDR igual que en producción.

Con una diferencia que conviene conocer antes de perder una madrugada: el CDR de beta no viene firmado de verdad. SUNAT devuelve marcadores literales en lugar de una firma (*Private key 'BetaPublicCert' not up* y equivalentes). La plataforma reconoce ese caso como BETA_PLACEHOLDER y lo acepta solo en beta.

PRODUCTION

Requiere un certificado digital real y credenciales SOL del contribuyente.

La activación de un certificado de producción no se puede pedir. Un certificado alcanza el estado ACTIVE únicamente después de que la plataforma haya firmado una factura con él en la serie reservada F000 y SUNAT beta la haya aceptado. Un certificado de producción no se puede probar contra beta, y emitir un comprobante real solo para demostrarlo no es una decisión que le corresponda tomar a la plataforma.

Pasar de BETA a PRODUCTION

POST /console/v1/companies/{companyId}/promotion desde la consola (rol OWNER, con segundo factor activo), o POST /api/v2/organizations/companies/{id}/promotion con una credencial de organización que tenga companies:manage.

Es de un solo sentido. No existe la operación inversa, y no es un olvido: los comprobantes que ya emitió están en SUNAT, y estampar BETA en el siguiente rompería la serie en producción.

Qué exige antes de aceptar

1. Una configuración de producción ya armada. Es decir: certificado real cuyo RUC de sujeto es el de la empresa, y cuenta SOL validada contra producción. La promoción nunca es el paso que descubre que no tienes certificado — para entonces esa parte ya está hecha.
2. Ningún envío de beta en vuelo. Si algo está a medio camino de SUNAT, primero se resuelve.

Puedes subir el certificado de producción mientras la empresa sigue en beta. Es la forma prevista de prepararlo todo sin interrumpir el desarrollo.

Qué hace exactamente

• Mueve la empresa a PRODUCTION.
• Cierra los ensayos que nunca enviaste. Un documento de beta creado y no enviado pasa a CANCELLED: su único movimiento restante era un envío que a partir de ahora se rechazaría. La respuesta te dice cuántos fueron.
• No toca nada que haya llegado a SUNAT. Esos documentos conservan su estado, su CDR y su entorno. Son evidencia de lo que ensayaste, y promover no es motivo para reescribir historia.
• Deja constancia en la auditoría de la organización.

Qué NO cambia

Tu companyId, tus credenciales de API, tus suscripciones de webhook con su secreto de firma, y los miembros de tu organización. Nada de lo que construiste hay que rehacerlo: cambia el modo, no el mundo.

Tampoco se arrastra la numeración. Los correlativos se llevan por entorno, así que tu primer F001-1 de producción empieza donde debe empezar y no continúa el conteo de los ensayos.

Sobre el edge de staging

apifact-staging.fac-360.com es una instalación aparte, con su propia base de datos. Sirve para probar contra una plataforma que no es la que atiende a tus clientes, y las credenciales no cruzan: una de staging presentada a producción es sencillamente desconocida y responde 401. El entorno no se puede equivocar en silencio.

Si lo que quieres es desarrollar y luego salir a producción con la misma empresa, no necesitas el edge de staging: da de alta tu empresa en BETA sobre producción y promuévela cuando estés listo.

Antes de cualquiera de los dos

POST /api/v2/documents/validations no toca ninguno de los dos entornos. Corre en una transacción READ ONLY, no consume cuota, no toma Idempotency-Key y está limitada a 60 peticiones por minuto por credencial. Úsala hasta que el mapeo esté limpio; recién entonces emite en beta.