openthorDocumentação

list_invoices

Notas fiscais (faturas) do período · domínio Vendas · escopo mcp:sales

O que faz

Lista de notas fiscais de saída em um período, com valor, custo e margem. Filtre por cliente (customer_code) ou vendedor (rep_code).

Parâmetros

ParâmetroTipoObrigatórioPadrãoSignificado
fromdata (YYYY-MM-DD)sim
todata (YYYY-MM-DD)sim
customer_codeintegernão
rep_codeintegernão
limitinteger (1–1000)não100

O que você recebe

  • invoice_id — Nº interno da NF
  • billed_at — Emitida em
  • customer_code — Cliente (cód.)
  • rep_code — Vendedor (RCA)
  • revenue_amount — Faturamento (R$)
  • cost_amount — Custo (R$)
  • margin_amount — Margem (R$)

Por trás da ferramenta

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