openthorDocumentação
Abrir o painel

find_invoices_by_number

Buscar notas fiscais pelo número (lote) · domínio Vendas · escopo mcp:sales

O que faz

Busca notas fiscais de saída pelo NÚMERO DA NOTA (NUMNOTA da DANFE) — individual ou em LOTE (até 200) — e retorna cabeçalho + itens: produto, código de barras do CADASTRO (EAN-13/DUN-14) E a EMBALAGEM FATURADA (unidade, código de barras e fator por embalagem exatamente como saíram na nota), quantidade e valor. Números NÃO ENCONTRADOS voltam como linhas com matched=false. Aceita NUMTRANSVENDA via number_kind. Use para 'quais produtos foram vendidos nas notas X, Y, Z?', validação de arquivo SID, conciliação fiscal ou auditoria.

Exemplo de pergunta

“quais produtos foram vendidos nas notas X, Y, Z?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
invoice_numbersarraysim—Números de nota (NUMNOTA) a buscar. Duplicatas são deduplicadas.
number_kindstring (numnota · numtransvenda)nãonumnotaNUMNOTA da DANFE (padrão) ou NUMTRANSVENDA (ID transacional interno).
supplier_codeintegernão—Filtra os ITENS por fornecedor (código do fornecedor).
limitinteger (1–5000)não2000

O que você recebe

  • requested_number
  • matched
  • invoice_number — Nº da nota
  • invoice_id — Nº interno da NF
  • billed_at — Emitida em
  • customer_code — Cliente (cód.)
  • rep_code — Vendedor (RCA)
  • revenue_amount — Faturamento (R$)
  • product_code — Produto (cód.)
  • description — Descrição
  • supplier_code — Fornecedor (cód.)
  • ean13 — EAN-13 (unidade)
  • qty — Quantidade
  • line_revenue — Receita da linha (R$)
  • sold_unit
  • sold_barcode

Cuidados ao ler o resultado

Leia antes de interpretar
  • Não encontrados = linhas com matched=false (número pedido sem NF correspondente).
  • Retorna o cadastro ATUAL (ean13/dun14) E a embalagem FATURADA (sold_unit, sold_barcode, sold_qty_per_pack — como saiu na nota).
  • sold_barcode vem de PCMOV.CODAUXILIAR (NUMBER, sem flag GTIN): pode perder zeros à esquerda e não é reparável — para identidade confiável use ean13. sold_unit (UN/CX/DP/FD) é o campo confiável da embalagem.
  • NUMNOTA pode repetir entre séries/filiais; itens de produto fora de linha aparecem normalmente.

Por trás da ferramenta

Esta ferramenta consulta o endpoint /v1/find/invoices-by-number da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.