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_live_... | sk_live_... |
| Certificado | Certificado digital vigente | El mismo certificado digital vigente |
| 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 digital: podés usar el mismo certificado que en producción.
- 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_live_para el contribuyente configurado en ambiente de 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_, asociada al contribuyente configurado en producción.
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 (sk_live_...) para el contribuyente en el panel.
Reemplazá la variable de entorno en tu sistema:
# Antes (pruebas)
SIFENDE_API_KEY=sk_live_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). Las API keys siempre usan el prefijo sk_live_; Sifende dirige cada emisión según el entorno seleccionado en el panel.
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" según la configuración de ambiente de tu integración.
- 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.