Integração a Itaú Shopline
Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte
Para obter o devido suporte Clique aqui, relatando o motivo da ocorrência o mais detalhado possível e anexe o print da tela para nosso entendimento
- [✓] Transação
- [✓] Consulta
No checkout é feito o processo de autorização
Na página de sucesso é enviado infomações para o recurso de notificação da transação
Via CRON deve ser processado a notificação da transação,
No processamento da notificação caso o pagamento seja confirmado, deve ser alterado o "state/status" do pedido para "processing" ou seja "Processando", liberando as ações para processar a fatura e o envio
Antes do envio da mercadoria, sempre confira as informações do pedido, se o status da transação está sendo exibido que o pagamento foi confirmado, inclusive junto a operadora financeira se a transação foi capturada, caso algo esteja inconsistente será necessário cancelar o pedido até a correção da ocorrência
Quando o pedido é enviado o status é alterado para "complete" ou seja "Completo"
Foi implementada automação para a cada 5 minutos ser feito a consulta do status da transação para ser atualizado o status do pedido
Para o uso do método é necessário ativar a CRON para o Magento
Clique aqui para visualizar o documento da MOZG
Certifique-se de que ação esteja sendo executado a cada minuto
Esse módulo usa o cronjob para processar as notificações
O módulo executa as notificações que foram recebidas há pelo menos 5 minutos.
Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku
Com apenas 1 clique, o aplicativo cria sua loja virtual usando a plataforma de comércio eletrônico Magento e instala os módulos da MOZG
https://github.com/mozgbrasil/heroku-magento#descrição
--
Sugiro "printar" as telas com todos os procedimentos executados
Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades
--
Este módulo destina-se a ser instalado usando o Composer
Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão
composer --version
Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui
--
É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader
Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal
php -v
Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB
Certique se da presença do arquivo phpinfo.php na raiz do seu projeto
<?php phpinfo(); ?>
Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Acesse o arquivo pelo browser
Em seguida pesquise pelo termo "ionCube PHP Loader"
Caso o seu servidor não tenha o suporte a extensão, entre em contato com sua empresa de hospedagem e peça para que eles ativem a extensão
Caso tenha a permissão e queira ativar a extensão, Clique aqui
Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor
Descompacte o pacote e faça upload do arquivo "loader-wizard.php" para seu servidor, onde será demonstrado o passo a passo para a ativação da extensão
Clique aqui para ver os processos executados
--
Na presença do "ionCube PHP Loader" efetue o download do seguinte arquivo e coloque na raiz do seu servidor e acesse, se funcionar quer dizer que o "ionCube" está lendo esse tipo de encriptação
--
Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final
--
Sugiro manter um ambiente de testes para efeito de testes e somente após os devidos testes aplicar os devidos procedimento no ambiente de produção
--
Sugiro efetuar backup da plataforma Magento e do banco de dados
--
Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado
--
Certique se da presença do arquivo composer.json na raiz do seu projeto Magento e que o mesmo tenha os parâmetros semelhantes ao modelo JSON abaixo
{
"minimum-stability": "dev",
"prefer-stable": true,
"license": [
"proprietary"
],
"repositories": [
{
"type": "composer",
"url": "https://packages.firegento.com"
}
],
"extra": {
"magento-root-dir": "./",
"magento-deploystrategy": "copy",
"magento-force": true
}
}
Caso não exista o arquivo composer.json na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima
Para instalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer require mozgbrasil/magento-itau-php_72:dev-master
Você pode verificar se o módulo está instalado, indo ao backend em:
STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output
--
Para atualizar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
Antes de efetuar qualquer processo que envolva atualização no Magento é recomendado manter o Compiler e Cache desativado
composer update
Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente
Para checar a data do módulo execute o seguinte comando
grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil
--
Para desinstalar o módulo execute o comando a seguir no terminal do seu servidor no diretório do seu projeto
composer remove mozgbrasil/magento-itau-php_72
--
-
Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado
-
Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg
A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo
Para configurar o método de pagamento, acesse no backend em:
STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)
Você terá os campos a seguir
Para obter o número do código da empresa acesse o Internet Banking do Itaú
Recebimentos > Itaú Shopline > Informações Cadastrais
Para obter o número da chave de criptografia acesse o Internet Banking do Itaú
Recebimentos > Itaú Shopline > Informações Cadastrais
Status dos pedidos recém-criados, antes da confirmação de resultado de pagamento via notificações de servidor da operadora
Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora
Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora
Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora
Se as encomendas já estiverem facturadas, não poderão ser canceladas
Selecione somente o status atribuído ao estado concluído, deixe vazio para usar o mesmo que os produtos normais
Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora
Status dos pedidos após reembolso (parcial) confirmada por uma notificação de REEMBOLSO_PARCIAL da operadora. Recomendamos que não defina este status e deixe Magento decidir o status.
Status dos pedidos após notificação de PENDENCIA da operadora
A opção "automática" deve ser selecionado, na necessidade do uso dessa automação que deve ser executada no processamento da notificação que é executada via CRON
A opção "manual" deve ser selecionado, na necessidade de capturar a transação manualmente, essa ação é feita acessando a fatura do pedido e clicando no botão "Capturar"
Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida.
Nota: isto fará com que Magento empurre todas as encomendas para o estado: 'Processamento' uma vez que a factura é criada, ignorando todas as outras definições.
Se você habilitar esta função será feito uma solicitação de captura para a operadora se você fizer o envio
Se uma pedido é cancelada por algum motivo, mas recebeu uma notificação de que o pagamento é autorizado, isso cancelará automaticamente o pedido
Ativar / Desativar reembolso automático ao cancelar um pedido
Ativar / desativar atualizações de e-mails
Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente
Deve ser armazenado os processos do módulo em var/log/
O arquivo
DATE_mozg.log
se trata de log do módulo sendo um log mais detalhado contendo todos os processos inclusive das execuções realizadas pelas bibliotecas externas do módulo
O arquivo
payment_METHOD.log
Se o reembolso for feito na operadora, e a mesma enviar uma notificação de reembolso para o Magento, deve ser criado automaticamente uma nota de crédito. Se você definir essa configuração como 'Sim', isso não acontecerá porque ele não processará nenhuma das notificações de REEMBOLSO recebidas.
Determina como os compradores são redirecionados após cancelar um pagamento.
Determina se os métodos de pagamento serão exibidos com seu logotipo ou apenas o nome.
Isso substituirá o local do cliente padrão do armazenamento do Magento.
Deixe vazio para deixar Magento decidir (Ex: nl_NL)
Isso irá substituir o país do endereço de faturamento do comprador ao determinar quais métodos de pagamento serão exibidos.
Para "ativar" ou "desativar" o uso do método
É a ordem apresentada em métodos de entrega no passo de fechamento de pedido
Nome do método que deve ser exibido
Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países "
Você deve selecionar os países que o método deve ser funcional
Por intermédio dessa funcionalidade é possível estipular o prazo em dias para vencimento do boleto
Espaço disponível para enviar uma linha de mensagem única por pedido, que só será exibida se o campo Observação contiver o texto 3.
Espaço disponível para enviar uma linha de mensagem única por pedido, que só será exibida se o campo Observação contiver o texto 3.
Espaço disponível para enviar uma linha de mensagem única por pedido, que só será exibida se o campo Observação contiver o texto 3.
Espaço disponível para enviar uma linha de mensagem única por pedido ou um parâmetro indicando qual Mensagem Adicional (1) se quer apresentar.
Enviar:
-
uma linha de mensagem ou
-
1 para apresentar a Mensagem Adicional 1 ou
-
2 para apresentar a Mensagem Adicional 2 ou
-
3 para apresentar as 3 linhas de Mensagem Adicional enviadas nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3.
Mensagem Adicional 1 (parâmetro 1) – Mensagem padrão pré-cadastrada que será exibida na emissão e na reemissão do boleto (se houver) e deverá ser registrado na tela de Informações Cadastrais do Módulo Itaú Shopline no item Mensagem Adicional 1.
Mensagem Adicional 2 (parâmetro 2) – Mensagem padrão pré-cadastrada que será exibida na emissão e na reemissão do boleto (se houver) e deverá ser registrado na tela de Informações Cadastrais do Módulo Itaú Shopline no item Mensagem Adicional 2.
Mensagem Adicional 3 (parâmetro 3) – Mensagem única por pedido que será exibida na emissão e na reemissão do boleto (se houver) e deverá ser enviada nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3.
Com Boleto é possível pagar menos do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão
Com Boleto é possível pagar mais do que o valor total. Selecione aqui o status, se este for o caso. Se você deixar isso em branco, ele tomará o status de pedido de pagamento autorizado como status padrão
Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento
Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir
- method-bankline.png
- method-boleto.png
E adicione a imagem no diretório do seu template
/skin/frontend//default/images/mozg_itau
A URL de retorno deve conter um endereço seguro para uma página de sucesso de sua loja.
Ex: https://www.minhaloja.com.br/mozg_itau/process/success/
Para o perfeito funcionamento do produto ItauShopLine.
É necessária a postagem de informações como BAIRRO e DOCUMENTO (CPF/CNPJ).
O formulário de cadastro de clientes no Magento deverá conter as devidas validações nesses campos.
No formulário de cadastro de clientes do Magento o campo BAIRRO se trata do campo "billing:street2", sugerimos aplicar as devidas validações.
No formulário de cadastro de clientes do Magento o atributo "tax_vat" geralmente é usado para armazenar "CPF/CNPJ", sugerimos ativar o atributo "tax_vat" e aplicar as devidas validações.
Deve ser feito analise no log para visualizar os parâmetros de envio ao ItauShopLine, caso alguma informação obrigatória não seja enviada ao itaú, deve ser exibido o erro 08
ERRO: "Problemas na criptografia ou o campo valor está incorreto. Entre em contato com o SOS Itaú Bankline. SOS - Itaú Bankline"
O erro está relacionado a Chave de Criptografia
Após a geração da Chave de Criptografia a mesma demora 24hrs para propagação
Sugiro aguardar o prazo para propagação e tentar novamente
Se o problema persistir sugiro entrar em contato com o Itaú apontando a ocorrência
É exibido esse retorno de erro, caso já exista no sistema do Itaú o número do pedido igual ao da transação corrente
Uma possível solução é incrementar os IDs dos pedidos
https://github.com/aligent/Magento_SetStartOrderNumber
--
Ao finalizar o pedido 100000112 é enviado para o Itaú como parâmetro do pedido como 00000112
--
Vamos supor que no passado já foi gerado uma transação junto ao Itaú usando o número do pedido como 113
Se atualmente formos novamente tentar criar um pedido com o número 00000113, deve ser retornado o erro
--
O processo da transação do pagamento é feito no sistema do Itaú e é aberto em popup.
Alem de estar no Manual do ItauShopLine
No próprio corpo HTML do ItauShopLine é enviado informações para a pagina que abriu o Popup
Sendo Obrigatório o uso do Popup para esse método de pagamento
Na eventualidade do navegador do usuário estiver habilitado o recurso de bloqueio de popup, será exibido um "aviso", induzindo o usuário ao clique para desbloqueio automático do popup.
Suporte Operacional Empresas
0300 100 7575
operemp@itau-unibanco.com.br
Banco Itaú-Unibanco S.A.
ou acesse
Para entrar em contato com a Itau
http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf
Equipe Mozg
🐈