Lembre-se de guardar copiar a URL, pois ela contém o '''token de liberação''' para solicitar o '''Access Token'''<br>
Lembre-se de guardar copiar a URL, pois ela contém o '''token de liberação''' para solicitar o '''Access Token'''<br>
Com a URL do token de liberação em mãos, basta informa-la em '''Identificação Token Temporário'''
Com a URL do token de liberação em mãos, basta informa-la em '''Identificação Token Temporário'''<br>
[[Arquivo:Token temporário ML.png|centro]]
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".
Após a mensagem de sucesso, será criado um XML contendo as credenciais de acesso a API.:<br>
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:XML da credenciais ML.png|centro]]
[[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.
A aplicação está pronta para ser consumida.
[[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]]
Última atualização: 20/12/2024 09:15
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).
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.
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.
Ao clicar em "Cobrança" por exemplo, a tela abaixo será exibida:
[[Arquivo:Ambiente de teste api bb.png|centro]]
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.
== 5° Passo - Produção ==
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]]
Ao clicar a tela de inicio para colocar o aplicativo em produção será exibida, basta seguir os passos.
[[Arquivo:Inicio da produção.png|centro|Inicio da produção para o aplicativo BB]]
== 6° Passo - Configurar WebHook ERP ==
Para o funcionamento do webhook é necessário algumas informações no ERP:
[[Arquivo:Parametros webhook Conta.png|centro]]
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.
É 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:
[[Arquivo:Parametros webhook banco.png|centro]]
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''':
[[Arquivo:Informações banco de dados xml de configurações webservice.png|centro]]
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:
== 7° Passo - Configurar WebHook Banco do Brasil ==
Na plataforma do Banco do Brasil é preciso seguir os seguintes passos:
Entrar no aplicativo, clicar no menu lateral esquerdo em webhook:
[[Arquivo:Menu lateral aplicativo bb.png|centro]]
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.
Segue os IPs externos utilizados pelo Webhook dos 2 datacenters do banco do brasil:
CCT1: 170.66.14.184
CCT2: 170.66.196.181 / 170.66.196.114 - 115
Edição das 09h18min de 20 de dezembro de 2024
Passo a passo de como utilizar a API do Mercado Livre.
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.:
