Guia de Configuração — FacturaSend + Quaza
Guia de Configuração — FacturaSend + Quaza
Documentos Eletrônicos Paraguai
Este guia apresenta os 13 passos necessários para configurar a emissão de documentos eletrônicos no Paraguai utilizando o FacturaSend integrado ao Quaza.
1 Criar usuário no FacturaSend
Acesse console.facturasend.com.py
e crie sua conta.
Após criar a conta, solicite acesso de administrador à equipe do FacturaSend para poder gerenciar os dados da sua empresa.
Com o acesso de administrador, você poderá configurar estabelecimentos, gerar chaves de API e gerenciar os webhooks.
2 Configurar estabelecimento
No painel do FacturaSend, acesse a configuração de Establecimiento e preencha os dados abaixo:
| Campo |
O que preencher |
| Establecimiento Nro |
Código de 3 caracteres (ex: 001) |
| Denominación |
Nome do estabelecimento |
| Dirección |
Endereço completo |
| Departamento |
Departamento (estado/província) |
| Distrito |
Distrito (cidade) |
| Teléfono |
Telefone de contato |
| Email |
E-mail de contato |
| Formato KUDE |
Formato de impressão da fatura |
3 Configurar ambiente
O FacturaSend possui 3 ambientes de operação:
| Ambiente |
Descrição |
| Homologação FacturaSend |
Ambiente de testes interno do FacturaSend. Ideal para validar a integração. |
| Homologação SIFEN |
Ambiente de testes oficial do SIFEN. Use para homologar junto à SET. |
| Produção SIFEN |
Ambiente real. Documentos emitidos aqui têm validade fiscal. |
Atenção: A mudança para o ambiente de Produção SIFEN é irreversível. Certifique-se de que seu certificado digital está válido antes de ativar.
4 Importar Certificado Digital
Para emissão no SIFEN (Homologação ou Produção), é obrigatório importar o certificado digital no FacturaSend.
No FacturaSend, acesse Configuración del Contribuyente > aba Certificado:
- Clique em "Cargar el Certificado Digital" e selecione o arquivo .p12 do certificado
- Informe a senha (password) do certificado no campo indicado
- Verifique se o certificado está válido (não vencido)
Importante: O certificado deve ter extensão .p12. Se não tiver, envie um ticket ao FacturaSend para instrução de exportação. Sem certificado válido, a emissão no SIFEN será rejeitada.
5 Gerar API Key
No painel do FacturaSend, clique em "Generar API Key" e copie a chave gerada.
Anote também o Tenant ID, que aparece em texto verde na tela.
URL da API: https://api.facturasend.com.py
Guarde a API Key e o Tenant ID em local seguro. Você precisará deles no próximo passo.
6 Configurar empresa no Quaza
No Quaza, acesse:
Fiscal > Empresa (NFe) > Configuração (Documento Eletrônico)
Preencha os campos:
| Campo |
O que preencher |
| API Key |
A chave gerada no passo anterior |
| Tenant ID |
O código em verde do painel FacturaSend |
| Estabelecimento |
O código de 3 caracteres configurado no passo 2 (ex: 001) |
7 Configurar emissão de notas
No Quaza, acesse:
Admin > Configuração > Fiscal
Configure os seguintes campos:
| Campo |
Valor correto |
| Gerar notas |
Pessoa física e jurídica |
| Competência |
Passada |
Importante: NÃO selecione a opção "Manual" em "Gerar notas". Isso impede a geração automática dos documentos eletrônicos.
8 Configurar permissões
No Quaza, acesse:
Admin > Grupo > Fiscal > Documento Eletrônico
Habilite as seguintes permissões para os grupos de usuários que precisam acessar os documentos:
-
Listar — visualizar a lista de documentos
-
Adicionar — criar novos documentos
-
Editar — alterar documentos existentes
-
Remover — excluir documentos
9 Série fiscal
No Quaza, acesse:
Fiscal > Série Fiscal
Verifique se existe uma única série do tipo "Documento Eletrônico" cadastrada.
Se a série já existir, não é necessário criar outra. Basta confirmar que está configurada corretamente.
10 Vincular categorias
No Quaza, acesse:
Inventário > Categoria
Para todas as categorias de produtos/serviços, configure:
| Campo |
Valor correto |
| Série Fiscal |
Documento Eletrônico |
| Tipo da Nota |
Documento Eletrônico |
Atenção: Todas as categorias devem ter essa configuração. Se alguma ficar sem, as faturas daquela categoria não serão geradas.
11 Configurar IVA nos produtos
No Quaza, acesse:
Fiscal > Produto > aba Documento Eletrônico
Configure os campos de imposto para cada produto:
| Campo |
Valor correto |
| Tipo Imposto |
IVA |
| Forma |
Gravado IVA |
| Proporção |
100 |
12 Criar integração para webhooks
No Quaza, acesse:
Admin > Integração
Crie uma nova integração com o identificador "FacturaSend".
O sistema gerará automaticamente um Client ID e um Client Secret.
Para gerar o token de autenticação, execute o seguinte comando no terminal:
echo -n "client_id:client_secret" | base64
Substitua client_id e client_secret pelos valores gerados.
O token final será: Basic {resultado_base64}
13 Configurar webhooks no FacturaSend
No painel do FacturaSend, acesse:
Opciones de la Empresa > Web Hooks
Configure a URL no formato:
https://{seu_dominio}/py/fiscal/webhook/facturasend/{arquivo}.php
No campo Authorization, insira: Basic {token} (gerado no passo anterior).
Cadastre os 5 webhooks abaixo:
| Arquivo |
Evento |
created.php |
Criação do documento eletrônico |
sifencreated.php |
Aprovação no SIFEN |
sifenrejected.php |
Rejeição no SIFEN |
sifencanceled.php |
Cancelamento no SIFEN |
receipted.php |
Recepção de documento aprovado |
Checklist de Configuração
| # |
Descrição |
Status |
| 1 |
Conta criada no FacturaSend com acesso de administrador |
☐ |
| 2 |
Estabelecimento configurado com todos os dados |
☐ |
| 3 |
Ambiente definido (Homologação ou Produção) |
☐ |
| 4 |
API Key gerada e Tenant ID anotado |
☐ |
| 5 |
Empresa configurada no Quaza com API Key e Tenant ID |
☐ |
| 6 |
Emissão de notas configurada (Pessoa física e jurídica / Passada) |
☐ |
| 7 |
Permissões de grupo habilitadas |
☐ |
| 8 |
Série fiscal "Documento Eletrônico" verificada |
☐ |
| 9 |
Todas as categorias vinculadas à série fiscal |
☐ |
| 10 |
IVA configurado nos produtos |
☐ |
| 11 |
Integração criada no Quaza com token gerado |
☐ |
| 12 |
5 webhooks cadastrados no FacturaSend |
☐ |