2017 © Pedro Peláez
 

magento-module magento-itau-php_56

Integração ao itau

image

mozgbrasil/magento-itau-php_56

Integração ao itau

  • Friday, July 27, 2018
  • by mozgbrasil
  • Repository
  • 1 Watchers
  • 0 Stars
  • 254 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 2 Versions
  • 25 % Grown

The README.md

valid XHTML, (*1)

Mozg\Itau

Sinopse

Integração a Itaú Shopline, (*2)

Motivação

Atender o mercado de módulos para Magento oferecendo melhorias e um excelente suporte, (*3)

Demonstração

Clique para visualizar o vídeo, (*4)

Suporte / Dúvidas

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, (*5)

Preço

Clique aqui, (*6)

Recursos do módulo

  • [✓] Transação
  • [✓] Consulta

Característica técnica

No checkout é feito o processo de autorização, (*7)

Na página de sucesso é enviado infomações para o recurso de notificação da transação, (*8)

Via CRON deve ser processado a notificação da transação,, (*9)

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, (*10)

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, (*11)

Quando o pedido é enviado o status é alterado para "complete" ou seja "Completo", (*12)

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, (*13)

Setup Cron

Para o uso do método é necessário ativar a CRON para o Magento, (*14)

Clique aqui para visualizar o documento da MOZG, (*15)

Certifique-se de que ação esteja sendo executado a cada minuto, (*16)

Esse módulo usa o cronjob para processar as notificações, (*17)

O módulo executa as notificações que foram recebidas há pelo menos 5 minutos., (*18)

Testando na Heroku

Gostaria de apresentar o aplicativo que disponibilizei para a plataforma Heroku, (*19)

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, (*20)

https://github.com/mozgbrasil/heroku-magento#descrição, (*21)

Instalação - Atualização - Desinstalação - Desativação

--, (*22)

Sugiro "printar" as telas com todos os procedimentos executados, (*23)

Envie para nós as imagens das telas na eventualidade de quaisquer dificuldades, (*24)

--, (*25)

Este módulo destina-se a ser instalado usando o Composer, (*26)

Execute o seguinte comando no terminal, para visualizar a existencia do Composer e sua versão, (*27)

composer --version

Caso não tenha o Composer em seu ambiente, sugiro ler o seguinte artigo Clique aqui, (*28)

--, (*29)

É necessário que o servidor tenha o suporte a extensão ionCube PHP Loader, (*30)

Para visualizar a existência da extensão nesse ambiente denominado PHP CLI, execute o seguinte comando no terminal, (*31)

php -v

Para visualizar se essa extensão está ativa em seu servidor no ambiente denominado PHP WEB, (*32)

Certique se da presença do arquivo phpinfo.php na raiz do seu projeto, (*33)

<?php phpinfo(); ?>

Caso não exista o arquivo phpinfo.php na raiz do projeto Magento, crie o mesmo adicionado o conteúdo acima, (*34)

Acesse o arquivo pelo browser, (*35)

Em seguida pesquise pelo termo "ionCube PHP Loader", (*36)

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, (*37)

Caso tenha a permissão e queira ativar a extensão, Clique aqui, (*38)

Em "Loader Downloads API", efetue download do pacote compatível com o seu servidor, (*39)

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, (*40)

Clique aqui para ver os processos executados, (*41)

--, (*42)

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, (*43)

https://raw.githubusercontent.com/mozgbrasil/heroku-magento/master/phpinfo-ioncube-encoder10-x86-64-php_56.php, (*44)

--, (*45)

Para utilizar o(s) módulo(s) da MOZG é necessário aceitar o Acordo de licença do usuário final, (*46)

--, (*47)

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, (*48)

--, (*49)

Sugiro efetuar backup da plataforma Magento e do banco de dados, (*50)

--, (*51)

Antes de efetuar qualquer atualização no Magento sempre mantenha o Compiler e o Cache desativado, (*52)

--, (*53)

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, (*54)

{
  "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, (*55)

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_56:dev-master

Você pode verificar se o módulo está instalado, indo ao backend em:, (*56)

STORES -> Configuration -> ADVANCED/Advanced -> Disable Modules Output

--, (*57)

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, (*58)

composer update

Na ocorrência de erro, renomeie a pasta /vendor/mozgbrasil e execute novamente, (*59)

Para checar a data do módulo execute o seguinte comando, (*60)

grep -ri --include=*.json 'time": "' ./vendor/mozgbrasil

--, (*61)

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_56

--, (*62)

Para desativar o módulo

  1. Antes de efetuar qualquer processo que envolva atualização sobre o Magento é necessário manter o Compiler e Cache desativado, (*63)

  2. Caso queira desativar os módulos da MOZG renomeie a seguinte pasta app/code/local/Mozg, (*64)

A desativação do módulo pode ser usado para detectar se determinada ocorrência tem relação com o módulo, (*65)

Como configurar o método de pagamento

Para configurar o método de pagamento, acesse no backend em:, (*66)

STORES -> Configuration -> Sales/Payment Methods -> Itau (powered by MOZG)

Você terá os campos a seguir, (*67)

Itau Configurações Padrão

Configurações necessárias

Código da Empresa

Para obter o número do código da empresa acesse o Internet Banking do Itaú, (*68)

Recebimentos > Itaú Shopline > Informações Cadastrais, (*69)

Chave de Criptografia

Para obter o número da chave de criptografia acesse o Internet Banking do Itaú, (*70)

Recebimentos > Itaú Shopline > Informações Cadastrais, (*71)

Avançado: Processamento de Pedidos Magento

Status do pedido: ordem de criação

Status dos pedidos recém-criados, antes da confirmação de resultado de pagamento via notificações de servidor da operadora, (*72)

Status do pedido: autorização de pagamento

Status dos pedidos após autorização confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*73)

Status do pedido: pagamento confirmado

Status dos pedidos após captura confirmada por uma notificação de AUTORIZAÇÃO da operadora, (*74)

Status do pedido: cancelamento de pedido

Status dos pedidos após cancelamento confirmada por uma notificação de CANCELAMENTO da operadora, (*75)

Se as encomendas já estiverem facturadas, não poderão ser canceladas, (*76)

Status do pedido: captura de pagamento (produtos virtuais)

Selecione somente o status atribuído ao estado concluído, deixe vazio para usar o mesmo que os produtos normais, (*77)

Status do pedido: Reembolsado

Status dos pedidos após reembolso confirmada por uma notificação de REEMBOLSO da operadora, (*78)

Status do pedido: Reembolsado Parcial

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., (*79)

Status do pedido: pedidos pendentes

Status dos pedidos após notificação de PENDENCIA da operadora, (*80)

Tipo de Captura

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, (*81)

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", (*82)

Criar uma fatura pendente (apenas para captura manual)

Isso criará uma fatura pendente se a notificação de AUTORIZAÇÃO for recebida., (*83)

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., (*84)

Status do pedido: Capturar no embarque

Se você habilitar esta função será feito uma solicitação de captura para a operadora se você fizer o envio, (*85)

Ativar Descancelar pedido

Se uma pedido é cancelada por algum motivo, mas recebeu uma notificação de que o pagamento é autorizado, isso cancelará automaticamente o pedido, (*86)

Cancelamento\Reembolso automático quando o pedido é cancelado

Ativar / Desativar reembolso automático ao cancelar um pedido, (*87)

E-mail da fatura

Ativar / desativar atualizações de e-mails, (*88)

Enviar e-mail de notificação do status do pedido

Ativar / desativar e-mails de atualização para todas as alterações no status do pedido para o cliente, (*89)

Ativar log de depuração

Deve ser armazenado os processos do módulo em var/log/, (*90)

O arquivo, (*91)

DATE_mozg.log, (*92)

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, (*93)

O arquivo, (*94)

payment_METHOD.log, (*95)

Avançado: Itau Notificações

Ignorar notificação de reembolso

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., (*96)

Avançado: Experiência de Checkout

Redirecionar o destino após o cancelamento

Determina como os compradores são redirecionados após cancelar um pagamento., (*97)

Método de pagamento método de renderização

Determina se os métodos de pagamento serão exibidos com seu logotipo ou apenas o nome., (*98)

Idioma local (opcional)

Isso substituirá o local do cliente padrão do armazenamento do Magento., (*99)

Deixe vazio para deixar Magento decidir (Ex: nl_NL), (*100)

Código do país ISO (opcional)

Isso irá substituir o país do endereço de faturamento do comprador ao determinar quais métodos de pagamento serão exibidos., (*101)

Itaú Shopline

Ativar

Para "ativar" ou "desativar" o uso do método, (*102)

Ordem de exibição

É a ordem apresentada em métodos de entrega no passo de fechamento de pedido, (*103)

Título

Nome do método que deve ser exibido, (*104)

Pagamentos aplicáveis aos países

Você pode definir se o método deve funcionar para "Todos os Países aceito" ou "Especificar Países ", (*105)

Pagamentos específicos aos países

Você deve selecionar os países que o método deve ser funcional, (*106)

Vencimento (em dias)

Por intermédio dessa funcionalidade é possível estipular o prazo em dias para vencimento do boleto, (*107)

Observação Adicional (1)

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., (*108)

Observação Adicional (2)

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., (*109)

Observação Adicional (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., (*110)

Observação

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., (*111)

Enviar:, (*112)

  • uma linha de mensagem ou, (*113)

  • 1 para apresentar a Mensagem Adicional 1 ou, (*114)

  • 2 para apresentar a Mensagem Adicional 2 ou, (*115)

  • 3 para apresentar as 3 linhas de Mensagem Adicional enviadas nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3., (*116)

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., (*117)

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., (*118)

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., (*119)

Status do pedido não pago

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, (*120)

Status do pedido pago em excesso

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, (*121)

Visível em

Determine a visibilidade desse método de pagamento no frontend e/ou backend do Magento, (*122)

Perguntas mais frequentes "FAQ"

Como alterar a imagem do método

Pode ser adicionado a imagem, contendo qualquer uma das nomenclaturas a seguir, (*123)

  • method-bankline.png
  • method-boleto.png

E adicione a imagem no diretório do seu template, (*124)

/skin/frontend/, (*125)

URL de retorno no sistema do Itaú

A URL de retorno deve conter um endereço seguro para uma página de sucesso de sua loja., (*126)

Ex: https://www.minhaloja.com.br/mozg_itau/process/success/, (*127)

Dependências

Para o perfeito funcionamento do produto ItauShopLine., (*128)

É necessária a postagem de informações como BAIRRO e DOCUMENTO (CPF/CNPJ)., (*129)

O formulário de cadastro de clientes no Magento deverá conter as devidas validações nesses campos., (*130)

No formulário de cadastro de clientes do Magento o campo BAIRRO se trata do campo "billing:street2", sugerimos aplicar as devidas validações., (*131)

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., (*132)

ERRO: "Problemas no processamento, tente mais tarde. (Erro 08) SOS - Itaú Bankline"

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, (*133)

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, (*134)

Após a geração da Chave de Criptografia a mesma demora 24hrs para propagação, (*135)

Sugiro aguardar o prazo para propagação e tentar novamente, (*136)

Se o problema persistir sugiro entrar em contato com o Itaú apontando a ocorrência, (*137)

ERRO: "data ou valor do boleto diferem do registro original"

É exibido esse retorno de erro, caso já exista no sistema do Itaú o número do pedido igual ao da transação corrente, (*138)

Uma possível solução é incrementar os IDs dos pedidos, (*139)

https://github.com/aligent/Magento_SetStartOrderNumber, (*140)

--, (*141)

Ao finalizar o pedido 100000112 é enviado para o Itaú como parâmetro do pedido como 00000112, (*142)

--, (*143)

Vamos supor que no passado já foi gerado uma transação junto ao Itaú usando o número do pedido como 113, (*144)

Se atualmente formos novamente tentar criar um pedido com o número 00000113, deve ser retornado o erro, (*145)

--, (*146)

Observações

O processo da transação do pagamento é feito no sistema do Itaú e é aberto em popup., (*147)

Alem de estar no Manual do ItauShopLine, (*148)

No próprio corpo HTML do ItauShopLine é enviado informações para a pagina que abriu o Popup, (*149)

Sendo Obrigatório o uso do Popup para esse método de pagamento, (*150)

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., (*151)

Dados de contato - Itau

Suporte Operacional Empresas
0300 100 7575
operemp@itau-unibanco.com.br
Banco Itaú-Unibanco S.A., (*152)

ou acesse, (*153)

Para entrar em contato com a Itau, (*154)

Manual

http://download.itau.com.br/downloadcenter/arquivos/Manual_Tecnico_ItauShopline.pdf, (*155)

Contribuintes

Equipe Mozg, (*156)

License

Comercial License, (*157)

Badges

Join the chat at https://gitter.im/mozgbrasil Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads Reference Status Dependency Status, (*158)

:cat2:, (*159)

The Versions

27/07 2018

dev-master

9999999-dev http://mozg.com.br

Integração ao itau

  Sources   Download

proprietary

The Requires

 

payment magento itaú pagamento cerebrum mozg

01/03 2018

1.0.0

1.0.0.0 http://mozg.com.br

Integração ao itau

  Sources   Download

proprietary

The Requires

 

payment magento itaú pagamento cerebrum mozg