Timbre

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

  1. Activá producción

    Desde el selector de proyecto, y esperá a que deje de decir «Preparando…».

  2. Generá la llave de producción

    Es otra llave. La de sandbox no sirve acá.

  3. Cargá las credenciales de producción

    Una vez por contribuyente. Confirmá que el veredicto no sea rejected.

  4. 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.