FacturaSend — middleware fiscal para emisión de Documento Electrónico Paraguay
El FacturaSend es el intermediario técnico que conecta el Quaza al SET/SIFEN.
Qué es FacturaSend
El FacturaSend es el intermediario técnico entre Quaza y la SET (Subsecretaría de Estado de Tributación - Paraguay). Cuando emite una factura electrónica en Paraguay, Quaza envía los datos a FacturaSend, que firma digitalmente, transmite a la SET y devuelve el XML aprobado.
FacturaSend está para Paraguay como SEFAZ Virtual está para Brasil — middleware fiscal.
Cómo funciona la integración
Quaza ↔ FacturaSend ↔ SET. Quaza envía JSON, FacturaSend convierte a XML/SET, transmite, devuelve respuesta + CDC.
| Etapa |
Quién hace |
| Cliente compra |
Quaza registra contrato |
| Genera factura |
Quaza |
| Envía JSON |
Quaza → FacturaSend |
| Firma + transmite |
FacturaSend |
| Valida + autoriza/rechaza |
SET |
| Devuelve resultado |
SET → FacturaSend → Quaza |
| Guarda CDC + libera PDF |
Quaza |
Glosario
| Término |
Significado |
| FacturaSend |
Intermediario fiscal para Paraguay. |
| SET |
Subsecretaría de Estado de Tributación. |
| SIFEN |
Sistema Integrado de Facturación Electrónica Nacional. |
| CDC |
Código de Control — equivalente a la clave de acceso NFe. |
| DE |
Documento Electrónico. |
| RUC |
Registro Único de Contribuyentes. |
| KuDE |
Representación visual del DE. |
| Token CSC |
Credencial de autenticación. |
| Timbrado |
Número de autorización de emisión. |
Flujo de envío
Flujo del Documento Electrónico (PY) — Quaza → FacturaSend → SIFEN (carriles: Operador · Quaza · FacturaSend · SET/SIFEN).
Cómo configurar (paso a paso)
Configurar el FacturaSend tiene dos partes: (A) en la cuenta del FacturaSend y (B) en Quaza. Usted puede hacerlo solo.
Pasos de la configuración
-
Cadastrar empresa en FacturaSend con RUC y datos fiscales
-
Obtener token CSC (credencial de API)
-
Configurar timbrado (número de autorización SET)
-
Insertar credenciales en Quaza (área de configuración fiscal)
- Testar en ambiente sandbox
- Validar XML retornado
- Activar producción
-
Configurar envío automático de KuDE por email
Parte B — conectar en Quaza
Con la cuenta de FacturaSend lista, usted conecta todo en Quaza en una sola pantalla — sin depender del soporte.
Menú: Fiscal → Empresa NFe
Empresa NFe — campos del Documento Electrónico (Paraguay)
Abra la empresa emisora. Como el país es Paraguay, aparece la sección del Documento Electrónico. Complete:
| Campo en Quaza |
Qué pegar |
| API Key |
La clave de API copiada del FacturaSend (pestaña API Key). |
| Tenant ID |
El identificador de su empresa en FacturaSend — aparece en la URL de la pestaña API Key. |
| Establecimiento |
El número del establecimiento/sucursal (3 dígitos, ej.: 001), igual al registrado en la SET/FacturaSend. |
| Informaciones adicionales |
Opcional — notas internas (ej.: fecha del pase a producción). |
Haga clic en Guardar. Listo: Quaza pasa a transmitir los documentos por su cuenta de FacturaSend.
La API Key es una contraseña. No la comparta ni la mande por e-mail/chat — quien tenga la API Key puede emitir documentos con su RUC.
De dónde sacar → dónde pegar
| Valor |
Dónde encontrarlo en FacturaSend |
Dónde pegarlo en Quaza |
| API Key |
CONFIGURACIÓN → Contribuyente emisor → pestaña API Key → copiar la clave |
Fiscal → Empresa NFe → campo API Key
|
| Tenant ID |
en la URL de la pestaña API Key |
Fiscal → Empresa NFe → campo Tenant ID
|
| Establecimiento |
Datos Fiscales → Datos de Establecimientos → Establecimiento Nro (ej.: 001) |
Fiscal → Empresa NFe → campo Establecimiento
|
Documentos soportados
- Factura electrónica (modelo 01)
- Autofactura (modelo 02)
- Nota de crédito (modelo 05)
- Nota de débito (modelo 06)
- Nota de remisión (modelo 07)
- Comprobante de retención (modelo 04)
Trampas frecuentes
1. Token CSC expirado.
2. RUC del cliente equivocado.
3. Numeración de timbrado agotando.
4. KuDE no enviado al cliente.
5. Cancelamiento fuera del plazo. SET acepta CDC dentro de 48h.
Preguntas frecuentes
¿Quaza emite directo en la SET sin el FacturaSend?No — el FacturaSend es la capa obligatoria que firma el XML y lo transmite al SIFEN.
¿Puedo tener más de un RUC en el mismo Quaza?Sí — multi-empresa, cada una con su integración y credenciales.
¿Cuánto tarda en tener el timbrado?La SET aprueba en pocos días; luego se registra en el FacturaSend.
¿Se puede alternar entre prueba y producción?Se va de prueba a producción; el pase a producción es irreversible, así que pruebe bastante antes.
¿Quién hace este setup?La implantación (equipo Quaza/admin), porque involucra credenciales sensibles.
¿Qué es el RUC?Registro Único del Contribuyente — el equivalente paraguayo al CNPJ.
¿Qué es el token CSC?La credencial técnica que conecta Quaza con la cuenta del FacturaSend.
¿Dónde consigo las credenciales?En la consola del FacturaSend, tras registrar la empresa/contribuyente.
¿Qué es el ambiente de prueba?Un ambiente que no consume timbrado ni genera documento con valor fiscal — para validar la configuración.
Me equivoqué en la configuración — ¿qué pasa?Los documentos se rechazan; corrija RUC/timbrado/token y pruebe de nuevo.
¿Puedo configurar solo?El setup involucra credenciales sensibles; en general se hace junto con el equipo de implantación.
¿Se puede probar antes de producción?Sí — hay un ambiente de prueba en el FacturaSend que no consume timbrado ni tiene valor fiscal.
¿Funciona multi-empresa?Sí — cada contribuyente (RUC) tiene sus propias credenciales aisladas.
Documento rechazado: ¿dónde veo el motivo?En la pestaña Histórico del documento en Quaza — el retorno del SIFEN trae el motivo.
¿Qué es el SIFEN?Es el sistema de facturación electrónica de la SET (la hacienda de Paraguay) — equivale a la SEFAZ brasileña.
¿Qué es el CDC?Código de Control — el código único del documento electrónico (equivale a la clave de acceso de la NFe).
¿Qué es el KuDE?Es el PDF que representa el documento electrónico (equivale al DANFE de la NFe).
¿Cómo sé que el documento fue aprobado?El FacturaSend devuelve el estado vía webhook; en Quaza el documento queda Aprobado, con el CDC.
¿Qué es el timbrado?Es la autorización de la SET para emitir, vinculada al RUC y al tipo de documento.
¿Necesito certificado digital propio (A1)?No como en Brasil — el FacturaSend se encarga de la firma; usted configura las credenciales (token/CSC).
Ambientes y testes
FacturaSend opera en dos ambientes claramente separados, y entender la diferencia es crítico para evitar emisiones equivocadas en producción:
| Ambiente |
Para qué sirve |
Consecuencias |
| Sandbox / Teste |
Validar integración, testar formato JSON, probar errores |
No consume timbrado. CDC ficticio. SET no recibe. |
| Producción |
Emisiones reales para clientes |
Consume timbrado real. CDC válido. SET recibe y archiva. |
Antes de migrar a producción, recomenda-se: (1) emitir 5-10 DEs de teste exitosos, (2) validar XML retornado contra schema SET, (3) verificar que KuDE PDF está renderizado correctamente, (4) testar cancelamiento de CDC.
Cada ambiente tiene su token CSC propio. NUNCA mezcle: usar token de teste en producción genera errores; usar token de producción en teste consume timbrado real.
Checklist operacional
Use este checklist como referencia rápida para garantizar que el módulo está siendo operado correctamente:
-
Configuración inicial validada — todos los campos obligatorios completados, permisos atribuidos, integraciones testadas
-
Equipo entrenado — al menos dos operadores saben operar; redundancia previene paralización
-
Procedimiento documentado — paso a paso de operaciones recurrentes disponible en lugar accesible
-
Backups al día — backup automático corriendo, último restore testado en los últimos 90 días
-
Monitoreo activo — alertas configuradas para fallas críticas, logs siendo revisados semanalmente
-
Plan de contingencia — si el módulo cae, equipo sabe cómo operar manualmente hasta volver
-
Auditoría periódica — revisión mensual de inconsistencias; trimestral de eficiencia operacional
-
Documentación de cambios — alteraciones relevantes registradas (fecha, autor, motivo, impacto)
Indicadores típicos a acompañar
Cada proveedor define sus propios KPIs, pero algunos son casi universales para este tipo de operación:
- Volumen mensual procesado (registros, transacciones, eventos)
- Tasa de error (% de operaciones que fallaron)
- Tiempo medio de respuesta/procesamiento
- Cobertura (% de la cartera atendida por el módulo)
- Satisfacción operacional (feedback del equipo que usa)
Compare valores actuales con media de los últimos 3 meses. Variación mayor que 20% en cualquier dirección merece investigación — puede ser mejora sostenible o degradación silenciosa.
Documentos relacionados