Escolar Documentos
Profissional Documentos
Cultura Documentos
MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN
Criado por Pedro Ivo Lobo da Silva, última alteração por Rene Julian Mirabal Lascano em 06 jul, 2017
Segmento: Varejo.
Módulo: SigaLoja.
Rotina:
Rotina Nome Técnico
Pedidos LOJA901A
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_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/)
País(es): Brasil.
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:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 1/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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
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:
1. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a opção Integridade/Verificação (APCFG60A).
2. 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.
3. 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;
4. 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).
5. Nestes casos descritos nos itens “iii” ou “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
6. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme instruções.
7. 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!
1. 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
___/___/____.
2. Clique em OK para continuar.
3. 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().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
a. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela.
b. 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.
c. Clique em Gravar para salvar o histórico (log) apresentado.
d. Clique em OK para encerrar o processamento.
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 2/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
1. Aplique o patch do chamado e execute uma vez a rotina CiaShop.
2. 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:
Tipo: C
Valor Padrão: 30
Tipo: L
Tipo: N
Descrição: Numero de dias a retroceder na data de processamento dos pedidos de venda CiaShop aprovados/cancelado.
Valor Padrão: 0
Tipo: C
Tipo: C
Atualizações do Compatibilizador
Pergunte (X1_PERGUNT)
Nome
Grupo (X1_GRUPO)
Ordem (X1_ORDEM)
Tipo (X1_TIPO)
Tamanho (X1_TAMANHO)
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 3/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Campo MH6_FILIAL
Tipo C
Tamanho 8
Decimal 0
Formato @!
Título Filial
Nível 0
Usado Sim
Obrigatório Sim
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH6_PDECOM
Tipo C
Tamanho 10
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH6_STATUS
Tipo C
Tamanho 2
Decimal 0
Formato
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 4/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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
Campo MH6_PEDORI
Tipo C
Tamanho 6
Decimal 0
Formato @!
Título Ped.Ori.Loja
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH6_CANORI
Tipo C
Tamanho 35
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 5/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Campo MH6_HRRAST
Tipo C
Tamanho 8
Decimal 0
Formato @!
Título Hr Rastreio
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH6_DTRAST
Tipo C
Tamanho 8
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH8_FILIAL
Tipo C
Tamanho 8
Decimal 0
Formato @!
Título Filial
Nível 0
Usado Sim
Obrigatório Sim
Browse Sim
Opções
When
Relação
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 6/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Val. 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
Campo MH8_NUM
Tipo C
Tamanho 15
Decimal 0
Formato @!
Título Ped.Protheus
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH8_PEDECO
Tipo C
Tamanho 10
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 7/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Relação
Val. Sistema
Campo MH8_DOCPED
Tipo C
Tamanho 10
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
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
Campo MH8_ORCAME
Tipo C
Tamanho 10
Decimal 0
Formato @!
Título No Orcamento
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 8/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Relação
Val. Sistema
Campo MH8_PRODUT
Tipo C
Tamanho 15
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH8_STAPRO
Tipo C
Tamanho 2
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH8_STACIA
Tipo C
Tamanho 2
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 9/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Relação
Val. Sistema
Campo MH8_MOTIVO
Tipo C
Tamanho 2
Decimal 0
Formato @!
Título Mot.Err.Suce
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo MH8_DESMOT
Tipo C
Tamanho 10
Decimal 0
Formato @!
Título Descr.Mot.ES
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C5_DTRASTR
Tipo D
Tamanho 8
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 10/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C5_HRRASTR
Tipo C
Tamanho 8
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C5_ECPEORI
Tipo C
Tamanho 15
Decimal 0
Formato @!
Título E-com.Ped.Or
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C5_ECCAORI
Tipo C
Tamanho 25
Decimal 0
Formato @!
Título E-Com.Ca.Ori
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 11/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Opções
When
Relação
Val. Sistema
Campo C9_PEDECOM
Tipo C
Tamanho 15
Decimal 0
Formato @!
Título Ped.E-Commer
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C9_ECPEORI
Tipo C
Tamanho 15
Decimal 0
Formato @!
Título E-com.Ped.Or
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo C9_ECCAORI
Tipo C
Tamanho 25
Decimal 0
Formato @!
Título E-Com.Ca.Ori
Nível 0
Usado Sim
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 12/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo LJ_URL
Tipo C
Tamanho 150
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Campo LJ_TOKEN
Tipo M
Tamanho 10
Decimal 0
Formato @!
Nível 0
Usado Sim
Obrigatório Não
Browse Sim
Opções
When
Relação
Val. Sistema
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
Alias (XB_ALIAS)
Tipo (XB_TIPO)
Sequência (XB_SEQ)
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 13/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Coluna (XB_COLUNA)
Descrição (XB_DESCRI)
Contém (XB_CONTEM)
Índice MH6
Ordem 1
Chave MH6_FILIAL+MH6_PDECOM
Proprietário U
Índice MH6
Ordem 2
Chave MH6_FILIAL+MH6_PEDORI
Proprietário U
Índice MH8
Ordem 1
Chave MH8_FILIAL+MH8_SEQ
Descrição Sequencia
Proprietário U
Tipo C
Tipo C
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:
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
1. 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)
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 14/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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
Itens/Pastas Descrição
Nome: MV_LJECSTF
Tipo: C
Cont. Por.: 30
Itens/Pastas Descrição
Nome: MV_LJECDNF
Tipo: C
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
Programa LOJA906
Módulo SigaLoja
Menu SigaLoja.xnu
Submenu E-commerce
Programa LOJA900K
Módulo SigaLoja
Menu SigaLoja.xnu
Submenu E-commerce
Programa LOJA901F
Módulo SigaLoja
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 15/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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
Na caixa nome do App, preencher um nome do aplicativo. Sugerimos o nome Protheus. Por fim, clicar no botão Gerar Token.
Na lista de aplicativos, procure o App criado e, em seguida, clique no botão Copiar Token:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 16/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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".
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 17/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Caso a Chave ou a Url não esteja de acordo ao tentar utilizar a consulta Traker o sistema apresenta a mensagem de erro.
http://totvsdev.myciashop.com.br/:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 18/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Digite o CEP e clique no botão [ calcular ] para cálculo do Frete e Clique no botão [ FECHAR PEDIDO ]:
Selecione uma Forma de Pagamento (p. ex. Depósito Bancário) e clique no botão [ concluir compra ]:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 19/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 20/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Entre com novos pedidos seguindo os passos anteriores selecionando outras formas de pagamento: cartão de crédito e faturado.
Digite o número do cartão, código de segurança e clique no botão [ Autorizar e Fechar Compra ]:
Inclua novo pedido e selecione a forma de pagamento Faturado. Clique em [ concluir compra ]:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 21/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Aguarde o processamento do pedido:
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 ]:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 22/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 23/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 24/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) e visualize o pedido de venda gerado:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 25/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 26/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 27/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:
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]:
Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resultado (=sucesso).
Recebimento e-mail de pagamento aprovado:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 28/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop:
No Faturamento (SIGAFAT), acesse Atualizações / Faturamento / Documento de Saida (MATA460) selecione os itens a faturar e clique na opção Prep.docs:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 29/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
No Controle de Loja (SIGALOJA), acesse E-commerce / Monitor Serv. CiaShop posicione na linha LOJA900E – Status de Pedidos e clique no botão executar:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 30/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Após a sincronização dos dados na loja virtual observe a coluna último sincronismo e resutado (=sucesso).
Recebimento e-mail de pedido enviado:
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
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 31/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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:
Para incluir um produto, digite na caixa de texto o código do produto em seguida clique no botão buscar:
Digite o Cep, selecione calcular para cálculo do Frete e selecione Fechar Pedido:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 32/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Cartão de Crédito
Faturado
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 33/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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.
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 34/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Ainda posicionado na linha LOJA901A - Pedidos selecione botão Cons Tracker para consultar o Tracker do pedido de venda:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 35/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Pedido de Venda
Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:
A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:
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:
Título a Receber
Pelo módulo Controle de Lojas, acesse a opção Atualizações >> Gerencia Financas >> Contas a Receber:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 36/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Role a tela até encontrar o título a receber ou pesquise o título a receber conforme tela abaixo e selecione Visualizar:
Reserva
Pelo módulo Controle de Loja, acesse a opção Atualização >> Gerência Vendas >> Controle Reservas:
Selecione Visualizar:
Orçamento
Pelo módulo Controle de Loja, acesse a opção Atualizaçs >> Atendimento >> Venda Assistida:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 37/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
A sincronização dos dados com a loja virtual Ciashop x Protheus será processado.
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.
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 38/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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:
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:
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:
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:
Pedido de Venda
Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 39/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:
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:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 40/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 41/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Pedido de Venda
Pelo módulo Faturamento, acesse a opção Atualizações >> Pedidos >> Pedidos de venda:
A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 42/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 43/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Selecione Ações Relacionadas para consultar o financeiro (título a receber) do pedido de venda:
Duplo clique na linha do pedido de venda apresenta a tela de visualização do pedido de venda:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 44/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
A sincronização dos dados com a loja virtual Ciashop x Protheus será processado.
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:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 45/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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:
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:
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:
Role a tela até encontrar o título a receber ou pesquise o título a receber conforme tela abaixo:
Reserva
Pelo módulo Controle de Loja, acesse a opção Atualização >> Gerência Vendas >> Controle Reservas:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 46/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
Role a tela até encontrar o título a receber ou pesquise a reserva conforme tela abaixo:
Orçamento
Pelo módulo Controle de Loja, acesse a opção Atualizações >> Atendimento >> Venda Assistida:
Role a tela até encontrar reserva ou pesquise o título a receber conforme tela abaixo:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 47/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
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.
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:
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:
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 48/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:
A tela de pedidos de venda será apresentada. Posicione no último pedido de venda e selecione opção Visualizar:
Vídeo
Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
Ponto de Entrada
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
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 49/50
23/08/2018 MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN - Linha Microsiga Protheus - TDN
documento_tecnico ciashop versao_11_80 todos_paises varejo mp_varejo_inov
evidencia_varejo sigaloja integracao integracao_ciashop
token_não_cadastrado_para_a_filial_corrente
http://tdn.totvs.com/display/public/PROT/MVAR-852_DT_INTEGRACAO_PROTHEUS_X_CIASHOP_TOKEN 50/50