Boletim Tcnico

Integrao E-commerce CiaShop - Fase 2

Produto

Microsiga Protheus - Controle de Lojas - Verso 11

Requisito

PCREQ-3277

Data da publicao

03/03/15

Pas(es)

Brasil

Banco(s) de Dados

Todos

Importante

Esta melhoria est disponvel a partir do Release Verso 11.8.

Para viabilizar esta melhoria, necessrio que j tenha aplicado o pacote de atualizaes do Requisito PCREQ-955
e implementado os procedimentos descritos no Boletim Tcnico Integrao E-Commerce CiaShop.

Esta melhoria depende de execuo do update de base U_UPDLO150, conforme Procedimentos para Implementao.

Disponibilizada melhoria na Integrao do Microsiga Protheus com o E-commerce da CiaShop Verso RTM 3.23, para
permitir que os processos de gesto das vendas originadas do E-Commerce CiaShop sejam realizados por meio dos
processos do Mdulo Controle de Lojas (SIGALOJA).
Os processos do E-commerce CiaShop integrados com o mdulo Controle de Lojas (SIGALOJA) so:

Tabelas de Preo (OMSA010).

Administradora Financeira (MATA070).

Venda Assistida (LOJA701).

Contas a Receber da Venda (FINA040).

Contas a Pagar da Taxa Administrativa (FINA050).

Baixa de Ttulos (FINA070).

Cancelamento de NF/Orc (LOJA140).

Liberao Crd/Estoque (MATA456).

Devoluo (LOJA720).

Tabela de Preos Variante (LOJA900F).

Cancelamento de Boletos (LOJA907).

SIGALOJA Integrao E-commerce CiaShop - Fase 2

Boletim Tcnico

Diagrama de Processos da Integrao CiaShop X Protheus Controle de Lojas

Fluxo da Integrao E-Commerce Ciashop

Cadastros

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Fluxos Integrao E-Commerce CiaShop X Protheus Controle de Lojas

Venda

Cancelamento

SIGALOJA Integrao E-commerce CiaShop - Fase 2

Boletim Tcnico

Devoluo

Cancelamento de Boletos

Alterao das rotinas no Microsiga Protheus para Integrao E-commerce Ciashop:

Mtodos de Pagamento CiaShop (LOJA905)

Este cadastro tornou-se obsoleto neste requisito.

Tabelas de Preo (OMSA010)

Implementada a opo de envio de mltiplas tabelas de preo para

e-commerce CiaShop, mediante a

sinalizao do campo e-commerce (DA0_ECFLAG).

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Importante
O cadastro do cabealho, onde (so) definida(s) a(s) regra(s) de utilizao da tabela utilizada na venda,
realizada no E-Commerce CiaShop. A integrao envia os produtos associados tabela, assim como os
respectivos preos.
Utilize essa funcionalidade caso deseje ter uma tabela de preo diferenciada por regra.
Os procedimentos para o cadastro da tabela de Preo Padro e Promocional mantm-se inalterados.

Administradora Financeira (MATA070)

Obedecendo regra do Mdulo Controle de Lojas, a gerao do ttulos de Contas a Receber referente
venda e Contas a Pagar - referente a Taxa Administrativa, passa a ser realizada aps a gerao do
oramento e considera as informaes contidas neste castrastro, em especial os seguintes campos:
Cod. e-comme (AE_ECCODIG) Este campo realiza o relacionamento entre o Mtodo de Pagamento do ecommerce para a localizao da Administradora Financeira.
Tipo Adminis (AE_TIPO) Forma de pagamento (SX5). As formas vlidas para a Integrao E-Commerce
CiaShop so:

FI Financeira: Nesta forma de pagamento, gerado um Pedido de Venda com bloqueio de crdito,
liberado mediante o pagamento do ttulo.

CC/CD- Carto de Crdito/Dbito Nesta forma de pagamento gerado um Pedido de Venda sem
bloqueio de Crdito. Nesta forma de pagamento possvel gerar um ttulo de Contas a Pagar para a
Administradora Financeira.

Tx. Cobrana (AE_TAXA ) - Informe o valor da Taxa Administrativa, que poder ser informada tambm
por meio do Grid de Taxas Administrativas para os tipos de Administradora de Carto - Tipo
CC/CD.

Pedidos (LOJA900A)
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

Lpis

Computador (kit)
Monitor

Mouse

SIGALOJA Integrao E-commerce CiaShop - Fase 2

Boletim Tcnico

Teclado

CPU

A rotina de Pedidos (LOJA900A) identifica o produto do tipo Kit e realiza o lanamento dos itens que o compem.
Importante
A montagem do produto tipo Kit deve ser realizada no E-commerce Ciashop, sendo que os produtos que o
compem devem ser enviados para o site anteriormente por meio dos servios de Integrao.

Venda Assistida (LOJA701)

Implementada a gerao do oramento associado venda e-commerce, de modo a oferecer suporte aos
processos do mdulo Controle de Loja, e facilitar a localizao dos componentes associados venda ecommerce, atravs dos campos:

Ped Cli Ecom (L1_PEDEC) Nmero do Pedido no e-commerce.

Num. Pedido (L1_PEDRES) Nmero do Pedido no ERP.

Srie (L1_SERPED) e Nota Fiscal (L1_DOCPED) - Prefixo e Srie dos Ttulos Gerados (Contas a
Receber e Contas a Pagar).

Importante
A gerao do cdigo da TES do produto, tanto para o Oramento(SL1) quanto para o Pedido de Venda
(SC5) sofreu alteraes:
a) Caso o parmetro MV_LJECOMS esteja habilitado, ser considerado prioritariamente o contedo do
novo parmetro MV_LJECOMR (cdigo da TES para gerao dos itens vendidos no site) que poder ser
macro executado, caso o mesmo possua o prefixo &.
b) No caso do parmetro MV_LJECOMR retornar em branco ou o parmetro MV_LJECOMS estiver
desabilitado, ser utilizada a funo MaTESInt .
c) Caso a MaTESInt retorne o valor em branco, ser considerado o contedo do campo TES Padrao
(B1_TS) e, caso este esteja em branco, o parmetro MV_TESSAI.

Contas a Receber da Venda (FINA040)

Implementada a gerao do ttulos de Contas a Receber antes da emisso da Nota Fiscal de Venda, referente
venda e-commerce.
Importante
Para que no haja duplicidade de movimentao financeira, a TES associada venda do item, no deve gerar
financeiro.

Contas a Pagar da Taxa Administrativa (FINA050)

Assim, como o ttulo de Contas a Receber, a gerao do ttulos de Contas a Pagar referente a taxa
administrativa, realizada antes da emisso da Nota Fiscal de Venda..

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Importante
A gerao de Contas a Pagar, referente taxa Administrativa, obedece s parametrizaes do Mdulo Controle
de Lojas. No necessria a ativao do Job de Integrao ERP (LjGrvBatch).

Baixa de Ttulos (FINA070)

Implementada a liberao automtica de Crdito/Estoque (MATA456) do Pedido, mediante o processamento da
baixa do ttulo associado ao oramento do e-commerce CiaShop com a forma de pagamento - Campo
FormPgto (L1_FORMPG) - tipo FI Financiado. O status do oramento enviado como Pagamento
Confirmado (10) atravs do servio Status de Pedido (LOJA900E).

Cancelamento de NF/Orc (LOJA140)

Implementado o cancelamento de Oramentos associado venda no e-commerce CiaShop. O status do
oramento enviado como Cancelado (90) atravs do servio Status de Pedido (LOJA900E).

Liberao Crd/Estoque (MATA456)

Implementado o bloqueio da liberao manual de Crdito/Estoque, caso o pedido esteja associado um
oramento do e-commerce CiaShop de uma venda com a forma de tipo FI Financiado.

Documento de sada (MATA461), - Atualiza o nmero do ttulo gerado na tabela de Notas Fiscais de Sada
Campos Nmero F2_DUPL e o prefixo F2_PREFIXO, alm de gravar no oramento associado ao Pedido o
Nmero da Nota Fiscal (L1_DOC) e srie da Nota Fiscal (L1_SERIE).

Devoluo (LOJA720)
Implementado a Devoluo de Vendas, realizadas no e-commerce CiaShop. O status do oramento enviado
como Devolvido (91) atravs do servio Status de Pedido (LOJA900E).
Importante
O controle dos Crditos gerados pela operao de Devoluo no esto integrados. Este processo deve ser
gerenciado nos dois ambientes (ERP e e-commerce).

Disponibilizao das novas rotinas no Microsiga Protheus para Integrao com E-Commerce CiaShop:

Tabela de Preo Variante (LOJA900F)

Implementado o servio Tabela de Preo Variante (LOJA900F) que realiza o envio das tabelas de preos
sinalizadas para Integrao e-commerce Ciashop.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

Boletim Tcnico

Importante

Neste servio, so enviados os produtos que compem a Tabela de Preo, sendo que o cadastro do
cabealho, deve ser feito na plataforma, antes da execuo da integrao.

Cancelamento de Boletos (LOJA907)

Implementado o Cancelamento de Oramentos do tipo FI Financiado, que esto vencidos e so referentes
vendas e-commerce CiaShop. Assim como a rotina Cancelamento de NF/Orc (LOJA140), o status do
oramento enviado como Cancelado (90) atravs do servio Status de Pedido (LOJA900E).

Procedimento para Implementao

Para viabilizar essa melhoria, necessrio aplicar o pacote de atualizaes deste requisito.
Importante
Antes de executar o compatibilizador U_UPDLO150 imprescindvel:
a)

Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio
\PROTHEUS11_DATA\DATA) e dos dicionrios de dados SXs (diretrio ou \PROTHEUS11_DATA\SYSTEM).

b)

Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser
alterados conforme o produto instalado na empresa.

c)

Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.

d)

Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o
compatibilizador, certifique-se de que esto 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 no estejam identificados pelo nickname.

e)

O compatibilizador deve ser executado com a Integridade Referencial desativada*.

Ateno
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco
de Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas
no banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opo

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as empresas e
filiais cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso, E SOMENTE
NESTE, no necessrio qualquer outro procedimento de ativao ou desativao de integridade,
basta finalizar a verificao e aplicar normalmente o compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem na
janela Verificao de relacionamento entre tabelas. Confirme a mensagem para que a verificao
seja concluda, ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so
relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente,
a(s) que possui(em) integridade est(aro) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is)
possui(em) a integridade ativada e reserve esta anotao para posterior consulta na reativao (ou
ainda, contate nosso Help Desk Framework para informaes quanto a um arquivo que contm essa
informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio desativar
tal integridade, selecionando a opo Integridade/ Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver
sido desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em mos as
informaes da(s) empresa(s) e/ou filial(is) que possua(m) ativao da integridade, selecione-a(s)
novamente e confirme a ativao.
Contate o Help Desk Framework EM CASO DE DVIDAS!

1.

Em ByYou Smart Client , digite U_UPDLO150 no campo Programa Inicial.

2.

Clique em OK para continuar.

3.

Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser
modificado

4.

Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em
modo exclusivo.

5.

Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos
arquivos.
apresentada uma mensagem explicativa na tela.

6.

Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes
processadas. Nesse log de atualizao so apresentados somente os campos atualizados pelo programa. O
compatibilizador cria os campos que ainda no existem no dicionrio de dados.

7.

Clique em Gravar para salvar o histrico (log) apresentado.

8.

Clique em OK para encerrar o processamento.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

Boletim Tcnico

Atualizaes do compatibilizador
1. Criao de Tabela no arquivo SX2 Tabelas:
Chave
MGY

Nome

Modo

EC CIASHOP LOG SINC T PREC VAR

PYME

Compartilhado

2. Criao de Campos no arquivo SX3 Campos:

a. Tabela MGY EC CIASHOP LOG SINC T PREC VAR
1. Campo

MGY_FILIAL

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

Filial

Descrio

Filial do Sistema

Usado

No

Obrigatrio

No

Browse

No

Grupo de Campos

033 - Tamanho da Filial

Help de Campo

Informe a filial do Sistema

Campo

MGY_SEQ

Tipo

Caracter

Tamanho

10

Decimal

Formato

@!

Ttulo

Sequncia

Descrio

Sequncia

Usado

Sim

Obrigatrio

No

Browse

No

10

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe a sequncia de execuo do Job

Campo

MGY_CODTAB

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

Tab Preo

Descrio

Tabela de Preo

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe o cdigo da tabela de Preo do

ERP

Campo

MGY_PRODUT

Tipo

Caracter

Tamanho

15

Decimal

Formato

@!

Ttulo

Produto

Descrio

Cdigo do Produto

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Grupo de Campos

030 - Tamanho do Produto

SIGALOJA Integrao E-commerce CiaShop - Fase 2

11

Boletim Tcnico

Help de Campo

Informe o cdigo da Variante

Campo

MGY_ PRCVEN

Tipo

Numrico

Tamanho

Decimal

Formato

@E 999,999.99

Ttulo

Preo

Descrio

Preo de Lista

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe o Preo de Lista

Campo

MGY_ ITEM

Tipo

Caractere

Tamanho

Formato

@!

Ttulo

Item

Descrio

Item da tabela de preo

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe o cdigo do item da tabela de preo

12

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Campo

MGY_ECFLAG

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

E-Commerce

Descrio

Ativo e-commerce?

Lista de Opes

1=Ativo;2=Inativo

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe se a operao para ativar ou

inativar o preo

b. Tabela DA0 Tabela de Preos

Campo

DA0_ECFLAG

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

E-Commerce

Descrio

Ativo e-commerce?

Modo de Edio

SuperGetMV("MV_LJECOMM",,.F.)

Lista de Opes

1=Ativo;2=Inativo

Usado

Sim

Obrigatrio

No

Browse

Sim

Contexto

Real

Propriedade

Alterar

Help de Campo

Se preenchida, indica se esta tabela ser enviada para o e-commerce

SIGALOJA Integrao E-commerce CiaShop - Fase 2

13

Boletim Tcnico

Campo

DA0_ECDTEX

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

Dt Exp

Descrio

Data da Exportao

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Indica se o registro j foi exportado para o e-commerce.

Campo

DA0_ECSEQ

Tipo

Caracter

Tamanho

15

Decimal

Formato

@!

Ttulo

Seq. Exp

Descrio

Seq.Exportac Intermed

Usado

Sim

Obrigatrio

No

Browse

No

Contexto

Real

Propriedade

Visualizar

Help de Campo

Informe a sequncia do exportao

14

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

c. Tabela DA1 Itens da Tabela de Preos

Campo

DA1_ECDTEX

Tipo

Caracter

Tamanho

Decimal

Formato

@!

Ttulo

Dt Exp

Descrio

Data da Exportao

Usado

Sim

Obrigatrio

No

Browse

Sim

Contexto

Real

Propriedade

Visualizar

Help de Campo

Data da exportao do registro para o site

Campo

DA1_ECSEQ

Tipo

Caracter

Tamanho

15

Decimal

Formato

@!

Ttulo

Seq. Exp

Descrio

Seq.Exportac Intermed

Usado

Sim

Obrigatrio

No

Browse

Sim

Contexto

Real

Propriedade

Visualizar

Help de Campo

Sequncia de Exportao na Tabela

Intermediria

SIGALOJA Integrao E-commerce CiaShop - Fase 2

15

Boletim Tcnico

3. Criao de Parmetros no arquivo SX6 Parmetros:

Nome da Varivel

MV_LJECOMS

Tipo

Lgico

Descrio

Habilita a gerao do Ttulo de Contas a Receber.

Valor Padro

.F.

Nome da Varivel

MV_LJECOMR

Tipo

Caractere

Descrio

Cdigo da TES para Itens do Pedido de Venda/Oramento. Se iniciado

com & o contedo ser macroexecutado.

Valor Padro

501

Nome da Varivel

MV_LJECOMW

Tipo

Numrico

Descrio

Nmero de Dias para seleo da data inicial dos oramentos vencidos.

Valor Padro

30

Procedimento para Configurao

CONFIGURAO DE PARMETROS
1. No Configurador (SIGACFG) acesse Ambientes/Cadastros/Parmetros (CFGX017). Configure o(s)
parmetro(s) a seguir:

Itens/Pastas

Descrio

Nome da Varivel

MV_LJCNDA

Tipo

Lgico

Descrio

Habilita a integrao entre os mdulos SIGALOJA e FRONTLOJA com

o cenrio de vendas, utilizando as regras de desconto, bnus e tabela
de preos.

Cont. Por.

.T.

16

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOMS

Tipo

Lgico

Descrio

Habilita a gerao do Ttulo de Contas a Receber.

Cont. Por.

.T.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOMR

Tipo

Caractere

Descrio

Cdigo da TES para Itens do Pedido de Venda/Oramento. Se iniciado

com & o contedo ser macroexecutado.

Cont. Por.

Cdigo da TES - tabela SF4 ou expresso que retorne este valor

Importante
Caso este parmetro estiver/retornar contedo vazio, ser considerado o mtodo antigo de busca da TES
(Cadastro de TES Inteligente). A TES, associada os itens vendidos, NO devem gerar financeiro, para no gerar
duplicidade de operao financeira.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOMB

Tipo

Numrico

Descrio

Nmero de dias para validade do Oramento do Carto.

Cont. Por.

Informar o nmero de dias de validade do Oramento em carto.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM2

Tipo

Numrico

Descrio

Nmero de dias para validade do Oramento do Boleto (FI).

Cont. Por.

Informar o nmero de dias de validade do Oramento em Boleto.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

17

Boletim Tcnico

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM6

Tipo

Caractere

Descrio

Cod. Condio de Pagto FI (Boleto).

Cont. Por.

Informar o cdigo constante no cadastro de Condies SE4 que ser

utilizado na gravao da condio do oramento e Pedido.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM7

Tipo

Caractere

Descrio

Cod. Condio de Pagto CC.

Cont. Por.

Informar o cdigo constante no cadastro de Condies SE4 que ser

utilizado na gravao da condio do oramento e Pedido.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM8

Tipo

Caractere

Descrio

Cod. Condio de Pagto CD.

Cont. Por.

Informar o cdigo constante no cadastro de Condies SE4 que ser

utilizado na gravao da condio do oramento e Pedido.

Importante
As condies de pagamento cadastradas nestes parmetros sero utilizadas para a gerao do Pedido de Venda, no
entanto, a quantidade de parcelas definido na venda e-commerce.
Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOMN

Tipo

Caractere

Descrio

Nome do Usurio do eCommerce. Configurar com o valor or

ECOMMERCE.

Cont. Por.

Informar o nome do usurio, associado a um caixa.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOMU

Tipo

Caracter

18

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Descrio

UserID do Usurio do eCommerce.

Cont. Por.

Informar o cdigo do usurio, associado a usurio caixa.

Importante
Este usurio deve estar associado a um caixa no Controle de Lojas com as permisses de gerao de oramento (no
fiscal, no tef) e cancelamento de oramento.

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM5

Tipo

Caractere

Descrio

Prefixo do Titulo. Configurar com o valor EC0

Cont. Por.

EC0

Itens/Pastas

Descrio

Nome da Varivel

MV_LJECOM9

Tipo

Caractere

Descrio

Tipo Frete (C/F) - CIF ou FOB.

Cont. Por.

Importante
Informar o valor F (Frete FOB), para que os valores de frete sejam considerados na rotina de Devoluo

(LOJA720).

CONFIGURAO DE MENUS
2. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Retire a opo de menu do
SIGALOJA, conforme instrues a seguir:
Menu

Atualizaes

Submenu

E-commerce

Nome da Rotina

Mtodos Pgto CiaShop

Programa

LOJA905

Mdulo

SIGALOJA

Tipo

Funo Protheus

SIGALOJA Integrao E-commerce CiaShop - Fase 2

19

Boletim Tcnico

Procedimento para Utilizao

Pr-Requisitos:
1. Mdulo Controle de Lojas (SIGALOJA), devidamente implementado e aplicao do pacote de atualizaes do
requisito PCREQ-955. Implementao dos procedimentos de utilizao descritos no Boletim Tcnico Integrao ecommerce CiaShop.
2. Ativao dos Novos Servios de Integrao e-commerce CiaShop:
2.1 No Controle de Lojas (SIGALOJA), acesse Atualizaes / E-Commerce / Monitor Serv. CiaShop (LOJA906)
e aguarde a rotina inserir o novos agendamentos dos servios de integrao e-commerce: Cancelamento de
Boletos (LOJA907) e Tabela de Preos Variante (LOJA900F).
2.2 No Configurador (SIGACFG), acesse Schedule/Schedule/Schedule/Agendamentos (CFGA110). Posicione o
cursor sobre o agendamento e clique em Editar
2.3 Edite os dados referente execuo da rotina: Data/Hora, Empresa, Habilitada e informaes de recorrncia.
2.4 Confira os dados e confirme.
2.5 Ative

os

servios

do

Scheduler,

conforme

instrues

TDN

(http://tdn.totvs.com.br/display/framework/schedule+Protheus)
3. Cadastro de Administradora Financeira Vinculada ao Mtodo de Pagamento:
3.1 No

Controle

de

Lojas

(SIGALOJA),

acesse

cadastro

de

Administradora

Financeira

Atualizaes/Cadastro/Adm. Financeira (MATA070) e realize o cadastro de uma administradora Financeira

vinculada ao mtodo de pagamento, informando os seguintes campos:
Cod. e-comme (AE_ECCODIG): por meio deste campo realizado o relacionamento entre o mtodo de
Pagamento do e-commerce e a localizao da Administradora Financeira.
Tipo Adminis (AE_TIPO) :Informe a Forma de pagamento (SX5). As formas vlidas para a integrao ecommerce CiaShop so:
FI Financeira: Nesta forma de pagamento, gerado um Pedido de Venda com bloqueio de crdito que
liberado mediante o pagamento do ttulo.

CC/CD- Carto de Crdito/Dbito: Nesta forma de pagamento gerado um Pedido de Venda sem
bloqueio de Crdito. Nesta forma de pagamento possvel gerar um ttulo de Contas a Pagar para a
Administradora Financeira.

Tx. Cobrana (AE_TAXA ): Informe o valor da Taxa Administrativa, que poder ser informada tambm
atravs do Grid de Taxas Administrativas para as formas de pagamento CC/CD.

20

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Importante
O cadastro de Mtodos de Pagamento CiaShop (LOJA905) tornou-se obsoleto nesta funcionalidade.
Cadastro de Tabelas de Preo
Pr-Requisito
Configure o Cabealho da Tabela de Preo cadastrada no e-commerce CiaShop:
1. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Cenrio de Vendas / Tabelas de Preo (OMSA010)
e realize o cadastro da tabela de preo, preenchendo os seguintes campos:

Cd Tabela (DA0_CODTAB) - informe o contedo do campo Cdigo ERP cadastrado no e-commerce

e-commerce (DA0_ECFLAG) - informe se a tabela est ativa ou inativa

2. Preencha os demais campos do cabealho

3. No grid preencha os seguintes campos:

Cod. Produto (DA1_CODPRO) Informe o cdigo do Produto e-commece.

Preco Venda (DA1_PRCVEN) - Informe o Preo de Venda.

Vigncia (DA1_DATVIG) Informe a data de publicao do preo.

4. Preencha os demais dados e confirme.

5. Acesse Atualizaes / E-Commerce / Monitor Servios CiaShop (LOJA906).
Verifique se o servio de Tabela de Preo Variante (LOJA900F) foi executado com sucesso.
6. Selecione a opo Log, para visualizar o histrico de execues do servio e seu resultado.
7. Selecione a opo detalhe para visualizar os produtos que foram atualizados.
Importante
Para cada exportao de Cadastro, uma sequncia de controle gerada no Campo Seq. Exp e gravado no Campo Dt
Exp (Data da ltima exportao).
Realize este procedimento somente para o cadastro de tabelas de preo que no sejam a Padro e a Promocional.

Venda no e-commerce com pagamento em Boleto

1. No e-commerce CiaShop, realize uma venda com pagamento em Boleto.
2. No Controle de Lojas (SIGALOJA), acesse Atualizaes / E-Commerce / Monitor Servios CiaShop
(LOJA906).
3. Posicione o cursor no servio Pedidos (LOJA901A) e selecione a opo Log e, em seguida, Detalhes.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

21

Boletim Tcnico

4. Localize o Pedido e-commerce e verifique se o mesmo foi integrado com sucesso, por meio do campo Pedido
Conf igual a 1.
5. Acesse Atualizaes/Atendimento/Venda Assistida (LOJA701).
6. No grid de oramento, identifique os componentes gerados na venda e-commerce:

O Pedido e-commerce, atravs do campo Ped Cli Ecom (L1_PEDEC) .

O Ttulo Gerado atravs dos campos Nota Fiscal (L1_DOCPED) e Srie (L1_SERPED) .

O Pedido de Venda no ERP pelo campo Num. Pedido (L1_PEDRES).

7. Acesse Gerencia Finanas/Contas a Receber (FINA040) e localize o ttulo gerado.

8. No Faturamento (SIGAFAT) acesse Atualizaes / Pedidos / Pedidos de Vendas (MATA460) e verifique o
Pedido gerado.
Importante
As etapas 9 a 20 devem ser realizadas somente para as vendas, cujos oramentos estejam com a forma de
pagamento - Campo FormPgto (L1_FORMPG)- tipo FI Financiado.
9. Acesse Pedidos / Liberao Cred. Est (MATA456).
10. Selecione Crdito/Estoque no parmetro Restringir Bloqueio.
11. Verifique se a legenda do Pedido est como bloqueado Crdito.
12. Selecione a opo Manual.
Verifique se foi exibida a mensagem informando que a liberao deve ser realizada pela baixa do pagamento,
e se no foi permitida a liberao do Pedido.
13. No Controle de Lojas (SIGALOJA), acesse Gerencia Finanas/Baixas a Receber (FINA070) e realize a
baixa do ttulo associado venda e-commerce.
14. Acesse Atualizaes / E-Commerce / Monitor Servios CiaShop (LOJA906).
15. Verifique se o servio de Status de Pedidos (LOJA900E) est ativo e foi executado com sucesso.
16. Selecione a opo Log para visualizar o histrico de execues do servio e seu resultado.
17. Na tela log de servio e-commerce, selecione a opo detalhe, e localize o Pedido - campo Pedido
MGT_PEDIDO.

22

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Verifique se foi enviada a atualizao do status campo Status MGT_STATU - para 10 (Pagamento
Confirmado) e se o mesmo foi realizado com sucesso.
18. No Faturamento (SIGAFAT) acesse Faturamento/Documento de Sada (MATA460A)

e informe os

parmetros.
19. Selecione o Pedido e clique na opo Prep. Docs.
20. Confirme os parmetros e aguarde a Preparao do Documento de Sada.
Verifique se a legenda dos itens do Pedido foi alterada para Pedido de Venda encerrado e foi informado o
nmero da Nota Fiscal.
21. Em Controle de Lojas (SIGALOJA) acesse Atualizaes / E-Commerce / Monitor Servios CiaShop
(LOJA906).
Verifique se o servio de Status de Pedidos (LOJA900E) est ativo e foi executado com sucesso.
22. Selecione a opo Log, para visualizar o histrico de execues do servio e seu resultado.
23. Na tela log de servio e-commerce, selecione a opo detalhe, e localize o Pedido - campo Pedido
(MGT_PEDIDO).
Verifique se foi enviada a atualizao do status campo Status (MGT_STATU) - para 30 Pedido Enviado e
se o mesmo foi realizado com sucesso.

Devoluo da Nota Fiscal de Venda

1. No Controle de Lojas (SIGALOJA), acesse Atendimento / Rotina de Troca (LOJA720).
2. Informe a Operao de Devoluo, o Cdigo do Cliente e a Data da Venda.
3. Na prxima tela, selecione a Nota Fiscal gerada na Venda e-commerce.
Na prxima tela, visualize os detalhes fiscal na opo Fiscais.
4. Em seguida, confirme o Cliente da Nota Fiscal de Entrada.
5.

Informe a opo de Gerao de Nota Fiscal de Entrada e compensao do ttulo.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

23

Boletim Tcnico

6. Selecione a opo Finalizar.

7. Verifique a mensagem exibida, que informa o nmero da Nota Fiscal de Entrada gerada e a emisso do
relatrio de Nota de Crdito gerada.
8. Acesse Atualizaes / E-Commerce / Monitor Servios CiaShop (LOJA906).
Verifique se o servio de Status de Pedidos (LOJA900E) est ativo e foi executado com sucesso.
9. Selecione a opo Log, para visualizar o histrico de execues do servio e seu resultado.
10. Na tela log de servio e-commerce, selecione o a opo detalhe, e localize o Pedido - campo Pedido
(MGT_PEDIDO).
Verifique se foi enviada a atualizao do status campo Status (MGT_STATU) - para 91 (Pedido Devolvido)
e se o mesmo foi realizado com sucesso.
Job de cancelamento de Boletos Vencidos
1. No e-commerce CiaShop realize uma venda , cujo mtodo de pagamento esteja associada a uma administradora
financeira do tipo FI Financiada.
Importante
Esta sequncia s pode ser realizada para vendas que gerem ttulos FI Financiados.
2. Em Controle de Lojas (SIGALOJA), acesse Atualizaes / E-Commerce / Monitor Servios CiaShop
(LOJA906).
3. Posicione o cursor no servio Pedidos (LOJA901A) e selecione a opo Log e, em seguida, Detalhes.
Localize o Pedido e-commerce e verifique se o mesmo foi integrado com sucesso, atravs do campo Pedido
Conf igual a 1.
4. Acesse Atualizaes/Atendimento/Venda Assistida (LOJA701).
5. No grid de oramento, identifique os componentes gerados na venda e-commerce:

O Pedido e-commerce, atravs do campo Ped Cli Ecom (L1_PEDEC).

O Ttulo Gerado atravs dos campos Nota Fiscal (L1_DOCPED) e Srie (L1_SERPED).

O Pedido de Venda no ERP pelo campo Num. Pedido (L1_PEDRES).

24

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

6. Na rotina de Venda Assistida, verfique se a venda est vencida, atravs do campo Dt. Validade
(L1_DTLIM) que deve estar com o primeiro dia til anterior data atual.
7. Acesse Gerncia Finanas/Contas a Receber (FINA040) e localize o ttulo gerado.
8. No(s) registro(s) de ttulo(s) gerado(s), verfique se o ttulo est vencido, atravs dos campos: Vencimento
(E1_VENCTO), Vencto Real (E1_VENCREA) e Vencto Orig. (E1_VENCORI) que devem estar com o
primeiro dia til anterior data atual.
9. No Controle de Lojas, acesse Atualizaes / E-Commerce / Monitor Servios CiaShop (LOJA906).
Verifique se o servio de Cancelamento de Boletos (LOJA907) est ativo e foi executado com sucesso.
10. Na opo XML de Envio verifique foi exibida a mensagem do Oramento Cancelado.
Verifique se o servio de Status de Pedidos (LOJA900E) est ativo e foi executado com sucesso.
11. Selecione a opo Log, para visualizar o histrico de execues do servio e seu resultado.
12. Na tela log de servio e-commerce, selecione a opo detalhe, e localize o Pedido - campo Pedido
(MGT_PEDIDO).
13. Verifique se foi enviado a atualizao do status campo Status (MGT_STATU) - para 90 (Pedido Cancelado)
e se o mesmo foi realizado com sucesso.
14. Acesse Atualizaes/Atendimento/Venda Assistida (LOJA701) e verifique se oramento foi excludo.
15. Acesse Gerencia Finanas/Contas a Receber (FINA040) e verifique se o ttulo foi excludo.
16. No Faturamento (SIGAFAT) acesse Atualizaes / Pedidos / Pedidos de Vendas (MATA460) e verifique se
o Pedido foi excludo.
Excluso de Oramento
1. No e-commerce CiaShop, realize uma venda.
2. Em Controle de Lojas (SIGALOJA) acesse Atualizaes / E-Commerce / Monitor Servios CiaShop
(LOJA906).
3. Posicione o cursor no servio Pedidos (LOJA901A) e selecione a opo Log e, em seguida, Detalhes.
Localize o Pedido e-commerce e verifique se o mesmo foi integrado com sucesso, por meio do campo Pedido
Conf igual a 1.

SIGALOJA Integrao E-commerce CiaShop - Fase 2

25

Boletim Tcnico

4. Acesse Atualizaes/Atendimento/Venda Assistida (LOJA701).

5. No grid de oramento, identifique os componentes gerados na venda e-commerce:

O Pedido e-commerce, atravs do campo Ped Cli Ecom (L1_PEDEC).

O Ttulo Gerado atravs dos campos Nota Fiscal (L1_DOCPED) e Srie (L1_SERPED).

O Pedido de Venda no ERP pelo campo Num. Pedido (L1_PEDRES).

6. Acesse a rotina de excluso de oramento Atendimento/Excluir Nf/Orc/Ped e posicione no oramento

gerado.
7. Selecione a opo Excluso Nf/orc.
8. Visualize os dados e selecione Confirmar.
Verifique se a venda foi excluda.
9. Acesse Atualizaes / E-Commerce / Monitor Servios CiaShop (LOJA906).
10. Verifique se o servio de Status de Pedidos (LOJA900E) est ativo e foi executado com sucesso.
11. Selecione a opo Log, para visualizar o histrico de execues do servio e seu resultado.
12. Na tela Log de servio e-commerce, selecione a opo detalhe, e localize o Pedido - campo Pedido
(MGT_PEDIDO).
Verifique se foi enviada a atualizao do status campo Status (MGT_STATU) - para 90 (Pedido Cancelado)
e se o mesmo foi realizado com sucesso.
13. Acesse Atualizaes/Atendimento/Venda Assistida (LOJA701) e verifique se oramento foi excludo.
14. Acesse Gerencia Finanas/Contas a Receber (FINA040) e verifique se o ttulo foi excludo.
Venda de kit de Produtos
Pr-Requisito:
Kit de Produto montado no e-commerce CiaShop, cujos produtos que o compem tenham sido enviados pelos
servios de integrao.
1. Realize os procedimentos de uma venda e-commerce - Venda no e-commerce com pagamento em
Boleto, por exemplo: selecionando comprar um produto do tipo Kit.

26

SIGALOJA Integrao e-commerce CiaShop Fase 2

Boletim Tcnico

Importante
Somente os itens que compem o kit so processados na venda (Oramento, Pedido, Nota Fiscal).

Informaes Tcnicas
DA0 - TABELA DE PREOS
DA1 - ITENS DA TABELA DE PREOS
SA1 - CLIENTES
SA4 - TRANSPORTADORAS
SAE ADMINISTRAO FINANCEIRA
SC5 - PEDIDOS DE VENDA
SC6 - ITENS DOS PEDIDOS DE VENDA
SC9 - PEDIDOS LIBERADOS
SLQ - ORAMENTO
Tabelas Utilizadas

SLR ITENS DO ORAMENTO

SL1 - ORAMENTO
SL2 ITENS DO ORAMENTO
SL4 - CONDIO NEGOCIADA
SE1 CONTAS A RECEBER
SE5 - MOVIMENTAO BANCRIA
SF2 CABEALHO NAS NF DE SADA
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

SIGALOJA Integrao E-commerce CiaShop - Fase 2

27

Boletim Tcnico

OMSA010 Tabela de Preos

MATA070 - Administradora Financeira
LOJA701 - Venda Assistida
FINA040 - Contas a Receber da Venda
FINA050 - Contas a Pagar da Taxa Administrativa
Rotinas Envolvidas

FINA070 - Baixa de Ttulos

LOJA140 - Cancelamento de NF/Orc
MATA456 - Liberao Crd/Estoque
LOJA720 Troca/Devoluo
MATA461 - Documento de Sada
LOJA907 - Cancelamento de Boletos

Sistemas Operacionais

Windows/Linux

28

SIGALOJA Integrao e-commerce CiaShop Fase 2