Mercado Livre: mudanças entre as edições
Sem resumo de edição |
|||
| (12 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. | ||
Fluxo de notas no Mercado Livre: | |||
[[Arquivo:Fluxo notas Mercado Livre.png|centro|commoldura]] | |||
<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> | |||
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: | |||
[[Arquivo:Informacoes basicas.png|centro|commoldura]] | |||
A URL de redirecionamento deve ser esta https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationMercadoLivre e as permissões as seguintes | |||
[[Arquivo:Url de redirect.png|centro|commoldura]] | |||
[[Arquivo:Permissoess.png|centro|commoldura]] | |||
<br> | |||
[[Arquivo: | 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]] | ||
<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: | |||
Após | [[Arquivo:Autorizacao Mercado Livre.png|centro|commoldura]] | ||
Após isso, será redirecionado para algo semelhante a isso: | |||
[[Arquivo:Okdeucerto.png|centro|commoldura]] | |||
[[Arquivo: | 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]] | |||
== 3° Passo - Solicitar o Access Token == | == 3° Passo - Solicitar o Access Token == | ||
Após | 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> | ||
Pronto para solicitar o token de Acesso:<br> | |||
[[Arquivo:Menu config tokens.png|centro|commoldura]] | |||
<br> | |||
<br> | |||
[[Arquivo: | 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]] | |||
== 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. | A aplicação está pronta para ser consumida. | ||
Última atualização: | == 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

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