Inutilizar números de nota fiscal
POST/v2/companies/:companyId/productinvoices/disablement
Informações adicionais
Caso seja um único número, utilizar o Número inicial e o Número final com o mesmo valor
Request
Responses
- 204
- 400
- 404
- 409
- 422
- 503
Faixa inutilizada na SEFAZ. Não há corpo de resposta: o status HTTP carrega o desfecho. Cobre a homologação (cStat 102) e também os retornos em que a faixa já estava inutilizada — cStat 206 e cStat 563 —, porque o estado desejado foi alcançado e reenviar a mesma faixa é idempotente.
Parâmetro inválido, ou rejeição da SEFAZ que impede a inutilização (code 40001). Ex.: cStat 241 (número da faixa já utilizado) e cStat 256 (NF-e da faixa já inutilizada na base). A mensagem da SEFAZ vai no corpo.
Empresa não encontrada (code 40401)
Outra chamada para a mesma faixa está em processamento (code 40902). O lock por faixa serializa o double-submit; o cabeçalho Retry-After diz em quantos segundos repetir. Retentar é seguro: a inutilização é idempotente.
Rejeição da SEFAZ fora do conjunto mapeado (code 42201). Ex.: cStat 781 (emissor não habilitado). A mensagem da SEFAZ vai no corpo.
SEFAZ indisponível ou falha de comunicação com o gateway