FisnodoWhatsAppConsola

Readiness de producción

Checklist SIFEN antes de salir a producción

Una guía operativa para confirmar que empresa, sucursales, puntos de emisión, certificado, timbrado, numeración por tipo documental, webhooks y artefactos están listos antes de emitir documentos reales en Paraguay.

Ver docs APIProbar demoEnviar email

Sandbox vs producción

Separá las pruebas técnicas de la emisión real. El go-live requiere datos fiscales reales, responsables definidos y evidencia descargable.

Sandbox

  • Validar JSON y reglas canónicas.
  • Generar KUDE, XML o imprimible de prueba.
  • Probar idempotencia, errores y reintentos.
  • Confirmar que el ERP/POS guarda external_id y document_id.

Producción

  • Usar tenant y API key productivos.
  • Configurar empresa, sucursal y punto de emisión reales.
  • Cargar certificado, timbrado, numeración por tipo y credenciales vigentes.
  • Enviar solo documentos aprobados por negocio y contabilidad.

No mezclar

  • El sandbox no remite a DNIT/SIFEN.
  • Los artefactos demo no tienen validez fiscal.
  • Las llaves productivas no se usan en entornos de desarrollo.
  • Cada RUC y punto de emisión debe tener su configuración correcta.

Evidencia final

  • Estado aceptado o rechazado visible en consola/API.
  • Timeline de validación, envío, respuesta y reintentos.
  • KUDE, XML, PDF/imprimible, payload y respuesta del canal disponibles.
  • Webhook recibido por el sistema origen.

Go-live por responsabilidad

El checklist funciona mejor cuando cada punto tiene dueño: negocio, contabilidad, desarrollo o infraestructura.

Empresa y RUC

  • RUC, razón social, nombre comercial y actividad económica revisados.
  • Dirección fiscal, departamento, distrito y ciudad confirmados.
  • Régimen fiscal y moneda operativa definidos.
  • Contactos de negocio, fiscal y técnico identificados.

Sucursales y puntos

  • Sucursal principal y adicionales cargadas.
  • Puntos de emisión con código y descripción correctos.
  • Responsable de cada punto definido.
  • Prueba por al menos un punto de emisión antes de ampliar cobertura.

Certificado y credenciales

  • Certificado PFX vigente y passphrase validada.
  • Credenciales SIFEN/e-Kuatia o proveedor cargadas.
  • Fecha de vencimiento monitoreada.
  • Procedimiento de rotación documentado antes del vencimiento.

Timbrado y numeración

  • Autoimpresor: timbrado, vigencia y rango por tipo documental.
  • SIFEN/e-Kuatia: timbrado electrónico único y numeración por tipo documental.
  • Política de reserva, agotamiento y series entendida.
  • No reutilizar numeración entre canales ni ambientes.

Integración

  • Idempotency-Key estable por documento.
  • Manejo de validation_error, configuration_error, certificate_error y upstream_error.
  • Consulta de estado y timeline implementada.
  • Retry manual o automatizado definido para fallas recuperables.

Webhooks

  • Endpoint HTTPS disponible.
  • Secreto compartido guardado fuera del código.
  • Firma X-Webhook-Signature verificada con comparación constante.
  • Replay probado para recuperar eventos perdidos.

Artefactos

  • Descarga de KUDE, XML firmado, PDF/imprimible y respuesta del canal probada.
  • Retención y permisos de acceso acordados.
  • Evidencia accesible para contabilidad y soporte.
  • Exportación o respaldo operativo definido si el cliente lo requiere.

Primer piloto

  • Un RUC, una sucursal, un punto de emisión y tipos documentales limitados.
  • Primer documento revisado por negocio, contabilidad y desarrollo.
  • Criterio de avance a más puntos definido.
  • Canal de soporte y escalamiento acordado.

Secuencia recomendada

Usá este orden para reducir retrabajo y detectar errores antes de que impacten documentos reales.

  1. 1

    Validar datos fiscales

    Confirmá empresa, sucursales, puntos, certificado, timbrado, numeración por tipo y canal antes de tocar código productivo.

  2. 2

    Cerrar el payload mínimo

    Probá factura, nota de crédito, nota de débito y cualquier documento requerido por el piloto.

  3. 3

    Probar sandbox completo

    Ejecutá validación, preview, estado, artefactos, webhooks y manejo de errores con datos de prueba.

  4. 4

    Ejecutar piloto productivo

    Emití un documento real controlado, verificá respuesta, KUDE/XML/PDF, timeline y webhook.

  5. 5

    Ampliar cobertura

    Solo después del piloto, agregá más puntos de emisión, volúmenes, usuarios y tipos documentales.

Preparar una revisión técnica

Enviá el canal actual, volumen mensual, tipos de documento, cantidad de RUCs, sucursales, puntos de emisión y fecha objetivo de salida.

Enviar brief por emailVer documentación API