Emissão de Pix e boleto no atendimento de emergência na região da Lapa

Como garantir que o técnico emita a cobrança e receba a confirmação antes de sair do imóvel na região da Lapa, sem depender de maquininha física ou sinal de celular instável?

O atendimento de emergência — desentupimento, vazamento, elétrica — exige velocidade não só na execução do serviço, mas no fechamento financeiro. Cada minuto gasto preenchendo dados de boleto ou esperando comprovante de transferência é um minuto a menos para o próximo chamado. A integração via API resolve isso ao transformar a emissão de Pix e boleto em etapa automática do fluxo de ordem de serviço.

Na prática, o técnico abre a OS no celular, finaliza o serviço e, com um toque, gera o QR Code Pix ou o boleto com vencimento no mesmo dia. O cliente paga na hora, o webhook confirma e a conciliação bate sozinha no dashboard. Sem digitação, sem erro humano, sem “depois eu confiro”.

Por que a emissão integrada muda o jogo na Lapa

A região da Lapa concentra comércio denso, condomínios verticais e ruas de trânsito intenso. Um técnico que atende emergência ali costuma rodar 8 a 12 chamados por plantão. Se cada cobrança leva 5 minutos manuais, são até 60 minutos perdidos por noite — tempo que vira receita quando a API assume o processo.

Além da velocidade, a integração elimina o risco de digitar valor errado, CPF/CNPJ incorreto ou esquecer de enviar o boleto. O payload da API puxa os dados da OS: cliente, valor, descrição do serviço, técnico responsável. O boleto sai com a numeração sequencial correta, juros e multa parametrizados, e o Pix carrega o identificador de conciliação (txid) que vincula tudo automaticamente.

Outro ponto crítico: a disponibilidade. Diferente de maquininhas que dependem de bateria e sinal de operadora, a API roda no backend do seu sistema. Se o celular do técnico fica sem internet, a OS fica pendente de sincronização e resolve assim que o sinal volta. Nenhum pagamento perdido, nenhuma cobrança duplicada.

Fluxo técnico: da OS à conciliação batida

1. Sistema de OS envia POST /v1/charges com amount, payer, due_date, metadata.os_id, metadata.tecnico_id, payment_methods: ["pix", "boleto"].
2. API retorna pix.qrcode, pix.qrcode_base64, boleto.url, boleto.linha_digitavel, charge_id.
3. App do técnico exibe QR Code na tela e botão “Enviar boleto por WhatsApp”.
4. Cliente paga → webhook charge.paid dispara com charge_id, paid_at, method, amount_received.
5. Backend atualiza OS para “Pago”, credita comissão do técnico se houver split, e envia comprovante ao cliente.
6. Dashboard financeiro reflete a entrada em tempo real, conciliada por txid (Pix) ou nosso_numero (boleto).

{
  "amount": 85000,
  "payer": {
    "name": "Condomínio Edifício Lapa Center",
    "document": "12.345.678/0001-90",
    "email": "sindico@lapacenter.com.br",
    "phone": "11999998888"
  },
  "due_date": "2024-01-15",
  "payment_methods": ["pix", "boleto"],
  "metadata": {
    "os_id": "OS-20240115-0042",
    "tecnico_id": "TEC-77",
    "bairro": "Lapa",
    "tipo_servico": "desentupimento_emergencia"
  },
  "split": [
    {"account_id": "ACC-TEC-77", "amount": 25500},
    {"account_id": "ACC-MATRIZ", "amount": 59500}
  ]
}

Esse payload único resolve emissão, split de comissão, metadados de conciliação e rastreabilidade por bairro. O técnico não decide nada — o sistema decide por ele.

Conciliação automática: o fim das planilhas de fim de mês

Quando cada pagamento carrega metadata.os_id e metadata.tecnico_id, a conciliação deixa de ser tarefa contábil e vira subproduto da operação. O dashboard da ViperPay permite filtrar:

• Por bairro: “Lapa” → vê todas as entradas da região
• Por técnico: “TEC-77” → performance individual
• Por método: Pix vs boleto → custo de cada canal
• Por status: pago, pendente, estornado, vencido

A tabela abaixo resume o ganho operacional:

Essa visibilidade permite decisões de gestão: se o Pix representa 78% dos recebimentos na Lapa, vale negociar taxa menor com o gateway. Se o boleto vencido sobe em segundas-feiras, ajusta a régua de cobrança para domingo à noite.

Segurança e conformidade no atendimento 24h

Plantão noturno não pode ser sinônimo de fragilidade. A API da ViperPay exige mTLS (certificado cliente + servidor), tokens de curta duração (JWT 15 min) e rate limiting por IP e conta. Cada requisição é assinada e auditada.

Para o técnico, a experiência é simples: login biométrico no app, token renovado em background. Para o gestor, logs completos de quem emitiu, quando, qual valor, qual OS. Em caso de disputa ou chargeback, a rastreabilidade está pronta — sem caçar e-mails ou prints de WhatsApp.

A conformidade com LGPD está embutida: dados do pagador trafegam criptografados, são armazenados pelo tempo regulatório e podem ser anonimizados via API de exclusão. O PCI DSS SAQ A-EP é coberto pela infraestrutura do gateway, tirando o escopo de certificação das suas costas.

Integração com ERP e sistemas legados

A maioria das empresas de emergência na Lapa roda ERP local ou sistema próprio de OS. A API REST segue OpenAPI 3.0, com SDKs em Python, Node.js, PHP, C# e Go. Webhooks usam assinatura HMAC-SHA256 para validação de origem.

Pontos de atenção na integração:

• Idempotência: envie Idempotency-Key no header para evitar cobranças duplicadas em retentativas de rede
• Ambiente sandbox: teste fluxo completo com Pix teste (BR Code estático) e boleto de homologação
• Versionamento: URL /v1/ garante estabilidade; migrações avisadas com 90 dias
• Suporte: canal Slack/Teams dedicado para clientes enterprise, SLA 4h em horário comercial

Se o seu ERP não tem API, a ViperPay oferece conector via planilha CSV/Excel com agendamento noturno — ponte temporária até a integração nativa.

Caso real: desentupidora na Lapa São Paulo

Uma recomendado que atende 24h implementou a API em duas semanas. Antes, o técnico ligava para a central, ditava dados, a atendente emitia boleto no internet banking, enviava foto por WhatsApp. Tempo médio: 7 minutos. Depois da integração: 12 segundos da finalização da OS ao QR Code na tela do cliente.

Resultado no primeiro mês: 340 atendimentos, 92% pagos via Pix na hora, 8% boleto D+0. Conciliação batida diariamente sem intervenção humana. Comissão dos técnicos creditada automaticamente na conta digital deles no mesmo dia. Inadimplência de boletos caiu de 14% para 3% com régua automática D+1/D+3/D+7 via WhatsApp.

O gestor passou a usar o dashboard para decidir alocação de equipes: bairros com maior ticket médio e maior adesão ao Pix receberam mais técnicos no horário de pico. Decisão baseada em dado, não em “achismo”.

Próximos passos para sua operação

Comece mapeando o fluxo atual: quantos minutos da OS à cobrança, quantos erros por mês, quanto tempo gasta conciliando. Depois, abra conta sandbox na ViperPay, gere as credenciais e implemente o endpoint de emissão no seu sistema de OS. Teste com 3 técnicos por uma semana. Meça. Ajuste. Escale.

A API não é projeto de TI — é ferramenta de receita. Cada minuto devolvido ao técnico é mais um chamado atendido, mais um cliente satisfeito, mais caixa no dia. Na Lapa, onde a densidade de chamados justifica plantão 24h, a matemática é simples: integração paga-se na primeira semana.

Pronto para transformar o financeiro da sua operação de emergência? A documentação técnica e o time de onboarding estão disponíveis para começar hoje.

Checklist prático

Perguntas frequentes