Captura de dados do MercadoPago

A partir da atualização de 25/11/2010 o capturador de vendas do Gel pode capturar também informações de pagamento do MercadoPago.

IMPORTANTE: A captura de dados do MercadoPago só funcionará se estiver sendo utilizada a captura direta. Através da captura por e-mail este recurso não poderá ser ativado e utilizado. Veja neste tutorial como configurar o capturador de vendas.

IMPORTANTE: Os dados de pagamento só serão capturados em NOVAS vendas (pedidos) capturadas APÓS a ativação deste recurso. Não é possível ativar a captura dos dados em pedidos já cadastrados.

O capturador de vendas captura as informações do MercadoPago que são disponibilizadas no site do MercadoLivre. Em momento algum o capturador acessa o site do MercadoPago, portanto o capturador não tem a capacidade de acessar, efetuar modificações ou pegar qualquer informação no site do MercadoPago. Nenhuma regra de segurança já existente no capturador de vendas foi modificada para a inclusão deste recurso. A captura destes dados só tornou-se possível após as modificações efetuadas no site do MercadoLivre, que agora exibe os dados de pagamentos do MercadoPago sem a necessidade de entrar no site do MercadoPago. Se no capturador de vendas esta sendo utilizada uma senha de operador para o MercadoLivre, o operador precisa apenas de acesso ao recurso "Minhas vendas" não sendo necessário adicionar outros acessos. Veja neste tutorial como configurar um operador para utilizar no capturador de vendas.

O principal objetivo desta integração é automatizar o processo de preenchimento das informações nos pedidos, como endereço do comprador, forma de pagamento escolhida, status do pagamento, etc. A captura de dados do MercadoPago não deve substituir a conferência dos pagamentos para liberação dos pedidos. Cabe ao vendedor conferir os valores pagos e status dos pagamentos no MercadoPago antes de enviar os produtos ao comprador. Embora o capturador tente capturar os dados com a maior precisão possível podem ocorrer falhas na captura destas informações, portanto é de fundamental importância que o vendedor continue conferindo os pagamentos no MercadoPago antes de enviar os produtos.

Existem casos onde o comprador pode não efetuar o pagamento do frete, ou informar um valor inferior ou maior do que o frete calculado pelo Gel. Cabe ao vendedor decidir se irá enviar o produto mesmo assim, ou irá entrar em contato com o comprador para solicitar o pagamento do frete ou outras diferenças. Portanto esta integração tem como finalidade fornecer informações para a tomada de decisão do vendedor no momento da conferência, e não automatizar processos de liberação de pedidos, o capturador não irá marcar pedidos como pago ou colocar no status de pagamento confirmado quando um pagamento é identificado.

OBS: Este recurso só funciona quando esta sendo utilizado o método de captura direta. Na captura por e-mail não é possível ativar a integração.

Para desativar este recurso siga os mesmos passos acima mas ao invés de marcar a opção Ativar integração com o MercadoPago desmarque-a.

Veja mais abaixo as opções de configuração para a integração com o MercadoPago.

Nas configurações da integração é possível definir opções que irão alterar o comportamento da captura dos dados e atualização dos pedidos, veja abaixo a descrição de cada opção.

Se marcada os dados referentes ao pagamento como, status, tipo de pagamento, data de pagamento, e outras informações de pagamento são capturados e atualizados nos pedidos.

Se esta opção estiver desmarcada os dados de pagamento não são atualizados nos pedidos e o status dos pedidos no Gel não são alterados de acordo com o status do pagamento no MercadoPago.

Se marcada os dados do endereço do comprador, informados no MercadoPago são capturados e atualizados no cadastro do comprador no Gel.

O status do pedido pode será alterado quando ocorrer alteração na situação do pagamento no MercadoPago. Se existir um e-mail associado ao status ele pode ser enviado de acordo com esta configuração.

Estas opções ajudam a evitar que alterações feitas manualmente nos pedidos sejam perdidas/sobrepostas pelos dados capturados do MercadoPago, estabelecendo quando as atualizações devem ser encerradas.

Exemplo: O status do pedido foi alterado manualmente por você para pedido despachado. Ocorre alguma alteração nos do MercadoPago pago para este pedido e ele é atualizado novamente pelo capturador, voltando para o status Pagamento identificado.

Portanto, enquanto o pedido esta sendo monitorado e atualizado pelo capturador alterações feitas manualmente nos dados do comprador, status e dados do pagamento podem ser perdidas.

Para evitar isto esta opção permite bloquear o capturador para atualizar os pedidos se eles estiverem em um status maior ou igual ao definido.

Quando o pedido é colocado, por você, e em um status maior ou igual ao definido ele não será mais atualizado pelo capturador.

Mais abaixo neste mesmo tutorial é apresentada uma metodologia de trabalho que pode ser adotada para evitar sobreposição de dados, e também como desativar as atualizações em um pedido específico.

Deixar de atualizar quando o pedido estiver em um status com percentual de andamento igual ou maior que o selecionado abaixo:

A recomendação padrão é o status de pagamento confirmado com 40% de andamento.

Ao atualizar os dados do pagamento, os pedidos serão colocados em status diferentes de acordo com a situação atual do pagamento.

Status	Descrição
10% - Pagamento cancelado no Meio de pagamento	Foi feita uma tentativa de pagamento mas ela foi recusada ou cancelada pelo MercadoPago. Exemplo: Cartão recusado ou boleto não pago dentro do vencimento.
20% - Pagamento processando no Meio de pagamento	Foi feita uma tentativa de pagamento mas o mesmo ainda não foi confirmado. Exemplo cartão de crédito aguardando aprovação, ou boleto aguardando compensação.
30% - Pagamento identificado no Meio de pagamento	Foi feito um pagamento e ele foi identificado e confirmado pelo MercadoPago.

Para cada status que o capturador colocar nos pedidos, pode ser enviado um e-mail associado.

Veja abaixo quais são os e-mails enviados para cada status.
Nota: Isto se aplica na configuração padrão do Gel, o vendedor pode alterar os e-mails associados aos status a qualquer momento.

Nota: Assim como outros modelos de e-mail do Gel o texto destes e-mails podem ser customizados pelo vendedor.

Veja neste tutorial como editar um modelo de e-mail.
Nota: Se a opção Enviar os e-mails associados aos status estiver desmarcada nas configurações da integração, nenhum e-mail será enviado, mesmo que o status tenha um e-mail associado.

Status	E-mail associado/Descrição
10% - Pagamento cancelado no Meio de pagamento	E-mail: Pagamento cancelado ou recusado no Meio de pagamento. Descrição: Este e-mail informa ao comprador que seu pagamento foi cancelado ou recusado e que ele pode efetuar uma nova tentativa de pagamento no MercadoPago.
20% - Pagamento processando no Meio de pagamento	E-mail: Pagamento processando no Meio de pagamento. Descrição: Este e-mail informa ao comprador que o seu pagamento esta sendo processado.
30% - Pagamento identificado no Meio de pagamento	E-mail: Pagamento identificado no Meio de pagamento. Descrição: Este e-mail informa ao comprador que o seu pagamento foi identificado e que estão sendo feitas as devidas conferências para confirmação definitiva do pagamento e posterior processamento do pedido.

E-mails de pendência
Na configuração padrão o Gel não irá enviar e-mails de pendência de pedido vencido, e qualificação não recebida quando os pedidos estiverem em determinados status conforme a tabela abaixo. Se você deseja alterar este comportamento veja neste tutorial como fazer.

Pendência	Status
Pedido vencido (pagamento não confirmado)	Esta pendência será ignorada em pedidos nestes status: 20% - Pagamento processando no Meio de pagamento 30% - Pagamento identificado no Meio de pagamento
Clientes que ainda não qualificaram	Esta pendência será ignorada em pedidos nestes status: 10% - Pagamento cancelado no Meio de pagamento 20% - Pagamento processando no Meio de pagamento 30% - Pagamento identificado no Meio de pagamento

Como mencionado no início deste tutorial o principal objetivo desta integração é fornecer informações ao vendedor para a tomada de decisão em relação aos pagamentos efetuados no MercadoPago e que foram capturados pelo Gel.

Veja abaixo como visualizar estas informações no Gel, que lhe ajudarão a decidir se o pedido deve ser enviado, ou é necessário algum pagamento adicional, etc.

Campo	Descrição
Status do pedido	O status relativo a situação de pagamento no MercadoPago. Veja mais acima neste mesmo tutorial os status possíveis e a descrição de cada um.
Forma de pagamento escolhida	Será colocado MercadoPago, indicando que o pagamento foi efetuado no MercadoPago.
Data do pagamento	Data em que foi efetuado o pagamento no MercadoPago.
Tipo de pagamento	Tipo de pagamento utilizado pelo comprador, podendo ser por exemplo: Saldo em conta, Cartão de crédito, Boleto, Transferência online, etc.
Detalhes do pagamento	O campo mais importante de todos pois traz vários detalhes sobre o pagamento, incluindo o valor de envio pago, valores adicionais, comissão do MercadoLivre/MercadoPago, etc. Comentários do comprador também são incluídos neste campo.

Em Dados do cliente os dados também são atualizados.

Nota: Os dados atualizados dependem de quais dados o comprador informou no momento do pagamento.

Se ele escolheu a opção de entrar em contato direto com o vendedor os dados de entrega não ficam armazenados no MercadoPago e portanto o cadastro não será atualizado.

Além de mostrar os dados do pagamento no pedido foi criado um novo recurso para mostrar o histórico das atualizações que ocorreram no pedido.

Esta informação pode ser útil para visualizar adições de valores no pagamento, e ou acompanhar a evolução do pagamento.

Cada vez que o pedido for atualizado com os dados do pagamento ou do endereço do comprador, uma entrada será adicionada ao histórico.

As atualizações são exibidas em ordem reversa ou seja, da mais recente para a mais antiga.

Nota: Se esta aba não for exibida na tela do pedido significa que o pedido não possui pagamento identificado no MercadoPago.

Por exemplo você pode desejar que o capturador não atualize mais os dados do comprador mesmo que ocorram alterações nos dados do MercadoPago. Ou que os dados de pagamento não sejam mais atualizados mesmo que ocorram alterações no processamento do pagamento.

Para isso marque as opções indicadas na imagem abaixo na aba Meios de Pagamento.
A atualização será desativada apenas no pedido em questão, não afetando os demais pedidos.

Veja abaixo uma sugestão de como trabalhar com a integração ativada, de forma a evitar sobreposição de dados, e enganos na conferência e liberação dos produtos para envio.

Inicie ativando a integração com o MercadoPago conforme indicado no início deste tutorial.

Na configuração do status onde os pedidos devem deixar de ser atualizados sugerimos selecionar o status que denote que o pagamento do pedido já foi confirmado por você, por exemplo o status "40% - Pagamento confirmado" .

Deixe todas as opções ativas de forma que tanto os dados do comprador como dados do pagamento sejam atualizados nos pedidos.

Deixe selecionada a opção de enviar o e-mail associado ao status.

Caso deseje editar o texto dos e-mails que serão enviados veja neste tutorial como fazer. Os modelos que devem ser editados estão listados mais acima neste mesmo tutorial no item E-mails que podem ser enviados.

Com a integração ativa os pedidos serão atualizados automaticamente e você poderá acompanhar a evolução dos pagamentos no Gel.

Para visualizar os pedidos entre no Gel e clique em Pedidos no lado esquerdo da tela.

O recurso Pesquisa rápida pelo status é muito útil para listar todos os pedidos que se encontram em determinado status.

Através desta opção você poderá listar rapidamente os pedidos que estão nos status relacionados ao meio de pagamento.

Por exemplo para listar os pedidos no status 30% - Pagamento identificado no Meio de pagamento clique no botão indicado na imagem abaixo, em seguida sobre este status na lista de opções.

Se o pedido estiver no status 30% - Pagamento identificado no Meio de pagamento significa que o pagamento foi confirmado pelo MercadoPago e o pagamento deve ser conferido para posterior envio do produto, neste caso você pode seguir os passos abaixo.

Na tela que será exibida confira os detalhes do pagamento conforme mostrado mais acima neste tutorial no item Vendo as informações de pagamento nos pedidos.

O campo Detalhes do pagamento mostra todas as informações, relacionadas ao pagamento que foram capturadas.

O valor do envio (frete) pago pelo comprador também será exibido neste campo. Se não for exibido valor de envio pode significar que o comprador não informou valor algum de envio.

Caso exista alguma inconsistência em relação ao pagamento, por exemplo o comprador não pagou o custo de envio, ou pagou um valor menor, você pode enviar um e-mail para o comprador solicitando o pagamento adicional deste valor.

Veja neste tutorial como enviar um e-mail manualmente, ou neste tutorial como enviar vários e-mails de uma só vez.

Caso exista alguma inconsistência no pagamento e seja necessário alterar o status do pedido, recomendamos que seja colocando em um status com percentual de pagamento entre 10% e 30% mas não em um status maior ou menor que este percentual.

Lembre-se que os status do Gel podem ser configurados e criados novos. Veja neste tutorial como configurar os status. Você pode por exemplo criar um status chamado "Pendência no pagamento do Frete" com percentual de andamento igual a 20% e colocar estes pedidos neste status. Como são tantas situações diferentes que podem ocorrer, e cada vendedor tem seu método de trabalho, este status não existe na configuração padrão do Gel. Um vendedor, por exemplo, pode preferir enviar o pedido mesmo havendo uma diferença no valor do frete, ao invés de solicitar um novo pagamento para o comprador. Portanto cabe ao vendedor configurar seus status para adequar a sua metodologia de trabalho.

Caso não tenha inconsistência no pagamento, ou seja o pedido já pode ser enviado mediante as informações de pagamento capturadas, o vendedor deverá acessar o MercadoPago e efetuar a conferência deste pagamento pessoalmente. Lembre-se: embora o capturador tente capturar os dados com a maior precisão possível podem ocorrer falhas nas capturas, principalmente pelo fato de que o MercadoLivre não disponibiliza a consulta a estas informações em um formato de dados estruturado. A conferência final é imprescindível.

Após confirmado o pagamento no MercadoPago coloque o pedido no status "40% - Pagamento confirmado". Isso fará com que este pedido deixe de ser atualizado pelo capturador e o status e alterações feitas por você nos dados do comprador e dados do pagamento não serão mais sobrepostas.