LAD Add-On Localizations

Oracle®

CLL F394
Brazilian Payables DDA Loader

Manual do Usuário
RELEASE 12

Versão 1

DISCLAIMER:

CURRENTLY, ORACLE OFFERS CERTAIN RESALABLE ASSETS OR OTHER DEFINED SERVICE

DELIVERABLES (COLLECTIVELY REFERRED TO AS "SERVICE DELIVERABLES") UNDER A
LIMITED USE LICENSE. THE SERVICE DELIVERABLES CURRENTLY INCLUDE, BUT ARE NOT
LIMITED TO, ORACLE INTEGRATION HUB. YOU AGREE THAT :

(i) SERVICE DELIVERABLES ARE NOT ORACLE STANDARD SOFTWARE PROGRAMS,

(ii) TECHNICAL SUPPORT FOR SERVICE DELIVERABLES IS NOT AVAILABLE FROM OR UNDER,
OR PROVIDED BY OR THROUGH, ORACLE'S SUPPORT SERVICES ORGANIZATION OR YOUR
ORACLE PROGRAM LICENSE AGREEMENT,
(iii) YOUR RIGHT TO USE AND RECEIVE SUPPORT SERVICES FOR SERVICE DELIVERABLES IS
SOLELY AS DESCRIBED IN YOUR CONTRACT FOR SUCH SERVICE DELIVERABLES, AND
(iv) A SERVICE REQUEST REGARDING SERVICE DELIVERABLES, REGARDLESS OF HOW
INITIATED OR LOGGED, WILL BE ADDRESSED IN ACCORDANCE WITH THE TERMS OF YOUR
CONTRACT FOR SUCH SERVICE DELIVERABLES.
Controle do Documento

Registro de Alterações

Data Autor Versão Referência da Alteração

30-Jul-13 Guilherme Sobreira da Silva 1.0 Criação do Documento

Revisores

Nome Função

Gesiane Toryi Dev Manager

LAD Add-on Localizations 1

Brazilian Payables DDA Loader Manual do Usuário
 Conteúdo

Controle do Documento ............................................................................................................. 1

Prefácio 3

O Manual ................................................................................................................................... 4
Como Usar este Manual ...................................................................................................... 4
Documentos Relacionados .................................................................................................. 5
Comentários/Sugestões ....................................................................................................... 5
Como Este Manual Está Organizado ......................................................................................... 6

CAPÍTULO 1 Informações de Implementação .............................................................................................. 7

Pré-requisito ............................................................................................................................... 8

Adicionar DDA Loader ao Menu do Oracle Payables (AP) ...................................................... 9

CAPÍTULO 2 Cadastro de Layout Bancário ............................................................................................... 11

Cadastro de Layout Bancário ................................................................................................... 12

CAPÍTULO 3 Carga do Arquivo DDA ......................................................................................................... 13

Carregando o Arquivo de Varredura para a Interface de boletos bancários (JL) ..................... 14

Log e Relatório de Saída do Processamento da Carga do Arquivo DDA ................................ 15

Processamento da Open Interface de boletos bancários........................................................... 17

LAD Add-on Localizations 2

Brazilian Payables DDA Loader Manual do Usuário
 Prefácio

E ste manual inclui informações necessárias para você trabalhar com o Brazilian Payables
trabalhar com o Brazilian Payables DDA Loader (CLL_F394). Ele contém informações detalhadas
sobre:

 Visão geral e informações de referência.

 Funções específicas.

 Programas do CLL_F394.

O prefácio mostra como este manual é organizado e introduz outras fontes de informação que
podem ajudá-lo a usar o CLL_F394.

LAD Add-on Localizations 3

Brazilian Payables DDA Loader Manual do Usuário
O Manual
Este capítulo contém informações importantes referentes à estrutura do manual.

Como Usar este Manual

O manual contém a ilustração das telas do sistema, para facilitar na compreensão da ferramenta, e
sempre após a figura é descrita a funcionalidade de cada campo.

Abaixo é demonstrado o padrão adotado no manual para descrever a funcionalidade dos campos:

Nome Característica Forma

Nome
É o nome do campo apresentado na tela do sistema.

Característica
Existem vários tipos de características, e são variados conforme a função do campo:

Requerido Necessário entrar com um valor para o campo, antes de

salvar as alterações.

Opcional Pode ou não entrar com um valor para o campo.

Condicional, Requerido Depende de uma ação anterior para o campo disponibilizar

a edição.

Exibir Somente Não permite alteração do valor do campo. O CLL_F394,

utiliza estes campos para exibir informações.

Sugerido, Obrigatório O CLL_F394, automaticamente entra com um valor para o

campo, podendo ser alterado caso necessário.

Forma de Edição/Acesso
As formas de edição/acesso aos campos são:

Pick O campo será preenchido apenas por uma lista de valores

pertinentes ao o campo.

Edit O campo permite entrada de dados definida pelo usuário.

Campos Flexíveis(Descriptive Flexfield)

Algumas telas do CLL_F394 exibem campos flexíveis(DF), indicados por colchetes. São usados
para registrar informações específicas, requeridas ao negócio do cliente.

LAD Add-on Localizations 4

Brazilian Payables DDA Loader Manual do Usuário
Documentos Relacionados

Informações técnicas do CLL_F394 podem ser encontradas no Manual Técnico de Referência

disponível no My Oracle Support.

Comentários/Sugestões

LAD Add-On Localizations desenvolveu este manual para auxiliá-lo na implantação e utilização
do produto e também valoriza seus comentários/sugestões para aprimoramento da documentação,
abaixo informamos nosso endereço e contato para envio de seus comentários/sugestões para
análise e caso aprovado será incluídos numa futura versão:

Oracle do Brasil


Rua Doutor José Áureo Bustamante, 455 - São Paulo - CEP 04710-090
A/C Diogenes Menezes

+55.11.5189-3060 Email: diogenes.menezes@oracle.com

LAD Add-on Localizations 5

Brazilian Payables DDA Loader Manual do Usuário
Como Este Manual Está Organizado
Este manual é dividido em 2 seções:

 Informações de Implementação do CLL F394 Brazilian Payables DDA Loader

 Cadastro de Layout Bancário
 Carga do Arquivo DDA

Informações de Implementação do CLL F394 Brazilian Payables DDA Loader

Informações básicas de implementação do CLL F394 Brazilian Payables DDA Loader.

Cadastro de Layout Bancário

Informações genéricas sobre o cadastro de layout realizado através do CLL F035 Brazilian Cash
Management, disponível sob o Note 464914.1.

Carga do Arquivo DDA

A carga do Arquivo de Varredura (DDA) é feita através da execução do programa concorrente
pertencente ao CLL F394 Brazilian Payables DDA Loader, que realiza a leitura do arquivo texto
enviado pelo banco, através das informações de layout parametrizadas no CLL F035 Brazilian
Cash Management, fazendo a inserção dos dados na Open Interface de boletos bancários fornecida
pelo módulo Brazilian Localizations for Oracle Payables (JL).

LAD Add-on Localizations 6

Brazilian Payables DDA Loader Manual do Usuário
CAPÍTULO

1 Informações de Implementação

I
nformações básicas de implementação do CLL F394 Brazilian Payables DDA Loader.

LAD Add-on Localizations 7

Brazilian Payables DDA Loader Manual do Usuário
Pré-requisito
Para o correto funcionamento do CLL Brazilian Payables DDA Loader, o Brazilian Localizations
for Oracle Payables (JL) deve estar atualizado com o patch 9319746:R12.JL.B.

LAD Add-on Localizations 8

Brazilian Payables DDA Loader Manual do Usuário
Adicionar DDA Loader ao Menu do Oracle Payables (AP)
Para facilitar o uso do CLL F394 Brazilian Payables DDA Loader, adicione a função ao menu do
AP, seguindo os passos abaixo.

Este passo a passo deve ser seguido pelo Administrador do Sistema.

1) Navegue até a tela de definição de Responsabilidades e obtenha o Menu usado pela

responsabilidade do Oracle Payables.

Navegação: System Administrator  Security  Responsibility  Define

Anote o nome do Menu utilizado.

LAD Add-on Localizations 9

Brazilian Payables DDA Loader Manual do Usuário
 2) Navegue até a tela de definição de Menus, informando o Menu encontrado.

Navegação: System Administrator  Application  Menu

3) Adicione ao menu a nova linha correspondente ao menu do CLL Brazilian Payables DDA
Loader.

LAD Add-on Localizations 10

Brazilian Payables DDA Loader Manual do Usuário
CAPÍTULO

2 Cadastro de Layout Bancário

V ocê deve usar o cadastro de layouts bancários para parametrização dos arquivos:

 Extrato bancário, para reconciliação.

 Varredura, para pagamento de boletos eletrônicos.

LAD Add-on Localizations 11

Brazilian Payables DDA Loader Manual do Usuário
Cadastro de Layout Bancário
A leitura do Arquivo de Varredura (DDA) é feita a partir de um layout parametrizado no sistema.

Este layout deve ser cadastrado na tela ‘Bank Layout Setup’ que pertence ao CLL F035 Brazilian
Cash Management.

Para o correto preenchimento desse layout, você deverá ter em mãos o arquivo a ser lido e/ou o
seu layout (informações que você deve conseguir com o banco que gerou o arquivo de varredura
DDA).

Navegação: CLL: Brazilian Cash Management Localization / Bank Layout Setup

Verifique o manual de referência do CLL F035 Brazilian Cash Management com

os procedimentos para o correto preenchimento deste tela. O User Guide do CLL
F035 Brazilian Cash Management pode ser obtido sob o Note 464914.1 disponível
no My Oracle Support.

LAD Add-on Localizations 12

Brazilian Payables DDA Loader Manual do Usuário
CAPÍTULO

3 Carga do Arquivo DDA

V ocê pode usar a o programa de Leitura do Arquivo DDA para geração dos dados na Open

Interface de boletos bancários fornecida por Brazilian Localizations for Oracle Payables (JL).

Verifique o manual de referência de Latin American Localizations para mais

informações sobre a Open Interface de boletos bancários.

LAD Add-on Localizations 13

Brazilian Payables DDA Loader Manual do Usuário
Carregando o Arquivo de Varredura para a Interface de boletos bancários (JL)
O banco gera um Arquivo de Varredura (DDA) contendo os boletos bancários disponíveis para
pagamento pelo sacado (sua empresa). O arquivo deve ser recebido via FTP e posicionado no
servidor do Banco de Dados de sua instalação.

Para a carga do Arquivo de Varredura,o programa DDA File Load deve ser executado. É possível
localizá-lo na responsabilidade do Oracle Payables (Submenu CLL Brasil) ou na própria
responsabilidade CLL: Brazilian Payables DDA Loader, na opção de execução de programas
(Run).

Como parâmetros de execução deste programa, temos:

Operating Unit (Requerido)

Informar a Organização na qual os boletos serão carregados.

Bank (Requerido)
Inserir o número do Banco ao qual pertence o Arquivo de Varredura DDA.

File Location (Requerido)

Diretório do servidor, onde o Arquivo de Varredura DDA se encontra.

File Name (Requerido)

Nome do arquivo. Informar o nome do arquivo completo, com extensão, se houver. O sistema é
case sentitive.

Devido à uma restrição do JL, o nome do arquivo deve possuir um tamanho máximo de 20
caracteres.

LAD Add-on Localizations 14

Brazilian Payables DDA Loader Manual do Usuário
Log e Relatório de Saída do Processamento da Carga do Arquivo DDA
Com base na parametrização do layout do Arquivo de Varredura DDA feita na tela de Bank
Layout Setup, do CLL F035 Brazilian Cash Management, o processo irá ler o cadastro e localizar
cada informação dentro do arquivo.

As linhas necessárias para carga de dados na interface são ‘File Header’ e ‘Detail’. Cada linha é
identificada por um campo identificador (Record Identifier) em seu layout, que também pode ser
localizado de acordo com as posições cadastradas na tela de layouts.

Havendo problemas de consistência nos dados encontrados em campos do arquivo, o

processamento será finalizado com Advertência e nenhum dado será armazenado na tabela da
Open Interface de boletos bancários.
Um relatório com as inconsistências será gerado após a execução do concurrent.
Abaixo, as validações verificadas no processamento e as informações geradas no relatório de
saída:
Para todos os campos encontrados dentro do arquivo texto, será verificado se o tipo de dado
que pode ser recebido na Open Interface de boletos bancários condiz com o dado encontrado.
Havendo incompatibilidade de dados, a mensagem abaixo será exibida no relatório:
Invalid data on field P1 of P2, data type expected: P3, mask expected: P4, value found: P5

* P1 será representado pelo campo em questão.

* P2 será representado pelo tipo de linha sendo lida (Header ou Detail).
* P3 será representado pelo tipo de dado esperado para este campo.
* P4 será representado pela máscara definida no layout cadastrado.
* P5 será representado pelo valor encontrado no arquivo.

Neste mesmo relatório de processamento, considerando a finalização com Sucesso, Erro ou

Advertência, irá constar as mensagens:

1) Line number P1 was not processed, identifier found: P2 - Qualquer linha diferente de Header
de Arquivo e Detail com segmento G, H ou Único deve ser desprezada.

* P1 será representado pelo número da linha no arquivo, de acordo com o campo de arquivo
‘Line Number’ cadastrado no layout.
* P2 será representado pelo identificador encotrado na linha do arquivo, de acordo com o
campo de arquivo ‘Identifier’ cadastrado no layout.

2) Record with no errors - line number P1 – Informando que a linha foi processada sem
inconsistências.

*P1 será representado pelo número da linha, de acordo com o campo de arquivo ‘Record
Sequential Number’ cadastrado no layout.

Caso o processamento finalize em erro, um log de processamento será gerado pelo Concurrent. As
possíveis causas de erro exibidas nesse log estão listadas abaixo:

1) Invalid path – Caso o diretório definido como parâmetro de entrada não seja encontrado.

2) File cannot be opened (concatenado com erro Oracle) – Caso haja algum outro erro na
abertura do arquivo.

3) The file name must contain no more than 20 characters – Caso o nome do arquivo possua
mais de 20 caracteres.
LAD Add-on Localizations 15
Brazilian Payables DDA Loader Manual do Usuário
 4) File already processed – Caso já exista um arquivo com o mesmo nome processado na
interface do JL.

5) P1 line type not found for the current bank - Caso o tipo de linha seja obrigatório (no caso
Header de Arquivo e Detail), e não existir o layout configurado para alguma dessas linhas.
*P1 será representado no log como ‘Header’ ou ‘Detail’.
6) Identifier not found for line type P1 – Caso o identificador de registro não seja encontrado em
algum dos tipos de linha cadastrados no sistema.
O Identificador de registro, é o campo de arquivo ‘Identifier’ cadastrado no layout
*P1 será representado no log como ‘Header’ ou ‘Detail’.
7) Identifier default value must be filled for line type P1 – Caso o identificador de registro esteja
com o valor padrão sem preenchimento em algum dos tipos de linha cadastrados no sistema.
O Identificador de registro deve, obrigatóriamente, possuir um valor preenchido no campo
‘Default’ no layout cadastrado.
*P1 será representado no log como ‘Header’ ou ‘Detail’.
8) Invalid File Header, identifier found: P1 – Todos os arquivos devem iniciar com a linha de
Header de Arquivo. Caso a primeira linha do arquivo não seja a linha especifida, o concurrent
será terminado com erro.
*P1 será representado no log como o valor no campo de arquivo correspondente ao ‘Record
Identifier’ encontrado de acordo com as posições definidas no layout cadastrado..

LAD Add-on Localizations 16

Brazilian Payables DDA Loader Manual do Usuário
Processamento da Open Interface de boletos bancários
Após a execução do programa DDA File Load, o processo para processamento da Open Interface
de boletos bancários do Brazilian Localizations for Oracle Payables (JL) deve ser executado.

Para isso, acessar a responsabilidade do Brazilian Localizations for Oracle Payables (JL), e
executar o programa concorrente Brazilian Payables Import Bank Collection Documents Program,
informando o nome do arquivo correspondente.

LAD Add-on Localizations 17

Brazilian Payables DDA Loader Manual do Usuário