SOP · INTEGRAÇÃO CONCILIADORA

Guia de Operação

O que a integração faz depois de configurada: as rotinas do dia a dia, o reenvio de lote, a renegociação, a situação da conciliação e como o atraso é recuperado.

Sumário

01   As quatro rotinas

02   Lote de envio e substituição de pacote

03   Renegociação 1›N

04   Status de conciliação

05   As rotinas agendadas

06   Ponteiros e retomada

As quatro rotinas

Enviando vendas

O envio reúne os títulos de cartão elegíveis do dia, por empresa, parceiro administração e estabelecimento. Para cada estabelecimento é gerado um pacote próprio, identificado por um número de lote.

Concluído o processamento, a aba Vendas recebe um registro por lote, com o retorno da Conciliadora. Erro no caminho vai para a aba Auditoria (Conciliadora).

Buscando pagamentos

É executada automaticamente às 17:30, ou pela operação Buscar Pagamentos, um estabelecimento por vez. O filtro aceita intervalo de data de pagamento, NSU ou TID.

Registros de Pagamentos e a grade Pagamentos

A grade Pagamentos funciona como registro de processamento: uma linha por vez que cada transação foi processada. No detalhe de cada linha estão os dados da Conciliadora, se a baixa saiu e por que não saiu.

É normal um título não baixar. As falhas mais comuns são divergência de NSU ou TID, divergência de parcelas e divergência de valores. O operador lê a linha, entende a falha e corrige na Mov. Financeira ou na Conciliadora.

ATENÇÃO: Nenhum registro na grade Pagamentos? Antes de suspeitar da busca, consulte a Auditoria (Conciliadora): erro de comunicação ou de configuração interrompe o processo antes de gerar a linha de pagamento.

Buscando cancelamentos

Espelho da busca de pagamentos, com uma diferença: nada é baixado. Os cancelamentos são registrados na aba Cancelamentos para análise caso a caso pela operação — cancelar venda não é processo trivial e não é automatizável. Essa aba precisa ser consultada com regularidade.

Buscando taxa de aluguel

As taxas são baixadas junto com o pagamento, sem ação extra. O financeiro da taxa é gerado com os dados da aba Taxa Aluguel do estabelecimento e utiliza a TOP do parâmetro TDCCONTOPBTXAL.

Lote de envio e substituição de pacote

A Conciliadora identifica um pacote de vendas pela combinação ID Empresa + Lote + Data. Repetir a combinação não cria pacote novo: substitui o que estava lá. Todo o comportamento de reenvio do SOP se apoia nisso.

Como o número do lote é montado

O número sai do Índice do Lote de Envio do estabelecimento, multiplicado por mil, mais um sequencial diário. Índice 1 gera os lotes 1001, 1002, 1003…

• Índice do Lote de Envio — identifica o estabelecimento dentro do seu ID Empresa. Atribuído no primeiro envio e nunca alterado. É o que impede dois estabelecimentos que compartilham o mesmo ID de empresa de colidirem.

• Sequencial diário — reinicia todo dia, porque a data faz parte da identificação do lote. Teto de 999 envios por estabelecimento por dia.

Reenviar um lote pela tela

No popup Enviar Vendas, o campo Substituir Lote pesquisa entre os lotes já enviados.

• A seleção precisa vir da lupa: o número do lote se repete entre dias, e só o registro completo traz a data junto.

• Selecionado o lote, o período é preenchido com a data dele e travado — a data do reenvio sai do lote, nunca dos campos de data.

• O reenvio relê as vendas já gravadas naquele lote, e não a apuração de elegíveis: o pacote original precisa voltar inteiro, inclusive os títulos que já foram baixados desde então.

• O lote pertence a um único estabelecimento; os demais da seleção são ignorados.

• Lote não encontrado ou ambíguo devolve erro indicando as datas candidatas, em vez de eleger uma arbitrariamente.

ATENÇÃO: Pacote vazio exclui o lote. Enviar a mesma combinação sem nenhum registro remove o pacote na Conciliadora. É a única forma de excluir um pacote — e também a causa de exclusões acidentais.

Renegociação

O número do financeiro é o que identifica a venda na Conciliadora. Renegociar um título encerra esse número e cria descendentes vivos — e o pacote enviado passa a apontar para um identificador que não existe mais. A rotina das 06:00 corrige isso automaticamente.

A rotina noturna que ressincroniza os lotes afetados por renegociação.

Por que a prontidão é all-or-nothing

A substituição regrava o lote inteiro. Se uma das parcelas vivas ainda não pode ser enviada, substituir apaga o vínculo do título obsoleto e a parcela pendente perde qualquer ligação com o lote — não volta a ser detectada. Por isso o lote inteiro espera, e o motivo fica registrado.

Os três informativos e o que fazer com cada um

Fora da janela

Lotes afetados anteriores à janela configurada em TDCCONDRREN não são ressincronizados; a contagem sai apenas no log do servidor, com aviso. O corte existe para que o trabalho de cada noite não seja proporcional a todo o histórico desde o go-live.

Nos defaults, TDCCONDRREN e TDCDIASLIMLOG coincidem em 365 dias — reduzir o primeiro cria uma faixa de lotes que ainda existem mas não são mais alcançados.

Status de conciliação

Enviar a venda não garante que a Conciliadora conseguiu casá-la com a transação da adquirente. Essa rotina pergunta, de hora em hora, o que aconteceu com cada título enviado — e escreve a resposta no próprio financeiro.

Códigos que a API devolve

Campos gravados na Mov. Financeira

Aba Conciliadora na Mov. Financeira

Como a rotina escolhe o que consultar

• Considera os títulos já enviados cujo status ainda não é Venda conciliada.

• Agrupa por data de negociação e faz uma consulta por dia, não uma por título.

• Para em TDCCONMAXDIA dias por execução — 15 no default.

• Título já conciliado não é reconsultado: o status conciliado é terminal.

Consulta pontual, um título por vez

Na Mov. Financeira, duas ações resolvem o caso isolado sem aguardar a rotina:

• (Conciliadora) Consultar status conciliação — consulta o status do título selecionado e regrava os campos de status. Resolve o título vivo quando houve renegociação.

• (Conciliadora) Consultar valor taxa conciliação — consulta o valor da taxa da venda e atualiza a Taxa Administradora do título.

As rotinas agendadas

Todas iteram os estabelecimentos ativos e são tolerantes: erro em um estabelecimento não interrompe os demais. Os agendamentos estão em Guia de Configuração › Agendamento.

Existe ainda a busca de locação de ponto de venda, às 16:30 — funcionalidade não suportada, veja Guia de Locação de Ponto de Venda.

Correção de parceiros

Com TDCVALTIPTIT ligado, o SOP passa a intervir no parceiro do financeiro de cartão: guarda o parceiro da nota em Cód. Parceiro Origem e coloca a administradora do tipo de título — o campo Parc.Administradora — no parceiro do título. A rotina de sábado varre e corrige o que ficou fora desse padrão.

Ponteiros e retomada

As duas rotinas de fluxo contínuo não trabalham com data fixa. Cada uma guarda no estabelecimento a data do último dia que processou e usa essa data como ponteiro para saber onde parou.

Como cada execução escolhe o dia e o que acontece com o ponteiro.

Estabelecimento muito atrasado recupera 1 dia por execução. Para acelerar o envio de vendas, utilize o envio manual com intervalo — mas note que ele não avança o ponteiro, então o automático continuará percorrendo os mesmos dias.