Mercado Livre

Passo a passo de como utilizar a API do Mercado Livre.

Obs: O aplicativo criado para o Mercado Livre, será o mesmo para o Mercado Pago
Url de teste do webhook a ser informada em URL de retornos de chamada de notificação: https://ws32.dataplussistemas.com.br/DataPlusERP.svc/ProcessNotificationMLFull

Para ambiente de produção, deve ser usado a URL do cliente.

1° Passo - Criar um aplicativo

Acessar Link: https://developers.mercadolivre.com.br/devcenter

Informar os dados básicos da aplicação:

A URL de redirecionamento deve ser esta https://www.google.com.br e os escopos selecionados devem ser: (read, offline access, write):

Selecionar todos os tópicos disponíveis na aplicação:

2° Passo - Solicitar o Token de liberação

Acessar a aplicação, e coletar o ID do aplicativo

Copiar a URL: (https://auth.mercadolivre.com.br/authorization?response_type=code&client_id=$CLIENT_ID&redirect_uri=https://www.google.com.br)

O $CLIENT_ID de ser substituído pelo ID do aplicativo

Após copiar a URL e substituir o $CLIENT_ID e pesquisar, basta confirmar o acesso a aplicação:

3° Passo - Solicitar o Access Token

Após a autorização da aplicação, basta ir até o ERP, no formulário de configurações de integração para solicitar o Token de liberação e logo após o Access Token

Antes de solicitar o token de acesso, é preciso realizar as configurações dos campos do Mercado Livre, principalmente o Caminho das Credenciais. Lembrando que as credenciais precisam estar no servidor, pois em caso de utilização do Webhook as credenciais serão utilizadas:

Pronto para solicitar o token de liberação:

Ao clicar em Gerar Token Autorização, será redirecionado para a URL de redirecionamento informada no aplicativo do mercado livre:

Lembre-se de guardar copiar a URL, pois ela contém o token de liberação para solicitar o Access Token

Com a URL do token de liberação em mãos, basta informa-la em Identificação Token Temporário

Após a mensagem de sucesso, será criado um XML contendo as credenciais de acesso a API na pasta AppData/Local do usuário chamado ApiConfig.:

Requisitos para funcionamento correto do recurso

1° - Cadastrar a própria empresa como parceiro fornecedor.

2° - Cadastrar a Ebazar como cliente e transportadora com as seguintes informações:

   CNPJ: 03.007.331/0121-58
   Inscrição Estadual (IE): 312.210.513.110
   Razão Social: EBAZAR.COM.BR LTDA

Endereço:

   Rua: Rod. Pres. Tancredo de Almeida Neves
   Número: 45
   Bairro: Parque Santa Delfa
   Cidade: Franco da Rocha
   Estado: SP
   CEP: 07809-105

3° - Indicar o CFOP de retorno de materiais em que a Operação Fiscal esteja informada como Retorno.

4° - Cadastrar o ID Externo das condições de pagamento conforme descrito abaixo:

   01 - Dinheiro
   02 - Cheque
   03 - Cartão de Crédito
   04 -Cartão de Débito
   05 - Crédito Loja
   10 - Vale Alimentação
   11 - Vale Refeição
   12 - Vale Presente
   13 - Vale Combustível
   15 - Boleto Bancário
   90 - Sem Pagamento
   99 - Outros
   16 - Depósito Bancário
   17 - Pagamento Instantâneo (PIX)
   18 - Transferência Bancária, Carteira Digital
   19 - Programa de Fidelidade, Cashback, Crédito Virtual

5° - Configurar os parâmetros necessários no formulário de configuração de integração.

6° - Cadastrar os produtos que serão vendidos no marketplace.

7° - Acoplar a regra RN_BaixaDuplicata_Movimento.

A aplicação está pronta para ser consumida.

Erros Comuns

Pode ser que ao tentar autenticar o aplicativo, aconteça alguns erros

1° Não foi possível conectar o aplicativo a conta

Mercado Livre - Não foi possível conectar o aplicativo

Este erro ocorre devido a uma divergência entre as URLs: o ERP está configurado com uma URL fixa (https://www.google.com.br), que deve ser exatamente a mesma cadastrada como URL de retorno no aplicativo do Mercado Livre. Para resolver, é necessário padronizar a URL no painel do desenvolvedor do Mercado Livre.

Mercado Livre - URL de callback

2° Utilizar o token do cliente internamente

É comum utilizarmos o token do cliente em testes internos, mas isso exige cautela. Como o token possui validade limitada, se o ERP identificar que ele expirou, realizará a renovação automática, o que invalidará o acesso no ambiente do cliente. Portanto, antes de testar, verifique o tempo de expiração; caso esteja próximo do vencimento, aguarde a renovação pelo próprio servidor do cliente.

Última atualização: 20/12/2024 09:15