# Ambientes (/docs/conceptos/ambientes)



Sifende tiene tres ambientes: Sandbox (no envía nada a SIFEN), pruebas con SIFEN (sin validez fiscal) y producción. El prefijo de la **API key** (`sk_sandbox_`, `sk_test_` o `sk_live_`) define el ambiente, y los tres usan la misma URL base, `https://api.sifende.com.py`.

| Aspecto                  | Sandbox de Sifende                        | Pruebas con SIFEN                         | Producción                                |
| ------------------------ | ----------------------------------------- | ----------------------------------------- | ----------------------------------------- |
| Prefijo de claves nuevas | `sk_sandbox_`                             | `sk_test_`                                | `sk_live_`                                |
| Opción al crearla        | **SANDBOX — Simulador de Sifende**        | **DEV — Pruebas con SIFEN**               | **PROD — Documentos con validez fiscal**  |
| Envío a SIFEN            | No se envían documentos                   | Ambiente de pruebas                       | Ambiente de producción                    |
| Validez fiscal           | Sin validez fiscal                        | Sin validez fiscal                        | Los documentos tienen efecto fiscal       |
| Timbrado y CSC           | Sifende proporciona los valores de prueba | Cargá los valores del ambiente de pruebas | Cargá los valores de producción de la SET |

Las claves antiguas conservan su valor y el ambiente al que quedaron vinculadas. No deduzcas su ambiente por el prefijo: consultalo en el panel. Rotar una clave conserva su ambiente.

El certificado activo del contribuyente sirve para los tres ambientes; en SANDBOX es opcional. El timbrado y el CSC de DEV y PROD se configuran por separado. Cada ambiente conserva su propia numeración; las emisiones de DEV y SANDBOX no consumen ni reservan cupo de producción.

## Sandbox de Sifende [#sandbox-de-sifende]

Usá una clave `sk_sandbox_` para probar emisión, consultas, descarga de KuDE y recepción de notificaciones sin enviar documentos a SIFEN. Necesitás la dirección del emisor y al menos una actividad económica configurada. No tenés que cargar un certificado, un timbrado ni un CSC para SANDBOX: si todavía no cargaste tu certificado, Sifende firma con uno de prueba. Los datos de la solicitud siguen sujetos a validación.

La emisión devuelve `202 Accepted` con `estado: "PENDIENTE"`. Después, la consulta de estado muestra `APROBADO` con `protocoloAutorizacion` formado por `SBX-` seguido del CDC. Es una aprobación de prueba de Sifende: no proviene de SIFEN ni otorga validez fiscal.

El KuDE lleva el rótulo **SANDBOX — SIN VALIDEZ FISCAL**. Para encontrar estos documentos en el panel, elegí **Sandbox** en el [filtro de ambiente](/docs/panel/documentos).

Los correos y webhooks sí se entregan: usá una dirección de prueba en `receptor.email`. Para recibir `documento.aprobado`, configurá un [endpoint de webhooks](/docs/panel/webhooks) en **Sandbox**. Las notificaciones nuevas incluyen `ambiente: "SANDBOX"` y se entregan únicamente a los endpoints de ese ambiente.

SANDBOX no admite cancelación, inutilización ni nominación: responde [`422 sandbox-operation-not-supported`](/docs/solucion-problemas/sandbox-operation-not-supported). Usá DEV para probar eventos y rechazos de SIFEN. Una aprobación en SANDBOX no comprueba que SIFEN vaya a aceptar el documento.

## Probar la integración [#probar-la-integración]

Creá una clave `sk_test_` para enviar documentos al ambiente de pruebas de SIFEN, consultar resultados, descargar KuDE y probar rechazos. Los datos del ambiente de pruebas de SIFEN pueden diferir de los de producción; consultá [Rechazos comunes](/docs/solucion-problemas/rechazos-comunes#ambiente-prueba).

## Pasar a producción [#pasar-a-producción]

1. Verificá que el contribuyente esté habilitado para producción.
2. Cargá su [timbrado de producción](/docs/panel/timbrado) vigente y su [CSC de producción](/docs/panel/certificado-y-csc). Verificá que el certificado siga activo.
3. Creá una API key para **PROD — Documentos con validez fiscal**. Si falta un requisito, el panel indica qué completar.
4. Reemplazá la variable de entorno de tu integración por la nueva clave `sk_live_`.

La URL base y el código de integración se mantienen. Las claves `sk_test_` existentes siguen siendo de pruebas.

## Mantener los ambientes separados [#mantener-los-ambientes-separados]

Usá variables distintas, como `SIFENDE_API_KEY_TEST` y `SIFENDE_API_KEY_PROD`. Las respuestas de emisión y consulta de estado incluyen `ambiente`: `DEV`, `PROD` o `SANDBOX`. Guardá ese valor junto con el CDC y mostrá una indicación visible cuando tu sistema esté en pruebas. El ambiente de un documento no cambia al pasar el contribuyente a producción. Tampoco cambian de ambiente los eventos, reintentos, claves de idempotencia ni entregas de webhooks existentes.

Para el checklist completo, consultá [Ir a producción](/docs/guias/ir-a-produccion).
