Integração de Dados Plataforma Hub Magento E-Commerce Facilitando Negócios Conectando softwares com Magento Plataforma de E-Commerce
Integração de Dados Plataforma Hub Magento E-Commerce Este documento descreve a integração de um aplicativo de E- Commerce baseado na Plataforma Magento com um software de gestão ERP (Enterprise Resource Planning), detalhando um caso de uso de venda para explicar o funcionamento da integração entre o Magento e o ERP através da Plataforma Hub. Conteúdo Situação e desafio... 3 Solução... 4 Como funciona a integração?... 5 Benefícios e Funcionalidades... 7 Quais informações podem ser integradas?... 10 Faça parte da Plataforma Hub utilizando a atual interface de integração dos seus aplicativos... 10 Contato... 11 2
Situação e desafio Este documento descreve a integração de um aplicativo de E-Commerce baseado na Plataforma Magento com um aplicativo ERP (Enterprise Resource Planning), descrevendo um caso de uso de venda para explicar o funcionamento da integração entre o Magento e a Plataforma Hub. Ao passo que o aplicativo de E-Commerce se utiliza de Web-Services para integração; o aplicativo ERP realiza integrações com base em Arquivos de Texto no padrão EDI EDIFACT, recebendo e enviando dados através de um FTP. Além disso, um detalhe do processo de negócio é que o gerente do departamento de vendas deve receber o mesmo arquivo de texto por e-mail quando o valor da venda feita no E-Commerce estiver acima de um certo valor condição que classifica a venda como de grande porte. FTP Web-Service E-Commerce ERP Enquanto o aplicativo E-Commerce é executado em um servidor web e realiza chamadas web-service para integração; o aplicativo ERP é executado em um ambiente Windows e efetua suas integrações através de arquivos TXT no formato EDIFACT através de um FTP autenticado. Esta integração reflete a necessidade pela agilidade do processamento e gerenciamento das vendas efetuadas através do aplicativo de E-Commerce. Sabendo que os responsáveis pelo departamento de vendas utilizam o ERP para efetuar a gestão da empresa, e também dispositivos móveis conectados em e-mail para casos emergenciais de aprovação de determinadas vendas (como as de grande porte ), a definição do processo como citada traz um diferencial estratégico para a empresa. Após estudar e determinar que o melhor processo é a troca de arquivos e notificação por e-mail, além de manter o aplicativo de E-Commerce desacoplado do software ERP, e evitar a modificação do software ERP para que o gerente de vendas seja notificado via e-mail em vendas de grande porte, a empresa encontrou a Plataforma Hub como um meio efetivo de conduzir este processo. 3
Solução A execução da integração com a Plataforma Hub, descrita neste modelo, é iniciada após a confirmação da venda pelo aplicativo E-Commerce, que grava os dados da venda no banco de dados próprio. A Plataforma Hub faz a busca de dados através de Web Services ao E-Commerce, a cada determinado período de tempo préconfigurado, buscando registros de dados novos ou atualizados no formato XML. Após a análise e tradução dos dados em XML, a Plataforma Hub realiza a tradução dos dados da estrutura XML para a estrutura do padrão EDI EDIFACT; e finalmente gera o arquivo de texto para o ERP. Ao término desta tradução, o aplicativo da Plataforma Hub copia o arquivo gerado para o diretório do FTP responsável pelo armazenamento. Este diretório de FTP é monitorado pelo software ERP, de onde os arquivos serão importados para processamento. E-Mail Web-Service FTP E-Commerce ERP (1) O E-Commerce recebe a confirmação de uma venda, e dispara uma chamada a um web-service avisando sobre aquela venda. (2) A Plataforma Hub é notificada desta chamada, recebe, analisa e traduz os dados para um arquivo no formato EDIFACT. (3) Este arquivo é enviado para um FTP autenticado por usuário e senha, monitorado pelo aplicativo ERP. (4) Conforme regra específica, caso o valor da venda ultrapasse determinado valor, um e-mail é disparado para o gerente de vendas contendo o arquivo de texto no formato EDIFACT. Uma das propriedades vistas neste modelo é que a integração ocorre de forma assíncrona. Esta forma permite que exista um processo do lado do aplicativo ERP responsável por iniciar a importação de dados (até mesmo manualmente), evitando processamentos constantes de monitoramento, e funcionando até mesmo em casos onde o software de gestão está inativo. 4
Como funciona a integração? A integração com a plataforma Magento é realizada através das APIs padrões disponibilizadas e habilitadas no próprio Magento. A configuração de tais APIs é feita por um usuário administrador, que deve seguir simplesmente três passos dentro da plataforma Magento: Criar uma Role (papel ou perfil de usuário); Criar um Usuário; e configurar um detalhe técnico de esquema das mensagens de integração, o WS-I Compliance. 1. Criação da Role 2. Criação do Usuário 5
3. Configuração do WS-I Compliance Através da disponibilização do usuário criado na plataforma Magento, juntamente com uma chave de acesso gerada, a Plataforma Hub faz leituras a cada certo período de tempo pré-configurado, buscando dados criados no e-commerce, como novos clientes, endereços e principalmente vendas. De forma inversa, o aplicativo que deseja se integrar com aquele e-commerce gera dados como produtos (incluindo imagens), estoque, grupos, em seu próprio formato, e a Plataforma Hub busca, converte e envia para o Magento, criando tais registros. Assim, para uma integração com um e-commerce que utiliza a plataforma Magento, é necessário apenas criar uma Role, um Usuário, ajustar um detalhe de configuração, e então trabalhar nas configurações relativas ao software da outra extremidade. 6
Benefícios e Funcionalidades A Plataforma Hub fornece muito mais do que integrar diferentes formatos de dados entre diversos aplicativos de negócio, e interconectar as empresas presentes na rede. Veja algumas funcionalidades poderosas aliadas ao uso da plataforma: Alertas de falhas: O serviço realiza monitoramento em tempo real, e, em caso de algum erro de tradução, relata as falhas através de e-mails de alerta para as pessoas responsáveis. Em casos de integração crítica, os responsáveis pela integração são informados no momento que o erro ocorreu, podendo tomar providências efetivas e em tempo hábil. A Plataforma Hub informa a quantas pessoas forem necessárias através de e-mail caso algum problema ocorra. Relatórios de transações: Verifique as transações realizadas durante determinado período, mensagens enviadas e recebidas, gerenciando a troca de dados de cada aplicativo integrado. Cada mensagem enviada tem todo o seu processamento registrado em logs, permitindo posterior análise e auditoria. Através de relatórios pré-definidos, é possível analisar mensagens enviadas e recebidas, data e hora, emitente, destinatário, além de outros dados, gerenciando os processos de troca de dados de cada aplicativo integrado. Confirmação funcional: Suporta geração automática e reconciliação de confirmações funcionais. É possível utilizar-se de mensagens de confirmação proprietárias. Uma confirmação positiva certifica ambos os parceiros que a mensagem está com a sintaxe correta. Uma confirmação negativa especifica onde o erro de sintaxe ocorreu na mensagem, alertando o emissor para tomar as ações corretivas. Checagem de mensagens duplicadas: Mensagens são examinadas por duplicidade contra mensagens anteriores baseado em um número de critérios, como números de controle, emissor, receptor, tipo de mensagem, data, e com a opção de usar chaves identificadoras. Mensagens duplicadas não são encaminhadas para o seu destino. O usuário é certificado que seu aplicativo de negócio não está recebendo mensagens duplicadas, evitando a necessidade de realizar esta checagem de duplicidade no aplicativo de negócio. Mapeamento de mensagens com diferentes hierarquias A hierarquia da mensagem na sua interface de aplicação pode ser diferente da que seu parceiro possui, incluindo casos onde: 7
a) Uma mensagem tem uma hierarquia de segmentos mestre-detalhe, enquanto a outra mensagem possui todos os registros mestres primeiro, seguidos dos registros detalhes. b) Um segmento em uma mensagem precisa ser mapeado para dois ou mais segmentos na outra mensagem. c) Um campo que ocorre apenas uma vez em uma mensagem pode precisar ser mapeado repetidamente para toda linha de item na outra mensagem, etc. A Plataforma Hub permite mapear segmentos apropriadamente em cabeçalhos, detalhes e totalizadores, incluindo mapeamento de segmentos de diferentes níveis nas mensagens de entrada e saída. Mapeamento de campos possuindo atributos diferentes A Plataforma Hub mapeia campos, na qual diferem em atributos como tamanhos mínimo e máximo, tipos de dados (um pode ser alfanumérico, por exemplo, enquanto outro pode ser numérico), formato de dados (um pode ser campo de tamanho fixo com espaço a esquerda, enquanto outro pode ser tamanho variável), padrões de dados (um formato de data pode ser yyyymmdd, enquanto outro pode ser ddmmyyyy), etc. Mapeamento de valores fixos A Plataforma Hub pode mapear campos de valores fixos na mensagem de saída para a qual não há campo disponível correspondente para mapeamento na mensagem de origem. Diferentes valores fixos podem também ser mapeados para campos na mensagem de saída baseado em valores de dados (incluindo valores em branco) nos campos correspondentes da mensagem de origem. Mapeamento de valores de referência cruzada A Plataforma Hub pode mapear campos que necessitam que os dados sejam referenciados em diferentes valores durante entrada e saída de traduções. Estes mapas são comuns quando há o mapeamento de códigos de produtos e números de peças, que podem ser diferentes para cada parceiro comercial. Mapeamento baseado em condições ou situações não usuais A Plataforma Hub tem a habilidade de mapear campos baseados em condições complexas na mensagem de origem: Se esta situação ocorre na mensagem de origem então mapeia os seguintes campos na mensagem de destino usando o seguinte critério de mapeamento. A maioria dos mapas baseados em situação podem ser criados usando uma diretiva simples baseada em qualificadores, na qual se usa funções como arrastar e soltar e apontar e clicar, necessitando de muito pouco esforço para o mapeamento. Outras, que são mais complexas, podem ser criadas 8
usando expressões de livre contexto baseadas em mapeamento (mapas semânticos) com um pouco mais de esforço para realização do mapeamento. Mapeamento de semânticas diferentes A Plataforma Hub tem a habilidade de mapear mensagens que diferenciam a semântica de informações, onde uma unidade de informação (como Comprador e Número de Telefone do Transportador, Número de Celular, Número de Fax, etc) está contido em dois ou mais campos, fazendo uso de valores únicos para distinguir a semântica. Cálculo de mapeamento de um resultado A Plataforma Hub pode executar cálculos de múltiplos campos como quantidade e preço unitário na mensagem de origem, e mapear o resultado em um único campo total na mensagem de saída. Confiabilidade de Dados A Plataforma Hub analisa as mensagens de seu aplicativo e o de seu parceiro compreensivamente para garantir a integridade de sintaxe, requisitos sintáticos, requisitos de balanceamento de dados, requisitos situacionais, validação de dados contra conjuntos de dados externos, requisitos de validação específicos do parceiro, etc. O usuário é então certificado que suas mensagens, enviadas ou recebidas, estão livres de erros. Roteamento de mensagens A Plataforma Hub possui uma excelente capacidade de roteamento permitindo que mensagens sejam roteadas de vários parceiros para qualquer um de seus aplicativos. A Plataforma Hub usa uma combinação de informação de Emissor, informação de Receptor e tipo de mensagem para fornecer várias opções de roteamento de mensagens. Cada relacionamento com parceiro pode rotear mensagens de forma diferente. Notas e comentários de mapeamento A Plataforma Hub permite concatenar ou combinar campos como notas e comentários, na qual ocorrem múltiplas instâncias do mesmo segmento em mensagens X12 e EDIFACT, e mapeá-las em um campo da mensagem de aplicação. Também permite fazer o inverso, por exemplo, dividindo um campo para mapeá-lo em múltiplas instâncias do mesmo segmento. 9
Quais informações podem ser integradas? A integração com a Plataforma Magento de E-Commerce permite a integração dos seguintes conjuntos de informação: 1. Produtos 2. Preços 3. Estoques 4. Vendas 5. Clientes 6. Endereços 7. Nota Fiscal / Invoice 8. Entregas É possível realizar a integração com módulos customizados, entretanto este processo depende da disponibilização do módulo e web service de consumo por parte do mantenedor da customização em questão na Plataforma Magento. Faça parte da Plataforma Hub utilizando a atual interface de integração dos seus aplicativos A Plataforma Hub permite que o seu aplicativo comercial seja integrado com os demais aplicativos presentes na rede sem a necessidade de qualquer modificação através de programação. Se o seu aplicativo já possui uma interface de integração (como arquivos de texto, ou até banco de dados, por exemplo), é preciso apenas inserir os formatos de dados na plataforma e começar a utilizar. Uma vez disponibilizados os formatos de dados do aplicativo para integração, já é possível realizar a integração com softwares já presentes na plataforma, como o Magento, trocando dados de forma transparente. A possibilidade de integração de qualquer para qualquer formato e através de diferentes meios de comunicação faz com que a Plataforma Hub conecte aplicativos rapidamente. Assim, a Plataforma Hub fornece o melhor custo benefício para pequenas e médias empresas quando integrando aplicativos internos e parceiros de negócio, facilitando negócios, e também considerando os objetivos de longo prazo das empresas conectadas. 10
Contato A Hub2b é uma empresa de Tecnologia da Informação, situada em Chapecó - SC - Brasil, em conexão direta com Nagpur - Índia, fundada no ano de 2012. Atua na área de B2B (Business to Business), especificamente com Integração de Dados, com o objetivo de conectar empresas e facilitar negócios através de software. Importando tecnologia e know-how da Índia, traz mais de 15 anos de experiência na área de EDI (Troca Eletrônica de Dados ou Electronic Data Interchange), e excelentes produtos. Skype Telefone sergiovenicius ricksponchi (49) 3321 8339 (49) 9978 9387 E-Mail atendimento@hub2b.com.br 11