Sumário
|
01.
...
Visão Geral
Este documento visa demonstrar o procedimento para configuração da integração do TOTVS Food Service PDV com o KDS Ninegrid
...
Desenvolvido a integração com o KDS Pluginbot(Ninegrid), onde os pedidos realizados no PDV, serão integrados e exibidos no KDS Pluginbot(Ninegrid) e também será possível realizar pedidos no Smart Order(Pluginbot) para que seja integrado com o PDV e exibido no KDS.
02.
...
Exemplo de Utilização
Quaisquer pedidos que sejam realizados no TOTVS Food Service PDV, seja Balcão, Mesa, Cartão, Comanda eletrônica, Pedidos Online, serão integrados e poderão ser visualizados diretamente no site do KDS Ninegrid.
03. Pré-requisitos
Sistema
- Versão do TOTVS Food Service PDV 2.28.01 ou superior.
...
Quando efetuado um pedido pelo operador no PDV, este pedido será enviado e exibido no KDS Pluginbot(Ninegrid).
Quando for feito o Pedido no Pluginbot(Ninegrid), este pedido será exibido no KDS e sincronizado junto ao PDV.
03. PRÉ - REQUISITOS
- Versão do TOTVS Chef PDV 2.27.05 ou superior;
- Instalação do executável "IntegracaoPedidosOnlineIntranet"
Instalação do ASP.NET Core Runtime 3.1.5 ou superior e Desktop Runtime 3.1.5 ou superior.
- Windows 7 SP1 ou superior
- A loja deverá possuir “Pedidos Intranet” na licença.
Image Removed
- .
- TOTVS Plataforma.IO
- TOTVS.Service.Notification
04. Instalando e configurando o TOTVS Plataforma IO
...
Totvs custom tabs box |
---|
tabs | Passo 1: Instalação Pedidos Online, Passo 2: Instalação Plataforma IO,Passo 32: Ativando o serviços do Plataforma IO |
---|
ids | passo1,passo2,passo3 |
---|
|
Totvs custom tabs box items |
---|
default | yesno |
---|
referencia | passo1 |
---|
| Executar o IntegracaoPedidosOnlineIntranet (De acordo com a versão instalado do TOTVS Chef PDV). Clique em "Avançar"' Image Removed
Clique em "Instalar" Aguarde a instalação finalizar. Image Removed
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Na pasta extraída do download; Executar como "ADMINISTRADOR" o executável "Totvs.PlataformaIO.exe"; Deixe o caminho padrão "c:\ms\Totvs.PlataformaIO"; Clique em "Next" e concluir a instalação. ![](/download/attachments/553882861/image2020-4-16_17-37-12.png?version=1&modificationDate=1593110612663&api=v2)
![](/download/attachments/553882861/image2020-4-16_17-37-25.png?version=1&modificationDate=1593110612623&api=v2)
![](/download/attachments/553882861/image2020-4-16_17-37-35.png?version=1&modificationDate=1593110612570&api=v2)
![](/download/attachments/553882861/image2020-4-16_17-37-48.png?version=1&modificationDate=1593110612537&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3passo2 |
---|
| Na pasta extraída do download; Executar como "ADMINISTRADOR" o executável "Totvs.PlataformaIO-ActivateService.exe" Verifique se o serviço "Totvs PlataformaIO" está em execução; ![](/download/attachments/553882861/image2020-4-16_17-39-14.png?version=1&modificationDate=1593110612497&api=v2)
Para validação se o serviço esta rodando corretamente; Abrir no navegador o seguinte link "http://localhost:5070/swagger/index.html" Deverá abrir a página conforma abaixo: Image Removed
|
|
05. Configurações
Após as instalações feitas no passo anterior , vamos agora fazer as configurações para funcionamento.
...
05. Configurações
Locais de impressão do KDS
Abra o aplicativo de configurações do TOTVS Food Service PDV, o Configurações.exe:
Image Added
Faça o login utilizando as credencias de usuário Master:
Image Added
Acesse a aba Monitor e marque para cada tela do TOTVS Food Service PDV o local de impressão desejado. Por exemplo:
Na tela de mesa, caso esteja marcada a opção BAR, todos os pedidos da tela mesa que possuírem produtos configurados para o ponto de produção BAR serão enviado ao KDS Bar.
Image Added
Configuração de Cadastro de Produtos
Totvs custom tabs box |
---|
tabs | Passo 1: Configurações Aba Monitor do configuraçõesCadastro de Produtos(Retaguarda Web) , Passo 2: Configurações do Cadastro de produtos (ChefWeb)Retaguarda Local |
---|
ids | passo1Passo1,passo2,passo3Passo2 |
---|
|
Totvs custom tabs box items |
---|
default | yesno |
---|
referencia | passo1 | | Passo1 |
---|
| Acesse o TOTVS Food Service Retaguarda Web Acesse o menu cadastros de produtos Image Added
Após acessar o cadastro de produtos, escolha o produto que deseja configurar para imprimir no KDS ,e clique em editar. Image Added
Após realizar o passo anterior, vá até a aba Geral e marque a opção imprimir no monitor. Image Added
Clique no menu Locais de impressão e selecione o local de impressão que desejar. Image Added
Agora basta clicar em salvar. Image Added
IMPORTANTE: Caso você ainda não possua o TOTVS Food Service Retaguarda Web, este processo deverá ser realizado na retaguarda local. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | Passo2 |
---|
| Acesse o Retaguarda Local. Image Added
Acesse o sistema informando as credenciais de acesso do mesmo: Image Added
Acesse o menu Cadastros>Produto>Produtos Image Added
Selecione o produto que deseja alterar e depois selecione o local de impressão desejado. Image Added
Acesse a aba geral e marcar a opção Imprimir monitor Image Added
Acesse o menu Operações >Gravar Dados na Ficha. Image Added
|
|
Ninegrid
No sistema Ninegrid, é necessário criar os setores internos, os KDS e vinculá-los.
- Acessar o site: https://totvsfood.ninegrid.com.br/dashboard e logar com as credencias de acesso.
- Acessar o menu Configurações-> Locais e cadastrar as informações requeridas
- Acessar o menu Configurações->Locais novamente, clicar em editar e cadastre o setor interno.
IMPORTANTE: O Id do setor Interno deve ser enviado ao responsável pelas configurações da integração na plataforma de integrações.
- Acessar o menu Smart Order→KDS
- Cadastrar KDS
- Vincular KDS com o Setor Interno anteriormente cadastrado.
06. Configurações Portal de Integrações
IMPORTANTE: Este procedimento deverá ser solicitado inicialmente ao time de P&D para a fase de pilotos e posteriormente ao time comercial que deverá receber os seguintes parâmetros para realizar as configurações:
User = Usuário de acesso ao Ninegrid
pass = Senha de acesso ao Ninegrid
LocationID = ID do setor interno(Passo anterior)
Para configuração no Portal de integrações, basta seguir os seguintes passos:
Totvs custom tabs box |
---|
tabs | Passo 1: Acessar o SIte Plataforma, Passo 2: Acessar Menu Estabelecimento, Passo 3: Efetuar o Cadastro do Estabelecimento, Passo 4: Acessar Menu IntegraçãoEstabelecimento, Passo 5: Localizando Loja, Passo 6: Adicionando a Integradora,Passo 7: Adicionando os Parametros |
---|
ids | passo1,passo2,passo3,passo4,passo5,passo6,passo7 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Acessar o site Plataforma - https://integracaofoodservicesui.azurewebsites.net/ Efetue o Login. Image Added
Para que os pedidos feitos no PDV, sejam enviados para o KDS(Pluginbot),vamos fazer algumas configurações no configurações.exe, seguindo os seguintes passos Execute o configurações .exe Image Removed
Fazer o login com usuário master(9999) e senha do dia Image Removed
Após realizar o login, vamos acessar aba monitor Image Removed
Após acessar esta aba, iremos marcar habilitado para as telas do PDV que desejamos que seja enviado o pedido para o KDS, e em seguida iremos marcar o ponto de produção no qual desejamos que seja impresso. Por exemplo: Caso eu marque habilitado na tela mesa e também marque a opção bar, todos os pedidos da tela mesa que possuírem produtos configurados para o ponto de produção bar será impresso. No próximo passo iremos configurar os produtos para imprimir no ponto de produção. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Após realizar as Configurações da aba monitor do aplicativo configurações.exe, vamos agora configurar os produtos para imprimir no ponto de produção, seguindo os seguintes passos: Acesse o menu cadastros de produtos Image Removed
Após acessar o cadastro de produtos, escolha o produto que deseja configurara para imprimir no KDS ,e clique em editar Image Removed
Após realizar o passo anterior, vá ate a aba Gera e verifique e marque a opção imprimir no monitor Image Removed
Após seguir realizar o procedimento descrito no passo anterior, clique no menu Locais de impressão e selecione o local de impressão que deseja que o produto seja impressora. Image Removed
Feito isso basta clicar no menu salvar. Image Removed
OBS : Caso você ainda não possua o chefweb , este processo desacrito aciam será realizado no retaguarda local, porem se já realizou no chef web não realizar no retaguarda local novamente. Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 | Selecione o Menu "Estabelecimento" Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Efetue o cadastro do estabelecimento na plataforma, informando os seguinte dados abaixo: Licença - Informar a licença da máquina onde está habilitado a licença do "Pedidos Online"; PC - Informar o PC da máquina onde está habilitado a licença do "Pedidos Online", neste campo para o PC de um digito (EX: PC01, PC02 ...), não deverá informar o "0" a esquerda (ex: PC1); Nome - Informar o Nome Fantasia da Loja; CNPJ - Informar o CNPJ da loja. Clique em "REGISTRAR". Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Selecione o menu "Integração" > "Integração Estabelecimento" Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Informe o "CNPJ" da loja e aperte a tecla "ENTER". Image Added
Uma lista com todos os PCS relacionados será carregada. Escolha o PC e clique em "Selecionar". Image Added
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo6 |
---|
| Após realizar o procedimento do passo anterior será exibida a tela da imagem abaixo onde o usuário, para adicionara a integradora deverá clicar no Botão "+" , conforme imagem abaixo. Image Added
Após clicar no Botão "+", sera exibido a tela abaixo Image Added
Para selecionar a integradora KDS-Ninegrid, deverá ser preenchido os seguintes dados - Tipo Operação = KDS - Fluxo do Pedido = Saída - Integração =KDS-Ninegrid - Descrição = "Texto livre onde cliente pode preencher o que desejar" |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo7 |
---|
| Após realizar o procedimento do passo 6, a integradora será adicionada conforme imagem abaixo, onde iremos adicionar os parâmetros. Para adicionar os parâmetros basta clicar no menu Editar, conforme destacado na imagem abaixo. Image Added
Após clicar no menu editar, será exibido a seguinte tela baixo onde será disponibilizado 4 parâmetros sendo eles : - user = este dado será fornecido pela Ninegrid
- pass = este dado será fornecido pela Ninegrid
- locationId = este numero será obtido ao cadastrar o setor no portal Ninegrid
- urlOrder = https://api.ninegrid.com.br/2.0/order
Após o preenchimento dos parâmetros acima basta clicar no menu ativar , conforme ilustrado na imagem abaixo Image Added
|
|
07. Procedimento no Portal Ninegrid
Após realizar o todos os procedimentos citados acima, vamos agora ao procedimento final que consiste no cadastro do KDS no portal Ninegrid.
Para realizar o cadastro do KDS , vamos primeiro acessar o portal Ninegrid pelo link https://totvsfood.ninegrid.com.br/login , posteriormente colocar usuário e senha.
Image Added
Após realizar o login , conforme orientado acima, vamos acessar agora o menu Smart Order > KDS.
Image Added
Após acessar o menu KDS ,vamos ser redirecionados para pagina abaixo, onde teremos a lista de KDS já cadastrados e teremos o o menu Cadastrar KDS, para cadastrar um novo KDS vamos clicar no mesmo.
Image Added
Após clicar no menu citado acima seremos direcionados para pagina abaixo, onde vamos preencher os seguintes dados.
- Nome: Texto no qual define o nome do KDS , aqui temos que ter uma atenção maior pois só podemos cadastrar um KDS cujo nomes são iguais aos locais impressão do TOTVS CHEF , caso seja cadastrado um nome no qual não exista no TOTVS Chef o pedido não saíra no KDS
- Status : Aqui podemos selecionar os status nos quais o KDS irá possuir.
- Login: Usuário no qual terá acesso ao KDS, aqui podemos selecionar o usuário ou cadastrar um novo.
- Layout do KDS:
- Tamanho da fonte: tamanho da letra na qual será exibida no KDS.
- Quantidade: Quantidade de colunas que será exibida no KDS .
- Tamanho dos Cards: Tamanhos dos cartões do KDS.
- Locais: Aqui vamos selecionar locais que desejamos que seja exibido o o pedido. Ex: Se macada a opção retirada todos os pedidos oriundos do local retirada será exibido no KDS.
Image Added
Após preencher os dados acima basta clicar no botão salvar conforme destacado na imagem abaixo.
Image Added
Por fim o KDS será exibido na lista de KDS.
Image Added
HTML |
---|
<!-- esconder o menu -->
<style>
div.theme-default .ia-splitter #main {
margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
display: none;
}
#main {
padding-left: 10px;
padding-right: 10px;
overflow-x: hidden;
}
.aui-header-primary .aui-nav, .aui-page-panel {
margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
margin-left: 0px !important;
}
</style>
|