NOME DO REQUISITO

Integração Protheus x CiaShop Utilização do Token

Características do Requisito

Linha de Produto:

Protheus - CiaShop.

Segmento:

Varejo.

Módulo:

SigaLoja.

Rotina:

Rotina	Nome Técnico
Status Pedidos Cancelados/Aprovados.	LOJA900K

Rotina(s) envolvida(s)	Nome Técnico
Identificador de Lojas (Token/URL)	LOJA080
Grava e envia Rastreio de Pedidos.	LOJA900ILOJA900K
Status de Pedidos	LOJA900E
Pedidos	LOJA901A
Consulta Pedido e Financeiro	LOJA900MLOJA901F
Monitor de Serviço E-commerce	LOJA906
Update	UPDLO148

Cadastros Iniciais:

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

Parâmetro(s):

Configurar o parâmetro MV_LJECDNF - Endereco Url Danfe da NFe E-commerce CiaShop. ( = http://testeurldanfe.com.br)

Configurar o parâmetro MV_LJECURL - Endereco Url dos dados da NFe E-commerce CiaShop. ( = http://testeurlnfe.com.br)

Configurar o parâmetro MV_LJECSTF - Loja Ecommerce Status Faturado para o conteúdo 30.

Configurar o parâmetro MV_LJECOMO - E-Commerce CiaShop para o conteúdo .T.

Configurar o parâmetro MV_LJECDIR - Número de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelados.

Configurar o parâmetro MV_LJECOMK - com a URL do webService da Ciashop. Ex: conteúdo do parâmetro (//https://totvsdev.myciashop.com.br/ws/)

Ponto de Entrada:

Não foram utilizados pontos de entrada.

Chamados Relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito (ISSUE):

Informe o requisito relacionado (Issue).

País(es):

Brasil.

Banco(s) de Dados:

SQL2008.todos

Tabelas Utilizadas:

MH6./ MH8 / SLJ

Sistema(s) Operacional(is):

Windows/Linux.

Descrição

API é um conjunto de rotinas e padrões de programação para acesso a um aplicativo de software ou plataforma baseado na Web. A sigla API refere-se ao termo em inglês "Application Programming Interface"

que significa em tradução para o português "Interface de Programação de Aplicativos".

A rotina LOJA901A ( Pedidos ) baixará para o Protheus os pedidos de vendas digitados no site da loja Ciashop. Estes pedidos poderão ser de Market Place ou não. No Protheus serão criados os pedidos de venda (SC5/SC6/SC9), reservas (SC0), financeiro (SE1), orçamento (SL1/SL2/SL4). Um registro na tabela SC9 ( Pedidos Liberados ) só será criado se o pedido de venda não for MarketPlace, ou seja, os pedidos de venda Market Place não serão liberados para faturamento neste momento. Os demais pedidos da Loja serão liberados para faturamento. Os pedidos Market Place virão com o campo código de pagamento igual a '998' ( _COD_PG = '998' ). Se a rotina verificar que o pedido é um Market Place e o código do pagamento vier diferente de '998' será desconsiderado o código de pagamento atual e no lugar será considerado '998'.

A tabela SAE ( Administração Financeira ) deverá conter o registro abaixo na importação de um pedido Market Place:

AE_COD	AE_DESC	AE_TIPO	AE_ECCODIG
004	Administradora Market Place	FI	998

O código 004 - Administradora Market Place será gravado na tabela SL4 ( Condição Negociada ).

Para os pedidos da loja, não Market Place, serão utilizadas outras administradoras financeiras:

A falta desse registro na tabela SAE ( Administração Financeira ) causará o erro 5 - Método de pagamento não cadastrado.

Segue abaixo outros motivos de erro que podem ocorrer na rotina 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

11 - Problemas na geração do Orçamento

12 - Problemas na geração do Título de Contas a Receber

13 - Problemas na geração do Título de Contas a Pagar da Taxa Administrativa

A rotina LOJA900E ( Status de Pedido ) enviará para loja o status dos pedidos no Protheus e o código do rastreio (correios). Enviará também os dados da Nota Fiscal Eletrônica (NFe) para os pedidos de venda com status de enviado ( = 30 ), com nota fiscal gerada e pedido Market Place. Ao terminar a rotina de status de pedido será executada a rotina LOJA900K ( Aprovação/Cancelamento Pedido ). Através da API (https://totvsdev.myciashop.com.br/api/v1/orders/?minUpdatedAt=yyyy-mm-aa) serão lidos todos os pedidos Ciashop a partir da data do sistema (dDataBase) em diante. Existe um parâmetro (MV_LJECDIR) que retrocede a data em um determinado número de dias para que possam ser processados aqueles pedidos que ficaram pendentes de um dia para outro. Por exemplo se a data do sistema no Protheus for 21/112016 e o conteúdo do parâmetro 2 (dias) serão processados todos os pedidos a partir da data 19/11/2016. Se o pedido de venda estiver com o status de cancelado ( "status": "cancelled") serão excluídos do Potheus. As reservas, financeiro, orçamento também serão excluídos. Os pedidos com status de aprovado ( "status": "approved") serão liberados para faturamento e o título correspondente ao pedido de venda será baixado no Protheus.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o UPDLO148 é imprescindível:

Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão 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 não estejam identificados pelo nickname.
O compatibilizador deve ser executado com a Integridade Referencial desativada*.

Atenção

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação 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:

No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
Se não há Integridade Referencial ativa, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário qualquer outro procedimento de ativação ou desativação de integridade, basta finalizar a verificação e aplicar normalmente o compatibilizador, conforme instruções.
Se há Integridade Referencial ativa em todas as empresas e filiais, é exibida uma mensagem na janela Verificação de relacionamento entre tabelas. Confirme a mensagem para que a verificação seja concluída, ou;
Se há Integridade Referencial ativa em uma ou mais empresas, que não na sua totalidade, são relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e, somente, a(s) que possui(em) integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta anotação para posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework para informações quanto a um arquivo que contém essa informação).
Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da integridade, selecione-a(s) novamente e confirme a ativação.

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
Clique em OK para continuar.
Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
  É apresentada uma mensagem explicativa na tela.
2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
3. Clique em Gravar para salvar o histórico (log) apresentado.
4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Aplique o patch do chamado e execute uma vez a rotina CiaShop.
No módulo SIGACFG acesse Ambiente >> Cadastros >> Parâmetros e verifique que o parâmetro MV_LJECSTF, MV_LJECOMO e MV_DIASRET foram criados conforme especificações abaixo:

Nome da Variável:	MV_LJECSTF
Tipo:	C
Descrição:	Loja Ecommerce Status Faturado.
Valor Padrão:	30

Nome da Variável:	MV_LJECOMO
Tipo:	L
Descrição:	E-Commerce CiaShop.
Valor Padrão:	.T.

Nome da Variável:	MV_LJECDIR
Tipo:	N
Descrição:	Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelado.
Valor Padrão:	0

Nome da Variável:	MV_LJECDNF
Tipo:	C
Descrição:	Endereço Url Danfe da NFe E-commerce CiaShop.
Valor Padrão:	http://testeurldanfe.com.br

Nome da Variável:	MV_LJECURL
Tipo:	C
Descrição:	Endereço Url dos dados da NFe E-commerce CiaShop.
Valor Padrão:	http://testeurlnfe.com.br

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte	(X1_PERGUNT)
Nome
Grupo	(X1_GRUPO)
Ordem	(X1_ORDEM)
Tipo	(X1_TIPO)
Tamanho	(X1_TAMANHO)

2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

MH6

(X2_CHAVE)

AMARRAÇÃO DADOS NO CIASHOP

(X2_NOME)

E

(X2_MODO)

N

(X2_PYME)

Chave

Nome

Modo

PYME

MH8

(X2_CHAVE)

EC CIASHOP LOG STA.PED.CAN.APR

(X2_NOME)

E

(X2_MODO)

N

(X2_PYME)

3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave	Ex.: não utilizado.
Descrição	Ex.: não utilizado.

4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

Tabela MH6 - AMARRAÇÃO DADOS NO CIASHOP:

Campo	MH6_FILIAL
Tipo	C
Tamanho	8
Decimal	0
Formato	@!
Título	Filial
Descrição	Filial do Sistema
Nível	0
Usado	Sim
Obrigatório	Sim
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Filial do Sistema.

Campo	MH6_PDECOM
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	Ped E-Com.
Descrição	Ped E-Commerce
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Código do pedido de venda E-commerce.

Campo	MH6_STATUS
Tipo	C
Tamanho	2
Decimal	0
Formato
Título	Status Pedid
Descrição	Status Pedido
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Status do pedido de venda E-commerce: -1=Volta passo;00=Pedido colocado;05=Em analise;10=Pagamento confirmado; 15=Embalado;21=Parcialmente enviado; 30=Enviado;90=cancelado; 91=Devolvido

Campo	MH6_RASTRE
Tipo	C
Tamanho	20
Decimal	0
Formato	@!
Título	Rastreio
Descrição	Rastreio
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Código do rastreio Correios.

Campo	MH6_PEDORI
Tipo	C
Tamanho	6
Decimal	0
Formato	@!
Título	Ped.Ori.Loja
Descrição	Pedido Origem Loja/MktPla
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Pedido Origem Loja ou Market Place

Campo	MH6_CANORI
Tipo	C
Tamanho	35
Decimal	0
Formato	@!
Título	Canal Origem
Descrição	Canal Origem
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Canal Origem Market Place: Ex.: Lojas Americanas

Campo	MH6_HRRAST
Tipo	C
Tamanho	8
Decimal	0
Formato	@!
Título	Hr Rastreio
Descrição	Hora Rastreio
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Hora de envio do código do rastreio para o site da loja Ciashop.

Campo	MH6_DTRAST
Tipo	C
Tamanho	8
Decimal	0
Formato	@!
Título	Dt. Rastreio
Descrição	Data de Rastreio
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Data de envio do código do rastreio para o site da loja Ciashop.

Tabela MH8 - EC CIASHOP LOG STA.PED.CAN.APR:

Campo	MH8_FILIAL
Tipo	C
Tamanho	8
Decimal	0
Formato	@!
Título	Filial
Descrição	Filial do Sistema
Nível	0
Usado	Sim
Obrigatório	Sim
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Filial do Sistema.

Campo	MH8_SEQ
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	Sequencia
Descrição	Sequencia
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Sequencial de gravação item de LOG.

Campo	MH8_NUM
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	Ped.Protheus
Descrição	Pedido Protheus
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Número do pedido de venda ou número do título a receber.

Campo	MH8_PEDECO
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	Ped E-Comerc
Descrição	Pedido E-Comerce
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Número do pedido de E-Commerce associado ao pedido de venda.

Campo	MH8_DOCPED
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	Nota Fiscal
Descrição	Nota Fiscal
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Número da nota fiscal do pedido de venda ou documento do orçamento (SL1).

Campo	MH8_SERPED
Tipo	C
Tamanho	3
Decimal	0
Formato	@!
Título	Serie
Descrição	Serie
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Série da nota fiscal do pedido de venda ou série do orçamento (SL1).

Campo	MH8_ORCAME
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	No Orcamento
Descrição	Numero do Orcamento
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Número do orçamento (SL1).

Campo	MH8_PRODUT
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	Cod. Produto
Descrição	Codigo do Produto
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Código do produto.

Campo	MH8_STAPRO
Tipo	C
Tamanho	2
Decimal	0
Formato	@!
Título	Status Proth
Descrição	Status do Protheus
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Status do pedido de venda Potheus.

Campo	MH8_STACIA
Tipo	C
Tamanho	2
Decimal	0
Formato	@!
Título	Stat CiaShop
Descrição	Status CiaShop
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Status do pedido CiaShop atrelado ao pedido de venda Potheus.

Campo	MH8_MOTIVO
Tipo	C
Tamanho	2
Decimal	0
Formato	@!
Título	Mot.Err.Suce
Descrição	Motivo Erro ou Sucesso
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Código do motivo de erro ou sucesso no processamento pedidos cancelados/aprovados CiaShop.

Campo	MH8_DESMOT
Tipo	C
Tamanho	10
Decimal	0
Formato	@!
Título	Descr.Mot.ES
Descrição	Descricao Motivo Err/Suce
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Descrição do motivo de erro ou sucesso no processamento pedidos cancelados/aprovados CiaShop.

Tabela SC5 - Pedidos

Campo	C5_DTRASTR
Tipo	D
Tamanho	8
Decimal	0
Formato	@!
Título	Dt. Rastreio
Descrição	Data de Rastreio Pedido
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Data de envio do rastreio correios.

Campo	C5_HRRASTR
Tipo	C
Tamanho	8
Decimal	0
Formato	@!
Título	Hr. Rastreio
Descrição	Hora do Rastreio
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Hora de envio do rastreio correios.

Campo	C5_ECPEORI
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	E-com.Ped.Or
Descrição	E-commerce Pedido Origem
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Pedido Origem MarketPlace.

Campo	C5_ECCAORI
Tipo	C
Tamanho	25
Decimal	0
Formato	@!
Título	E-Com.Ca.Ori
Descrição	E-Commerce CAnal ORIgem
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Pedido Origem MarketPlace.

Tabela SC9 - Pedidos Liberados

Campo	C9_PEDECOM
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	Ped.E-Commer
Descrição	Pedido E-Commerce
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Pedido e-commerce associado ao pedido de venda CiaShop.

Campo	C9_ECPEORI
Tipo	C
Tamanho	15
Decimal	0
Formato	@!
Título	E-com.Ped.Or
Descrição	E-commerce Pedido Origem
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Pedido e-commerce origem associado ao pedido de venda CiaShop.

Campo	C9_ECCAORI
Tipo	C
Tamanho	25
Decimal	0
Formato	@!
Título	E-Com.Ca.Ori
Descrição	E-Commerce CAnal ORIgem
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Canal Origem do pedido de venda Ciashop.

Tabela SLJ - Identificação Loja

Campo	LJ_URL
Tipo	C
Tamanho	150
Decimal	0
Formato	@!
Título	Url Lj Ciash
Descrição	Url Loja Ciashop
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Endereço de acesso ao site da loja.

Campo	LJ_TOKEN
Tipo	M
Tamanho	10
Decimal	0
Formato	@!
Título	Chave Token
Descrição	Chave Token CiaShop
Nível	0
Usado	Sim
Obrigatório	Não
Browse	Sim
Opções
When
Relação
Val. Sistema
Help	Chave de acesso ao site da Loja (Token).

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

Pesquisa B05PLS:

Alias	(XB_ALIAS)
Tipo	(XB_TIPO)
Sequência	(XB_SEQ)
Coluna	(XB_COLUNA)
Descrição	(XB_DESCRI)
Contém	(XB_CONTEM)

6. Criação ou Alteração de Índices no arquivo SIX – Índices:

U

Índice	SC5MH6
Ordem	61
Chave	C5MH6_FILIAL+C5_PEDECOM
Descrição	Ped E-Com.
Proprietário	U
NickName	C5PEDECOM
ShowPesq	S
Índice	SF2
Ordem	10
Chave	F2_FILIAL+F2_PREFIXO+F2_DUPL+F2_CLIENTE+F2_LOJA
Descrição	Prefixo+Num. Titulo+Cliente+Loja
Proprietário
NickName	SF2PRFDUPL
ShowPesq	S
Índice	MH6
Ordem	1
Chave	MH6_FILIAL MH6_PDECOM
Descrição	Filial+Ped E-Com.
Proprietário	U

Índice	MH8MH6
Ordem	12
Chave	MH8MH6_FILIAL+MH8_SEQ MH6_PEDORI
DescriçãoSequencia	Filial+Pedido Orig.
Proprietário	U

7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável	MV_LJECSTF
Tipo	C
Descrição	Loja Ecommerce Status Faturado.
Valor Padrão	30

Nome da Variável

MV_LJECOMO

Tipo

L

Descrição

E-Commerce CiaShop

Valor Padrão

.T.

Nome da Variável

MV_DIASRET

Tipo

N

Descrição

Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelados.

Valor Padrão

0

8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

Tabela SE1 – Contas a Receber

Campo	E1_CLIENTE
Sequência	003
Campo Domínio	E1_PEDECOM
Tipo	P
Regra	U_LJI9PECM()
Posiciona?	N
Chave	Informe o conteúdo do (X7_CHAVE)
Condição	INCLUI
Proprietário	U

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas	Descrição
Nome:	MV_DIASRET
Tipo:	N
Cont. Por.:	0
Descrição:	Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelados.

Itens/Pastas	Descrição
Nome:	MV_LJECSTF
Tipo:	C
Cont. Por.:	30
Descrição:	Loja Ecommerce Status Faturado.

Itens/Pastas	Descrição
Nome:	MV_LJECOMO
Tipo:	.T.
Cont. Por.:	30
Descrição:	E-Commerce CiaShop.

CONFIGURAÇÃO DE MENUS

2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu	SigaLoja.xnu
Submenu	E-commerce
Nome da Rotina	Acesso Token Ciashop
Programa	LOJA900J
Módulo	SigaLoja
Tipo	Protheus

Índice	MH8
Ordem	1
Chave	MH8_FILIAL+MH8_SEQ
Descrição	Sequencia
Proprietário	U

7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável	MV_LJECURL
Tipo	C
Descrição	Endereco Url dos dados da NFe E-commerce CiaShop.
Valor Padrão	http://testeurlnfe.com.br

Nome da Variável	MV_LJECDNF
Tipo	C
Descrição	Endereco Url Danfe da NFe E-commerce CiaShop.
Valor Padrão	http://testeurldanfe.com.br

Nome da Variável	MV_LJECDIR
Tipo	N
Descrição	Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelados.
Valor Padrão	0

8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas	Descrição
Nome:	MV_LJECDIR
Tipo:	N
Cont. Por.:	0
Descrição:	Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelados.

Itens/Pastas	Descrição
Nome:	MV_LJECURL
Tipo:	C
Cont. Por.:	30
Descrição:	Endereco Url dos dados da NFe E-commerce CiaShop.

Itens/Pastas	Descrição
Nome:	MV_LJECSTF
Tipo:	C
Cont. Por.:	30
Descrição:	Loja Ecommerce Status Faturado.

Itens/Pastas	Descrição
Nome:	MV_LJECDNF
Tipo:	C
Cont. Por.:	http://testeurldanfe.com.br
Descrição:	Endereco Url Danfe da NFe E-commerce CiaShop.

CONFIGURAÇÃO DE MENUS

2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu	SigaLoja.xnu
Submenu	E-commerce
Nome da Rotina	Monitor Serv. Ciashop
Programa	LOJA906
Módulo	SigaLoja
Tipo	Função Protheus

Menu	SigaLoja.xnu
Submenu	E-commerce
Nome da Rotina	Grava/Envia Rastreio Ped.
Programa	LOJA900K
Módulo	SigaLoja
Tipo	Função Protheus

Menu	SigaLoja.xnu
Submenu	E-commerce
Nome da Rotina	Consult.pedido.financeiro
Programa	LOJA901F
Módulo	SigaLoja
Tipo	Função Protheus

Procedimento para Utilização:

Chave de acesso Token
No ambiente da Loja virtual, gerar token para se comunicar com a loja virtual;
Acessar o administrador da loja através do endereço padrão https://nomedaloja.myciashop.com.br/manager.
Trocar o <nomedaloja> por <totvsdev>:
https://totvsdev.myciashop.com.br/manager
Estas informações são fornecidas ao cliente após criação da loja pela equipe administrativa Ciashop. Lembramos que a loja é criada após o envio do contrato e proposta (digitalizados) de implantação devidamente assinados pelo cliente:
Login: totvsdev
Senha: totvsdev
Image Added
A confirmar Login e senha clicando no botão Login a tela abaixo é apresentada:
Image Added
Clicar em Apps e, em seguida, clicar em Criar App Privado:
Image Added
Na caixa nome do App, preencher um nome do aplicativo. Sugerimos o nome Protheus. Por fim, clicar no botão Gerar Token.
Image Added
O App será gerado e aparecerá na listagem de nomes:
Image Added
Na lista de aplicativos, procure o App criado e, em seguida, clique no botão Copiar Token:
Image Added
No Controle de Loja (SIGALOJA), acesse Atualizações / Gerência Vendas / Identif.de Lojas:
Image Added
Image Added
Clique na opção Incluir ou Alterar (caso o identificador da loja já esteja gravado):
Image Added
Preencha os campos abaixo e cole a chave, copiada no item Copiar Token, no campo Chave Token. A Url (totvsdev.myciashop.com.br) será alimentada do parâmetro "MV_LJECOMK".
Image Added
Clique no botão Confirmar e em seguida Fechar:
Image Added

Caso a Chave ou a Url não esteja de acordo ao tentar utilizar a consulta Traker o sistema apresenta a mensagem de erro.
Image Added
Inclusão Pedido de Venda no site da loja Ciashop

Acesse o site CiaShop para inclusão do pedido CiaShop:

http://totvsdev.myciashop.com.br/:

Image Added

Na caixa de texto [ Pesquise seu produto... ] digite o produto e clique em buscar:

Image Added

Clique no botão [ Comprar ]:

Image Added

Clique no botão [ ir para o carrinho ]:

Image Added

Digite o CEP e clique no botão [ calcular ] para cálculo do Frete e Clique no botão [ FECHAR PEDIDO ]:

Image Added

Digite um e-mail válido e clique no botão [ Continuar ]:

Image Added

Digite uma Senha válida e clique no botão Continuar:

Image Added

Clique no botão [ Usar este endereço ]:

Image Added

Selecione uma Forma de Pagamento (p. ex. Depósito Bancário) e clique no botão [ concluir compra ]:

Image Added

Clique em Autorizar e Fechar Compra:

Image Added

Será apresentada uma tela de pedido confirmado:

Image Added

Um e-mail é enviado confirmando o recebimento do pedido:

Image Added

Entre com novos pedidos seguindo os passos anteriores selecionando outras formas de pagamento: cartão de crédito e faturado.

Image Added

Digite o número do cartão, código de segurança e clique no botão [ Autorizar e Fechar Compra ]:

Image Added

Inclua novo pedido e selecione a forma de pagamento Faturado. Clique em [ concluir compra ]:

Image Added

Aguarde o processamento do pedido:

Image Added

3. Baixando Pedido de Venda do site da Loja CiaShop para o Protheus

No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) :

Image Added

Posicione no último pedido de venda gravado (p. ex.: 000160):

Image Added

No Controle de Loja (SIGALOJA), acesse E-commerce > Monitor Serv. CiaShop (LOJA906):

NOTA IMPORTANTE !!! – NÃO UTILIZAR O SIGAMDI PARA EXECUTAR ESTA ROTINA !!!

Clique na linha LOJA901A – Pedidos e clique no botão [ Executar ]:

Image Added

Aguarde o término da execução da sincronização de dados com a CiaShop:

Image Added

Sincronização efetuada com sucesso:

Image Added

Clique no botão Log para consultar o Log de execução da rotina Pedidos:

Image Added

Clique no botão [Detalhes]:

Image Added

Clique no botão [ Cons Tracker ] para consultando o Tracker dos pedidos:

Image Added

Digite o número do pedido e-commerce para consulta do tracker:

Image Added

Clique no botão [+] para expandir a consulta do tracker:

Image Added

No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) e visualize o pedido de venda gerado:

Image Added

Consultando o número e o status do pedido e-commerce (00=Pedido Colocado):

Image Added

4. Aprovando o Pedido de Venda no Protheus

No Controle de Loja (SIGALOJA), acesse Atualizações / Gerencia Finanças / Baixas a Receber (FINA070), Posicione no título a ser baixado e clique na opção Baixar :

Image Added

Clique no botão [Confirmar] para confirmar a baixa do título:

Image Added

Clique no botão Sair:

Image Added

No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) posicione no pedido de venda e verifique o status do pedido (10=Pagamento confirmado) cujo título a receber foi baixado:

Image Added

Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:

Image Added

No Controle de Loja (SIGALOJA), acesse E-commerce > Monitor Serv. CiaShop (LOJA906) posicione na linha LOJA900E – Status de Pedidos e clique no botão [Executar]:

Image Added

Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resultado (=sucesso).

Recebimento e-mail de pagamento aprovado:

Image Added

Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:

Image Added

No Faturamento (SIGAFAT), acesse Atualizações / Faturamento / Documento de Saida (MATA460) selecione os itens a faturar e clique na opção Prep.docs:

Image Added

Ajustes os parâmetros e clique no botão OK para confirma-los. Seleciona a série e nota:

Image Added

Confirme a geração da nota clicando nos botões OK:

Image Added

Clique no botão sair para sair da preparação do documento.

No Faturamento (SIGAFAT), acesse Atualizações / Pedidos / Pedidos de venda (MATA410) E verifique o status do pedido (30=Enviado) de venda que teve o seu título a receber baixado:

Image Added

No Controle de Loja (SIGALOJA), acesse E-commerce / Monitor Serv. CiaShop posicione na linha LOJA900E – Status de Pedidos e clique no botão executar:

Image Added

Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resutado (=sucesso).

Recebimento e-mail de pedido enviado:

Image Added

Visualizando o status do pedido e-commerce 520 pela ferramenta Postman:

Image Added

nota: se o parâmetro MV_LJECDIR (numero de dias a retroceder da data de processamento) estiver diferente de 0 (zero) a data será retroagida (p. ex.: = 2 data do sistema 21/09/2016 será retroagida para 19/09/2016).

5. Aprovação Pedido de Venda site Loja CIaShop

Processamento do pedido aprovado Loja CIashop no Protheus (LOJA900K).

Para acesso ao site da Loja Ciashop digite o endereço abaixo:

http://totvsdev.myciashop.com.br

Será apresentada na tela abaixo:

Image Added

Para incluir um produto, digite na caixa de texto o código do produto em seguida clique no botão buscar:

Image Added

Para comprar o produto informe a quantidade e clique em comprar:

Image Added

Selecione Ir para o carrinho:

Image Added

Digite o Cep, selecione calcular para cálculo do Frete e selecione Fechar Pedido:

Image Added

Selecione Usar este endereço e continuar:

Image Added

Selecione uma das formas de pagamento e concluir a compra:

Depósito Bancário

Image Added

Cartão de Crédito

Image Added

Faturado

Image Added

Aguarde o processamento do pedido:

Image Added

Na tela de pedido confirmado selecione Voltar para página principal:

Image Added

Rotina LOJA901A - Pedidos

A rotina LOJA901A – será utilizada para baixar (incluir) no Protheus o pedido informado anteriormente no site da loja (CiaShop), pedido de e-commerce 677. Na baixa do pedido Ciashop, será atualizado no Protheus a tabela de pedido de venda (SC5/SC6), reserva (SC0), título a receber (SE1) e orçamento (SL1/SL2/SL4). O pedido será gerado com status 00 – pedido colocado (C5_STATUS).

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Monitor Serv. Ciashop. A tela Monitor de Serviços E-Commerce será apresentada:

Image Added

Os pedidos de venda na loja Ciashop serão sincronizados com o Protheus:

Image Added

Ao término da rotina de Pedidos será apresentado na coluna Resultado Erro ou Sucesso. Ainda posicionado na linha de Pedidos, selecione Log para consultar o log do pedido.

Image Added

Selecione o botão detalhes:

Image Added

Observe o número do pedido e-commerce e role a barra de rolagem à direita:

Image Added

Selecione voltar para retornar a tela Monitor de serviços E-commerce:

Image Added

Ainda posicionado na linha LOJA901A - Pedidos selecione botão Cons Tracker para consultar o Tracker do pedido de venda:

Image Added

Digite o número do pedido E-commerce (680) gerado anteriormente e selecione Ok:

Image Added

Selecione Fechar para sair da tela do Tracker:

Image Added

Pedido de Venda

Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:

Image Added

Role a barra de rolagem vertical para visualizar os demais campos:

Image Added

Nota: pedido gerado com quantidade liberada zerada, ou seja, pedido não liberado para faturamento.

Selecione o botão fechar para sair da tela de pedido de venda:

Image Added

Título a Receber

Pelo módulo Controle de Lojas, acesse a opção Atualizações >> Gerencia Financas >> Contas a Receber:

Image Added

Role a tela até encontrar o título a receber ou pesquise o título a receber conforme tela abaixo e selecione Visualizar:

Image Added

Reserva

Pelo módulo Controle de Loja, acesse a opção Atualização >> Gerência Vendas >> Controle Reservas:

Image Added

Selecione Visualizar:

Image Added

Selecione Fechar para sair da tela Controle Reservas:

Image Added

Orçamento

Pelo módulo Controle de Loja, acesse a opção Atualizaçs >> Atendimento >> Venda Assistida:

Image Added

Role a barra de rolagem até o orçamento desejado e selecione Visualizar:

Image Added

Selecione o botão Sair para fechar a tela de orçamento:

Image Added

Status de Pedidos (LOJA900E)

A rotina de Status de Pedidos envia para o site da loja Ciashop os status dos pedidos de venda no Protheus. Ao final da execução da rotina Status de Pedidos, a rotina de cancelamento e aprovação de pedido de venda (LOJA900K) é chamada para o processamento dos pedidos Ciashop cancelados e/ou aprovados no site da loja.

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Monitor Serv. Ciashop. A tela Monitor de Serviços E-Commerce será apresentada. Selecione a linha da rotina LOJA900E – Status de Pedidos e clique em executar:

Image Added

A sincronização dos dados com a loja virtual Ciashop x Protheus será processado.

Image Added

Ao término dos processamentos das rotinas Status de Pedidos (LOJA900E) e Cancelamento/Aprovação pedido de venda (LOJA900K) selecione o botão Fechar para fechar o Monitor de Serviços E-commerce.

Image Added

Aprovação do pedido de venda

Tomando como exemplo o pedido de venda E-commerce 000680, importado anteriormente, e cancelado pela rotina temos:

Image Added

Ao ser executada a rotina de aprovação de pedido (LOJA900K), ela liberará no Protheus o pedido de venda (SC5/SC6/SC9) para faturamentos (geração documento de saída), baixará o título no contas a receber no Financeiro (SE1). As Reservas (SC0) e o orçamento (SL1/SL2/SL4) serão mantidos.

Pelo módulo Faturamento, acesse a opção Atualizações >> Faturamento >> Documento de saída:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e verifique que o pedido E-commerce 680 (pedido Protheus correspondente 000304) consta no sistema como liberado para faturamento:

Image Added

Para verificar se o título a receber foi baixado pela rotina de aprovação de pedido de venda Ciashop utilize o módulo Controle de Lojas, acesse a opção Atualizações >> Gerencia Financas >> Contas a Receber:

Image Added

Role a tela até encontrar o título a receber ou pesquise o título a receber conforme tela abaixo. Selecione a opção Legenda no Ações Relacionadas:

Image Added

Pedido de Venda

Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:

Image Added

Role a barra de rolagem vertical para visualizar os demais campos. Com a baixa do título o status do pedido de venda é alterado para Pagamento Confirmado:

Image Added

Preparação do Documento de Saída

Uma vez o pedido de venda liberado para faturamento e o título a receber baixado (pagamento confirmado), pela rotina de aprovação pedido, podemos faturar (gerar a nota fiscal de saída) do pedido.

Pelo módulo Faturamento, acesse a opção Atualizações >> Faturamento >> Documento de saída:

Image Added

A tela de parâmetros é apresentada. Preencha os parâmetro e confirme selecionando o botão OK:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e verifique que o pedido E-commerce 680 (pedido Protheus correspondente 000304) consta no sistema como liberado para faturamento:

Image Added

Marque, com duplo-clique, o item a fatuar e clique no botão Prep. docs:

Image Added

Preencha os parâmetros necessários:

Image Added

Selecione a Série, número da nota e clique em ok:

Image Added

Clique no botão Ok para confirmar a geração da nota:

Image Added

Aguarde a geração da nota fiscal:

Image Added

Selecione a opção Ações Relacionadas para visualizar a legenda:

Image Added

Selecione a opção Sair para fechar a tela de prepração de nota:

Image Added

Pedido de Venda

Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:

Image Added

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Monitor Serv. Ciashop. A tela Monitor de Serviços E-Commerce será apresentada. Selecione a linha da rotina LOJA900E – Status de Pedidos e clique em executar:

Image Added

Recebimento de e-mail confirmação pedido de venda enviado:

Image Added

Para os pedidos de venda com status 30 ( Enviado ) e nota fiscal Gerada serão enviados os dados da Nota Fiscal Eletrônica (NFe) e um e-mail será enviado ao usuário do pedido de venda:

Image Added

Nota: para reenviar os dados da nota fiscal (NFe) exclua da tabela MGT - EC CIASHOP LOG SINCR STAT PED o registro referente ao pedido de venda Protheus/Ecommerce.

Para consultar os status do pedido, visualizar o pedido de venda e o financeiro (título a receber):

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Consult.pedido.financeiro:

Image Added

Informe os parâmetros necessários para compor o filtro:

Image Added

Selecione a opção Legenda para visualizar os status dos pedidos de venda:

Image Added

Selecione Ações Relacionadas para consultar o financeiro (título a receber) do pedido de venda:

Image Added

Selecione o botão Fechar para sair da tela de consulta Financeiro:

Image Added

Duplo clique na linha do pedido de venda apresenta a tela de visualização do pedido de venda:

Image Added

Role a barra de rolagem horizontal/vertical para visualizar os demais campos:

Image Added

6. Processando pedidos Cancelados/Aprovados CiaShop

Status de Pedidos (LOJA900E)

A rotina de Status de Pedidos envia para o site da loja Ciashop os status dos pedidos de venda no Protheus. Ao final da execução da rotina Status de Pedidos, a rotina de cancelamento e aprovação de pedido de venda (LOJA900K) é chamada para o processamento dos pedidos Ciashop cancelados e/ou aprovados no site da loja.

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Monitor Serv. Ciashop. A tela Monitor de Serviços E-Commerce será apresentada. Selecione a linha da rotina LOJA900E – Status de Pedidos e clique em executar:

Image Added

A sincronização dos dados com a loja virtual Ciashop x Protheus será processado.

Image Added

Ao término dos processamentos das rotinas Status de Pedidos (LOJA900E) e Cancelamento/Aprovação pedido de venda (LOJA900K) selecione o botão Fechar para fechar o Monitor de Serviços E-commerce.

Cancelamento de pedido de venda

Tomando como exemplo o pedido de venda E-commerce 000677, importado anteriormente, e cancelado pela rotina temos:

Image Added

O pedido de venda, por algum motivo, pode ser cancelado pela loja Ciashop. Ao ser executada a rotina de cancelamento de pedido (LOJA900K), ela excluirá no Protheus o pedido de venda (SC5/SC6), Reservas (SC0), contas a receber no Financeiro (SE1) e o orçamento (SL1/SL2/SL4). Ao consultar o tracker do pedido de venda e-commerce cancelado utilize a tela abaixo. Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Monitor Serv. Ciashop. Selecione a linha LOJA901A - Pedidos selecione botão Cons Tracker para consultar o Tracker do pedido de venda:

Image Added

Digite o pedido E-commerce cancelado:

Image Added

Será apresentada a mensagem abaixo:

Image Added

Selecione OK para fechar a tela da mensagem apresentada. Selecione Fechar para sair da rotina Monitor de Serviços E-commerce.

Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e verifique que o pedido E-commerce 677 (pedido Protheus correspondente 000303) não consta mais no sistema:

Image Added

Para verificar se o título a receber foi excluído pela rotina de cancelamento de pedido de venda Ciashop utilize?

Pelo módulo Controle de Lojas, acesse a opção Atualizações >> Gerencia Financas >> Contas a Receber:

Image Added

Role a tela até encontrar o título a receber ou pesquise o título a receber conforme tela abaixo:

Image Added

Reserva

Pelo módulo Controle de Loja, acesse a opção Atualização >> Gerência Vendas >> Controle Reservas:

Image Added

Role a tela até encontrar o título a receber ou pesquise a reserva conforme tela abaixo:

Image Added

Orçamento

Pelo módulo Controle de Loja, acesse a opção Atualizações >> Atendimento >> Venda Assistida:

Image Added

Role a tela até encontrar reserva ou pesquise o título a receber conforme tela abaixo:

Image Added

Após a execução da rotina Status Ped.Canc./Aprov (cancelamento pedido CiaShop 542) os dados do pedido de venda (SC5/SC6/SC9), financeiro contas a receber (SE1), orçamento (SL1/SL2) e reservas deverão ser excluídos do sistema:

7. Rastreio

Para incluir e/ou enviar os dados do rastreio (Correios) do pedido de venda para o Ciashop:

Pelo módulo Controle de Loja, acesse a opção Atualização >> E-commerce >> Grava/envia Rastreio Ped:

Image Added

Informe os parâmetros para filtrar os pedidos de venda:

Image Added

Informe o número do pedido e-commerce para o filtro e a data e hora do envio do rastreio. A data e hora não compõem o filtro dos pedidos de venda. Esses dados serão gravados no pedido de venda.

Image Added

Duplo clique na linha do pedido para seleção da linha:

Image Added

Duplo clique na coluna Rastreio para apresentação da tela de inclusão do rastreio e envio. Digite o rastreio e mantenha marcada a caixa Enviar status:

Image Added

O código do rastreio será enviado para o site da Loja Ciashop. Selecion Ok para fechar a janela de aviso e Sair para fechar a tela de rastreio:

Image Added

Para consultar os dados do rastreio no pedido de venda:

Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:

Image Added

A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:

Image Added

Role a barra de rolagem Vertical para visualizar os dados do rastreio:

Image Added

Menu

SigaLoja.xnu

Submenu

E-commerce

Nome da Rotina

Monitor Serv. Ciashop

Programa

LOJA906

Módulo

SigaLoja

Tipo

Função Protheus

Menu

SigaLoja.xnu

Submenu

E-commerce

Nome da Rotina

Grava/Envia Rastreio Ped.

Programa

LOJA900I

Módulo

SigaLoja

Tipo

Função Protheus

Procedimento para Utilização

11111

Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
Localização da rotina no menu;
Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

2. Posicione o cursor em um produto e clique em Alterar.

3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

6. Confira os dados e confirme.

Acesse o site CiaShop para inclusão do pedido CiaShop:
http://totvsdev.myciashop.com.br/:

Image Removed

2. Na caixa de texto [ Pesquise seu produto... ] digite o produto e clique em buscar:

Image Removed

3. Clique no botão [ Comprar ]:

Image Removed

4. Clique no botão [ Continuar comprando ]:

Image Removed

5. Digite um novo produto (p.ex. TELEFONE SEM FIO) e clique em buscar:

Image Removed

6. Clique no botão [ Comprar ]:

Image Removed

7. Clique no botão [ Ir para o carrinho ]:

Image Removed

8. Digite o CEP e clique no botão [ calcular ] para cálculo do Frete:

Image Removed

9. Clique no botão [ FECHAR PEDIDO ]:

Image Removed

10. Digite um e-mail válido e clique no botão [ Continuar ]:

Image Removed

11. Digite uma Senha válida e clique no botão Continuar:

Image Removed

12. Clique no botão [ Usar este endereço ]:

Image Removed

13. Selecione uma Forma de Pagamento (p. ex. Depósito Bancário) e clique no botão [ concluir compra ]:

Image Removed

14. Clique em Autorizar e Fechar Compra:

Image Removed

15. Será apresentada uma tela de pedido confirmado:

Image Removed

16. Um e-mail é enviado confirmando o recebimento do pedido:

Image Removed

17. Entre com novos pedidos seguindo os passos de 2 - 16 escolhendo no item 13 as formas de pagamento: cartão de crédito e faturado.

Image Removed

18. Digite o número do cartão, código de segurança e clique no botão [ Autorizar e Fechar Compra ]:

Image Removed

19. Inclua novo pedido e selecione a forma de pagamento Faturado. Clique em [ concluir compra ]:

Image Removed

20. Instale e configure o aplicativo Postman. Este aplicativo será utilizado para consultar os pedidos CiaShop utilizando as APIs da CiaShop:

Image Removed

21. Clique no aplicativo Postman – Rest Client:

Image Removed

22. Clique na aba Headers, digite a informações abaixo e clique no botão [ Send ] para visualizar os pedidos digitados anteriormente:

Image Removed

23.Utilize a API abaixo para consultar um pedido de venda CiaShop (p. ex.: 522) digitado anteriormente:

https://totvsdev.myciashop.com.br/api/v1/orders/522

24. Utilize a API abaixo para consultar um pedido de venda CiaShop digitado anteriormente:

https://totvsdev.myciashop.com.br/api/v1/orders/522/orderitems

25. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) :

Image Removed

26. Posicione no último pedido de venda gravado (p. ex.: 000160):

Image Removed

27. No Controle de Loja (SIGALOJA), acesse E-commerce > Monitor Serv. CiaShop (LOJA906):

NOTA IMPORTANTE !!! – NÃO UTILIZAR O SIGAMDI PARA EXECUTAR ESTA ROTINA !!!

28. Clique na linha LOJA901A – Pedidos e clique no botão [ Executar ]:

Image Removed

29. Aguarde o término da execução da sincronização de dados com a CiaShop:

Image Removed

30. Sincronização efetuada com sucesso:

Image Removed

31. Clique no botão Log para consultar o Log de execução da rotina Pedidos:

Image Removed

32. Clique no botão [Detalhes]:

Image Removed

33. Clique no botão [ Cons Tracker ] para consultando o Tracker dos pedidos:

Image Removed

34. Digite o número do pedido e-commerce para consulta do tracker:

Image Removed

35. Clique no botão [+] para expandir a consulta do tracker:

Image Removed

36. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) :

37. Visualizando o pedido de venda gerado:

Image RemovedImage Removed

38. Consultando o número e o status do pedido e-commerce (00=Gerado):

Image Removed

39. No Controle de Loja (SIGALOJA), acesse Atualizações / Gerencia Finanças / Baixas a Receber (FINA070), Posicione no título a ser baixado e clique na opção Baixar :

Image Removed

40. Clique no botão [Confirmar] para confirmar a baixa do título:

Image Removed

41. Clique no botão Sair:

Image Removed

42. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) posicione no pedido de venda e verifique o status do pedido (10=Pagamento confirmado) cujo título a receber foi baixado:

Image Removed

43. Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:

Image Removed

44. No Controle de Loja (SIGALOJA), acesse E-commerce > Monitor Serv. CiaShop (LOJA906) posicione na linha LOJA900E – Status de Pedidos e clique no botão [Executar]:

Image Removed

45. Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resultado (=sucesso).

46. Recebimento e-mail de pagamento aprovado:

Image Removed

47. Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:

Image Removed

48. No Faturamento (SIGAFAT), acesse Atualizações / Faturamento / Documento de Saida (MATA460) selecione os itens a faturar e clique na opção Prep.docs:

Image Removed

49. Ajustes os parâmetros e clique no botão OK para confirma-los. Seleciona a série e nota:

Image Removed

50. Confirme a geração da nota clicando nos botões OK:

Image Removed

51. Clique no botão sair para sair da preparação do documento.

52. No Faturamento (SIGAFAT), acesse Atualizações / Pedidos / Pedidos de venda (MATA410) E verifique o status do pedido (30=Enviado) de venda que teve o seu título a receber baixado:

Image Removed

53. No Controle de Loja (SIGALOJA), acesse E-commerce / Monitor Serv. CiaShop posicione na linha LOJA900E – Status de Pedidos e clique no botão executar:

Image Removed

54. Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resutado (=sucesso).

55. Recebimento e-mail de pedido enviado:

Image Removed

56. Visualizando o status do pedido e-commerce 520 pela ferramenta Postman:

Image Removed

57. Altere ou mantenha a data base do sistema para que os pedidos CiaShop sejam processados partir desta data:

Image Removed

nota: se o parâmetro MV_DIASRET (numero de dias a retroceder da data de processamento) estiver diferente de 0 (zero) a data será retroagida (p. ex.: = 2 data do sistema 21/09/2016 será retroagida para 19/09/2016).

58. No Controle de Loja (SIGALOJA), acesse Atualizaçoes / E-commerce / Acesso Token CiaShop::

Image Removed

59. Será apresentada a tela para inclusão, alteração, visualização e exclusão da chave de acesso loja ao CiaShop. Clique na opção Incluir:

Image Removed

60. Após Incluir/Alterar clique no botão Fechar:

Image Removed

nota: Por segurança o conteúdo da Chave Token foi modificado. Solicite uma nova chave de acesso a CiaShop.

61. Processando pedidos Cancelados/Aprovados CiaShop

62. Pelo aplicativo Postman verifique o status dos pedido de venda CiaShop (cancelado):

Image Removed

63. No Controle de Loja (SIGALOJA), acesse Atualizaçoes / E-commerce / Monitor Serv. CiaShop posicione na linha LOJA900K - Status Ped.Canc./Aprov e clique no botão Executar:

Image Removed

64. Após a execução da rotina Status Ped.Canc./Aprov (cancelamento pedido CiaShop 542) os dados do pedido de venda (SC5/SC6/SC9), financeiro contas a receber (SE1), orçamento (SL1/SL2) deverão ser excluídos do sistema:

Image Removed

65. Processando pedidos Cancelados/Aprovados CiaShop

66. Pelo aplicativo Postman verifique o status dos pedido de venda CiaShop (aprovado):

Image Removed

67. No Controle de Loja (SIGALOJA), acesse Atualizaçoes / E-commerce / Monitor Serv. CiaShop posicione na linha LOJA900K - Status Ped.Canc./Aprov e clique no botão Executar:

Image Removed

68. Após a execução da rotina de aprovação do pedido CiaShop 546 os dados do pedido de venda (SC5/SC6/SC9), financeiro (SE1), orçamento (SL1/SL2) deverão ser ajustados no sistema:

Antes:

Image Removed

Depois:

Image Removed

O status do pedido de venda (C5_STATUS) será alterado de 05 - Em análise para 10 - aprovado;

O pedido de venda será liberado para Faturamento (C9_QTDLIB = 1);

O título a receber no Financeiro será baixado.

69. Mantenha posicionada a linha da rotina LOJA900K e clique no botão Log:

Image Removed

70. Clique no botão Detalhes para visualizar os detalhes do LOG:

Image Removed

70. No Controle de Loja (SIGALOJA), acesse Atualizaçoes / E-commerce / Grava/envia Rastreio Ped :

Image Removed

71. Informe os parâmetros para filtro dos pedidos de venda e clique no botão OK:

Image Removed

72. Serão apresentados os pedidos de venda conforme filtro digitado anteriormente:

Image Removed

72. Duplo clique na caixa de seleção do pedido de venda a ser digitado o rastreio:

Image Removed

73. Duplo clique na linha selecionada e na coluna Rastreio:

Image Removed

74. Digite o rastreio, desmarque/marque a caixa para Enviar o status de pedido para CiaShop e clique no botão OK:

Image Removed

75. Clique no botão Ok para fechar a janela de pedido enviado com sucesso:

Image Removed

76. Clique na opção Sair:

Image Removed

77. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) :

Image Removed

78. Clique na opção Visualizar e observe os conteúdos dos campos Ped. E-Com, Status E-com e Rastr.:

Image Removed

nota: as vinte primeiras posição do rastreio são utilizadas para guardar o rastreio digitado e as demais posição são utilizada para gravar a data e hora informados nos parâmetros.

79. No Controle de Loja (SIGALOJA), acesse AtualizaçÕes / E-commerce / Consult.Pedido.Financeiro (LOJA900M) :

Image Removed

80. Forneça os parâmetros de filtro para os pedidos de venda e clique no botão Ok:

Image Removed

81. Clique na opção Legenda para visualizar os diferentes status dos pedidos de venda:

Image Removed

82. Posiciona em um pedido de venda e clique na opção Ações Relacionadas >> Consulta Financeiro:

Image Removed

83. Clique no botão Fechar para sair da tela de consulta financeiro:

Image Removed

84. Duplo clique na linha do pedido de venda apresenta a tela de visualização do pedido de venda. Clique no botão fechar para sair da rotina:

Image Removed

Vídeo

Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Título do Vídeo:	Disponibilizado pelo Marketing.
Introdução:	Disponibilizado pelo Marketing.
Passo a Passo:	Capturar diretamente do sistema.
Finalização:	Disponibilizado pelo Marketing.

Ponto de Entrada

Descrição:

Informe o Menu em que estará localizada a rotina

Localização:

Informe o Submenu em que estará localizada a rotina

Eventos:

Informe o Título da rotina

Programa Fonte:

Informe o Fonte da rotina

Função:

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Retorno:

Nome	Tipo	Descrição	Obrigatório

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

aCab[4][2]:= 'NF' //Validações do usuário

EndIf

Return aCab

Árvore de páginas

Versões comparadas

Versão antiga 49

Nova versão Atual

Chave

Integração Protheus x CiaShop Utilização do Token

Características do Requisito

Descrição

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Configuração

Procedimento para Utilização:

Procedimento para Utilização

Vídeo

Ponto de Entrada

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 49

Nova versão Atual

Chave

Integração Protheus x CiaShop Utilização do Token

Características do Requisito

Descrição

Importante

Procedimento para Implantação

Atualizações do Compatibilizador

Procedimento para Configuração

Procedimento para Configuração

Procedimento para Utilização:

Procedimento para Utilização

Vídeo

Ponto de Entrada