Ferramenta
list_business_invoices
Exemplo de chamada
{
"method": "tools/call",
"params": {
"name": "list_business_invoices",
"arguments": {
"document": "19131243000197"
}
}
}
Exemplo de resultado
O objeto abaixo é retornado emstructuredContent.
{
"object": "list",
"data": [
{
"object": "invoice",
"record_type": "invoice",
"business_role": "issuer",
"access_key": "00000000000000000000000000000000000000000001",
"number": "1",
"issued_at": "2025-01-02",
"issuer_legal_name": "Empresa de teste",
"recipient_name": "Destinatário de teste",
"amount": "123.45"
}
],
"document": "19131243000197",
"updated_at": "2026-11-01T00:00:00Z"
}
Schema dos parâmetros
Schema dos parâmetros
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"document": {
"type": "string",
"pattern": "^(?:[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
"description": "CNPJ completo, com ou sem pontuação.",
"title": "CNPJ"
}
},
"required": [
"document"
],
"additionalProperties": false,
"examples": [
{
"document": "19131243000197"
}
]
}
Schema do resultado
Schema do resultado
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"object": {
"type": "string",
"const": "list",
"description": "Coleção de objetos Base39."
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"object": {
"type": "string",
"const": "invoice",
"description": "Tipo do objeto Base39."
},
"record_type": {
"type": "string",
"enum": [
"invoice",
"item",
"event"
],
"description": "Tipo de registro."
},
"business_role": {
"type": "string",
"enum": [
"issuer",
"recipient"
],
"description": "Papel do CNPJ na nota fiscal."
},
"access_key": {
"type": "string",
"minLength": 1,
"description": "Chave de acesso da nota fiscal."
},
"model": {
"type": "string",
"description": "Modelo da nota fiscal."
},
"series": {
"type": "string",
"description": "Série da nota fiscal."
},
"number": {
"type": "string",
"description": "Número de identificação."
},
"operation_type": {
"type": "string",
"description": "Natureza da operação."
},
"issued_at": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Data de emissão."
},
"last_event": {
"type": "string",
"description": "Evento mais recente."
},
"last_event_date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Data do evento mais recente."
},
"issuer_legal_name": {
"type": "string",
"description": "Razão social do emitente."
},
"issuer_state_registration": {
"type": "string",
"description": "Inscrição estadual do emitente."
},
"issuer_state": {
"type": "string",
"description": "Unidade federativa do emitente."
},
"issuer_city": {
"type": "string",
"description": "Município do emitente."
},
"recipient_parent_authority_code": {
"type": "string",
"description": "Código do órgão superior destinatário."
},
"recipient_parent_authority_name": {
"type": "string",
"description": "Nome do órgão superior destinatário."
},
"recipient_authority_code": {
"type": "string",
"description": "Código do órgão destinatário."
},
"recipient_authority_name": {
"type": "string",
"description": "Nome do órgão destinatário."
},
"recipient_name": {
"type": "string",
"description": "Nome do destinatário."
},
"recipient_state": {
"type": "string",
"description": "Unidade federativa do destinatário."
},
"operation_destination": {
"type": "string",
"description": "Destino da operação."
},
"final_consumer": {
"type": "string",
"description": "Indicação de consumidor final conforme publicada."
},
"buyer_presence": {
"type": "string",
"description": "Presença do comprador conforme publicada."
},
"amount": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?$",
"description": "Valor em reais, como texto decimal."
},
"product_number": {
"type": "string",
"description": "Número do produto."
},
"description": {
"type": "string",
"description": "Descrição informada."
},
"ncm_code": {
"type": "string",
"description": "Código NCM."
},
"ncm_type": {
"type": "string",
"description": "Tipo NCM."
},
"cfop": {
"type": "string",
"description": "Código Fiscal de Operações e Prestações."
},
"quantity": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?$",
"description": "Quantidade informada, como texto decimal."
},
"unit": {
"type": "string",
"description": "Unidade informada."
},
"unit_amount": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?$",
"description": "Valor unitário em reais."
},
"total_amount": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?$",
"description": "Valor total em reais."
},
"event": {
"type": "string",
"description": "Evento da nota fiscal."
},
"event_date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Data do evento."
},
"reason": {
"type": "string",
"description": "Motivo informado."
}
},
"required": [
"object",
"access_key"
],
"additionalProperties": false
},
"description": "Objetos da coleção."
},
"next_cursor": {
"description": "Cursor opaco da próxima página; ausente ao final.",
"type": "string"
},
"document": {
"type": "string",
"minLength": 1,
"description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
},
"updated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "Data e hora da última atualização publicada, em ISO 8601."
}
},
"required": [
"object",
"data",
"document"
],
"additionalProperties": false,
"examples": [
{
"object": "list",
"data": [
{
"object": "invoice",
"record_type": "invoice",
"business_role": "issuer",
"access_key": "00000000000000000000000000000000000000000001",
"number": "1",
"issued_at": "2025-01-02",
"issuer_legal_name": "Empresa de teste",
"recipient_name": "Destinatário de teste",
"amount": "123.45"
}
],
"document": "19131243000197",
"updated_at": "2026-11-01T00:00:00Z"
}
]
}