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

Autoatendimento - Doc. Hibrida

Última atualização: 29/10/2026 | Versão: Spice e API: 6.15.02.3

Aprenda a configurar, utilizar e dar suporte ao Autoatendimento Spice em totens interativos disponíveis no estabelecimento. O recurso permite que o seu cliente monte e personalize o pedido, escolha a forma de consumo, realize o pagamento e emita a NFC-e no terminal, com vendas integradas ao fluxo da loja.

Este guia orienta a validação dos pré-requisitos, a configuração do Spice e a preparação do dispositivo, além de apoiar a operação e o suporte. As áreas de o impacto de cada função de cada configuração no seu negócio.

Importante: este recurso não possui a mesma proposta de uso de um self checkout de supermercado. O foco é autoatendimento para pedidos no contexto de Food Service.

Antes de começar

Antes da configuração, valide os pré-requisitos abaixo.

  • Versão mínima do Spice e da API: 6.15.02.3.
  • Operação com NFC-e ativa.
  • Dispositivo com Android 16 ou superior.
  • Tela recomendada: 11 polegadas IPS, resolução 2.5K (2560 x 1600) e 90 Hz.
  • Licença no CRM para Autoatendimento e Smart TEF.
  • Servidor da API com IP fixo.
  • Dispositivo do totem na mesma rede do servidor da API.
  • Aplicativo utilizado preferencialmente na vertical.
  • Impressora instalada ou disponível na máquina onde a API está instalada.
  • Número Auxiliar configurado no Spice.

Observação: o Autoatendimento exige emissão de NFC-e. Antes de ativar o recurso, confirme que o Spice está preparado para trabalhar com Documento Fiscal Eletrônico e NFC-e.

Configuração do Autoatendimento

1. Instalar a API Spice Service

Para iniciar a configuração, instale a API Spice Service em uma versão compatível com o Spice.

image-20261026-122553.png
image-20261026-122623.png

  1. Execute o instalador da API Spice Service.

  2. Clique em Avançar.

  3. Confirme o servidor, a base de dados e a porta.

  4. Use, por padrão, a porta 8877.

  5. Finalize a instalação.

  6. No Windows, abra os Serviços e confirme se Alterdata Spice – API está em execução.

    image-20261026-122708.png


📋 Detalhamento de Campos — Instalar a API Spice Service

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Servidor

Instalador da API Spice Service

Informar a máquina ou endereço do servidor onde a API será configurada.

Base de dados

Instalador da API Spice Service

Definir a base utilizada pelo Spice para integração com o Autoatendimento.

Porta

Instalador da API Spice Service

Definir a porta de comunicação da API, usando por padrão a porta 8877.

Alterdata Spice – API

Windows / Serviços

Confirmar se o serviço da API está instalado e em execução.
🔧 Detalhamento técnico - Instalar a API Spice Service

A API é responsável pela comunicação entre o Spice e os dispositivos de Autoatendimento. Se houver dúvida sobre compatibilidade de versão, a instalação não deve prosseguir até a validação da combinação correta entre Spice e API.

O IP exibido nas configurações do Autoatendimento será obtido a partir da máquina onde a API está instalada.

2. Configurações gerais no Spice

Acesse Funções Administrativas > Configurações > Autoatendimento > Geral.

image-20261026-123047.png

  1. Marque Trabalho com Autoatendimento.

  2. Defina o Usuário padrão para vendas.

  3. Em Formas de Pagamento, vincule ao menos uma forma entre cartão ou Pix.

  4. Se desejar, habilite Permitir pagamento em dinheiro.

  5. Em Formas de consumo, defina se o cliente poderá escolher consumir no local e/ou levar para viagem.

  6. Personalize Logotipo e Banner.

Autoatendimento_Spice_Onde prefere comer.png
Autoatendimento_Spice_Banner.png

Observação: não é possível operar o Autoatendimento usando somente pagamento em dinheiro. É obrigatório configurar pelo menos uma forma de pagamento com cartão ou Pix.

Autoatndimento_pagamento-dinheiro.gif
📋 Detalhamento de Campos — Configurações gerais no Spice

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Trabalho com Autoatendimento

Funções Administrativas / Configurações / Autoatendimento / Geral

Ativar o recurso de Autoatendimento para operação em totem ou tablet.

Usuário padrão para vendas

Funções Administrativas / Configurações / Autoatendimento / Geral

Definir o usuário usado no acesso ao Autoatendimento e vinculado às vendas do terminal.

Formas de Pagamento

Funções Administrativas / Configurações / Autoatendimento / Geral

Selecionar os meios de pagamento disponíveis ao cliente no terminal.

Permitir pagamento em dinheiro

Funções Administrativas / Configurações / Autoatendimento / Geral

Permitir que o pedido seja finalizado no terminal e pago posteriormente no caixa.

Formas de consumo

Funções Administrativas / Configurações / Autoatendimento / Geral

Definir se o cliente poderá escolher consumo no local e/ou viagem.

Logotipo e Banner

Funções Administrativas / Configurações / Autoatendimento / Geral

Personalizar a identidade visual exibida no Autoatendimento.
🔧 Detalhamento técnico - Configurações gerais no Spice

As informações de IP e porta vêm da base de dados e da instalação da API. O sistema não permite edição manual desses dados nesta tela.

Quando o pagamento em dinheiro estiver habilitado, o pedido seguirá para o Spice como venda pendente para recebimento posterior no caixa.

3. Configurar produtos no Spice

Acesse Funções Administrativas > Configurações > Autoatendimento > Produtos.

image-20261026-123337.png

O envio de produtos para o Autoatendimento é feito por grupos.

  1. Selecione os grupos que farão parte do cardápio do Autoatendimento.

  2. Defina a ordem em que esses grupos serão exibidos.

  3. Revise os produtos vinculados em cada grupo.

  4. Oculte itens que não devem aparecer no terminal.

  5. Defina se cada item usará Preço 1 ou Preço 2.

image-20261026-123430.png

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

📋 Detalhamento de Campos — Configurar produtos

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Grupos

Funções Administrativas / Configurações / Autoatendimento / Produtos

Selecionar os grupos que farão parte do cardápio do Autoatendimento.

Ordem dos grupos

Funções Administrativas / Configurações / Autoatendimento / Produtos

Definir a sequência em que os grupos serão exibidos no terminal.

Produtos vinculados

Funções Administrativas / Configurações / Autoatendimento / Produtos

Revisar quais produtos estarão disponíveis dentro de cada grupo.

Ocultar item

Funções Administrativas / Configurações / Autoatendimento / Produtos

Remover da visualização do terminal itens que não devem ser vendidos no Autoatendimento.

Preço 1 ou Preço 2

Funções Administrativas / Configurações / Autoatendimento / Produtos

Definir qual tabela de preço será utilizada por produto no Autoatendimento.
🔧 Detalhamento técnico sobre Preço 1 e Preço 2

A troca entre Preço 1 e Preço 2 é feita manualmente nesta aba. Também existe a opção de alteração em lote.

image-20261026-123527.png

Quando um produto ou adicional participa de uma pergunta de outro produto, ele pode herdar o preço do produto principal.

Exemplo: se um hambúrguer estiver configurado em Preço 2, os itens selecionados dentro das perguntas desse hambúrguer seguirão esse preço do produto pai. Já a mesma bebida vendida separadamente pode continuar usando Preço 1.

4. Relacionar dispositivos e impressão no Spice

Acesse Funções Administrativas > Configurações > Autoatendimento > Impressão.

image-20261026-123556.png

Nessa área são exibidos os tablets e totens com Autoatendimento já cadastrados.

  • Use a tela para visualizar dispositivos.

  • Remova dispositivos da lista apenas quando eles realmente não forem mais usados.

  • O cadastro do dispositivo é feito pelo próprio aplicativo e sincronizado via API.

📋 Detalhamento de Campos — Relacionar dispositivos e impressão

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Dispositivos cadastrados

Funções Administrativas / Configurações / Autoatendimento / Impressão

Visualizar tablets e totens vinculados ao Autoatendimento.

Remover dispositivo

Funções Administrativas / Configurações / Autoatendimento / Impressão

Excluir dispositivos que não serão mais utilizados na operação.

Impressora

Funções Administrativas / Configurações / Autoatendimento / Impressão

Relacionar a impressão disponível para uso pelo dispositivo via API.
🔧 Detalhamento técnico - Relacionar dispositivos e impressão

A impressora exibida no aplicativo depende de ela estar disponível na máquina onde a API está instalada, seja por porta USB ou por porta IP.

Se um dispositivo removido no Spice continuar em uso e fizer novo login, ele poderá ser recriado automaticamente.

5. Configurar NFC-e no Spice

O Autoatendimento usa o mesmo processo de emissão fiscal da comanda.

EnvioCupomFiscal_Spice.png

  1. Confirme que o emissor Altshop_EnvioCupomFiscal.exe está em execução.

  2. Valide se série e sequencial estão configurados.

  3. No Spice, confira as configurações fiscais em Periféricos.

  4. Garanta que dados como CSC, CNAE e certificado digital estejam corretamente informados.

📋 Detalhamento de Campos — Configurar NFC-e

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Altshop_EnvioCupomFiscal.exe

Windows / C:\Program Files (x86)\Alterdata\Spice

Confirmar que o emissor fiscal está em execução para permitir a emissão de NFC-e.

Série

Spice / Periféricos / Configurações fiscais

Definir a série utilizada na emissão da NFC-e.

Sequencial

Spice / Periféricos / Configurações fiscais

Controlar a numeração sequencial das notas emitidas.

CSC, CNAE e certificado digital

Spice / Periféricos / Configurações fiscais

Garantir que os dados fiscais obrigatórios estejam informados corretamente para emissão da NFC-e.

Informação: a emissão de NFC-e precisa estar funcional antes de liberar o uso do Autoatendimento em produção.

6. Configurar Número Auxiliar no Spice

Acesse Funções Administrativas > Configurações > Geral > Pedido >
O Número Auxiliar é obrigatório para trabalhar com Autoatendimento.

  1. Marque a opção Trabalhar com número auxiliar de pedidos.

  2. Clique em Configurar Número Auxiliar.

image-20261026-120231.png

  • Se o tipo de geração for sequencial ou aleatório, o pedido receberá o prefixo AUT junto ao número gerado.

  • Se o tipo de geração for Nome, o cliente informará o nome durante o pedido.

Essa identificação ajuda a diferenciar pedidos originados no Autoatendimento dos demais fluxos da operação.

Caso escolha o tipo de geração: Nome. Ao realizar os pedidos no autoatendimento ele pede para que o cliente informe o nome.

image-20261026-120604.png
📋 Detalhamento de Campos — Configurar Número Auxiliar

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Trabalhar com número auxiliar de pedidos

Funções Administrativas / Configurações / Geral / Pedido

Habilitar o uso do número auxiliar, obrigatório para identificar pedidos do Autoatendimento.

Configurar Número Auxiliar

Funções Administrativas / Configurações / Geral / Pedido

Abrir a configuração do número auxiliar após habilitar o recurso no cadastro de pedidos.

Tipo de geração

Funções Administrativas / Configurações / Geral / Pedido / Configurar Número Auxiliar

Definir se a identificação será sequencial, aleatória ou por nome informado pelo cliente.

Prefixo AUT

Funções Administrativas / Configurações / Geral / Pedido / Configurar Número Auxiliar

Diferenciar pedidos originados no Autoatendimento quando a geração for sequencial ou aleatória.

Nome do cliente

Autoatendimento Spice / Fluxo do pedido

Solicitar o nome do cliente no terminal quando o tipo de geração estiver configurado como Nome.

7. Configurar o aplicativo no dispositivo

No dispositivo que será usado como totem ou tablet.

  1. Instale o aplicativo Autoatendimento Spice.

  2. Abra o aplicativo.

  3. Na tela inicial, acesse as configurações com a senha padrão 12897722.

  4. Informe o IP do servidor e a porta usada pela API.

  5. Toque em Conectar com o servidor.

  6. Informe o apelido do dispositivo.

  7. Selecione a impressora.

  8. Informe o Terminal POS da Smart TEF.

  9. Salve as configurações e faça login com o usuário padrão.

📋 Detalhamento de Campos — Configurar o aplicativo no dispositivo

Utilize o cabeçalho da tabela para ordenar as colunas.

Campo

Onde fica no sistema

Objetivo

Senha de configuração

Autoatendimento Spice / Tela inicial / Configurações

Acessar as configurações iniciais do aplicativo no dispositivo.

IP do servidor

Autoatendimento Spice / Configurações do aplicativo

Informar o endereço do servidor onde a API Spice Service está instalada.

Porta da API

Autoatendimento Spice / Configurações do aplicativo

Definir a porta usada para comunicação entre o aplicativo e a API.

Apelido do dispositivo

Autoatendimento Spice / Configurações do aplicativo

Identificar o totem ou tablet na operação e no cadastro de dispositivos.

Impressora

Autoatendimento Spice / Configurações do aplicativo

Selecionar a impressora que será usada pelo dispositivo.

Terminal POS

Autoatendimento Spice / Configurações do aplicativo

Relacionar a POS da Smart TEF exclusiva do totem.
🔧 Detalhamento técnico e observações de operação

  • O dispositivo precisa estar na mesma rede do servidor da API.

  • Em dispositivos Gertec, o sistema pode identificar automaticamente modelos compatíveis para ativar o SDK de impressão.

  • O modo demonstração pode ser usado para validações iniciais.

  • A descrição do dispositivo é composta por Apelido + AUT + 4 últimos dígitos do ID.

Observação: cada totem precisa ter uma POS própria. As maquininhas não podem ser compartilhadas entre dispositivos. Alterar o apelido do dispositivo faz o sistema entender que se trata de outro terminal, criando outro caixa na base.

Como operar o Autoatendimento

Login e abertura do caixa

Após configurar o dispositivo, faça login com o usuário padrão definido no Spice.

  • Ao entrar no Autoatendimento, o caixa daquele terminal será aberto automaticamente.

  • Se houver turno aberto, o caixa será vinculado a ele.

  • Se não houver turno aberto, o sistema abrirá o turno e depois o caixa.

Importante: o encerramento do caixa do Autoatendimento deve ser feito no Spice.

Fluxo do cliente no terminal

  1. Toque na tela para iniciar.

  2. Escolha o grupo desejado no cardápio.

  3. Selecione o produto.

  4. Informe quantidade e personalize o item, se necessário.

  5. Adicione o produto ao pedido.

  6. Toque em Pagar.

  7. Escolha a forma de consumo, quando habilitada.

  8. Informe o nome, quando essa identificação for solicitada.

  9. Escolha a forma de pagamento disponível.

  10. Informe CPF na nota, se desejado.

  11. Conclua o pagamento.

Autoatendimento_Spice_Logotipo.png

Para sair da operação e voltar à tela de login, toque 4 vezes na logo do Spice e informe a senha do usuário.

Situações operacionais importantes

Situação

Comportamento do sistema

Observação

Pagamento em dinheiro

Comportamento do sistema: O pedido pode ser finalizado normalmente e direcionado ao caixa.
Impacto operacional: Fica pendente para recebimento.

Esse valor contabiliza no caixa do Spice, não no do Autoatendimento.

Falha ou instabilidade no Smart TEF

Comportamento do sistema: A venda é concluída como pedido e segue para preparo.
Impacto operacional: O cliente não perde o pedido.

O comportamento é semelhante ao pagamento em dinheiro.

Rejeição da NFC-e

Comportamento do sistema: O cancelamento é feito no Spice.
Impacto operacional: Afeta o caixa correspondente.

A NFC-e poderá ser emitida depois pelo ALT + V no Spice.

Cancelamento de venda paga

Comportamento do sistema: O pedido pode ser finalizado normalmente e direcionado ao caixa.
Impacto operacional: Fica pendente para recebimento.

Se houver devolução em dinheiro pelo caixa principal, pode ocorrer sangria nesse valor.

Perguntas e suporte

O que esta versão atende e o que não atende

🟢 Esta versão Atende:

  • Integração com Spice por meio da Spice API.
  • Uso em dispositivos Android.
  • Operação em totem ou tablet.
  • Perguntas, adicionais, observações e personalização de itens conforme cadastro do produto.
  • Pagamento com Smart TEF e Pix, conforme configuração.
  • Pagamento em dinheiro no caixa, quando habilitado.
  • Integração com painel de senhas.

🔴 Esta versão Não atende:

  • Fluxo de self checkout de supermercado.

  • Impressão de ticket unitário.

  • Produtos do tipo combo, pizza e itens de rodízio.

  • Produtos fracionados em quantidades não inteiras, como 1,5 kg ou 0,25 kg.

  • Regras automáticas de disponibilidade por dia com troca dinâmica de preço.

Como funciona a abertura e o encerramento de caixa?

O Autoatendimento funciona como um terminal próprio. Por isso, ele possui abertura e encerramento de caixa próprios. Ao logar no dispositivo, o caixa é aberto automaticamente. O encerramento deve ser realizado no Spice.

Pedidos originados no Autoatendimento, mas recebidos depois no Spice como venda pendente, contabilizam no caixa do Spice e não no caixa do Autoatendimento.

O painel de senhas funciona com o Autoatendimento?

Sim. Quando o cliente possui licença ou opta por usar o recurso com painel de senhas, a integração funciona normalmente, permitindo chamar nome ou senha do consumidor final.

As perguntas e adicionais dos produtos funcionam no terminal?

Sim. O cadastro de perguntas segue normalmente as etapas configuradas no produto, incluindo observações, adicionais, perguntas do tipo produto e remoção de ingredientes.

O que acontece se der problema no Smart TEF?

Nesse cenário, o pedido pode ser finalizado com orientação para o cliente procurar o caixa e acertar o pagamento com um funcionário. O pedido ficará no Spice, em venda pendente, para recebimento.

O que acontece se a NFC-e for rejeitada?

Se houver erro fiscal na finalização, a NFC-e não será emitida naquele momento, mas a venda seguirá normalmente como pedido pago e entrará na fila de preparo. Depois, a nota poderá ser emitida pelo ALT + V no Spice.