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

Autoatendimento - Doc. Hibrida

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.

Regra crítica: 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.

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.

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.

Unknown Attachment

Unknown Attachment

  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.

    Unknown Attachment


📋 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

Onde configurar: Funções Administrativas > Configurações > Autoatendimento > Geral.

Unknown Attachment

  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.

Unknown Attachment

Unknown Attachment

Atençã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.

Unknown Attachment

📋 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

Onde configurar: Funções Administrativas > Configurações > Autoatendimento > Produtos.

Unknown Attachment

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.

Unknown Attachment

Atençã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.

Unknown Attachment

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

Onde configurar: Funções Administrativas > Configurações > Autoatendimento > Impressão.

Unknown Attachment

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

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

Unknown Attachment

  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.

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

6. Configurar Número Auxiliar

O Número Auxiliar é obrigatório para trabalhar com Autoatendimento.

Unknown Attachment

  • 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.

Unknown Attachment

📋 Detalhamento de Campos — Configurar Número Auxiliar

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

Campo

Onde fica no sistema

Objetivo

Número Auxiliar

Spice / Configurações do Número Auxiliar

Identificar os pedidos originados no Autoatendimento durante a operação.

Tipo de geração

Spice / Configurações do Número Auxiliar

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

Prefixo AUT

Spice / Configurações do Número Auxiliar

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

Nome do cliente

Autoatendimento Spice / Fluxo do pedido

Permitir que o cliente informe o nome quando o tipo de geração estiver configurado como Nome.

7. Configurar o aplicativo no dispositivo

Onde configurar: 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.

Atençã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.

Unknown Attachment

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

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.