Integração e-Commerce CiaShop

Descrição

Disponibilizada a Integração do Microsiga Protheus® com o E-commerce da CiaShop Versão RTM 3.23, para permitir a automatização dos processos de importação de cadastros de clientes e pedidos realizados no site para o ERP e exportação dos produtos e todos os cadastros relacionados ao Microsiga Protheus® para o E-Commerce da CiaShop.

 Neste integração, também é possível que os processos de gestão das vendas originadas do E-Commerce da CiaShop sejam realizadas através dos processos do Módulo Controle de Lojas (SIGALOJA).

Os processos do E-commerce CiaShop integrados com o  módulo Controle de Lojas (SIGALOJA) são:

• Tabelas de Preço (OMSA010).
• Administradora Financeira (MATA070).
• Venda Assistida (LOJA701).
• Contas a Receber da Venda (FINA040).
• Baixa de Títulos (FINA070).
• Cancelamento de NF/Orc (LOJA140).
• Liberação Créd/Estoque (MATA456).
• Devolução (LOJA720).
• Tabela de Preços Variante (LOJA900F).
• Cancelamento de Boletos  (LOJA907).
• Exclusão de Documento de Saída (MATA521)

Diagrama de Processos da Integração  CiaShop X Protheus® Controle de Lojas

Fluxo da Integração E-Commerce Ciashop

Cadastros (exportação)

O fluxo da exportação é realizado da seguinte forma:

• Os cadastros são realizados no ERP.
• Os serviços de controle executam a verificação da base de dados para identificar registros que precisam ser exportados ao site, considerando os incluídos e alterados desde a última exportação.
• As operações no site E-Commerce são executadas através dos métodos disponibilizados pela CiaShop.
• Os serviços de exportação ou de acompanhamento de execução pelo Schedule podem ser são acessados pelo Monitor de Serviços CiaShop (LOJA906).
•  Todos os serviços geram uma ocorrência de exportação  em um registro na tabela de Log de exportação para futura visualização.

Importante

O fluxo de importação é realizado da mesma forma que o fluxo de exportação, porém no sentido inverso.

Fluxos Integração E-Commerce CiaShop X Protheus® Controle de Lojas

Venda

Cancelamento

Devolução

Cancelamento de Boletos

     Processos Integrados do Protheus® para o E-Commerce CiaShop:

• Categorias/Departamentos (Amarração com produtos):
  • As Categorias no Protheus® são definidas como departamentos.
  • A categoria tem o objetivo de classificar os produtos facilitando a navegação dos clientes no site.
  • Possui uma estrutura hierárquica no conceito de pai-filho.
  • Um produto pode estar amarrado a mais de uma categoria.

Exemplo: o produto Bermuda pode estar vinculado às categorias Esporte->Futebol->Bermuda e Masculino->Bermuda. 

• • Uma categoria filha pode estar associada a apenas um pai.
  • O Protheus®envia ao site as categorias e as respectivas amarrações com os produtos.

• Produtos (pai e filho/variantes):
• Os produtos representam as mercadorias comercializadas na loja virtual, sendo que alguns podem utilizar o conceito de SKU (definido no E-Commerce CiaShop como variante), ou seja, são variações de características de um mesmo produto (grade ou produto paixproduto-filho).
• Os produtos-filhos(variantes) representam as variações do produto-pai, principalmente no que se refere a tamanho e cor.
• No Protheus®, é utilizada a grade para atender a esta necessidade.
• Para enviar ao site, o produto pai que é um produto final também, deve estar associado ao produto filho através de arquivo e interface de cadastro de grade de produtos.
• O Preço de Venda Promocional cadastrado na  Tabela de Preço é enviado no Serviço de Produtos.

A integração não envia a exclusão do preço de venda promocional. Nesse caso, é enviado o preço promocional com vigência vencida (data atual -2 até data atual -1)
• Estoque e Preço:
  • O Protheus®envia ao site a quantidade de itens por local de estoque, mediante o conteúdo do parâmetro MV_LJECOMG- sendo igual a branco todos os locais do cadastrados; considerando apenas o saldo atual em conjunto com o Preço deVenda Padrão cadastrado na Tabela de Preço.
• Tabela de Preço Variante:
  • O Protheus®envia ao site, além do preço de venda padrão e promocional,  outras Tabelas de Preço, sinalizadas como E-Commerce.
  
  Importante
  Na etapa de implantação, sugerimos que o processo cadastral seja realizado por etapas. Para isso, verifique se os cadastros predecessores foram integrados com sucesso.
  
  Exemplo: Antes de realizar o cadastro de relacionamento Produto x Categoria, verifique se o Produto e a Categoria foram enviados com sucesso para o E-Commerce, através de consulta da ocorrência no Monitor de Serviços CiaShop (LOJA906).

      Processos Integrados do site do E-commerce CiaShop para o Protheus®:

• Clientes.
• Pedidos.
  • Dados extras de Pedidos

     Disponibilização de novas rotinas no Microsiga Protheus® para Integração com E-Commerce CiaShop:

• Monitor de Serviços CiaShop (LOJA906):  

• Visualiza os serviços (jobs) -  associados ao processo de integração - agendadas para execução, com seu respectivo status (Ativo/Inativo

• Executa as tarefas manualmente, independente do estado de agendamento. 

• Visualiza o Log de execução das tarefas.

• Efetua a impressão do Relatório de Pedidos Integrados (LOJR902) - que imprime a relação dos pedidos e-commerce que foram gerados pedidos no ERP.

• Efetua a impressão do Relatório de Pedidos Não Integrados (LOJR903) - que imprime a relação dos pedidos e-commerce que não foram gerados pedidos no ERP e a respectiva ocorrência de erro.

• Realiza a consulta dos cadastros associados à venda e-commerce.
• Realiza uma pré-validação do produto a ser enviado para o e-commerce.

     Alteração das rotinas no Microsiga Protheus® para Integração com E-commerce Ciashop:

• Grade de Produtos (Variantes) (MATA550):

   Ao finalizar a inclusão ou alteração da grade, é apresentada uma tela para seleção do Produto Pai, dentre os produtos criados.  Ao confirmar a seleção, os demais produtos passam a ser filhos do Produto Pai e recebem o código do p            produto selecionado como B1_PRODPAI.

• Cadastro de Produtos (LOJA110):

   Exibe no grid de preços do produto, a data da exportação (data da última atualização para o site e-commerce), a sequência do registro na tabela de exportação, além dos novos campos enviados para o e-commerce:

• • Pai Ant (B0_ECPAIANT): ao preencher este campo, é enviado o XML de exclusão do relacionamento Variante X Produto.
  • Imagem Prod (B0_ECIMGFI): permite informar o nome do arquivo de imagem do produto-filho.
  • Descr. E-com (B0_ECTITU): Permite efetuar a descrição do Produto-Filho.
  • Comprimento: B0_ECCOMP: Permite informar o comprimento (em metros).
  • Largura: B0_ECLARGU: Permite informar a largura (em metros).
  • Profundidade: B0_ECPROFU: Permite inforrnar a profundidade (em metros).

• Cadastro de Categoria de Produtos (FATA140):

    Permite exibir a data da exportação (data da última atualização para o site e-commerce), a sequência do registro na tabela de exportação e se a categoria está ativa ou inativa para o E-Commerce.

• Cadastro de Complemento de Produtos (MATA180):

    Disponibilizou-se a pasta E-commerce com os campos específicos dos produtos que são negociados no site.

    Quando o campo E-commerce do produto for preenchido, a validação do preenchimento mínimo para evitar erros de exportação para o site, é acionada, além de disponibilizar a inclusão dos novos campos:

• Descr. E-com (B5_ECTITU): Descrição da variante associada ao produto-pai.
• Palavra Chav (B5_ECPCHAV): Palava-chave do produto.
• Cubagem C3 (B5_ECCUBAG): Cubagem do produto.
• Data Lancam (B5_ECDTLAN): Data de Lançamento do Produto.
• Imagem Prod (B5_ECIMGFI): Nome do arquivo de imagem associada ao produto-pai que consta no servidor e-commerce.
• Apresentacao (B5_ECAPRES): Valor do Folder Apresentação, da descrição de Produto no site.
• Beneficio (B5_ECBENFI): Valor do Folder Benefício da descrição de Produto no site.
• Indicacao (B5_ECINDIC): Valor do Folder Indicação da descrição de Produto no site.
• Comprimento: B5_ECCOMP: Permite informar o comprimento (em metros).
• Largura: B5_ECLARGU: Permite informar a largura (em metros).
• Profundidade: B5_ECPROFU: Permite inforrnar a profundidade (em metros).
  
  
• Cadastro de Transportadoras (MATA050):

   Implementado o campo Cod. E-commerce (A4_ECSERVI), que permite informar o código correspondente (de <-> para) ao Método de Entrega cadastrado no E-Commerce.

   O código vinculado ao cadastro da transportadora, deve ser o mesmo recebido pelo XML de pedido.

   É necessário criar um código de transportadora no Protheus® para cada código de tipo de envio configurado no site administrativo da CiaShop.

• Geração de Documento de Saída (MATA460A):

    Alteração da rotina de Emissão de Documento de Saída para atualizar o status do pedido para a etapa Pedido Enviado (30) nas vendas originadas do e-commerce CiaShop.

Importante

• O link de rastreio do Pedido informado no campo EC Rastr. (C5_RASTR) deve ser preenchido manualmente.
• Esta rotina atualiza  o número do título gerado na tabela de Notas Fiscais de Saída – Campos Número F2_DUPL e oprefixo F2_PREFIXO, além de gravar no orçamento associado ao Pedido o Número da Nota Fiscal (L1_DOC) e série da Nota Fiscal (L1_SERIE).
  
  
• Exclusão de Documento de Saída (MATA521)

              Alteração da rotina de Exclusão  de Documento de Saída para atualizar o status do pedido para a etapa anterior de  Pedido Enviado nas vendas originadas do e-commerce CiaShop.

• Tabelas de Preço (OMSA010)

   Implementada a opção de envio de múltiplas tabelas de preço para  e-commerce CiaShop, mediante a sinalização do campo e-commerce (DA0_ECFLAG).

Importante

• O cadastro do cabeçalho, onde é (são) definida(s) a(s) regra(s) de utilização da tabela utilizada na venda, é realizada no E-Commerce CiaShop.
• A integração envia os produtos associados à tabela, assim como os respectivos preços.
• Utilize essa funcionalidade caso deseje ter uma tabela de preço diferenciada por regra.
• Os procedimentos para o cadastro da tabela de Preço Padrão e Promocional mantém-se inalterados.

      Administradora Financeira (MATA070)

Obedecendo à regra do Módulo Controle de Lojas, a geração do títulos de Contas a Receber – referente à venda – e Contas a Pagar  - referente a Taxa Administrativa, passa a  ser realizada após a geração do orçamento e considera as informações contidas neste castrastro, em especial os seguintes campos:

• Cod. e-comme (AE_ECCODIG) – Este campo realiza o relacionamento entre o Método de Pagamento do e-commerce para a  localização da Administradora Financeira.
• Tipo Adminis (AE_TIPO) – Forma de pagamento (SX5).  As formas válidas para a Integração E-Commerce CiaShop são:
  • FI – Financeira: Nesta forma de pagamento, é gerado um Pedido de Venda com bloqueio de crédito, liberado mediante o pagamento do título.
  • CC/CD-  Cartão de Crédito/Débito – Nesta forma de pagamento é gerado um Pedido de Venda sem bloqueio de Crédito. Nesta forma de pagamento é possível gerar um título de Contas a Pagar para a Administradora Financeira.
  • Tx. Cobrança (AE_TAXA ) - Informe o valor da Taxa Administrativa, que poderá ser informada também por meio do Gridde Taxas Administrativas – para os tipos de Administradora de Cartão - Tipo CC/CD.

• Pedidos  (LOJA901A)

    Implementada a reserva de produtos e-commerce, mediante a habilitação do parâmetro MV_LJECOM0

Importante:

Para a reserva no Pedido de venda, é necessário que o campo C6_RESERVA esta configurado como usado no dicionário de Dados

    Implementada a venda de produtos do tipo Kit. Um  produto do tipo Kit é um produto composto por outros produtos.

Por exemplo: 

• Estojo de maquiagem (Kit)
  • Batom
  • Sombra
  •  Lápis 
• Computador (kit)
  • Monitor
  • Mouse 
  • Teclado
  • CPU

A rotina de Integração de  Pedidos (LOJA900A) identifica o produto do tipo Kit e realiza o lançamento dos itens que o compõem.

Importante

• • A montagem do produto tipo Kit deve ser realizada no E-commerce Ciashop, sendo que os produtos que o compõem devem ser enviados para o site anteriormente por meio dos serviços de Integração.
    
    Implementada melhoria com a disponibilização do parâmetro MV_LJIPENP na Integração de  Pedidos (LOJA900A), para  considerar o valor do IPI da tabela de preço dos produtos vendidos no E-Commerce Ciashop integrado com o Protheus®.
  • Desta forma, ao baixar o pedido do site, o valor do IPI é retirado para que possa ser calculado na geração da Nota Fiscal (Faturamento).
  • Exemplo de cálculo da geração do cálculo inverso do IPI – Parâmetro MV_LJIPENP habilitado:

                                                                                                     Fórmula:

                                                                                        Exemplo de cálculo da geração do cálculo inverso do IPI

Neste cenário o valor da venda gerada pelo e-commerce e a Nota Fiscal de Saída gerada pelo ERP Protheus® são iguais.

Implementada a integração de vendas realizadas em MarketPlace.

Neste cenário, a integração gera o cliente associado à venda na própria rotina de integração de Pedidos (LOJA901A).

Caso a Administradora Financeira associada à venda marketplace seja do tipo Financeira - campo Tipo Adminis (AE_TIPO) igual à FI - , é possível realizar a liberação do Pedido de Venda para Faturamento, sem realizar a baixa do título associado à venda; por meio da nova rotina Conf. Pagto CiaShop (LOJA901D) . Neste caso, é necessária a indicação da confirmação do pagamento - campos Financ. Prop (AE_FINPRO) igual a “Não” e Conf Pagto (AE_ECCNFPG) selecionado no cadastro de Administradora Financeira (LOJA070).

Fluxograma do Processo:

• Venda Assistida (LOJA701)

Implementada a geração do orçamento associado à venda e-commerce, de modo a oferecer suporte aos processos do módulo Controle de Lojas, e facilitar a localização dos componentes associados à venda e-commerce,  através dos campos:

• Ped Cli Ecom (L1_PEDEC) – Número do Pedido no e-commerce.
• Num. Pedido (L1_PEDRES) – Número do Pedido no ERP.
• Série (L1_SERPED)  e  Nota Fiscal (L1_DOCPED)  - Prefixo e Série dos Títulos Gerados (Contas a Receber e Contas a Pagar).

Importante

A geração do código da TES do produto, tanto para o Orçamento(SL1) quanto para o Pedido de Venda (SC5) sofreu alterações:

• Caso o parâmetro MV_LJECOMS esteja habilitado, será considerado prioritariamente o conteúdo do novo parâmetro MV_LJECOMR (código da TES para geração dos itens vendidos no site) que poderá ser macro executado, caso o mesmo possua o prefixo &.
  
  
• No caso do parâmetro MV_LJECOMR retornar branco,  será utilizada a funcionalidade TES Inteligente - função MaTESInt - Para a apuração da TES Inteligente, é considerada a operação 03 - venda pessoa física ou 01 - venda pessoa jurídica ou o conteúdo do parâmetro  MV_LJECOMV.  Caso a plataforma e-commerce CiaShop esteja com a funcionalidade de Revenda Pessoa Jurídica implementada, é considerada a operação informada no parâmetro MV_LJECMM2.
  
  
• Caso a MaTESInt retorne o valor em branco, será considerado o conteúdo do campo TESPadrao (B1_TS) e, caso este esteja em branco, o parâmetro MV_TESSAI.

• Contas a Receber da Venda (FINA040)

   Implementada a geração do títulos de Contas a Receber antes da emissão da Nota Fiscal de Venda, referente á venda e-commerce.

  Importante

   Para que não haja duplicidade de movimentação financeira, a TES associada à venda do item, não deve gerar financeiro.

   A geração de Contas a Receber, obedece às parametrizações do Módulo Controle deLojas. Não é necessária a ativação do Job de Integração ERP (LjGrvBatch).

• Baixa de Títulos (FINA070)
  Implementada a liberação automática de Crédito/Estoque (MATA456) do Pedido, mediante o processamento da baixa do título associado ao orçamento do e-commerce CiaShop com a forma de pagamento  - Campo FormPgto   (L1_FORMPG) -  tipo FI – Financiado.  O status do orçamento é enviado como Pagamento Confirmado (10)  através do serviço Status de Pedido (LOJA900E).
  
  
• Cancelamento de NF/Orc (LOJA140)

   Implementado o cancelamento de Orçamentos associado à venda no e-commerce CiaShop.  O status do orçamento é enviado como Cancelado (90) através do serviço Status de Pedido (LOJA900E).

• Liberação Créd/Estoque (MATA456)

   Implementado o bloqueio da liberação manual de Crédito/Estoque, caso o pedido esteja associado à um orçamento do e-commerce CiaShop de uma venda com a forma de tipo FI – Financiado.

• Devolução (LOJA720)

   Implementado a Devolução de Vendas, realizadas no e-commerce CiaShop. O status do orçamento é enviado como Devolvido (91) através do serviço Status de Pedido (LOJA900E).

  Importante

   O controle dos Créditos gerados pela operação de Devolução não estão integrados. Este processo deve ser gerenciado nos dois ambientes (ERP e e-commerce).

• Cancelamento de Boletos  (LOJA907)
  Implementado o Cancelamento de Orçamentos do tipo FI – Financiado, que estão vencidos e são referentes à vendas e-commerce CiaShop.  Assim como a rotina  Cancelamento de NF/Orc (LOJA140), o  status do orçamento é       enviado como Cancelado (90) através do serviço Status de Pedido (LOJA900E)
  
  
• Consulta Tracker (LJECTracker)

   Implementado no Monitor de Serviços CiaShop (LOJA906), a  Consulta Tracker, que realiza a consulta e visualização do Pedido, Reservas, Orçamentos e Títulos gerados da venda e-commerce.

• Validador de Cadastros de Produtos (LOJA900D).
  Implementado no Monitor de Serviços CiaShop (LOJA906),  o Validador de Cadastro de Produtos, que realiza uma pré-validação do produto , a fim de verificar se o mesmo está apto para integrar no e-commerce CiaShop.

   Logo abaixo, em Anexo II, segue detalhes sobre os itens validados no validador de cadastros.

Importante

Antes de executar os compatibilizadores U_UPDLO148 e U_UPDLO150 é imprescindível:

• Realizar a aplicação do pacote associado ao chamado TGZOXW ( o compatibilizador  U_UPDLO114 tem que estar com a data maior ou igual a 24/04/2016 )

• Realizar o backup da base de dados do produto que será executado o compatibilizador ( \PROTHEUS11_DATA\DATA e dos dicionários de dados SXs (\PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em ByYou Smart Client, digite U_UPDLO148 e U_UPDLO150 no campo Programa Inicial. 
   Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a 30/12/2015 (U_UPDLO148) e 22/04/2016 (U_UPDLO150)
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. 
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Atualizações do Compatibilizador

1.  Criação de tabela no arquivo SX2– Tabelas:

     2  Criação  de Campos no arquivo SX3 – Campos:

Tabela  MGM  - Ec Ciashop Result Sincronizada:

• Tabela MGN - EcCiashopLog Sincr Produtos:

• Tabela  MGO - Ec Ciashop Log Sincr Categoria:

• Tabela MGP - Ec Ciashop Log Sincr Cat X Prd:

•  Tabela  MGQ - Ec Ciashop Log Sincr Caracteri:

• Tabela  MGR - Ec Ciashop Log Sincr Estoque:

• Tabela  MGS - Ec Ciashop Log Sincr Comprador:

• Tabela  MGT - Ec Ciashop Log Sincr Stat Ped:

• Tabela  MGU - Ec Ciashop Log Sincr Pedidos: