erp4me

📱 Comanda Alterdata SmartPOS

A Comanda Alterdata SmartPOS integra o lançamento de pedidos e o recebimento de pagamentos diretamente na maquininha, reduzindo etapas no atendimento do salão. O recurso pertence ao ecossistema Spice e permite que o garçom registre o pedido, feche a conta e receba em cartão no mesmo dispositivo, com mais agilidade e segurança para o estabelecimento.


✅ Antes de começar (Checklist)

Antes de configurar a Comanda Alterdata na SmartPOS, confirme os itens abaixo:

  • Spice instalado na versão mínima 6.13.37. Se estiver na versão 6.13.38, utilize a API 2.4.2 ou 2.5.

  • Spice Service API na versão mínima 2.4.1.

  • Comanda Alterdata na versão 2.2 ou superior.

  • SmartPOS de uma das marcas compatíveis: Cielo, Stone, Getnet, Rede, Safra, Pagseguro ou Itaú 🆕 Em breve!.

  • Formas de pagamento em cartão com a opção TEF marcada no cadastro.

  • Formas de pagamento configuradas no Spice em Funções Administrativas > Configurações > aba Mobile/Mesa.

  • Rede Wi-Fi interna configurada e funcionando. A comanda opera apenas em rede local.

Se tiver dúvidas sobre o objetivo ou o caminho de algum campo citado neste checklist, consulte a seção Detalhamento de Campos do Sistema.


1. Modelos de SmartPOS Compatíveis

A Comanda Alterdata é compatível com diferentes modelos de SmartPOS para operação geral, pizza e emissão de NFC-e, conforme as tabelas abaixo.

Para funcionamento geral e de pizza

Adquirente

Modelos

Cielo

LIO ON / v2 / v3

Stone

P2 / L400

Getnet

A8 / N950 / P2

Rede

GPOS700 / L400

Safra

A8

Pagseguro

Moderninha Smart 2

Itaú 🆕

N960K (Laranjinha do Itaú) Em breve!

Para NFC-e na Comanda Alterdata

Adquirente

Modelos

Versão mínima

Cielo

LIO ON / v2 / v3

2.4 ou 67.0

Stone

P2

Getnet

A8 / N950 / P2

68.0

Rede

GPOS700 / L400

2.4 ou 67.0

Safra

A8

67.0

Pagseguro

Moderninha Smart 2

💡 Dica de produtividade: Para consultar a lista atualizada de modelos e versões compatíveis, acesse Portal da Uca » Spice » Materiais » Spice manuais » SOS suporte » API – versões e compatibilidade.


2. Instalação da Comanda na SmartPOS

A Comanda Alterdata utiliza o mesmo aplicativo do smartphone, mas o processo de instalação varia conforme a adquirente. Na SmartPOS, o download é feito diretamente no portal da desenvolvedora do hardware — e não pela Play Store.

2.1 Instalação na Cielo e Stone (com código de liberação)

Ao adquirir a máquina, a desenvolvedora disponibiliza um código de identificação:

Passo a passo

  1. Envie o código, EC ou Stonecode, para a Alterdata (DSN Shop) através do suporte de canais.

  2. A Alterdata fará o vínculo do Spice no portal da desenvolvedora.

  3. Após o vínculo, a máquina recebe o download automaticamente e instala a Comanda.

Para atualizar manualmente

  • Cielo LIO: acesse Ajuda > Sobre Cielo LIO > Atualizar Aplicativos Cielo LIO. Os aplicativos disponibilizados serão baixados e ficarão visíveis na aba Apps.

  • Stone: o aplicativo fica disponível em até 3 horas após a liberação, com o terminal ligado e conectado ao Wi-Fi ou 3G. Para verificar, acesse Menu > Ajustes > Verificar atualizações.

2.2 Instalação na Rede, Getnet, Safra e Itaú 🆕 Em breve! (sem código)

Para as máquinas da Rede, Getnet, Safra e Itaú Em breve!, não é necessário código de liberação. Basta acessar a loja de aplicativos da desenvolvedora e baixar o aplicativo Comanda Alterdata diretamente.


3. Configurações Pós-Instalação

📸 Veja a tela de configurações da Comanda Alterdata:

Campos da Configuração da Comanda.png

Na tela inicial da Comanda Alterdata, toque em Configurações, na parte inferior da tela, e informe a senha 12897722.

As opções de configuração serão exibidas. Preencha conforme as orientações abaixo e, se tiver dúvida sobre o impacto de cada campo no negócio, consulte Campos da Configuração da Comanda na seção Detalhamento de Campos do Sistema.

  1. Verifique o Id do dispositivo gerado automaticamente.

  2. Defina o Nome da conexão para identificar facilmente o dispositivo.

  3. Informe o Endereço IP da máquina onde o Spice Service (API) está instalado.

  4. Confirme a Porta, por padrão 8877. Altere apenas se já estiver em uso por outro sistema.

  5. Mantenha o Time Out no padrão 10000, salvo orientação do suporte.

  6. Ative o Modo Terminal se vários garçons compartilham o mesmo dispositivo.

  7. Defina se deseja Permitir edição da taxa, como taxa de serviço ou couvert, durante a venda.

  8. Clique em Obter carga para sincronizar os dados com a API.

  9. Use Testar Wi-Fi para validar a conexão de rede.

  10. Acesse Ver conexões para revisar todas as conexões configuradas.

⚠️ Atenção: Mantenha a porta padrão 8877 sempre que possível. Isso facilita o diagnóstico em caso de suporte técnico.


4. Funcionamento da Comanda com SmartPOS

A rotina de funcionamento da Comanda Alterdata na SmartPOS é idêntica à do celular. A grande vantagem é a possibilidade de receber pagamentos em cartão diretamente na maquininha, sem precisar de um segundo equipamento.

⚠️ Atenção: A SmartPOS com a Comanda Alterdata funciona apenas dentro do estabelecimento, conectada à rede Wi-Fi interna. Não é possível utilizá-la em ambientes externos.

4.1 Abertura e lançamento de pedidos

  1. Abra a Comanda Alterdata na SmartPOS e informe usuário e senha.

  2. O processo de abertura de mesa/comanda e lançamento de itens segue o mesmo fluxo do celular.

4.2 Visualização e fechamento da conta

  1. Toque sobre a mesa/comanda desejada e selecione Ver Conta para visualizar os itens vendidos e os totais.

  2. Toque sobre o valor total em verde, na parte inferior, para iniciar o fechamento. A comanda exibirá cliente, número de pessoas, subtotal com desconto ou acréscimo e taxas.

  3. Imprima a conta para entregar ao cliente. Após a impressão, a mesa ficará bloqueada, habilitada apenas para Receber ou Alterar/Imprimir.

💡 Dica: A opção Alterar modifica apenas os dados da mesa, como cliente e número de pessoas. Ela não altera os itens lançados.

4.3 Recebimento do pagamento

  1. Toque em Receber ou Receber Conta. Serão exibidos o valor a receber, o total por pessoa e as formas de pagamento configuradas.

  2. Informe a forma de pagamento. É possível realizar pagamento parcial, adicionando múltiplas formas até completar o valor total.

  3. Se a forma de pagamento for cartão, o pagamento será processado diretamente pela SmartPOS.

  4. No Spice Desktop, o status da mesa ficará como Em pagamento, aguardando a confirmação manual pelo responsável do caixa. Ao confirmar, basta emitir a nota fiscal.

⚠️ Atenção: A nota fiscal deve ser emitida na retaguarda, no Spice Desktop, exceto quando configurado para emitir NFC-e diretamente na Comanda Alterdata com adquirente compatível.

💡 Dica: Se o campo de forma de pagamento estiver vazio nas configurações do Spice, em Funções Administrativas > Configurações > aba Comanda Alterdata, essa forma não aparecerá na tela de pagamento da comanda. Consulte Campos de Formas de Pagamento para revisar a configuração.


5. Impressão de Ticket Unitário

O recurso de Ticket Unitário permite que clientes comprem itens individualmente e recebam um ticket impresso para cada unidade. É indicado para eventos, festas e estabelecimentos com consumo avulso.

📸 Veja como ativar a impressão de ticket unitário no Spice:

Ativar a impressão de ticket unitário_Spice.gif

Ativação no Spice Desktop

  1. Na tela principal, acesse Funções Administrativas > Configurações > aba Impressão.

  2. Marque a opção Trabalho imprimindo tickets individuais de itens unitários.

  3. Clique em Selecione os módulos de impressão, marque Comanda POS e salve.

⚠️ Atenção: Ao ativar o ticket unitário, a impressão de copa/cozinha será desabilitada no setor configurado. O ticket unitário será impresso somente após o recebimento da conta.

Cadastro da unidade do produto

📸 Veja como configurar o cadastro da unidade:

Sempre vender como unitário no PDV e Spice.gif
  1. No Shop, acesse Produtos e serviços > Cadastro de produtos > Unidades.

  2. No cadastro da unidade, marque Sempre vender como unitário no PDV e Spice.

No Spice Simples, acesse Cadastros > Produtos > Unidades e marque Quantidade unitária.

Para entender o impacto de cada campo usado nesta configuração, consulte Campos de Ticket Unitário.

💡 Dica: No fechamento da conta, após inserir o pagamento, a comanda perguntará se deseja imprimir o ticket unitário.


6. Funcionamento do PIX nas SmartPOS

O PIX na SmartPOS permite que o cliente pague escaneando um QR Code gerado diretamente na tela da maquininha, sem necessidade de aplicativos externos ou maquininhas adicionais.

Configuração

📸 Veja como configurar o recebimento PIX no Spice:

Configurar o recebimento PIX no Spice.gif
  1. No Shop, cadastre uma forma de pagamento do tipo PIX em Vendas > Cadastros > Formas de pagamento.
    📸 Veja como configurar forma de pagamento PIX no Shop:

    Forma de Pagamento PIX.png
  2. No Spice, configure essa forma de pagamento na aba Mobile em Funções Administrativas > Configurações > Comanda Alterdata.

  3. A forma de pagamento será enviada automaticamente para a SmartPOS.

Se precisar validar a localização ou a finalidade dos campos, consulte Campos de PIX.

Funcionamento

  • Ao selecionar PIX como forma de pagamento na comanda, o QR Code é gerado na tela da maquininha.

  • O cliente escaneia o QR Code com o celular e finaliza o pagamento.

⚠️ Atenção: A funcionalidade do PIX depende do acordo e autorização entre o estabelecimento e a adquirente. Se a modalidade PIX não estiver habilitada na maquininha pela adquirente, o QR Code não será gerado e a transação não será concluída.

Modelos compatíveis com PIX

Adquirente

Modelos

Versão mínima

Rede

GPOS700 / L400

2.4 ou 68.0

Stone

P2 / A8

2.5 ou 68.0


7. Cashback

O recurso de Cashback na Comanda SmartPOS permite que o cliente acumule e resgate créditos diretamente no momento do fechamento da conta, incentivando a fidelização e o retorno ao estabelecimento.

📸 Veja como ativar a integração Cashback no Spice:

Integração Cashback no Spice.gif

Pré-requisito: configurações de cashback realizadas no Spice em Funções Administrativas > Configurações > Integrações > aba Cashback. Consulte Campos de Cashback para entender os campos envolvidos.

Passo a passo

  1. Vincule o CPF do cliente ao editar a mesa. Essa informação é essencial para identificar o saldo de cashback disponível.

  2. No fechamento da conta, toque na opção Cashback. A comanda verificará o saldo disponível para resgate.

  3. O cliente escolhe o valor a resgatar ou deixa zerado para continuar acumulando.

  4. O cliente receberá um SMS com um TOKEN no celular cadastrado. O garçom digita o TOKEN para validar o resgate.

  5. A comanda exibirá o saldo anterior e o valor recebido na compra. O fechamento segue normalmente.

💡 Dica: Caso o garçom esqueça de informar o CPF ao abrir a mesa, ao clicar em Cashback no fechamento, o sistema abrirá a opção para incluir o CPF naquele momento.

Cancelamento do resgate: toque no ícone de lixeira ao lado da opção Cashback para cancelar o resgate antes da conclusão.

⚠️ Atenção: Após a conclusão da conta na comanda, o valor de resgate do cashback não pode ser removido e o cliente não pode ser trocado.

💡 Dica: Se o estabelecimento encerra a conta na comanda apenas para bloquear a mesa, é possível verificar o valor do resgate no fechamento diretamente no Spice Desktop.


📋 Detalhamento de Campos do Sistema

Esta seção deve ficar no final do guia, depois dos passos de uso, para não interromper o fluxo principal. Ao longo da documentação, os links para esta seção devem aparecer nos pontos em que o usuário precisa configurar, validar ou entender o impacto de um campo: checklist, configurações pós-instalação, formas de pagamento, ticket unitário, PIX e cashback.

As tabelas abaixo detalham cada campo mencionado ao longo deste guia, seu impacto no negócio e a localização exata no sistema. Sempre que um passo a passo mencionar um campo, retorne aqui para consultar seu significado completo.

Campos da Configuração da Comanda

Localização: Comanda Alterdata > tela inicial > botão Configurações (senha: 12897722)

Campo

Objetivo

Onde fica no sistema

Id do dispositivo

Identifica de qual equipamento partiu cada pedido nas impressões de copa e cozinha. É gerado automaticamente e não precisa ser alterado.

Comanda Alterdata > Configurações

Nome da conexão

Facilita a identificação do dispositivo quando há múltiplas SmartPOS no estabelecimento.

Comanda Alterdata > Configurações

Endereço IP

Define o endereço da máquina onde o Spice Service API está instalado. Sem o IP correto, a comanda não se comunica com o Spice.

Comanda Alterdata > Configurações

Porta

Define a porta de comunicação com o Spice Service. O padrão 8877 facilita suporte e diagnóstico. Altere apenas se houver conflito com outro sistema.

Comanda Alterdata > Configurações

Time Out

Define o tempo máximo, em milissegundos, que a comanda aguarda resposta da API. O padrão 10000, ou 10 segundos, atende à maioria dos ambientes.

Comanda Alterdata > Configurações

Modo Terminal

Quando ativado, retorna à tela de login após cada pedido finalizado. É ideal para estabelecimentos onde vários garçons compartilham o mesmo dispositivo.

Comanda Alterdata > Configurações

Permitir edição da taxa

Permite que o garçom altere o valor da taxa de serviço ou couvert durante a venda, oferecendo flexibilidade no atendimento.

Comanda Alterdata > Configurações

Obter carga

Sincroniza os dados do Spice, como terminais, produtos e configurações, com a comanda. Use quando os terminais não estiverem aparecendo.

Comanda Alterdata > Configurações

Testar Wi-Fi

Valida se a conexão Wi-Fi do dispositivo está funcionando corretamente antes de iniciar o atendimento.

Comanda Alterdata > Configurações

Ver conexões

Exibe todas as conexões configuradas no dispositivo, permitindo alternar entre ambientes ou revisar configurações anteriores.

Comanda Alterdata > Configurações

Campos de Formas de Pagamento

Campo

Objetivo

Onde fica no sistema

Opção TEF no cadastro da forma de pagamento

Habilita a exibição da forma de pagamento em cartão na SmartPOS. Sem essa marcação, o cartão não aparecerá como opção de pagamento na comanda.

Spice + Shop: Vendas > Cadastros > Formas de pagamento > opção TEF. Spice Simples: Cadastros > Pagamentos > opção Utiliza TEF

Formas de pagamento Comanda Alterdata

Define quais formas de pagamento, como dinheiro, crédito, débito e voucher, estarão disponíveis na SmartPOS. Se um campo ficar vazio, aquela forma não será enviada para a comanda.

Spice > Funções Administrativas > Configurações > aba Comanda Alterdata

Formas de Pagamento SITEF

Vincula as bandeiras de cartão específicas para que o estabelecimento identifique exatamente qual bandeira foi utilizada em cada venda. Recurso não disponível para Spice Simples.

Shop > Vendas > Cadastros > Formas de Pagamento SITEF

Campos de Ticket Unitário

Campo

Objetivo

Onde fica no sistema

Imprimir tickets de itens unitários individualmente

Ativa a impressão de um ticket por unidade vendida, ideal para eventos e consumo avulso.

Spice Desktop > Funções Administrativas > Configurações > aba Impressão

Módulo de impressão Comanda POS

Define que os tickets unitários serão impressos pela SmartPOS, e não por outro módulo de impressão.

Spice Desktop > Funções Administrativas > Configurações > aba Impressão > Selecione os módulos de impressão

Sempre vender como unitário no PDV e Spice

Garante que o produto seja vendido sempre como unidade individual, habilitando a geração do ticket unitário.

Shop: Produtos e serviços > Cadastro de produtos > Unidades. Spice Simples: Cadastros > Produtos > Unidades > Quantidade unitária

Campos de PIX

Campo

Objetivo

Onde fica no sistema

Forma de pagamento tipo PIX

Cadastra o PIX como forma de pagamento disponível, permitindo a geração do QR Code na SmartPOS.

Shop > Vendas > Cadastros > Formas de pagamento > tipo PIX

Configuração PIX na aba Mobile

Envia a forma de pagamento PIX para a SmartPOS, habilitando o recebimento via QR Code na maquininha.

Spice > Funções Administrativas > Configurações > Comanda Alterdata

Campos de Cashback

Campo

Objetivo

Onde fica no sistema

Configurações de Cashback

Define as regras de acúmulo e resgate de cashback, como percentuais, limites e validade, habilitando o recurso na comanda.

Spice > Funções Administrativas > Configurações > Integrações > aba Cashback

CPF do cliente na mesa

Vincula o cliente à mesa para que o sistema identifique o saldo de cashback disponível para resgate.

Comanda Alterdata > Editar mesa > campo CPF


⌨️ Atalhos e Referências Rápidas

Ação

Atalho

Acessar configurações da Comanda

Comanda Alterdata > Configurações (senha: 12897722)

Configurar formas de pagamento

Spice > Funções Administrativas > Configurações > aba Comanda Alterdata

Marcar TEF na forma de pagamento no Shop

Shop > Vendas > Cadastros > Formas de pagamento > opção TEF

Marcar TEF na forma de pagamento no Spice Simples

Cadastros > Pagamentos > opção Utiliza TEF

Vincular bandeiras SITEF

Shop > Vendas > Cadastros > Formas de Pagamento SITEF

Ativar ticket unitário

Spice > Funções Administrativas > Configurações > aba Impressão

Cadastrar unidade do produto no Shop

Shop > Produtos e serviços > Cadastro de produtos > Unidades

Cadastrar unidade do produto no Spice Simples

Cadastros > Produtos > Unidades > Quantidade unitária

Configurar PIX

Spice > Funções Administrativas > Configurações > Comanda Alterdata

Configurar Cashback

Spice > Funções Administrativas > Configurações > Integrações > aba Cashback

Verificar código EC na Cielo

SmartPOS Cielo > Menu > Sobre > Número do EC

Atualizar app na Cielo

SmartPOS Cielo > Ajuda > Sobre Cielo LIO > Atualizar Aplicativos

Atualizar app na Stone

SmartPOS Stone > Menu > Ajustes > Verificar atualizações

🔗 Integração com o ecossistema Alterdata: A Comanda Alterdata SmartPOS opera integrada ao Spice, para gestão de mesas, pedidos e caixa; ao Shop/Wshop, para cadastro de produtos, formas de pagamento e SITEF; e ao Spice Service API, para comunicação entre a SmartPOS e a retaguarda. Alterações nas configurações de qualquer um desses sistemas impactam diretamente o funcionamento da comanda na maquininha.