Guias

Integre com a API Fiscal

Orientações práticas para autenticar, emitir e tratar as respostas da API.

• Primeiros passos — Como obter credencial, autenticar e fazer a primeira chamada à API Fiscal Weesy.
• Ambientes: simulação, homologação e produção — Entenda como escolher o ambiente da NFS-e e conferir o que a prefeitura oferece.
• Autenticação — Autenticação por credencial de parceiro ou de emissor na API Fiscal Weesy.
• Erros e suporte — Formato problem+json, códigos de erro e uso de traceId na API Fiscal Weesy.
• Repetir sem duplicar — Como repetir uma solicitação sem criar documentos fiscais duplicados.
• Sincronização — Paginação por cursor e atualização incremental de NFS-e.
• Cadastro de serviço fiscal — Como consultar e cadastrar serviços fiscais vinculados ao município do emissor.
• Webhooks — Recebimento, deduplicação e validação ES256 dos webhooks da API Fiscal Weesy.
• Versionamento — Política de compatibilidade e depreciação das APIs fiscais Weesy.
• Limites e retentativas — Como tratar respostas 429, Retry-After e indisponibilidade temporária.