Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Integração Protheus x CiaShop MultiEstoque

Características do Requisito

Linha de Produto:

Protheus - CiaShop.

Segmento:

Varejo.

Módulo:

SigaLoja.

Rotina:

Rotina

Nome Técnico

Identificação de Lojas LOJA080

Cadastro de Filiais e Armazéns.

LOJA900I

Estoque/Preço.

LOJA900C

Rotina(s) envolvida(s)

Nome Técnico

 ProdutosLOJA900A 
PedidosLOJA901A
Monitor de Serviços E-commerceLOJA906

Cadastros Iniciais:

Identificacao de Lojas - Dados do acesso CiaShop (Token e Locais de Estoque) tabela SLJ- Identificacao de Lojas               

Requisito (ISSUE): MVAR-1062

País(es):

Brasil.

Banco(s) de Dados:

todos

Tabelas Utilizadas:

SLJ/MGU/MGR

Sistema(s) Operacional(is):

Windows/Linux.

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/public/PROT/DT_Integracao_Ecommerce_Ciashop  e também do cadastro de Token, conforme o Documento Técnico: http://tdn.totvs.com/display/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN, além da versão do binário ser igual ou superior à 7.00.131227A-20161110

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

 

 

Atualizações no Dicionário de Dados

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

 Tabela MGR - EC CiaShop Log Sincr Estoque

Alias

MGR

X2_UNICO

MGR_FILIAL+MGR_SEQ+MGR_PRODUT+MGR_ARMECO

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

Tabela MGR - EC CiaShop Log Sincr Estoque

Campo

MGR_VLRPRO

Tipo

N

Tamanho

9

Decimal

2

Formato

@E 999,999.99

Título

Valor Promoc

Descrição

Valor Promocional

Nível

0

Usado

Sim

Obrigatório

Não

Browse

Nãp

Propriedade

 Alterar

Help

Informar o preço promocional.

  

Campo

MGR_PROINI

Tipo

D

Tamanho

8

Título

Inic Promoca

Descrição

Início da Promoção

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informar data inicial do preço promocional

Campo

MGR_PROFIN

Tipo

D

Tamanho

8

Título

Final Promo

Descrição

Final da Promoção

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informar data final do preço promocional

Campo

MGR_FILARM  

Tipo

C

Tamanho

8

Formato

@!

Título

Fil Armz    

Descrição

Filial do Armazém                     

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informar filial do armazém

 Grupo de Campos 033

Campo

 MGR_ARMAZE  

Tipo

C

Tamanho

2

Formato

@!

Título

 Cód Armz    

Descrição

 Código do Armazém                    

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informar código do armazém

 Grupo de Campos 024

Campo

 MGR_ARMECO  

Tipo

C

Tamanho

10*

Formato

@!

Título

 Armazém EC    

Descrição

 Armazém e-commerce                     

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informar o código do armazém e-commerce

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

  • Tabela MGU - Log Sincr Pedidos

Campo

 MGU_FILPED 

Tipo

C

Tamanho

8

Formato

@!

Título

Fil Pec EC    

Descrição

Filial do Pedido e-comm                     

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Alterar

Help

Informa a filial do Pedido e-commerce. Caso seja a filial corrente e/ou tenha varias filiais para o pedido, o conteúdo será em branco

 Grupo de Campos 033

 

  • Tabela SLJ - Identificação de Lojas

Campo

LJ_ECFLAG   

Tipo

C

Tamanho

1

Decimal

0

Formato

@!

Título

e-commerce     

Descrição

e-commerce Status

Usado

Sim

Obrigatório

Não

Browse

Não

Opções

 1=Ativo; 2=Inativo

When

 SuperGetMv("MV_LJECOMO",,.F.)

Contexto

 Real
 Propriedade Alterar

Help

Informa se o cadastro de Filiais e locais de estoque serão integrados para o e-commerce

Campo

LJ_ECDTEX     

Tipo

C

Tamanho

8

Título

Data Exp     

Descrição

Data de Exportação                              

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Visualizar

Help

Data de exportação do registro


Campo

 LJ_ECIDFIL     

Tipo

N

Tamanho

5

 Formato 99999

Título

Cod Fil EC    

Descrição

Cod Filial e-commerce                             

Usado

Sim

Obrigatório

Não

Browse

Não

Propriedade

 Visualizar

Help

 

Informa o código da filial para o e -commerce

 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:

Campo

 LJ_ECFLAG      

Sequência

001

 Contr. Domínio LJ_LOCAL

Tipo

Primário

Regra

 SuperGetMv("MV_LJECOMG",, "")                          

Proprietário

Sim

Condição

LJ080ECLOC()

 

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:

Cód FilialLocalArmazéns enviados para o e-commerce
"D MG 01 ""02,03" "D_MG_01_02", "D_MG_01_03"
"010102"02,03"01010202", "01010203"

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:

 Código Armazém 

recebido do e-commerce

Cód Filial recebido do e-commerce e

para qual será realizada o processamento da venda

Local de estoque considerado

nos itens da venda

 "D_MG_01_02""D MG 01 ""02"
 "01010203""010102""03"

 

 

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:

ParâmetroTabela associadaCompartilhamento TabelaCompartilhamento do Parâmetro
MV_LJECOMNSA6ExclusivoExclusivo
MV_LJECOMUSA6ExclusivoExclusivo
 MV_LJECOMH------ ------ Compartilhado
 MV_LJECOMA SA3 Compartilhado Compartilhado

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