Ir a Producción

Para emitir documentos con validez fiscal, prepará la configuración de producción y creá una API key sk_live_. La URL base sigue siendo https://api.sifende.com.py.

Si probaste en SANDBOX, verificá también la integración en DEV con una clave sk_test_: la aprobación de Sandbox no es una respuesta de SIFEN.

Preparar las credenciales

El timbrado y el CSC de producción salen de Marangatu. Si todavía no los tenés, seguí Generar el timbrado electrónico (video).

1. Verificá la habilitación del contribuyente para producción. El panel ofrece Pasar a Producción y muestra los requisitos antes de Activar producción.
2. En Contribuyente → Certificado digital, verificá que el certificado esté activo y vigente. Es el mismo que usaste en pruebas; lo emite un prestador de servicios de certificación autorizado.
3. Configurá el CSC de producción y su ID CSC en esa pantalla. Los valores de pruebas y producción se guardan por separado.
4. En Contribuyente → Timbrado, elegí producción y cargá Número de Timbrado y Fecha de Inicio, exactamente como figuran ante la SET.
5. En API Keys → Crear API Key, elegí PROD — Documentos con validez fiscal. El panel no crea la clave si falta la habilitación, el timbrado vigente, el CSC de producción o el certificado activo.
6. Copiá la clave y reemplazá la variable SIFENDE_API_KEY de tu integración.

SIFENDE_API_KEY=sk_live_...

El cambio de ambiente no requiere cambiar la URL ni el código de integración. Los establecimientos y puntos se envían en cada emisión.

Checklist de integración

• Probaste los flujos que usás con una clave sk_test_.
• Guardás el CDC y el resultado de cada emisión.
• Consultás el estado o procesás webhooks sin emitir otra vez por un timeout.
• Usás Idempotency-Key para reintentar una operación con la misma clave y contenido.
• Respetás Retry-After y distinguís errores de validación de resultados indeterminados.
• Revisás los rechazos y las observaciones de SIFEN.
• Descargás el KuDE y verificás los datos del documento.
• Protegés las claves y tenés previsto cómo reemplazarlas.

Las facturas a crédito están disponibles en PYG, con modalidades PLAZO y CUOTA. Consultá Condición de pago.

Flujos a probar

En DEV, probá cada flujo que use tu integración:

• Factura B2C, incluida la modalidad innominada cuando corresponda.
• Factura B2B con RUC y datos completos del receptor.
• Nota de Crédito sobre una factura aprobada.
• Nota de Débito sobre una factura aprobada.
• Cancelación de un documento aprobado dentro del plazo permitido.
• Inutilización de numeración no utilizada.
• Corrección y reemisión después de un rechazo.
• Descarga y revisión del KuDE PDF.

Si usás crédito, NRE o nominación, incluí también esos flujos en las pruebas.

Comprobar la primera operación

Emití una operación real, verificá que termine en APROBADO o APROBADO_OBSERVACION y revisá su KuDE. Verificá también que el documento aparezca en el portal e-Kuatia del ambiente correspondiente. Los documentos enviados con sk_live_ tienen efecto fiscal: hacé las pruebas de integración con sk_test_.

Si recibís rechazos, revisá mensajeRechazo antes de continuar. Ante un resultado incierto, conservá el CDC y consultá su estado. Si necesitás ayuda, contactá a soporte.

Monitorear las primeras emisiones

Durante las primeras 24 a 48 horas, revisá activamente los resultados, los rechazos, las observaciones y el tiempo hasta la aprobación. Es una recomendación de seguimiento de tu integración, no un plazo de procesamiento de SIFEN.

Si algo sale mal

• Ante rechazos masivos, frená las nuevas emisiones del flujo afectado y revisá el código y el texto de mensajeRechazo antes de continuar.
• Si hay un timeout o un resultado incierto, conservá la intención de emisión y el CDC que hayas recibido. Seguí la guía de idempotencia; no generes otra emisión para intentar obtener una respuesta.
• Si el documento está ERROR o sigue en EN_LOTE después de varias horas, revisá la guía de reintento de lotes.
• Si necesitás ayuda, contactá a soporte con el CDC y el error recibido, sin compartir claves ni contraseñas.

Guías del panel

• Certificado y CSC
• Timbrado
• API keys y cambio sin corte
• Personalización del correo