Mercado Livre: mudanças entre as edições

De Base de Conhecimentos da DataPlus Sistemas
Ir para navegação Ir para pesquisar
Vinicius (discussão | contribs)
Sem resumo de edição
Samuel (discussão | contribs)
 
(10 revisões intermediárias por um outro usuário não estão sendo mostradas)
Linha 1: Linha 1:
Passo a passo de como utilizar a API do Mercado Livre.<br>
Passo a passo de como utilizar a API do Mercado Livre.
 
Fluxo de notas no Mercado Livre:
[[Arquivo:Fluxo notas Mercado Livre.png|centro|commoldura]]
<br>
<br>


'''Obs: O aplicativo criado para o Mercado Livre, será o mesmo para o Mercado Pago'''<br>
'''Obs: O aplicativo criado para o Mercado Livre, será o mesmo para o Mercado Pago'''<br>
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
<br>
<br>


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


== 1° Passo - Criar um aplicativo ==
== 1° Passo - Criar um aplicativo ==


Acessar Link: https://developers.mercadolivre.com.br/devcenter
Acessar Link: https://developers.mercadolivre.com.br/devcenter<br>
 
[[Arquivo:Criar nova aplicação ML.png|centro|commoldura]]<br>
 
Informar os dados básicos da aplicação:


=== Criar nova aplicação ===
[[Arquivo:Informacoes basicas.png|centro|commoldura]]
[[Arquivo:Criar nova aplicação ML.png|centro]]<br>


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


[[Arquivo:Dados basicos aplicativo ML.png|centro]]
A URL de redirecionamento deve ser esta https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationMercadoLivre e as permissões as seguintes


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


[[Arquivo:Dados de redirecionamento ML aplicativo.png|centro]]


Selecionar todos os tópicos disponíveis na aplicação:<br>
[[Arquivo:Url de redirect.png|centro|commoldura]]


[[Arquivo:Topicos Aplicativo ML.png|centro]]
 
[[Arquivo:Permissoess.png|centro|commoldura]]
<br>
 
Selecionar todos os tópicos disponíveis na aplicação, e no campo url de retornos de chamada de notificação, insira o seguinte URL: https://ws32.dataplussistemas.com.br/datapluserp.svc/processnotificationmlfull:<br>
[[Arquivo:Topicoss.png|centro|commoldura]]


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


Acessar a aplicação, e coletar o '''ID do aplicativo'''<br>
Acessar a aplicação, e coletar o '''ID do aplicativo e a Chave Secreta'''<br>
[[Arquivo:Credenciais aplicativos ML.png|centro]]
[[Arquivo:Credenciais aplicativos ML.png|centro]]


Copiar a URL: '''(https://auth.mercadolivre.com.br/authorization?response_type=code&client_id=$CLIENT_ID&redirect_uri=https://www.google.com.br)'''<br>
<br>
 
Inserir no menu de configuração de integração, no seguinte campo:
[[Arquivo:Integracao ecommerce ml.png|centro|commoldura]]
<br>Após isso, clicar em Gerar Token Autorização, após isso, será redirecionado para a seguinte página, clique em autorizar:


O '''$CLIENT_ID''' de ser substituído pelo '''ID do aplicativo'''<br>
[[Arquivo:Autorizacao Mercado Livre.png|centro|commoldura]]
Após isso, será redirecionado para algo semelhante a isso:
[[Arquivo:Okdeucerto.png|centro|commoldura]]


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


[[Arquivo:Confirmação de acesso a aplicação ML.png|centro]]
o "ok" indica que o processo funcionou como esperado, após isso retorne para o ERP, no formulário de configuração, na aba Mercado Livre, no campo Caminho Credenciais, insira o destino onde será salvo o arquivo com as credenciais do token, preferencialmente em '''AppData/Local''':
[[Arquivo:Autorização aplicação ML.png|centro]]
[[Arquivo:Configuraçao2.png|centro|commoldura]]


== 3° Passo - Solicitar o Access Token ==
== 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'''<br>
Após configurado o destino, basta ir até o ERP, no formulário de configurações de integração para solicitar o '''Access Token'''<br>


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
Pronto para solicitar o token de Acesso:<br>
no servidor, pois em caso de utilização do Webhook as credenciais serão utilizadas:
[[Arquivo:Menu config tokens.png|centro|commoldura]]
[[Arquivo:Configurações ML.png|centro]]


Pronto para solicitar o token de liberação:<br>


[[Arquivo:Solicitar token de liberação ERP no ML.png|centro]]
<br>


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


[[Arquivo:Acess Token ML.png|centro]]
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.:<br>
[[Arquivo:XML da credenciais ML.png|centro]]


Lembre-se de guardar copiar a URL, pois ela contém o '''token de liberação''' para solicitar o '''Access Token'''<br>
== Requisitos para funcionamento correto do recurso ==


Com a URL do token de liberação em mãos, basta informa-la em '''Identificação Token Temporário'''<br>
1° - Cadastrar a própria empresa como parceiro fornecedor.


[[Arquivo:Token temporário ML.png|centro]]
2° - Cadastrar a Ebazar como cliente e transportadora com as seguintes informações:


Após a mensagem de sucesso, será criado um XML contendo as credenciais de acesso a API.:<br>
    CNPJ: 03.007.331/0121-58
[[Arquivo:XML da credenciais ML.png|centro]]
    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.
A aplicação está pronta para ser consumida.


Última atualização: 20/12/2024 09:15
== 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'''
<br>
 
[[Arquivo:Mercado Livre - Não foi possível conectar o aplicativo.png|centro|Mercado Livre - Não foi possível conectar o aplicativo]]
<br><br>
 
'''2° Utilizar o token do cliente internamente'''
<br>
 
É 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: 08/04/2026 10:00
 
[[index.php?title=Categoria:Interna]]

Edição atual tal como às 15h32min de 23 de setembro de 2026

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

Fluxo de notas no 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://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationMercadoLivre e as permissões as seguintes




Selecionar todos os tópicos disponíveis na aplicação, e no campo url de retornos de chamada de notificação, insira o seguinte URL: https://ws32.dataplussistemas.com.br/datapluserp.svc/processnotificationmlfull:

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

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


Inserir no menu de configuração de integração, no seguinte campo:


Após isso, clicar em Gerar Token Autorização, após isso, será redirecionado para a seguinte página, clique em autorizar:

Após isso, será redirecionado para algo semelhante a isso:


o "ok" indica que o processo funcionou como esperado, após isso retorne para o ERP, no formulário de configuração, na aba Mercado Livre, no campo Caminho Credenciais, insira o destino onde será salvo o arquivo com as credenciais do token, preferencialmente em AppData/Local:

3° Passo - Solicitar o Access Token

Após configurado o destino, basta ir até o ERP, no formulário de configurações de integração para solicitar o Access Token

Pronto para solicitar o token de Acesso:




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
Mercado Livre - Não foi possível conectar o aplicativo



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: 08/04/2026 10:00

index.php?title=Categoria:Interna