Configuração FacturaSend — setup da integração fiscal Paraguai
Configurar FacturaSend é o primeiro passo pra emitir
Documento Eletrônico
no Paraguai. Cadastra-se RUC, timbrado, token CSC, e ambiente. Teste em sandbox antes de produção.
Por que configurar
Antes de emitir o primeiro Documento Eletrônico
no Paraguai, é preciso configurar a integração entre Quaza e FacturaSend
. São credenciais, certificados, RUC, timbrado, ambiente (teste/produção).
Princípio: configuração feita uma vez, testada em ambiente de teste, depois ativada em produção. Não pule etapas.
Passos da configuração
-
Cadastrar empresa no FacturaSend com RUC e dados fiscais
-
Obter token CSC (credencial de API)
-
Configurar timbrado (número de autorização SET)
-
Inserir credenciais no Quaza (área de configuração fiscal)
-
Testar em ambiente sandbox (emissão teste, não consome timbrado)
-
Validar XML retornado (CDC presente, formato OK)
-
Ativar produção e fazer primeira emissão real
-
Configurar envio automático de KuDE por email
Glossário
| Termo |
Significado |
| RUC |
Registro Único de Contribuyentes — identificador fiscal Paraguai. |
| Timbrado |
Número de autorização de emissão concedido pela SET. |
| Token CSC |
Credencial de API do FacturaSend. |
| Ambiente teste |
Sandbox do FacturaSend — sem consumo de timbrado. |
| Ambiente produção |
Emissões reais, consomem timbrado, vão à SET. |
| CDC |
Código de Control retornado pela SET. |
| SET |
Subsecretaría de Estado de Tributación. |
| Auditoria |
Revisão sistemática de registros para detectar inconsistências. |
| Permissão |
Direito de acesso/edição vinculado a papel ou usuário. |
| API REST |
Interface programática que permite integração com sistemas externos. |
Fluxo de setup
CONFIGURAÇÃO FACTURASEND — PASSO A PASSO
──────────────────────────────────────────
1. Cadastrar empresa no FacturaSend
│
▼
2. Obter token CSC + timbrado
│
▼
3. Quaza → Configuração Fiscal
┌──────────────────────────┐
│ - RUC │
│ - timbrado │
│ - token CSC │
│ - ambiente (teste/prod) │
└──────────────┬───────────┘
▼
4. Salvar e testar conexão
│
▼
5. Emitir DE teste
│
▼
6. Validar resposta (CDC + KuDE)
│
▼
7. Mudar ambiente → produção
│
▼
8. Primeira emissão real
Credenciais e tokens
Configuração → FacturaSend
Tela de configuração do FacturaSend — token CSC, RUC, timbrado, ambiente.
| Campo |
O que preencher |
| RUC |
Número do RUC da empresa (Paraguai) |
| Razão social |
Nome registrado na SET |
| Timbrado |
Número concedido pela SET (formato 8-9 dígitos) |
| Token CSC |
Chave de API (gerada no portal FacturaSend) |
| Ambiente |
Teste ou Produção |
| URL endpoint |
Geralmente preenchida automaticamente |
Pegadinhas frequentes
1. Confundir ambiente teste com produção. Ativar produção sem ter testado = primeira emissão real falha.
2. Token CSC errado/expirado. Conexão falha. Renove.
3. Timbrado esgotado sem aviso. Configure alerta quando faltarem 100 números.
4. RUC com formato errado. Confira dígito verificador.
5. Atualização de credencial sem testar. Mudou token, esqueceu de testar — emissão para de funcionar.
FAQ
Posso ter mais de um RUC no mesmo Quaza?
Sim — multi-empresa. Cada uma com suas credenciais.
Quanto tempo leva pra ter timbrado?
SET aprova em poucos dias. Depois é só cadastrar no FacturaSend.
Posso alternar entre teste e produção?
Sim — botão na configuração. Sempre teste antes de produção.
Token CSC vence?
Depende da config do FacturaSend. Geralmente longo prazo. Renove proativamente.
Configuração afeta empresas existentes?
Não — Quaza vincula configuração à empresa específica.
Boas práticas operacionais
Esta seção reúne hábitos que provedores experientes adotam pra evitar problemas recorrentes neste módulo. Aplicação consistente faz diferença grande no longo prazo — diferença entre operação caótica e operação previsível.
Revisão periódica
Reserve 30 minutos por semana pra revisar o estado do módulo: o que rodou, o que falhou, o que ficou pendente. Anomalia detectada cedo custa 10x menos que descoberta tarde.
Documentação de procedimentos
Crie checklists internos pra operações recorrentes — abertura/fechamento do mês, processamento em lote, correção de inconsistências. Não dependa de quem "sabe de cabeça" — funcionário pode sair, ficar doente, ter dia ruim.
Backup antes de operações em massa
Qualquer mudança que afete 100+ registros deve ser precedida de backup ou export. Restaurar uma alteração massiva equivocada é caro; prevenir é simples.
Comunicação com cliente
Mudanças que impactam o cliente (preço, cobrança, regra) devem ser comunicadas com antecedência. Cliente surpreendido reclama; cliente avisado entende.
Indicadores acompanhados
Defina 2-3 indicadores que medem a saúde do módulo. Acompanhe semanalmente. Quando algum sai do range esperado, investigue antes de virar problema visível.
Checklist operacional
Use este checklist como referência rápida para garantir que o módulo está sendo operado corretamente:
-
Configuração inicial validada — todos os campos obrigatórios preenchidos, permissões atribuídas, integrações testadas
-
Equipe treinada — pelo menos dois operadores sabem operar; redundância previne paralisação
-
Procedimento documentado — passo a passo de operações recorrentes disponível em local acessível
-
Backups em dia — backup automático rodando, último restore testado nos últimos 90 dias
-
Monitoramento ativo — alertas configurados para falhas críticas, logs sendo revisados semanalmente
-
Plano de contingência — se o módulo cair, equipe sabe como operar manualmente até voltar
-
Auditoria periódica — revisão mensal de inconsistências; trimestral de eficiência operacional
-
Documentação de mudanças — alterações relevantes registradas (data, autor, motivo, impacto)
Indicadores típicos a acompanhar
Cada provedor define seus próprios KPIs, mas alguns são quase universais para este tipo de operação:
- Volume mensal processado (registros, transações, eventos)
- Taxa de erro (% de operações que falharam)
- Tempo médio de resposta/processamento
- Cobertura (% da carteira atendida pelo módulo)
- Satisfação operacional (feedback da equipe que usa)
Compare valores atuais com média dos últimos 3 meses. Variação maior que 20% em qualquer direção merece investigação — pode ser melhoria sustentável ou degradação silenciosa.
Documentos relacionados