Emitindo uma NFS-e

Padrão Nacional

POST /v1/nfse/emitir

O documento é a DPS (Declaração de Prestação de Serviços), no bloco infDPS. A partir dela o Ambiente Nacional gera a NFS-e.

Provedor municipal

POST /v1/nfse/govdigital/emitir

Segue o modelo ABRASF, com RPS (Recibo Provisório de Serviços) convertido em NFS-e pelo município.

Os dois caminhos devolvem 202 com job_id e são acompanhados da mesma forma.

Quando o retorno se perde

A NFS-e é onde mais aparece o "fantasma"

Um timeout do município não significa que a nota não foi gerada. Ela pode existir na prefeitura sem que a resposta tenha chegado até aqui — e reenviar cria uma segunda nota de serviço.

Antes de reenviar, consulte pelo RPS:

GET /v1/nfse/{cpf_cnpj}/consultar-rps

Ou, no Padrão Nacional, pela chave:

POST /v1/nfse/consultar-sefaz

E, do lado do Conota, localize a operação:

GET /v1/jobs/localizar?ref=sua_referencia

Cancelamento

POST /v1/nfse/cancelar

Prazos e regras de cancelamento de NFS-e são municipais e variam bastante — alguns municípios exigem substituição em vez de cancelamento. Confirme a regra do município antes de prometer o comportamento ao usuário final.