Ambientes
Ambiente de pruebas (QA) y producción en Sifende — URLs, credenciales y diferencias de comportamiento.
Sifende tiene dos ambientes separados: pruebas (QA / sandbox) y producción. El contrato de la API es el mismo en los dos. Lo que cambia es a qué endpoint de SIFEN se conectan, qué credenciales usan, y si los documentos emitidos tienen efecto fiscal o no.
Comparación rápida
| Aspecto | Pruebas | Producción |
|---|---|---|
| Endpoint Sifende | https://api.sifende.com.py/api/v1/... | https://api.sifende.com.py/api/v1/... |
| Endpoint SIFEN | e-kuatia test (DNIT) | e-kuatia prod (DNIT) |
| Prefijo API key | sk_test_... | sk_live_... |
| Certificado | De pruebas (provisto por SET) | Real, emitido por una AC autorizada |
| Timbrado | De pruebas | Asignado por la SET para producción |
| Validez legal | ❌ No tiene efecto fiscal | ✅ Documentos legalmente válidos |
| Visible en e-kuatia | Solo en e-kuatia test | Sí (consulta pública con CDC) |
El contrato de la API es idéntico. Cuando estés listo para ir a producción no hace falta tocar el código: solo cambian las credenciales (API key y timbrado).
Ambiente de pruebas (QA)
Es donde validás tu integración antes de emitir documentos reales.
Para qué se usa
- Validar tu integración: emitir FE, NCE, NDE de prueba sin consecuencias fiscales.
- Probar casos límite como receptores B2B, B2C, innominados, con descuentos o multi-IVA.
- Reproducir errores. Los rechazos de SIFEN test usan los mismos códigos que producción.
- Hacer demos a clientes mostrando el flujo sin emitir documentos reales.
Credenciales de pruebas
- Certificado de pruebas: la SET provee un P12 genérico para el ambiente de testing.
- Timbrado de pruebas: la SET también asigna un timbrado específico para QA.
- API key: en el panel de Sifende, generá una clave con prefijo
sk_test_desde el modo "Pruebas".
Limitaciones del ambiente de pruebas
- El endpoint de SIFEN test puede tener mayor latencia y menor disponibilidad que producción.
- Los documentos emitidos en QA no aparecen en e-kuatia productivo y no tienen validez legal.
- Los CDC generados en QA no sirven en producción, porque los timbrados son distintos.
Ambiente de producción
El ambiente real, con efecto fiscal.
Para qué se usa
- Emitir documentos electrónicos legalmente válidos.
- Operar tu negocio facturando ante DNIT.
- Cancelar o inutilizar documentos productivos.
Requisitos
- Certificado digital P12 real, emitido por una autoridad certificadora autorizada en Paraguay (DOCUMENTA, eFirma, e-Forma, ID-Token, etc.).
- Timbrado electrónico vigente asignado por la SET al RUC del contribuyente.
- Habilitación como facturador electrónico (CSC asignado por e-kuatia).
- API key con prefijo
sk_live_.
Cómo cambiar de ambiente
El cambio de QA a producción es de configuración, no de código:
Configurá el contribuyente en producción desde el panel: subí el certificado real, cargá el timbrado productivo y registrá el CSC asignado por e-kuatia.
Generá una API key productiva (sk_live_...) en el panel.
Reemplazá la variable de entorno en tu sistema:
# Antes (pruebas)
SIFENDE_API_KEY=sk_test_abc123...
# Después (producción)
SIFENDE_API_KEY=sk_live_xyz789...Antes de migrar todo el flujo, probá con un documento de bajo monto para validar que toda la cadena funciona.
La URL base es la misma en los dos ambientes (api.sifende.com.py). Sifende detecta el ambiente por el prefijo de la API key (sk_test_ vs sk_live_) y rutea al endpoint correcto de SIFEN.
Buenas prácticas de separación
- Variables de entorno distintas por ambiente:
SIFENDE_API_KEY_TESTySIFENDE_API_KEY_PROD. - Bases de datos separadas para CDC de QA y producción. No mezcles los identificadores.
- Banderas visuales en tu sistema: poné un banner amarillo "AMBIENTE DE PRUEBAS" si el API key empieza con
sk_test_. - Nunca uses claves de producción en desarrollo. Si lo hacés, vas a emitir documentos reales con datos de prueba.
Próximos pasos
- Inicio Rápido — Requisitos Previos: cómo conseguir las credenciales.
- Ir a Producción: checklist de go-live.
- Autenticación: más sobre las API keys.