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.
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
04. Instalando e configurando o TOTVS Plataforma IO
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. 



|
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; 
|
|
05. Configurações
Locais de impressão do KDS
Abra o aplicativo de configurações do TOTVS Food Service PDV, o Configurações.exe:

Faça o login utilizando as credencias de usuário Master:

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.

Configuração de Cadastro de Produtos
Acesse o TOTVS Food Service Retaguarda Web Acesse o menu cadastros de produtos 
Após acessar o cadastro de produtos, escolha o produto que deseja configurar para imprimir no KDS ,e clique em editar. 
Após realizar o passo anterior, vá até a aba Geral e marque a opção imprimir no monitor. 
Clique no menu Locais de impressão e selecione o local de impressão que desejar. 
Agora basta clicar em salvar. 
IMPORTANTE: Caso você ainda não possua o TOTVS Food Service Retaguarda Web, este processo deverá ser realizado na retaguarda local. |
Acesse o Retaguarda Local. 
Acesse o sistema informando as credenciais de acesso do mesmo: 
Acesse o menu Cadastros>Produto>Produtos 
Selecione o produto que deseja alterar e depois selecione o local de impressão desejado. 
Acesse a aba geral e marcar a opção Imprimir monitor 
Acesse o menu Operações >Gravar Dados na Ficha. 
|
|
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:
Selecione o Menu "Estabelecimento" 
|
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". 
|
Selecione o menu "Integração" > "Integração Estabelecimento" 
|
Informe o "CNPJ" da loja e aperte a tecla "ENTER". 
Uma lista com todos os PCS relacionados será carregada. Escolha o PC e clique em "Selecionar". 
|
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. 
Após clicar no Botão "+", sera exibido a tela abaixo 
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" |
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. 
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 
|
|
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.

Após realizar o login , conforme orientado acima, vamos acessar agora o menu Smart Order > KDS.

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.

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.

Após preencher os dados acima basta clicar no botão salvar conforme destacado na imagem abaixo.

Por fim o KDS será exibido na lista de KDS.

<!-- 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>
|