Histórico da Página
Aviso |
---|
As configurações desse documento foram homologadas somente para o ambiente CiaShop, não foi homologada para plataforma VTEX. |
Integração e-Commerce CiaShop
MV_EJECDESLinha de Produto: | Microsiga Protheus | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmento: | Varejo | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Módulo: | Controle de Lojas/Faturamento | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Parâmetro(s): | MV_LJECOM0 MV_LJECOM2 MV_LJECOM5 MV_LJECOM6 MV_LJECOM7 MV_LJECOM8 MV_LJECOM9 MV_LJECOMA MV_LJECOMB MV_LJECOMM MV_LJECOMN MV_LJECOMG MV_LJECOMH MV_LJECOMI MV_LJECOMK MV_LJECOML MV_LJECOMO MV_LJECOMQ MV_LJECOMS MV_LJECOMR MV_LJECOMU MV_LJECOMU MV_LJECOMW MV_LJECMM1 MV_LJECMM2 MV_LJECLPE MV_LJIPENP MV_LJATIPI MV_LJDTIPI MV_LJCNDA MV_VALCNPJ MV_VALCPF MV_LJECNDI | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Ponto de Entrada: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Chamados Relacionados | TUSCZS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Requisito (ISSUE): | PCREQ-3848 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Banco(s) de Dados: | Todos | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tabelas Utilizadas: | ACU - Categoria De Produtos ACV - Categoria X Grupo Ou Produto DA0 - Tabela De Precos DA1 - Itens Da Tabela De Precos MGM - Ec Ciashop Result Sincronizaca MGN - Ec Ciashop Log Sincr Produtos MGO - Ec Ciashop Log Sincr Categoria MGP - Ec Ciashop Log Sincr Cat X Prd MGQ - Ec Ciashop Log Sincr Caracteri MGR - Ec Ciashop Log Sincr Estoque MGS - Ec Ciashop Log Sincr Comprador MGT - Ec Ciashop Log Sincr Stat Ped MGU - Ec Ciashop Log Sincr Pedidos SA1 - Clientes SA4 - Transportadoras SAE – Administração Financeira SB0 - Dados Adicionais - Loja SB1 - Descricao Generica Do Produto SB2 - Saldos Fisico E Financeiro SB5 - Dados Adicionais Do Produto SC5 - Pedidos De Venda SC6 - Itens Dos Pedidos De Venda SC9 - Pedidos Liberados DA0 - Tabela de Preços DA1 -Itens da Tabela de Preços SA1 - Clientes SA4 - Transportadoras SAE – Administradoras Financeiras SC5 - Pedidos de Venda SC6 - Itens do Pedido de Vendas SC9 - Pedidos Liberados SLQ - Orçamento SLR – Itens do Orçamento SL1 - Orçamento SL2 – Itens do Orçamento SL4 - Condição Negociada SE1 – Contas a Receber SE5 - Movimentação Bancária SF2 – Cabeçalho das NF de Saída | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sistema(s) Operacional(is): | Todos | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Versões/Release: | 12.1.7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Versão Corrigida: | 12.1.11 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Versão Expedida: | 12.1.7 |
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.
...
Fluxos Integração E-Commerce CiaShop X Protheus® Controle de LojasLojas
Venda
Cancelamento
Devolução
...
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,
- 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.
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).
...
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):
...
- 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 - informar a profundidade (em metros).
Observação: ao informar no campo B5_ECFLAG = "2", os campos: B5_ECDESCR, B5_PESO, B5_ECPROFU, B5_ECLARGU, e B5_ECCOMP não são validados porém são enviados ao Manager, caso não seja informado algum campo será enviado valores padrões.
- Cadastro de Transportadoras (MATA050):
...
Valor de Venda Produto (e-commerce) | Frete | Alíquota do IPI | Base do IPI | Valor do IPI | Valor de Venda Produto (NF de Saída) |
85,00 | 10,00 | 10% | 86,36 | 8,64 | 95,00 |
Importante: A integração e-commerce somente realiza o cálculo reverso do imposto IPI.
Ao realizar o cálculo reverso do IPI, alguns valores na planilha financeira do Pedido de Vendas no Protheus, podem estar divergentes com o valor final do faturamento. Possíveis diferenças a mais ou menos são lançadas respectivamente como desconto ou frete de acordo com a parametrização dos seguintes parâmetros: MV_LJATIPI e MV_LJDTIPI.
Neste cenário o valor da venda gerada pelo e-commerce e a Nota Fiscal de Saída gerada pelo ERP Protheus® Protheus são iguais.
Fluxograma do Processo:
...
Logo abaixo, em Anexo II, segue detalhes sobre os itens validados no validador de cadastrosos itens validados no validador de cadastros.
Aviso | ||
---|---|---|
| ||
Nem todas as funcionalidades disponíveis na plataforma CiaShop são compatíveis com a integração Protheus, antes de habilitar verifique se a funcionalidade está prevista nessa documentação. Exemplo: Não existe integração de Brinde. |
Atualizações do Dicionário de Dados
...
Nome da Variável | MV_LJECMM1 |
Tipo | Caractere |
Descrição | Seleção armazém, onde 0 - Cad Produto, 1 - Param MV_LJECOMG, 2 - Saldo descrescente, 3 - Saldo crescente |
Valor Padrão | 0 |
Nome da Variável | MV_LJECMM2 |
Tipo | Caractere |
Descrição | Tipo de Operação de Revenda para pessoa jurídica. |
Valor Padrão |
...
Nome da Variável | MV_LJATIPI |
Tipo | Lógico |
Descrição | Define se a diferença do IPI embutido pelo calculado deverá ser lançado como acréscimo no total da NF. |
Valor Padrão | .F. |
...
Nome da Variável | MV_LJECDES |
Tipo | Caracter |
Descrição | Envia a descrição dos campos B5_ECCARAC,B5_ECAPRES,B5_ECBENFI e B5_ECINDIC, invés de fixo Característica/Apresentação/Benefícios/Indicação 1-Sim,2-Não |
Valor Padrão | 2 |
Procedimento para Configuração
...
Nome da Variável | MV_LJECOMH |
Tipo | Caracter |
Descrição | Usuário WebService CiaShop |
Cont. Por | -Informar o nome usuário do Webservice CiaShop -CiaShop |
Nome da Variável | MV_LJECOMI |
Tipo | Caracter |
Descrição | Senha WebService CiaShop |
Cont. Por. | Informar a senha do WebService Ciashop |
...
Nome da Variável | MV_LJECOMR |
Tipo | Caractere |
Descrição | Código da TES para Itens do Pedido de Venda/Orçamento. Se iniciado com & o conteúdo será macroexecutado. |
Cont. Por. | Código da TES - tabela SF4 ou expressão que retorne este valor |
Importante:
Caso este parâmetro estiver/retornar conteúdo vazio, será considerado o método antigo de busca da TES (Cadastro de TES Inteligente). A TES, associada os itens vendidos, NÃO devem gerar financeiro, para não gerar duplicidade de operação financeira.
...
Nome da Variável | MV_LJECOM8 |
Tipo | Caractere |
Descrição | Cod. Condição de Pagto CD. |
Cont. Por. | Informar o código constante no cadastro de Condições SE4 que será utilizado na gravação da condição do orçamento e Pedido. |
Importante:
As condições de pagamento cadastradas nestes parâmetros serão utilizadas para a geração do Pedido de Venda, no entanto, a quantidade de parcelas é definido na venda e-commerce.
...
Nome da Variável | MV_LJECOMU |
Tipo | Caracter |
Descrição | UserID do Usuário do eCommerce. |
Cont. Por. | Informar o código do usuário, associado a usuário caixa. |
Importante:
Este usuário deve estar associado a um caixa no Controle de Lojas com as permissões de geração de orçamento (não fiscal, não tef) e cancelamento de orçamento.
...
Nome da Variável | MV_LJECOM9 |
Tipo | Caractere |
Descrição | Tipo Frete (C/F) - CIF ou FOB. |
Cont. Por. | F |
Importante:
Informar o valor F (Frete FOB), para que os valores de frete sejam considerados na rotina de Devolução (LOJA720).
...
Os parâmetros a seguir devem ser configurados, se o e-commerce realizar a venda de produtos com IPI tributado na Nota Fiscal:
Nome da Variável | MV_LJIPENP |
Tipo | Lógico |
Descrição | Define se valor IPI devera ser abatido no valor de venda do produto.. |
Cont. Por | .T. |
...
Os parâmetros a seguir indicam a forma de seleção do armazém para o pedido de venda:
Nome da Variável | MV_LJECMM1 |
Tipo | Caractere |
Descrição | Seleção armazém, onde 0 - Cad Produto, 1 - Param MV_LJECOMG, 2 - Saldo descrescente, 3 - Saldo crescente |
Cont Por | Informar 0 ou 1 ou 2 ou 3 conforme a necessidade |
...
O parâmetro a seguir deve ser configurado, se o e-commerce realizar a reserva de estoque:
Nome da Variável | MV_LJECOM0 |
Tipo | Lógico |
Descrição | Realiza reserva e-commerce? Este parâmetro funciona caso o parâmeto MV_RESAUT esteja desabilitado. |
Cont. p | .T. |
Os Os parâmetros a seguir devem ser configurados caso deseje utilizar TES Inteligente para operações distintas de venda Pessoa Física e Jurídica e o conteúdo desses parâmetros devem existir na tabela DJ - Tipo de Operação
...
Nome da Variável | MV_LJECNDI |
Tipo | Lógico |
Descrição | E-Commerce desconto item |
Valor Padrão | .T. |
CONFIGURAÇÃO DE MENUS
No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu SIGALOJA, conforme instruções a seguir:
Menu
Atualizações
Submenu
e-commerce
Nome da Rotina
Monitor Serv. CiaShop
Programa
LOJA906
Módulo
Sigaloja
Tipo
Função Protheus
...
Menu
Atualizações
Submenu
e-commerce
Nome da Rotina
Rastreio de Pedido
Programa
LOJA900k
Módulo
Sigaloja
Tipo
Função Protheus
...
Procedimento para Utilização
Pré-Requisitos:
- Ative os Serviços de Integração E-commerce CiaShop, de acordo com as instruções mencionadas abaixo:
...
- LOJA900 - Departamentos - Tabelas envolvidas: ACU
- LOJA900A - Produtos - Tabelas envolvidas: SB5, SB1, SB0, ACV, SB4, DA0, DA1, SLJ
Importante: Neste serviço são executados os seguintes serviços:
LOJA900, LOJA900B, LOJA900D
- LOJA900B - Departamentos X Produtos - Tabelas envolvidas: ACV, SB5, ACU, SB1
- LOJA900C - Estoque - Tabelas envolvidas: SB5, SB0, SB1, SB2, DA0, DA1, SLJ
- LOJA900D - Descrição de Produtos - Tabelas envolvidas: SB5
- LOJA900E - Status de Pedidos - Tabelas envolvidas: SC5 (sem filtro por filial), SF2, SLJ
Lista de códigos de status enviados para o e-commerce:
- 05-Pedido em análise (válido somente para cancelamento de baixa de título financiado).
- 10-Pagamento confirmado preparando envio
- 15- Pedido em embalado (válido somente para exclusão de documento de saída)
- 30 - Pedido enviado.
- 90- Pedido Cancelado.
- 91 - Pedido Devolvido.
Esta rotina realiza a chamada na rotina LOJA901I que recebe e atualiza o status do Pedido Protheus e tem as principais tabelas envolvidas: SC5, SC6, SC9, SL1, SL2, SL4, SE1, SE2, MH6
- LOJA900F – Tabela de Preços - Tabelas envolvidas: SB5, SB1, SB0, DA0, DA1
- LOJA900I - Cadastro de Filiais e Armazéns - Tabelas envolvidas: SLJ, NNR, SM0
- LOJA901 - Compradores - Principal Tabela envolvida: SA1
- LOJA901A - Pedido - Principais Tabelas envolvidas: SC5, SC6, SC9, SC0, NNR, SB2, SL1, SL2, SL4, SE1, SE2, SA1, SAE, SE4, SF4, SFM, SB1, SA6, SLF, SA4, MEP, MH6
Ocorrências que poderão retornar no serviço de Integração de Pedidos:
- 1- Cliente não encontrado;
- 2 - CPF do pedido diferente do CPF do cadastro do cliente;
- 3- Documento inválido;
- 4- Transportadora não cadastrada;
- 5- Método de pagamento não cadastrado;
- 6- Produto não cadastrado;
- 7- TES não informada no cadastro do produto;
- 8- Vendedor (Promoter) não cadastrado
- 9- Forma de pagamento inválida
- 10– Problema na geração do Pedido de venda
- 11- Problemas na geração do Orçamento
- 12- Problemas na geração do Título de Contas a Receber
- 13- (desuso)
- 14– Problema na geração de Endereço de Entrega do Cliente
- 15- Problema na geração de Reserva do Pedido
- 16- Não localizados pagamentos(SL4) associados ao orçamento
- 17-Problemas ao desfazer reserva pois pedido náo foi feito
Neste serviço são executados os seguintes serviços:
LOJA901 e LOJA901B - Dados Extras do Pedido
- LOJA907 – Cancelamento de Boletos - Principais Tabelas envolvidas: SC5, SC6, SC9, SL1, SL2, SL4, SE1, SE2
- LOJA907 – Cancelamento de Boletos - Principais Tabelas envolvidas: SC5, SC6, SC9, SL1, SL2, SL4, SE1, SE2
- LOJA900G - Envio de Cadastros
...
LOJA900A (LOJA900, LOJA900B, LOJA900D), LOJA900C, LOJA900F, LOJA907, LOJA900E.
- LOJA900G - Recebimento de Cadastros
Neste serviço é executado o seguinte serviço:
...
- E-commerce (B5_ECFLAG): Permite indicar se o produto é enviado para o site, caso não seja preenchido não é enviado.
- Palavra Chav (B5_ECPCHAV): Permite informarpalava-chave do produto.
- Cubagem C3 (B5_ECCUBAG): Permite informar a cubagem do produto.
- Data Lancam (B5_ECDTLAN): Permite informar a 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.
- Descr. E-com (B5_ECTITU): Permite informar a descrição da variante associada ao produto.
- 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).
- Caraterística (B5_ECCARAC): Permite informar ovalor do folder (Características) da descrição deprodutono site.
- Apresentação (B5_ECAPRES): Permite informar o valor do folder (Apresentação) da descrição de produto no site.
- Beneficio (B5_ECBENFI): Permite informar ovalor do folder (Benefício) da descrição de Produto no site.
- Indicação (B5_ECINDIC): Permite informar o valor do folder (Indicação) da descrição de Produtono site Importante: As informações de Característica, Apresentação, Benefício e Indicação são enviadas no Serviço de Caracteríscas de Produtos (LOJA900CLOJA900D) e somente serão enviadas caso haja alteração entre a última informação enviada com sucesso para o site.
...
- E-commerce (B0_ECFLAG): Permite indicar se o produto é enviado para o site, caso não seja preenchido não é enviado.
- Imagem Prod (B0_ECIMGFI): Nome do arquivo de imagem do produto-filho, constante no servidor e-commerce.
- Descr. E-com (B0_ECTITU): Descrição do produto-filho.
- Pai Ant (B0_ECPAIANT): Permite enviar o XML de exclusão do relacionamento ProdutoXVariante.
- Comprimento: B0_ECCOMP: Permite informar o comprimento (em metros).
- Largura: B0_ECLARGU: Permite informar a largura (em metros).
- Profundidade: B0_ECPROFU: Permite inforrmar a profundidade (em metros).
Importante: Caso o produto não tenha saldo em estoque, ele não sera integrado para o Site.
Caso a tabela SB1 estiver compartilhada aconselhamos realizar também o compartilhamento tabela SB0.
Caso a tabela SB1 estiver compartilhada e a tabela SB0 exclusiva é necessário executar a integração da filial em que os produtos filhos foram gerados.
6. Confira os dados e Confirme.
...