Guia de integração

Repetir sem duplicar

Ao criar um documento fiscal, envie um `idIntegracao` estável por operação. Ele permite repetir uma chamada com segurança quando a resposta se perde.

Exemplo

{
  "idIntegracao": "pedido-10432",
  "cnpjEmitente": "21664333000195",
  "ambiente": "homologacao",
  "servico": 42,
  "valorServico": 100.00
}

Como escolher a chave

Gere a chave no seu sistema antes da primeira chamada. Use até 60 caracteres, não a recicle para outro documento e persista-a junto ao pedido que originou a emissão.

Respostas repetidas

A primeira criação retorna 201. A repetição com o mesmo emissor, chave e corpo retorna 200 com o mesmo recurso. Se a chave for reutilizada com corpo diferente, a API retorna 409 idintegracao_reutilizado. Chamadas concorrentes não devem criar dois documentos.

Tratamento de timeout

Se a conexão cair sem resposta, repita a requisição com a mesma chave e o mesmo corpo, ou consulte a nota pelo idIntegracao. Não gere uma chave nova só porque houve timeout.

Observação: A chave é delimitada pelo parceiro e CNPJ do emissor. Para detalhes e exceções de reprocessamento, consulte a operação de emissão na referência NFS-e.

← Voltar ao início