Treeunfe API B2C home pagelight logo
  1. Distribuição ADN
  2. Consulta pontual na ADN
POST
/nfse/distribute
curl --request POST \
     --url https://api.treeunfe.com.br/api/v1/nfse/distribute \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "nsu": 123.45,
  "lote": true,
  "cnpjConsulta": "<string>"
}'

Faz uma única consulta de documentos na ADN a partir de um NSU. Sem nsu, continua do último NSU baixado. Para baixar tudo o que estiver pendente, prefira Sincronizar distribuição.

A distribuição não emite nota: ela baixa documentos em que a empresa aparece, emitidos por terceiros.

​
Autenticação

x-api-key
required
string

API Key da empresa. A empresa precisa de certificado A1 válido.

​
Body

application/json

nsu
number

NSU inicial. Padrão: o último NSU baixado pela empresa.

lote
boolean

true traz um lote de documentos; false traz só um. Padrão: false.

cnpjConsulta
string

CNPJ do consulente (14 dígitos).

​
Respostas

StatusDescrição
200Consulta realizada.
401x-api-key ausente ou inválida.
422Erro na consulta à ADN.
429Limite de requisições excedido.
curl -X POST "https://api.treeunfe.com.br/api/v1/nfse/distribute" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lote": true
  }'