Guia de integração
Ambientes: simulação, homologação e produção
O ambiente vai no campo `ambiente` da solicitação. A URL base da API é a mesma; o valor informado decide se a nota será simulada, enviada ao ambiente de testes da prefeitura ou emitida com validade fiscal.
Exemplo
GET https://apifiscal.weesy.com.br/v1/municipios/3550308
Na resposta, confira `atendido`, `padrao`, `homologacaoDisponivel` e se há exigência de certificado.Simulação
Use simulacao para desenvolver e testar sem certificado. A Weesy simula o fluxo fiscal: a nota não é enviada à prefeitura e o PDF vem marcado “SEM VALOR FISCAL”.
Homologação
Use homologacao para enviar ao ambiente de testes da prefeitura. A empresa precisa ter certificado digital e a cidade precisa oferecer homologação. Consulte a cidade antes de escolher esse ambiente.
Produção
Use producao para emitir uma nota fiscal válida. No período de teste grátis, a produção pode estar bloqueada para a empresa.
Confira a cidade antes de emitir
A consulta de municípios informa se a cidade é atendida, qual padrão fiscal usa, se oferece homologação e se exige certificado. Quando a cidade não tem homologação, faça os testes em simulacao.
Observação: Os três ambientes usam https://apifiscal.weesy.com.br/v1. Você escolhe o ambiente no corpo da emissão.