# Programação de Operações de Cobrança
# Versão 1

# FINALIDADE
A aplicação Programação de Operações de Cobrança tem como objetivo automatizar e programar, em segundo plano, as operações de cobrança terceirizada, conforme as necessidades de cada empresa. As operações programáveis são:
- SFCB/CBPS – Processamento de solicitações de cobrança
- CBRM – Geração de arquivo de remessa
- CBRT – Geração de arquivo de retorno
- CBRC – Carga de arquivo de retorno da carteira de cobrança
- CBCN – Conversão da cobrança terceirizada
- CBEX – Verificação de prazo de cobrança expirado
- CBCH – Checagem dos débitos pendentes de remessa
Antes de utilizar esta aplicação, é necessário:
- O cadastro de convênio de cobrança terceirizada — do tipo CTEO, subtipo COB, ativo e dentro da vigência —, por meio da aplicação Contrato de Convênio.
- O cadastro e a parametrização da solicitação de cobrança, por meio da aplicação Cadastro de Solicitação de Cobrança.
# COMO ACESSAR
Login > Workspace Cobrança > Página Boas-Vindas > Programação de Operações de Cobrança

# PARÂMETROS DE COBRANÇA
Ao acessar a aplicação, o card Parâmetros de Cobrança é exibido com os campos Empresa, Base Cálculo da Comissão e Geração de Remessas, pré-preenchidos conforme a configuração da empresa selecionada. Esses campos são somente leitura nesta tela; sua alteração depende do parâmetro de sistema COB (ver seção ESPECIFICIDADES).

# OPERAÇÕES A SEREM PROGRAMADAS
No card Operações a serem programadas, selecione uma das operações listadas por meio do botão de seleção (radio). Ao selecionar uma operação, o campo “O que essa operação faz?” exibe uma descrição do comportamento dela. Para a operação SFCB/CBPS, por exemplo, o sistema exibe: “Seleciona faturas das solicitações de cobrança e atualiza status (AG - AGUARDANDO → EP - EM PROCESSAMENTO → GE - GERADA).”

O comportamento de cada operação é:
# SFCB/CBPS – Processamento de Solicitações
Seleciona faturas conforme critérios definidos nas solicitações de cobrança com status “AG - AGUARDANDO”. Durante o processamento, passam para “EP - EM PROCESSAMENTO” e, ao final, “GE - GERADA”. Os resultados do processamento podem ser consultados na tela de Manutenção de Espelho de Cobrança.
# CBRM – Geração de Arquivos de Remessa
Cria arquivos de remessa para cada prestador de serviço, contendo faturas selecionadas, substituídas ou renegociadas.
# CBRT – Geração de Arquivos de Retorno
Gera arquivos com informações sobre faturas em cobrança (arrecadação, cancelamento, renegociação etc.). Faturas locadas são ignoradas.
# CBRC – Carga de Arquivos de Retorno da Carteira de Cobrança
Processa arquivos enviados pelos prestadores informando faturas incobráveis e seus motivos. Os arquivos utilizam a extensão .COB; ao final do processamento, recebem a extensão .OK em caso de sucesso ou .ERR em caso de erro. As faturas processadas são marcadas como “retornadas”.
# CBEX – Verificação de Prazo de Cobrança Expirado
Requer perfil administrativo. Verifica se o prazo de vencimento da cobrança, definido no cadastro do convênio (ex.: 30 dias), foi ultrapassado. Débitos com prazo de cobrança expirado são removidos das próximas programações da solicitação.
# CBCH – Checagem dos Débitos Pendentes de Remessa
Requer perfil administrativo. Realiza a checagem dos débitos pendentes, garantindo que as faturas estejam corretamente marcadas como “em cobrança”. Etapa obrigatória tanto na geração de remessa quanto de retorno.
# CBCN – Conversão da Cobrança Terceirizada
Requer perfil administrativo. Permite conversões entre os modelos de controle por UC e UC/Cliente. Ver seção CONVERSÃO DA COBRANÇA TERCEIRIZADA (CBCN).
# PROGRAMAR OPERAÇÃO
Após selecionar a operação desejada, clique no botão PROGRAMAR. O sistema verifica o parâmetro de sistema LBG – Programação de Operações em Background.

Na tela Programação do background, os campos disponíveis são: Tipo de Operação, Solicitante e, no modo em lote: Lote, Data de Execução, Hora da Execução, Quantidade de Execuções e Periodicidade de execução em lote (Única, Diária, Semanal, Quinzenal ou Mensal), além do campo Observações. Os botões CONSULTA e PARÂMETROS também estão disponíveis para consulta de dados relacionados à programação.

Clique em SALVAR para confirmar a programação, ou CANCELAR para descartar.
# CONVERSÃO DA COBRANÇA TERCEIRIZADA (CBCN)
Ao selecionar a operação CBCN – Conversão da cobrança terceirizada e clicar em PROGRAMAR, o sistema exibe o modal “Tipo de conversão”, solicitando a escolha entre:
- UC para UC/CLIENTE
- UC/CLIENTE para UC

Esse comportamento é controlado pelo parâmetro de sistema CUC. A conversão UC → UC/Cliente é necessária quando o controle passa a considerar o cliente da UC, e impede novas solicitações até que a conversão seja concluída. A conversão UC/Cliente → UC reverte o controle para UC única por convênio — UCs duplicadas ou com clientes diferentes são inativadas, e seus débitos cancelados e liberados para nova seleção.
Clique em CONTINUAR para prosseguir com o tipo de conversão selecionado, ou CANCELAR para fechar o modal sem programar.
# CONFIRMAÇÃO DA PROGRAMAÇÃO
Ao salvar uma programação em lote, o sistema exibe uma caixa de diálogo de confirmação, resumindo os dados informados (data de execução, tipo de lote e horário de início) e perguntando “Confirmar programação?”.

Para prosseguir, clique em CONFIRMAR; para cancelar, clique em CANCELAR.
# VALIDAÇÕES DO SISTEMA
# ESPECIFICIDADES
Parâmetros de sistema que definem o comportamento da cobrança terceirizada:
| FUNÇÃO | PARÂMETROS | STATUS/COMPORTAMENTO |
|---|---|---|
| CUC – Controle por UC e Cliente | S / N | S: controle por Unidade Consumidora (UC) e cliente. N ou diferente de S: controle apenas por UC. |
| RTZ – Reativação Automática | S / N | S: reativação automática da UC ou UC/Cliente habilitada. N ou diferente de S: desabilitada. |
| IAC – Inativação Automática | S / N | S: inativação automática da cobrança terceirizada habilitada. N ou diferente de S: desabilitada. |
| EXP – Disponibilização de Fatura Expirada | S / N | S: o débito pode ser novamente selecionado. N ou diferente de S: o débito não será reutilizado. |
| RBC – Retirada de Débitos da Cobrança Terceirizada | 3 argumentos | Define regras para retirada automática de débitos em casos específicos de alteração nas características das UCs. |
| COB – Controle de Operações de Cobrança | PAGO/EMITIDO, MAN/AUT | 1ª posição (PAGO/EMITIDO): define a base de cálculo da comissão do prestador — se trabalha com o valor pago ou o valor emitido da fatura. 2ª posição (MAN/AUT): define a geração do arquivo de remessa ao final do processamento. AUT: geração automática, sem necessidade de validação manual. MAN: geração manual — após a solicitação atingir a situação GE, é necessário validar o processamento na tela de Manutenção de Espelho de Cobrança antes de prosseguir. |
| LBG – Programação de Operações em Background | S / N | S: abre a tela de Programação do background no modo de lote. N ou diferente de S: abre no modo avulso. |
# Reestruturação das operações de remessa e retorno (a partir da v1.12)
- Geração de Arquivo de Remessa: CBCH (checagem dos débitos pendentes) → CBRM (geração do arquivo de remessa) → CBCL (cálculo da faixa de comissão, executada apenas se o convênio estiver configurado para isso).
- Geração de Arquivo de Retorno: CBCH (checagem dos débitos pendentes) → CBEX (verificação de débitos com prazo de cobrança expirado) → CBRT (geração do arquivo de retorno).
# Considerações importantes
- A ordem recomendada de execução é: SFCB → CBRM → CBRT.
- Mesmo com convênios vencidos, arquivos de remessa e retorno ainda podem ser gerados se houver pendências.
- Parcelas de negociação vinculadas à fatura de energia só são geradas com o faturamento mensal da UC.
- Parcelamentos pagos geram comissões para o prestador, mesmo após o fim da vigência do convênio.
# PROCEDIMENTOS BÁSICOS - SÍMBOLOS E CONVENÇÕES
Info: Ícones de informação (representados por um “i” dentro de um círculo) exibem dicas ou instruções adicionais ao passar o cursor sobre eles.
Demais convenções (ex.: campos obrigatórios com asterisco) devem ser confirmadas com base nas telas reais do ambiente de homologação antes da publicação desta DU.
# REQUISITOS DE USUÁRIOS
Principais ações que os usuários poderão executar ao acessar a funcionalidade de Programação de Operações de Cobrança.
| USUÁRIO | RESPONSABILIDADES |
|---|---|
| Cobrança | Programar operações de cobrança terceirizada (SFCB/CBPS, CBRM, CBRT, CBRC) |
| Cobrança — perfil administrativo | Programar conversão da cobrança terceirizada (CBCN), verificação de prazo de cobrança expirado (CBEX) e checagem dos débitos pendentes de remessa (CBCH) — acesso restrito a usuários com perfil administrativo |
# RELATÓRIO DE INCIDÊNCIAS
Seção destinada a resolução de problemas e erros que podem ocorrer e como pode ser solucionado.
| PROBLEMA | CAUSA | SOLUÇÃO |
|---|---|---|
# DOCUMENTOS RELACIONADOS
| TÍTULO | LINK |
|---|---|
| Contrato de Convênio | - |
| Cadastro de Solicitação de Cobrança | - |
| Manutenção de Espelho de Cobrança | Manutenção de Espelho de Cobrança |