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)
 
(13 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.
Passo a passo de como utilizar a API do Mercado Livre.


== 1° Passo - Criar um aplicativo ==
Fluxo de notas no Mercado Livre:
[[Arquivo:Fluxo notas Mercado Livre.png|centro|commoldura]]
<br>


Acessar Link: https://developers.mercadolivre.com.br/devcenter
'''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>


=== Criar nova aplicação ===
Para ambiente de produção, deve ser usado a URL do cliente.
[[Arquivo:Criar nova aplicação ML.png|centro]]<br>


Informar os dados básicos da aplicação:<br>
== 1° Passo - Criar um aplicativo ==


[[Arquivo:Dados basicos aplicativo ML.png|centro]]
Acessar Link: https://developers.mercadolivre.com.br/devcenter<br>


A URL de redirecionamento deve ser esta '''https://www.google.com.br''' e os escopos selecionados devem ser: '''(read, offline access, write)''':<br>
[[Arquivo:Criar nova aplicação ML.png|centro|commoldura]]<br>


[[Arquivo:Dados de redirecionamento ML aplicativo.png|centro]]
Informar os dados básicos da aplicação:


Selecionar todos os tópicos disponíveis na aplicação:<br>
[[Arquivo:Informacoes basicas.png|centro|commoldura]]
 
[[Arquivo:Topicos Aplicativo ML.png|centro]]
 
== 2° Passo - Solicitar o Token de liberação ==


Acessar a aplicação, e coletar o '''ID do aplicativo'''<br>
[[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>
A URL de redirecionamento deve ser esta https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationMercadoLivre e as permissões as seguintes


O '''$CLIENT_ID''' de ser substituído pelo '''ID do aplicativo'''<br>


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]]
[[Arquivo:Url de redirect.png|centro|commoldura]]
[[Arquivo:Autorização aplicação ML.png|centro]]


== 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>
[[Arquivo:Permissoess.png|centro|commoldura]]
<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
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>
no servidor, pois em caso de utilização do Webhook as credenciais serão utilizadas:
[[Arquivo:Topicoss.png|centro|commoldura]]
[[Arquivo:Configurações ML.png|centro]]


Pronto para solicitar o token de liberação:<br>
== 2° Passo - Solicitar o Token de liberação ==


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


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]]
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:


Lembre-se de guardar copiar a URL, pois ela contém o '''token de liberação''' para solicitar o '''Access Token'''<br>
[[Arquivo:Autorizacao Mercado Livre.png|centro|commoldura]]
Após isso, será redirecionado para algo semelhante a isso:
[[Arquivo:Okdeucerto.png|centro|commoldura]]


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


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:Configuraçao2.png|centro|commoldura]]


Para o próximo passo basta selecionar o aplicativo, no meu caso é o "Teste cobrança". Mas como será o seu primeiro acesso basta clicar em "Nova Aplicação".
== 3° Passo - Solicitar o Access Token ==
Você será redirecionado para a tela de criação de uma nova aplicação, basta informar os dados (Nome, Descrição e icone. Icones são opcionais).
[[Arquivo:Cadastro nova aplicação.png|centro|Cadastro nova aplicação]]
 
Logo abaixo você deve selecionar quais APIs o seu aplicativo ira obter, os aplicativos podem possuir APIs de cobranças ou pagamentos.
[[Arquivo:Apis para aplicação Cobrança.png|centro|Apis para aplicação cobrança]]
 
[[Arquivo:Apis para aplicação pagamento.png|centro|Apis para aplicação pagamento]]
 
Com o aplicativo selecionado basta ir na barra de menus no canto esquerdo.
 
[[Arquivo:Barra de menus BB.png|centro|Barra de menus do aplicativo BB]]
 
Para obter as credenciais para poder realizar os testes ou até mesmo as credencias de produção, basta clicar em credenciais.
[[Arquivo:Credenciais de teste dados ocultos.png|centro|Credenciais de teste dados ocultos]]
 
== 4° Passo - Acessar Documentação e Ambiente de Teste ==
Para acessar a documentação ou ambiente de teste, basta voltar para o Dashboard inicial clicando na barra de menus ao lado esquerdo e ir em "Dashboard". No Dashboard basta ir em "Documentação" ou "SandBox" (Para o ambiente de teste).
[[Arquivo:Dashbord toolstrip BB.png|centro|Dashboard]]
 
Ao clicar em "Documentação", para obter os dados de teste, basta ir ao menu lateral esquerdo e clicar em "API Cobrança -> Homologação e testes" (Dados da API de cobrança) por exemplo.
[[Arquivo:Barra lateral documentação.png|centro|Homologação e teste]]
 
Ao acessar essa aba ao rolar para baixo você tem acesso aos dados fictícios, como também, exemplo de como montar a requisição.
[[Arquivo:Dados ficticios documentação.png|centro|Dados ficticios documentação]]
 
[[Arquivo:Dados ficticios requisicao.png|centro|Dados ficticios requisicao]]
 
Ao clicar em "SandBox", para obter acesso ao ambiente de testes do Banco do Brasil, basta ir ao menu lateral esquerdo e clicar em "API'S" e escolher a API que deseja testar, você pode utilizar o ambiente de testes para entender o processo ou ir direto ao ERP.


[[Arquivo:Barra Lateral SandBox.png|centro|Barra Lateral SandBox]]
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>


Ao clicar em "Cobrança" por exemplo, a tela abaixo será exibida:
Pronto para solicitar o token de Acesso:<br>
[[Arquivo:Ambiente de teste api bb.png|centro]]
[[Arquivo:Menu config tokens.png|centro|commoldura]]


Porém, antes de utilizar a API você precisa Autorizar as suas credenciais, basta clicar em "Authorize":
[[Arquivo:Tela de autorização sandbox.png|centro|Tela de autorização SanxBox]]


Basta informar o seu Client-Id e Client-Secret e selecionar os escopos a ser utilizado, pode selecionar os dois escopos, pois será necessário para utilizar nos testes. Após isso basta autorizar.
<br>


== 5° Passo - Produção ==
<br>
Para colocar a aplicação em Produção basta ir na barra de menus no canto esquerdo e clicar em Produção.


[[Arquivo:Produção.png|centro|Colocando o aplicativo BB em produção]]
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]]


Ao clicar a tela de inicio para colocar o aplicativo em produção será exibida, basta seguir os passos.
== Requisitos para funcionamento correto do recurso ==


[[Arquivo:Inicio da produção.png|centro|Inicio da produção para o aplicativo BB]]
1° - Cadastrar a própria empresa como parceiro fornecedor.


== 6° Passo - Configurar WebHook ERP ==
2° - Cadastrar a Ebazar como cliente e transportadora com as seguintes informações:


Para o funcionamento do webhook é necessário algumas informações no ERP:
    CNPJ: 03.007.331/0121-58
    Inscrição Estadual (IE): 312.210.513.110
    Razão Social: EBAZAR.COM.BR LTDA


[[Arquivo:Parametros webhook Conta.png|centro]]
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


Informar o número de convenio da conta e também a quantidade de dias acordada na contratação do convenio para a data de crédito, considerando feriados e finais de semana.
3° - Indicar o CFOP de retorno de materiais em que a Operação Fiscal esteja informada como '''Retorno'''.


É necessário informar no cadastro de banco o código da ocorrência que vai ser utilizada para a baixa operacional das cobranças recebidas no evento do webhook:
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


[[Arquivo:Parametros webhook banco.png|centro]]
5° - Configurar os parâmetros necessários no formulário de configuração de integração.


Já nas informações da aplicação, é preciso informar as informações do banco de dados para funcionamento da aplicação, que se encontra na pasta '''XmlConfig''' no arquivo '''WH_DpSettings.xml''':
6° - Cadastrar os produtos que serão vendidos no marketplace.


[[Arquivo:Informações banco de dados xml de configurações webservice.png|centro]]
7° - Acoplar a regra [[RN_BaixaDuplicata_Movimento]].


Já no arquivo '''web.config''' é preciso parametrizar o caminho do arquivo de configurações e também aonde o arquivo de log será gerado, e um usuário para ser utilizado no log de alterações do movimento que será gerado:
A aplicação está pronta para ser consumida.


[[Arquivo:Arquivo webconfig parametrização valores.png|centro]]
== Erros Comuns ==


== 7° Passo - Configurar WebHook Banco do Brasil ==
Pode ser que ao tentar autenticar o aplicativo, aconteça alguns erros


Na plataforma do Banco do Brasil é preciso seguir os seguintes passos:
'''1° Não foi possível conectar o aplicativo a conta'''
<br>


Entrar no aplicativo, clicar no menu lateral esquerdo em webhook:
[[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>


[[Arquivo:Menu lateral aplicativo bb.png|centro]]
'''2° Utilizar o token do cliente internamente'''
<br>


Clicar em '''Cadastrar Evento''' e inserir as informações necessárias para o funcionamento, assim como escolher a API a ser utilizada, o convenio, a URL de callback e o email para notificações de problemas e o tipo de evento.
É 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


Segue os IPs externos utilizados pelo Webhook dos 2 datacenters do banco do brasil:
[[index.php?title=Categoria:Interna]]
  CCT1: 170.66.14.184
  CCT2: 170.66.196.181 / 170.66.196.114 - 115

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