FisnodoWhatsAppConsola

Manual de preparación

Antes de integrar factura electrónica SIFEN/e-Kuatia

Usá este manual cuando el cliente va a operar documentos electrónicos o prepara la migración desde autoimpresión hacia SIFEN/e-Kuatia.

Ver checklist SIFENVer docs APIVolver a manuales

Checklist mínimo antes de integrar

Separá preparación fiscal, configuración de canal e implementación técnica. Si una parte no está lista, el primer documento real debe esperar.

Datos fiscales

  • RUC con dígito verificador.
  • Razón social exacta.
  • Dirección fiscal y actividad económica.
  • Régimen fiscal.
  • Responsable fiscal que aprueba el primer documento electrónico.

Sucursal y punto

  • Establecimientos reales que emitirán.
  • Puntos de emisión por establecimiento.
  • Tipo documental que usará cada punto.
  • Responsable operativo por punto.
  • Plan para ampliar a más puntos después de la primera prueba controlada.

Certificado digital

  • Archivo PFX vigente.
  • Contraseña del PFX.
  • Fecha de vencimiento conocida.
  • Procedimiento para renovar antes de vencer.
  • Canal seguro para entregar el material al responsable autorizado.

Timbrado y numeración

  • Timbrado electrónico vigente.
  • Numeración por establecimiento, punto y tipo documental.
  • Siguiente número real por tipo.
  • Política de series si el cliente opera varios puntos.
  • Control para no reutilizar numeración entre ambientes.

Ambientes

  • Tenant o entorno de prueba para validar payloads.
  • Tenant o entorno productivo separado.
  • Claves API distintas por ambiente.
  • Webhooks distintos por ambiente.
  • Datos de prueba claramente separados de documentos reales.

Integración técnica

  • Payload canónico mínimo por tipo documental.
  • external_id guardado en el sistema origen.
  • Idempotency-Key estable por documento.
  • Consulta de estado y timeline.
  • Descarga de XML firmado, KUDE, PDF y respuesta del canal.

Secuencia recomendada

Primero readiness fiscal, después integración técnica, y recién al final el primer documento real controlado.

  1. 1

    Confirmar datos fiscales

    Validar empresa, sucursal, punto, certificado, timbrado y numeración con el responsable fiscal.

  2. 2

    Configurar SIFEN/e-Kuatia

    Cargar certificado, credenciales, timbrado electrónico y numeración por tipo documental.

  3. 3

    Validar payloads

    Ejecutar /v1/documents/validate hasta resolver errores de contrato, configuración y certificado.

  4. 4

    Probar sandbox

    Generar previews o documentos demo para revisar estructura, artefactos y manejo de errores.

  5. 5

    Conectar webhooks

    Validar firma X-Webhook-Signature y guardar eventos de forma idempotente.

  6. 6

    Emitir primer documento real controlado

    Crear una factura o documento real acordado con el cliente, revisar XML, KUDE, respuesta SIFEN, timeline y webhook.

Migración desde autoimpresión

El cambio normal de autoimpresión a SIFEN/e-Kuatia es unidireccional para documentos nuevos.

Antes del cambio

  • Cerrar documentos pendientes del canal autoimpresor.
  • Confirmar último número usado por tipo documental.
  • Guardar evidencia histórica necesaria.
  • Validar certificado y numeración SIFEN.
  • Definir fecha y hora de corte.

Después del cambio

  • Nuevos documentos salen por SIFEN/e-Kuatia.
  • La configuración autoimpresor queda como referencia histórica.
  • La regeneración de documentos viejos debe tratarse como soporte o auditoría.
  • Volver a autoimpresor no es un flujo normal; sería corrección administrativa.
  • El sistema origen debe conservar external_id e idempotencia igual que antes.