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

Comanda Alterdata SmartPOS

A Comanda Alterdata SmartPOS integra o lançamento de pedidos, o fechamento da conta e o recebimento de pagamentos diretamente na maquininha dentro do ecossistema Spice. Use este guia para configurar o Spice, validar os modelos compatíveis e operar recursos como PIX, Ticket Unitário e Cashback; quando precisar entender a finalidade de algum campo, consulte o Detalhamento de Campos.

Antes de começar

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

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.

Funcionamento geral e 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ú)

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.

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.

Cielo e Stone com código de liberação

Observação: Ao adquirir a máquina, a desenvolvedora disponibiliza um código de identificação para liberar a instalação.

Passo a passo de instalação com código

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

Atualização manual

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

Rede, Getnet, Safra e Itaú 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.

📋 Detalhamento de Campos — Instalação da Comanda

Campo

Onde fica no sistema

Objetivo

Número do EC

SmartPOS Cielo > Menu > Sobre

Identifica o estabelecimento comercial para liberação do aplicativo no portal da Cielo.

Stonecode

Portal ou canais de atendimento Stone

Identifica o estabelecimento para liberação do aplicativo no portal da Stone.

Atualizar Aplicativos

Cielo LIO > Ajuda > Sobre Cielo LIO > Atualizar Aplicativos Cielo LIO

Força a busca e instalação dos aplicativos liberados para a maquininha.

Verificar atualizações

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

Valida se o aplicativo já foi disponibilizado após a liberação.

Configurações na Comanda Alterdata Pós-Instalação

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

Campos da Configuração da Comanda.png

Acessar configurações

  1. Na tela inicial da Comanda Alterdata, toque em Configurações, na parte inferior da tela.

  2. Informe a senha 12897722.

Preencher dados de conexão

  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.

📋 Detalhamento de Campos — Configurações Pós-Instalação

Campo

Onde fica no sistema

Objetivo

Id do dispositivo

Comanda Alterdata > Configurações

Identifica de qual equipamento partiu cada pedido nas impressões de copa e cozinha.

Nome da conexão

Comanda Alterdata > Configurações

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

Endereço IP

Comanda Alterdata > Configurações

Define o endereço da máquina onde o Spice Service API está instalado.

Porta

Comanda Alterdata > Configurações

Define a porta de comunicação com o Spice Service; o padrão é 8877.

Time Out

Comanda Alterdata > Configurações

Define o tempo máximo, em milissegundos, que a comanda aguarda resposta da API.

Modo Terminal

Comanda Alterdata > Configurações

Retorna à tela de login após cada pedido finalizado quando vários garçons compartilham o mesmo dispositivo.

Permitir edição da taxa

Comanda Alterdata > Configurações

Permite alterar taxa de serviço ou couvert durante a venda.

Obter carga

Comanda Alterdata > Configurações

Sincroniza os dados do Spice, como terminais, produtos e configurações.

Testar Wi-Fi

Comanda Alterdata > Configurações

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

Ver conexões

Comanda Alterdata > Configurações

Exibe todas as conexões configuradas no dispositivo.

Funcionamento da Comanda com SmartPOS

A rotina de funcionamento da Comanda Alterdata na SmartPOS é idêntica à do celular. A grande vantagem é 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.

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.

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.

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.

📋 Detalhamento de Campos — Funcionamento e Pagamento

Campo

Onde fica no sistema

Objetivo

Ver Conta

Comanda Alterdata > mesa/comanda selecionada

Exibe os itens vendidos, totais, cliente, pessoas, descontos, acréscimos e taxas.

Receber / Receber Conta

Comanda Alterdata > fechamento da conta

Inicia o recebimento e permite selecionar as formas de pagamento configuradas.

Formas de pagamento Comanda Alterdata

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

Define quais formas, como dinheiro, crédito, débito e voucher, estarão disponíveis na SmartPOS.

Status Em pagamento

Spice Desktop > mesa em fechamento

Indica que a conta foi recebida na comanda e aguarda confirmação manual no caixa.

Formas de Pagamento SITEF

Shop > Vendas > Cadastros > Formas de Pagamento SITEF

Vincula bandeiras de cartão para identificar a bandeira utilizada em cada venda. Recurso não disponível para Spice Simples.

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.

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

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

📋 Detalhamento de Campos — Ticket Unitário

Campo

Onde fica no sistema

Objetivo

Imprimir tickets de itens unitários individualmente

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

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

Módulo de impressão Comanda POS

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

Define que os tickets unitários serão impressos pela SmartPOS.

Sempre vender como unitário no PDV e Spice

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

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

Quantidade unitária

Spice Simples > Cadastros > Produtos > Unidades

Habilita a unidade para venda unitária no Spice Simples.

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
  1. No Spice, configure essa forma de pagamento na aba Mobile em Funções Administrativas > Configurações > Comanda Alterdata.

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

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

📋 Detalhamento de Campos — PIX

Campo

Onde fica no sistema

Objetivo

Forma de pagamento tipo PIX

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

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

Configuração PIX na aba Mobile

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

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

Modalidade PIX habilitada

Configuração/contrato da adquirente da SmartPOS

Permite que a maquininha gere o QR Code e conclua a transação.

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

Observação: Antes de usar o recurso, configure o Cashback no Spice em Funções Administrativas > Configurações > Integrações > aba Cashback.

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 — Cashback

Campo

Onde fica no sistema

Objetivo

Configurações de Cashback

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

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

CPF do cliente na mesa

Comanda Alterdata > Editar mesa > campo CPF

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

TOKEN

SMS enviado ao celular cadastrado do cliente

Valida o resgate do cashback no fechamento da conta.

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.