Í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:
|
title | 1. Hierarquia de dados |
---|
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.
Abaixo serão apresentadas funcionalidades para solução Omni channel presentes nas soluções:
Abaixo rotinas e telas pertinentes ao Pluginbot - WebApp:
title | 1. Rotinas do Pluginbot - WebApp |
---|
Abaixo rotinas e telas pertinentes ao TOTVS Varejo Franquias e Redes - Connector:
title | 1. Rotinas do TOTVS Varejo Franquias e Redes – Connector |
---|
RESULTADO DA CONSULTA:
Na rotina Global → Administração → Reprocessar Ticket Connector, é possível colocar na fila tickets já processados.
TELA DE PESQUISA:
TELA DO RESULTADO:
Informações |
---|
Documentação Consulta dinâmica para visualizar o consumo do Connector |
Abaixo segue rotinas e telas pertinente ao TOTVS Varejo Franquias e Redes - Customer:
title | 1. Rotinas do TOTVS Franquias e Redes – Customer |
---|
Informações |
---|
Abaixo rotinas e telas pertinentes ao TOTVS Varejo Franquias e Redes - Retaguarda:
title | 1. Rotina para acompanhamento dos Pedidos |
---|
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;
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;
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.
|
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. |
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. |
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.
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:
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
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.
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 lojatitle | 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?"
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.
As validações e informações necessárias para geração da Nota fiscal:
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:
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 |
---|
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 |
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.
Para visualizar ou resgatar um Pedido Omni, entre na opção Pré-venda onde será possível identificar os pedidos do Omni disponíveis para emissão de cupom fiscal:
title | 2. Troca/Devolução Omni |
---|
No PDV na opção de Troca e Devolução, efetue a devolução normalmente:
Após informar os dados da devolução, será apresentada a opção para seleção dos Motivos de devolução exclusivos da Omni.
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 |
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) |
---|
3. Pelo Menu Superior <Opções> ou pela coluna Opções (...), a loja deve alterar o Status do Pedido para <Em Separação>.
4. Ao clicar no botão (+) é possível visualizar informações referente aos Produtos participantes do Pedido para efetuar a separação:
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:
title | 2. Ship from store (Envio pela Loja) |
---|
4. Ao clicar no botão (+) é possível visualizar informações referentes aos Produtos participantes do Pedido para efetuar a separação:
8. Caso os dados da Nota estejam todos corretos, a loja deverá clicar em Gerar Nota Fiscal:
9. A loja pode acompanhar o status da NF-e pela rotina Fiscal → Notas Fiscais:
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:
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.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