Producción
Activar el ambiente real, y qué falta después de activarlo.
Sandbox está abierto desde el primer minuto: creás la cuenta, la organización queda con su proyecto de sandbox y ya podés integrar contra el sandbox de Hacienda, sin límite y sin tarjeta.
Producción se activa aparte, y la activás vos.
Activarla
Desde el panel, en el selector de organización y proyecto: la fila Producción trae el botón Activar.
Activar no es instantáneo. La petición encola el ambiente y responde de una vez, así que la fila queda en Preparando… hasta que el proyecto de producción existe de verdad; ahí pasa a ser seleccionable, igual que el de sandbox. Es el mismo aprovisionamiento asincrónico que corre cuando te registrás.
Mientras está preparándose no hay nada que hacer: no vuelvas a activarla —una segunda activación se rechaza— y no vas a poder generar una llave de producción hasta que el proyecto exista.
Crear el proyecto de producción no presenta nada ante Hacienda y no toca tu sandbox. Por sí solo no habilita ni un comprobante real: lo que habilita documentos reales son las credenciales de producción de cada contribuyente.
Otro proyecto, otra llave
Un proyecto está clavado a un ambiente de por vida. Activar producción no convierte tu proyecto de sandbox en uno real: crea otro proyecto, con su propia llave, sus propios documentos y su propia numeración.
No hay ningún parámetro que cambie de ambiente. El campo environment de una
emisión solo sirve para declarar cuál esperás, y si no coincide con el del
proyecto la petición se rechaza —nunca para cambiarlo. Lo mismo dice
Autenticación: cambiar de ambiente es cambiar de llave.
Generá la llave de producción desde el panel, en Integración → Llaves de API, y guardala en tu lado como el secreto que es: se muestra una sola vez.
Lo que no se hereda
Un contribuyente listo en sandbox no está listo en producción.
Las sucursales y las terminales son del contribuyente y se comparten entre
ambientes, así que ya están. Las credenciales de Hacienda no: se guardan por
ambiente, y las del sandbox no sirven contra el ambiente real de Hacienda.
Hasta que le cargues a ese contribuyente sus credenciales de producción,
credentialStatus en producción es absent, y todo lo que emita a su nombre va
a fallar al autenticarse.
Se cargan igual que las de sandbox, cambiando el ambiente en la ruta:
PUT /internal/v1/issuers/environments/production/credentials. Se guardan, se
comprueban contra Hacienda y devuelven el veredicto de ese intento —lo mismo que
explica Contribuyentes.
Para ver cómo está cada uno en el ambiente que te importa, la lista acepta
environment como parámetro de consulta: GET /internal/v1/issuers/list
reporta hasCredentials y credentialStatus del ambiente que le pidas, y
sandbox si no le pedís ninguno.
Antes del primer documento real
Activá producción
Desde el selector de proyecto, y esperá a que deje de decir «Preparando…».
Generá la llave de producción
Es otra llave. La de sandbox no sirve acá.
Cargá las credenciales de producción
Una vez por contribuyente. Confirmá que el veredicto no sea
rejected.Emití el primero con cuidado
En producción no hay documentos de prueba: el primero es real y gasta un consecutivo real. La numeración no tiene marcha atrás, así que si sale mal se corrige con una nota de crédito, no borrándolo.
Si la activación falla
La fila queda en No se pudo activar con el motivo que quedó registrado. No se reintenta solo y no hay nada que puedas volver a apretar: escribinos con ese motivo y lo reintentamos nosotros. Tu sandbox sigue funcionando mientras tanto.