DF-e

Checkpoint NSU

Consulta e força/corrige o NSU (Número Sequencial Único) de onde a Distribuição continua buscando documentos novos -- um checkpoint por (contribuinte, produto, ambiente). É a mesma tabela usada internamente pelo motor de distribuição, só exposta pra leitura/ajuste manual.

⚠️

Ferramenta de recuperação/suporte, não um parâmetro de cadastro normal. Forçar um NSU errado pode fazer a próxima sincronização pular documentos (NSU maior que o real) ou reprocessar documentos já baixados (NSU menor). Use principalmente depois de um erro reportado pela SEFAZ pra um CNPJ específico, não como rotina.

Consultar GET

GET https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/distribuicao-nsu

Devolve todos os checkpoints já gravados pra este contribuinte, um por (produto, ambiente).

{
  "checkpoints": [
    {
      "product_code": "NFE",
      "environment": "HOMOLOGACAO",
      "last_nsu": 45,
      "updated_at": "2026-08-30T14:22:00-03:00"
    }
  ]
}

Forçar / corrigir POST

POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/distribuicao-nsu

Campo	Obrigatório	Observação
`product_code`	Sim	`NFE`, `CTE`, `MDFE` ou `NFSE`.
`ambiente`	Sim	`HOMOLOGACAO` ou `PRODUCAO`.
`last_nsu`	Sim	Número inteiro maior ou igual a zero.

curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/distribuicao-nsu \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{"product_code": "NFE", "ambiente": "HOMOLOGACAO", "last_nsu": 45}'

Resposta

{
  "checkpoint": {
    "product_code": "NFE",
    "environment": "HOMOLOGACAO",
    "last_nsu": 45
  }
}