Histórico da Página
Integração Protheus x CiaShop Utilização do Token
Características do Requisito
Linha de Produto: | Protheus - CiaShop. | ||||||||||||||||||||
Segmento: | Varejo. | ||||||||||||||||||||
Módulo: | SigaLoja. | ||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||
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á criada 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 PlaceA 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 ) A falta desse registro na tabela SAE 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
Se o pedido de venda for cancelado (status 90 - cancelled) no site da loja
A rotina LOJA900K processa os pedidos de venda aprovados e/ou cancelados no site da Loja CiashopA 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 ficam 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.
Rotina para aprovar ou cancelar pedidos de venda CiaShop MarketPlace.
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
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o UPDLO168 é 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:
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.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - 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.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
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_DIASRETLJECDIR |
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: |
Nome da Variável: | MV_LJECURL |
Tipo: | C |
Descrição: | Endereço Url dos dados da NFe E-commerce CiaShop. |
Valor Padrão: |
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:
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) | TOKEN ACESSO LOJAS NO CIASHOP (X2_NOME) | E (X2_MODO) | N (X2_PYME) |
Chave | Nome | Modo | PYME |
MH8MH6 (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 - TOKEN ACESSO LOJAS AMARRAÇÃO DADOS NO CIASHOP:
Campo | MH6_URL FILIAL |
Tipo | C |
Tamanho | 1508 |
Decimal | 0 |
Formato | @! |
TítuloURL CiaShop | Filial |
DescriçãoURL CiaShop | Filial do Sistema |
Nível | 0 |
Usado | Sim |
Obrigatório | Sim |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
HelpDescreva o conteúdo informado para Help de Campo no ATUSX | Filial do Sistema. |
Campo | MH6_TOKEN PDECOM |
Tipo | MC |
Tamanho | 10 |
Decimal | 0 |
Formato | @! |
TítuloChave Token | Ped E-Com. |
DescriçãoChave Token Acesso CiaSho | Ped E-Commerce |
Nível | 0 |
Usado | Sim |
Obrigatório | SimNão |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Chave de acesso lojas (Token)Código do pedido de venda E-commerce. |
Campo | MH6_FILIALSTATUS |
Tipo | C |
Tamanho | 82 |
Decimal | 0 |
Formato | @! |
Título | Filial Status Pedid |
Descrição | Filial do Sistema Status Pedido |
Nível | 0 |
Usado | Sim |
Obrigatório | SimNão |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help Filial do Sistema. |
- Tabela MH8 - EC CIASHOP LOG STA.PED.CAN.APR:
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 | |
Campo | MH8_SEQ |
Tipo | C |
Tamanho | 1020 |
Decimal | 0 |
Formato | @! |
Título | Sequencia Rastreio |
Descrição | Sequencia Rastreio |
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 LOGCódigo do rastreio Correios. |
Campo | MH8MH6_NUM PEDORI |
Tipo | C |
Tamanho | 156 |
Decimal | 0 |
Formato | @! |
Título | Ped.Ori.Protheus Loja |
Descrição | Pedido Protheus Origem Loja/MktPla |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
HelpNúmero do pedido de venda ou número do título a receber. | Pedido Origem Loja ou Market Place |
Campo | MH8MH6_PEDECO CANORI |
Tipo | C |
Tamanho | 1035 |
Decimal | 0 |
Formato | @! |
Título | Ped E-Comerc Canal Origem |
Descrição | Pedido E-Comerce 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 AmericanasNúmero do pedido de E-Commerce associado ao pedido de venda. |
Campo | MH8MH6_DOCPED HRRAST |
Tipo | C |
Tamanho | 108 |
Decimal | 0 |
Formato | @! |
Título | Nota Fiscal Hr Rastreio |
Descrição | Nota Fiscal Hora Rastreio |
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)Hora de envio do código do rastreio para o site da loja Ciashop. |
Campo | MH8MH6_SERPED DTRAST |
Tipo | C |
Tamanho | 38 |
Decimal | 0 |
Formato | @! |
TítuloSerie | Dt. Rastreio |
Descrição | Serie Data de Rastreio |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
HelpSérie da nota fiscal do pedido de venda ou série do orçamento (SL1). | 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_ORCAME FILIAL |
Tipo | C |
Tamanho | 108 |
Decimal | 0 |
Formato | @! |
Título | No Orcamento Filial |
Descrição | Numero do Orcamento Filial do Sistema |
Nível | 0 |
Usado | Sim |
Obrigatório | NãoSim |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Número do orçamento (SL1)Filial do Sistema. |
Campo | MH8_PRODUT SEQ |
Tipo | C |
Tamanho | 1510 |
Decimal | 0 |
Formato | @! |
Título | Cod. Produto Sequencia |
Descrição | Codigo do Produto Sequencia |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Código do produtoSequencial de gravação item de LOG. |
Campo | MH8_STAPRONUM |
Tipo | C |
Tamanho | 215 |
Decimal | 0 |
Formato | @! |
TítuloStatus Proth | Ped.Protheus |
Descrição | Status do Pedido Protheus |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Status Número do pedido de venda Potheusou número do título a receber. |
Campo | MH8_STACIAPEDECO |
Tipo | C |
Tamanho | 210 |
Decimal | 0 |
Formato | @! |
TítuloStat CiaShop | Ped E-Comerc |
Descrição | Status CiaShop Pedido E-Comerce |
Nível | 0 |
Usado | Sim |
Obrigatório | Não |
Browse | Sim |
Opções | |
When | |
Relação | |
Val. Sistema | |
Help | Status Número do pedido CiaShop atrelado de E-Commerce associado ao pedido de venda Potheus. |
Campo | MH8_MOTIVODOCPED |
Tipo | C |
Tamanho | 210 |
Decimal | 0 |
Formato | @! |
TítuloMot.Err.Suce | Nota Fiscal |
Descrição | Motivo Erro ou Sucesso Nota Fiscal |
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 CiaShopNúmero da nota fiscal do pedido de venda ou documento do orçamento (SL1). |
Campo | MH8_DESMOTSERPED |
Tipo | C |
Tamanho | 103 |
Decimal | 0 |
Formato | @! |
TítuloDescr.Mot.ES | Serie |
Descrição | Descricao Motivo Err/Suce Serie |
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 SC9 - Pedidos Liberados
Série da nota fiscal do pedido de venda ou série do orçamento (SL1). |
Campo | MH8_ORCAME | ||
Campo | C9_PEDECOM | ||
Tipo | C | ||
Tamanho | 10 | ||
Decimal | 0 | ||
Formato | @! | ||
Título | Ped.E-Commer | No Orcamento | |
Descrição | Numero do Orcamento | 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. |
- Tabela SE1 - Contas a Receber
Número do orçamento (SL1). |
Campo | E1MH8_PEDECOM PRODUT |
Tipo | C |
Tamanho | 1015 |
Decimal | 0 |
Formato | @! |
Título | Ped.E-Commer Cod. Produto |
Descrição | Pedido E-Commerce Codigo do Produto |
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. |
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:
Índice | SC5 |
Ordem | 6 |
Chave | C5_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
U
Índice
MH6
Ordem
1
Chave
MH6_FILIAL
Descrição
Filial
Proprietário
U
Índice
MH8
Ordem
1
Chave
MH8_FILIAL+MH8_SEQ
Descrição
Sequencia
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:
Índice | MH6 |
Ordem | 1 |
Chave | MH6_FILIAL+MH6_PDECOM |
Descrição | Filial+Ped E-Com. |
Proprietário | U |
Índice | MH6 |
Ordem | 2 |
Chave | MH6_FILIAL+MH6_PEDORI |
Descrição | Filial+Pedido Orig. |
Proprietário | U |
Í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 |
Nome da Variável | MV_LJECDNF |
Tipo | C |
Descrição | Endereco Url Danfe da NFe E-commerce CiaShop. |
Valor Padrão |
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.: | |
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:
Na caixa de texto [ Pesquise seu produto... ] digite o produto e clique em buscar: Clique no botão [ Comprar ]: Clique no botão [ ir para o carrinho ]: Digite o CEP e clique no botão [ calcular ] para cálculo do Frete e Clique no botão [ FECHAR PEDIDO ]: Digite um e-mail válido e clique no botão [ Continuar ]: Digite uma Senha válida e clique no botão Continuar: Clique no botão [ Usar este endereço ]: Selecione uma Forma de Pagamento (p. ex. Depósito Bancário) e clique no botão [ concluir compra ]: Clique em Autorizar e Fechar Compra: Será apresentada uma tela de pedido confirmado: Um e-mail é enviado confirmando o recebimento do pedido: 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 ]: Aguarde o processamento do pedido:
3. Baixando Pedido de Venda do site da Loja CiaShop para o Protheus No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) : Posicione no último pedido de venda gravado (p. ex.: 000160): 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 ]: Aguarde o término da execução da sincronização de dados com a CiaShop: Sincronização efetuada com sucesso: Clique no botão Log para consultar o Log de execução da rotina Pedidos: Clique no botão [Detalhes]: Clique no botão [ Cons Tracker ] para consultando o Tracker dos pedidos: Digite o número do pedido e-commerce para consulta do tracker: Clique no botão [+] para expandir a consulta do tracker: No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) e visualize o pedido de venda gerado: Consultando o número e o status do pedido e-commerce (00=Pedido Colocado): 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 : Clique no botão [Confirmar] para confirmar a baixa do título: Clique no botão Sair: 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: 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: 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: Ajustes os parâmetros e clique no botão OK para confirma-los. Seleciona a série e nota: Confirme a geração da nota clicando nos botões OK: 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: No Controle de Loja (SIGALOJA), acesse E-commerce / Monitor Serv. CiaShop 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 resutado (=sucesso). Recebimento e-mail de pedido enviado: Visualizando o status do pedido e-commerce 520 pela ferramenta Postman: 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:
Para incluir um produto, digite na caixa de texto o código do produto em seguida clique no botão buscar:
Para comprar o produto informe a quantidade e clique em comprar:
Selecione Ir para o carrinho:
Digite o Cep, selecione calcular para cálculo do Frete e selecione Fechar Pedido:
Selecione Usar este endereço e continuar:
Selecione uma das formas de pagamento e concluir a compra: Depósito Bancário
Cartão de Crédito
Faturado
Aguarde o processamento do pedido:
Na tela de pedido confirmado selecione Voltar para página principal:
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: Os pedidos de venda na loja Ciashop serão sincronizados com o Protheus: 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. Selecione o botão detalhes: Observe o número do pedido e-commerce e role a barra de rolagem à direita: Selecione voltar para retornar a tela Monitor de serviços E-commerce: Ainda posicionado na linha LOJA901A - Pedidos selecione botão Cons Tracker para consultar o Tracker do pedido de venda: Digite o número do pedido E-commerce (680) gerado anteriormente e selecione Ok: Selecione Fechar para sair da tela do Tracker: 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: Role a barra de rolagem vertical para visualizar os demais campos: 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: 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: Selecione Fechar para sair da tela Controle Reservas: Orçamento Pelo módulo Controle de Loja, acesse a opção Atualizaçs >> Atendimento >> Venda Assistida: Role a barra de rolagem até o orçamento desejado e selecione Visualizar: Selecione o botão Sair para fechar a tela de orçamento: 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: 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. Aprovação do pedido de venda Tomando como exemplo o pedido de venda E-commerce 000680, importado anteriormente, e cancelado pela rotina temos: 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: 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: 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: A tela de parâmetros é apresentada. Preencha os parâmetro e confirme selecionando o botão OK: 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: Marque, com duplo-clique, o item a fatuar e clique no botão Prep. docs: Preencha os parâmetros necessários: Selecione a Série, número da nota e clique em ok: Clique no botão Ok para confirmar a geração da nota: Aguarde a geração da nota fiscal: Selecione a opção Ações Relacionadas para visualizar a legenda: Selecione a opção Sair para fechar a tela de prepração de nota: 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: Recebimento de e-mail confirmação pedido de venda enviado: 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: Informe os parâmetros necessários para compor o filtro: Selecione a opção Legenda para visualizar os status dos pedidos de venda: Selecione Ações Relacionadas para consultar o financeiro (título a receber) do pedido de venda: Selecione o botão Fechar para sair da tela de consulta Financeiro: Duplo clique na linha do pedido de venda apresenta a tela de visualização do pedido de venda: Role a barra de rolagem horizontal/vertical para visualizar os demais campos:
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: 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: Digite o pedido E-commerce cancelado: Será apresentada a mensagem abaixo: 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: 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: Informe os parâmetros para filtrar os pedidos de venda: 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 linha do pedido para seleção da linha: 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: Para consultar os dados do rastreio no 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: 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 dados do rastreio: |
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 |
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/: 2. Na caixa de texto [ Pesquise seu produto... ] digite o produto e clique em buscar: 3. Clique no botão [ Comprar ]: 4. Clique no botão [ Continuar comprando ]: 5. Digite um novo produto (p.ex. TELEFONE SEM FIO) e clique em buscar: 6. Clique no botão [ Comprar ]: 7. Clique no botão [ Ir para o carrinho ]: 8. Digite o CEP e clique no botão [ calcular ] para cálculo do Frete: 9. Clique no botão [ FECHAR PEDIDO ]: 10. Digite um e-mail válido e clique no botão [ Continuar ]: 11. Digite uma Senha válida e clique no botão Continuar: 12. Clique no botão [ Usar este endereço ]: 13. Selecione uma Forma de Pagamento (p. ex. Depósito Bancário) e clique no botão [ concluir compra ]: 14. Clique em Autorizar e Fechar Compra: 15. Será apresentada uma tela de pedido confirmado: 16. Um e-mail é enviado confirmando o recebimento do pedido: 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. 18. Digite o número do cartão, código de segurança e clique no botão [ Autorizar e Fechar Compra ]: 19. Inclua novo pedido e selecione a forma de pagamento Faturado. Clique em [ concluir compra ]: 20. Instale e configure o aplicativo Postman. Este aplicativo será utilizado para consultar os pedidos CiaShop utilizando as APIs da CiaShop: 21. Clique no aplicativo Postman – Rest Client: 22. Clique na aba Headers, digite a informações abaixo e clique no botão [ Send ] para visualizar os pedidos digitados anteriormente: 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) : 26. Posicione no último pedido de venda gravado (p. ex.: 000160): 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 ]: 29. Aguarde o término da execução da sincronização de dados com a CiaShop: 30. Sincronização efetuada com sucesso: 31. Clique no botão Log para consultar o Log de execução da rotina Pedidos: 32. Clique no botão [Detalhes]: 33. Clique no botão [ Cons Tracker ] para consultando o Tracker dos pedidos: 34. Digite o número do pedido e-commerce para consulta do tracker: 35. Clique no botão [+] para expandir a consulta do tracker: 36. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) :
37. Visualizando o pedido de venda gerado: 38. Consultando o número e o status do pedido e-commerce (00=Gerado): 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 : 40. Clique no botão [Confirmar] para confirmar a baixa do título: 41. Clique no botão Sair: 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: 43. Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop: 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]: 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: 47. Consultado o pedido e-commerce 520 pela ferramenta Postman poderemos visualizar o status do pedido no CiaShop: 48. No Faturamento (SIGAFAT), acesse Atualizações / Faturamento / Documento de Saida (MATA460) selecione os itens a faturar e clique na opção Prep.docs: 49. Ajustes os parâmetros e clique no botão OK para confirma-los. Seleciona a série e nota: 50. Confirme a geração da nota clicando nos botões OK: 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: 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: 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: 56. Visualizando o status do pedido e-commerce 520 pela ferramenta Postman: 57. Altere ou mantenha a data base do sistema para que os pedidos CiaShop sejam processados partir desta data: 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:: 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: 60. Após Incluir/Alterar clique no botão Fechar: 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): 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: 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: 65. Processando pedidos Cancelados/Aprovados CiaShop 66. Pelo aplicativo Postman verifique o status dos pedido de venda CiaShop (aprovado):
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: 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: Depois: 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: 70. Clique no botão Detalhes para visualizar os detalhes do LOG: 70. No Controle de Loja (SIGALOJA), acesse Atualizaçoes / E-commerce / Grava/envia Rastreio Ped : 71. Informe os parâmetros para filtro dos pedidos de venda e clique no botão OK: 72. Serão apresentados os pedidos de venda conforme filtro digitado anteriormente: 72. Duplo clique na caixa de seleção do pedido de venda a ser digitado o rastreio: 73. Duplo clique na linha selecionada e na coluna Rastreio: 74. Digite o rastreio, desmarque/marque a caixa para Enviar o status de pedido para CiaShop e clique no botão OK: 75. Clique no botão Ok para fechar a janela de pedido enviado com sucesso: 76. Clique na opção Sair: 77. No Faturamento (SIGAFAT), acesse Atualizações /Pedidos / Pedidos de Venda (MATA410) : 78. Clique na opção Visualizar e observe os conteúdos dos campos Ped. E-Com, Status E-com e Rastr.: 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) : 80. Forneça os parâmetros de filtro para os pedidos de venda e clique no botão Ok: 81. Clique na opção Legenda para visualizar os diferentes status dos pedidos de venda: 82. Posiciona em um pedido de venda e clique na opção Ações Relacionadas >> Consulta Financeiro: 83. Clique no botão Fechar para sair da tela de consulta financeiro: 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:
|
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: |
|
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