Histórico da Página
CONTEÚDO
| Índice | ||||||
|---|---|---|---|---|---|---|
|
| Extrair | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1. Visão Geral
2. Estrutura Principal - Client e Server
2.1 Arquitetura do SistemaAbaixo segue a estrutura e entre RETAGUARDA Server e Client:
2.2 Configurações TOTVS Varejo Franquias e Redes - RetaguardaAbaixo as configurações pertinentes ao TOTVS Varejo Franquias e Redes - Retaguarda: Expandir | | ||||||||||||||||||||
| |||||||||||||||||||||
| Informações | |||||||||||||||||||||
| Expandir | |||||||||||||||||||||
|
| Informações |
|---|
Documentação Publicação dos métodos do Motor |
2.4 Configurações TOTVS Varejo Franquias e Redes - Customer
Abaixo configurações pertinentes ao TOTVS Varejo Franquias e Redes - Customer:
| title | 1. Configurações TOTVS Varejo Franquias e Redes - Customer |
|---|
As configurações pertinentes ao Customer, foram informadas neste documento no índice 2.2 Configurações TOTVS Varejo Franquias e Redes - Retaguarda.
Com essas configurações, os pedidos estarão disponíveis no PDV de forma online.
| Informações |
|---|
2.5 Configurações Webapp Pluginbot
Abaixo configurações pertinentes ao Webapp Pluginbot:
| title | 1. Configurações Webapp Pluginbot |
|---|
https://manual.ninegrid.com.br/index.php/varejo/
As parametrizações iniciais devem ser do passo 1 até o passo 8:
2.6 Configurações TOTVS Varejo Franquias e Redes - PDV
As Configurações TOTVS Varejo Franquias e Redes -PDV não são necessárias. Após todas as configurações citadas nos índices "2.2 Configurações TOTVS Varejo Franquias e Redes - Retaguarda" e "2.4 Configurações TOTVS Varejo Franquias e Redes - Customer", o PDV está apito para uso resgatar os Pedidos de venda Omni.
3. Telas e utilização
Abaixo serão apresentadas funcionalidades para solução Omni channel presentes nas soluções:
- TOTVS Varejo Franquias e Redes – Connector;
- TOTVS Varejo Franquias e Redes – Retaguarda;
- TOTVS Varejo Franquias e Redes – Customer;
- Pluginbot - WebApp
3.1 Rotinas do Pluginbot - WebApp
Abaixo rotinas e telas pertinentes ao Pluginbot - WebApp:
| title | 1. Rotinas do Pluginbot - WebApp |
|---|
3.2 Rotinas do TOTVS Varejo Franquias e Redes – Connector
Abaixo rotinas e telas pertinentes ao TOTVS Varejo Franquias e Redes - Connector:
| title | 1. Rotinas do TOTVS Varejo Franquias e Redes – Connector |
|---|
No TOTVS Varejo Franquias e Redes - Retaguarda, no domínio compartilhado ou central, acesso Relatórios e Consultas → Consultas Dinâmicas → Outros → Consumo Connector:
Este relatório irá apresentar o consumo de uso para um determinado Sistema satélite, o consumo de uso por método:TELA DE FILTRO
RESULTADO DA CONSULTA:
Esta rotina normalmente é usada em caso de falha na integração que precise reenviar dados para o sistema externo:
TELA DE PESQUISA:
TELA DO RESULTADO:
| Informações |
|---|
Documentação Consulta dinâmica para visualizar o consumo do Connector |
3.3 Rotinas do TOTVS Varejo Franquias e Redes – Customer
Abaixo segue rotinas e telas pertinente ao TOTVS Varejo Franquias e Redes - Customer:
| title | 1. Rotinas do TOTVS Franquias e Redes – Customer |
|---|
Como já mostrado neste documento, as soluções do Webapp Pluginbot, Retaguarda e PDV se integram com o Customer.
| Informações |
|---|
3.4 Rotinas do TOTVS Varejo Franquias e Redes – Retaguarda
Abaixo rotinas e telas pertinentes ao TOTVS Varejo Franquias e Redes - Retaguarda:
| title | 1. Rotina para acompanhamento dos Pedidos |
|---|
Será exibida a rotina:
Opções da tela:Menu Superior:
Filtrar: Pesquisar os pedidos baseados nos parâmetros desejados
Opções: Detalhes do Pedido, Imprimir, Alterações de Status do Pedido,
Sair: Fechar a tela
OPÇÕES DE PESQUISA
Status do Pedido: Selecionar o status dos pedidos que deseja visualizar, abaixo explicativo de cada Status:
Em aberto = Pedido recebido da Plataforma Pluginbot que a loja precisa iniciar o atendimento | Operação exclusiva pela Pluginbot;;
Pedido Recebido = Pedido Confirmado pela Loja, porém , ainda não baixou no PDV | Operação exclusiva pelo Retaguarda;
Confirmado Loja = Pedido Confirmado pela Loja e já baixado para o PDV | Operação exclusiva pelo Retaguarda;
Envio pela Loja = Pedido que será Emitido NF-e, não ocorre interação com PDV | Operação exclusiva pelo Retaguarda;
Faturado = Cupom Fiscal Emitido no PDV | Operação Exclusiva do PDV;
Em Faturamento = PDV recuperou o Pedido e está finalizando o Cupom | Operação Exclusiva do PDV;
Em separação = Pedido está sendo separado pela Loja | Operação exclusiva pelo Retaguarda;
Cancelado = Pedido cancelado pela loja (Pode ocorrer | Operação pode ocorrer na Pluginbot, Retaguarda ou PDV;
Período de Emissão: Informe o Período que deseja pesquisar;
Unidade de negócio: Informe as unidades que deseja pesquisar. Caso não informado, serão consideradas todas;
Permite Atualização Automática?: Quando selecionado, o sistema irá atualizar a tela considerando o intervalo de tempo selecionado. Ao selecionar esta opção a rotina irá considerar a data do dia atual e os status "Em Aberto" e "Em Separação". A intenção desta funcionalidade é apresentar à loja, os pedidos que estão chegando da Pluginbot e que precisem de ação da loja;
Intervalo de Atualização: Intervalo que a atualização automática irá atualizar a tela;RESULTADO DA PESQUISA
N. do Pedido: Retornar o Número do Pedido | Obrigatório;
Unidade Negócio: Nome da Unidade de Negócio | Obrigatório;
Canal: Nome do canal de venda usado no Pedido | Obrigatório;
Modalidade: Modalidade da venda usada no pedido | Obrigatório;
Data: Retornar a Data e Hora do Pedido | Obrigatório;
Valor Total: Valor total do Pedido | Obrigatório;
Identificação do Cliente: CPF do cliente da venda | Não Obrigatório;
Tipo de Entrega: Tipo de entrega "Retira Loja" ou "Envio pela Loja" | Obrigatório;
Pedido Pago: "Pago" ou "Em aberto". Atualmente todo Pedido deve vir pago | Obrigatório;
Status do Pedido: Status Atual do Pedido | Obrigatório;
DISTONÍVEL NA COLUNA "N. PEDIDO":
Ao clicar no botão
será possível visualizar informações referentes ao Pagamento e Produtos participantes do Pedido:
Integração de dados que são enviados para o PDV:
Integração de dados que são recebidos do PDV:
Para as baixas no PDV, existe um controle de tempo de baixa para cada tipo de integração para cada loja, ou seja, mesmo o serviço sendo executado no PDV a cada 10 minutos, o server pode não ter disponibilizado a informação para que a baixa aconteça. As configurações atuais (podem sofrer alteração) estão da seguinte forma:
Na tabela lotecontrole e LoteControleExterno (PDV Omni) é controlado a última baixa de cada loja para identificar se poderá disponibilizar novos dados para baixa.
|
3. Arquitetura de Dados
| Expandir | ||
|---|---|---|
| ||
Conceito de Franquias e Redes:
O acesso aos dados é controlado hierarquicamente, ou seja, os dados que pertencem à uma central ou a máster não podem ser visualizados por uma entidade que esteja abaixo na árvore de hierarquia se os dados forem privados. Porém se estes dados são públicos a visualização é possível. |
Integração com sistemas TOTVS
Abaixo será apresentado outras soluções TOTVS que fazem parte do ecossistema do RETAGUARDA:
| Expandir | ||
|---|---|---|
| ||
SOLUÇÕES ENVOLVIDAS:
TVFR Report Service (Relatórios):
TVFR Fiscal Cloud: TVFR GDI:
TVFR Fidelidade:
Pela integração 200 destacada no item 5.3 deste documento, , ocorre o envio de dados de Produtos e Lojas para o Fidelidade via API. TVFR Mozart (Mensageria): Solução de mensageria responsável por gerenciar, receber e enviar "mensagens" que serão integradas entre sistemas.
|
5. Integração com soluções Externas - Boticário
5.1 Diretório da integração
A pasta IntegracaoLive é o diretório onde atualmente estão as integrações que temos no Boticário.
Antigamente elas ficavam no diretório IntegracaoSAP. Ainda temos na pasta integração SAP alguns serviços que são utilizados pela Associação do Boticário, por esse motivo, ao gerar um pacote das integrações, também temos que incluir essa Solution IntegracaoSAP.
5.2 Taskmananger - Gerenciador de tarefas
Existe um Controller para cada integração que faz o papel de um middler entre o TaskManager e o código da integração.
Dentro da pasta Queue do Taskmanager existe um executável chamado Bematech.IntegracaoLive.ExecutaTarefas.exe, que é chamado pelas tarefas do Taskmanager, ou seja, nos arquivos de configuração dentro da pasta Tasks, onde as rotinas de cada integração serão executadas:
Pasta queue:
5.3 Mapeamento das Integrações
Abaixo segue a solução de integração com o número da tarefa do taskmananger:
Retail App - O Retail APP é a solução do parceiro TOTVS para apresentar os principais cockpits de forma mobile.
(10001) Venda
(10002) Pagamento
(10003) Estoque
(10004) Operadores
Loja Associação (Inativa)
(901) Preço
(900) Produto
(903) Pré-Venda
(902) Cliente
(904) Situação Pré-Venda
(905) Estoque
Hana - Integração com o Hana do Boticário.
(1100) Cupom (A cada 1 minuto)
(1101) Vendas SellOut (A cada 1 minuto)
(1102) Cancelamento Vendas SellOut (A cada 1 minuto)
(1103) Devolução Vendas SellOut (A cada 1 minuto)
(1110) Cancelamento (A cada 1 minuto)
(1120) Devolução (A cada 1 minuto)
(1130) Cancelamento Devolução (A cada 1 minuto)
(1140) GiftCard (A cada 1 minuto)
(1150) Redução Z (A cada 2 minutos)
(1160) Reprocessamento (A cada 2 minutos)
(1170) NFCe (A cada 2 minutos)
(1180) Autorização - (Inativa)
(1190) Fechamento - (Inativa)
Exemplo de Fluxo de integração com HANA:
NeoGrid - Integração de Pedidos
(4000) Gerar, processa e Consulta Ticket (A cada 10 minutos)
Gera
(1398) Nota Fiscal Recebimento (A cada 1 minuto)
(1400) Nota Fiscal Processamento (A cada 1 minuto)
(1399) Nota Fiscal Envio Status (A cada 1 minuto)
(1403) Cancelamento Nota Fiscal Recebimento (A cada 2 minutos)
(1401) Cancelamento Nota Fiscal Processamento (A cada 2 minutos)
(1404) Cancelamento Nota Fiscal Envio Status (A cada 2 minutos)
(1500) Estoque (A cada 2 minutos)
(1502) Reprocessamento Estoque (A cada 2 minutos)
(1501) Inventário (A cada 2 minutos)
(1503) Reprocessamento Inventário (A cada 2 minutos)
(1405) Impostos Produtos (A cada 2 minutos)
(1402) Processamento Títulos Financeiros (A cada 5 minutos)
Exemplo de integração com Gera:
SAP - Integração com o SAP Boticário
(600) Enviar Inclusão Programações Condições Pagamento Pedido (A cada 10 minutos)
(601) Receber Condições Pagamento (A cada 30 minutos)
(400) Recebe Franquias - Lojas (A cada120 minutos)
(100) Inclusão Pedido (A cada 2 minutos)
(101) Alteração Pedido (A cada 2 minutos)
(102) Cancelamento Pedido (A cada 10 minutos)
(103) Posição Ordem Venda Pedido (A cada 10 minutos)
(104) Restrição de Produtos para Pedido (A cada 60 minutos)
(200) Produto e envio de Loja e Produto ao TVFR Fidelidade (A cada 60 minutos)
(300) Preço (A cada 30 minutos)
(500) Receber Distribuidores (A cada 360 minutos)
Exemplo do fluxo de integração de Pedido:
Usuário - Botiweb (extranet)
(402) Usuários
Usuários - IDEA
(403) Consulta Usuário IDEA
(404) Inserir Usuário IDEA
(405) Alterar Usuário IDEA
(406) Consulta Lista Usuário IDEA
(407) Consulta Lista Domínios IDEA
(408) Alterar Campos Usuário IDEA
Estoque
(4002) Receber Estoque para inventário (Sob demanda)
(4003) Processar Estoque para inventário (A cada 10 minutos)
(4004) API Consulta Saldo do Estoque de determinada Loja
5.3 Tabelas e Logs das integrações
A tabela InterfaceIntegracao é uma tabela de configuração das integrações e APIs e dentre várias possibilidades de configurações uma delas é a coluna “Ativo”, que determina se uma integração está ativa ou não.
Ao desativar uma determinada interface, o processo dela continua rodando no Taskmanager, porém o código da mesma não é executado, pois existe no inicio do código uma validação para identificar se a integração está ativa.
Exemplo de log de uma determinada interface desativada:
Conforme exemplo mostrado, o log é gravado na tabela logintegracao e é possível referenciar na coluna tipomodulo o código da integração. Este código é o mesmo informado em cada uma das integrações deste documento.
Algumas integrações podem não gravar informações nesta tabela devido a não nescessidade.
As tabelas ticket e conteudoticket são usadas para dados enviados nas integrações com SAP, gravando o conteúdo enviado ou recebido.
Coluna Opções (...): Opções disponíveis para o Pedido:Detalhes do Pedido: É possível clicar nesta opção para visualizar maiores informações do Pedido:
Imprimir: Opção para Imprimir o pedido em impressora matricial. Usado para colocar em conjunto com a mercadoria separada:
Imprimir (Impressora Térmica): Opção para Imprimir o pedido em impressora térmica, está opção necessita ter o PDV instalado no computador. Usado para colocar em conjunto com a mercadoria separada:
ALTERAÇÃO DE STATUS DO PEDIDO
Alterar Status: Em Separação: A loja está validando se possui os produtos físicos da lojaAlterar Status: Confirmado: A loja tem os produtos físico e já efetuou a separação. Este pedido irá ficar disponível no PDV e na Plataforma Pluginbot é confirmado pela loja.
Alterar Status: Envio Pela loja: A loja tem os produtos físicos e já efetuou a separação. Será aberta a rotina de NF-e para emissão da nota e na Plataforma Pluginbot é confirmado pela loja.
Alterar Status: Cancelado: A loja não tem os produtos físicos ou não irá conseguir atender o pedido. Na Plataforma Pluginbot é notificado o cliente do cancelamento do Pedido e irá ocorrer o estorno do cartão;
Todas estas opções também estão disponíveis no Menu Superior Opções, deixando a critério do usuário escolher onde usar.
| title | 2. Pedido Omni - Emissão de NF-e |
|---|
Na rotina Comercial → Pedido de Venda Omni, é possível emitir uma NF-e para os pedidos do tipo: "Envio pela Loja".
Ao consultar os pedidos existentes e selecionar a opção "Alterar Status: Envio pela Loja" para algum dos pedidos listados, o Retaguarda irá apresenta a mensagem de alerta:
"Atenção: Esta opção irá gerar uma Nota Fiscal para este Pedido. Deseja continuar?"
Se o usuário clicar em Não, a mensagem é fechada e nenhuma ação é executada, caso o usuário clique na opção Sim, as informações necessárias para a geração da Nota Fiscal são coletadas do Pedido Omni e a tela de Manutenção de Documentos Fiscais é aberta com a Nota Fiscal carregada e pronta para ser emitida:
Confirmando a geração da Nota Fiscal, as informações necessárias para a geração da Nota Fiscal começam a ser validadas do Pedido.
- Parâmetros configurados: "9259 Série Padrão para Pedido Omni" e "9258 Tipo de Documento Padrão para Pedido Omni";
- Dados do Emitente e destinatário (Loja e Cliente) estão de acordo com o Retaguarda;
- Se todos os Itens, Quantidades e valores estão de acordo;
Caso todos os requisitos estejam de acordo, a tela de Manutenção de Documentos Fiscais é aberta com as informações da Nota preenchidas:
Totais dos Itens:
Itens da Nota Fiscal:
Caso o pedido possua Frete, este valor será exibido na aba de Despesas da Nota Fiscal:
Caso o tipo de documento esteja selecionado para "Gerar Financeiro", será apresentado Informações das Parcelas do Financeiro:
Não será permita nenhuma alteração nos dados da Nota fiscal, caso as informações estejam corretas, clique em Gerar da Nota Fiscal:
Após Geração da Nota Fiscal, a tela é fechada e o status do Pedido é alterado para "Envio pela Loja":
Após este processo, o status do Pedido é enviado para Pluginbot para confirmar a entrega do pedido para o cliente.
| Informações |
|---|
| title | 3. Consulta Analítica - Canal de Venda |
|---|
As vendas feitas pelo PDV estarão com o campo Canal de venda como "PDV" e as originadas pela PLuginbot estarão com o campo Canal de vendas como "Omni".
Abaixo um exemplo de resultado destacando esta coluna:
Atualmente somente esta consulta possui informações do canal de venda e que pode diferenciar as vendas originadas pela solução Omni.
| title | 4. Cadastro de Motivo de Devolução Omni |
|---|
Na rotina Comercial → Cadastros → Motivos, é necessário efetuar o cadastro dos Motivos de devolução da solução Omni:
No processo de devolução no PDV, este Motivo ficará disponível para seleção.
| Informações |
|---|
Documentação Na rotina de Motivos - Novo Tipo de Devolução de Pedido OMS |
3.5 Rotinas do TOTVS Varejo Franquias e Redes – PDV
Abaixo segue rotinas e telas pertinente ao TOTVS Varejo Franquias e Redes - PDV:
| title | 1. Resgate do Pedido |
|---|
Para notificar a loja que existe(m) pedido(s) pendente(s), o PDV mostrará a quantidade de pedidos pendentes no ícone de sacola na parte superior da tela.
O Cliente deve ter o número do Pedido em mãos para que seja possível identificá-lo de forma mais simples. Após a Seleção do pedido, Clique na opção OK:
Será exibida a mensagem se deseja informar o CPF do cliente:
Após esta mensagem, o pedido será lançado automaticamente até a finalização da Venda e emissão do Cupom Fiscal:
| title | 2. Troca/Devolução Omni |
|---|
No PDV na opção de Troca e Devolução, efetue a devolução normalmente:
Caso não exista nenhum motivo cadastrado, esta tela não será apresentada.
| Informações |
|---|
Documentação Solicitar motivo de devolução para vendas finalizadas com resgate Omni |
4. Operação de loja com Pedido: Retira Loja e Envio pela Loja
Abaixo será apresentado o processo de como a loja deverá operar com os pedidos para Retira na loja ou envio pela loja:
| title | 1. Pickup in Store (Retira Loja) |
|---|
1. Assim que o pagamento do pedido for aprovado, o pedido será enviado na integração para que a loja identifique o pedido.2. O usuário da loja via TOTVS Varejo Franquias e Redes - Retaguarda pelo domínio Central ou loja na rotina Comercial → Pedido de Venda Omni, deverá encontrar os pedidos com Status "Em Aberto", isto é, pedidos que precisam de confirmação da loja. Deve se atentar na coluna "Tipo de Entrega" que deve estar preenchido como "Retira loja":
3. Pelo Menu Superior <Opções> ou pela coluna Opções (...), a loja deve alterar o Status do Pedido para <Em Separação>.
5. Após separação do Pedido, a loja poderá efetuar a impressão do pedido para anexá-la a mercadoria:
6. A loja deverá confirmar o Pedido ou Rejeitá-lo , alterando seu Status:
.7. Caso a loja tenha confirmado o Pedido, este pedido ficará disponível no PDV em até 10 minutos e o Pedido será atualizado na Pluginbot notificando o cliente que seu pedido está disponível para retirada.
8. Quando o cliente chegar para retirar a mercadoria portando o número do pedido. No PDV, a loja deverá clicar em "Pré-Venda" e digitar o número do pedido para encontrá-lo:
9. Após encontrar o Pedido a loja finaliza a Pré-venda e entrega a mercadoria e o Cupom Fiscal ao Cliente:
10. No Retaguarda e Pluginbot o status do Pedido será atualizado para concluído.
| title | 2. Ship from store (Envio pela Loja) |
|---|
1. Assim que o pagamento do pedido for aprovado, o pedido será enviado na integração para que a loja identifique o pedido.2. O usuário da loja via TOTVS Varejo Franquias e Redes - Retaguarda pelo domínio Central ou loja na rotina Comercial → Pedido de Venda Omni, deverá encontrar os pedidos com Status "Em Aberto", isto é, pedidos que precisam de confirmação da loja. Deve se atentar na coluna "Tipo de Entrega" que deve estar preenchido como "Envio pela Loja":
3. Pelo Menu Superior <Opções> ou pela coluna Opções (...), a loja deve alterar o Status do Pedido para <Em Separação>.
5. Após separação do Pedido, a loja poderá efetuar a impressão do pedido e adicioná-la à mercadoria:6. A loja deverá confirmar o Pedido ou Rejeitá-lo, alterando seu Status:
.7. Caso a loja tenha confirmado o Pedido pelo status "Envio loja (95)", o sistema irá iniciar o processo de geração de NF-e, lembrando que este pedido não integra com o PDV:
10. O pedido terá seu status atualizado para "Envio pela loja" e este status será atualizado na Pluginbot, confirmando que a entrega do Pedido será realizada:
5. Pré-requisitos funcionais
Para que a solução de Pedidos de Venda Omni esteja disponível com as configurações acima, os produtos utilizados devem estar com as versões mínimas:
6. Pré-Requisitos Não funcional
6.1 Criação Space PluginBot
Para criação do ambiente e integração com as lojas , é de responsabilidade do parceiro a geração e a criação de uma nova space.
Para isso, as seguintes informações devem ser enviadas para o parceiro:
Código de loja
Chave da sua loja
ID da Integração
Código Estabelecimento
Código Sistema Satélite
Código Integração
Request ID
Usuário e Senha
WSDL da Integração
URL da RestAPI Motor Promoção
Host da integração
URL da Integração
URL da RestAPI para Consultas Promoção
URL da RestAPI para Lista Status do Pedido
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas