Guía de Configuración — FacturaSend + Quaza
Guía de Configuración — FacturaSend + Quaza
Documentos Electrónicos Paraguay
Esta guía presenta los 13 pasos necesarios para configurar la emisión de documentos electrónicos en Paraguay utilizando FacturaSend integrado con Quaza.
1 Crear usuario en FacturaSend
Ingrese a console.facturasend.com.py
y cree su cuenta.
Una vez creada la cuenta, solicite acceso de administrador al equipo de FacturaSend para poder gestionar los datos de su empresa.
Con el acceso de administrador, usted podrá configurar establecimientos, generar claves de API y gestionar los webhooks.
2 Configurar establecimiento
En el panel de FacturaSend, acceda a la configuración de Establecimiento y complete los siguientes datos:
| Campo |
Qué completar |
| Establecimiento Nro |
Código de 3 caracteres (ej: 001) |
| Denominación |
Nombre del establecimiento |
| Dirección |
Dirección completa |
| Departamento |
Departamento (provincia) |
| Distrito |
Distrito (ciudad) |
| Teléfono |
Teléfono de contacto |
| Email |
Correo electrónico de contacto |
| Formato KUDE |
Formato de impresión de la factura |
3 Configurar ambiente
FacturaSend cuenta con 3 ambientes de operación:
| Ambiente |
Descripción |
| Homologación FacturaSend |
Ambiente de pruebas interno de FacturaSend. Ideal para validar la integración. |
| Homologación SIFEN |
Ambiente de pruebas oficial del SIFEN. Utilícelo para homologar ante la SET. |
| Producción SIFEN |
Ambiente real. Los documentos emitidos aquí tienen validez fiscal. |
Atención: El cambio al ambiente de Producción SIFEN es irreversible. Asegúrese de que su certificado digital esté vigente antes de activarlo.
4 Importar certificado digital
Para la emisión en el SIFEN (Homologación o Producción), es obligatorio importar el certificado digital en FacturaSend.
En FacturaSend, acceda a Configuración del Contribuyente > pestaña Certificado:
- Haga clic en "Cargar el Certificado Digital" y seleccione el archivo .p12 del certificado
- Ingrese la contraseña (password) del certificado en el campo indicado
- Verifique que el certificado esté válido (no vencido)
Importante: El certificado debe tener extensión .p12. Si no la tiene, envíe un ticket a FacturaSend para instrucciones de exportación. Sin certificado válido, la emisión en el SIFEN será rechazada.
5 Generar API Key
En el panel de FacturaSend, haga clic en "Generar API Key" y copie la clave generada.
Anote también el Tenant ID, que aparece en texto verde en la pantalla.
URL de la API: https://api.facturasend.com.py
Guarde la API Key y el Tenant ID en un lugar seguro. Los necesitará en el siguiente paso.
6 Configurar empresa en Quaza
En Quaza, acceda a:
Fiscal > Empresa (NFe) > Configuración (Documento Electrónico)
Complete los campos:
| Campo |
Qué completar |
| API Key |
La clave generada en el paso anterior |
| Tenant ID |
El código en verde del panel de FacturaSend |
| Establecimiento |
El código de 3 caracteres configurado en el paso 2 (ej: 001) |
7 Configurar emisión de facturas
En Quaza, acceda a:
Admin > Configuración > Fiscal
Configure los siguientes campos:
| Campo |
Valor correcto |
| Generar facturas |
Persona física y jurídica |
| Competencia |
Pasada |
Importante: NO seleccione la opción "Manual" en "Generar facturas". Esto impide la generación automática de los documentos electrónicos.
8 Configurar permisos
En Quaza, acceda a:
Admin > Grupo > Fiscal > Documento Electrónico
Habilite los siguientes permisos para los grupos de usuarios que necesiten acceder a los documentos:
-
Listar — ver la lista de documentos
-
Adicionar — crear nuevos documentos
-
Editar — modificar documentos existentes
-
Remover — eliminar documentos
9 Serie fiscal
En Quaza, acceda a:
Fiscal > Serie Fiscal
Verifique que exista una única serie del tipo "Documento Electrónico" registrada.
Si la serie ya existe, no es necesario crear otra. Solo confirme que esté configurada correctamente.
10 Vincular categorías
En Quaza, acceda a:
Inventario > Categoría
Para todas las categorías de productos/servicios, configure:
| Campo |
Valor correcto |
| Serie Fiscal |
Documento Electrónico |
| Tipo de Factura |
Documento Electrónico |
Atención: Todas las categorías deben tener esta configuración. Si alguna queda sin configurar, las facturas de esa categoría no se generarán.
11 Configurar IVA en los productos
En Quaza, acceda a:
Fiscal > Producto > pestaña Documento Electrónico
Configure los campos de impuesto para cada producto:
| Campo |
Valor correcto |
| Tipo Impuesto |
IVA |
| Forma |
Gravado IVA |
| Proporción |
100 |
12 Crear integración para webhooks
En Quaza, acceda a:
Admin > Integración
Cree una nueva integración con el identificador "FacturaSend".
El sistema generará automáticamente un Client ID y un Client Secret.
Para generar el token de autenticación, ejecute el siguiente comando en la terminal:
echo -n "client_id:client_secret" | base64
Reemplace client_id y client_secret por los valores generados.
El token final será: Basic {resultado_base64}
13 Configurar webhooks en FacturaSend
En el panel de FacturaSend, acceda a:
Opciones de la Empresa > Web Hooks
Configure la URL con el formato:
https://{su_dominio}/py/fiscal/webhook/facturasend/{archivo}.php
En el campo Authorization, ingrese: Basic {token} (generado en el paso anterior).
Registre los 5 webhooks a continuación:
| Archivo |
Evento |
created.php |
Creación del documento electrónico |
sifencreated.php |
Aprobación en el SIFEN |
sifenrejected.php |
Rechazo en el SIFEN |
sifencanceled.php |
Cancelación en el SIFEN |
receipted.php |
Recepción de documento aprobado |
Checklist de Configuración
| # |
Descripción |
Estado |
| 1 |
Cuenta creada en FacturaSend con acceso de administrador |
☐ |
| 2 |
Establecimiento configurado con todos los datos |
☐ |
| 3 |
Ambiente definido (Homologación o Producción) |
☐ |
| 4 |
API Key generada y Tenant ID anotado |
☐ |
| 5 |
Empresa configurada en Quaza con API Key y Tenant ID |
☐ |
| 6 |
Emisión de facturas configurada (Persona física y jurídica / Pasada) |
☐ |
| 7 |
Permisos de grupo habilitados |
☐ |
| 8 |
Serie fiscal "Documento Electrónico" verificada |
☐ |
| 9 |
Todas las categorías vinculadas a la serie fiscal |
☐ |
| 10 |
IVA configurado en los productos |
☐ |
| 11 |
Integración creada en Quaza con token generado |
☐ |
| 12 |
5 webhooks registrados en FacturaSend |
☐ |