Developer

Portuguese

English

Portuguese

English

Appearance

Novidades ​

Confira as principais atualizações que ocorreram nas documentações:

🆕 01 de outubro de 2026 ​

Reorganização dos guias do Partner Portal. As páginas que documentam telas do Partner's Portal agora ficam na seção Partner Portal, logo depois da Home, com os mesmos nomes do menu do portal:

AntesAgora
Home > Credenciais (/guides/credentials)Partner Portal > API Keys
Home > Credenciais > Convite de usuário desenvolvedorPartner Portal > Membros (nova página)
Home > Webhooks (/guides/webhooks)Partner Portal > Webhooks
Home > Log de entrada (/guides/input-logs)Partner Portal > Monitoramento > Tráfego
Partner Portal > Submissão de DocumentosPartner Portal > Monitoramento > Submissão de Documentos
Partner Portal > Dashboard de monitoramentoPartner Portal > Dashboard
iPaaSPartner Portal > Integrações

ℹ️ Nota

Os endereços antigos continuam funcionando e redirecionam automaticamente para os novos. Se você salvou algum link, atualize-o quando puder.

O conteúdo dessas páginas foi revisado para refletir as telas atuais do portal:

  • API Keys: criação (Criar Novo > Gerar API Key, com a Secret exibida uma única vez) e exclusão;
  • Membros: perfil desenvolvedor, convite pelo portal do ME ou pela tela Membros e revogação de acesso;
  • Tráfego: acesso por Monitoramento > Tráfego, data no fuso do navegador, filtros (período, status, método e filtros salvos) e detalhe da requisição;
  • Webhooks: abas Inscrições, Credenciais, Buckets e Autenticação, campos e validações dos formulários, overrides do OAuth2 e a tela Monitoramento > Eventos;
  • Dashboard e Submissão de Documentos: limite de 1 ano no período, comportamento do Recarregar e dos atalhos para Tráfego e Eventos, e novos estados de erro do envio.

🆕 29 de setembro de 2026 ​

Nova seção de guias do Partner Portal > Integrações, a área do iPaaS (Integration Platform as a Service):

Novo guia do Partner Portal > Monitoramento:

  • Submissão de Documentos: como enviar payloads direto às APIs do ME pelo portal, com validação contra o schema, confirmação em produção, leitura da resposta e rastreio no Tráfego.

🆕 28 de setembro de 2026 ​

Novo guia do Partner Portal:

  • Dashboard: indicadores de execuções, taxa de sucesso, falhas e webhooks esgotados, comparativo com o período anterior, gráficos de tráfego e de resultados de integração, e a lista de falhas com o passo a passo de investigação.

🆕 08 de setembro de 2026 ​

Atualizações na Products API:

Atualizações na Quotations API:

🆕 20 de agosto de 2026 ​

Atualizações na Service-Sheet API:

🆕 19 de agosto de 2026 ​

Atualizações na Quotations API:

🆕 14 de agosto de 2026 ​

Atualizações na Quotations API:

🆕 03 de agosto de 2026 ​

Atualizações na Contracts API:

🆕 28 de julho de 2026 ​

  • Atualizações na Requests API: Campo requestItems no request body de POST /v1/requests agora é obrigatório;

  • Atualizações na Pre-Orders Api: Campo selectionJustification adicionado na resposta 200 de GET /v1/pre-orders/{preOrderId}/items — justificativa de seleção do item no pré-pedido (string, nullable);

  • Atualizações na Orders API: Campo reason do request body de PATCH /v1/orders/supplier-orders/{orderId}/reject e PUT /v1/orders/supplier-orders/{orderId}/reject: enum inline movido para schema de componente RejectionReason (valores mantidos, refatoração estrutural);

🆕 02 de julho de 2026 ​

Atualizações na Contracts API:

  • Campo requestItemId (integer, nullable) adicionado à resposta de GET /v1/contracts/{contractId}/items — número sequencial do item da requisição.

Atualizações na Pre-Orders Api:

  • Campo selectionJustification (string, nullable) adicionado à resposta de GET /v1/pre-orders/{preOrderId}/items — justificativa para seleção do item no pré-pedido.

Atualizações na Orders API:

  • Campo productIdentificationCode adicionado ao request body de POST /v1/orders em Create an order.
  • Campo productIdentification adicionado ao request body de PUT /v1/orders/{orderId} em Update an order based on the order Id.
  • Campo productIdentificationCode (string, deprecated) adicionado ao request body de PUT /v1/orders/{orderId} — código de identificação do produto (NBM/NCM), marcado como depreciado em Update an order based on the order Id.

🆕 29 de junho de 2026 ​

Adição de novos Webhooks:

  • request-item.canceled
  • request.attachment.deleted
  • request.attachment.created
  • request.updated.history
  • preorder.resubmitted

🆕 19 de junho de 2026 ​

Atualizações na Contracts API:

Atualizações na Products API:

  • Endpoint removido: GET /v1/products/vat-determination — Get all VAT determination records.
  • Endpoint removido: POST /v1/products/vat-determination — Create VAT determination records.
  • Endpoint removido: PUT /v1/products/vat-determination/{id} — Update a VAT determination record.

Atualizações na Orders API:

🆕 16 de junho de 2026 ​

Atualizações na Products API:

  • Novo endpoint: GET /v1/products/vat-determination — Get all VAT determination records.
  • Novo endpoint: POST /v1/products/vat-determination — Create VAT determination records.
  • Novo endpoint: PUT /v1/products/vat-determination/{id} — Update a VAT determination record.

Atualizações na Requests API:

  • Novo endpoint: GET /v1/requests/{requestId}/items/business-organizations — Get a list of Business Organizations for all items.

🆕 20 de maio de 2026 ​

🆕 14 de maio de 2026 ​

Atualização de Endereços IP de Webhook: remoção dos IPs 20.102.37.227 e 191.232.73.226. O único IP de origem dos webhooks Callback agora é 164.152.52.63.

🆕 07 de maio de 2026 ​

Adição de novo Webhook: request.updated.

🆕 09 de abril de 2026 ​

Adição de informações sobre certificado digital:

  • Nova página de guia Cerfificado digital.
  • Integração nova api.mercadoe.com
  • Integração antiga api.me.com.br

🆕 07 de abril de 2026 ​

Adição de novos Webhooks:

  • contract.approved
  • contract.attachment.created
  • contract.attachment.deleted
  • member.created
  • member.updated
  • order.attachment.created
  • order.attachment.deleted
  • order.cancellation.requested
  • order.item.cancellationrequested
  • order.item.closed
  • order.item.deliverydateupdated
  • order.item.refused
  • order.refused
  • order.update.noapproval
  • service-sheet-document.created

🆕 30 de março de 2026 ​

Atualizações no ME Data Connect:

  • Nova tabela na página Rfqs:
    • RFQShortList + schema joins.

🆕 24 de março de 2026 ​

  • Dashboard de Gestão de Compras

    1. Criação de Dashboard de Gestão de Pedidos - Valor Convertido

      a. Coluna Calculada para Identificação da Taxa cambial por Moeda: Foi criada uma coluna calculada que faz a leitura do campo CurrencyCode e retorna automaticamente a taxa correspondente de acordo com a taxa cambial de cada moeda.

      b. Coluna/Medida de Cálculo do Valor Convertido: Foi adicionada uma nova coluna calculada que multiplica o valor total por linha pela taxa de câmbio identificada, resultando no Valor Total Convertido.

      • Essa métrica permite comparar valores originais com os convertidos.

      c. Inclusão de Cards de Indicadores - O dashboard passou a exibir:

      • Card – Valor Total Original (na moeda do pedido)

      • Card – Valor Total Convertido (conforme filtrado a moeda)

        • Essa visualização facilita a análise gerencial e a validação dos valores utilizados no SPEND.

      d. Ajustes nos Gráficos e Grids - Todos os visuais do relatório foram atualizados para incluir:

      • Valor Total Original

      • Valor Total Convertido

      • Moeda do Pedido

        • Dessa forma, gráficos, grid e indicadores passaram a refletir corretamente tanto os valores nativos quanto os valores convertidos, permitindo análises mais completas e comparáveis.

  • Dashboard de Gestão de Leadtime

    1. Ajuste no Leadtime Aprovação da Requisição até a Criação da Cotação

      • Importante: Quando não existe cotação, o cálculo considera o Pré Pedido; e, se nem isso existir, considera a data de hoje (processo em andamento). Como o cálculo funciona:

        a. Quando existir a data de criação da Cotação (RFQ):

        • Início: Data de Aprovação da Requisição (se não houver a data de aprovação, usa a data de criação da requisição).
        • Fim: Data da Cotação.

        b. Quando não existir a data de criação da Cotação:

        • Início: Data da aprovação da requisição (ou criação da requisição).

        • Fim: Pré-Pedido (ou, se não existir, hoje).

    • Outro cenário identificado que foi ajustado:

      • Regra especial: Se a data de criação do Pré Pedido for maior que a data de aprovação da requisição, é considerada a data de criação da requisição (para manter a linha do tempo correta).

      • Para esse cenário acima, foi desenvolvida uma lógica que usará a data de criação da requisição x data de criação do Pré-Pedido.

  • Dashboard de Gestão de Cotações

    1. Criação de Nova visão (Gestão de Avaliação Técnica por Item): Este dashboard foi criado para ajudar o Gestor de compras a monitorar se as avalições técnicas enviadas aos solicitantes estão sendo respondidas ao nível de item.

  • Identidade Visual ME

    • Os modelos foram atualizados com a nova cor do header e o logo revisado, transformando o dashboard em uma extensão da marca e tornando a comunicação dos dados mais clara, profissional e estratégica.

🆕 18 de março de 2026 ​

Atualizações no ME Data Connect:

  • Nova tabela na página Requests:
    • RequestChangeHistory + schema joins;
    • RequestItemChangeHistory + schema joins.

🆕 16 de março de 2026 ​

Atualizações no ME Data Connect:

  • Nova tabela na página Rfqs:
    • RfqItemEvaluationResponses + schema joins.

🆕 13 de março de 2026 ​

Atualizações no ME Data Connect:

  • Adição do campo SupplierId na tabela RfqTasks.

🆕 06 de março de 2026 ​

Atualizações no ME Data Connect:

  • Nova tabela na página PreOrders:
    • PreOrderApprovalHistory + schema joins.
  • Correção de nomenclatura das seguintes tabelas na página de schemas de Requests:
    • RequestAttributeValues para RequestAttributes;
    • RequestItemAttributeValuespara RequestItemAttributes.

🆕 10 de fevereiro de 2026 ​

Atualizações no ME Data Connect:

  • Nova tabela na página Suppliers:
    • SupplierAttributes + schema joins.

🆕 09 de fevereiro de 2026 ​

Atualizações no ME Data Connect:

  • Adição do campo TimeKey nas seguintes tabelas na página de Rfqs: RfqAttributeValues, RfqBorgs, RfqItemAttributeValues, RfqItemRequests, RfqResponseItems, RfqResponseItemCounterProposals, RfqResponseItemHistory, RfqResponseTaxes e RfqTasks;

  • Adição dos seguintes campos na tabela RfqResponseItems: TimeKey, SupplierOriginId, SupplierOriginDescription, RfqTypeId e RfqTypeDescription;

  • Adição dos seguintes campos na tabela RfqResponseTaxes: TimeKey, ReducedTaxRate e TaxBase;

  • Adição dos seguintes campos na tabela RfqTasks: TimeKey e TaskTypeName.

❗ Atenção: Mudanças nos Campos da API OData.

As seguintes mudanças afetam os campos retornados pela API OData:

  • RfqResponseTaxes:

    • Campo RfqAttendeeId: agora é opcional e o nome foi corrigido de RfqAttedeeId para RfqAttendeeId. Impacto: clientes que utilizam o nome antigo (RfqAttedeeId) precisarão atualizar para RfqAttendeeId. Além disso, devem substituir referências a RfqAttedeeId por RfqAttendeeId em todas as consultas e filtros.
    • Campo RfqItemId: antes era string e agora é long e opcional. Impacto: clientes que fazem comparações ou filtros usando este campo como string precisarão converter para número.

  • RfqItems:

    • Campo RfqItemId: antes era string (marcado como obsoleto) e agora é long e opcional (obsoleto removido). Impacto: clientes que utilizam este campo precisarão converter de string para número.

  • RfqResponseItems:

    • Campo RfqItemId: antes era string (marcado como obsoleto) e agora é long e opcional (obsoleto removido). Impacto: clientes que utilizam este campo precisarão converter de string para número.

  • RfqItemRequests:

    • Campo RfqItemId: antes era string e agora é long e opcional. Impacto: clientes que fazem comparações ou filtros usando este campo como string precisarão converter para número.

  • RfqResponseItemHistory:

    • Campo RfqItemId: antes era string e agora é long e opcional. Impacto: clientes que fazem comparações ou filtros usando este campo como string precisarão converter para número.

  • ContractItemTaxes:

    • Campo Item: antes era string e agora é long e opcional. Impacto: clientes que fazem comparações ou filtros usando este campo como string precisarão converter para número.

🆕 30 de janeiro de 2026 ​

Atualizações no ME Data Connect:

  • Adição de campos na tabela ContractItems: TimeKey, ApplicationType, ApplicationTypeId, UsedQuantity, UsedValue, TotalItemBalanceValue, RemainingBalanceValue e RemainingBalanceQuantity.

🆕 08 de dezembro de 2025 ​

Atualizações no ME Data Connect:

  • Adição de campos na tabela RfqAttendees: TimeKey, Disqualified, DeliveryDeadline, Note, PaymentConditionCode, PaymentConditionDescription, ContactName, Currency, BillingLimit, ProposalValidity e TaxOption.

🆕 03 de dezembro de 2025 ​

Atualização no ME Data Connect:

  • Adição do campo SupplierHomologationStatus na tabela Suppliers.

🆕 02 de dezembro de 2025 ​

Atualizações no ME Data Connect:

  • Adição de campos na tabela RfqItems: TimeKey, ApplicationType, ApplicationTypeId, EstimatedBaselinePrice e ChosenSupplierId.

🆕 5 de novembro de 2025 ​

Nova funcionalidade: Webhooks tipo Bucket (Polling):

  • Lançamento de uma nova modalidade de webhook que utiliza o modelo "pull" (polling) ao invés do tradicional modelo "push" (callback).
  • Ideal para clientes que não podem ou não desejam expor endpoints HTTP na internet, incluindo:
    • ERPs com restrições de firewall ou segurança;
    • Sistemas legados sem capacidade de receber webhooks;
    • Ambientes com menor maturidade técnica para suportar callbacks tradicionais.

🆕 31 de outubro de 2025 ​

Atualizações no ME Data Connect:

  • Novas tabelas na página Orders:

    • OrderAttributes + schema joins
    • OrderItemAttributes + schema joins

  • Novas tabelas na página PreOrders:

    • PreOrderAttributes + schema joins
    • PreOrderItemAttributes + schema joins

  • Novas tabelas na página Products:

    • ProductAttributes + schema joins
    • ProductImages + schema joins

  • Novas tabelas e campos na página Requests:

    • RequestApprovalHistory + schema joins
    • RequestApprovalsUserGroups + schema joins
    • Adição de campos na tabela Requests: TimeKey, LedgerAccountCode e LedgerAccountDescription;
    • Adição de campos na tabela RequestItems: State, AssignedBuyerId, AssignedBuyerName, ApplicationType, ApplicationTypeId, TrackingId, Currency e ExchangeRate.

  • Novas tabelas e campos na página Rfqs:

    • RfqTaskHistories + schema joins
    • RfqTaskEvaluationResponses + schema joins
    • Adição de campo na tabela RfqTasks: UserId

  • Adição de campos na tabela TrackingTransaction: TimeKey, OrderOwnerId, RequestOwnerId, PreOrderOwnerId, RfqOwnerId, InvoiceOwnerId, ProductId, OrderQuantity, RequestQuantity, PreOrderQuantity, RfqQuantity, InvoiceQuantity, RequestItemStateType, ContractId, ContractItemId, ContractCreatedDate, ContractOwnerId e TrackingId.

  • Nova tabela na página Contracts:

    • ContractItemTaxes + schema joins

  • Adição do campo TimeKey nas tabelas Suppliers, SupplierBorgs e SupplierGroups na página Suppliers.

🆕 14 de outubro de 2025 ​

  • Novos campos no ME Data Connect:

    • Campo SnapshotAtem diversas tabelas de: Contracts, Invoices, Orders, Pre Orders, Products, Requests, Rfqs, Service Orders, Service Sheets, Suppliers, Tracking Transactions e Users;
    • Campos PaymentDatee DueDate na Invoices;
    • Campo Notena Rfqs;

  • Nova tabela SupplierBusinessMetrics em: Suppliers;

  • Nova tabela Borgs e seus relacionamentos em: Borgs.

🆕 10 de outubro de 2025 ​

✅ 9 de outubro de 2025 ​

  • Diversas melhorias para facilitar o entendimento na página de guia Webhooks.

🆕 09 de setembro de 2025 ​

  • Novos campos no ME Data Connect:
    • Campos Balance e UsedValue adicionados à tabela Contracts.

✅ 20 de agosto de 2025 ​

  • Atualização dos Dashboards modelos em português. A atualização está relacionada a uma melhoria no relacionamento entre tabelas no Dashboard de Gestão de Cotações na visão de Gestão de Negociação via Contraproposta, aprimorando, assim, a confiabilidade da informação.

🆕 28 de Julho de 2025 ​

  • Campos adicionados na tabela RFQs: PresentValueDailyTax.
  • Campos adicionados na tabela RFQResponseItems: PresentValueNetUnitPrice, PresentValueUnitPriceWithTax, PresentValueEqualizedUnitPrice, PresentValueTotalNetPrice, PresentValueTotalWithTaxes, e PresentValueTotalEqualized.

🆕 25 de julho de 2025 ​

🆕 12 de junho de 2025 ​

  • Adição de novos eventos na plataforma de Webhooks:
    • Status do item da Requisição;
    • RFQ - Criação da resposta;
    • RFQ - Atualização da resposta.

✅ 22 de maio de 2025 ​

  • Atualização da página Microsoft Entra/Azure AD com conteúdos detalhados sobre este tipo de configuração do SSO no ME.

✅ 06 de março de 2025 ​

  • Atualização dos Dashboards modelos em português. As atualizações incluem novas visões no template de Gestão de Cotação Respondida, conforme descrito abaixo:
    • Gestão de Negociação via Contraproposta;
    • Gestão de Avaliação Técnica;
    • Gestão de Respostas da Cotação por Faixas.

🆕 11 de dezembro de 2024 ​

  • Novos campos no ME Data Connect:
    • Campos ReasonForBuyerResponse, ResponseOwnerIde Respondent adicionados à tabela RfqAttendees.

✅ 10 de dezembro de 2024 ​

  • Atualização dos Dashboards modelos em português e inglês. As atualizações incluem novas visões no template de Gestão de Cotação Respondida, conforme descrito a seguir:
    • Gestão de Negociação via Contraproposta;
    • Gestão de Avaliação Técnica.

🆕 10 de outubro de 2024 ​

✅ 26 de setembro de 2024 ​

  • Atualização do Dashboard modelo em português "Gestão de Cotação Respondida" com melhorias que incluem a medição da quantidade de cotações recusada por fornecedores e a origem da cotação recusada (Manual ou MEG).

🆕 28 de agosto de 2024 ​

✅ 04 de junho de 2024 ​

  • Atualizações nas páginas do ME Data Connect:
    • Em Dashboards modelos foram feitas atualizações sobre os temas de _dashboards _ disponibilizados;
    • Em Filtros de dados : atualização do filtro genérico na opção "Data fixa na própria URL" e adição de informação de timeout para este filtro.
  • Novo schema no ME Data Connect: InvoiceAttachments e seus relacionamentos.

✅ 22 de abril de 2024 ​

  • Atualização dos dashboards modelos do ME DATA CONNECT em Português. O link para baixá-los está aqui.

🆕 15 de abril de 2024 ​

🆕 20 de fevereiro de 2024 ​

  • Nova página de guia de Resposta de cotação.
  • Na página Excel Custom foram atualizadas as abas de Relatórios finais da planilha de Excel Custom - Modelo Padrão Completo do ME.

🆕 19 de fevereiro de 2024 ​

🆕 02 de fevereiro de 2024 ​

🆕 30 de janeiro de 2024 ​

🆕 23 de janeiro de 2024 ​

🆕 19 de janeiro de 2024 ​

✅ 22 de dezembro de 2023 ​

  • Atualização dos dashboards modelos do ME DATA CONNECT em Português, Inglês e Espanhol. Os links para baixá-los estão aqui.

🆕 15 de dezembro de 2023 ​

  • Em ME DATA CONNECT > Schemas > Contracts, foi adicionada a nova tabela ContractBorgs com seus relacionamentos.

🆕 14 de dezembro de 2023 ​

🆕 27 de novembro de 2023 ​

🆕 24 de novembro de 2023 ​

  • Em ME DATA CONNECT > Schemas > RfqTasks, foram adicionados os seguintes campos: TechnicalResponsible, TechnicalResponsibleEmail, TechnicalResponsibleComments e ApprovalNotes.

✅ 21 de novembro de 2023 ​

  • Em Guias > ME DATA CONNECT > Dashboards modelos > Links para download dos dashboards modelos foram atualizados os Dashboards modelos em português nos seguintes pontos:
    • Correção de um filtro com número de requisição aplicado incorretamente fazendo com que o dashboard ficasse em branco.
    • Está disponível a nova visão "Gestão de Pedidos em Aprovação".

🆕 10 de novembro de 2023 ​

🆕 03 de novembro de 2023 ​

  • Nova página de guia sobre Pedido.

🆕 23 de outubro de 2023 ​

  • Em ME DATA CONNECT > Schemas > RfqItems, foi adicionado o campo: ProductRfq.

✅ 11 de outubro de 2023 ​

🆕 05 de outubro de 2023 ​

🆕 02 de outubro de 2023 ​

  • Adição do novo parâmetro orderLimitInDays em API REFERENCE > ORDERS API > Supplier Orders > Get orders.
  • Mais informações sobre este parâmetro foram adicionadas em Detalhes dos pedidos.

🆕 29 de setembro de 2023 ​

  • Em ME DATA CONNECT > Schemas > RfqResponseItems, foram adicionados os seguintes campos: Measure, GrossPrice, NetPrice, DeadLine.1, CreatedDate.

🆕 11 de setembro de 2023 ​

✅ 08 de setembro de 2023 ​

🆕 01 de setembro de 2023 ​

🆕 25 de agosto de 2023 ​

🆕 17 de agosto de 2023 ​

  • Adição do conteúdo "Clique aqui para trazer mais tabelas para o painel do Power BI" na página de Filtros de dados.

🆕 10 de agosto de 2023 ​

🆕 04 de agosto de 2023 ​

  • Nova página de guia sobre Filtros de dados sugeridos para serem usados no Power BI: ME DATA CONNECT > Visão geral do ME Data Connect > Filtros de dados.

🆕 14 de julho de 2023 ​

🆕 13 de julho de 2023 ​

🆕 29 de junho de 2023 ​

🆕 26 de junho de 2023 ​

  • Adicionado evento de Nota Fiscal criada na plataforma de Webhooks

🆕 14 de junho de 2023 ​

  • Em Guias > Aceite e recusa de pedidos > Detalhes dos pedidos foram adicionadas as consultas que o fornecedor pode fazer, incluindo também data e local de entrega diferentes por itens.
  • Adicionado novo guia Rate Limit com as politicas de limite de requisições.

🆕 13 de junho de 2023 ​

  • Adicionado evento de Fornecedor Aprovado na plataforma de Webhooks
  • Adicionado evento de Pendencia de Homologacao de Fornecedor na plataforma de Webhooks

🆕 05 de junho de 2023 ​

  • Adicionando novo serviço de GraphQL mais

🆕 01 de junho de 2023 ​

  • Adicionado evento de Pedido Alterado na plataforma de Webhooks.

🆕 31 de maio de 2023 ​

  • Adicionado evento de Pedido Cancelado na plataforma de Webhooks

🆕 04 de abril de 2023 ​

🆕 27 de março de 2023 ​

Em API Reference > Webhooks foram adicionados dois novos eventos Request Approved e Pre-Order Approved.

🆕 22 de março de 2023 ​

  • Em API Reference ocorreu total remodelação das APIs, além da descrição de campos e dos endpoints das seguintes APIs:
    • Orders API
    • Invoices API
    • Suppliers API
    • Users API
    • Products API
    • Requests API
    • Pre-orders API
  • Em API Reference > Webhooks > Retries Logic foram adicionados os tempos de retentativas de envio do webhook em caso de falha.

🆕 21 de março de 2023 ​

🆕 3 de fevereiro de 2023 ​

Last updated: