Conecte o seu negócio a um catálogo mais amplo e mais oportunidades

A API B2B da MediaMax permite ligar uma loja online, ERP ou sistema interno ao nosso catálogo, preços, stock, encomendas e expedições, através de pedidos HTTP autenticados.

O catálogo permite obter uma lista paginada e consultar depois a ficha atualizada de um SKU. Os dados podem incluir nome, referência, preço do cliente, disponibilidade, EAN, imagens e informação energética, consoante o produto.

Obter catálogo

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/all?pag=1&max=25' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN' \
  --header 'Accept-Language: pt'
              

Consultar um produto

                curl --request GET \
  --url 'https://www.mediamax.es/api/product/SKU-EXEMPLO' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN'
              

Resposta ilustrativa simplificada

                {
  "id": 12345,
  "attributes": {
    "name": "Produto de exemplo",
    "sku": "SKU-EXEMPLO",
    "price": 199.99,
    "qty_available": 8,
    "gallery": []
  }
}
              

Os feeds fornecem ficheiros para importar periodicamente para um eCommerce, ERP ou integrador. São uma alternativa ou complemento à API: permitem sincronizações por lotes sem necessidade de efetuar consultas individuais por produto.

Feed rápido de preço e disponibilidade

Frequência de atualização recomendada: a cada 15–30 minutos, segundo o processo de integração.

Formato documentado: separador de campos |; delimitador de texto '.

O Catálogo Exclusivo Alargado inclui referências que ainda não estão publicadas no nosso site, permitindo-lhe aceder a um catálogo muito mais extenso.

Que vantagens oferece?

O seu objetivo é melhorar o matching com as fichas existentes em plataformas como a Amazon, a Miravia e outros marketplaces, aumentando as possibilidades de comercializar os nossos produtos.

Que vantagens oferece?

Cada integração API está associada a um utilizador e a um email da MediaMax, vinculados à configuração comercial e fiscal do cliente. Essa associação influencia a tarifa, os preços e o tratamento da faturação.

Uma encomenda API reúne a referência própria do cliente, a morada de faturação, a morada de envio e as linhas com SKU e quantidade. A MediaMax devolve um identificador que deve ser guardado junto com a referência original.

Criar encomenda

                curl --request POST \
  --url 'https://www.mediamax.es/api/order' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data @pedido.json
              

Exemplo de pedido.json

                {
  "b2b_reference": "ENCOMENDA-CLIENTE-2026-0001",
  "order_billing_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Empresa Exemplo, Lda",
    "email": "compras@example.com",
    "phone": "+34900000000",
    "street": "Rua Exemplo 1",
    "postcode": "03001",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES"
  },
  "order_shipping_address": {
    "name": "Laura",
    "lastname": "García",
    "company": "Empresa Exemplo, Lda",
    "email": "logistica@example.com",
    "phone": "+34900000000",
    "street": "Avenida de Entrega 10",
    "postcode": "03002",
    "city": "Alicante",
    "region_id": "A",
    "country": "ES",
    "express": 0
  },
  "order_lines": [
    {"sku": "SKU-EXEMPLO", "quantity": 1}
  ]
}
              

Consultar várias referências

                curl --request GET \
  --url 'https://www.mediamax.es/api/batch/reference?pag=1&max=25&references=ENCOMENDA-001&references=ENCOMENDA-002' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN'
              

No Dropship, a MediaMax prepara e envia as encomendas em nome do cliente, utilizando a configuração da conta para a documentação e a etiquetagem. Segundo o procedimento descrito, as encomendas feitas por API utilizam esta modalidade.

Uma encomenda pode gerar uma ou várias expedições. Cada uma pode ter a sua própria referência de picking, transportadora, rastreio e estado logístico.

Consultar expedição por referência

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/reference/WH%2FOUT%2F00000' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN'
              

Resposta ilustrativa simplificada

                {
  "code": "200",
  "status": "success",
  "data": {
    "id": 4567,
    "attributes": {
      "reference": "WH/OUT/00000",
      "tracking": "TRACKING-EXEMPLO",
      "status": "done"
    }
  }
}
              

Consultar todas as expedições da encomenda

                curl --request GET \
  --url 'https://www.mediamax.es/api/packing/show/order/odoo/S00000' \
  --header 'HTTP-API-KEY: O_SEU_TOKEN'
              

A passagem de DEMO para produção exige supervisionar as primeiras operações para confirmar que a integração funciona com dados reais. Utiliza-se um bloqueio de contacto para controlar a transferência do picking até concluir a revisão.

Resumo das operações