Manual de Integrao E-Commerce CiaShop x SIGALOJA

Janeiro/2015

Protheus SIGALOJA x e-commerce CiaShop

Ttulo do documento
Sumrio
1.

Contexto de negcio (Introduo) .............................................................................................................. 3

2.

Sistemas Envolvidos .................................................................................................................................. 3

3.

Integrao .................................................................................................................................................. 3

4.

Escopo ....................................................................................................................................................... 4

5.

Pr-requisitos instalao/implantao/utilizao ........................................................................................ 5

5.1.

CiaShop...................................................................................................................................................... 5

5.2.

Protheus ..................................................................................................................................................... 5

6.

Instalao/Atualizao ............................................................................................................................... 6

6.1.

CiaShop...................................................................................................................................................... 6

6.2.

Protheus ..................................................................................................................................................... 6

7.

Controle de Verso .................................................................................................................................... 6

8.

Suporte ....................................................................................................................................................... 6

9.

Transaes/Entidades/Mensagens nicas ................................................................................................. 6

10.

Fluxo das Informaes ............................................................................................................................... 7

10.1. Cadastros ................................................................................................................................................... 7

10.2. Processos................................................................................................................................................... 8
11.

Fluxo das Informaes ............................................................................................................................... 8

12.

Checklist de suporte da aplicao .............................................................................................................. 8

Verso 4.0

Protheus SIGALOJA x e-commerce CiaShop

1. Contexto de negcio (Introduo)

Comrcio eletrnico (tambm conhecido como e-commerce), a automao das transaes comerciais por meio das tecnologias
de informtica e telecomunicaes. A parcela mais visvel do comrcio eletrnico constitui-se do universo de lojas virtuais disponveis
na internet.
Todas as etapas do negcio desde a busca do produto desejado, at sua entrega ao cliente podem ser controladas por
meio do computador. A incluso de um cliente ao banco de dados tem custo marginal baixssimo, praticamente nulo, e pode ser
uma arma estratgica para a fidelizao. Sebrae (http://www.sebrae.com.br) 13/03/2014 10:25) .
A Ciashop uma empresa com mais de 15 anos de experincia em e-commerce, que provem servios flexveis e solues, cujo
desenvolvimento focado em escalabilidade.
Suas plataformas SMB e Framework permitem atender diferentes tamanhos de clientes, tanto pequenas empresas quanto as
grandes operaes de e-commerce.

2. Sistemas Envolvidos

Protheus/SIGALOJA.
E-commerce CiaShop Ambiente Web.

3. Integrao
A integrao e-commerce CiaShop Protheus foi disponibilizada para automatizar o fluxo das informaes entre o ERP Protheus e o
e-commerce, visando a extino do retrabalho cadastral nas duas pontas (ERP e e-commerce), reduzindo ao risco de informaes
divergentes nos dois ambientes.
A integrao com e-commerce CiaShop da CiaShop verso RTM 3.23 automatiza os processos de importao de cadastros de
clientes e pedidos, realizados no site para o ERP, bem como a exportao dos produtos e todos os cadastros relacionados a ele
para o e-commerce da CiaShop.
Os processos integrados do Protheus para o E-commerce CiaShop para so:

Categorias
Produtos
Categorias X Produtos
Saldos em Estoque + Tabela de Preo

Os processos integrados do site E-commerce CiaShop para o Protheus so:

Clientes.
Pedidos.
Servios de controle executam a verificao da base de dados para identificar registros que precisam ser exportados ao site,
considerando os includos e alterados, desde a ltima exportao, e realizam a transferncia dos dados para uma tabela
intermediria.
Tecnologia
As operaes no site E-Commerce so executadas por meio dos mtodos disponibilizados pelo WebService WSIntegrao da
CiaShop.

Verso 22.0

Protheus SIGALOJA x e-commerce CiaShop

Ttulo do documento
O usurio pode acessar os servios de exportao ou acompanhar a execuo via scheduler, ambas acessadas pelo Monitor de
Servios CiaShop.
Para toda ocorrncia de no exportao (inconsistncia), gerado um registro na tabela de log de exportao para futura
visualizao e tomada de providncias.

4. Escopo
Para viabilizar a integrao do Microsiga Protheus x E-commerce CiaShop, disponibilizou-se a seguinte rotina:

Monitor de Servios CiaShop:

O Monitor de Servios de Integrao permite:
Visualizao dos servios (jobs) - associados ao processo de integrao - agendadas para execuo, com seu
respectivo status (Ativo/Inativo) e visualizao do XML enviado/recebido.
Executar a tarefas manualmente, independente do estado de agendamento.
Visualizao do Log de execuo das tarefas.
Impresso do Relatrio de Pedidos Integrados.
Impresso do Relatrio de Pedidos No Integrados.
Processos de Integrao Protheus X CiaShop:

Os processos integrados do Protheus para o e-Commerce CiaShop so:

Categorias/Departamentos (Amarrao com produtos)

o As categorias no Protheus so definidas como departamentos.
o A categoria tem o objetivo de classificar os produtos facilitando a navegao dos clientes no site.
o Segue uma estrutura hierrquica no conceito de pai-filho.
o Um produto pode estar amarrado a mais de uma categoria, ex: o produto Bermuda pode estar vinculado s
categorias Esporte->Futebol->Bermuda e Masculino->Bermuda.
o Uma categoria filha pode estar associada a apenas um pai.
o O Protheus envia ao site as categorias e as respectivas amarraes com os produtos.

Produtos (pai e filho/variantes):

o Produtos (pai e filho): 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, so variaes de
caractersticas de um mesmo produto (grade).

Verso 4.0

Protheus SIGALOJA x e-commerce CiaShop

Os produtos-filhos representam as variaes do produto-pai, principalmente no que se refere a tamanho e cor. No

Protheus, utilizada a grade para atender a esta necessidade. Para envio ao site, o produto pai, que um
produto final tambm, deve estar associado ao produto filho atravs de arquivo e interface de cadastro.
Estoque:
o O Protheus envia ao site a quantidade de itens no estoque, considerando apenas o saldo atual em conjunto com
o preo de Venda, cadastrado na Tabela de Preo e-commerce.
o

Os processos integrados do site do E-commerce CiaShop para o Protheus so:

Clientes.
o Os Dados cadastrais, assim como o Endereo de Entrega do Pedido so includos/alterados no cadastro de
Clientes.
o O cadastro de Cliente pode ser importado pelo servio prprio ou pela rotina de Pedido.
o Caso o Cliente no seja includo no ERP com sucesso, gerada uma ocorrncia no monitor do servio de Cliente
e no servio de Pedido, caso haja uma venda associada a ele.
o Caso o endereo de entrega seja diferente do cadastro do cliente, gerado um novo cdigo de loja (02, 03...) para
o cliente, sendo este cdigo associado aos campos Cliente de Entrega do Pedido.
Pedidos.
o Os pedidos importados para o Protheus correspondem a um pedido de venda gerados pelo servio de integrao
e-commerce CiaShop. Pedidos gerados no site estaro liberados para alterao no ambiente de Faturamento.
o Durante a importao de um Pedido para o ERP so realizadas as seguintes validaes:
TES Inteligente associada ao produto.
Transportadora ERP associada ao servio de entrega.
Mtodos de Pagamento e parcela associado condio de pagamento.
o Os Pedidos estaro bloqueados por crdito, caso o mtodo de pagamento cadastrado esteja sinalizado para gerar
pedido bloqueado, e ser liberado mediante a rotina de Liberao de Crdito/Estoque. Por isso, verificar com a
CiaShop em que etapa do pagamento dever ser enviado o pedido para integrao.
o Aps a importao do Pedido de venda, a rotina de Emisso de Documento de Sada para atualiza o status do
pedido Status Ecom - como Pedido Enviado (30) nas vendas originadas do e-commerce CiaShop,cuja
atualizao do Status ser enviada pelo servio de atualizao de Status.
o Somente o status de Pedido Enviado (30) gerado automaticamente, os demais status (Pagamento Confirmado,
Cancelado, Devolvido) dever ser alterado manualmente atravs do campo Status Ecom, assim como o campo
referente ao link de rastreio do Pedido.

5. Pr-requisitos instalao/implantao/utilizao
5.1.

Plataforma e-commerce CiaShop verso RTM 3.23.

E-commerce CiaShop configurado para realizar integrao, por meio do WebService WsIntegrao.
Realizar os procedimentos de instalao/atualizao descritos na url wiki.ciashop.com.br/parceiros.

5.2.

CiaShop

Protheus

Protheus verso 11 release R5 ou superior.

Servidor Protheus, devidamente configurado para realizar comunicao via WebService.
Criar Schedule no TOTVS para ativar o agendamento dos servios de integrao .
Execuo dos updates de base UPDLO114 e UPDLO148, conforme Procedimentos para Implementao.
Servios de integrao E-commerce CiaShop ativos e agendados no Agent do Shedule.

Verso 22.0

Protheus SIGALOJA x e-commerce CiaShop

Ttulo do documento
6. Instalao/Atualizao
6.1.

Realizar os procedimentos de instalao/atualizao descritos na url wiki.ciashop.com.br/parceiros.

6.2.

CiaShop

Protheus

Realizar os procedimentos de Configurao e Utilizao, descritos no Boletim Tcnico Integrao e-commerce Protheus
X CiaShop.

7. Controle de Verso
O grupo TOTVS representado por suas marcas ir administrar as demandas de evoluo dos layouts e demais ajustes, acordando
junto aos solicitantes o prazo de liberao de release.
Todas as evolues programadas devero ser discutidas e aprovadas pelas marcas antes do incio do desenvolvimento, e somente
sero desenvolvidas em caso de concordncia das marcas e alinhamento com as diretivas definidas pelo Comit de Integrao
TOTVS.

8. Suporte
O suporte aos recursos da Integrao ser de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos
CiaShop e Backoffice Protheus estaro aptas a fazer a primeira anlise e, quando necessrio, repassar para a equipe mais
adequada em cada caso.
Observao: Este modelo de suporte est sendo revisado pela TOTVS.

9. Transaes/Entidades/Mensagens nicas
Integrao
Protheus

Categorias

CiaShop

Departamentos

Produtos(Grade)
+ Tabela de
Preo + Estoque

Produtos(Variantes)

Categoria X
Produtos

DepartamentosProdutos

Estoque + Tabela
de Preos

AtualizaEstoque

Documento de
Sada

StatusPedido

Verso 4.0

Protheus SIGALOJA x e-commerce CiaShop

Integrao
CiaShop

Pedido de Venda

Protheus

Clientes

Compradores

10. Fluxo das Informaes

10.1. Cadastros

Mtodos de Pagamento (no h o envio).

Transportadoras (no h o envio).
Grades de Produtos (no h o envio).
Produto.
Saldo em Estoque.
Tabela de Preo.
TES Inteligente (no h o envio).
Complemento de Produto.
Categorias.
Produto X Categoria.
Cliente (CiaShop).

Verso 22.0

Pedidos

Protheus SIGALOJA x e-commerce CiaShop

Ttulo do documento
10.2. Processos

Gerao do Pedido (CiaShop).

Emisso de Documento de Sada (Status do Pedido).

11. Fluxo das Informaes

Protheus

E-commerce CiaShop

WebService
WsIntegrao

Categorias

Produto

Categoria X
Produto

Status de
Pedido
(Emisso de
Documento
de Sada)

Estoque

Compradores
(Clientes)

Pedidos

12. Checklist de suporte da aplicao

Checklist de Verificaes:
Verificar se o WebService de Integrao WSIntegrao est ativo na URL fornecida pela CiaShop com usurio e senha
informados pela CiaShop.
Verificar se o e-commerce est configurado com o mtodos de pagamentos(formas de pagamento) e servios de entrega
(frete).
Verificar se servidor Protheus est configurado para realizar a comunicao WebService.
Verifcar se o(s) pacote(s) associado(s) (s) funcionalidade(s) informada no Boletim Tcnico Integrao e-commerce
ProtheusX CiaShop foi (ram) aplicado(s).

Verso 4.0

Protheus SIGALOJA x e-commerce CiaShop

Verificar se os compatibilizadores informados no Boletim Tcnico Integrao e-commerce ProtheusX CiaShop foram
executados e os componentes informados nos mesmos foram criados.
Verificar se o todos os procedimentos de Configurao/Implantao informados no Boletim Tcnico Integrao ecommerce ProtheusX CiaShop foram realizados .
Verificar se o parmetro que informa a URL do WebService WsIntegrao est cadastrado no Configurador do Protheus
Verificar se o parmetros que informa o usurio e a senha do usurio associado ao do WebService WsIntegrao est
cadastrado no Configurador do Protheus.
Identificar os cdigos dos mtodos de pagamentos - inclusive as parcelas e os servios de entrega para cadastro no
ERP Protheus.

Verso 22.0