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.

Token, credenciales y certificado digital

Separar estos conceptos evita compras equivocadas, secretos compartidos por canales inseguros y errores de go-live.

API key de Fisnodo

  • Es la llave que usa el ERP, POS o backend para llamar a la API de Fisnodo con Authorization: Bearer <api-key>.
  • Se crea en la consola de Fisnodo y debe ser distinta por ambiente.
  • No firma XML, no identifica al contribuyente ante DNIT/SIFEN y debe rotarse si se expone.

Credencial o token SIFEN/e-Kuatia

  • Es el secreto o parámetro de canal que permite autenticar la operación contra SIFEN/e-Kuatia o el proveedor fiscal que corresponda.
  • No debe confundirse con la API key de Fisnodo ni con el token físico criptográfico.
  • Debe cargarse por un canal acordado, guardarse cifrado y rotarse según vencimiento, baja o sospecha de exposición.

Token físico criptográfico

  • Algunos proveedores entregan o usan un dispositivo USB, HSM o contenedor seguro donde vive la clave privada del certificado.
  • Si el cliente dice “tengo el token”, hay que confirmar si se puede exportar el material requerido o si el flujo debe operar con ese dispositivo.
  • Fisnodo no necesita el dispositivo físico para esta guía; para operar hay que acordar si se carga PFX/keystore o si la firma queda en un dispositivo o servicio externo.

Certificado digital

  • Para SIFEN/e-Kuatia normalmente se usa un certificado cualificado tributario tipo F1 o el perfil vigente indicado por el prestador.
  • El certificado identifica al titular y permite firmar el XML; el archivo PFX o keystore debe venir con su passphrase.
  • Antes de comprar, pedí al proveedor que confirme uso para DNIT/SIFEN/e-Kuatia, formato entregable, vigencia, renovación y revocación.

Dónde consultar o comprar certificado digital

Para SIFEN/e-Kuatia normal, DNIT indica que el certificado debe obtenerse mediante un Prestador Cualificado de Servicios de Confianza (PCSC) acreditado por MIC. La lista oficial de AC Raíz está en permanente actualización; revisala antes de comprar.

En la lista oficial revisada figuran siete PCSC, pero seis tienen certificado tipo F1 publicado para uso tributario: VIT/eFirma, CODE100, Documenta/Dígito, Confirma, ITTI Secure y SOS Docs. Ministerio del Interior aparece con F2, por eso no lo listamos como opción F1 para una integración SIFEN/e-Kuatia normal.

Referencia DNIT: firma digital para e-Kuatia y e-Kuatia’i. Para e-Kuatia’i, DNIT describe un trámite gratuito del CCFE en oficinas impositivas; no es el mismo escenario que una integración e-Kuatia/SIFEN normal con sistema propio.

VIT S.A. / eFirma

Infoinfo@efirma.com.py
021 229 350 / 021 207 733 / 0981 957 554
Webwww.efirma.com.py
Producto · Contacto

CODE100 S.A.

Infoinfo@code100.com.py
021-445601-2 / 0992-460.600
Webwww.code100.com.py
Producto · Contacto

Documenta S.A. / Dígito

Infofirmadigital@documenta.com.py
+595 (021) 729 0002
Webwww.digito.com.py
Producto · Contacto

Confirma S.A.

Infoinfo@confirma.com.py
021 - 218 0018
Webwww.confirma.com.py
Producto · Contacto

ITTI S.A.E.C.A. / ITTI Secure

Infosecure@itti.digital
021-238.2200
Webwww.secure.itti.digital
Producto · Contacto

SOS Tecnología y Gestión de Información LTDA / SOS Docs

Infochristian@sosdocs.com.py
+595 (21) 423-401
Websosdocs.com.py
Producto · Contacto

Mensaje para consultar: Necesito un Certificado Cualificado Tributario Tipo F1 para facturación electrónica SIFEN / e-Kuatia a nombre del contribuyente/RUC. ¿Cuál es el costo, plazo de emisión, vigencia, formato entregado .p12/.pfx, requisitos de validación de identidad, renovación y soporte para integración con sistema propio?

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.