Integração Protheus x CiaShop MultiEstoque

Características do Requisito

Descrição

Alterado o cadastro de Identificação de Lojas (LOJA080) para indicar se a filial informada e o locais de estoque informados irão para o e-commerce CiaShop através dos métodos da API: branch e warehouse; enviados pela rotina LOJA900I - Cadastro de Filiais e Armazéns; respectivamente, caso o campo e-commerce esteja com o valor Ativo.

Alterado a rotina de envio de Produtos (LOJA900A) para não enviar o saldo do produto, caso exista ao menos uma loja cadastrada com filial e locais de estoque a ser integrados com o e-commerce CiaShop - campo e-commerce esteja com o valor Ativo.

 Alterada a rotina de envio de Estoque/Preço (LOJA900C) para enviar o Preço Promocional e a  sua vigência, além do saldo por armazém. O envio de saldo por armazém somente será enviado caso exista ao menos uma loja cadastrada com filial e locais de estoque a ser integrados com o e-commerce CiaShop.

Alterada a rotina de Monitor de Serviços CiaShop (LOJA906) para enviar a confirmação de pedidos para o e-commerce CiaShop que não tenham sido confirmados, em virtude de problemas na integração

Alterada a rotina de recebimento de Pedidos (LOJA901A) para realizar a integração de Pedidos com o local de estoque definido no item. Somente serão integrados pedidos com uma filial e armazém.

 Alterada a rotina de envio de Status de Pedidos (LOJA900E) para realizar o envio de status de Pedido, conforme a filial associada ao armazém e-commerce.

Importante: Esta melhoria depende que a integração e-commerce CiaShop esteja implantada, conforme o Documento Técnico http://tdn.totvs.com/display/PROT/DT_Integracao_e-Commerce_CiaShop_Versao11.80 além da implantação do cadastro de Token, conforme o Documento Técnico: http://tdn.totvs.com/display/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN

Nesta melhoria não está contemplada a geração de Multi-Entrega (Multi-CD)

Importante

Antes de executar o compatibilizador informe o UPDLO148 é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório  \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \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 Microsiga Protheus TOTVS Smart Client (se versão 10), digite o n U_UPDLO148 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 à 16/12/2016
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.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Atualizações do Compatibilizador

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

 Tabela MGR - EC CiaShop Log Sincr Estoque

2.  Alteração  de Campos no arquivo SX3 – Campos:

Tabela MGR - EC CiaShop Log Sincr Estoque

*  Este campo possui como tamanho a somatória dos campos MGR_FILIAL e MGR_ARMAZE

• Tabela MGU - Log Sincr Pedidos

• Tabela SLJ - Identificação de Lojas

 Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

3.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

Procedimento para Utilização

Pré-Requisito:

Implantação do cadastro de Token, conforme o Documento Técnico: http://tdn.totvs.com/display/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN

Cadastro de Filiais e Armazéns:

       1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Gerencia Vendas / Identificação de Lojas (LOJA080).

O sistema apresenta a janela de lojas cadastradas

       2.            Posicione o cursor em uma Loja e clique em Alterar.

       3.            Na campo Cod. Empresa (LJ_RPCEMP), informe o código da empresa que é executada a integração e-commerce.

       4.            No campo Cod. Filial (LJ_RPCFIL), informe a filial pertencente à empresa ao qual é executada a integração e-commerce 

       5.            No campo Armazém (LJ_LOCAL), informe os armazéns que serão enviados o saldo em estoque. Este campo deve ser preenchido e o armazéns devem estar cadastrados para a filial informada no campo Cod Filial (LJ_RPCFIL) deste cadastro.

       6.          No campo e-commerce (LJ_ECFLAG), informe se o cadastro de filialis de armazéns irão para o e-commerce, caso estejam com valor 1- Ativo

 Monitor de Serviços CiaShop - Envio do cadastro de Filiais e Armazéns:

  1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Cadastros / Monitor Serv. CiaShop (LOJA906).

O sistema apresenta a janela com a lista de serviços disponíveis com a integração

       2.            Para realizar o envio do cadastro de Filiais e armazéns, aguarde a execução do Serviço LOJA900I - Cadastro de Filiais e Amazéns e/ou LOJA900C - Estoque/Preço, que executa uma chamada à rotina LOJA900I.

       3.            No botão XML envio, visualize o Json enviado.

       4.            No botão XML Retorno, visualize a mensagem de Retorno

       5.            No botão Log visualize o resultado do envio das mensagens.

Importante: Nas API, a execução e o envio é realizado unitariamente. Não existe um cadastro de detalhe de envio dos dados.

No serviço de armazéns warehouse, é enviado o endereço da Filial cadastrada no armazém, considerando o endereço de cobrança ou entrega, conforme o parâmetro MV_SPEDEND

Importante: 

Realize a geração e o cadastro do Token para a execução dos métodos da API de envio da filial (branch) e armazém (warehouse)

O código do armazém enviado para a CiaShop (atributo erpId do Método warehouse) é composto das seguintes informações: campo  Cod. Filial (LJ_RPCFIL) + Código do Armazém.

Exemplo:

Quando o cadastro de filiais e Armazéns forem enviados para o e-commerce, o campo  Data Exp (LJ_ECDTEX)  será preenchido.

O campo Cod Fil EC (LJ_ECIDFIL) é preenchido com o código da filial cadastrada retornado pela integração no e-commerce.

Monitor de Serviços CiaShop - Envio do Estoque/Preço

  1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Cadastros / Monitor Serv. CiaShop (LOJA906).

O sistema apresenta a janela com a lista de serviços disponíveis com a integração

       2.            Para realizar o envio do estoque, aguarde a execução do serviço LOJA900C - Estoque/Preço.

       3.            No botão XML envio, visualize o XML enviado.

       4.            No botão XML Retorno, visualize a mensagem de Retorno

       5.            No botão Log, visualize o resultado do envio das mensagens pelo API.

       6.            No botão Detalhes, visualize as informações enviadas.

Importante: Assim, como  se comporta as informações de saldo e preço do produto, as informações da promoção somente serão enviadas caso haja alteração com os dados  enviados anteriormente

O envio de saldo por armazém somente será realizado caso exista ao menos uma loja cadastrada com filial e locais de estoque a ser integrados com o e-commerce CiaShop - campo Status e-comm (LJ_ECFLAG) valor Ativo.

Monitor de Serviços CiaShop - Confirmação de Pedidos para o e-commerce

  1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Cadastros / Monitor Serv. CiaShop (LOJA906).

O sistema apresenta a janela com a lista de serviços disponíveis com a integração

       2.            Aguarde a execução do serviço LOJA901A - Pedidos.

       3.            No botão XML envio, visualize o XML enviado.

       4.            No botão XML Retorno, visualize a mensagem de Retorno

       5.            No botão Detalhes, visualize os pedidos integrados e identifique um pedido que não tenha sido enviada a confirmação para o e-commerce CiaShop, através do campo Pedido Conf (MGU_CONFIR) valor 0.

       6.            No botão Ações relacionadas, selecione a opção Confirmar Pedido.

       7.            No campo Pedido e-commerce: informe o número do Pedido e-commerce, identificado no passo 6  e confirme.

       8.            Confirme a mensagem de confirmação enviada para o e-commerce.

Importante: Uma vez enviada a confirmação do Pedidos e-commerce, o mesmo não será mais listado nas próximas execuções do serviço de integração de pedidos.

Somente os pedidos não-confirmados/com erros durante o serviço de integração de Pedidos (LOJA901A), poderão ter a confirmação enviada.

Monitor de Serviços CiaShop - Integração de Pedidos com  local de estoque cadastrado para a mesma filial de execução da rotina

  Pré-requisito: realize uma compra de um produto para um Cliente associado a um local de estoque (armazém), cuja filial seja a mesma da execução da rotina

Importante: Para configurações do armazém no e-commerce CiaShop, acesse o seguinte documento:

  1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Cadastros / Monitor Serv. CiaShop (LOJA906).

O sistema apresenta a janela com a lista de serviços disponíveis com a integração

       2.            Aguarde a execução do serviço LOJA901A - Pedidos.

       3.            No botão XML envio, visualize o XML enviado.

       4.            No botão XML Retorno, visualize a mensagem de Retorno

       5.            No botão Detalhes, visualize os pedidos integrados com sucesso - através do campo Pedido Conf (MGU_CONFIR) valor 1-   e identifique um pedido, cuja a filial seja a mesma da execução da rotina (campo Fil Ped EC MGU_FILPED em branco).

       6.            No botão Cons Tracker, informe o número do pedido e-commerce gerado na compra do site

       7.            Posicione sobre o item do Pedido de Venda  e acesse o botão Detalhes,  para visualizar o  local de estoque informado para o item do Pedido

Importante:

O código do armazém recebido pela para a CiaShop (atributo erpId da tag  receipt_Item_warehouses/warehouse_item) é composto das seguintes informações: campo  Cod. Filial  + Código do Armazém, por isso quando o pedido que contenha o armazém é integrado para o ERP são consideradas as seguintes informações  no processamento da venda

Exemplo:

Monitor de Serviços CiaShop - Integração de Pedidos com  local de estoque cadastrado para a filial diferente da  de execução da rotina

  Pré-requisito: realize uma compra de um produto para um Cliente associado a um local de estoque (armazém), cuja filial não seja a mesma da execução da rotina

Importante: Para configurações do armazém no e-commerce CiaShop, acesse o seguinte documento:

  1.            No Controle de Lojas (SIGALOJA), acesse Atualizações / Cadastros / Monitor Serv. CiaShop (LOJA906).

O sistema apresenta a janela com a lista de serviços disponíveis com a integração

       2.            Aguarde a execução do serviço LOJA901A - Pedidos.

Importante: 

a) Antes de realizar o processamento do Pedido, a filial do sistema é alterada para a filial associada ao local de estoque/armazém e-commerce.

Por isso, sugerimos a revisão dos parâmetros e-commerce e das tabelas envolvidas no processo de integração e-commerce ( exemplo: SA3, SA6, SE4, SA4, SAE, DA0, DA1, SF4, SB1, SB2), a fim de verificar se existem cadastros para as filiais envolvidas e/ou faz-se necessário a criação de parâmetros exclusivos, em virtude da tabela associada possuir chaves diferentes por filial

Exemplo:

b) Caso o cliente não exista na filial que está sendo realizada a integração de local de estoque, o mesmo será incluído pela rotina de integração de pedidos

       3.            No botão XML envio, visualize o XML enviado.

       4.            No botão XML Retorno, visualize a mensagem de Retorno

       5.            No botão Detalhes, visualize os pedidos integrados com sucesso - através do campo Pedido Conf (MGU_CONFIR) valor 1-   e identifique um pedido, cuja a filial diferente da de execução da rotina (campo Fil Ped EC MGU_FILPED preenchido).

       6.            No botão Cons Tracker, informe o número do pedido e-commerce gerado na compra do site

       7.            Posicione sobre o item do Pedido de Venda  e acesse o botão Detalhes,  e verifique que não é possível a visualização dos dados da venda, pois a filial da venda é diferente da filial do Pedido

 c) A Integração não processa pedidos vinculados a mais de uma filial