Acerto de caixa automático: Sitef e Winthor conciliados às 5h
A venda foi aprovada no PDV e no Sitef, mas o título ainda precisa ser acertado à mão na rotina 410 do Winthor. Veja como a conciliação Sitef × Winthor da Gothor faz esse acerto sozinha, todos os dias às 5h, e entrega o relatório do que acertou.
A venda foi aprovada no PDV e no Sitef, o cliente já saiu da loja com a mercadoria, e mesmo assim o trabalho do financeiro está só começando. No Winthor, o título daquela venda continua em aberto até alguém acertá-lo à mão na rotina 410, uma transação de cada vez.
Numa loja movimentada, isso passa de mil transações por dia. E cada venda parcelada multiplica o trabalho pelo número de parcelas.
O custo do acerto manual
O acerto de caixa feito transação por transação traz três problemas para a operação:
- Trabalho repetitivo. A equipe abre a 410 e acerta parcela por parcela, todos os dias, o que o sistema já sabe que foi pago.
- Custo operacional. O setor de acerto de caixa precisa de uma equipe grande só para acompanhar o volume de vendas.
- Falta de visão do todo. Para saber se o dia fechou, alguém precisa comparar o relatório do Sitef com o ERP manualmente.
O que a API de acerto faz
A conciliação Sitef × Winthor da Gothor é uma API que cruza as transações do Sitef com as prestações da PCPREST do Winthor e acerta os títulos automaticamente. O trabalho segue quatro passos:
- Busca. Consulta no Sitef as transações confirmadas, por loja e período.
- Cruzamento. Encontra a prestação correspondente na PCPREST pelos identificadores da venda.
- Acerto. Marca a parcela como acertada com os mesmos comandos da rotina 410.
- Relatório. Devolve tudo o que foi acertado automaticamente.
Os comandos vêm do rastreamento da própria 410: a API grava em PCFECHAMENTOMAP e atualiza a PCPREST, exatamente como a rotina faz. Não há regra de negócio nova, e o acerto altera apenas o necessário para marcar a parcela como acertada.
O caminho de uma venda
O fluxo acompanha o que já acontece na loja:
- PDV da loja: o cartão ou o Pix é aprovado no caixa.
- Sitef: a transação fica disponível para consulta.
- API de acerto: busca, cruza, decide e acerta.
- Oracle e Winthor: a prestação fica acertada na PCPREST.
Nada é instalado no PDV e nada é customizado no ERP. A API lê a transação pela consulta oficial do Sitef, o caixa continua operando como sempre, e não há alteração no Winthor nem gatilho no banco.
A consulta ao Sitef é feita em blocos de três horas, respeitando o limite de requisições por segundo do serviço.
Como a transação encontra a parcela
No cartão, a conciliação usa o NSU do TEF e do autorizador. No Pix, os identificadores do pagamento digital. Cada transação recebe um resultado, e cada resultado tem um comportamento definido:
| Resultado | O que significa | O que a API faz |
|---|---|---|
| Encontrada | A venda foi localizada e os valores fecham | Acerta, se ainda estiver em aberto |
| Já acertada | A prestação já tinha sido acertada antes | Não altera; só conta no relatório |
| Não encontrada | Não existe prestação correspondente | Não age; entra na conferência |
| Divergente | Mais de uma venda casou, ou a soma não fecha | Não age; mostra o que procurou |
| Sem contrapartida | Abertura de caixa, fatura, recarga, consulta de câmbio | Não age; fica fora da conta de erro |
A regra é simples: na dúvida, a API não escreve. Uma divergência vira item de conferência, nunca um palpite aplicado no banco.
A venda parcelada
A venda parcelada é o caso em que a conferência manual mais erra. O Winthor lança uma linha por parcela, e nenhuma delas tem o valor total da venda.
Numa venda de R$ 1.118,00 em dez vezes, a PCPREST tem 10 linhas de R$ 111,80. Procurar pelo valor da transação não encontra nada: nenhuma linha vale o total, e a venda nunca seria acertada.
A API agrupa as parcelas da mesma venda e confere a soma, que precisa bater no centavo. As dez parcelas são acertadas na mesma transação de banco: ou todas, ou nenhuma. Acertar só metade faria a venda sumir do relatório como resolvida.
Todo dia às 5h, sem ninguém
Às 5h, o movimento do dia anterior já fechou. A API processa esse dia inteiro, loja por loja, e já grava o acerto.
- O dia anterior inteiro. A data é calculada na hora da execução, nunca fixa.
- Uma loja por vez. Se uma falhar, por rede ou banco fora do ar, as outras seguem e o erro aparece com o nome da loja.
- Liga e desliga por loja. Um botão tira a loja do acerto automático sem desativá-la no sistema.
- Desligado, avisa. Quando o agendamento não roda, ele registra isso no log em vez de sumir em silêncio.
O horário é só o gatilho. O mesmo trabalho pode ser disparado pela tela ou pela API, para qualquer período.
Dois relatórios, duas perguntas
O relatório resumido responde "o que precisa de atenção?": traz os totais do período (quantas transações bateram, quantas não bateram e quantas estão ambíguas) e lista só o que não fechou, com os parâmetros usados na busca. É o relatório de quem fecha o caixa e quer saber onde olhar.
O relatório detalhado responde "me mostra tudo": transação por transação, com os dados do Sitef, se ela foi achada no ERP, se já foi acertada e quando, e a linha da PCPREST correspondente. É o relatório de quem precisa comprovar um caso específico.
Quando a parcela não é encontrada, o relatório diz exatamente o que foi procurado no ERP, e não apenas que falhou. Os dois relatórios filtram por loja, período, horário e caixa, e saem em JSON.
A tela de quem opera: rotina web 98630
Na Plataforma Web, a conciliação fica na rotina 98630, numerada no mesmo padrão das rotinas do Winthor. A equipe filtra por loja, período e caixa, acompanha a taxa de acerto e vê a data do acerto de cada transação.
Cada transação abre com o Sitef e o Winthor conferidos campo a campo: valor, autorização, NSU do TEF e NSU do host, com a parcela e a data do acerto.
Nas configurações, cada loja entra ou sai do acerto das 5h por um botão, sem ser desativada, e toda alteração fica registrada.
Escrever no ERP com segurança
Gravar no banco do Winthor exige cuidado, e a API foi construída em torno disso:
- Modo simulação. Qualquer operação pode rodar sem escrever: os comandos são montados e gravados para conferência, e nada muda no banco.
- Auditoria. Cada comando fica registrado com a matrícula, o nome e o horário de quem pediu. A execução das 5h aparece como sistema.
- Caminho de volta. É possível desfazer o acerto de um período e devolver as parcelas ao estado de não acertadas. Para isso, a API parte do registro do que ela mesma acertou; um acerto feito à mão por outra pessoa não é tocado.
- Tudo ou nada. O acerto só é confirmado se cada comando atingir exatamente a linha esperada. Qualquer desvio desfaz a operação inteira.
Medido em produção
Em testes em produção numa rede varejista que usa o Winthor, a API conferiu 50 mil transações, em 8 lojas e 5 dias de operação real. Na validação inicial, 99,45% das transações casaram de primeira (4.843 de 4.870).
Num único dia de uma das lojas, das 1.311 transações, 1.290 foram acertadas às 5h, sem ninguém abrir a 410, e nenhuma ficou com casamento duvidoso.
A conta que importa para a operação é outra: quantas horas por dia a equipe deixa de gastar abrindo a 410 parcela por parcela.
O que é preciso para começar
A implantação não pede mudança no PDV nem customização no ERP:
- Acesso ao Sitef: credencial de consulta das transações, por loja.
- Acesso ao Oracle: usuário com leitura e escrita nas tabelas que a 410 usa.
- Um servidor: um contêiner na rede interna, com saída para o Sitef.
- Simulação: rodar sem escrever até a conferência convencer.
Recomendamos começar pela simulação: sua equipe vê o que seria acertado, nos dados da própria operação, antes de autorizar a primeira escrita.
Para avaliar o acerto de caixa automático na operação da sua empresa, fale com a equipe da Gothor.
Este post foi escrito com a ajuda da Juniper, a assistente de IA da Gothor, e revisado pela nossa equipe antes de ir ao ar.
