`GET /v1/find/invoices-by-number`

Busca notas fiscais pelo número (NUMNOTA), em lote, com itens e códigos de barras; reporta não encontrados. · domínio Vendas

Exemplo

cURL

curl -H "Authorization: Bearer ot_live_SEU_TOKEN_AQUI" \
  "https://api.openthor.dev/v1/find/invoices-by-number?invoice_numbers=123&limit=5"

A autenticação e o formato do envelope { data, meta } são comuns a todos os endpoints — veja Autenticação e Resposta e metadados.

Parâmetros

Este endpoint é uma função: aceita somente os parâmetros abaixo (a sintaxe genérica de filtros não se aplica).

Parâmetro	Tipo	Obrigatório	Padrão	Máximo
`invoice_numbers` — invoice_numbers	bigint[]	sim	—	200
`number_kind` — number_kind	text	não	—	—
`supplier_code` — supplier	int	não	—	—

Colunas retornadas

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

Ordenação e paginação

Ordene com sort=coluna (crescente) ou sort=-coluna (decrescente). Colunas ordenáveis: requested_number · invoice_number · product_code. Limite padrão 2000, máximo 5000 linhas por chamada; pagine com offset enquanto meta.has_more for true.

O que sua chave enxerga

O recorte da credencial (filial, vendedor, cliente, fornecedor, janela de datas) é aplicado no servidor e não pode ser ampliado por filtros — dois usuários podem ver totais diferentes no mesmo endpoint, por desenho.

Ferramentas MCP sobre este endpoint

find_invoices_by_number — Buscar notas fiscais pelo número (lote)

Esta página ajudou? Conte para a gente — lemos tudo.