SIFENDE
Guías

Ir a Producción

Checklist completo para pasar tu integración de Sifende al ambiente de producción — credenciales, manejo de errores y pruebas finales.

Pasar del entorno de pruebas a producción significa que tus DE empiezan a tener validez fiscal real. Errores en producción afectan tu IVA, tus declaraciones y la relación con tus clientes. Acá tenés el checklist antes del go-live.

Una vez en producción, los documentos son legales. No podés emitir "de prueba" en producción: todo lo que enviás se envía a SIFEN como real. Hacé todas las pruebas en el entorno de pruebas primero (subiendo un certificado con ambiente=DEV).

No hay una URL separada para pruebas. Sifende usa la misma URL base (https://api.sifende.com.py) para ambos entornos. El destino real (SIFEN test vs SIFEN producción) lo determina el certificado que subas: ambiente=DEV enruta a sifen-test.set.gov.py, ambiente=PROD enruta al SIFEN productivo. Tampoco hay prefijo sk_test_: todas las API keys usan el prefijo sk_live_.

Pre-requisitos

Antes de empezar, asegurate de tener:

  • Tu integración funcionando 100% en el entorno de pruebas (todos los flujos críticos probados con un certificado ambiente=DEV)
  • Acceso al portal MARANGATÚ de la SET (para timbrado y certificado)
  • Acceso al portal e-Kuatia (para CSC de producción)
  • Certificado digital de producción vigente (PKCS12 con clave)
  • Timbrado de producción otorgado por la SET

Checklist de migración

Obtené el CSC de producción. Ingresá al portal e-Kuatia con tu certificado, andá a "Códigos de Seguridad", y generá un CSC de producción. Anotá el ID y el código: los necesitás en Sifende.

Subí el certificado de producción en Sifende:

  1. Configuración → Certificado Digital
  2. Subí el archivo .p12 o .pfx de producción
  3. Ingresá la contraseña del certificado
  4. Verificá que la fecha de vencimiento sea correcta

⚠️ El certificado de producción (ambiente=PROD) es distinto al de pruebas (ambiente=DEV); no reuses credenciales. El campo ambiente del certificado es lo que determina si Sifende enruta a SIFEN test o a SIFEN producción.

Registrá el timbrado de producción en Sifende:

  1. Configuración → Timbrados
  2. Cargá el número de timbrado obtenido en MARANGATÚ
  3. Ingresá establecimiento, puntoExpedicion, rango (desde/hasta), fechaInicio y fechaFin
  4. Activalo

Creá una API key de producción en Sifende:

  1. Configuración → API Keys
  2. Generá una nueva key
  3. Copiala inmediatamente. Solo se muestra una vez
  4. Guardala como secreto (variables de entorno, vault, etc.)

⚠️ Aunque todas las API keys usan el prefijo sk_live_, separá las keys del entorno de pruebas y las de producción. Manejalas como secretos distintos en tu vault / variables de entorno y nunca las cruces.

Actualizá tu integración:

# Variables de entorno
SIFENDE_BASE_URL=https://api.sifende.com.py
SIFENDE_API_KEY=sk_live_...

Cambiá la URL base y la API key. Recompilá / redeployá tu aplicación.

Emití tu primer DE de producción con un cliente conocido (ej: tu propia empresa o un cliente de confianza). Verificá que:

  • El estado pasa a APROBADO
  • El KuDE se genera correctamente
  • El DE aparece en el portal e-Kuatia

Monitoreá las primeras 24-48 horas activamente. Cualquier rechazo masivo indica un problema que hay que detener antes de que escale.

URL base

Sifende usa una sola URL base para los dos entornos:

https://api.sifende.com.py

El destino real lo determina el certificado:

ambiente del certificadoSIFEN al que se enrutaPara qué sirve
DEVsifen-test.set.gov.pyPruebas, sin validez fiscal
PRODSIFEN producciónDocumentos legales reales

No hay una URL qa.sifende.com.py ni un prefijo sk_test_. Si tu integración apuntaba a una URL distinta a la oficial, actualizala antes del go-live.

Checklist crítico antes del go-live

Credenciales

  • API key de producción guardada en variables de entorno (no en código)
  • Certificado de producción subido y vigente
  • Timbrado de producción registrado y activo
  • CSC de producción configurado

Manejo de errores

  • Reintentos con backoff exponencial para errores de red (timeouts, 5xx)
  • Manejo de 429 Too Many Requests
  • Polling de estado implementado (ver Polling de Resultados)
  • Persistís el id y cdc de cada DE antes de pollear
  • Loggeás todos los rechazos con código y motivo

Calidad de datos

  • Validación de RUC en el frontend (formato {número}-{dv})
  • Montos en PYG son enteros sin decimales
  • Fechas en formato ISO 8601 sin timezone (2026-04-15T10:30:00)
  • Campos B2B completos cuando corresponde (razón social, dirección, tipo contribuyente)
  • Solo usás condicionPago: CONTADO por ahora; el soporte para CREDITO está en desarrollo

Solo CONTADO está completamente soportado en producción. La condición de pago CREDITO (cuotas, plazos) está en el roadmap pero no es estable hoy. Si tu negocio requiere ventas a crédito, esperá la próxima versión o contactá a soporte.

Flujos probados

  • Factura Electrónica B2C (con receptor INNOMINADO)
  • Factura Electrónica B2B
  • Nota de Crédito sobre una FE aprobada
  • Nota de Débito sobre una FE aprobada
  • Cancelación de un documento aprobado
  • Inutilización de rango de numeración
  • Reemisión después de un rechazo
  • Descarga de KuDE PDF

Notificaciones

  • Si activaste email al receptor, probaste que llega correctamente
  • El template de email tiene tu branding y datos de contacto

Seguridad

  • La API key NO está en el código fuente ni en repositorios git
  • Tenés un plan de rotación de API keys
  • El certificado digital está almacenado de forma segura
  • Configuraste alertas para errores 5xx y 401

Operaciones

  • Tenés un dashboard para ver tasa de aprobación / rechazo
  • Tenés un plan para días de baja de SIFEN (rara pero pasa)
  • Documentaste internamente el procedimiento para incidentes

Pruebas finales recomendadas

Antes del go-live oficial, ejecutá estos casos en producción con datos reales pero a baja escala:

  1. DE B2C de monto bajo. Verificá que llega APROBADO y el KuDE es válido.
  2. DE B2B con cliente conocido. Confirmá que el cliente recibe el documento por email (si aplica) y puede consultarlo en e-Kuatia.
  3. Cancelación. Cancelá el primer DE de prueba y emití uno nuevo.
  4. Verificación cruzada. Entrá al portal e-Kuatia y confirmá que tus DE aparecen ahí.

Si algo sale mal

Soporte

¿Necesitás ayuda con el go-live?

Próximos pasos

Reintentar Documentos Rechazados

Flujo completo para corregir un documento rechazado por SIFEN y reemitirlo con un nuevo CDC.

Referencia API

Documentación completa de todos los endpoints de la API de Sifende — schemas, ejemplos de código y referencia de errores.

On this page

Pre-requisitosChecklist de migraciónURL baseChecklist crítico antes del go-liveCredencialesManejo de erroresCalidad de datosFlujos probadosNotificacionesSeguridadOperacionesPruebas finales recomendadasSi algo sale malSoportePróximos pasos