Central de Ajuda Quaza Provedores

FacturaSend (PT)

FacturaSend — Quaza

FacturaSend — o middleware fiscal que conecta o Quaza ao SIFEN (Paraguai)

O FacturaSend é o intermediário técnico entre o Quaza e a SET/SIFEN. O Quaza envia os dados da fatura; o FacturaSend assina digitalmente, transmite à SET e devolve o resultado (CDC + KuDE). O Quaza não fala direto com a SET — quem faz isso é o FacturaSend.

Nesta wiki:

O que é FacturaSend

Para emitir uma fatura eletrônica no Paraguai (o Documento Eletrônico ), o Quaza envia os dados ao FacturaSend, que assina digitalmente, transmite à SET e devolve o XML aprovado com o CDC. É uma camada de abstração que cuida da parte técnica da comunicação fiscal.

Analogia: o FacturaSend está para o Paraguai assim como uma "SEFAZ virtual" está para o Brasil — um middleware que resolve a parte chata da comunicação com o fisco.
OPERADOR QUAZA (servidor) FacturaSend SET / SIFEN 1 Mensalidade / Fatura gera o documento Cria o documento estado CRIADA 2 Clica "Processar" manual OU tarefa Monta JSON · POST API estado ENVIADA Recebe o documento 3 Valida · assina XML envia ao SIFEN Valida o DE (5–30s) aprova: CDC · ou rechaça 4 Recebe via webhook APROVADA / REJEITADA Devolve o resultado 5 Envia o KuDE ao cliente Gera o KuDE (PDF) documento aprovado

Fluxo do Documento Eletrônico (PY) — Quaza → FacturaSend → SIFEN (raias: Operador · Quaza · FacturaSend · SET/SIFEN).

Como funciona a integração

O caminho é sempre Quaza → FacturaSend → SET (SIFEN), via API REST autenticada. O Quaza manda os dados da fatura em JSON; o FacturaSend converte para o XML do SIFEN, assina com o certificado do contribuinte e transmite.

Etapa Quem faz
Cliente contrata serviço/produto e é faturado Quaza
Cria o Documento Eletrônico e envia os dados Quaza → FacturaSend
Assina o XML e transmite à SET FacturaSend
Valida e autoriza/rejeita SET (SIFEN)
Devolve o resultado (CDC ou motivo) SET → FacturaSend → Quaza
Salva o CDC, gera o KuDE e envia ao cliente Quaza

Como configurar (passo a passo)

Configurar o FacturaSend tem duas partes: (A) na conta do FacturaSend e (B) no Quaza. Você consegue fazer sozinho.

Parte A — Conta no FacturaSend

1. Estabelecimento

Os dados da sucursal/estabelecimento, exatamente como cadastrados na SET — usados ao gerar cada documento (número, ponto de expedição).

fs_establecimiento

Datos de Establecimientos — número do estabelecimento (ex.: 001 / Matriz) e endereço. Dados sensíveis mascarados.

2. Certificado digital

O certificado .p12 do contribuinte é o que assina os documentos. A tela mostra a validade do certificado — fique atento ao vencimento.

fs_certificado

Certificado digital — upload do .p12 e senha. Senha e identificação mascaradas.

3. Ambiente (teste × produção) e CSC

Define se os documentos vão ao SIFEN de verdade. O CSC (Código de Seguridad del Cliente) é um código de segurança junto à SET.

A virada para Produção é irreversível. Valide tudo em teste antes.
fs_ambiente

Ambiente de Ejecución — conexão com o SIFEN e modo Produção. Identificação da empresa mascarada.

4. API Key

A API Key é a credencial que aplicações externas (o Quaza) usam para falar com o FacturaSend. É gerada aqui e depois informada na integração do Quaza.

fs_apikey

API Key — gerada no console e usada pelo Quaza. Chave e URLs mascaradas.

5. Webhooks

Os webhooks avisam o Quaza quando o SIFEN aprova, rejeita ou cancela um documento (a URL aponta para o Quaza). É o que mantém a situação do documento atualizada sem precisar consultar manualmente.

fs_webhooks

Web Hooks — URL do Quaza notificada a cada evento do SIFEN. URL, token e identificação mascarados.

Parte B — ligar no Quaza

Com a conta do FacturaSend pronta (Parte A), você liga ela ao Quaza em uma única tela — sem precisar do suporte.

Menu: Fiscal → Empresa NFe
Empresa NFe — campos do Documento Eletrônico (Paraguai)

Abra a empresa emissora. Como o país é o Paraguai, aparece a seção do Documento Eletrônico. Preencha:

Campo no Quaza O que colar
API Key A chave de API copiada do FacturaSend (aba API Key).
Tenant ID O identificador da sua empresa no FacturaSend — aparece na URL da aba API Key.
Estabelecimento O número do estabelecimento/sucursal (3 dígitos, ex.: 001), igual ao cadastrado na SET/FacturaSend.
Informações adicionais Opcional — anotações internas (ex.: data da virada para produção).

Clique em Salvar. Pronto: o Quaza passa a transmitir os documentos pela sua conta do FacturaSend.

A API Key é uma senha. Não a compartilhe nem mande por e-mail/chat — quem tiver a API Key pode emitir documentos no seu RUC.

De onde tirar → onde colar

Os três valores que ligam os dois sistemas:

Valor Onde achar no FacturaSend Onde colar no Quaza
API Key CONFIGURACIÓN → Contribuyente emisor → aba API Key → copiar a chave Fiscal → Empresa NFe → campo API Key
Tenant ID na URL da aba API Key (identificador da sua empresa) Fiscal → Empresa NFe → campo Tenant ID
Estabelecimento Datos Fiscales → Datos de Establecimientos → Establecimiento Nro (ex.: 001) Fiscal → Empresa NFe → campo Estabelecimento

Ordem dos passos

  1. Na conta FacturaSend: cadastrar estabelecimento, subir o certificado digital, configurar o ambiente (começar em Teste) e gerar a API Key.
  2. Cadastrar os webhooks apontando para o Quaza.
  3. No Quaza: em Fiscal → Empresa NFe, colar a API Key e o Tenant ID na empresa emissora e definir o estabelecimento.
  4. Emitir um documento de teste e validar a resposta (CDC + KuDE).
  5. Testar cancelamento e nota de crédito ainda em teste.
  6. Virar o ambiente para Produção e fazer a primeira emissão real.

O que o FacturaSend faz (operações)

Operação O que é
Emitir Recebe o documento do Quaza, assina e transmite ao SIFEN.
Consultar Devolve a situação atual de um documento já enviado (pelo CDC).
Cancelar Envia o pedido de cancelamento ao SIFEN (dentro do prazo legal).
Obter KuDE / XML Devolve o PDF visual (KuDE) e o XML assinado do documento.

No Quaza, essas operações aparecem como os botões da nota (Processar, Consultar, Cancelar, Ver DANFE/XML) — ver Documento Eletrônico .

Webhooks — como o resultado volta ao Quaza

A resposta do SIFEN costuma ser assíncrona. Para o Quaza saber o desfecho sem ficar perguntando, o FacturaSend chama de volta o Quaza por webhooks (uma URL do Quaza que recebe o aviso):

Evento O que dispara no Quaza
SIFEN — aprovado Marca o documento como Aprovado e guarda o CDC.
SIFEN — rejeitado Marca como Rejeitado SIFEN com o motivo.
SIFEN — cancelado Marca como Cancelado.
Além dos webhooks (push), há também a tarefa automática "Fiscal — Consulta Documento Eletrônico Paraguai" (poll), que periodicamente confere no SIFEN os documentos pendentes — uma rede de segurança caso um webhook não chegue.

Documentos suportados

Pela tela de Documento Eletrônico do Quaza, são emitidos hoje:

  • Factura electrónica — o documento do dia a dia.
  • Nota de crédito electrónica — ajuste para menos / anulação.
  • Nota de débito electrónica — ajuste para mais.
A Autofactura e a Nota de remisión existem no padrão do SIFEN, mas não estão habilitadas para emissão pela tela atual do Quaza.

Quando dá errado

Sintoma O que fazer
Documento Rejeitado FacturaSend (antes do SIFEN) Erro de dados/configuração; veja o motivo no Histórico da nota, corrija e processe de novo.
Documento Rejeitado SIFEN Corrija o que o SIFEN apontou e use Reenviar.
Credencial inválida/expirada Nada é transmitido. Acione a implantação para revisar Tenant ID/Secret/API Key.
Timbrado esgotado Solicite novo timbrado à SET e atualize no FacturaSend.

Glossário

Termo Significado
FacturaSend Middleware fiscal que assina e transmite os DEs ao SIFEN (Paraguai).
SET Subsecretaría de Estado de Tributación — a autoridade fiscal paraguaia.
SIFEN Sistema Integrado de Facturación Electrónica Nacional.
CDC Código de Control — identificador único do DE (equivale à chave da NFe).
KuDE Representação visual do DE em PDF (equivale ao DANFE).
RUC Registro Único de Contribuyentes (o identificador fiscal paraguaio).
Timbrado Autorização de numeração concedida pela SET.
API Key / Tenant ID Credenciais que autenticam o Quaza na conta do FacturaSend.
CSC (Código de Seguridad del Cliente) Código de segurança definido junto à SET, configurado na aba Ambiente do FacturaSend (não confundir com a API Key).

Pegadinhas frequentes

1. Credencial expirada/errada. O FacturaSend rejeita e nada é transmitido.
2. RUC do cliente inválido. O SIFEN rejeita.
3. Timbrado esgotando. Solicite novo bloco à SET antes de acabar.
4. KuDE não enviado ao cliente. Use "Enviar documento" ou configure o envio automático.
5. Trocar ambiente sem testar. Mudou para produção sem validar em teste — a primeira emissão real falha.

FAQ

O Quaza emite direto na SET sem o FacturaSend?

Não — o FacturaSend é a camada obrigatória que assina o XML e transmite ao SIFEN.

Posso ter mais de um RUC no mesmo Quaza?

Sim — multi-empresa, cada uma com sua integração e credenciais.

Quanto tempo leva para ter timbrado?

A SET aprova em poucos dias; depois é cadastrar no FacturaSend.

Dá para alternar entre teste e produção?

Vai-se de teste para produção; a virada para produção é irreversível, então teste bastante antes.

Quem faz esse setup?

A implantação (equipe Quaza/admin), porque envolve credenciais sensíveis.

O que é o RUC?

Registro Único do Contribuinte — o equivalente paraguaio ao CNPJ.

O que é o token CSC?

A credencial técnica que liga o Quaza à conta do FacturaSend.

Onde consigo as credenciais?

No console do FacturaSend, após cadastrar a empresa/contribuinte.

O que é o ambiente de teste?

Um ambiente que não consome timbrado nem gera documento com valor fiscal — para validar a configuração.

Errei a configuração — o que acontece?

Os documentos são rejeitados; corrija RUC/timbrado/token e teste novamente.

Posso configurar sozinho?

O setup envolve credenciais sensíveis; em geral é feito junto com a equipe de implantação.

Dá pra testar antes de produção?

Sim — há ambiente de teste no FacturaSend que não consome timbrado nem tem valor fiscal.

Multi-empresa funciona?

Sim — cada contribuinte (RUC) tem suas próprias credenciais isoladas.

Documento rejeitado: onde vejo o motivo?

Na aba Histórico do documento no Quaza — o retorno do SIFEN traz o motivo.

O que é o SIFEN?

É o sistema de facturação eletrônica da SET (a Receita do Paraguai) — equivale à SEFAZ brasileira.

O que é o CDC?

Código de Control — o código único do documento eletrônico (equivale à chave de acesso da NFe).

O que é o KuDE?

É o PDF que representa o documento eletrônico (equivale ao DANFE da NFe).

Como sei que o documento foi aprovado?

O FacturaSend devolve o estado via webhook; no Quaza o documento fica Aprovado, com o CDC.

O que é o timbrado?

É a autorização da SET para emitir, vinculada ao RUC e ao tipo de documento.

Preciso de certificado digital próprio (A1)?

Não como no Brasil — o FacturaSend cuida da assinatura; você configura as credenciais (token/CSC).

Documentos relacionados