API V1: Explorador

API V2: Explorador

Notificações

O AnyMarket possuí a funcionalidade de notificação de eventos: Quando um evento ocorre, por exemplo o status do pedido for modificado, nós iremos notificar sua aplicação.

Para receber as notificações do AnyMarket, é necessário que sua aplicação aceite requisições POST no formato JSON. As notificações serão enviadas no seguinte formato:

{
  "type" : "PRODUCT",
    "content" : {
    "id":"10",
    "oi":"99999."
  }
}

URL de retorno

A URL informada é o endereço do serviço REST da aplicação desenvolvida pelo parceiro. Todas as chamadas deverão ter suporte ao método POST e deverão retornar o status 200 ou 201 em caso de sucesso.

Para cadastro da URL de notificação, acesse o aplicativo AnyMarket e navegue até a tela de parâmetros. Informe a URL no campo Callback URL.

Tipos de notificação

Se a URL de retorno estiver cadastrada corretamente, informaremos a sua aplicação quando ocorrer os seguintes eventos no AnyMarket:

Produto

Quando houver uma alteração/inclusão de produto

{
  "type" : "PRODUCT",
  "content" : {
    "id":"10",
    "oi":"99999."
  }
}

Pedido

Quando houver uma alteração/inclusão de pedido

{
  "type" : "ORDER",
  "content" : {
    "id":"10",
    "oi":"99999."
  }
}

Transmissão

Quando houver uma alteração/inclusão de SKU. As transmissões só são notificadas caso o SKU possua publicação ativa. A mesma regra se aplica ao FEED.

{
  "type" : "TRANSMISSION",
  "content" : {
    "id":"10",
    "oi":"99999."
  }
}

Indisponibilidade e exceções

O AnyMarket tentará notificar o parceiro 3 vezes em intervalos regulares. Se após as 3 tentativas não houver sucesso, o AnyMarket envia o pedido, produto ou anúncio para o seu respectivo feed.

Após a disponibilização no feed, o AnyMarket manterá o item disponível por 30 dias.

Feeds

Módulo Magento

Integração Protheus

Integração com API de Frete

O ANYMARKET permite ao seller fornecer sua própria implementação de consulta de frete. Quando habilitada essa implementação, o ANYMARKET passará a realizar chamadas para a URL fornecida, e caso o a API do seller responder um tempo hábil (até 500ms) o ANYMARKET irá enviar esses dados para o marketplace. Caso contrário, a tabela de frete configurada/criada no ANYMARKET será utilizada como contingência.

Para habilitar a consulta de frete em API, o seller deve acessar a tela de parâmetros do ANYMARKET, selecionar a opção de cálculo de frete por API e informar a URL da API conforme ilustrado na imagem a seguir.

A imagem abaixo apresenta como é realizado o fluxo da consulta de frete, desde a chama do marketplace até o retorno do resultado para o mesmo.

{
  "zipCode" : "87100000",
  "marketplace": "Mercado Livre",
  "products" : [
    {
      "sku" : "A1512",
      "height" : 10,
      "width" : 20,
      "weight" : 20,
      "length" : 20,
      "amount" : 1,
      "value" : 149.90,
      "metadata": {
        "idInMarketplace": "MLB1039413612",
        "official_store_id": "224"
      }
    },
    {
      "sku" : "B1510",
      "height" : 20,
      "width" : 35,
      "weight" : 35,
      "length" : 10,
      "amount" : 2,
      "value" : 299.90,
      "metadata": {
        "idInMarketplace": "MLB1039413643",
        "official_store_id": "224"
      }
    }
  ]
}

{
  "items" : [
    {
      "serviceName" : "Transporte Terrestre",
      "carrierName" : "Seller Transporte",
      "deliveryTime" : 12,
      "price" : 23.99,
      "freightType" : "NORMAL"
    },
    {
      "serviceName" : "SEDEX",
      "carrierName" : "Seller Transporte",
      "deliveryTime" : 6,
      "price" : 35.90,
      "freightType" : "EXPRESSA"
    }
  ]
}

Integração com API de Preço

O ANYMARKET permite ao seller fornecer sua própria implementação de consulta de preço. Quando habilitada essa implementação, o ANYMARKET passará a realizar chamadas para a URL fornecida.
Ao criar um novo anúncio, ele utilizará os preços retornados desta chamada para os campos de "Preço Por" e "Preço De".

A imagem abaixo apresenta como é realizado o fluxo da consulta de preço, desde o início da criação do anúncio até sua conclusão.

Para habilitar a consulta de preço em API, o seller deve acessar a tela de parâmetros do ANYMARKET, selecionar a opção de Utilizar cálculo de preço por API e informar a URL da API conforme ilustrado na imagem a seguir.

Utilização da Integração com a API de Preço

Quando a integração está habilitada, o ANYMARKET irá realizar uma chamada POST para o endpoint informado nos parâmetros do sistema, enviando como parâmetro (Query String) o seguinte:

Parâmetro	Descrição
token	TOKEN de autenticação da conta que está fazendo a chamada. Serve para identificar qual a conta do ANYMARKET está chamando o serviço.
oi	Código interno de identificação da loja no ANYMARKET.
sku	O id do SKU para o qual o anúncio está sendo criado.
marketplace	Qual o MARKETPLACE que está sendo criado o anúncio.

E como body, encaminharemos informações que temos sobre o anúncio que está sendo criado:

Algumas dessas informações são:

                {
  "fields": [{
      "key": "string",
      "value": "string"
  }]
}
              

Tendo como resposta esperada:

{
  "price": 123.45,
  "discount": 123.45
}

Validações que serão executadas no retorno:

Preenchimento de ambos os valores: os 2 campos são de retorno obrigatório.

Preços inválidos: Preço DE (price) deve ser maior que o Preço POR (discount).

Exemplos