Desenvolvimento Millen-23319 – Integração Pagfor – Banco Citi (Citibank)
Release 102
Versão 5
Autor Jaciara Silva
Processo: Financeiro
Nome do Processo: Títulos a pagar - Pagfor
Motivação
Desenvolvido o layout para utilização de PagFor com o banco Citi. Este desenvolvimento contempla a geração de arquivos para os segmentos abaixo:
- Tipos A e B (adicional para TED)
- Tipos J e J52 – Título em cobrança
- Tipos N – Sem código barras
- Tipos O – Com código de barras
- Tipo W – Com código de barras
Importante! Foi utilizado para desenvolvimento da integração o layout 240 bilíngue
Parâmetros
Em Financeiro\A Pagar, ter títulos cadastrados para fornecedores.
Entradas
Cadastrando tipo de pagamento
Os tipos de pagamentos devem ser cadastros no sistema porque a partir dessa informação é que serão gerados os segmentos nos arquivos a serem enviados aos bancos.
O segmento é a informação que identifica o pagamento que está sendo realizado, por exemplo: TED e PIX.
Em Utilitários\Comercial, selecione a opção Tipos de Pagamento e faça o cadastro dos segmentos disponibilizados pelo banco, nesse caso o Citi, para serem usados com o Pagfor.
TED Citibanck – este tipo de pagamento é responsável por gerar nos arquivos de remessa, os segmentos:
- A
- Adicional B
TIT_COBRANÇA_Citibank – este tipo de pagamento é responsável por gerar nos arquivos de remessa, os segmentos:
- J
- Adicional J52
PGTO COM BARRAS - Citibank - este tipo de pagamento é responsável por gerar nos arquivos de remessa, o segmento:
- O
- Adicional W, quando se tratar de FGTS
PGTO SEM BARRAS – Citibank - este tipo de pagamento é responsável por gerar nos arquivos de remessa, o segmento:
- N – podendo ser GPS, DARF, DARF Simples.
Cadastrando banco Citi
Em Financeiro\Cadastros\Bancos, faça o cadastramento preenchendo os dados do banco, com as informações para sua identificação e ligando o parâmetro Acessa CNAB. 
Cadastrando conta para banco Citi
Para poder gerar um borderô, é necessário que exista uma conta na qual os borderôs deverão ser vinculados, para que possam ser enviados ao banco.
Em Financeiro\Cadastros\Contas, preencha um cadastro com os dados da conta corrente que a empresa mantém junto ao Citi. 
Também no cadastro da conta, deve ser informado o diretório no qual os arquivos de PagFor serão gerados e o número do convênio com o banco. 
Cadastrando carteira de pagamento para banco Citi
Este cadastro é importante porque será solicitado pelo sistema no momento da geração dos borderôs a serem enviados para o banco.
Financeiro\Receber\Cadastro\Carteira, preencha com os dados do banco e no campo Tipo de Carteira, selecione a opção Pagamento de Fornecedor. 
Incluindo borderôs e gerando arquivos de remessa para o banco Citi
- Tipo de pagamento - TED
Inclusão de título a pagar
Na guia Geral, algumas informações do título são obrigatórias, sem elas o sistema não permitirá a inclusão do título. 
Selecione o tipo de pagamento TED.
Preencha também as informações da guia Cobrança e Cheque, referentes ao banco para o pagamento e clique em Salvar.
Inclusão de borderô
Em Financeiro\A Pagar\Borderô PagFor, clique em Incluir Borderô. Preencha os dados da tela de identificação e clique na guia Títulos.
Clique na lupa para preencher os campos de filtro e selecionar os títulos a serem incluídos no borderô. É importante selecionar a opção Fornecedor, para que os títulos venham corretos para a tela.
Clique em OK, para lançar os títulos na tela. Em nosso exemplo, teremos somente o título que acabamos de incluir.
Clique em Salvar. Faça uma nova consulta e observe o borderô que acabamos de criar. A seguir faremos a geração do arquivo de envio PagFor.
Geração do arquivo de remessa
Em Financeiro\A Pagar\Borderô PagFor, selecione o link Gerar PagFor. Preencha as informações solicitadas na tela. No campo Tipo, selecione Inclusão, porque estamos enviando um título para o banco. Clique em Gerar Arquivo. 
No cadastro da conta do banco Citi, foi informado um diretório para geração dos arquivos de remessa PagFor, faça uma consulta no diretório e verifique o arquivo gravado.
Arquivo gerado com Segmentos dos tipos A e B (adicional para TED)
- Tipo de pagamento - Título de Cobrança
Inclusão de título a pagar
Na guia Geral, algumas informações do título são obrigatórias, sem elas o sistema não permitirá a inclusão do título. 
Selecione o tipo de pagamento Título de Cobrança, conforme cadastrado.
Preencha também as informações da guia Cobrança e Cheque, observe que neste caso não é necessário preencher os dados do banco, e efetive.
Inclusão de borderô
Em Financeiro\A Pagar\Borderô PagFor, clique em Incluir Borderô. Preencha os dados da tela de identificação e clique na guia Títulos.
Clique na lupa para preencher os campos de filtro e selecionar os títulos a serem incluídos no borderô. É importante selecionar a opção Fornecedor, para que os títulos venham corretos para a tela.
Clique em OK, para lançar os títulos na tela. Em nosso exemplo, teremos somente o título que acabamos de incluir.
Clique em Efetivar. Faça uma nova consulta e observe o borderô que acabamos de criar. A seguir faremos a geração do arquivo de envio PagFor.
Geração do arquivo de remessa
Em Financeiro\A Pagar\Borderô PagFor, clique no link Gerar PagFor. Preencha as informações solicitadas na tela. No campo Tipo, selecione Inclusão, porque estamos enviando um título para o banco. Clique em Gerar Arquivo. 
No cadastro da conta do banco Citi, foi informado um diretório para geração dos arquivos de remessa PagFor, faça uma consulta no diretório e verifique o arquivo gravado.
Arquivo gerado com Segmentos dos tipos J e J52
- Tipo de pagamento - Com Código de Barras
O banco Citi possui implementação para gerar o segmento W, referente ao FGTS. Então, neste borderô incluiremos dois títulos para mostrar os dois segmentos.
Inclusão de título a pagar
Na guia Geral, algumas informações do título são obrigatórias, sem elas o sistema não permitirá a inclusão do título. 
Selecione o tipo de pagamento Título de Cobrança, conforme cadastrado.
Preencha também as informações da guia Cobrança e Cheque, observe que neste caso não é necessário preencher os dados do banco, e efetive.
Selecione o tipo de pagamento Título de Cobrança, conforme cadastrado. 
Preencha também as informações da guia Cobrança e Cheque, observe que neste caso não é necessário preencher os dados do banco, e efetive. 
Inclusão de borderô
Em Financeiro\A Pagar\Borderô PagFor, clique em Incluir Borderô. Preencha os dados da tela de identificação e clique na guia Títulos.
Clique na lupa para preencher os campos de filtro e selecionar os títulos a serem incluídos no borderô. É importante selecionar a opção Fornecedor, para que os títulos venham corretos para a tela.
Clique em OK, para lançar os títulos na tela. Em nosso exemplo, teremos somente o título que acabamos de incluir.
Clique em Salvar. Faça uma nova consulta e observe o borderô que acabamos de criar. A seguir faremos a geração do arquivo de envio PagFor.
Geração do arquivo de remessa
Em Financeiro\A Pagar\Borderô PagFor, clique no link Outras Funções, selecione a opção Gerar PagFor. Preencha as informações solicitadas na tela. No campo Tipo, selecione Inclusão, porque estamos enviando um título para o banco. Clique em Gerar Arquivo. 
No cadastro da conta do banco Citi, foi informado um diretório para geração dos arquivos de remessa PagFor, faça uma consulta no diretório e verifique o arquivo gravado.
Arquivo de envio com Segmentos do tipo O e W
- Tipo de pagamento - Sem Código de Barras
Inclusão de título a pagar
Na guia Geral, algumas informações do título são obrigatórias, sem elas o sistema não permitirá a inclusão do título. 
Selecione o tipo de pagamento Título de Cobrança, conforme cadastrado.
Preencha também as informações da guia Cobrança e Cheque, observe que neste caso não é necessário preencher os dados do banco pagador, e efetive. 
Inclusão de borderô
Em Financeiro\A Pagar\Borderô PagFor, clique em Incluir Borderô. Preencha os dados da tela de identificação e clique na guia Títulos.
Clique na lupa para preencher os campos de filtro e selecionar os títulos a serem incluídos no borderô. É importante selecionar a opção Fornecedor, para que os títulos venham corretos para a tela.
Clique em OK, para lançar os títulos na tela. Em nosso exemplo, teremos somente o título que acabamos de incluir.
Clique em Salvar. Faça uma nova consulta e observe o borderô que acabamos de criar. A seguir faremos a geração do arquivo de envio PagFor.
Geração do arquivo de remessa
Em Financeiro\A Pagar\Borderô PagFor, clique no link Outras Funções, selecione a opção Gerar PagFor. Preencha as informações solicitadas na tela. No campo Tipo, selecione Inclusão, porque estamos enviando um título para o banco. Clique em Gerar Arquivo. 
No cadastro da conta do banco Citi, foi informado um diretório para geração dos arquivos de remessa PagFor, faça uma consulta no diretório e verifique o arquivo gravado.
Arquivo de envio com Segmento do tipo N
Retorno de arquivos PagFor do banco Citi
Após o processamento do arquivo de remessa, o banco devolve um arquivo para a empresa com o resultado, chamado de arquivo de retorno, que pode ser identificado pela extensão .RET. Este arquivo será processado pelo e-Millennium e os títulos a pagar serão atualizados.
Em Financeiro\A Pagar\Borderô PagFor, no link Outras Funções, selecione a opção Retorno PagFor.
Selecione o banco, a conta e clique em Receber Arquivos.
Analisando os títulos retornados nos arquivos, observe que alguns estão com status de OK e outros não. Neste caso, ou existe algum erro referente ao título, ou ele se está em agendamento. Será necessário que o responsável pelo envio ou recebimento do retorno, verifique o que ocorreu. 
Clicando em Efetivar, será emitida uma mensagem alertando que existem títulos não efetuados, ou seja, ainda não foram pagos, mas serão baixados no sistema, se o usuário confirmar a efetivação.
Vamos deixar somente um deles marcado e efetivar, para ver o reflexo no cadastro do título. Clique em Próximo, aguarde a mensagem de comando executado com sucesso e faça uma consulta nos títulos para ver se foram baixados.
Validações e Saídas
Geração dos arquivos de envio para o Pagfor, com os segmentos disponibilizados pelo banco Citi.