Entidade LOPS

FINANC.LOPS

Descrição

O LOP (Localização, Operação e Portador) permite definir onde (localização, p.ex.: banco, carteira, advogado), tipo de cobrança (operação, p.ex.: cobrança simples, cobrança descontada, Vendor, cobrança judicial) e quem (portador, p.ex.: empresa, nome do banco, nome do escritório de cobrança, nome do advogado/escritório) um título financeiro encontra-se para o processo de cobrança.

No LOP são informadas as regras e configurações financeiras de cobrança do título, p.ex.: percentual de juros de mora diário por atraso, número de dias para protesto, tipo de impressão de boleto bancário, etc.

As regras e configurações do LOP são utilizadas para geração dos títulos, emissão de boletos de cobrança bancária e para envio dos títulos para registro nos bancos através de arquivos CNAB.

No caso do estabelecimento ter uma integração para processar pagamentos de comércio eletrônico, é o LOP que indica todos os parâmetros necessários para estabelecer o processamento das respectivas transações.

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Chave de identificação interna
LOPUPPERRqd UK LOP:
O LOP (Localização, Operação e Portador) permite definir onde (localização, p.ex.: banco, carteira, advogado), tipo de cobrança (operação, p.ex.: cobrança simples, cobrança descontada, Vendor, cobrança judicial) e quem (portador, p.ex.: empresa, nome do banco, nome do escritório de cobrança, nome do advogado/escritório) um título financeiro encontra-se para o processo de cobrança.
LOCALIZACAO_IDID(18)Rqd FK Localizacão:
Localização do título.

Referência para LOCALIZACOES
OPERACAO_IDID(18)Rqd FK Operacão:
Operação de cobrança do título.

Referência para OPERACOES
PORTADOR_IDID(18)Rqd FK Portador:
Portador do título.

Referência para PORTADORES
CONTA_CORRENTE_IDID(18)FK Conta corrente:
Conta corrente bancária a qual o LOP está vinculado.

Referência para CONTAS_CORRENTES
TIPO_OPERACAOSELECTION_CHECK(5)Rqd Tipo de operação:
Define o tipo de operação do título.

Valores permitidos:
  • R - Receber - Compromissos devidos por clientes e demais devedores da empresa.
  • P - Pagar - Compromissos a pagar para fornecedores de produtos e serviços.
  • T - Terceiros - O compromisso de pagamento/recebimento não cabe a empresa, e sim a emitente e um destinatário diferente.

Valor padrão = R
DIAS_INADIMPLENCIAINTEGERRqd Dias para inadimplência:
Número de dias para o título ser considerado como inadimplente.
Somente será considerado como inadimplente caso informado o conceito.

Valor padrão = 15
JURO_DIAPERCENT(18)Juros ao dia (mora diária):
Valor em percentual (%) que será utilizado para cálculo dos juros (simples) a serem cobrados sobre o valor do título para cada dia de atraso no pagamento.
P.ex.: Se o percentual de juros mensal for de 1% (um por cento), deve-se informar o percentual diário, calculado da seguinte forma: juros ao mês dividido por 30, no que no exemplo seria: 1 / 30 = 0,03333 (juros ao dia de 0,03333%).
ATIVOFLAG(1)Rqd Ativo:
Define se o LOP está ativo e pode ser utilizado nos títulos.

Valor padrão = S
ESTABELECIMENTO_IDID(18)FK Estabelecimento:
Estabelecimento responsável pelo LOP.

Referência para ESTABELECIMENTOS
DIAS_PROTESTOINTEGERDias para protesto/negativação:
Número de dias para envio dos títulos não pagos para protesto ou negativação nos serviços de proteção ao crédito, tais como SPC e Serasa. P.ex.: O título deve ser enviado para protesto caso não seja baixado ou pago em até 3 dias úteis após o seu vencimento.
NUMERO_LOTEINTEGERNúmero de lote de remessa:
Número do último lote enviado de arquivo de cobrança leiaute CNAB para o banco.
TIPO_IMPRESSAOOPCAO(1)Rqd Tipo de impressão de boleto:
Tipo (modelo) de impressão do boleto bancário.

Valores permitidos:
  • B - Banco - Impressão do boleto é de responsabilidade do banco. Não envia o título no e-mail anexado.
  • M - Matricial - Impressão do boleto em impressora matricial em formulário contínuo fornecido pelo banco.Não envia o título no e-mail anexado.
  • N - Nenhum - Não haverá impressão de boleto de cobrança bancário. Não envia o título no e-mail anexado.
  • 1 - PDF - Impressão do boleto em arquivo padrão PDF, utilizando a biblioteca jBoleto.
  • 2 - PDF - 2 página - Impressão de 2 boletos por página.
  • 3 - PDF - 3 página - Impressão de 3 boletos por página.
  • 4 - PDF - Com recibo sacado - Impressão de um boleto por página em arquivo padrão PDF.
  • 5 - PDF - Com recibo sacado e verso - Impressão de um boleto por página em arquivo padrão PDF.
    Será impresso uma segunda página em cada boleto com informações para entrega

Valor padrão = N
PERCENTUAL_MULTAPERCENT(18)Percentual de multa:
Percentual (%) de multa por atraso no pagamento do título.
TIPO_ENVIO_BANCOOPCAO(3)Tipo de envio para banco:
Padrão de leiaute de arquivo de remessa ou retorno dos movimentos bancários.

Valores permitidos:
  • 240 - CNAB 240 - Formato de arquivo com 240 caracteres por linha.
  • 400 - CNAB 400 - Formato de arquivo com 400 caracteres por linha.
CARTEIRATEXT(3)Carteira:
Identificação (código) para carteira definida pela operação de cobrança com banco ao qual o LOP se referencia.
A carteira informada no LOP será desconsiderada se houver uma carteira informada no cadastro da conta corrente vinculada ao LOP.
CONVENIOTEXTConvênio bancário:
Número do convênio (contrato) estabelecido entre a empresa e o banco.
Esta informação será desconsiderada se houver um convênio informado no cadastro da conta corrente vinculada ao LOP.
VARIACAO_CARTEIRATEXTVariação para carteira:
Variação para carteira, fornecida pelo banco responsável para registro ou cobrança do título.
PREFIXO_TITULOTEXTPrefixo para os títulos:
Prefixo do título conforme instruções fornecidas pelo banco onde o título será registrado ou cobrado.

Pode ser informado no banco a codificação para o prefixo/tipo de título na interface CNAB.CAD_BANCOS_CODIGOS_ESPECIES_TITULOS, que está na guia de bancos.

P.ex.: Banco do Brasil:
  • Carteiras 31 e 51: Preencher com SD.
  • Carteira 12: Preencher com AIU.
  • Demais carteiras: Preencher com AI.

Exemplos:
  • SD
  • DM
PROTESTAR_DIASOPCAO(1)Rqd Forma de protesto:
Informação da forma e instrução de como o título deve ser protestado por falta de pagamento.

Valores permitidos:
  • 1 - Dias corridos - O título deve ser protestado após N dias corridos após o seu vencimento, incluindo sábados, domingos e feriados.
  • 2 - Dias úteis - O título deve ser protestado N dias úteis após o seu vencimento, não incluindo sábados, domingos e feriados.
  • 3 - Não protestar - O título não deve ser protestado após o seu vencimento.
  • 8 - Negativação - O título deve ser negativado após N dias corridos após o seu vencimento, incluindo sábados, domingos e feriados.
    Deve ser validado com o banco se existe a possibilidade.

Valor padrão = 1
ACEITEFLAG(1)Rqd Aceite:
Informação do aceite do título pelo sacado.

Valor padrão = N
MODALIDADE_COBRANCATEXTModalidade de cobrança:
Modalidade de cobrança utilizado para definição do leiaute e padrão do boleto de cobrança bancária.
Não precisa ser informada quando o título é enviado ao banco através de arquivo de remessa CNAB e a impressão do boleto utiliza o mesmo número de carteira de cobrança.
NOSSO_NUMERODECIMAL(40)Nosso número:
Próximo número a ser utilizado na sequenciação dos títulos para o banco.
O "nosso número" refere-se a numeração do título para o banco onde o título será registrado para cobrança.
Sugere-se o uso de uma "sequence", informado no campo "Sequência para Nosso número" (ver Sequências) em ambientes replicados onde a geração de títulos de um mesmo LOP é realizado em mais de um servidor (p.ex.: a geração de títulos é realizada no servidor da matriz e também e realizada em servidores das filiais).
Caso não informado, será utilizado o número informado no Contas correntes / caixas.
NOSSO_NUMERO_SEQUENCIA_IDID(18)FK Nosso número (sequência):
Próximo número válido para o nosso número do título, o uso deste atributo é aconselhado quando existe uma base replicada utilizando o mesmo LOP.

O "nosso número" refere-se a numeração do título para o banco onde o título será registrado para cobrança.

Referência para SEQUENCES
CODIGO_PRODUTOTEXTCódigo de produto:
Código de produto para o banco.
DISPONIBILIDADE_RECURSOOPTION(1)Rqd Disponibilidade do recurso:
Define se o saldo deve ser considerado como disponível.

Valores permitidos:
  • S - Sim - O saldo de qualquer título deste LOP é considerado como recurso disponível, independente dele estar aberto ou previsto.
  • A - Apenas títulos abertos - Apenas o saldo de títulos abertos (confirmados) são considerados como recurso disponível.
  • N - Não - Não é considerado como recurso disponível

Valor padrão = S
LAYOUT_ENVIO_IDID(18)FK Layout envio:
Layout para exportação dos registros

Referência para LAYOUT_ARQUIVOS_EXPORTACOES
LAYOUT_RETORNO_IDID(18)FK Layout retorno:
Layout a ser utilizado para realizar a importação dos arquivos

Referência para LAYOUT_IMPORTACOES
SISTEMA_EXTERNO_IDID(18)FK Sistema externo:
Quando informado, indica que este LOP está integrado a um sistema externo. Neste caso, todas as operações realizadas nos respectivos títulos são automaticamente repassadas para uma API de integração.

Referência para SISTEMAS_EXTERNOS
INTEGRADOR_ELETRONICO_IDID(18)FK Integrador eletrônico:
Nome do integrador eletrônico. Apenas nomes disponíveis na instalação do sistema poderão ser utilizados.
Quando informado, as transações financeiras relacionados ao LOP estarão dependentes do processo de autorização/captura do respectivo módulo de integração.

Exemplos:
  • CIELO
  • CONECTA
  • GETNET

Referência para INTEGRADORES_ELETRONICOS
AMBIENTE_INTEGRADOROPCAO(1)Ambiente do integrador:
Indica se o sistema deve usar o ambiente de produção ou de homologação do integrador. Este campo deve obrigatoriamente ser preenchido quando o LOP estiver associado a um integrador eletrônico.

Valores permitidos:
  • H - Homologação
  • P - Produção
AFILIACAO_INTEGRADORTEXT(40)Afiliação do integrador:
Código de identificação ou número de afiliação determinado pelo integrador para o estabelecimento. Somente informado quando um integrador eletrônico for informado.
O formato deste código varia de integrador para integrador:
  • Cielo: É composto por um número inteiro. Ex: 1006993069
  • GetNet: É chamado de EC (ou MerchantID) - Composto por um número inteiro com 6 ou mais dígitos.

Exemplos:
  • 1006993069
  • 1001734898
USUARIO_INTEGRADORTEXT(80)Usuário integrador:
Usuário utilizado nas comunicações com o integrador. Utilizado, por exemplo, nas comunicações com a GETNET.
TERMINAL_INTEGRADORTEXT(40)Terminal do integrador:
Código de terminal do integrador. Este campo somente deve ser preenchido se o respectivo integrador exigir (Label para terminal do respectivo integrador estiver informado)
CHAVE_INTEGRADORTEXT(250)Chave do integrador:
É um código de segurança (ou senha) específico para o estabelecimento, usada para realizar a autenticação e comunicação com o integrador.

Exemplos:
  • 25fbb99741c739dd84d7b06ec78c9bac718838630f30b112d033ce2e621b34f3 e84827130b9837473681c2787007da5914d6359947015a5cdb2b8843db0fa832
CORPO_MAILSOURCE_CODECorpo e-mail:
Código para permitir o envio de e-mail contendo informações relativas ao título.

Caso não informado , o sistema não permitirá o envio de e-mail para este LOP.

Quando utilizado esta informação em Títulos a receber, pode-se utilizar macros de substituição de títulos, utilizando a macro "titu".
VALOR_TARIFADECIMAL_VALUEValor de tarifa:
Valor de tarifa de cobrança a ser incluído nos documentos ou títulos gerados pelo sistema.
MODO_COBRANCA_TARIFAOPTION(1)Modo de cobrança de tarifa:
Modo de cobrança da tarifa. Campo é obrigatório se o valor de tarifa de cobrança for preenchido.

Valores permitidos:
  • 0 - Documento - Valor de tarifa de ser incluído no campo despesas acessórias do documento fiscal.
  • 1 - Título - Valor de tarifa deve ser incluído somente no título.
  • 2 - Título (no pagamento) - Valor de tarifa deve ser incluído somente na apresentação do título, como por exemplo no boleto ou arquivo CNAB, e será registrado somente no pagamento do título.
DIAS_CREDITO_DESCONTOINTEGERDias para crédito em desconto:
Número de dias, após o envio/pedido de "desconto" do título que será registrado o crédito na conta corrente.
Caso não informado, e ocorrer um desconto será utilizado o padrão 1 dia.
PERMITE_CANCELAR_PROGRAMADOSFLAG(1)Rqd Permite cancelar títulos programados:
Indica se o LOP permite que títulos na situação "Programado" podem ou não ser cancelados.

Valor padrão = N
DIAS_DISPONIBILIDADEINTEGERRqd Dias para disponibilidade:
Número de dias úteis necessários para que o valor esteja disponível para uso. Este número é utilizado para calcular a data de disponibilidade nos fluxos de caixa.

Valor padrão = 0
SEQUENCIAL_ARQUIVO_CNAB_IDID(18)FK Sequencial para o arquivo CNAB:
Número sequencial para o lote de arquivo enviado para o banco com o arquivo CNAB, caso não informado deve ser utilizado o campo "NUMERO_LOTE".

Referência para SEQUENCES
CONCEITO_INADIMPLENCIA_IDID(18)FK Conceito para inadimplência:
Conceito a ser utilizado para informar a inadimplência para o cliente. Somente será aplicado caso tipo de título aplicar o conceito.

Referência para CONCEITOS_CLIENTES
TAXA_PADRAO_REMISSAODECIMAL_VALUETaxa padrão para remissão:
Valor de taxa da remissão do boleto.
OBSERVACOES_SACADOTEXT_LONGObservações sacado:
Observações a serem impressas no boleto na área de recibo do sacado.
DIAS_BAIXA_DEVOLUCAOINTEGERDias para baixa/devolução:
Número de dias corridos para baixa/devolução do título no banco. O Título deve ser baixado e devolvido ao cedente.
CREDITAVELFLAG(1)Creditável:
Define se os valores dos recebimentos dos títulos do LOP devem ser creditados na conta corrente (lançamento nos contas correntes). P.ex.: Títulos antecipados normalmente não creditam o valor na conta corrente na liquidação do título pelo cliente, pois os valores foram negociados com o banco. No caso, será gerado um movimento de liquidação do título com o valor pago e um lançamento em conta corrente com valor 0,00 (zero).

Valor padrão = S
TODOS_ESTABELECIMENTOSFLAG(1)Rqd Todos estabelecimentos:
Define se o LOP é permitido para todos os estabelecimentos.

Valor padrão = S
TEXTO_LOCAL_PAGAMENTO_LINHA_1UPPER(80)Texto para local de pagamento - Linha 1:
Texto para local de pagamento a ser impresso no boleto bancário.
Exemplo: PAGÁVEL PREFERENCIALMENTE NAS AGÊNCIAS BRADESCO
TEXTO_LOCAL_PAGAMENTO_LINHA_2TEXT_LONG(80)Texto para local de pagamento - Linha 2:
Texto para local de pagamento (linha 2) a ser impresso no boleto bancário.
Caso não informado será utilizado o padrão informado na conta corrente vinculada.
INSTRUCAO_BANCARIA_1UPPER(100)Instrução bancária 1:
Texto com instruções bancárias a serem informadas na linha 1 do boleto, caso não informado é utilizado o padrão informado na conta corrente.
Para informar automaticamente o protesto no corpo do boleto marque a preferência FINANC.TITULOS.INFORMAR_PROTESTO_AUTOMATICO e defina os textos conforme as preferências FINANC.TITULOS.NEGATIVACAO_TEXTO e FINANC.TITULOS.PROTESTO_TEXTO
Exemplo: APÓS O VENCIMENTO COBRAR R$ :MULTA: DE MULTA.
INSTRUCAO_BANCARIA_2UPPER(100)Instrução bancária 2:
Texto com instruções bancárias a serem informadas na linha 2 do boleto, caso não informado é utilizado o padrão informado na conta corrente.
Exemplo: APÓS O VENCIMENTO COBRAR JUROS DE R$ :VALOR: AO DIA
INSTRUCAO_BANCARIA_3UPPER(100)Instrução bancária 3:
Texto com instruções bancárias a serem informadas na linha 3 do boleto, caso não informado é utilizado o padrão informado na conta corrente.
Ver documentação da instrução bancária 1.
INSTRUCAO_BANCARIA_4UPPER(100)Instrução bancária 4:
Texto com instruções bancárias a serem informadas na linha 4 do boleto, caso não informado é utilizado o padrão informado na conta corrente.
Ver documentação da instrução bancária 1.
CODIGO_INSTRUCAO_BANCARIA_1TEXT(10)Código para instrução bancária 1:
Código da primeira instrução bancária.
CODIGO_INSTRUCAO_BANCARIA_2TEXT(10)Código para instrução bancária 2:
Código da segunda instrução bancária.
LOP_BAIXA_IDID(18)FK Lop para baixa:
Indica o LOP para o qual um título deste LOP deve ser alterado quando o mesmo for baixado pela instituição financeira.
Um título é baixado quando ele não for pago dentro dos prazos limites determinados para ele.

Exemplo: Boleto não pago até N dias depois do vencimento.

Referência para LOPS

Regras

Revisar data disponível

(Depois de alterar)
Ao alterar o número de dias para disponibilidade, recalcular as datas de todos os títulos que estão em aberto.

Layout de exportação ou tipo de envio devem estar preenchidos

(Antes de inserir, Antes de alterar)
Valida ser o leiaute de exportação está preenchido quando o \"Tipo de envio para banco\" não estiver preenchido.

Não foi informado o valor de tarifa ou modo de cobrança da tarifa

(Antes de inserir, Antes de alterar)
Não informado o valor de tarifa ou modo de cobrança da tarifa.

LOP não pode ficar inativo pois ele está sendo usado como padrão para um cliente!

(Antes de alterar)
Quando for colocado um LOP para inativo, deve verificar se ele não está sendo utilizado como padrão para algum cliente e, se for o caso, alertar para o usuário.

Retornar CNPJ do estabelecimento

Retorna o CNPJ do estabelecimento emitente dos títulos.
P.ex.: Retorna 02150784000160 para o CNPJ 02.150.784/0001-60.

Retornar Texto de dias para protesto

Retorna o texto a informação do número de dias para protesto dos títulos e que poderá ser utilizado na impressão de boletos bancários.
P.ex.: Retorna Protestar 5 dias apos vencimento. para 5 dias para protesto.

Retornar Código do tipo de documento do estabelecimento

Retorna o código do tipo de documento (CNPJ ou CPF) do estabelecimento emitente dos títulos.
Se CPF
   Retorna 1
Senão se CNPJ
   Retorna 2
Senão 
   Retorna 0
Existem ainda opções não tratadas:

Retornar Forma de protesto

Retorna o código para a forma de protesto de acordo o código jBoleto informando no cadastro do banco informado no cadastro da conta corrente informada no cadastro do LOP.
Se banco = Banco do Brasil (jBoleto = 0)
   Se Forma de protesto = Dias corridos
      Retorna 1
   Senão se Forma de protesto = Dias úteis
      Retorna 2
   Senão se Forma de protesto = Não protestar
      Retorna 3
Se banco = Bradesco (jBoleto = 1)
   Se Forma de protesto = Dias corridos
      Retorna 06
   Senão se Forma de protesto = Dias úteis
      Retorna 18
   Senão se Forma de protesto = Não protestar
      Retorna " "
Se banco = CEF Caixa Econômica Federal (jBoleto = 4)
   Se Forma de protesto = Dias corridos
      Retorna 1
   Senão se Forma de protesto = Dias úteis
      Retorna 2
   Senão se Forma de protesto = Não protestar
      Retorna 3
Se banco = Santander (jBoleto = 8)
   Se Forma de protesto = Dias corridos
      Retorna 1
   Senão se Forma de protesto = Dias úteis
      Retorna 2
   Senão se Forma de protesto = Não protestar
      Retorna 0

Retornar Quem emite o boleto bancário

Retorna quem deve emitir o boleto (banco ou empresa).
Se emitente = Banco
   Retorna 1
Senão
   Retorna 2

Retornar Carteira

Retorna o código da carteira de cobrança informada no cadastro da conta corrente a qual o LOP está vinculado e caso esta carteira não esta não esteja informada, retorna o código da carteira informada no cadastro do LOP.

Retornar Convênio bancário

Retorna o código do convênio bancário informado no cadastro da conta corrente a qual o LOP está vinculado e caso este convênio não esta não esteja informado, retorna o código do convênio bancário informado no cadastro do LOP.
Se Conta corrente informada 
e Código do produto informado
e Carteira informada
e Convênio informado
e Variação da carteira informada
   Retorna Convênio formatado com Convênio + Código do produto + Modalidade de cobrança + Variação da carteira
Senão se Conta corrente informada 
e Convênio da conta corrente informado
   Retorna Convênio da Conta corrente
Senão
   Retorna Convênio do LOP

Retornar Convênio bancário simples

Retorna o código do convênio bancário informado no cadastro da conta corrente a qual o LOP está vinculado e caso este convênio não esta não esteja informado, retorna o código do convênio bancário informado no cadastro do LOP.

Retornar Espécie de título

Retorna o código da espécie de título informado campo Prefixo para os títulos.
Se Prefixo = DS
   Retorna 04
Senão se Prefixo = DM
   Retorna 02
Senão 
   Retorna " "

Retornar próximo Nosso Número

Retorna o próximo número da sequência para identificação dos títulos.
Se Conta corrente informada e Nosso Número da Conta corrente informada
   Retorna Nosso Número da Conta corrente + 1
Senão se Nosso Número do LOP informado
   Retorna Nosso Número do LOP + 1

Retornar Percentual de multa

Retornar o percentual de multa formatado para padrão texto.
P.ex.: Retorna 5,00 para percentual de 5% de multa.

Retornar Quem distribui o boleto bancário

Retorna código de responsabilidade pela entrega e distribuição dos boletos de cobrança de acordo com o informado no campo Tipo de impressão.
Se Tipo de impressão = Banco
   Retorna 1
Senão
   Retorna 2