Guia de integração

Primeiros passos

Use o token da empresa para fazer uma emissão de teste sem mandar a nota para a prefeitura.

Exemplo

curl --request POST \
  --url https://apifiscal.weesy.com.br/v1/nfse \
  --header "Authorization: Bearer $WEESY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"idIntegracao":"pedido-10432","cnpjEmitente":"21664333000195","ambiente":"simulacao","servico":{"id":42},"valorServico":100.00,"discriminacao":"Suporte técnico","tomador":{"tipoPessoa":"J","cpfCnpj":"11222333000181","nome":"EMPRESA EXEMPLO LTDA","endereco":{"cep":"01001000","logradouro":"Rua Exemplo","numero":"100","bairro":"Centro","codigoIbge":"3550308"}}}'

1. Gere o token da empresa

No ERP Weesy, entre com o usuário dono da conta, abra Integração por API e gere um token. Copie-o na hora e guarde-o como segredo no servidor.

2. Confira a cidade

Consulte a cidade da empresa pela rota de municípios. A resposta informa se a Weesy atende a cidade, qual padrão fiscal ela usa e se existe ambiente de homologação.

3. Cadastre o serviço fiscal

Escolha o código de serviço aceito pela prefeitura e cadastre o serviço uma vez para a empresa. Antes de emitir, você pode simular a nota para conferir valores e informações.

4. Faça a primeira emissão de teste

Use ambiente: simulacao. A Weesy percorre o fluxo de emissão sem certificado e sem enviar a nota à prefeitura. A resposta 201 só confirma que a solicitação foi recebida; consulte a nota ou aguarde o webhook para ver o resultado.

Observação: A simulação não tem validade fiscal. Para emitir uma nota válida, use produção somente depois de conferir as regras da sua empresa e da prefeitura.

← Voltar ao início