MercadoE OData MCP Server

Query OData

Ferramenta universal para executar queries OData em QUALQUER entidade da API MercadoE. Use para análises complexas, correlação entre tabelas e investigações profundas. Entidades disponíveis (cada uma é independente, vinculadas por IDs compartilhados): CORE: Requests, RequestItems, RequestApprovals, RequestBorgs, RequestItemStatus, RequestItemDeliverySchedules, RequestAttributes, RequestAddresses, RequestItemBorgs, RequestItemMags, RequestItemAttributes, PreOrderItemRequests, RfqItemRequests PRO

Aggregate OData

Agrupa e agrega dados em memória (sum, count, avg, min, max) sem depender da API OData $apply (que está quebrada). Use para análises dimensionais: "total de pedidos por status", "maior valor por fornecedor", "quantidade média por categoria", etc. Como funciona: 1. Busca TODOS os registros do filtro via paginação (executeODataAllPages) 2. Agrupa em memória pelo campo groupBy 3. Aplica operações de agregação (sum/count/avg/min/max) a cada grupo 4. Ordena pelo campo de agregação (descending por pa

Get Orders

Busca pedidos de compra (Orders) com análise do ciclo de procurement. Use para rastrear status de pedidos, verificar entregas, analisar fornecedores. Para itens do pedido, use query_odata com resource 'OrderItems' e filtro OrderId. Entidades relacionadas: OrderItems, OrderBorgs, OrderItemRequests, OrderItemDeliveries, OrderAddresses, OrderAttributes, OrderItemDates. CAMPOS DISPONÍVEIS em Orders: OrderId, ClientCode, Summary, SentDate, ReceivedDate, ConfirmationDate, DeadLine, Total, TotalWithTa

Get Order Detail

Busca COMPLETA de um pedido em uma única chamada, paralelizando 10 consultas: - Orders (cabeçalho) - OrderItems (linhas) - OrderItemDeliveries (entregas por item) - OrderBorgs (centros de custo / empresa no cabeçalho) - OrderItemRequests (origem: qual requisição gerou cada item) - OrderAddresses (endereços de entrega/cobrança) - OrderItemDates (timeline detalhada por item: envio, confirmação, recebimento) - OrderItemBorgs (centros de custo por ITEM — granularidade fina) - OrderAttributes (atribu

Get Request Detail

Busca COMPLETA de uma requisição em uma única chamada, paralelizando 15 consultas (OData + REST): HEADER: - Requests (cabeçalho) - RequestBorgs (centros de custo / empresa / org. de compra do cabeçalho) - RequestAttributes (atributos customizados do cabeçalho) - RequestAddresses (endereços de entrega) ITENS: - RequestItems (linhas) - RequestItemStatus (histórico de status por item COM RfqId/PreOrderId vinculados — diz qual cotação/PO cada item virou) - RequestItemDeliverySchedules (cronograma de

Get Request Items Tracking

Rastreia o fluxo detalhado dos itens de uma requisição, buscando prazos de entrega prometidos em RFQs (Cotações) ou PreOrders. Use para responder: "Qual o prazo de entrega prometido para o item X?" ou para auditar atrasos em requisições pendentes.

Get Request Item Approvers

Consulta a lista completa de aprovadores de todos os itens de uma requisição específica. Retorna detalhes como nome do aprovador, data de aprovação e status inicial/final por item.

Get Request Cost Objects

Consulta objetos de custo e unidades organizacionais (centros de custo, empresas, organizações de compra) de requisições. Modos de uso: - RequestId: retorna os objetos de custo (REST) + unidades organizacionais (RequestBorgs OData) da requisição - CostCenterName: busca na entidade RequestBorgs pelo nome do centro de custo/empresa/organização (ex: "Tamboré", "Cinemark") - Ambos: combina os dois resultados A entidade RequestBorgs retorna campos como: Name, Code, VentType (Center, Company, Purcha

Get Request Item Deliveries

Busca o cronograma de entrega (datas e quantidades) de um item específico de uma requisição. Use para verificar quando partes de um item solicitado estão programadas para chegar.

Get Procurement Flow

Rastreia o fluxo completo de procurement a partir de QUALQUER ID (Request, Order, RFQ ou PreOrder). Busca a cadeia relacional: Request → Order → Invoice → Contract em paralelo. Use quando o usuário quer "investigar" ou "rastrear" um fluxo de compra. Exemplo: "Investigue o pedido 39528467" → busca o pedido e automaticamente rastreia Request, Invoice e Contract vinculados.

Get Requests

Busca requisições de compra (Requests) com rastreamento e aprovações. Use para localizar requisições por ID, status, solicitante, título, cliente ou data de criação. Exemplos de uso: - Buscar por ID: RequestId='44863914' - Buscar por status: StatusCode=1 - Buscar por solicitante: RequesterName='João' - Buscar por título: Title='manutenção' - Alternativa via query_odata: resource='Requests', filter="RequestId eq '44863914'" IMPORTANTE — Campos da entidade Requests (payload real): - RequestId: I

Get Request By ID (REST)

Busca dados de uma única requisição de compra através da API REST legada. Use esta tool quando precisar buscar especificamente uma requisição pelo seu ID (RequestId), evitando problemas de falha de validação de token que ocorrem na busca via OData.

Get Invoices

Busca notas fiscais (Invoices) para reconciliação financeira e análise de faturamento. Use para verificar faturas de fornecedores, status, valores, número de NF, vínculo com pedidos. CAMPOS DISPONÍVEIS em Invoices: InvoiceId, SupplierId, SupplierName, Status, CategoryCode, InvoiceNumber (string ex: '3166566581'), Total (number), DocumentNumber (CNPJ do fornecedor, só dígitos), Discounts, Freight, Note, IssuedBy, CreatedDate, PaymentDate, DueDate, UpdatedAt, SupplierAddress/Number/Complement/Dis

Get Contracts

Busca contratos (Contracts) para análise de saldo, vínculo com fornecedores e gestão contratual. Use para verificar saldos contratuais, itens contratados e aprovações. Entidades relacionadas (consultar via query_odata com ContractId): ContractItems, ContractApprovals, ContractAttributeValues, ContractBorgs, ContractItemTaxes. ⚠️ ATENÇÃO: Verifique os campos de data disponíveis antes de filtrar. Nem todas as entidades possuem 'CreatedDate'.

Get Products

Busca produtos do catálogo (Products) para inteligência de catálogo e estoque. Use para encontrar detalhes de produtos e atributos. Entidades relacionadas (consultar via query_odata com ProductId): ProductAttributes. Exemplo: "Encontre detalhes do produto" → use Description como filtro

Get RFQs

Busca cotações (RFQs) para análise de sourcing estratégico. Use para acompanhar processos de cotação, respostas de fornecedores e contrapropostas. Entidades relacionadas (consultar via query_odata com RfqId): RfqItems, RfqResponseItems, RfqResponseItemCounterProposals, RfqResponseItemHistory, RfqBorgs, RfqAttendees, RfqTasks, RfqItemRequests. CAMPOS DISPONÍVEIS: RfqId, Summary, ClientCode, CustomerId, CustomerTradingName, OwnerId, OwnerName, Deadline, CreatedDate, CategoryName, CategoryDescript

Get Pre-Orders

Busca pré-pedidos (PreOrders) para visibilidade do pipeline de pré-procurement. Use para acompanhar pré-pedidos antes de virarem pedidos formais. CAMPOS DISPONÍVEIS em PreOrders (todos String salvo indicado): PreOrderId, ClientCode, Summary, Note, SentDate (date), DeadLine (date), DeliveryDate (date), ApprovalDate (date), Invisible (bool), CategoryName, CurrencyCode, Freight (double), IcoTerms, Total (double), TotalWithTaxes (double), SupplierId, SupplierIdentity, SupplierName, SupplierTradingN

Get Suppliers

Busca fornecedores do catálogo (entidade OData Suppliers) e entidades correlatas. Entidades relacionadas (consultar via query_odata com SupplierId): SupplierAttributes, SupplierGroups, SupplierBorgs. CAMPOS DISPONÍVEIS em Suppliers: SupplierId, SupplierName, SupplierCode, DocumentNumber (CNPJ), Contact, Email, AddressNumber, Street, Neighborhood, City, State, Country, Complement, PostalCode, AverageScore, SupplierHomologationStatus, UpdatedAt, TimeKey.

Get Service Orders

Busca ordens de serviço (ServiceOrders) e suas folhas de medição. Entidades relacionadas (consultar via query_odata com ServiceOrderId): ServiceSheets, ServiceSheetItems. Use para acompanhar execução de serviços e medições contratuais.

Get Tracking Transactions

Busca em TrackingTransactions — a tabela DESNORMALIZADA que rastreia um item através de TODO o fluxo de procurement. Cada linha conecta um produto a qualquer combinação de Requisição → Cotação → Pré-Pedido → Pedido → Nota Fiscal → Contrato, com IDs, quantidades, datas e responsáveis de cada fase em colunas próprias. USE para perguntas de rastreio cruzado: "por onde passou o produto X?", "qual o caminho do pedido Y até a nota?", "quais requisições viraram cotação?", "o que está pendente de compr

Get Lead Time Metrics

Calcula o lead time (em dias) entre abertura de Requisição e criação de Pedido. Use para perguntas de lead time: "qual o lead time médio dos pedidos de junho?", "quanto tempo a requisição X levou para virar pedido?", "lead time do pedido Y". Retorna estatísticas agregadas (média, mediana, min, max, contagem) — NÃO retorna as linhas cruas. FILTROS (combinam com AND — informe ao menos um): - OrderCreatedDateFrom/To: período em que o PEDIDO foi criado (ex: "pedidos de junho") - RequestCreatedDateF

Get Invoice Detail

Visão completa de UMA nota fiscal em uma única chamada: cabeçalho + itens + vínculo com pedidos (InvoiceItemOrders) + aprovações + atributos + anexos. Tudo paralelizado. Use para auditoria financeira de uma NF específica ou para responder "quais pedidos essa nota cobre?", "qual o XML/PDF dessa NF?", "quem aprovou essa nota?".

Global Search

Busca global cross-domain: procura um ID ou termo em múltiplas entidades simultaneamente. Use quando o usuário não sabe em qual domínio está o dado, ou para correlação entre domínios. Busca em: Orders, Requests, Invoices, Contracts, PreOrders. Exemplo: "Investigue o fluxo de procurement" → busca o ID em Requests → Orders → Invoices (cadeia relacional)