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:
-
Cielo: código EC (Estabelecimento Comercial). Acesse Menu > Sobre e localize o Número do EC, com 16 caracteres.
-
Stone: código Stonecode. Consulte o passo a passo em https://ajuda.stone.com.br/onde-encontro-meu-stonecode.
Passo a passo
-
Envie o código, EC ou Stonecode, para a Alterdata (DSN Shop) através do suporte de canais.
-
A Alterdata fará o vínculo do Spice no portal da desenvolvedora.
-
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:
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.
-
Verifique o Id do dispositivo gerado automaticamente.
-
Defina o Nome da conexão para identificar facilmente o dispositivo.
-
Informe o Endereço IP da máquina onde o Spice Service (API) está instalado.
-
Confirme a Porta, por padrão 8877. Altere apenas se já estiver em uso por outro sistema.
-
Mantenha o Time Out no padrão 10000, salvo orientação do suporte.
-
Ative o Modo Terminal se vários garçons compartilham o mesmo dispositivo.
-
Defina se deseja Permitir edição da taxa, como taxa de serviço ou couvert, durante a venda.
-
Clique em Obter carga para sincronizar os dados com a API.
-
Use Testar Wi-Fi para validar a conexão de rede.
-
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
-
Abra a Comanda Alterdata na SmartPOS e informe usuário e senha.
-
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
-
Toque sobre a mesa/comanda desejada e selecione Ver Conta para visualizar os itens vendidos e os totais.
-
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.
-
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
-
Toque em Receber ou Receber Conta. Serão exibidos o valor a receber, o total por pessoa e as formas de pagamento configuradas.
-
Informe a forma de pagamento. É possível realizar pagamento parcial, adicionando múltiplas formas até completar o valor total.
-
Se a forma de pagamento for cartão, o pagamento será processado diretamente pela SmartPOS.
-
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:
Ativação no Spice Desktop
-
Na tela principal, acesse Funções Administrativas > Configurações > aba Impressão.
-
Marque a opção Trabalho imprimindo tickets individuais de itens unitários.
-
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:
-
No Shop, acesse Produtos e serviços > Cadastro de produtos > Unidades.
-
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:
-
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:
-
No Spice, configure essa forma de pagamento na aba Mobile em Funções Administrativas > Configurações > Comanda Alterdata.
-
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:
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
-
Vincule o CPF do cliente ao editar a mesa. Essa informação é essencial para identificar o saldo de cashback disponível.
-
No fechamento da conta, toque na opção Cashback. A comanda verificará o saldo disponível para resgate.
-
O cliente escolhe o valor a resgatar ou deixa zerado para continuar acumulando.
-
O cliente receberá um SMS com um TOKEN no celular cadastrado. O garçom digita o TOKEN para validar o resgate.
-
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.