Ambientes
Elegí Sandbox, pruebas con SIFEN o producción con la API key, usando la misma URL base.
La API key determina el ambiente de la operación. 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. 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
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 un certificado activo, la dirección del emisor y al menos una actividad económica configurada. No tenés que cargar un timbrado ni un CSC para SANDBOX; 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.
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 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. 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
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.
Pasar a producción
- Verificá que el contribuyente esté habilitado para producción.
- Cargá su timbrado de producción vigente y su CSC de producción. Verificá que el certificado siga activo.
- Creá una API key para PROD — Documentos con validez fiscal. Si falta un requisito, el panel indica qué completar.
- 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
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.