💰 Financeiro

Integrações com maquininha

Visão geral (Stone, PagSeguro, InfinitePay)

4 min de leitura
Vídeo em breve

Maquininha e o upOS

A maquininha de cartão é um dos equipamentos mais importantes de qualquer comércio brasileiro, e assistências técnicas não são exceção. Muitos clientes preferem pagar com cartão (débito ou crédito), e oferecer essa opção é praticamente obrigatório para não perder vendas.

Neste artigo, vamos explicar como o upOS se relaciona com as maquininhas e como configurar o sistema para que seus recebimentos em cartão sejam registrados corretamente.

Estado atual das integrações

No momento, o upOS não possui integração direta/automática com maquininhas de cartão. Isso significa que a cobrança é feita na maquininha separadamente e o registro do recebimento no upOS é feito manualmente. Essa é a realidade da maioria dos sistemas de gestão para pequenas empresas, e funciona perfeitamente com um processo bem organizado.

Integrações diretas com plataformas como Stone, PagSeguro, InfinitePay, Cielo e outras estão no roadmap do upOS para futuras versões. Quando implementadas, permitirão que o pagamento na maquininha gere automaticamente o registro de recebimento no sistema.

Como funciona hoje (processo manual)

O processo é simples e leva menos de 1 minuto:

  1. O cliente paga na maquininha normalmente (débito, crédito à vista ou parcelado).
  2. Após a aprovação da transação na maquininha, você registra o recebimento no upOS:
  3. Na OS ou na conta a receber, clique em "Registrar recebimento".
  4. Selecione a forma de pagamento (Cartão de Crédito ou Cartão de Débito).
  5. Informe o valor e confirme.
💡 Dica: Registre o recebimento no upOS IMEDIATAMENTE após a transação na maquininha. Não acumule para registrar depois — isso gera esquecimento e descasamento entre o financeiro do sistema e o saldo real da maquininha. Na prática, o fluxo fica: passa na maquininha → aprovado → registra no upOS → próximo atendimento.

Antecipação de recebíveis — conceito importante

A maioria das maquininhas no Brasil trabalha com antecipação de recebíveis. Na prática, isso significa que quando o cliente paga parcelado em 10x de R$ 100, você NÃO recebe R$ 100 por mês durante 10 meses. Em vez disso, a operadora antecipa o valor total de uma vez (descontando uma taxa) e deposita na sua conta.

No upOS, isso se reflete na configuração da forma de pagamento:

  • Cartão com antecipação (padrão): Independente de quantas parcelas o cliente escolheu, você registra UM recebimento no valor total. O parcelamento é informação do cliente, não do seu fluxo financeiro.
  • Cartão sem antecipação: Se sua operadora NÃO antecipa (raro), você recebe uma parcela por mês. Nesse caso, a forma de pagamento deve ter "aceita parcelamento" ativo no upOS, e cada parcela gerará uma conta a receber separada.
⚠️ Atenção: Verifique com sua operadora de cartão se você trabalha com antecipação de recebíveis. A maioria dos planos padrão de Stone, PagSeguro, InfinitePay e Cielo já vem com antecipação automática ativada. Configure a forma de pagamento no upOS de acordo com a sua realidade — isso afeta diretamente como as contas a receber são geradas.

Configurando formas de pagamento para cartão

Para que os recebimentos em cartão sejam registrados corretamente:

  1. Acesse Configurações → Formas de Pagamento.
  2. Edite (ou crie) a forma "Cartão de Crédito".
  3. Defina "Aceita parcelamento":
    • Não (padrão) — se usa antecipação de recebíveis. Gera 1 conta a receber única, independente do número de parcelas do cliente.
    • Sim — se NÃO usa antecipação. Gera N contas a receber, uma por parcela.
  4. Configure as condições de pagamento (à vista, 2x, 3x, 6x, 10x, 12x, etc.).
  5. Salve.

Faça o mesmo para "Cartão de Débito" (que geralmente é sempre à vista).

💡 Dica: No final de cada dia, compare o total de vendas em cartão registrado no upOS com o relatório de vendas da sua maquininha (acessível pelo app da operadora). Se os valores baterem, seu registro está correto. Essa conciliação diária leva 2 minutos e previne erros que se acumulam ao longo do mês.

Taxas de maquininha

As operadoras cobram taxas sobre cada transação (geralmente entre 1,5% e 5%, dependendo da bandeira, tipo de transação e plano contratado). Essas taxas são descontadas do valor que cai na sua conta. Para um controle mais preciso, você pode registrar as taxas como despesa mensal em Contas a Pagar — basta consultar o extrato da operadora no final do mês.