Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Integração E-Commerce CiaShop

 

Produto

:

Microsiga Protheus® - Controle de Lojas – Versão 12

 

 

 

Requisito

:

PCREQ-3846

Data da publicação

:

23/07/15

País(es)

:

Brasil

Banco(s) de Dados

:

Todos

...

  • 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.


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 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.

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.

 

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

Somente o status de Pedido Enviado (30) é gerado automaticamente, os demais status (Pagamento Confirmado, Cancelado, Devolvido) devem ser alterados manualmente através do campo Status Ecom (C5_STATUS). O link de rastreio do Pedido informado no campo EC Rastr. (C5_RASTR) também deve ser preenchido manualmente.

Para as formas de pagamento, cuja a baixa do título é realizada antes da emissão da Nota (Depósito, Boleto), é necessário emitir a Nota Fiscal e depois realizar a baixa do título que foi gerado pela rotina de Emissão de Documento de Saída.



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










Fluxo da Integração E-Commerce Ciashop
Cadastros















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



Cancelamento



Devolução


Cancelamento de Boletos


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

...

Assim, como o título de Contas a Receber, a geração do títulos de Contas a Pagar referente a taxa administrativa, é realizada antes da emissão da Nota Fiscal de Venda..
Importante
A geração de Contas a Pagar, referente à taxa Administrativa, obedece ás parametrizações do Módulo Controle de Lojas. Não é necessária a ativação do Job de Integração ERP (LjGrvBatch).

  • Baixa de Títulos (FINA070)

...

  1. Criação de Índices no arquivo SIX – Índices:

    Índice

    MGM

    Ordem

    1

    Chave

    MGM_FILIAL + MGM_SERVIC + MGM_SEQ

    Descrição

    Serviço+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGM

    Ordem

    2

    Chave

    MGM_FILIAL + MGM_SEQ

    Descrição

    Sequência

    Mostra Pesq.

    Sim

    Índice

    MGN

    Ordem

    1

    Chave

    MGN_FILIAL + MGN_SEQ + MGN_CODIGO

    Descrição

    Sequência+Código

    Mostra Pesq.

    Sim

    Índice

    MGN

    Ordem

    2

    Chave

    MGN_FILIAL + MGN_CODIGO + MGN_SEQ

    Descrição

    Código+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGO

    Ordem

    1

    Chave

    MGO_FILIAL + MGO_SEQ + MGO_CODIGO

    Descrição

    Sequência+Código

    Mostra Pesq.

    Sim

    Índice

    MGO

    Ordem

    2

    Chave

    MGO_FILIAL + MGO_CODIGO + MGO_SEQ

    Descrição

    Código+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGP

    Ordem

    1

    Chave

    MGP_FILIAL + MGP_SEQ + MGP_PRODUT

    Descrição

    Sequência+Produto

    Mostra Pesq.

    Sim

    Índice

    MGP

    Ordem

    2

    Chave

    MGP_FILIAL + MGP_PRODUT + MGP_SEQ

    Descrição

    Produto+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGQ

    Ordem

    1

    Chave

    MGQ_FILIAL + MGQ_SEQ + MGQ_PRODUT

    Descrição

    Sequência+Produto

    Mostra Pesq.

    Sim

    Índice

    MGQ

    Ordem

    2

    Chave

    MGQ_FILIAL + MGQ_PRODUT + MGQ_SEQ

    Descrição

    Produto+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGR

    Ordem

    1

    Chave

    MGR_FILIAL + MGR_SEQ + MGR_PRODUT

    Descrição

    Sequência+Produto

    Mostra Pesq.

    Sim

    Índice

    MGR

    Ordem

    2

    Chave

    MGR_FILIAL + MGR_PRODUT + MGR_SEQ

    Descrição

    Produto+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGS

    Ordem

    1

    Chave

    MGS_FILIAL + MGS_SEQ + MGS_CLIENT

    Descrição

    Sequência+Cliente

    Mostra Pesq.

    Sim

    Índice

    MGS

    Ordem

    2

    Chave

    MGS_FILIAL + MGS_CLIENT + MGS_SEQ

    Descrição

    Cliente+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGT

    Ordem

    1

    Chave

    MGT_FILIAL + MGT_SEQ + MGT_PEDIDO

    Descrição

    Sequência+Pedido

    Mostra Pesq.

    Sim

    Índice

    MGT

    Ordem

    2

    Chave

    MGT_FILIAL + MGT_PEDIDO + MGT_SEQ

    Descrição

    Pedido+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGU

    Ordem

    1

    Chave

    MGU_FILIAL + MGU_SEQ + MGU_PEDECO

    Descrição

    Sequência+N.Ped.E-Comm

    Mostra Pesq.

    Sim

    Índice

    MGU

    Ordem

    2

    Chave

    MGU_FILIAL + MGU_PEDECO + MGU_SEQ

    Descrição

    N.Ped.E-Comm+Sequência

    Mostra Pesq.

    Sim

    Índice

    MGV

    Ordem

    1

    Chave

    MGV_FILIAL + MGV_METODO+STR(MGV_PARCEL)

    Descrição

    Metodo Pgto

    Mostra Pesq.

    Sim

    Índice

    MGV

    Ordem

    2

    Chave

    MGV_FILIAL + MGV_CONDPG

    Descrição

    Condição

    Mostra Pesq.

    Sim

  2. Criação de Parâmetros no arquivo SX6 – Parâmetros:

    Nome da Variável

    MV_LJECOMH

    Tipo

    Caracter

    Descrição

    Usuário WebService CiaShop

    Valor Padrão

    ECOMMERCE

    Nome da Variável

    MV_LJECOMI

    Tipo

    Caracter

    Descrição

    Senha WebService CiaShop

    Valor Padrão

    ECOMMERCE

    Nome da Variável

    MV_LJECOMK

    Tipo

    Caracter

    Descrição

    URL WebService CiaShop

    Valor Padrão

    https://www.url.com.br/url/ws/

    Nome da Variável

    MV_LJECOML

    Tipo

    Caracter

    Descrição

    Tabela de Preço Promoção

    Valor Padrão

     

    Nome da Variável

    MV_LJECOMO

    Tipo

    Logico

    Descrição

    e-commerce CiaShop

    Valor Padrão

    .F.

    Nome da Variável

    MV_LJECOMQ

    Tipo

    Caracter

    Descrição

    Tabela de Preço Padrão

    Valor Padrão

    001

     

    Procedimento para Configuração

    CONFIGURAÇÃO DE PARÂMETROS

  3. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

...


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.

Itens/Pastas

Descrição

Nome da Variável

MV_LJECOM5

Tipo

Caractere

Descrição

Prefixo do Título. Configurar com o valor EC0

Cont. Por.

EC0

...

Importante
Informar o valor F (Frete FOB), para que os valores de frete sejam considerados na rotina de Devolução (LOJA720).

CONFIGURAÇÃO DE MENUS

  1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe as novas opções de menu do 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

 

Procedimento para Utilização


Pré-Requisitos:

    • Módulo Controle de Lojas (SIGALOJA), devidamente implementado e aplicação do pacote de atualizações do requisito PCREQ-955. Implementação dos procedimentos de utilização descritos no Boletim Técnico Integração e-commerce CiaShop.

...

  • ERRO 1 - Cliente não encontrado.
  • ERRO 2 - CPF do pedido diferente do CPF do cadastro do cliente.
  • ERRO 3 - Documento inválido.
  • ERRO 4 - Transportadora não cadastrada.
  • ERRO 5 - Método de pagamento não cadastrado.
  • ERRO 6 - Produto não cadastrado.
  • ERRO 7 - TES não informada no cadastro do produto.
  • ERRO 8 - Vendedor (Promoter) não cadastrado.
  • ERRO 9 - Forma de pagamento inválida.
  • ERRO 10 – Problema na geração do Pedido de venda.
  • ERRO 11 - Problemas na geração do Orçamento.
  • ERRO 12 - Problemas na geração do Título de Contas a Receber.
  • ERRO 13 - Problemas na geração do Título de Contas a Pagar da Taxa Administrativa.

 

Informações Técnicas







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
MGV - Ec Ciashop Metodos Pagamento
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 – ADMINISTRAÇÃO FINANCEIRA
SC5 - PEDIDOS DE VENDA
SC6 - ITENS DOS PEDIDOS DE VENDA
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 NAS NF DE SAÍDA
MGT - EC CIASHOP LOG SINCR STAT PED
MGU - EC CIASHOP LOG SINCR PEDIDOS
MGV - EC CIASHOP METODOS PAGAMENTO
MGY - EC CIASHOP LOG SINC T PREC VAR

Rotinas Envolvidas

FATA140 - Categorias de Produtos
FATA150 - Amarração Cat.x prd
OMSA010 - Tabelas de Preço
MATA050 - Transportadoras
MATA089 - TES Inteligente
MATA180 – Complemento de Produtos
MATA456 - Liberação Cred/Est
MATA460 – Pedidos de Vendas
MATA460A – Documento de Saída
MATA550 - Grade de Produto
LOJA110 - Cadastro de Produtos
LOJA905 – Métodos de Pagamento CiaShop
LOJA906 – Monitor Serviços CiaShop

...