🧪 Nova Experiência: Você está testando nossa nova documentação. Dê sua opinião
erp4me
erp4me
Breadcrumbs

Autoatendimento Spice

Aprenda a configurar e utilizar o Autoatendimento no Spice para liberar pedidos e pagamentos autônomos via totem ou tablet. O recurso permite que o cliente selecione itens, personalize o pedido, realize o pagamento e conclua a emissão de NFC-e diretamente no terminal, com vendas integradas ao fluxo da loja. Use este guia para validar os pré-requisitos, configurar o Spice e preparar o dispositivo de atendimento.

Dica: Consulte o Detalhamento de Campos ao final de cada etapa para entender o destino e a função de cada configuração na operação.

Antes de começar

  • Utilizar NFC-e no Spice 6.15.02.3 e Spice Service 6.15.02.3 (API) ou superior.
  • Validar a operação no Spice ou no Spice Simples, conforme o ambiente do cliente.
  • Usar dispositivo com Android 16 ou superior.
  • Utilizar tela de 11 polegadas IPS com resolução 2.5K (2560x1600) e 90 Hz.
  • Ter Certificado Digital configurado para emissão e envio dos XMLs de NFC-e.
  • Configurar Número Auxiliar para identificar pedidos originados no Autoatendimento.
  • Contratar e configurar Smart TEF para pagamentos por cartão e Pix.

Regra importante: o Autoatendimento exige NFC-e. Ao ativar o Autoatendimento, o Spice deve estar preparado para trabalhar com Documento Fiscal Eletrônico e NFC-e em Configurações > Periféricos > NFC-e.

Instalação da API Spice Service

Para iniciar a configuração do Autoatendimento, instale a API Spice Service em uma versão compatível com o Spice. Essa API é responsável pela comunicação entre o Spice e os dispositivos do Autoatendimento, por isso a instalação correta é essencial para manter o fluxo operacional funcionando.

Aviso: não prossiga com a instalação se houver dúvida sobre a versão compatível com o Spice (Spice 6.15.02.3 e Spice Service 6.15.02.3 (API) ou superior). A versão incorreta pode impedir a comunicação entre o sistema e o Autoatendimento.

Instalação da API Spice Service

  1. Excute o instalador da API Spice Service em uma versão compatível com o Spice.

  2. Clique em Avançar para seguir com a configuração.

  3. Confirme o Servidor informado.

  4. Confirme a Base de dados utilizada pelo Spice.

  5. Por padrão é utilizada a porta 8877.

  6. Finalize a instalação.

Validar o serviço no Windows

  1. Abra os Serviços do Windows.

  2. Localize o serviço Alterdata Spice – API.

  3. Confirme se o serviço está em execução.

Observação: a execução do serviço Alterdata Spice – API indica que a API foi instalada e está disponível para comunicação com o Spice.

📋 Detalhamento de Campos — Instalação da API Spice Service

Considere os campos e opções disponíveis na tela Instalador da API Spice Service:

Campo

Objetivo

Servidor

Identificar a máquina ou ambiente onde o Spice está instalado para direcionar a comunicação da API Spice Service.

Base de dados

Definir a base utilizada pelo Spice para gravar e consultar as informações consumidas pela API.

Porta

Definir a porta de comunicação da API, mantendo o padrão 8877 quando não houver regra de rede diferente.

Alterdata Spice – API (Serviços do Windows)

Confirmar a execução do serviço responsável por manter a API Spice Service disponível para comunicação com o Spice e o Autoatendimento.

Configuração Geral Autoatendimento

Onde configurar: acesse o Configurador do Spice em Configurações > Autoatendimento > Geral.

  1. Marque a opção Trabalho com Autoatendimento.

  2. Confirme se a emissão de NFC-e está ativa em Configurações > Periféricos > NFC-e.

  3. Preencha os dados necessários para geração e envio dos XMLs de NFC-e em Ambiente Normal e Em Contingência.

  4. Acesse Configurações > Periféricos > Caixa > Pedido, marque Número Auxiliar de Pedido e defina o Tipo da Geração.

  5. Em Dados de acesso ao Autoatendimento, consulte as informações de API geradas automaticamente pelo banco de dados do sistema, como IP do servidor e porta de comunicação.

  6. Defina o Usuário padrão para vendas, que será utilizado para acesso ao Autoatendimento e vínculo das vendas no Spice.

  7. Em Formas de pagamento para recebimento dos pedidos, informe ao menos uma opção entre Débito, Crédito, Voucher ou PIX.

  8. Se desejar receber pedidos com pagamento em dinheiro, marque Permitir pagamento em dinheiro no caixa.

  9. Em Formas de consumo dos pedidos, habilite as opções adequadas para apresentar a tela Onde prefere comer?, com Comer no local e/ou Levar para viagem.

  10. Personalize o Logotipo e vincule Banners promocionais ou institucionais no formato 1080x300.

Autoatendimento_Spice_Onde prefere comer.png
Autoatendimento_Spice_Banner.png

Observação: os dados de acesso à API não são editáveis no Spice. Eles são alimentados automaticamente com as informações da máquina onde a API está instalada.

Atenção: não é possível utilizar somente pagamento em dinheiro. Para proteger o fluxo de venda, informe ao menos uma forma de pagamento por cartão ou Pix.

Dica: quando o tipo de geração do Número Auxiliar for Nome, a tela Como podemos te chamar? será exibida ao cliente. Se não houver prefixo configurado, o Spice utilizará AUT para diferenciar pedidos do Autoatendimento.

📋 Detalhamento de Campos — Configuração Geral

Considere os campos e opções disponíveis na tela Configurador do Spice > aba Configurações > sub-abas Geral, Periféricos e Autoatendimento:

Campo

Objetivo

Trabalho com Autoatendimento (Autoatendimento)

Ativar o recurso de Autoatendimento para liberar operação em totem ou tablet integrada ao fluxo de venda do Spice.

Documento Fiscal Eletrônico e NFC-e (Periféricos > NFC-e)

Garantir a emissão fiscal obrigatória dos pedidos realizados no Autoatendimento por meio de NFC-e.

Certificado Digital (Periféricos > NFC-e)

Assinar e transmitir os XMLs de NFC-e para a SEFAZ nos ambientes normal e de contingência.

Número Auxiliar de Pedido (Periféricos > Caixa > Pedido)

Identificar pedidos do Autoatendimento para produção, retirada, conferência e impressão, diferenciando-os dos demais pedidos do caixa.

Dados de acesso ao Autoatendimento (Autoatendimento)

Exibir o IP e a porta da API usados pelo dispositivo para conectar-se ao Spice, sem edição manual no configurador.

Usuário padrão para vendas (Autoatendimento)

Definir o usuário responsável por autenticar o acesso e vincular as vendas geradas no Autoatendimento ao controle operacional do Spice.

Formas de pagamento (Autoatendimento)

Disponibilizar meios de recebimento como débito, crédito, voucher, Pix e dinheiro no caixa, mantendo ao menos uma forma eletrônica para o fluxo com Smart TEF.

Formas de consumo dos pedidos (Autoatendimento)

Apresentar ao cliente as opções de consumo, como comer no local ou levar para viagem, para orientar atendimento, produção e entrega do pedido.

Logotipo e Banners (Autoatendimento)

Personalizar a experiência visual do terminal com a identidade do estabelecimento e materiais promocionais no formato recomendado.

Envio de Produtos

Onde configurar: acesse o Configurador do Spice em Configurações > Autoatendimento > Produtos.

  1. Clique em Localizar e incluir grupos.

  2. Na tela Pesquisa de Grupos, marque os grupos que serão disponibilizados no Autoatendimento.

  3. Clique em F9 - Confirmar.

  4. Organize a ordem de exibição dos grupos e revise os produtos que serão enviados.

  5. Para ocultar itens específicos, selecione o item na Tabela/Lista e clique em Mover para não exibir. Assim tais itens serão incluídos na aba Não Exibir mantendo o grupo disponível sem que certos itens apareçam para venda no terminal.

  6. Defina o tipo de preço aplicável, como Preço 1 ou Preço 2.

Atenção: é obrigatório selecionar ao menos um grupo de produtos para que o Autoatendimento tenha cardápio disponível.

Observação: itens fracionados podem ser enviados e vendidos no Autoatendimento, mas a venda ocorre em quantidades inteiras, como 1 kg ou 2 kg, e não em frações.

📋 Detalhamento de Campos — Envio de Produtos

Considere os campos e opções disponíveis na tela Configurador do Spice > aba Configurações > aba Autoatendimento > aba Produtos:

Campo

Objetivo

Localizar e incluir grupos

Selecionar os grupos que compõem o cardápio exibido no Autoatendimento, garantindo que o cliente visualize apenas categorias liberadas para venda.

Tabela/Lista de grupos

Ordenar grupos, revisar itens enviados e organizar a navegação do cliente no terminal de Autoatendimento.

Mover para não exibir (Produtos do grupo selecionado)

Ocultar produtos específicos sem remover o grupo do cardápio, mantendo a disponibilidade dos demais itens para venda.

Preço 1 / Preço 2 (Produtos do grupo selecionado)

Definir qual tabela de preço será enviada para cada item no Autoatendimento, evitando divergência entre cardápio, venda e cobrança.

Produtos fracionados

Permitir envio de produtos fracionados ao terminal com venda apenas em quantidades inteiras, evitando frações incompatíveis com a primeira versão do recurso.

Pizza e Rodízio (Grupos de produtos)

Evitar o envio de grupos incompatíveis, como pizza e rodízio, para preservar regras de montagem e cobrança ainda não atendidas pelo Autoatendimento.

Relacionar Impressora

Onde configurar: acesse o Configurador do Spice em Configurações > Autoatendimento > Impressão.

  1. Cadastre o dispositivo no próprio Autoatendimento; ele será enviado pela API para a área de impressão do Spice.

  2. Consulte os dispositivos já cadastrados e suas respectivas impressoras.

  3. Remova dispositivos apenas quando eles não forem mais utilizados.

  4. Após configurar o Autoatendimento, os produtos e o relacionamento de impressora, grave as configurações do Spice.

Observação: a área de Impressão no Spice é usada para consulta e remoção de dispositivos. O cadastro é feito pelo Autoatendimento e sincronizado pela API.

Atenção: se um dispositivo removido no Spice continuar em uso, ele será recriado automaticamente ao realizar novo login no Autoatendimento.

📋 Detalhamento de Campos — Relacionar Impressora

Considere os campos e opções disponíveis na tela Configurador do Spice > aba Configurações > aba Autoatendimento > aba Impressão:

Campo

Objetivo

Dispositivo do Autoatendimento

Identificar o terminal cadastrado pela API para relacionar pagamentos, relatórios, impressão e vínculo operacional no Spice.

Descrição

Exibir a identificação composta por Apelido + AUT + 4 últimos dígitos do ID para diferenciar dispositivos e facilitar suporte.

Impressora utilizada

Indicar a impressora vinculada ao terminal para emissão de pedidos, NFC-e, cupom fiscal ou comprovantes operacionais.

Provedor

Registrar o provedor de pagamento, como Smart TEF, para orientar a integração de recebimentos do terminal.

Serial Terminal

Relacionar a maquininha Smart TEF ao dispositivo correto, evitando direcionamento de pagamento para terminal indevido.

Configuração no Dispositivo

Onde configurar: no Totem ou Tablet, abra o aplicativo Autoatendimento.

Informação: Em dispositivos Gertec, o modo demonstração do Autoatendimento conta com a impressão do pedido para o cliente.
O sistema identifica automaticamente dispositivos Gertec (modelos SK210 ou SK315) durante a inicialização do aplicativo para ativar o SDK de impressão.

🔧 Regras de Impressão no Modo Demonstração:

  • Itens do Pedido: A impressão contempla todos os itens selecionados, seguindo o layout padrão do modo "normal".

  • Independência de API: Não há conexão externa na demonstração, toda a montagem do layout é processada localmente pelo aplicativo.

  • Layout Unificado: O template de impressão foi unificado. Assim, pedidos pendentes e pedidos normais compartilham a mesma estrutura visual, diferenciando-se apenas pelo aviso de "Pendente" e pelos campos de total pago/a pagar.

  1. Toque no aplicativo Autoatendimento.

  2. Na tela de boas-vindas, informe a senha padrão 12897722 para acessar as configurações.

  3. Opcionalmente, toque em Experimentar demonstração para acessar o modo demonstração.

  4. Na tela Configurações, informe o IP da máquina onde a API está instalada.

  5. Confirme a Porta; por padrão, a API utiliza 8877.

  6. Toque em Conectar com o servidor.

  7. Informe o Apelido do dispositivo.

  8. Selecione a Impressora para pedidos e cupom fiscal.

  9. Informe o Terminal POS cadastrado no site da Smart TEF.

  10. Salve as configurações para criar o dispositivo no Spice e exibir a tela de login do Autoatendimento.

Atenção: o Totem ou Tablet precisa estar conectado à mesma rede da máquina da API. Sem comunicação com a API, o dispositivo não conclui a configuração operacional.

Observação: a alteração do Apelido fará o Spice tratar o terminal como outro caixa. Se apenas o servidor mudar de local, atualize o IP sem alterar o nome do dispositivo.

Dica: mantenha um padrão de nomes (Apelidos) para os dispositivos, facilitando conferência de caixa, suporte e identificação das maquininhas Smart TEF. A Descrição é gerada pela API, sendo ela composta do Apelido + AUT + 4 últimos dígitos do ID do dispositivo.

📋 Detalhamento de Campos — Configuração no Dispositivo

Considere os campos e opções disponíveis na tela Configurações do Autoatendimento no dispositivo:

Campo

Objetivo

Senha padrão 1289722 (Tela de boas-vindas)

Acessar as configurações iniciais do aplicativo antes da conexão com a API e do cadastro operacional do dispositivo.

IP do servidor

Conectar o dispositivo à máquina onde a API Spice Service está instalada, permitindo comunicação com o Spice.

Porta

Definir a porta usada na comunicação com a API, normalmente 8877, conforme a instalação do serviço.

Apelido

Nomear o dispositivo para identificação operacional no caixa, nos relatórios e no relacionamento com impressoras e Smart TEF.

Descrição (Gerada pela API)

Compor automaticamente a identificação Apelido + AUT + 4 últimos dígitos do ID para diferenciar terminais cadastrados.

Impressora para pedidos e cupom fiscal

Definir onde serão impressos pedidos, NFC-e ou comprovantes sem validade fiscal, conforme o hardware disponível.

Terminal POS

Direcionar o pagamento para a maquininha Smart TEF correspondente ao dispositivo configurado.

Operação do Autoatendimento

Login e caixa

Fluxo operacional: após configurar o dispositivo, utilize o usuário padrão definido no Spice para entrar no Autoatendimento.

  1. Informe o usuário configurado no Spice e a respectiva senha de acesso.

  2. Ao iniciar a operação, a API abre automaticamente o caixa do dispositivo no Spice.

  3. Se houver turno aberto, o caixa é vinculado ao turno existente.

  4. Se não houver turno aberto, a API abre o turno e, em seguida, abre o caixa do Autoatendimento.

  5. Feche o caixa pelo Spice para evitar que ele permaneça aberto nos dias seguintes.

Atenção: pedidos do Autoatendimento não podem ficar sem vínculo de caixa. Se o caixa ou turno for encerrado por engano, a API abrirá automaticamente um novo caixa para as próximas vendas.

Utilizar o Autoatendimento

Experiência do cliente: o cliente realiza o pedido, escolhe consumo, identifica-se, paga e recebe a confirmação conforme as configurações do Spice.

  1. Toque na tela para iniciar o pedido.

  2. No cardápio, toque no grupo desejado para localizar o item.

  3. Selecione o produto.

  4. Informe a Quantidade e, se necessário, adicione uma observação.

  5. Toque em Adicionar ao pedido.

  6. Toque em Pagar.

  7. Escolha onde prefere comer: Comer aqui ou Levar para viagem.

  8. Na tela Como podemos te chamar?, informe uma descrição com pelo menos 3 caracteres.

Autoatendimento_Spice_Logotipo.png

  1. Escolha a forma de pagamento configurada no Spice.

  2. Use CPF na nota quando o cliente desejar vincular o documento à NFC-e.

  3. Conclua o pagamento; a venda será vinculada ao caixa do Autoatendimento.

Dica: as opções de inclusão, alteração e remoção ajudam o cliente a revisar o pedido antes do pagamento, reduzindo retrabalho no caixa e na produção.

Observação: perguntas obrigatórias, adicionais e observações seguem as regras configuradas no Spice. Itens gratuitos e perguntas do tipo produto são exibidos para facilitar a composição do pedido.

Falha de pagamento ou instabilidade: se houver divergência relacionada ao produto ou ao pagamento, o cliente poderá ser direcionado para concluir no caixa do Spice. Nesse cenário, a Smart TEF não será chamada e a pendência aparecerá em Vendas Pendentes.

Autoatndimento_pagamento-dinheiro.gif

Quanto à emissão de notas: o Autoatendimento utiliza o mesmo emissor da Comanda (Altshop_EnvioCupomFiscal.exe), conforme as configurações de emissão normal e contingência, séries e sequenciais.

EnvioCupomFiscal_Spice.png
📋 Detalhamento de Campos — Operação do Autoatendimento

Considere os campos e opções disponíveis nas telas de Login, Fluxo de pedido e Caixa do Spice:

Campo

Objetivo

Usuário padrão (Login)

Vincular o acesso ao usuário configurado no Spice para registrar vendas, permissões e abertura de caixa do Autoatendimento.

Caixa do Autoatendimento (Caixa do Spice)

Registrar vendas, relatórios e conferência por dispositivo, garantindo vínculo de caixa para cada pedido concluído no terminal.

Onde prefere comer? (Fluxo de pedido)

Separar consumo no local e viagem para orientar produção, embalagem e atendimento conforme a escolha do cliente.

Como podemos te chamar? (Fluxo de identificação do cliente)

Identificar o pedido para retirada e comunicação com o cliente, especialmente quando o Número Auxiliar usa geração por nome.

CPF na nota (Fluxo de pagamento)

Vincular o documento do cliente à NFC-e, permitindo emissão fiscal com CPF quando solicitado.

Vendas Pendentes (Caixa do Spice)

Tratar pedidos direcionados ao caixa por falha de pagamento, pagamento em dinheiro ou instabilidade, sem acionar a Smart TEF no terminal.

Particularidades do Autoatendimento

Nesta primeira versão, o Autoatendimento funciona integrado ao Spice pela Spice API, opera em dispositivos Android, permite instalação manual via APK, uso em Totens ou Tablets preferencialmente na vertical, venda de produtos compatíveis configurados no cardápio, pagamento conforme as formas habilitadas e controle de vendas vinculado ao caixa do Autoatendimento.

💡 Esta versão do Autoatendimento Spice atende:

  • Integração com o Spice: Spice, Spice Simples e Autoatendimento se comunicam pela Spice API, a mesma base usada na integração com a Comanda Alterdata.

  • Plataforma: opera em dispositivos Android.

  • Instalação: o aplicativo é instalado manualmente via APK; em versões futuras, estará disponível na Play Store.

  • Uso em Totem ou Tablet: utilize o app preferencialmente na vertical para melhor experiência. Embora funcione na horizontal, a usabilidade não é a ideal.

  • Adicionais e perguntas: será usado sempre o preço disponível do produto principal. Se o principal estiver em Preço 2 e o adicional possuir apenas Preço 1, o Preço 1 será enviado para não ocultar o item.

  • Impressoras: Totens com impressora acoplada exigem SDK próprio na interação* com o hardware e homologação.
    *Por exemplo: para impedir que o cliente continue o atendimento se o papel da impressora estiver acabando.

  • Cancelamento de venda paga na Smart TEF: realize pelo atalho Alt+V ou por Funções Administrativas no Spice. O cancelamento será abatido do caixa correspondente. As vendas realizadas no terminal são vinculadas a um caixa próprio; em casos de cancelamento com devolução de valores em espécie, a operação reflete no caixa principal do Spice.

    • Exemplo prático: se o Autoatendimento vendeu R$ 150,00 e o caixa do Spice vendeu R$ 1000,00, ao cancelar a venda de R$ 150,00 com devolução em dinheiro pela gaveta do Spice, o sistema realiza uma sangria automática ou manual nesse valor. No encerramento, o saldo do Spice será de R$ 850,00.

  • Sair para a tela de login: toque 4 vezes na logo do Spice e informe a senha do usuário para retornar ao login.