banksync manual de implantacao
TRANSCRIPT
MMaannuuaall FFuunncciioonnaall
2
Apresentação do Documento
O Manual do BankSync tem como objetivo explicar aos usuários do sistema, os pontos
principais no que diz respeito à instalação, configuração e conhecimentos relacionados a área e
usabilidade do software.
Inicialmente é feita uma introdução sobre o que é o BankSync, sua história, seus objetivos
e algumas particularidades que o software possui. Para auxiliar no entendimento do produto, é
também explicado nesta sessão um pouco sobre o processo de comunicação bancária.
Na sequência, é demonstrado como é feita a instalação do software, desde seu download
no site da Sistema Informática Empresarial, passando pelo registro do add-on no SBO1 e
atribuindo uma licença para os usuários do SBO.
Uma vez feita à instalação, o manual traz as configurações que devem ser feitas, tanto em telas
do SBO quanto do próprio BankSync. Esta configuração acontece de maneira sequencial e segui-
la é recomendável.
Quando encerradas as configurações, inicia-se a apresentação dos processos realizados
pelo BankSync. Nesta sessão são demonstradas as telas e é explicado em mais detalhes alguns
filtros e funcionalidades do add-on.
Feita a apresentação dos processos, são demonstradas algumas telas que permitem um
controle administrativo dos boletos e transferências geradas pelo BankSync.
1 SBO: SAP Business One
3
Sumário
Sumário
1. Introdução ao BankSync _________________________________________________________ 11
2. Comunicação bancária ___________________________________________________________ 11
2.1. Boletos _____________________________________________________________________________ 12
2.2. Transferências ______________________________________________________________________ 12
3. Comunicação bancária dentro do SAP Business One _______________________________ 13
3.1. Boletos _____________________________________________________________________________ 13
3.2. Boletos de Contas a Receber ________________________________________________________ 14
3.2.1. Enviado __________________________________________________________________________________ 14
3.2.2. Gerado ___________________________________________________________________________________ 14
3.2.3. Depositado _______________________________________________________________________________ 15
3.2.4. Pago _____________________________________________________________________________________ 15
3.2.5. Cancelado________________________________________________________________________________ 16
3.2.6. Sem êxito ________________________________________________________________________________ 17
3.3. Boletos de Contas a Pagar ___________________________________________________________ 17
3.3.1. Gerado ___________________________________________________________________________________ 18
3.3.2. Pago _____________________________________________________________________________________ 18
3.3.3. Cancelado________________________________________________________________________________ 18
3.4. Transferências ______________________________________________________________________ 19
3.5. Particularidades do processo adaptado _______________________________________________ 21
4. Informações técnicas ____________________________________________________________ 22
4.1. Tecnologia _________________________________________________________________________ 22
4.2. Conexão Remota ____________________________________________________________________ 22
4.3. Suporte Técnico ____________________________________________________________________ 22
5. Instalação _______________________________________________________________________ 23
5.1. Download do Software _______________________________________________________________ 23
5.2. Registro do Add-On no SBO _________________________________________________________ 23
5.3. Instalação do Add-On no SBO ________________________________________________________ 25
5.4. Primeira execução do BankSync _____________________________________________________ 28
5.4.1. Senha para o banco de dados _____________________________________________________________ 28
5.4.2. Dados padrões das tabelas do BankSync __________________________________________________ 29
5.4.3. Chave de ativação ________________________________________________________________________ 29
5.5. Licenças para Add-Ons da SAP ______________________________________________________ 30
4
5.5.1. Adquirindo uma licença ___________________________________________________________________ 30
5.5.2. Atribuindo as licenças ____________________________________________________________________ 31
5.6. Configurando usuários do BankSync no SBO _________________________________________ 31
6. Configurações ___________________________________________________________________ 33
6.1. Telas do SAP Business One _________________________________________________________ 33
6.1.1. Detalhes da empresa _____________________________________________________________________ 34
6.1.2. Configurações gerais _____________________________________________________________________ 36
6.1.3. Contas bancárias da empresa _____________________________________________________________ 37
6.1.4. Formas de pagamento ____________________________________________________________________ 40
6.1.5. Parâmetros do BankSync _________________________________________________________________ 46
6.2. Telas do BankSync __________________________________________________________________ 48
6.2.1. Nomenclatura de Arquivo de Remessa _____________________________________________________ 48
6.2.2. Leiaute de Arquivo de Remessa ___________________________________________________________ 52
6.2.2.1. Definição do Leiaute _________________________________________________________________ 52
6.2.2.2. Definição do Registro ________________________________________________________________ 56
6.2.2.3. Definição do Campo __________________________________________________________________ 58
6.2.3. Leiaute de Arquivo de Retorno ____________________________________________________________ 71
6.2.3.1. Identificação _________________________________________________________________________ 73
6.2.3.2. Ocorrências _________________________________________________________________________ 80
6.2.3.3. Cobrança ____________________________________________________________________________ 83
6.2.3.4. Erros ________________________________________________________________________________ 85
6.2.3.5. Validação Boletos ____________________________________________________________________ 87
6.2.3.6. Validação DDA _______________________________________________________________________ 90
6.2.4. Leiaute de Extrato Bancário (CNAB) _______________________________________________________ 94
6.2.4.1. Identificação _________________________________________________________________________ 96
6.2.4.2. Serviço _____________________________________________________________________________ 101
7. Processos do BankSync_________________________________________________________ 102
7.1. Processo de remessas _____________________________________________________________ 103
7.1.1. Criando títulos no SBO __________________________________________________________________ 103
7.1.1.1. Criando uma nota fiscal _____________________________________________________________ 103
7.1.1.2. Gerando um título ___________________________________________________________________ 105
7.1.2. Geração da remessa _____________________________________________________________________ 107
7.1.2.1. Apresentação do assistente _________________________________________________________ 107
7.1.2.2. Filtros ______________________________________________________________________________ 107
7.1.2.3. Escolha dos títulos __________________________________________________________________ 111
7.1.2.4. Resultados ____________________________________________________________________________ 112
7.2. Importação do arquivo de retorno ___________________________________________________ 113
7.2.1. Filtragem ________________________________________________________________________________ 114
7.2.2. Escolha dos títulos ______________________________________________________________________ 115
7.2.3. Resultados ______________________________________________________________________________ 120
7.2.4. Reconciliação dos boletos _______________________________________________________________ 121
7.3. Importação do extrato bancário CNAB _______________________________________________ 122
7.3.1. Filtragem ________________________________________________________________________________ 122
7.3.2. Escolha das linhas de extrato ____________________________________________________________ 124
7.3.3. Resultados ______________________________________________________________________________ 127
5
7.4. Processo de importação de boletos por DDA _________________________________________ 128
7.4.1. Configurações ___________________________________________________________________________ 129
7.4.2. Seleção e correção dos boletos __________________________________________________________ 130
8. Databases ______________________________________________________________________ 134
8.1. Databases – Boleto _________________________________________________________________ 135
8.2. Databases - Cálculo ________________________________________________________________ 137
8.3. Databases - Cedente _______________________________________________________________ 138
8.4. Databases – Contas a Pagar ________________________________________________________ 139
8.5. Databases - Documento ____________________________________________________________ 140
8.6. Databases - Extra __________________________________________________________________ 141
8.7. Databases – Forma de Pagamento ___________________________________________________ 142
8.8. Databases - Leiaute ________________________________________________________________ 145
8.9. Databases - PN_____________________________________________________________________ 146
9. DLL - Dynamic-Link Library ______________________________________________________ 150
9.1. Código de Barras e Linha Digitável __________________________________________________ 153
9.2. Configurações das DLLs no SAP Business One ______________________________________ 155
9.3. Particularidades das DLLs __________________________________________________________ 158
9.3.1. Banco ABC ______________________________________________________________________________ 158
9.3.2. Banco Banrisul __________________________________________________________________________ 158
9.3.3. Banco Bradesco _________________________________________________________________________ 159
9.3.4. Banco do Brasil _________________________________________________________________________ 160
9.3.5. Banco BVA ______________________________________________________________________________ 162
9.3.6. Banco CitiBank __________________________________________________________________________ 162
9.3.7. Banco Fibra _____________________________________________________________________________ 163
9.3.8. Banco Caixa Econômica Federal _________________________________________________________ 163
9.3.9. Banco HSBC ____________________________________________________________________________ 166
9.3.10. Banco Itau ______________________________________________________________________________ 166
9.3.11. Banco Mercantil _________________________________________________________________________ 167
9.3.12. Banco Nordeste _________________________________________________________________________ 168
9.3.13. Banco Pine ______________________________________________________________________________ 168
9.3.14. Banco Real ______________________________________________________________________________ 169
9.3.15. Banco Safra _____________________________________________________________________________ 170
9.3.16. Banco Safra (Bradesco Correspondente) _________________________________________________ 170
9.3.17. Banco Santander ________________________________________________________________________ 171
9.3.18. Banco Sicredi ___________________________________________________________________________ 171
9.3.19. Banco Sofisa ____________________________________________________________________________ 172
9.3.20. Banco Unibanco _________________________________________________________________________ 173
9.3.21. Banco BicBanco _________________________________________________________________________ 173
9.3.22. Banco BicBanco (Correspondente Bradesco) _____________________________________________ 174
9.3.23. Banco Sofisa (Correspondente) __________________________________________________________ 175
6
9.3.24. Dummy _________________________________________________________________________________ 176
9.3.25. Particularidade com o DV do Nosso Número ______________________________________________ 176
10. Funcionalidades ______________________________________________________________ 177
10.1. OneShare ________________________________________________________________________ 177
10.1.1. Exportação de leiautes ___________________________________________________________________ 177
10.1.2. Importação de leiautes ___________________________________________________________________ 181
10.2. Consulta ao SERASA _____________________________________________________________ 186
10.2.1. Configuração da consulta SERASA _______________________________________________________ 186
10.2.2. Utilização da consulta SERASA __________________________________________________________ 190
10.3. Lançamentos contábeis extras ____________________________________________________ 193
10.4. Backup periódico dos leiautes ____________________________________________________ 195
7
Índice de Figuras
FIGURA 1: ADMINISTRAÇÃO DE BOLETOS ........................................................................................................................................ 13
FIGURA 2: STATUS DO BOLETO DE CONTAS A RECEBER ................................................................................................................... 14
FIGURA 3: BOLETOS PAGOS RECONCILIADOS OU NÃO .................................................................................................................... 16
FIGURA 4: STATUS DOS BOLETOS DE CONTAS A PAGAR .................................................................................................................. 17
FIGURA 5: PROCESSO DAS TRANSFERÊNCIAS NO BANKSYNC ........................................................................................................... 20
FIGURA 6: STATUS DAS TRANSFERÊNCIAS DO BANKSYNC................................................................................................................ 20
FIGURA 7: REGISTRANDO O ADD-ON NO SBO .................................................................................................................................. 24
FIGURA 8: CONFIGURAÇÃO DE INICIALIZAÇÃO DO ADD-ON ............................................................................................................ 25
FIGURA 9: INÍCIO DA INSTALAÇÃO DO ADD-ON NO SBO.................................................................................................................. 26
FIGURA 10: INSTALAÇÃO – INFORMAÇÕES DO USUÁRIO ................................................................................................................ 27
FIGURA 11: INSTALAÇÃO – CAMINHO DA INSTALAÇÃO ................................................................................................................... 27
FIGURA 12: ATUALIZAÇÃO DA ESTRUTURA DA BASE DE DADOS ...................................................................................................... 28
FIGURA 13: REQUISITANDO A SENHA DO BANCO DE DADOS .......................................................................................................... 29
FIGURA 14: AVISO ANTES DE POVOAR AS TABELAS DO ADD-ON ..................................................................................................... 29
FIGURA 15: CHAVE DE ATIVAÇÃO ..................................................................................................................................................... 30
FIGURA 16: SELECIONANDO LICENÇA PARA UM USUÁRIO .............................................................................................................. 31
FIGURA 17: AUTORIZAÇÕES GERAIS POR USUÁRIO .......................................................................................................................... 32
FIGURA 18: DETALHES DA EMPRESA ................................................................................................................................................ 34
FIGURA 19: EXEMPLO DE MAIS DE UMA BASE NO SBO.................................................................................................................... 35
FIGURA 20: CONFIGURAÇÕES GERAIS .............................................................................................................................................. 36
FIGURA 21: CONTAS BANCÁRIAS DA EMPRESA ................................................................................................................................ 37
FIGURA 22: FORMA DE PAGAMENTO ............................................................................................................................................... 40
FIGURA 23: ESCOLHA DA CONTA BANCÁRIA DA EMPRESA .............................................................................................................. 42
FIGURA 24: PROPRIEDADES DO BOLETO .......................................................................................................................................... 43
FIGURA 25: LISTA DE CARTEIRAS ...................................................................................................................................................... 44
FIGURA 26: CADASTRAR CARTEIRA ................................................................................................................................................... 44
FIGURA 27: OPÇÃO PARA APROVAÇÃO ............................................................................................................................................ 45
FIGURA 28: ESCOLHER UMA DLL ...................................................................................................................................................... 45
FIGURA 29: CAMINHO PARA INSERIR A DLL ..................................................................................................................................... 46
FIGURA 30: PARÂMETROS DO BANKSYNC ........................................................................................................................................ 47
FIGURA 31: NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................................................................ 48
FIGURA 32: GRADE PARA DEFINIÇÕES DA NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................ 49
FIGURA 33: MODELO DE EXEMPLO .................................................................................................................................................. 52
FIGURA 34: LEIAUTE DE ARQUIVO DE REMESSA .............................................................................................................................. 53
FIGURA 35 TELA DE DEFINIÇÃO DE REGISTRO .................................................................................................................................. 56
FIGURA 36: DEFINIÇÃO DO CAMPO TEXTO FIXO .............................................................................................................................. 59
FIGURA 37: CONFIGURAÇÃO DA POSIÇÃO PARA CÓDIGO DE BARRAS ............................................................................................ 61
FIGURA 38 DEFINIÇÃO DO CAMPO DATABASE ................................................................................................................................. 62
FIGURA 39: CONFIGURAÇÃO DA POSIÇÃO PARA CÓDIGO DE BARRAS ............................................................................................ 64
FIGURA 40: DEFINIÇÃO DO CAMPO CATEGORIA .............................................................................................................................. 65
FIGURA 41: CONFIGURAÇÃO DA POSIÇÃO PARA CÓDIGO DE BARRAS ............................................................................................ 67
FIGURA 42: CONFIGURAÇÃO DA COLUNA CONDIÇÃO E VALOR ....................................................................................................... 68
FIGURA 43: DEFINIÇÃO DO CAMPO SQL SELECT............................................................................................................................... 69
FIGURA 44: CONFIGURAÇÃO DA POSIÇÃO PARA CÓDIGO DE BARRAS ............................................................................................ 71
FIGURA 45: LEIAUTE DE ARQUIVO DE RETORNO .............................................................................................................................. 72
8
FIGURA 46: LEIAUTE DE ARQUIVO DE RETORNO, CABEÇALHO ........................................................................................................ 73
FIGURA 47: ARQUIVO DE RETORNO ................................................................................................................................................. 74
FIGURA 48: LEIAUTE DE ARQUIVO DE RETORNO TÍTULO ................................................................................................................. 74
FIGURA 49: ARQUIVO DE RETORNO ................................................................................................................................................. 75
FIGURA 50: DETALHES DA EMPRESA IDENTIFICAÇÃO DA EMPRESA ................................................................................................ 76
FIGURA 51: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAÇÃO DO DOCUMENTO ....................................................................... 76
FIGURA 52: ARQUIVO DE RETORNO CHAVE ÚNICA .......................................................................................................................... 76
FIGURA 53: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAÇÃO ALTERNATIVA............................................................................. 77
FIGURA 54: IDENTIFICAÇÃO ESPECIAL .............................................................................................................................................. 79
FIGURA 55: LEIAUTE DE ARQUIVO DE RETORNO - OCORRÊNCIAS ................................................................................................... 81
FIGURA 56: CÓDIGOS DE OCORRÊNCIAS .......................................................................................................................................... 82
FIGURA 57: LEIAUTE DE ARQUIVO DE RETORNO - COBRANÇA ........................................................................................................ 83
FIGURA 58: TIPO DE COBRANÇA PADRÃO ........................................................................................................................................ 84
FIGURA 59: LEIAUTE DE ARQUIVO DE RETORNO ERRO .................................................................................................................... 85
FIGURA 60: OCORRÊNCIAS DE ERROS, MANUAL DO BANCO ........................................................................................................... 86
FIGURA 61: LEIAUTE DE ARQUIVO DE RETORNO VALIDAÇÃO .......................................................................................................... 87
FIGURA 62: LEIAUTE DE RETORNO VALIDAÇÃO DDA ........................................................................................................................ 91
FIGURA 63: LEIAUTE DE ARQUIVO DE EXTRATO CNAB ..................................................................................................................... 95
FIGURA 64 LEIAUTE DE EXTRATO BANCÁRIO CNAB REGISTRO / IDENTIFICAÇÃO ............................................................................ 96
FIGURA 65: EXTRATO BANCÁRIO CNAB ............................................................................................................................................ 96
FIGURA 66: FORMATO DE VALOR ..................................................................................................................................................... 99
FIGURA 67: FORMATO DO TIPO DE LANÇAMENTO .......................................................................................................................... 99
FIGURA 68: TELA DA ABA SERVIÇO ................................................................................................................................................. 101
FIGURA 69: CADASTRO DE CÓDIGOS E DESCRIÇÕES PARA SERVIÇOS DE EXTRATO BANCÁRIO ..................................................... 102
FIGURA 70: NOTA FISCAL DE SAÍDA ................................................................................................................................................ 104
FIGURA 71: LCM DA NOTA FISCAL DE SAÍDA .................................................................................................................................. 104
FIGURA 72: CONTAS A RECEBER ..................................................................................................................................................... 105
FIGURA 73: TELA DE MEIO DE PAGAMENTO .................................................................................................................................. 106
FIGURA 74: ASSISTENTE DE EXPORTAÇÃO - APRESENTAÇÃO ......................................................................................................... 107
FIGURA 75: CONFIGURAÇÃO DO TIPO DE DOCUMENTO................................................................................................................ 108
FIGURA 76: CONFIGURAÇÃO DO FILTRO DE DATA ......................................................................................................................... 108
FIGURA 77: CONFIGURAÇÃO DO FILTRO DE STATUS DO DOCUMENTO ......................................................................................... 108
FIGURA 78: CONFIGURAÇÃO DO FILTRO DE PAGAMENTOS ........................................................................................................... 109
FIGURA 79: CONFIGURAÇÃO DO FILTRO DE SITUAÇÃO DO DOCUMENTO .................................................................................... 109
FIGURA 80: CONFIGURAÇÃO DO FILTRO DE FORMA DE PAGAMENTO .......................................................................................... 109
FIGURA 81: CONFIGURAÇÃO DO FILTRO DE TIPO DE TRANSAÇÃO ................................................................................................ 110
FIGURA 82: CONFIGURAÇÃO DO FILTRO DE CONTAS A PAGAR ..................................................................................................... 110
FIGURA 83: ALERTA ......................................................................................................................................................................... 111
FIGURA 84: ASSISTENTE DE EXPORTAÇÃO - ESCOLHA DOS TÍTULOS.............................................................................................. 111
FIGURA 85: ASSISTENTE DE EXPORTAÇÃO – RESULTADOS ............................................................................................................. 113
FIGURA 86: ASSISTENTE DE IMPORTAÇÃO – APRESENTAÇÃO........................................................................................................ 114
FIGURA 87: ASSISTENTE DE IMPORTAÇÃO – FILTRAGEM ............................................................................................................... 115
FIGURA 88: ASSISTENTE DE IMPORTAÇÃO – ABA AUTOMÁTICA ................................................................................................... 116
FIGURA 89: CONFIGURAÇÃO DO TIPO DE COBRANÇA ................................................................................................................... 117
FIGURA 90: ASSISTENTE DE IMPORTAÇÃO – TELA DE RESULTADOS DA IMPORTAÇÃO DO ARQUIVO ........................................... 117
FIGURA 91: STATUS REPLICADO ..................................................................................................................................................... 118
FIGURA 92: OCORRÊNCIAS NAS COLUNAS MOTIVO E INFORMAÇÕES ADICIONAIS ....................................................................... 119
FIGURA 93: ASSISTENTE DE IMPORTAÇÃO – ABA MANUAL ........................................................................................................... 119
FIGURA 94: ASSISTENTE DE IMPORTAÇÃO – ABA NÃO IDENTIFICADO .......................................................................................... 120
9
FIGURA 95: ASSISTENTE DE IMPORTAÇÃO – RESULTADOS ............................................................................................................ 121
FIGURA 96: ASSISTENTE PARA EXTRATOS CNAB - APRESENTAÇÃO ................................................................................................ 122
FIGURA 97: ASSISTENTE PARA EXTRATOS CNAB - FILTRAGEM ....................................................................................................... 123
FIGURA 98: ASSISTENTE PARA EXTRATOS CNAB - AUTOMÁTICA ................................................................................................... 125
FIGURA 99: ASSISTENTE PARA EXTRATOS CNAB– MANUAL ........................................................................................................... 126
FIGURA 100: ASSISTENTE PARA EXTRATOS CNAB– NÃO-IDENTIFICADOS ...................................................................................... 126
FIGURA 101: ASSISTENTE PARA EXTRATOS CNAB - RESULTADOS .................................................................................................. 127
FIGURA 102: PROCESSAR EXTRATO BANCÁRIO EXTERNO .............................................................................................................. 128
FIGURA 103: ASSISTENTE DE IMPORTAÇÃO DE BOLETOS POR DDA – APRESENTAÇÃO ................................................................. 129
FIGURA 104: ASSISTENTE DE IMPORTAÇÃO DE BOLETOS POR DDA – CONFIGURAÇÕES ............................................................... 130
FIGURA 105: ASSISTENTE DE IMPORTAÇÃO DE BOLETOS POR DDA – SELEÇÃO DOS BOLETOS ..................................................... 131
FIGURA 106: TELA DE IDENTIFICAÇÕES FISCAIS DO PARCEIRO DE NEGÓCIO ................................................................................. 132
FIGURA 107: DEFINIÇÃO DO REGISTRO - DATABASES .................................................................................................................... 134
FIGURA 108: DEFINIÇÃO DO CAMPO – BASE DE DADOS (DATABASES) .......................................................................................... 135
FIGURA 109: PROCESSO DE EXECUÇÃO DE UMA DLL ..................................................................................................................... 151
FIGURA 110: FLUXO DE CHAMADAS DO BUSINESS ONE ................................................................................................................ 152
FIGURA 111: MENSAGEM DE ERRO DA DLL. ................................................................................................................................... 152
FIGURA 112: CONFIGURAÇÃO DA FORMA DE PAGAMENTO .......................................................................................................... 156
FIGURA 113: CONFIGURAÇÕES ESPECÍFICAS DO BOLETO .............................................................................................................. 157
FIGURA 114: CAMINHO DO ONESHARE .......................................................................................................................................... 178
FIGURA 115: TELA INICIAL DA EXPORTAÇÃO DE LEIAUTES ............................................................................................................. 179
FIGURA 116: TELA INFORMANDO O CAMINHO PARA SALVAR O ARQUIVO DE LEIAUTE ............................................................... 180
FIGURA 117: TELA DE SELEÇÃO DE LEIAUTES A SEREM EXPORTADOS ........................................................................................... 181
FIGURA 118: CAMINHO DO ONESHARE .......................................................................................................................................... 182
FIGURA 119: TELA INICIAL DA EXPORTAÇÃO DE LEIAUTES ............................................................................................................. 183
FIGURA 120: TELA QUE INFORMARÁ O CAMINHO ONDE FOI SALVO O ARQUIVO DE LEIAUTE ..................................................... 183
FIGURA 121: TELA DE SELEÇÃO DE LEIAUTES A SEREM IMPORTADOS ........................................................................................... 184
FIGURA 122: TELA DE CORREÇÃO DE INFORMAÇÕES REFERENTES AOS LEIAUTES A SEREM IMPORTADOS ................................. 185
FIGURA 123: TELA DE FINALIZAÇÃO DE IMPORTAÇÃO DE LEIAUTES.............................................................................................. 186
FIGURA 124: CAMINHO PARA ACESSO ÁS CONFIGURAÇÕES SERASA ............................................................................................ 187
FIGURA 125: CONFIGURAÇÕES SERASA / ABA CONFIGURAÇÃO .................................................................................................... 188
FIGURA 126: CONFIGURAÇÕES SERASA / ABA PERMISSÕES DE ACESSO ....................................................................................... 188
FIGURA 127: CONFIGURAÇÕES SERASA / ABA INFORMAÇÕES ...................................................................................................... 189
FIGURA 128: CONFIGURAÇÕES SERASA / ABA INFORMAÇÕES / CONSULTA DE SALDO ................................................................ 189
FIGURA 129: CONSULTAS SERASA .................................................................................................................................................. 190
FIGURA 130: CONSULTAS SERASA / NOVA CONSULTA SERASA ...................................................................................................... 191
FIGURA 131: TELA DE CONSULTA COMPLETA SERASA ................................................................................................................... 192
FIGURA 132: BOTÃO DE CONSULTA SERASA .................................................................................................................................. 192
FIGURA 133: ADD-ON SETTINGS – PARÂMETROS DO BANKSYNC .................................................................................................. 193
FIGURA 134: CONTAS BANCÁRIAS DA EMPRESA – CONFIGURAÇÃO DAS CONTAS ........................................................................ 194
FIGURA 135: LANÇAMENTO CONTÁBIL MANUAL – LANÇAMENTOS EXTRAS ................................................................................. 195
FIGURA 136: PAINEL DE CONTROLE – BOTÃO BACKUP LAYOUT .................................................................................................... 196
FIGURA 137: PAINEL DE CONTROLE – CAMINHO DO BACKUP ....................................................................................................... 196
FIGURA 138: CONFIGURAÇÃO DO BANKSYNC - ACESSO RESTRITO ................................................................................................ 197
FIGURA 139: CONFIGURAÇÃO DO BANKSYNC – ADDON SETTINGS ............................................................................................... 198
FIGURA 140: MENU B1 – NOVA OPÇÃO ......................................................................................................................................... 199
FIGURA 141: PAINEL DE CONTROLE - CONEXÃO ............................................................................................................................ 199
FIGURA 142: MENU B1 – ADMINISTRADOR DE BACKUP LAYOUTS ................................................................................................ 200
10
FIGURA 143: GERADOR DE CONSULTAS – TABELA DE BACKUPS .................................................................................................... 200
Índice de Tabelas
TABELA 1: AUTORIZAÇÕES PARA USUÁRIOS DO BANKSYNC ............................................................................................................ 33
TABELA 2: CHAVES DOS BOLETOS DAS EMPRESAS DO GRUPO ALGODÃO S.A ................................................................................. 36
TABELA 3: NIVELAMENTO DO ARQUIVO DE REMESSA ..................................................................................................................... 55
TABELA 4: ESTRUTURA DOS DADOS DO CÓDIGO DE BARRAS ........................................................................................................ 153
TABELA 5: EXEMPLO DE PREENCHIMENTO DOS CAMPOS LIVRES .................................................................................................. 154
TABELA 6: FORMATAÇÃO DOS DADOS DA LINHA DIGITÁVEL ......................................................................................................... 154
TABELA 7: CAMPOS DA TABELA CONTAS BANCÁRIAS DA EMPRESA .............................................................................................. 155
TABELA 8: CAMPOS DA TABELA FORMAS DE PAGAMENTO ........................................................................................................... 155
11
1. Introdução ao BankSync
O BankSync é uma solução projetada para atender a complexidade dos serviços de
pagamentos e cobrança executados pelos Bancos que integram o Sistema Bancário Brasileiro,
totalmente integrado ao produto SAP Business One™ e é a única solução homologada para este
fim, fornecendo os dados para geração dos arquivos de comunicação bancária e registro das
ocorrências.
O BankSync possui as seguintes funcionalidades:
Criar leiautes dinâmicos de remessa e retorno no padrão CNAB, atendendo as
necessidades dos bancos brasileiros;
Automatizar as situações que um boleto pode assumir dentro do SBO;
Enviar e receber as transferências e boletos do SBO;
Realizar a importação de arquivos de extrato, no padrão CNAB, para o SBO;
Também possui a funcionalidade de integração dos dados de DDA, caso a empresa for
optante do DDA é possível importar os dados de pagamentos diretamente para a base do
cliente;
Importar e Exportar leiautes para outras bases;
Automatizar a reconciliação bancária, evitando erros na reconciliação manual e aperfeiçoar
o tempo utilizado para tal atividade;
2. Comunicação bancária
A comunicação bancária é um serviço disponibilizado pelos bancos que permite que
pessoas físicas e jurídicas troquem informações e solicitem operações com seus bancos. Dentre
as opções disponíveis, estão o envio de dados de títulos para a cobrança de clientes,
manipulação da aplicação do patrimônio obtido em cobranças, pagamentos de despesas para
terceiros, entre outros.
12
2.1. Boletos
O principal meio de comunicação bancária é feito através do uso de boletos, que são
títulos que representam um valor que se tem a receber de um cliente, ou para pagar para um
terceiro. São conhecidos também por bloquetos de cobrança.
Qualquer pessoa, física ou jurídica, pode emitir boletos de cobrança, bastando apenas que
este se registre em sua agência para aderir à modalidade.
Existem duas modalidade utilizadas para boletos de cobrança, chamados de cobrança
registrada e não-registrada:
Registrada: são gerados pelo cedente e as informações do documento são enviadas
para o banco através de um arquivo de remessa. Estes dados são gerenciados pela
instituição financeira que pode realizar serviços, como o protesto de títulos quando
inadimplentes;
Não-Registrada: funcionam como os de cobrança registrada só que as informações do
documento não necessitam ser enviadas para o banco. Portanto, todo serviço de
verificação e protesto fica a encargo do cedente;
Estes serviços apresentam um custo para seus utilizadores, chamado de tarifa. O custo
dos bloquetos de cobrança registrados são cobrados quando o arquivo de remessa é enviado ao
banco. O custo dos bloquetos de cobrança não-registrada, por sua vez, só é cobrado do cedente
quando o sacado efetua o pagamento. De certa forma, os bloquetos de cobrança registrados
podem ser chamados de pré-pagos, enquanto os não registrados podem ser chamados de pós-
pagos.
2.2. Transferências
Outra maneira de realizar movimentações de capital para o pagamento de título é através
da transferência de valores de uma conta para outra. Fazendo uso de transferências, uma
pessoa, física ou jurídica, pode realizar o pagamento de títulos na mesma maneira que faria
utilizando um boleto, mas sem a necessidade de um papel impresso.
Algumas das modalidades de transferências mais utilizadas são o DOC e a TED. O DOC,
ou Documento de Ordem de Crédito, é utilizado para transferências com valores mais baixos e o
dinheiro é liberado apenas no dia útil seguinte ao do processamento da operação.
13
Uma Transferência Eletrônica Disponível (TED) é uma operação na qual os correntistas
realizam operações interbancos para valores iguais ou acima dos R$3.000,00, além disso, este é
um meio mais rápido para transferir recursos, pois, como não há necessidade da operação
passar pelo sistema de compensação dos bancos, o dinheiro fica disponível no mesmo dia, desde
que o emitente tenha saldo na conta.
3. Comunicação bancária dentro do SAP Business One
3.1. Boletos
O controle de boletos dentro do SAP Business One é feito originalmente através de uma
tela específica para a administração dos boletos, localizada em Módulos | Banco | Boleto |
Administração de boletos, demonstrada na Figura 1.
Figura 1: Administração de Boletos
14
Um boleto não pode migrar de uma gaveta para qualquer outra. Existem restrições e
propósitos para a existência de cada uma destas gavetas e para que um boleto se desloque de
uma gaveta para a outra, ele deve passar por todas as gavetas intermediárias.
Na sessão que segue, serão explicados os significados de cada uma destas gavetas,
separados pelo tipo do boleto, que pode ser de Contas a Receber e de Contas a Pagar.
3.2. Boletos de Contas a Receber
Os boletos de Contas a Receber apresentam um controle maior, pois são gerenciados
desde o momento de sua criação.
A Figura 2 demonstra os estados que um boleto de Contas a Receber pode assumir no
sistema. Na sequência, são descritos o que cada uma destas situações representa no sistema.
Figura 2: Status do boleto de Contas a Receber
3.2.1. Enviado
O estado de enviado, também chamado de “criado”, é um dos status iniciais que um boleto
pode assumir no sistema. Ele representa o momento em que o boleto passou a existir
virtualmente dentro de seu sistema. Para o SBO, o sistema sugere que este seja um estado de
aprovação, para que então ele seja aprovado, utilizado e impresso.
Quando um boleto é gerado com o estado de Enviado, não há qualquer lançamento
contábil feito no sistema por parte do documento de Contas a Receber que foi criado.
3.2.2. Gerado
Um boleto que apresenta o estado de Gerado pode apresentar dois significados
dependendo se o boleto foi criado diretamente com o status de Gerado, ou se ele migrou do
status de enviado para o de gerado.
15
Quando um boleto passa para o estado de gerado é realizada uma movimentação da conta
contábil de “Contas a Receber Nacionais/Internacionais” para a conta contábil de “Contas a
Receber por Boletos”.
Partindo do primeiro caso, em que o boleto é criado inicialmente como Gerado, o estado
de gerado tem basicamente o mesmo significado que os boletos com status de Enviado, exceto
que o boleto já se encontra aprovado, caso o usuário esteja utilizando o cenário proposto pelo
SBO.
No segundo cenário, quando o boleto passa de enviado para gerado, significa que o boleto
já foi submetido para a comunicação bancária através de uma remessa. Em outras palavras, o
BankSync troca automaticamente o estado de boletos que estão com a situação igual a Enviado
para Gerado, a partir do momento que este passa a fazer parte de um arquivo de remessa.
De qualquer forma, os boletos que se encontram atualmente em uma remessa e estão a
caminho do processamento pelo banco, estarão sempre com o status de Gerado. Note também
que caso o boleto tenha sido criado inicialmente com o estado de Gerado, o BankSync possui um
controle interno utilizado para identificar quais boletos já foram inseridos em uma remessa ou
não, então ambos os cenários são compatíveis com o Add-on.
3.2.3. Depositado
Esta situação é utilizada pelos bancos para informar ao cedente que o banco recebeu os
dados do seu boleto e que agora ele está sobre custódia dele.
Quando o boleto é passado do status de Gerado para Depositado, ocorre um lançamento
contábil movimentando as contas contábeis de Cobrança da conta bancária da empresa e a de
Apresentação de boletos.
3.2.4. Pago
Este estado indica que o boleto foi pago pelo cliente, e muitas vezes os bancos só irão
mandar dados do boleto no arquivo de retorno quando o boleto for pago.
Porém, existe uma particularidade neste estado, pois para o SAP Business One, quando
um boleto foi pago pelo seu cliente, isto não significa que a sua empresa recebeu o dinheiro
ainda. A confirmação deste recebimento do dinheiro é feita através de um demonstrativo no
16
extrato bancário, o qual deve ser reconciliado no sistema contra o boleto. Como os bancos não
informam a qual boleto cada linha do extrato é referente, esta reconciliação deve ser executada
manualmente pelo usuário do SBO.
Os boletos que se encontram reconciliados no sistema aparecem na gaveta dos boletos
pagos juntamente com os que ainda não foram. Para identificar se um boleto já foi reconciliado ou
não, basta observar nas colunas Reconciliada e Nº da reconciliação externa, esta última só
apresentando valor caso a primeira coluna indique “sim”. A Figura 3 mostra um exemplo em que
se podem identificar boletos reconciliados junto com os que não foram.
Figura 3: Boletos pagos reconciliados ou não
OBS: as colunas Reconciliada e Nº da reconciliação externa não aparecem por padrão
no programa. Deve-se clicar no botão de Configurações do Formulário e marcá-las para
exibição.
3.2.5. Cancelado
Um boleto que se encontra nos estados de Enviado e Gerado pode ser cancelados. Esta
operação irá reverter o lançamento contábil manual criado pelos boletos que se encontram no
estado Gerado.
17
A operação de cancelamento de um boleto é irreversível e irá encerrar também o Contas a
Receber ao qual o boleto estava associado. O título vinculado ao Contas a Receber passará para
a situação “aberta” novamente.
3.2.6. Sem êxito
Esta operação tem o propósito similar ao de cancelamento, exceto que funciona apenas
para os boletos que estão no estado Pago.
Uma vez que um boleto caia na situação Sem Êxito, é feito um lançamento da “Conta
Contábil Do Banco” para o “Contas a Receber Nacionais” daquele cliente.
OBS: deve ser tomada a devida cautela ao executar esta operação, pois caso o boleto não
tenha sido reconciliado ainda no sistema, pode ficar uma falha na contabilidade, tendo em vista
que nunca houve um lançamento da “Conta Contábil de Cobrança/Desconto do Banco” para a
“Conta Contábil do Banco”.
3.3. Boletos de Contas a Pagar
O SAP Business One realiza um controle mais simplificado dos boletos de Contas a Pagar,
tendo em vista que preocupações quanto a sua origem e emissão fazem parte do papel do
cedente.
É importante ressaltar que o boleto de Contas a Pagar deve receber algumas informações
a mais do que os de Contas a Receber, como o número do boleto e sua linha digitável.
A Figura 4 demonstra os estados que um boleto de Contas a Pagar pode assumir no
sistema. Na sequência, são descritos o que cada uma destas situações representa no sistema.
Figura 4: Status dos boletos de Contas a Pagar
18
Alguns usuários utilizam o campo Código de Barras do boleto de Contas a Pagar para
informarem o código lido do boleto pela leitora de barras, enquanto que outros inserem neste
campo o valor da linha digitável do boleto.
O valor que é preenchido neste campo é salvo na tabela OBOE, no campo BarcodeRep
que é reservado pelo SBO para guardar a representação, ou linha digitável do código de barras.
Para o SBO, o preenchimento deste campo é indiferente, já que o valor é armazenado
apenas para posteriores consultas. Porém, para o BankSync, os três primeiros dígitos deste
campo são utilizados para identificar a qual banco pertence o boleto de Contas a Pagar. Este
valor será utilizado nos Leiautes de arquivo de remessa para Contas a Pagar. Mesmo assim,
independente dos valores que o usuário escolha preencher neste campo, ambos apresentam nos
primeiros três números o Código do banco.
3.3.1. Gerado
Todos os boletos para Contas a Pagar são criados com o estado igual a Gerado. Neste
momento é gerado um lançamento contábil da conta contábil “Contas a Pagar Nacionais” para o
“Contas a Pagar por Boleto”.
Um boleto neste estado pode ser deslocado para os outros dois estados, Pago e
Cancelado.
3.3.2. Pago
O estado Pago indica que o boleto foi efetivamente pago para o cedente e quando um
boleto é deslocado para este status, é criado um lançamento contábil das contas de “Contas a
Pagar por Boleto” do parceiro de negócio para a conta “Conta Contábil do Banco”.
Um boleto que se encontra na situação de Pago não pode ser diretamente cancelado,
porém é possível retorná-lo para o estado Gerado e passá-lo posteriormente para Cancelado.
Passar o boleto para o estado Gerado irá gerar um lançamento de estorno do lançamento que foi
gerado, quando o boleto foi passado para Pago.
3.3.3. Cancelado
Uma vez que um boleto entre na aba de “Cancelados”, este não pode mais ser
movimentado pelas abas. Também é criado um estorno para o lançamento do status de Gerado
do boleto.
19
3.4. Transferências
As transferências no SBO ocorrem de uma maneira mais simplificada, quando comparado
aos boletos.
Quando determinando o meio de pagamento por transferência de um Contas a Pagar, o
usuário deve apenas escolher uma conta da qual será retirado o dinheiro e informar uma
referência qualquer para a transferência. Feito isto, o Contas a Pagar será criado considerando
que a transferência já ocorreu e realizando as devidas contabilizações.
Porém, para a maior parte dos clientes este comportamento é indesejado, tendo em vista
que este cenário impede o uso da comunicação bancária, já que o cliente só poderá criar os
Contas a Pagar uma vez que a transferência já tenha ocorrido.
Para auxiliar neste problema, o BankSync adotou uma solução alternativa para a criação
das transferências. Com o BankSync ligado e através da tela Módulos | Banco | Contas a Pagar |
Contas a Pagar, no momento em que o usuário tenta inserir o novo Contas a Pagar no sistema,
o BankSync intervém criando, ao invés do Contas a Pagar, um rascunho de pagamento, o qual
será guardado até o momento em que o pagamento realmente ocorra no sistema para que então
o verdadeiro Contas a Pagar seja criado e contabilizando no sistema. Para auxiliar no
entendimento do processo adotado pelo BankSync, veja a Figura 5.
20
Figura 5: Processo das transferências no BankSync
Figura 6: Status das transferências do BankSync
Como pode ser observado nas figuras Figura 5 e Figura 6, o processo do BankSync possui
quatro estados, similares aos de boletos de Contas a Pagar. Quando uma nova transferência é
criada, ela se encontra no estado de Enviado, passando para Gerado uma vez que ela se
encontre em uma remessa. Após a importação de um retorno, a transferência pode passar para
Pago ou Cancelado. Se ela passar para Pago, então será gerado um documento de Contas a
Pagar a partir do rascunho gerado inicialmente. Caso contrário, o rascunho anterior será
cancelado e enviado para a aba de cancelados.
21
3.5. Particularidades do processo adaptado
Infelizmente, a solução adotada pelo BankSync gera alguns transtornos para o usuário,
tendo em vista que o add-on prioriza a segurança dos dados às comodidades do usuário dentro
SAP Business One.
A primeira destas particularidades se dá quanto à consulta dos novos títulos criados pelo
BankSync. A tela de Contas a Pagar não irá mostrar nenhum novo registro quando você criar um
novo pagamento por transferência, pois o documento criado é um rascunho.
Tentar consultar eles na tela de rascunho também irá resultar em fracasso, pois o
BankSync esconde os rascunhos gerados por ele próprio, para evitar que o usuário tente gerar
outro Contas a Pagar a partir dele.
A única forma efetiva para a consulta destes rascunhos é através da tela Módulos | Banco |
Transferências Bancárias | Administração de Transferências Bancárias. Esta tela é similar a
de Administração de boletos do SBO.
Outro inconveniente causado pelo uso de rascunhos, é que documentos vinculados a
rascunhos ainda irão tentar aparecer na tela de Contas a Pagar após a escolha do parceiro de
negócio, já que eles apenas deixam de aparecer quando estão ligados a um Contas a Pagar real.
O BankSync se encarrega desta tarefa excluindo da tela de Contas a Pagar os títulos que
já estão associados a um rascunho não cancelado.
O problema surge quando o BankSync não está em execução, pois os documentos que já
estão vinculados a rascunhos poderão ser pagos novamente, causando inconsistências para o
add-on. Cabe aqui uma sugestão ao usuário, informando ao mesmo que toda operação
envolvendo Contas a Pagar e Contas a Receber, deve ser feita com o BankSync ativo.
22
4. Informações técnicas
4.1. Tecnologia
Os recursos tecnológicos utilizados para o desenvolvimento do BankSync integram os
seguintes grupos:
SAP Software Development Kit (SDK)
Este kit para desenvolvimento fornece uma interface de relacionamento do add-on com o
produto SAP Business One™ através de duas API (Application Protocol Interface):
o Data Interface – API (DI-API): a interface de dados provê os métodos e atributos
necessários para a manipulação da base de dados. Através dela é possível recuperar,
editar, inserir e atualizar dados.
o User Interface – API (UI-API): a interface de usuário provê a interação com a
aplicação. Através dela é possível inserir, modificar e remover funcionalidades visuais.
4.2. Conexão Remota
O servidor e o cliente obrigatoriamente devem estar na mesma sub-rede. Caso exista a
necessidade desse acesso remoto, deve-se fazê-lo através do software Team Viewer que a
equipe de suporte utiliza, efetuando esses acessos apenas nas versões 5 e 6.
O Team Viewer está disponível no site da Sistema Informática Empresarial no seguinte
link: http://www.sistemainfo.com.br/conteudo.php?mnu=atendimento_acessoremoto.
4.3. Suporte Técnico
O suporte ao cliente inicialmente será prestado pelo VAR, que mantém o trato com o
cliente. O atendimento da equipe de Suporte SAP da Sistema Informática Empresarial para com o
VAR será por meio de chamados, que poderão ser cadastrados no site da Sistema Informática
utilizando um login e senha, cadastrados pela própria equipe de Suporte SAP para o VAR.
23
5. Instalação
Este capítulo irá guiá-lo por todo o processo que envolve a instalação e configuração do
add-on dentro do SAP Business One. Ele lhe demonstrará onde baixar o software, como registrá-
lo no SBO, o que é e onde obter uma chave de ativação, como realizar a aquisição de uma
licença para utilização do add-on dentro do SBO no site da SAP, como atribuir esta licença para
um usuário e como configurar as permissões mínimas para que este usuário possa usar o add-on
sem restrições por parte do SBO.
5.1. Download do Software
O primeiro quesito para a instalação do software é navegar até nosso site2. O endereço
direto para a página de download está atualmente no link abaixo:
http://www.sistemainfo.com.br/conteudo.php?mnu=solucoes_BankSync_download
Esta página contém a última versão disponível do add-on, bem como as DLL’s que podem
ser utilizadas com as formas de pagamento do SBO.
Este processo segue o padrão estabelecido pelo produto SAP Business One™. O grupo de
objetos enviado ao VAR para que este possa efetuar a instalação do add-on no ambiente do
Cliente é composto pelos seguintes itens:
BankSync Setup.ard: arquivo que define os registros necessários para a instalação do
produto;
BankSync Setup.exe: arquivo que executa o processo de instalação do add-on dentro
do SAP Business One™;
É necessário salientar que este add-on foi desenvolvido sobre a Plataforma Microsoft .Net,
sendo assim, é necessário que o cliente tenha o .Net Framework 3.5 instalado em cada máquina
que deseja utilizar o add-on. Este framework é free3 e tem sua distribuição feita pelo site de sua
fabricante, a Microsoft.
5.2. Registro do Add-On no SBO
2 Site SIE: www.sistemainfo.com.br
3 Free: Licença Free;
24
Uma vez feito o download são descompactados os arquivos, deve-se efetuar o login no
SBO com um usuário com permissões para alteração nos registros de add-ons (geralmente é o
usuário manager), e navegar até a tela de Módulos | Administração | Add-Ons | Administração
de add-on.
Figura 7: Registrando o add-on no SBO
Nesta tela, demonstrada na Figura 7, deve-se selecionar o botão Registrar add-on. Ele irá
abrir uma nova janela, onde deve clicar no botão , e informar para o programa onde se
encontra o arquivo BankSync.ard. Encontrado o caminho do programa, selecione OK.
25
Figura 8: Configuração de inicialização do add-on
Uma vez informado o caminho até o instalador do add-on, uma nova linha com os dados
do BankSync irá aparecer na grade de add-ons atribuídos à empresa. Configure os dados da
grade conforme a Figura 8 e clique sobre o botão Atualizar. Feito isto, você terá informado ao
SBO que seu add-on precisa ser instalado, e que ele deverá ser inicializado automaticamente
toda vez que uma nova instância do SAP Business One for iniciada.
5.3. Instalação do Add-On no SBO
Agora que o add-on já está registrado dentro do SBO, é hora de realizar a sua instalação.
Para isso, vá até o menu Módulos | Administração | Add-Ons | Administrador add-on, e navegue
até a aba Add-ons pendentes. Você irá se deparar com uma tela similar a demonstrada na
Figura 9. Clicando sobre o botão Instalar, será dado início ao Assistente de Instalação do
BankSync.
26
Figura 9: Início da instalação do add-on no SBO
As imagens a seguir demonstram apenas as telas do instalador do BankSync que
apresentam configurações para o usuário preencher. A primeira (Figura 10) solicita informações
com relação à empresa do usuário, enquanto que a segunda (Figura 11) pede para que seja
definido o local onde o add-on será instalado.
OBS: o caminho padrão geralmente atende as necessidades dos usuários. É
recomendado que este caminho não seja alterado.
27
Figura 10: Instalação – Informações do usuário
Figura 11: Instalação – Caminho da instalação
28
Uma vez escolhidas estas configurações, o add-on iniciará a sua instalação. Até este
momento, o BankSync não terá criado, ainda, nenhum objeto dentro do SAP Business One.
Porém, caso o usuário tenha informado para o add-on executar automaticamente junto com o
SBO, prossiga imediatamente para a próxima etapa: Primeira execução do BankSync.
5.4. Primeira execução do BankSync
Quando o BankSync for executado pela primeira vez, ele irá solicitar algumas informações
para o usuário. As sessões que vêm na sequência demonstram com mais detalhes os
procedimentos que devem ser tomados.
OBS: durante o processo da primeira execução da BankSync, fique atento para a tela
mostrada na Figura 12, pois ela irá aparecer sempre que houver uma alteração na estrutura da
base de dados. Para que o add-on possa continuar sua instalação sem imprevistos, clique
sempre em “Sim” toda vez que esta tela aparecer.
Figura 12: Atualização da estrutura da base de dados
5.4.1. Senha para o banco de dados
A primeira destas informações é a senha do usuário “sa” do banco de dados, a qual será
guardada pelo add-on, para que posteriormente ele possa fazer consultas à base de dados. A
Figura 13 demonstra a tela:
29
Figura 13: Requisitando a senha do banco de dados
5.4.2. Dados padrões das tabelas do BankSync
Após alguns minutos, o add-on irá alertar o usuário de que ele precisa inserir os dados
padrões dentro da base de dados, e que este processo levará alguns minutos. Além de poder
ocasionar travamentos para outros usuários do sistema. Selecione “Sim” para prosseguir
normalmente pela instalação. Se desejar continuar esta operação em outra ocasião, selecione
“Não” para parar a execução do add-on. A Figura 14 mostra um exemplo da tela em questão:
Figura 14: Aviso antes de povoar as tabelas do Add-On
5.4.3. Chave de ativação
Por último, o BankSync irá requisitar ao usuário para que este informe a sua chave de
ativação, conforme demonstrado na Figura 15. O campo da chave de ativação é o único no qual o
usuário deverá preencher dados.
30
OBS: Os campos que estão à esquerda da figura deverão ser ignorados por hora.
Caso o usuário não possua uma chave de ativação, este deverá entrar em contato com a
Sistema Informática Empresarial para solicitar a sua chave, via e-mail ou telefone. Esta chave
será única para cada instalação de servidor do SBO e estará vincula a chave de hardware, código
do sistema e código da instalação do SBO. Sem esta chave de ativação o produto não poderá ser
inicializado.
Figura 15: Chave de ativação
5.5. Licenças para Add-Ons da SAP
Para que o add-on possa ser inicializado no SAP Business One, é necessário que o VAR
obtenha uma licença de uso diretamente no site da SAP. Esta sessão informa o usuário sobre
como esta licença pode ser adquirida, e onde ela deve ser utilizada dentro do SBO.
5.5.1. Adquirindo uma licença
Os passos para adquirir esta licença fazem parte da própria documentação da SAP,
disponíveis no link:
31
https://websmp104.sap-ag.de/smb/sbo/licensekeys
5.5.2. Atribuindo as licenças
Uma vez que uma ou mais licenças tenham sido adquiridas e registradas no servidor de
licenças do SAP Business One, é necessário ainda atribuí-las a usuários do SBO. Para atribuir
uma licença no sistema, navegue até Módulos | Administração | Licença | Administração de
licenças, e selecione o usuário que deseja atribuir uma licença do add-on na grade de Usuários.
Em seguida, marque a licença do BankSync, na grade de Licenças Externas, e finalize clicando
no botão Atualizar. A Figura 16 demonstra este procedimento, utilizando no exemplo o usuário
manager.
Figura 16: Selecionando licença para um usuário
5.6. Configurando usuários do BankSync no SBO
Uma vez que seus usuários estejam com as permissões para o uso do BankSync
configuradas, deve-se ainda garantir que estes possuam acessos as telas do mesmo. Este
controle é mantido pelo próprio SAP Business One, e o local onde estas opções podem ser
32
gerenciadas ficam em Módulos | Administração | Inicialização do sistema | Autorizações |
Autorizações gerais. Vide Figura 17 para um exemplo desta tela:
Figura 17: Autorizações gerais por usuário
Para garantir o acesso as principais telas utilizadas pelo BankSync, é necessário configurar
as permissões para o usuário em questão conforme demonstrado na Tabela 1.
33
Tabela 1: Autorizações para usuários do BankSync
6. Configurações
Esta sessão do manual irá demonstrar para o usuário como preparar o add-on, realizando
todas as configurações necessárias para seu uso dentro do SBO.
Em um primeiro momento, serão explicadas as configurações que precisarão ser
realizadas nas telas do próprio SBO e, na sequência, passarão a ser explicadas as telas do
próprio BankSync.
Cada item será inicialmente apresentado com uma breve introdução sobre o propósito da
tela, seguido de um detalhamento mais aprofundado sobre o propósito de seus campos; em
alguns casos, passando a oferecer dicas sobre o seu preenchimento, ou apontando para
exemplos em que seu uso se faz necessário.
Nas telas apresentadas, itens importantes para o BankSync serão destacados em
vermelho. Estes e outros itens serão descritos em mais detalhes a cada tela apresentada.
6.1. Telas do SAP Business One
34
Este primeiro grupo de configurações expõe particularidades que devem ser tratadas em
telas do próprio SAP Business One.
6.1.1. Detalhes da empresa
Esta tela abaixo (Figura 18) pode ser encontrada em Módulos | Administração | Inicialização
do Sistema | Detalhes da Empresa. Na aba Dados contábeis existe um único campo de usuário
que é de interesse para o BankSync, que é o Chave única da empresa.
Figura 18: Detalhes da Empresa
Quando temos casos em que a empresa contratante do SBO emite boletos em mais de
uma base de dados, utilizamos este campo para distinguir de qual base o boleto foi lançado, para
evitar confusões com as numerações internas do SBO.
Para facilitar a compreensão de seu uso e importância, vamos utilizar como exemplo as
empresas do grupo Algodão S.A, demonstrado na Figura 19. Supondo que cada uma destas
bases hipotéticas gerasse remessas de boletos para um banco em comum; no momento em que
35
o retorno do banco fosse ser importado para dentro do SBO, poderiam existir nele boletos
emitidos de cada uma das bases citadas no exemplo.
Figura 19: Exemplo de mais de uma base no SBO
Isto causaria um conflito, no que diz respeito à identificação dos boletos que estão no
arquivo com os que estão nas bases das empresas, pois a maneira principal de identificação
utilizada pelo BankSync é pela chave primária da tabela de boletos OBOE.BoeKey, ou seja, em
um mesmo retorno bancário, se existissem dois boletos com o mesmo código (Ex: OBOE.BoeKey
= 1), porém de bases diferentes, o BankSync não saberia identificar a qual base cada boleto
pertenceria.
Ao configurar o campo de Chave única da empresa para representar as siglas de sua
empresa, podemos evitar este problema de identificação. De acordo com a Tabela 2, podemos
acompanhar que a chave dos boletos é precedida pela chave única da base que gerou o boleto.
A base de dados GAMA está com o valor padrão que é dado quando há uma nova instalação do
BankSync, UNC. As bases ALPHA e BETHA estão devidamente configuradas, com uma chave
única distinta para cada uma delas; enquanto que a base DELTA não possui qualquer
identificação. Como não existem chaves repetidas, não haverá problemas de identificação entre
as bases, com exceção a base DELTA, pois esta não possui chave única, e poderá causar
problemas até para as outras bases.
36
Tabela 2: Chaves dos boletos das empresas do grupo Algodão S.A
6.1.2. Configurações gerais
A tela de Configurações gerais, disponível em Módulos | Administração | Inicialização do
Sistema | Configurações gerais, apresenta várias configurações importantes para o SBO, porém
para o BankSync, apenas o campo Pasta Boleto que se encontra na aba Caminho, é de
extrema importância.
Este caminho serve para indicar onde se encontram as DLL’s no momento em que o SBO
vai criar um boleto de Contas a Receber. Para que as DLL’s apareçam na lista de Algoritmos de
código de barras, em Formas de pagamento, é necessário que elas estejam na pasta “Boleto”,
dentro do diretório onde o SBO fora instalado. Geralmente este diretório é C:\Arquivos de
Programas\SAP\SAP Business One\Boleto.
Figura 20: Configurações Gerais
37
OBS: é importante ressaltar que o diretório que o SBO usa para buscas as DLL’s que
poderão ser escolhidas na tela de Forma de Pagamento não é necessariamente o mesmo de
onde ele irá buscar as DLL’s no momento em que o SBO irá criar um boleto de Contas a
Receber. Isto geralmente causa confusão entre os usuários. Por isso, aconselhamos a deixar o
valor para o campo Pasta Boleto apontando para C:\Arquivos de Programas\SAP\SAP Business
One\Boleto.
6.1.3. Contas bancárias da empresa
O cadastro de contas bancárias da empresa possibilita o cadastro de contas bancárias
para uso dentro do sistema, em especial para a contabilização de pagamentos e recebimentos.
Este cadastro é utilizado principalmente em conjunto com a Forma de Pagamento; e alguns dos
campos presentes nesta tela são requisitos para o uso apropriado das DLL’s associadas às
formas de pagamento. Para acessar esta tela (Figura 21), acesse: Módulos | Administração |
Configurações | Banco | Contas bancárias da empresa.
Figura 21: Contas bancárias da empresa
O preenchimento da maioria de seus campos é de fácil compreensão, contudo existem
alguns que precisam de especial atenção e que são destacados na sequência:
38
Código do Banco – BankCode
Código utilizado para identificação do banco;
Número da conta – Account
Número da conta bancária da empresa. Informe apenas números, e não informe os dígitos
verificadores, já que estes possuem um campo próprio para eles;
Filial – Branch
Este campo é o número da agência do banco onde a empresa possui a conta. Informar o
valor sem os dígitos verificadores e utilize apenas números;
Chave de controle – ControlKey
Utilize este campo para informar o dígito verificador da Agência, caso ela tenha algum;
Dígito de controle da conta – AccountChk
Informe o dígito verificador do número da conta da empresa neste campo. Em caso de
existirem mais de um dígito verificador para o número da conta, utilize o campo Usuário nº 1
(DSC1.UsrNumber1);
Nosso Número – OurNum
Informe aqui o número que deseja para o próximo boleto de Contas a Receber que for
emitir no sistema. Existe uma particularidade4 quanto a este campo, que faz com que ele precise
ser utilizado em conjunto com o campo do Nº do Acordo e/ou o Nº do Contrato;
Número do Acordo – AgreeNum
Este campo deve ser utilizado para complementar o campo Nosso Número;
Conta contábil – GLAccount
4 Para maiores detalhes sobre como deve ser feito o preenchimento do campo Nosso Número, consulte o capítulo
referente às DLL’s.
39
Esta é a conta contábil que irá ser utilizada quando o boleto for finalmente finalizado.
Importante ressaltar que um boleto só será finalizado após o mesmo ter sido consolidado.
Dependendo do seu tipo de contabilidade, caso queira que suas movimentações bancárias
sejam diferentes para cada conta ou banco, aconselhamos criar uma conta contábil para cada
banco. O mesmo deve ser feito para a Conta contábil provisória, a conta do Banco de
cobrança e a conta do Banco de desconto, que estão descritos na sequência.
Conta contábil provisória – GLIntrAct
Esta conta é utilizada quando o boleto foi reconciliado e a Forma de Pagamento está
marcada com a opção Lançar na conta contábil provisória.
Banco de cobrança – BankCollec
Conta utilizada quando o boleto é passado para o status de pago, e a maneira escolhida
para seu pagamento foi a de cobrança.
Banco de desconto – BankDiscou
Conta utilizada quando o boleto é passado para o status de Pago, e a maneira escolhida
para seu pagamento foi a de descontado.
Leiaute de Extrato CNAB – U_CodeCSLA
Informe neste campo5 o código do leiaute de extrato CNAB para importações de extrato
neste banco.
Leiaute de Importação por DDA– U_CodeILAY
Informe neste campo o código do leiaute de retorno bancário, para importações de
arquivos para DDA. Este campo mostrará apenas leiautes marcados como DDA, no cadastro de
leiautes de retorno. Somente contas bancárias da empresa que possuem este campo preenchido
estarão disponíveis para seleção durante o assistente de Importação de Boletos por DDA.
Número do Contrato – U_Contract
Este campo é de uso especial para as DLLs do BankSync.
5 Pressione TAB sobre ele, com o Add-on iniciado, para chamar uma Choose From List com a sugestão de valores;
40
6.1.4. Formas de pagamento
Localizada em Módulos | Administração | Configurações | Banco | Formas de pagamento,
as formas de pagamento são utilizadas no momento de uma compra ou venda, e possuem
detalhes referentes ao tipo de pagamento escolhido.
O BankSync só realiza o controle de boletos para Contas a Pagar ou receber, e para
transferências de Contas a Pagar.
Veja na sequência, como deve ser feito o preenchimento de seus campos. Utilize a Figura
22 para auxiliar na identificação dos campos:
Figura 22: Forma de pagamento
Código da forma de pagamento – PayMethCod
41
Informe um código para a forma de pagamento. Aconselha-se a utilizar um código que
indique o tipo, a conta e o banco ao qual a forma de pagamento pertence, mas não há nada que
lhe impeça de utilizar da forma que melhor achar.
Descrição – Descript
Uma descrição mais significativa, do que o código, para o método de pagamento.
Tipo de pagamento – Type
Informe se o tipo da forma de pagamento será de Recebido, para vendas e Contas a
Receber; ou de Pago, para compras e Contas a Pagar.
Meio de pagamento - BankTransf
Aqui é onde se informa qual método será utilizado no pagamento de contas. Dependendo
das combinações utilizadas entre Tipo de Pagamento e Meio de Pagamento, alguns
componentes podem aparecer, ou não.
Banco da empresa – BankCountr, BankDflt, DflAccount, Branch, BankCtlKey
Aqui, deve-se escolher uma das contas bancárias da empresa que foram cadastradas
anteriormente. Para facilitar a escolha, clique sobre o botão , que está ao lado do campo “País”.
Uma tela, conforme demonstrado na Figura 23, irá aparecer permitindo-lhe escolher uma conta.
42
Figura 23: Escolha da conta bancária da empresa
Características do Boleto
Destaca-se em especial, o botão . Este botão está disponível apenas quando o Tipo de
Pagamento for Recebido, e o Meio de Pagamento for Boleto. Ao clicar-se sobre ele, uma nova
janela irá aparecer (Figura 24).
43
Figura 24: Propriedades do boleto
Nesta tela, devem ser preenchidos os dados conforme instruído no manual CNAB do
banco em questão. Alguns campos foram adicionados a partir da versão 8.82 do SBO como:
Instrução de cancelamento, Código de ocorrência e Código de movimento que é um campo
“Obrigatório” para gerar a remessa pelo BankSync.
Mas é importante citar o preenchimento de dois campos além dos citados acima, que são
particularmente importantes para as DLLs: O Nº do portfólio e o Código da Moeda.
Primeiro, com relação ao código da moeda, a não ser que seja especificado de maneira
diferente, este código deverá ser sempre 9 ou 0. O código 9 simboliza a moeda “Real”, enquanto
0 simboliza um valor neutro, e que o banco irá tratá-lo em sua moeda padrão, ou de outra
maneira especificada pelo manual do banco.
Com relação ao campo do portfólio, também chamado de carteira no banco, o valor que
interessa para o programa é o que está presente em Nº do portfólio. Para cadastrar/editar este
valor, basta clicar sobre o botão ao lado do campo Id portfólio interno. Isto irá abrir uma nova
tela, vista na Figura 25.
44
Figura 25: Lista de Carteiras
Clicando para editar, ou criar um novo registro, aparecerá à tela presente na Figura 26.
Figura 26: Cadastrar carteira
Enviar para aprovação – SendAccept
45
Quando esta opção estiver marcada (Figura 27), novos boletos serão sugeridos para
serem criados com o status de Enviado, ao invés de Gerado. Isto permite para o usuário um
controle mais facilitado dos boletos que já fazem parte de uma remessa, pois eles estarão com o
status igual a Gerado.
Figura 27: Opção para aprovação
OBS: Caso esta opção não esteja marcada, novos boletos serão criados com o status de
Gerado. Porém, isto não será problema para o BankSync, pois ele possui um controle interno dos
boletos que já foram incluídos em uma remessa.
Algoritmo do código de barras – BoeDLL
Este campo (Figura 28) aparece apenas quando a Forma de pagamento está com Meio
de pagamento igual a Recebido e Tipo de pagamento igual a Boleto. É neste campo que o
usuário escolhe onde e qual das DLL de forma de pagamento ele irá utilizar.
Figura 28: Escolher uma DLL
Caso a DLL que você esteja procurando não esteja disponível na lista, clique sobre a
opção Definir Novo, mostrado na Figura 28, e informe o caminho até sua DLL na tela que
46
aparece (Figura 29). Isto fará com que a DLL seja copiada para a pasta, considerando uma
instalação padrão do SBO, no caminho: C:\Arquivos de Programas\SAP\SAP Business
One\Boleto.
Figura 29: Caminho para inserir a DLL
OBS: para evitar erros, mantenha as DLLs atualizadas e se possível na pasta de
instalação do SBO, que geralmente encontra-se no seguinte caminho (C:\Arquivos de
Programas\SAP\SAP Business One\Boleto).
6.1.5. Parâmetros do BankSync
Ao clicar sobre o botão , o qual está disponível apenas para formas de
pagamento para Boletos de Recebido e Pago, ou para Transferências de Pago. Irá aparecer
uma tela contendo algumas informações que são de relevância para o BankSync. Uma amostra
da tela se encontra abaixo na Figura 30:
47
Figura 30: Parâmetros do BankSync
O campo de Número Sequencial de Remessa é automaticamente incrementado toda vez
que uma remessa, utilizando aquela forma de pagamento, é realizada.
Os campos de Leiaute de Remessa e Leiaute de Retorno apontam para o leiaute que
deverá ser usado no momento em que um processo de remessa ou retorno, for utilizar esta forma
de pagamento. Caso o tipo da Forma de pagamento seja de Recebido, apenas leiautes de
Contas a Receber irão aparecer; se for de Pago, aparecerão apenas os de Contas a Pagar.
Por último, a Conta contábil para tarifas bancárias é a conta que deve ser utilizada, para
aquela forma de pagamento, quando um boleto apresentar uma tarifa cobrada pelo banco.
Os campos que estão abaixo de conta contábil para tarifas bancárias não devem ser
alterados. Eles são utilizados apenas em casos muito especiais, e a má configuração destes
poderá causar inconsistências em sua contabilidade.
48
6.2. Telas do BankSync
Esta sessão do manual irá demonstrar e explicar as telas de configuração apresentadas
pelo BankSync.
OBS: não iremos apresentar a tela de leiaute de Extrato Bancário (não CNAB), por ser um
leiaute raramente utilizado. É possível importar arquivos de extrato do banco, que são separados
por “,” por meio de uma própria tela do SBO.
6.2.1. Nomenclatura de Arquivo de Remessa
O cadastro de Nomenclatura de Arquivo de Remessa tem por objetivo, oferecer uma
regra de nomenclatura personalizável para os arquivos gerados pelas remessas do BankSync.
Esta tela está disponível em Módulos | Administração | Configurações | Banco | BankSync |
Nomenclatura de arquivo de remessa, um exemplo desta tela encontra-se abaixo na Figura 31.
Figura 31: Nomenclatura de arquivo de remessa
49
Código - Code
Um código único para este cadastro.
Descrição – Name
Descrição para a nomenclatura.
Diretório base – U_BasePath
Este é o diretório em que o BankSync irá criar seu arquivo de remessa.
OBS: caso o diretório esteja errado e/ou a pasta não exista, o BankSync acusará um erro.
Criar subdiretório pelo nome da Forma de Pagamento – U_Subdirs
Caso esta opção esteja marcada, o BankSync irá criar o arquivo de remessa dentro de
uma pasta adicional ao caminho em diretório base, utilizando como nome para este nova pasta, o
código da forma de pagamento.
Exemplificando, imaginem que a forma de pagamento tenha um código igual a P0001, os
arquivos de remessa gerados para esta forma de pagamento, seriam localizados no diretório
C:\BankSync\Export\P0001.
Definição de Nomenclatura
Figura 32: Grade para definições da Nomenclatura de arquivo de remessa
50
Nesta grade, podemos personalizar como será feita a montagem do nome do arquivo
gerado pela remessa. Os botões Adicionar linha e Remover linha manipula a quantidade de
linhas para montar a estrutura do nome. Segue uma descrição das colunas desta grade:
Para auxiliar nos exemplos, vamos assumir que o leiaute em questão esteja gerando o
seguinte nome: REM250720120941.txt; e que a linha para nossos exemplos será a segunda de
cima para baixo.
Significado – U_Name
Pode ser chamado também de descrição. Ajuda a identificar o propósito desta linha.
Pos – U_Position
A posição que o conteúdo desta linha irá assumir dentro do nome do arquivo montado.
Em nosso exemplo, a posição para a data da remessa inicia na quarta posição do nome.
Qtde – U_Size
Representa o tamanho final que este valor deverá apresentar dentro do nome. Caso o
valor em Qtde seja diferente do previsto, o programa irá compensar os valores em falta, ou cortar
os valores em excesso, sempre da esquerda para a direita.
O valor para preenchimento dos espaços faltantes é feito com base no tipo, conforme
demonstrado no próximo tópico.
Tipo – U_Type
O tipo do registro serve como uma validação da linha, para garantir que o pedaço em
questão do nome atenda a um dos critérios pré-estabelecidos. Os valores que ele pode assumir
são:
Texto Fixo: Utilizado quando o programa não deva apresentar um tratamento para este
campo;
Contador: Representa um valor numérico que irá aumentar a cada nova remessa gerada;
Contador diário: Idêntico ao Contador, exceto que a cada novo dia, o contador é
reiniciado para “1” novamente;
51
Datetime: Indica que o valor final é uma data, e irá tentar converter a data informada em
conteúdo, caso esta seja diferente de vazia;
Conteúdo – U_Value
Conteúdo é o valor que será utilizado no nome do arquivo. No caso de Datetime, se o
campo Conteúdo estiver vazio, o sistema pegará a data de hoje. Para os campos Contador e
Contador Diário, deve-se colocar pelo menos o valor “1” para que o programa comece a
incrementar a partir dele.
Formato – U_Value
Formato define que validação deverá ser utilizada, e como o valor deverá ser mostrado no
nome do arquivo.
A formatação que ele irá apresentar e se existir alguma particularidade, estão descritos na
sequência:
Livre: O programa não realiza qualquer validação sobre este trecho do nome;
Maiúscula: Converte todo o valor presente em Conteúdo para letras maiúsculas;
Minúscula: Converte todo o valor presente em Conteúdo para letras minúsculas;
Numérico: Converte o valor para um número, descartando os pedaços de Conteúdo que
não forem numéricos;
Data/Hora: Quando formatado como data, o valor que será utilizado é o do dia atual do
relógio de seu sistema operacional. As letras presentes ao lado de Data indicam qual o formato
que ela irá adotar:
d: Dia; m: Mês; y: Ano; H: Hora; m: Minuto;
Quando as letras aparecem mais de uma vez, a formatação irá forçar com que zeros
estejam presentes quando o número não alcançar a quantidade de letras. Ex: dia 2 de outubro de
2010, para a máscara dd/mm, será formatado como 02/10.
52
Visualizando o modelo de exemplo
Figura 33: Modelo de exemplo
Esta tela apresenta uma funcionalidade que permite ao usuário verificar como será gerada
a nomenclatura do arquivo.
Ao clicar sobre o botão Ver Exemplo, o programa irá gerar sobre o campo Exemplo o
nome que aquele leiaute irá produzir após gerar uma remessa. Importante ressaltar que antes de
visualizar o exemplo, deve-se salvar qualquer alteração pendente na tela, pois do contrário, será
mostrado o exemplo para a forma antiga.
6.2.2. Leiaute de Arquivo de Remessa
O cadastro de Leiaute de Arquivo de Remessa tem por objetivo deixar os arquivos de
remessa em padrão CNAB oferecido pelos bancos, para efetuar os pagamentos ou recebimentos
eletrônicos. Cada leiaute de arquivo de remessa tem suas próprias particularidades dependendo,
lógico, do banco em questão, mas todos sem exceções utilizam-no como base, o padrão
Febraban (Federação Brasileira de Bancos). O cadastro de arquivo de leiaute de remessa
encontra-se disponível acessando os seguintes módulos: Módulos | Administração |
Configurações | Banco | BankSync | Leiaute de Arquivo de Remessa,
6.2.2.1. Definição do Leiaute
A definição de leiaute de arquivo de remessa nos serve como um esqueleto de nosso
arquivo .txt, que será gerado na exportação de arquivo de remessa, ele irá ser gerado
exatamente na estrutura definida, na definição do leiaute. Verificamos um exemplo
acompanhando a Figura 34, que ilustra a estrutura de um arquivo de remessa e analisaremos o
que significa para cada tipo de campo mostrado nesta tela:
53
Figura 34: Leiaute de arquivo de remessa
Os campos que serão descritos abaixo, são referentes à tela de leiaute de arquivo de
remessa, parte de definição do leiaute e como devem ser seus respectivos preenchimentos:
Código – Code
Um código único para este cadastro.
Nome – Name
Nome dado para o leiaute.
Tipo de Doc. - U_PayType
Para qual tipo de transação esse leiaute, será para Contas a Pagar ou Contas a Receber.
54
Nomenclatura - U_Filename
Campo que vincula o leiaute de nomenclatura com o leiaute de remessa em questão.
Aceita Caracteres Diacríticos - U_Diacriti
Permite que ao gerar os arquivos de remessa, possam sair no mesmo, caracteres como ( ,
’ . ” ^ ~ ) dentre outros.
Maiúsculas - U_IsUpper
Faz com que toda a vez que for gerada uma remessa, todos os campos alfanuméricos
saiam com suas letras no formato maiúsculas.
Com Nova Linha - U_HasNewLn
Ao gerar o arquivo de remessa ele sempre irá adicionar ao final do arquivo .txt, uma nova
linha em branco6, apenas para finalizar o arquivo.
Descrição - U_Descript
Informada à descrição que terá aquela linha específica do arquivo de remessa, na maioria
dos casos, podendo ser um Cabeçalho, Detalhes ou Rodapé de arquivo.
Ativo - U_Actived
Sempre que este campo estiver marcado, aquela linha do leiaute de arquivo de remessa
estará ativa, ou seja, o BankSync irá verificar se existem dados para esta linha, caso tenha, esta
linha sairá no arquivo de remessa, caso não o BankSync desconsidera essa linha e parte para a
linha seguinte.
Requerido - U_Required
Sempre que este campo estiver marcado, o BankSync entenderá que está linha de arquivo
é obrigatória, e sempre irá sair no arquivo de remessa.
Tipo de Dados – DataType
6 É de grande importância para a maioria dos bancos finalizar com uma linha em branco o arquivo .txt, pois o site do banco identifica que o arquivo
não foi finalizado caso ele não tenha uma linha em branco;
55
Irá identificar o que esta linha será no arquivo de remessa, as opções para definição de
tipos de dados são estas:
Cabeçalho de Arquivo
Cabeçalho de Título
Todos os Títulos
Títulos do Próprio Banco
Títulos do Próprio Banco - Registrados
Títulos do Próprio Banco - Não Registrados
Títulos de Outros Bancos
Rodapé de Título
Cabeçalho de Transferência
Cabeçalho de Transferência - Próprio Banco
Cabeçalho de Transferência - Outros Bancos
Rodapé de Transferência
Rodapé de Arquivo
Herdar do Nível Anterior
Nível - U_Level
O nível irá definir ao sistema a ordem de impressão dos arquivos de remessa, lembrando
sempre que dados como cabeçalho e rodapé, sempre tem de ser do mesmo nível.
Segue abaixo na Tabela 3, um exemplo simples de nivelamento dos arquivos de remessa,
contado que temos um registro de cabeçalho, um registro de detalhe e um registro de rodapé:
Tabela 3: Nivelamento do arquivo de remessa
56
Tamanho - U_Size
O campo irá definir o tamanho do arquivo de remessa, ou seja, se for um CNAB 400, o
tamanho deste campo deve ser 400. Neste caso cada linha do arquivo remessa irá sair com 400
caracteres, caso seja CNAB 240 o tamanho do campo deve ser 240, e cada linha do arquivo de
remessa terá 240 caracteres.
6.2.2.2. Definição do Registro
Utilizando o botão Definição do Registro ou clicando duas vezes sobre ele, irá abrir a tela
de definição de registro. Após informar todo o conteúdo referente à definição do leiaute, serão
informadas as linhas do arquivo, ou seja, todos os dados que a linha em questão irá conter,
conforme a Figura 35.
Figura 35 Tela de Definição de Registro
57
Registro – Name
Essa linha contém a mesma informação que foi dada na tela de Definição de Leiaute, ele
somente replica esse nome para a tela de Definição de Registros.
Descrição - U_Name
Informará à descrição que terá o campo, referente à linha do arquivo de remessa em
questão, ou seja, o que este campo significa.
OBS: a descrição dos campos independente do nível (Cabeçalho, Detalhe e Rodapé), é
baseada no Manual do Banco que está sendo utilizado para configurar esse leiaute de remessa.
O Manual do Banco disponibiliza TODAS as informações para a correta configuração do leiaute
de remessa.
Posição - U_Position
Este campo é um auto contador, ele se ajusta conforme a quantidade de caracteres do
campo anterior, somando assim automaticamente. Iniciando sempre da posição um, o tamanho
máximo permitido é baseado no campo Tamanho da tela de Definição de Leiaute, ou seja, o
contador vai acusar erro caso a posição do ultimo campo, somado a quantidade do próximo
campo, for maior que o valor final definido no campo Tamanho.
Qtde - U_Size
Será definida aqui a quantidade de caracteres que terá o seu campo em questão.
Tipo - U_Type
O BankSync possibilita 4 tipos de campos em um combobox chamado Tipo, os campos
podem ser dos seguintes tipos:
0 - Texto Fixo: Quando o campo for do tipo texto fixo, será informado um valor
dentro dele que será sempre o mesmo, como a própria configuração informa, FIXO.
1 - Data Base: Um campo data base é um tipo de campo que permite ao usuário
buscar dados de campos do SBO, como por exemplo: Nome do PN, Endereço do PN,
dentre outros campos.
58
2 – Categoria: Este tipo de campo nos possibilita criar mais de uma condição para
um único campo, por exemplo, quando vier um número “0” eu gostaria que este campo me
trouxesse o Nome do PN, caso venha “1” gostaria que retornasse o Nome do Cedente, ou
seja, em um único campo o usuário poderá possuir dois tipos de retorno.
3 - SQL Select: O BankSync possibilita ao usuário informar uma consulta SQL
Select para que retorne o valor desejado. Alguns campos do Business One não tem opção
em nosso tipo de campo Data Base. Sendo assim o usuário pode utilizar o tipo de campo
SQL Select para retornar os dados que ele deseja de uma tabela especifica do Business
One.
6.2.2.3. Definição do Campo
Na Definição do Campo, o usuário informa o formato deste campo, o alinhamento e o
preenchimento do mesmo, além de sua posição e suas propriedades específicas.
Texto Fixo
Para a definição de um campo Texto Fixo, é necessário realizar algumas configurações,
(Figura 36), que serão abordadas abaixo:
59
Figura 36: Definição do campo texto fixo
Campo – Name
O nome que sempre virá neste campo é o mesmo nome que o usuário já definiu no campo
Descrição, na tela de Definição de Registro.
Propriedades Gerais
Tipo - U_Type
O tipo de documento será sempre o mesmo que estiver no campo Tipo da tela de
Definição de Registro.
Formato - U_Format
0 - Livre
1 - Alfabético
60
2 - Alfanumérico
3 - Numérico
4 - 2 Decimais
5 - 5 Decimais
6 - Data (aaaammdd)
7 - Data (ddmmaa)
8 - Hora (ddmmaaaa)
Alinhamento - U_Align
(0) - Esquerda
(1) - Direita
Preenchimento - U_Filling
(*) - Zero
(0) - Espaço
(_) - Underscore
(-) - Hifen
OBS: quando o campo for de formato Numérico, Decimal 2 ou Decimal 5, o seu
alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato
Alfanumérico, Alfabético ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda +
Espaço.
Posição - U_Pos / Tamanho - U_Siz
Digamos que o usuário tenha um campo de 44 posições, por exemplo, um código de
barras, e ele gostaria de pegar apenas os “3” primeiros dígitos desse código de barras, que seria
o número do banco. Dessa forma o usuário deve preencher o campo Posição, com a posição em
que ele se encontra, que neste caso a posição “1” (os três primeiros dígitos do código de barras),
e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso “3”. A
configuração irá ficar conforme a Figura 37.
61
Figura 37: Configuração da posição para código de barras
Propriedades Específicas
Texto Fixo - U_Text
No campo Texto Fixo, o usuário deve preencher com os caracteres que ele sempre
deseja que saia em seu arquivo de remessa, pois como o próprio campo diz Fixo, ou seja,
sempre sairá com os caracteres que estiverem preenchidos neste campo.
Database
Para a definição de um campo Database, é necessário realizar algumas configurações,
(Figura 38), que serão abordadas abaixo:
62
Figura 38 Definição do campo database
Campo – Name
O nome que sempre virá neste campo é o mesmo nome que o usuário já definiu no campo
Descrição, na tela de Definição de Registro.
Propriedades Gerais
Tipo - U_Type
O tipo de documento será sempre o mesmo que estiver no campo Tipo da tela de
Definição de Registro.
63
Formato - U_Format
0 - Livre
1 - Alfabético
2 - Alfanumérico
3 - Numérico
4 - 2 Decimais
5 - 5 Decimais
6 - Data (aaaammdd)
7 - Data (ddmmaa)
8 - Hora (ddmmaaaa)
Alinhamento - U_Align
(0) - Esquerda
(1) - Direita
Preenchimento - U_Filling
(*) - Zero
(0) - Espaço
(_) - Underscore
(-) - Hifen
OBS: quando o campo for de formato Numérico, Decimal 2 ou Decimal 5, o seu
alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato
Alfanumérico, Alfabético ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda +
Espaço.
Posição - U_Pos / Tamanho - U_Siz
Digamos que o usuário tenha um campo de 44 posições, por exemplo, um código de
barras, e ele gostaria de pegar apenas os “3” primeiros dígitos desse código de barras, que seria
o número do banco. Dessa forma o usuário deve preencher o campo Posição, com a posição em
que ele se encontra, que neste caso a posição “1” (os três primeiros dígitos do código de barras),
64
e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso “3”. A
configuração irá ficar conforme a Figura 39.
Figura 39: Configuração da posição para código de barras
Propriedades Específicas
Base de Dados - U_Database
Este campo deverá conter sempre a base de dados que o cliente deseja que o add-on
busque nas tabelas do Business One, como por exemplo: Nome do PN, Endereço do PN, dentre
outros campos de tabelas do Business One que temos disponíveis como bases de dados (data
base).
Categoria
Para a definição de um campo Categoria, é necessário realizar algumas configurações,
(Figura 40), que serão abordadas abaixo:
65
Figura 40: Definição do campo categoria
Campo – Name
O nome que sempre virá neste campo é o mesmo nome que o usuário já definiu no campo
Descrição, na tela de Definição de Registro.
Propriedades Gerais
Tipo - U_Type
O tipo de documento será sempre o mesmo que estiver no campo Tipo da tela de
Definição de Registro.
Formato - U_Format
0 - Livre
1 - Alfabético
66
2 - Alfanumérico
3 - Numérico
4 - 2 Decimais
5 - 5 Decimais
6 - Data (aaaammdd)
7 - Data (ddmmaa)
8 - Hora (ddmmaaaa)
Alinhamento - U_Align
(0) - Esquerda
(1) - Direita
Preenchimento - U_Filling
(*) - Zero
(0) - Espaço
(_) - Underscore
(-) - Hifen
OBS: quando o campo for de formato Numérico, Decimal 2, Decimal 5, o seu
alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato
Alfanumérico, Alfabético ou Livre o seu alinhamento e preenchimento devem ser: Esquerda +
Espaço.
Posição - U_Pos / Tamanho - U_Siz
Digamos que o usuário tenha um campo de 44 posições, por exemplo, um código de
barras, e ele gostaria de pegar apenas os “3” primeiros dígitos desse código de barras, que seria
o número do banco. Dessa forma o usuário deve preencher o campo Posição, com a posição em
que ele se encontra, que neste caso a posição “1” (os três primeiros dígitos do código de barras),
e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso “3”. A
configuração irá ficar conforme a Figura 41.
67
Figura 41: Configuração da posição para código de barras
Propriedades Específicas
Tipo de Retorno: U_RetType
0 – Texto Fixo
1 – Base de Dados
Valor Padrão - U_Text
A informação configurada nesse campo será utilizada quando nenhumas das condições
presentes na grade forem verdadeiras.
Grade de Dados
Condição - U_CondOp
Este campo sempre vai estar preenchido com a condição que o usuário deseja que o add-
on faça, como por exemplo:
0 - Menor que ou igual a
1 - Menor que
2 - Igual a
3 - Diferente de
4 - Maior que
5 - Maior que ou igual a
68
Valor - U_CondVal
O campo valor sempre vai conter o valor para o add-on efetuar a condição, como por
exemplo: digamos que a condição selecionada seja 0 – Menor que ou igual a, e no campo
Valor, para que o add-on efetue essa condição, o usuário coloque “5”, então o sistema vai
sempre verificar a condição Menor que ou igual a “5”, conforme a Figura 42.
Figura 42: Configuração da coluna condição e valor
Texto Fixo - U_Text
Quando preenchido o campo texto fixo, ele fará a condição e retornará sempre o valor que
estiver fixo neste campo.
Base de Dados - U_Database
Quando preenchido com uma base de dados ele retornará sempre a base de dados
informada pelo usuário.
SQL Select
Para a definição de um campo SQL Select, é necessário realizar algumas configurações,
(Figura 43), que serão abordadas abaixo:
69
Figura 43: Definição do campo SQL Select
Campo – Name
O nome que sempre virá neste campo é o mesmo nome que o usuário já definiu no campo
Descrição, na tela de Definição de Registro.
Propriedades Gerais
Tipo - U_Type
O tipo de documento será sempre o mesmo que estiver no campo Tipo da tela de
Definição de Registro.
Formato - U_Format
0 - Livre
70
1 - Alfabético
2 - Alfanumérico
3 - Numérico
4 - 2 Decimais
5 - 5 Decimais
6 - Data (aaaammdd)
7 - Data (ddmmaa)
8 - Hora (ddmmaaaa)
Alinhamento - U_Align
(0) - Esquerda
(1) - Direita
Preenchimento - U_Filling
(*) - Zero
(0) - Espaço
(_) - Underscore
(-) - Hifen
OBS: quando o campo for de formato Numérico, Decimal 2 ou Decimal 5, o seu
alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato
Alfanumérico, Alfabético ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda +
Espaço.
Posição - U_Pos / Tamanho - U_Siz
Digamos que o usuário tenha um campo de 44 posições, por exemplo, um código de
barras, e ele gostaria de pegar apenas os “3” primeiros dígitos desse código de barras, que seria
o número do banco. Dessa forma o usuário deve preencher o campo Posição, com a posição em
que ele se encontra, que neste caso a posição “1” (os três primeiros dígitos do código de barras),
e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso “3”. A
configuração irá ficar conforme a Figura 44.
71
Figura 44: Configuração da posição para código de barras
SQL Select
Select - U_Select
Neste campo deve conter a consulta SQL que o usuário deseja utilizar, lembrando que o
usuário deve colocar a consulta sem a palavra Select, pois está palavra já está implementada no
próprio campo, veja o exemplo abaixo:
Consulta SQL Normal
Select OBOE.OurNum From OBOE Where OBOE.BoeNum = %BoeNum%
Como tem de ser preenchido o SQL no campo Select do BankSync
OBOE.OurNum From OBOE Where OBOE.BoeNum = %BoeNum%
6.2.3. Leiaute de Arquivo de Retorno
O cadastro de Leiaute de Arquivo de Retorno tem por objetivo buscar os dados que
estão contidos dentro do arquivo de retorno, e retornar estes ao sistema, para que sejam assim
importados e efetuados os pagamentos ou recebimentos dos documentos que já foram enviados
ao banco.
Os leiautes de arquivo de retorno (Figura 45) contêm algumas abas para cadastro que
serão explicadas posteriormente.
Para cadastrar um Leiaute de Arquivo de Retorno, basta acessar os seguintes módulos:
Módulos | Administração | Configurações | Banco | BankSync | Leiaute de Arquivo de Retorno,
72
Figura 45: Leiaute de Arquivo de Retorno
Os campos que serão descritos abaixo, são referentes à tela de leiaute de arquivo de
retorno parte fixa. Após descrevermos estes, vamos analisar os campos que estão contidos em
suas respectivas abas (Identificação, Ocorrências, Erros, Validação).
Código – Code
Um código único para este cadastro.
Nome – Name
Nome dado para o leiaute.
Tipo de Doc. - U_PayType
Para qual tipo de transação esse leiaute será: Contas a Pagar, Contas a Receber ou DDA.
73
6.2.3.1. Identificação
Número de Linhas de um Título - U_LineCnt
Informar neste campo o número de linhas de títulos que possuem o seu arquivo de retorno.
Muitas vezes os bancos colocam alguns dos valores dos títulos ou datas, na segunda linha do
título. Caso a quantidade informada for “1”, o add-on irá capturar valores diferentes do desejado,
pois estará procurando na linha incorreta.
Cabeçalho
Identificação - U_HeadVl
Informamos neste campo qual a identificação que define o cabeçalho de nosso arquivo de
retorno.
Posição - U_HeadPs
Cadastramos neste campo a posição desta identificação.
Tamanho - U_HeadSz
Neste campo informamos o tamanho desta identificação. Para melhor visualizar, segue
abaixo um exemplo de cadastro (Figura 46).
Figura 46: Leiaute de arquivo de retorno, Cabeçalho
74
Figura 47: Arquivo de retorno
Sabendo que a primeira posição da primeira linha é composta por “0”, automaticamente o
BankSync irá identificar isso como sendo o Cabeçalho do Arquivo de Retorno (Figura 47).
Título
Identificação - U_IdValue
Informamos neste campo qual a identificação que define os títulos de nosso arquivo de
retorno.
Posição - U_IdPos
Cadastramos neste campo a posição desta identificação.
Tamanho - U_IdSiz
Neste campo informamos o tamanho desta identificação. Para melhor visualizar, segue
abaixo um exemplo de cadastro (Figura 48).
Figura 48: Leiaute de arquivo de retorno Título
75
Figura 49: Arquivo de retorno
Sabendo que a primeira posição da segunda linha é composta por “1”, automaticamente o
BankSync irá identificar isso como sendo um título de seu arquivo de retorno (Figura 49), ou seja,
cada vez que conter o número “1” na primeira posição da linha, será mais um título para o add-on
identificar.
Identificação do Documento
Posição - U_BoEKPos
O BankSync permite ao usuário cadastrar na tela de Detalhes da Empresa, Módulos |
Administração | Inicialização do Sistema | Detalhes da Empresa, o campo Chave Única da
Empresa (Figura 50), ao gerar o arquivo de remessa. Temos um campo que configuramos para
utilizar esta informação, cujo valor é um database chamado Boleto - Chave Única, composto por
Chave Única da Empresa + OBOE.BoeKey. É baseado neste dado, que sai na remessa e
também vem no arquivo de retorno (Figura 52), que o BankSync irá identificar o título dentro do
Business One, bastando neste campo informar qual a posição que ele começa. Para melhor
visualizar veja o exemplo de cadastro abaixo (Figura 51).
Tamanho - U_BoEKSiz
Informar o tamanho desta identificação do documento, ou seja, quantos caracteres ele irá
possuir.
Linha - U_BoEKLin
Em qual linha do título esta identificação se encontra.
76
Figura 50: Detalhes da empresa Identificação da Empresa
Figura 51: Leiaute de arquivo de retorno Identificação do Documento
Figura 52: Arquivo de retorno chave única
Na hora da importação do arquivo de retorno o BankSync efetua a seguinte verificação,
partindo da posição 38, conta 25 caracteres, na linha informada, e avalia se o documento em
questão realmente consta em sua base do Business One.
Identificação Alternativa do Boleto
A primeira verificação que o BankSync faz é a identificação do documento. Caso esta
identificação não funcione por algum motivo de configuração, o BankSync passa para outro tipo
de identificação, a Identificação Alternativa, que utiliza quatro campos para se identificar;
Portfólio, Nosso Número, Dígito Verificador do Nosso Número e Número da Nota Fiscal (Serial).
Para o BankSync identificar qualquer documento, pela identificação especial, todas as
informações devem vir de maneira correta, ou seja, caso alguma das informações não baterem
com os dados reais deste título, o add-on automaticamente desconsiderará esta identificação e
passará para a Identificação Especial que será vista no próximo tópico deste manual.
77
Caso então o usuário já saiba que, por exemplo, o Nosso Número e o Dígito Verificador
estão incorretos em seu arquivo de retorno, o próprio usuário deve preencher tais campos com
“0” na posição, “0” no tamanho e “0” na linha, assim o add-on irá buscar apenas os campos
configurados, e desta forma a Identificação Alternativa funcionará. Veja o exemplo abaixo
(Figura 53).
Figura 53: Leiaute de arquivo de retorno Identificação Alternativa
Portfólio
Posição - U_PortPos
Deve ser preenchida a posição de início do número do portfólio.
Tamanho - U_PortSiz
Informar o tamanho do portfólio.
Linha - U_PortLin
Cadastrar em qual linha os caracteres se encontra.
Nosso Número
Posição - U_OurNmPos
Deve ser preenchida a posição de início do nosso número.
78
Tamanho - U_OurNmSiz
Informar o tamanho do nosso número.
Linha - U_OurNmLin
Cadastrar em qual linha os caracteres se encontra.
Dígito
Posição - U_ONmCkPos
Deve ser preenchida a posição de início do dígito verificador do nosso número.
Tamanho - U_ONmCkSiz
Informar o tamanho do dígito verificador do nosso número.
Linha - U_ONmCkLin
Cadastrar em qual linha os caracteres se encontra.
Número da Nota Fiscal
Posição - U_SerialP
Deve ser preenchida a posição de início do dígito verificador do nosso número.
Tamanho - U_SerialS
Informar o tamanho do dígito verificador do nosso número.
Linha - U_SerialL
Cadastrar em qual linha os caracteres se encontra.
79
Identificação Especial
A identificação especial é a última tentativa feita pelo add-on para identificar o título em
questão. Ele baseia-se em apenas um dado que o usuário poderá escolher, bastando configurar o
campo Tabela e escolher o Campo que você quer utilizar de acordo com a informação que você
busca. Segue exemplo de cadastro deste campo Identificação Especial (Figura 54).
Figura 54: Identificação Especial
Tabela - U_SpecTbl
Informar a tabela na qual o usuário deseja fazer a identificação especial.
OBOE - Boletos
OPYM - Forma de Pagamento
OPTF - Portfólio
@SIEBS_BOEC - BankSync: Controle de Boletos
OINV - Nota Fiscal de Saída
RCT2 - Notas Fiscais de Contas a Receber
Campo - U_SpecFld
Após selecionar a tabela desejada, o campo Campo irá trazer todos os campos
disponíveis desta tabela para utilização do usuário, bastando o mesmo escolher o campo
desejado.
Formato - U_SpecFor
Escolher o formato referente ao campo escolhido no campo Campo.
0 - Alfanumérico
80
1 - Numérico
Posição - U_SpecPos
Deve ser preenchida a posição de início do campo em questão.
Tamanho - U_SpecSiz
Informar o tamanho do campo em questão.
Linha - U_SpecLin
Cadastrar em qual linha os caracteres se encontram.
6.2.3.2. Ocorrências
Em seu arquivo de retorno, o banco envia uma ocorrência, essa nada mais é do que uma
informação do acontecimento, que ocorreu com seu documento dentro do banco, se ele foi pago,
depositado, rejeitado, dentre outras opções (Figura 55).
81
Figura 55: Leiaute de arquivo de retorno - Ocorrências
Posição - U_IdOcoPos
Deve ser preenchida a posição de início do campo ocorrência.
Tamanho - U_IdOcoSiz
Informar o tamanho do campo ocorrência.
Linha - IdOcoLin
Cadastrar em qual linha os caracteres se encontram.
Entrada Normal - U_IdOkVal
Deve ser informado o valor que o banco estipulou em seu manual, para conhecimento de
quando o arquivo simplesmente deu entrada no banco, ou quando ele foi depositado.
82
Liquidação - U_IdPayVal
Deve ser informado o valor que o banco estipulou em seu manual, para quando o arquivo
foi liquidado, ou seja, Pago.
Identificação de Ocorrências
O banco informa em seu manual, várias ocorrências que tem de ser cadastradas na grid de
Identificação de Ocorrências, note abaixo um exemplo de uma lista de ocorrências de um
banco qualquer (Figura 56).
Figura 56: Códigos de Ocorrências
Código - U_IdOcor
Código informado neste campo tem de ser o mesmo código que informa o manual do
banco, como mostra o exemplo da figura acima (Figura 56).
Descrição - U_DescOcor
Descrição informada neste campo tem de ser a mesma descrição que informa o manual do
banco.
Ação - U_Action
Após cadastrar o código da ocorrência junto com sua descrição, o usuário pode definir no
campo Ação, uma ação para este documento, ou seja, quando ele vier com a ocorrência XX ele
83
toma a ação de Pagar, por exemplo, assim sendo, sempre que algum documento vir com a
ocorrência XX ele vai para a gaveta de Pago, na administração de boletos.
0 - Nenhuma
1 - Depositar
2 - Pagar
3 - Cancelar
4 - Falhar
5 - Gerado
99 – Customizado
6.2.3.3. Cobrança
Nessa tela é possível efetuar a configuração de cobrança padrão que os títulos irão
apresentar. A Figura 57 referencia a aba Cobrança, possuindo alguns campos para configuração,
que serão vistos a seguir.
Figura 57: Leiaute de arquivo de retorno - Cobrança
84
Posição
Deve ser preenchida a posição de início do campo cobrança.
Tamanho
Informar o tamanho do campo cobrança.
Linha
Cadastrar em qual linha os caracteres se encontram.
Tipo Padrão
Seleciona se os títulos serão importados com o Tipo de Cobrança padrão, tendo as
opções de acordo com a Figura 58.
Figura 58: Tipo de cobrança padrão
Grid
Código
Código informado neste campo tem de ser o mesmo código de Tipo de Cobrança que
informa o manual do banco.
Descrição
Descrição informada neste campo tem de ser a mesma descrição que informa o manual do
banco.
85
Tipo de Cobrança
Definir o Tipo de Cobrança que aquele código irá apresentar de acordo com o manual do
banco.
6.2.3.4. Erros
Algumas vezes o arquivo de remessa enviado ao banco apresenta alguns erros, e estes
são apresentados em seu arquivo de retorno, por meio de ocorrências. O processo é igual ao de
ocorrências de pagamentos, a única diferença é que o erro possui cinco campos para
ocorrências, enquanto a ocorrência de pagamento possui apenas um campo. Segue abaixo um
exemplo da aba de Erros (Figura 59).
Figura 59: Leiaute de arquivo de retorno Erro
Campo
Posição - U_ErFd1Pos
86
Deve ser preenchida a posição de início do campo erro (Essa informação vale para todos
os campos de erro).
Tamanho - U_ErFd1Siz
Informar o tamanho do campo erro (Essa informação vale para todos os campos de erro).
Linha - U_ErFd1Lin
Cadastrar em qual linha os caracteres se encontram (Essa informação vale para todos os
campos de erro).
Grid de Cadastro de Descrição dos Erros
Os dados cadastrados nessa grid são os mesmos que o banco informa em seu manual,
conforme mostra o exemplo abaixo (Figura 60):
Figura 60: Ocorrências de Erros, Manual do Banco
Código - U_IdErr
O Código informado neste campo tem de ser o mesmo código que informa o manual do
banco.
Descrição - U_DescErr
87
Descrição informada neste campo tem de ser a mesma descrição que informa o manual do
banco.
6.2.3.5. Validação Boletos
Na tela de validação (Figura 61), são cadastrados campos onde o BankSync buscará no
arquivo de retorno os dados de seu documento, como: Valor, Datas, Nome, Tarifa Bancária. Após
verificar e buscar tais valores, é efetuado no processo de importação a validação desses valores
para o Business One.
Figura 61: Leiaute de arquivo de retorno Validação
Valor Pago ou Depositado
Este campo vai retornar ao add-on, o valor do pagamento do documento, valor que entrou
no banco.
88
Posição - U_ValPos
Deve ser preenchida a posição de início do valor do pagamento.
Tamanho - U_ValSiz
Informar o tamanho do campo valor pago.
Linha - U_ValLin
Cadastrar em qual linha os caracteres se encontram.
Decimais - U_ValDec
Informar quantas casas decimais o add-on deve considerar.
Tarifa de Cobrança
Posição - TaCPos
Deve ser preenchida a posição de início do valor da tarifa de cobrança.
Tamanho - TaCSiz
Informar o tamanho do campo tarifa de cobrança.
Linha - TaCLin
Cadastrar em qual linha os caracteres se encontram.
Decimais - TaCDec
Informar quantas casas decimais o add-on deve considerar.
Momento da Tarifa - U_TaxMomen
A tarifa bancária pode vir no arquivo de remessa em duas situações: na hora que o
documento foi pago ou na hora que ele deu entrada no banco. O campo Momento da Tarifa
identifica exatamente isso, em qual desses momentos o usuário vai programar o add-on para
identificar a tarifa bancária.
0 – Pago
1 – Depositado
Destacada - U_TaxDest
Quando o checkbox Destacada estiver ativo, o BankSync irá entender que o valor da tarifa
já esta adicionado ao valor do documento, ou seja, se o banco informa que a tarifa é fixa de R$
89
1,50 por documento e o documento do usuário é de R$ 10,00, o valor do boleto seria de R$ 11,50
pois a tarifa já estava destacada, ou seja, inclusa no valor do documento.
Nome
Posição - U_NamePos
Deve ser preenchida a posição de início do Nome do Sacado.
Tamanho - U_NameSiz
Informar o tamanho do campo nome.
Linha - U_NameLin
Cadastrar em qual linha os caracteres se encontram.
Tipo de Transação
Posição - U_PstTpPos
Deve ser preenchida a posição de início do tipo de transação.
OBS: campo não obrigatório, apenas para consultas para diferenciar documentos;
Tamanho - U_PstTpSiz
Informar o tamanho do campo tipo de transação.
Linha - U_PstTpLin
Cadastrar em qual linha os caracteres se encontram.
Data de Transação
Posição - U_DtProPos
Deve ser preenchida a posição de início da data de transação.
Tamanho - U_DtProSiz
O tamanho é preenchido automaticamente, juntamente com a escolha do formato da
data.
Linha - U_DtProLin
90
Cadastrar em qual linha os caracteres se encontram.
Formato - U_DtProFor
Escolher um formato de data que o manual do banco especificar como padrão para
suas datas.
o 0 - ddmmaaaa
o 1 - mmddaaaa
o 2 - aaaammdd
o 3 - ddmmaa
o 4 - aammdd
OBS: vale salientar: dd = dia , mm = mês , aaaa = ano;
Local - U_HeadTtl
Escolher o local do arquivo de retorno que o BankSync deve considerar a data de
lançamento, se é do título, ou seja, do documento, ou se é do cabeçalho (Header).
o 0 - Título
o 1 - Header.
6.2.3.6. Validação DDA
Para trabalhar com o DDA o tipo de validação que o BankSync faz é um pouco diferente,
ele utiliza campos exclusivos para importação de arquivos DDA, como vamos ver no exemplo
abaixo (Figura 62).
91
Figura 62: Leiaute de retorno Validação DDA
Valor do Boleto
Este campo vai retornar ao add-on o valor do pagamento do documento.
Posição - U_ValPos
Deve ser preenchida a posição de início do valor do pagamento.
Tamanho - U_ValSiz
Informar o tamanho do campo valor pago.
Linha - U_ValLin
Cadastrar em qual linha os caracteres se encontram.
Nome
Posição - U_NamePos
Deve ser preenchida a posição de início do Nome.
Tamanho - U_NameSiz
92
Informar o tamanho do campo Nome.
Linha - U_NameLin
Cadastrar em qual linha os caracteres se encontram.
Data de Lançamento
Posição - U_DtProPos
Deve ser preenchida a posição de início da data de lançamento.
Tamanho - U_DtProSiz
O tamanho é preenchido automaticamente, juntamente com a escolha do formato da
data.
Linha - U_DtProLin
Cadastrar em qual linha os caracteres se encontra.
Formato - U_DtProFor
Escolher um formato de data que o manual do banco especificar como padrão para
suas datas.
o 0– ddmmaaaa
o 1- mmddaaaa
o 2- aaaammdd
o 3- ddmmaa
o 4– aammdd
OBS: vale salientar: dd = dia , mm = mês , aaaa = ano;
CPF/CNPJ
Posição - U_CpfPos
Deve ser preenchida a posição de início do CNPJ ou CPF.
Tamanho - U_CpfSize
Informar o tamanho do campo valor pago. Vale lembrar que os dados destes
campos não contêm caracteres diacríticos, como – ou /, sendo assim, o tamanho
deste campo deve ser apenas a quantidade de caracteres numéricos.
Linha - U_CpfLine
93
Cadastrar em qual linha os caracteres se encontram.
Data de Vencimento
Posição - U_DtMatPos
Deve ser preenchida a posição de início da data de vencimento.
Tamanho - U_DtMatSiz
O tamanho é preenchido automaticamente, juntamente com a escolha do formato da
data.
Linha - U_DtMatLin
Cadastrar em qual linha os caracteres se encontram.
Formato - U_DtMatFor
Escolher um formato de data que o manual do banco especificar como padrão para
suas datas.
o 0– ddmmaaaa
o 1- mmddaaaa
o 2- aaaammdd
o 3- ddmmaa
o 4– aammdd
OBS: vale salientar: dd = dia , mm = mês , aaaa = ano;
Código de barras
Posição - U_BCodPos
Deve ser preenchida a posição de início do Código de Barras.
Tamanho - U_BCodSiz
Informar o tamanho do campo Código de Barras.
Linha - U_BCodLin
Cadastrar em qual linha os caracteres se encontram.
Data de Pagamento
Posição - U_DtPayPos
94
Deve ser preenchida a posição de início da data de pagamento.
Tamanho - U_DtPaySiz
O tamanho é preenchido automaticamente, juntamente com a escolha do formato da
data.
Linha - U_DtPayLin
Cadastrar em qual linha os caracteres se encontram.
Formato - U_DtPayFor
Escolher um formato de data que o manual do banco especificar como padrão para
suas datas.
o 0– ddmmaaaa
o 1- mmddaaaa
o 2- aaaammdd
o 3- ddmmaa
o 4– aammdd
OBS: vale salientar: dd = dia , mm = mês , aaaa = ano;
Status do Boleto sugerido - U_BoeStats
Quando o usuário importa o arquivo de DDA, pode ser escolhido o tipo de operação que o
usuário deseja configurar seu Contas a Pagar, para que os documentos mudem diretamente para
a gaveta de Pago na tela de administração de boletos, ou que o documento continue na gaveta
de Gerado. Para isso basta escolher uma destas opções do combobox Status do Boleto
Sugerido.
0 - Gerado
1 – Pago
6.2.4. Leiaute de Extrato Bancário (CNAB)
Sempre que efetuamos uma movimentação em nossa conta bancária, ao final das
transações podemos tirar um extrato de quais movimentações foram efetuadas. O extrato
bancário CNAB faz exatamente isso, só que em um padrão CNAB, que permite ao usuário
importar este arquivo por meio do BankSync e assim fazer suas reconciliações dos documentos.
Para acessar a tela de cadastro de leiaute de extrato CNAB (Figura 63) base acessar os
95
seguintes módulos: Módulos | Administração | Configurações | Banco | BankSync | Leiaute de
Extrato Bancário (CNAB).
Figura 63: Leiaute de arquivo de extrato CNAB
Código – Code
Um código único para este cadastro.
Nome – Name
Nome dado para o leiaute.
96
6.2.4.1. Identificação
Registro
Identificação - U_RegIdent
No campo identificação temos de descrever, o que em nosso arquivo de extrato CNAB,
será linhas de documentos ou de transações. O manual do banco sempre nos traz essa
informação, para melhor visualização segue o exemplo abaixo (Figura 64):
Figura 64 Leiaute de extrato bancário CNAB Registro / Identificação
Figura 65: Extrato bancário CNAB
Neste caso sempre que informar “E” na posição “14” com tamanho “1”, o BankSync irá
identificar isso como uma linha de transação (Figura 65).
Posição - U_RegPos
Deve ser preenchida a posição de início da Identificação.
Tamanho - U_RegSiz
Informar o tamanho do campo Identificação.
97
Banco
Cód. Banco
O código do banco sempre é formado por “3” caracteres numéricos, desta forma deve ser
preenchido os campos, posição e tamanho do código do banco.
OBS: neste caso o BankSync irá procurar em seu arquivo de retorno CNAB, primeiro a
identificação, como vimos no exemplo anterior ‘E’ na posição 14 e irá identificar que essa linha é
uma transação. Após isso ele irá procurar os caracteres que se encontram na posição e tamanho
para retornar ao add-on, ou seja, retornar o código do banco.
Posição - U_BkCodPos
Deve ser preenchida a posição de início do Código do Banco.
Tamanho - U_BkCodSiz
Informar o tamanho do campo Código do Banco.
Nº da Conta
O número da conta sempre é formado por caracteres numéricos, desta forma devem ser
preenchidos os campos posição e tamanho da conta.
Posição - BkAcNPos
Deve ser preenchida a posição de início do Número da Conta.
Tamanho - BkAcNSiz
Informar o tamanho do campo Número da Conta.
Lançamento
Data
Posição - U_LnDtePos
Deve ser preenchida a posição de início da data.
98
Tamanho - U_LnDteSiz
O tamanho é preenchido automaticamente, juntamente com a escolha do formato da
data.
Formato - U_LnDteFmt
Escolher um formato de data, que o manual do banco especificar como padrão para
suas datas.
o 0 - dd/mm/aaaa
o 1 - ddmmaaaa
o 2 - mm/dd/aaaa
o 3 - mmddaaaa
o 4 - aaaa/mm/dd
o 5 - aaaammdd
o 6 - ddmmaa
Referência
Posição - U_LnRefPos
Deve ser preenchida a posição de início de referência.
Tamanho - U_LnRefSiz
Informar o tamanho do campo referência.
Formato - U_LnRefFmt
Escolher um formato do campo referência.
o 0 - Texto
Detalhes
Posição - U_LnDetPos
Deve ser preenchida a posição de início de detalhes.
Tamanho - U_LnDetSiz
Informar o tamanho do campo detalhes.
Formato - U_LnDetFmt
Escolher um formato do campo detalhes.
99
o 0 – Texto
Valor
Posição - U_LnVlrPos
Deve ser preenchida a posição de início do valor.
Tamanho - U_LnVlrSiz
Informar o tamanho do campo valor.
Formato - U_LnVlrFmt
Escolher um formato do campo valor (Figura 66).
Figura 66: Formato de valor
Tipo Lançamento
Posição - U_LnTypPos
Deve ser preenchida a posição de início do tipo de lançamento.
Tamanho - U_LnTypSiz
Informar o tamanho do campo tipo de lançamento.
Formato - U_LnTypFmt
Escolher um formato do campo tipo de lançamento (Figura 67).
Figura 67: Formato do tipo de lançamento
100
Nº Documento
Posição - U_LnDcNPos
Deve ser preenchida a posição de início do número do documento.
Tamanho - U_LnDcNSiz
Informar o tamanho do campo número do documento.
Formato - U_LnDcNFmt
Escolher um formato do campo número do documento.
o 0 – Texto
Código Externo
Posição - U_LnExCPos
Preencher a posição do campo código externo.
Tamanho - U_LnExCSiz
Informar o tamanho do campo código externo.
Formato - U_LnExCFmt
Escolher um formato do campo código externo.
o 0 - Texto
Nº Extrato
Posição - U_LnExNPos
Informar a posição do campo número do extrato.
Tamanho - U_LnExNSiz
Informar o tamanho do campo número do extrato.
Formato - U_LnExNFmt
Escolher um formato do campo número do extrato.
o 0 – Texto
101
6.2.4.2. Serviço
A aba serviço (Figura 68) é bem semelhante a parte de cadastros de ocorrências no leiaute
de arquivo de retorno. Ela identifica um serviço que o próprio usuário cadastra de acordo com o
manual do banco em questão. Cada serviço é formado por um Tipo, Código, Descrição e um
Tipo de transação. Ao verificar a posição e o tamanho deste serviço no arquivo texto de extrato
bancário, o add-on irá efetuar o processo de importação deste extrato.
Figura 68: Tela da aba serviço
Posição - U_SrvPos
Deve ser preenchida a posição de início do serviço.
Tamanho - U_SrvSiz
Informar o tamanho do campo serviço.
Tipos
Tipo - U_LineType
102
O manual do banco informa ao usuário qual o tipo referente ao código do serviço,
ex: 101 - Crédito, 201 – Débito.
o 0 - Crédito
o 1 - Débito
Código - U_TrnsCode
O manual do banco informa ao usuário quais os códigos de serviço que ele deve
cadastrar em sua grade de seleção, como mostra a Figura 69 abaixo:
Figura 69: Cadastro de códigos e descrições para Serviços de extrato bancário
Descrição - U_U_Descript
A descrição também é retirada do manual do banco, conforma mostra o exemplo
acima.
Tipo Transação - U_TrnsType
o 0 - Referência de Pagamento
o 1 - Nota de depósito com nº de referência
o 2 - Doc Num
o 3 - Não tomar nenhuma ação
7. Processos do BankSync
Esta etapa do manual irá descrever, em detalhes, cada uma das etapas envolvidas nos
processos que utilizam o BankSync, dando um enfoque especial as partes que dizem respeito ao
próprio add-on.
103
Primeiramente serão tratados os processos de remessas e em seguida, será apresentado
o processo de geração de boletos de Contas a Pagar com base no Débito Direto Autorizado
(DDA).
7.1. Processo de remessas
O processo de remessas envolve enviar arquivos de texto, com os dados de seus títulos
para o banco, e importar o retorno enviado pelo banco para o seu sistema.
Iniciaremos pela geração de remessas para o banco, detalhando a partir da geração de
uma Nota Fiscal de Saída. Serão apresentadas as particularidades para geração de boletos de
Contas a Pagar, Contas a Receber e transferências de Contas a Pagar.
Na sequência, será demonstrado como deve ser feita a importação de um arquivo de
retorno e como devem ser interpretados os dados apresentados na grade de importação.
Uma vez que tenhamos arquivos de retorno importados no sistema, passaremos para a
parte de reconciliação dos boletos, com base no extrato bancário CNAB.
7.1.1. Criando títulos no SBO
Este tópico explica ao usuário como gerar títulos que podem ser enviados para a remessa.
Ele será breve, pois foge um pouco do foco deste manual, que é explicar as particularidades do
BankSync.
7.1.1.1. Criando uma nota fiscal
Existem diversas maneiras de se criar uma nota fiscal no SBO. Adotaremos aqui a forma
mais simples, onde navegaremos diretamente até sua tela de cadastro e criaremos uma nova
nota.
Iniciamos por uma nota fiscal de saída. Para isto, navegamos até a tela de criação de uma
nota fiscal de saída, que se encontra em Módulos | Vendas | Nota Fiscal de Saída. Ao fazer isto,
veremos uma tela similar à demonstrada na Figura 70.
104
Figura 70: Nota fiscal de saída
Basta agora informar um parceiro de negócio, um item que possua estoque positivo,
escolher o imposto aplicado a ele e clicar sobre o botão Inserir.
Ao final da criação desta nota fiscal, será gerado um LCM, conforme demonstrado em
Figura 71.
Figura 71: LCM da nota fiscal de saída
105
7.1.1.2. Gerando um título
Uma vez que exista um documento no sistema que precise de pagamento, basta navegar
até sua tela respectiva, que seria a de Contas a Receber, para recebimento de uma nota fiscal de
saída ou lançamento de crédito para um fornecedor, ou a de Contas a Pagar, caso seja para o
pagamento de uma nota fiscal de entrada ou um lançamento de débito para um cliente. Após isso
basta selecionar o documento que se deseje dar baixa, escolher o meio de pagamento adotado e
executar a baixa.
Como no exemplo anterior criamos uma nota fiscal de saída, iremos criar agora um Contas
a Receber baseado nela. Para isto, navegue até Módulos | Banco | Contas a Receber | Contas a
Receber. Será exibida a tela demonstrada na Figura 72.
Figura 72: Contas a Receber
106
Informe um parceiro de negócio, que será um cliente neste caso, e selecione o documento
que deseja pagar dentre os que são exibidos na grade da tela. Uma vez escolhido, clique sobre o
ícone da sacola de dinheiro , localizado na barra de ícones de acesso rápido, e uma tela onde
deve ser informado o meio de pagamento irá aparecer, exemplificada na Figura 73.
Figura 73: Tela de meio de pagamento
Escolhemos como meio de pagamento o Boleto. Selecionamos uma das formas de
pagamento disponíveis e informamos seu valor igual ao presente na nota. Note que, para este
exemplo, deixamos o status inicial do boleto como Enviado. Em seguida clicamos sobre o botão
OK para retornarmos a tela anterior. Nela, clicamos sobre o botão Inserir. Agora temos em nosso
sistema um novo boleto de Contas a Receber criado.
Note que não foi criado nenhum lançamento contábil decorrente da criação deste título. Tal
situação ocorreu por causa de duas condições do sistema:
O primeiro se deve ao fato de que o título de Contas a Receber que foi criado ainda está
com seu status em aberto. Isto aconteceu porque, para o SBO, um título pago por boleto só será
encerrado uma vez que o boleto tenha sido Pago e Reconciliado.
107
O segundo motivo para nenhum lançamento ter sido gerado ocorreu por ter criado o boleto
com seu status igual a Enviado. Isso evitou que o SBO gerasse uma transação de troca de status
do boleto, do status Enviado para Gerado, que iria gerar uma movimentação entre as contas do
parceiro de negócio associado ao boleto.
7.1.2. Geração da remessa
O processo de criação de uma remessa, utilizando o BankSync, inicia invocando o
assistente de geração do arquivo de remessa, que se encontra em Módulos | Banco | BankSync |
Exportação de Arquivo de Remessa. Será então demonstrado um assistente que irá guiar o
usuário pelo processo de geração dos arquivos de remessa.
7.1.2.1. Apresentação do assistente
Em geral, os assistentes do BankSync seguem um padrão e a primeira etapa deles será
sempre uma tela de apresentação do assistente (Figura 74). Ela faz uma breve introdução do
processo que será executado, sendo neste caso o de geração do arquivo de remessa para o
banco.
Figura 74: Assistente de exportação - Apresentação
7.1.2.2. Filtros
A próxima etapa possibilita filtrar os boletos que farão parte dos arquivos de remessa.
Nessa tela é possível filtrar os boletos por:
108
Tipo do documento: Informa se serão listados os meios de pagamento (boletos e
transferências) ligados a documentos de Contas a Receber ou Contas a Pagar
(Figura 75). Também define algumas configurações especiais, que estão detalhadas
mais abaixo;
Figura 75: Configuração do tipo de documento
Número do documento: No caso, o número do boleto, campo OBOE.BoeNum;
Datas: Permite filtrar o boleto pela data de lançamento, vencimento, do documento
ou ainda a data em que o boleto foi cancelado. Para que o filtro de data de
cancelamento seja efetuado, a opção de Status do documento deverá ter a
checkbox Cancelado marcada (Figura 76);
Figura 76: Configuração do filtro de data
Parceiros de negócio
Status do documento: Somente deverão aparecer os boletos cujo status forem
iguais a Enviado, Gerado, Cancelado ou Pendente (Figura 77);
Figura 77: Configuração do filtro de status do documento
109
Pagamentos: Somente deverá listar os boletos que estão vinculados a notas fiscais
bloqueadas ou desbloqueadas (Figura 78);
Figura 78: Configuração do filtro de pagamentos
Situação do documento: Permite listar os documentos que ainda não foram
exportados, que já foram exportados, ou ainda ambos;
Figura 79: Configuração do filtro de situação do documento
Forma de Pagamento: Aqui são listadas todas as formas de pagamento disponíveis
para o tipo de documento previamente selecionado (pagar ou receber) (Figura 80).
Note, será gerado um documento para cada forma de pagamento selecionada e
caso nenhuma seja marcada, serão mostrado títulos de todas as formas de
pagamento.
Figura 80: Configuração do filtro de forma de pagamento
Além das opções de filtragem citadas anteriormente, baseado no fato de se estar listando
meios de pagamento para Contas a Receber ou a pagar, esta tela apresenta alguns campos
específicos.
110
No caso de selecionado para Tipo de Documento a opção de Contas a Receber, pode-se
escolher se o tipo de transação será para Cobrança ou então Descontado (Figura 81). Qualquer
que seja a opção, isto não obrigará o boleto a ser pago neste formato. Esta opção existe apenas
para ser utilizada em conjunto com o campo database Leiaute – Tipo de Transação, dos
Leiautes de Arquivo de Remessa.
Figura 81: Configuração do filtro de tipo de transação
Caso a opção do Tipo de Documento seja a de Contas a Pagar, a tela possibilita realizar
a filtragem por banco do boleto, o qual é identificável através da recuperação do código do banco
que se encontra no código de barras/linha digitável do mesmo. Em conjunto com a opção de
filtragem por banco existe a opção Inverter Seleção (Figura 82), que filtra todos os bancos, com
exceção do selecionado. O uso destas opções é feito geralmente com leiautes para Contas a
Pagar, de bancos que aceitam boletos de outros bancos.
Figura 82: Configuração do filtro de Contas a Pagar
Para boletos de Contas a Pagar, o sistema emite um alerta para aqueles que cuja
formação do código de barras não atenda ao esperado, conforme demonstrado na Figura 83.
111
Figura 83: Alerta
7.1.2.3. Escolha dos títulos
Na etapa seguinte do assistente, são mostrados todos os boletos ou transferências que
serão adicionados aos arquivos de remessa. Segue uma descrição das colunas presentes nesta
grade. Para uma melhor visualização, utilize a Figura 84 como referência.
Figura 84: Assistente de exportação - Escolha dos títulos
Marcando o checkbox da coluna Sel., o usuário estará confirmando a inclusão daquele
título para o arquivo de remessa vinculado ao leiaute daquela forma de pagamento.
OBS: selecionando um dos checkbox e, em seguida, segurando a tecla shift + clicando
sobre outro checkbox, pode-se selecionar vários títulos de uma única vez.
112
Para marcar ou desmarcar todos os títulos de uma única vez, basta um único clique
sobre o cabeçalho da coluna Sel.
Tipo
A coluna tipo informa se a linha em questão apresenta um boleto (B), ou uma transferência
(T).
Nota/Parcela
A primeira letra desta coluna indica qual o documento que originou o boleto. Notas fiscais
(N) e Lançamentos contábeis manuais (L).
O número que vêm antes da barra (/) representa o número da serial, caso o documento
seja uma nota, ou então o número da transação (OJDT.TransId), caso o documento seja um
lançamento contábil manual.
Por fim, o número que vem após a barra indica qual a parcela que foi associada ao boleto.
OBS: caso a numeração venha zerada, isto significa que o boleto foi atribuído a mais de
um documento.
7.1.2.4. Resultados
Uma vez que o usuário avance para a próxima e última etapa, o assistente irá iniciar a
geração dos arquivos de remessa. Nesta tela, o programa demonstrará em tempo real em qual
etapa o gerador de arquivos se encontra, postando mensagens para a grade presente na tela,
conforme demonstrado na Figura 85.
113
Figura 85: Assistente de exportação – Resultados
Caso ocorra alguma falha nesta etapa do assistente, ele irá apresentar para o usuário uma
mensagem de erro, enquanto que ao mesmo tempo ele irá parar qualquer processo que estiver
executando. Sendo assim, para tentar novamente a criação do arquivo de remessa, o usuário
deverá tentar concertar o problema apresentado pelo programa e depois executar novamente o
assistente de exportação.
Caso o programa encerre com sucesso, terá então gerado os arquivos de remessas nos
locais apontados pelo leiaute de nomenclatura de arquivo.
OBS: o BankSync não realiza o envio do arquivo gerado para o banco, devido à
complicações e da não padronização dos serviços prestados pelos bancos nesta área. O
processo de selecionar o arquivo e enviar para o banco deve ser feito automaticamente pelo
cliente.
7.2. Importação do arquivo de retorno
O processo de importação do retorno bancário tem origem quando o banco disponibiliza
para o cliente um arquivo CNAB contendo as situações dos boletos enviados previamente para o
banco, geralmente feito através de um retorno por e-mail.
114
Sendo assim, uma vez que o cliente obtenha este arquivo, para dar início ao processo, ele
deverá navegar até Módulos | Banco | BankSync | Importação de Arquivo de Retorno. Feito
isto, será exibida uma tela de introdução que irá explicar um pouco sobre o processo de retorno,
conforme a demonstrada na Figura 86. Clicando sobre o botão Seguinte, o assistente irá para a
sua próxima etapa.
Figura 86: Assistente de Importação – Apresentação
7.2.1. Filtragem
A primeira opção de interação do usuário com o assistente vem na forma de escolha dos
filtros (Figura 87) que serão aplicados a importação dos títulos. Dentre as opções de filtros têm-
se:
Tipo do documento: Indica se o retorno contém títulos que estão associados a
documentos de Contas a Pagar ou a receber;
Data de vencimento: Caso sejam preenchidos, títulos que estejam fora dos limites
estipulados não serão exibidos na etapa de escolha dos documentos;
Forma de pagamento: A forma de pagamento é utilizada apenas para identificar o
leiaute que deverá ser utilizado no momento do retorno, uma vez que os boletos e
115
transferências já foram associados as suas respectivas formas de pagamento no
momento de sua criação;
Caminho do arquivo: Deve-se preencher neste campo o caminho completo até a
localidade do arquivo que se deseja importar no assistente. Para facilitar esta
operação, o botão que se encontra ao lado deste campo, oferece um assistente
que ajuda o usuário a encontrar este arquivo;
Figura 87: Assistente de Importação – Filtragem
Uma vez que os filtros tenham sido escolhidos, ao clicar-se sobre o botão Seguinte
novamente, o programa irá carregar os títulos encontrados do arquivo na grade da próxima etapa.
7.2.2. Escolha dos títulos
Ao se deparar com a tela de escolha dos títulos, pode-se perceber que existem três abas
nesta tela: Automática, Manual e Não-Identificados. Seus propósitos e particularidades são
explicados a seguir.
116
Automática
Esta é a principal aba das três e é a que indica que o título está pronto para ser atualizado
no sistema. Nela é possível escolher quais os títulos para realizar a importação no sistema, bem
como ajustar a data de lançamento que é recuperada do arquivo.
Importante ressaltar que a coluna Data do Lançamento desta grade será utilizada para
firmar a data em que a transação ocorreu. Em outras palavras, no caso de uma importação de
dados referentes aos boletos, será criada uma transação de boletos do SAP Business One e
agrupados nela todos os boletos cujas datas pertencem ao mesmo intervalo.
A Figura 88 ilustra um exemplo de cenário de importação, onde todos os títulos presentes
representam boletos no sistema.
OBS: além das datas diferenciadas, para que um boleto passe do status de Gerado para
Pago, ele precisa primeiro ser passado para o status Depositado.
Figura 88: Assistente de Importação – Aba Automática
117
Antes que o usuário prossiga par a etapa seguinte, caso ele tenha escolhido um leiaute
para Contas a Receber, ele deve decidir se os boletos selecionados na grade devem ser
considerados como pagos pela carteira de Descontado ou então pela de Cobrança (Figura 89).
Figura 89: Configuração do tipo de cobrança
Ele também pode inserir um pequeno texto que será adicionado à transação da troca de
status do boleto.
Ao clicar sobre o botão Seguinte, o assistente irá exibir a grade de resultados, que contém
um demonstrativo de todos os títulos que foram atualizados no sistema, separados por mudança
de status (Figura 90).
Figura 90: Assistente de Importação – Tela de resultados da importação do arquivo
118
Manual
O BankSync utiliza a aba Manual para separar os títulos que ele não sabe qual ação
tomar, deixando a cargo do usuário quais ações serão efetuadas posteriormente na tela de
Administração de boletos do SBO ou configuradas no próprio leiaute de retorno na aba
Ocorrências.
Os títulos que caem na aba manual o fazem geralmente por um dos motivos seguintes:
A ocorrência encontrada no arquivo não está cadastrada no leiaute de retorno,
sendo assim o programa não sabe que ação tomar;
A ocorrência encontrada no arquivo foi cadastrada no leiaute de retorno, porém não
foi atribuída nenhuma ação para ser tomada quando esta ocorrência fosse
encontrada;
Quando houver uma ocorrência de alteração de vencimento cuja nova data de
vencimento seja igual à data de vencimento atual do título;
Quando a ação selecionada para a ocorrência não for permitida pelo SBO, o que
depende da situação atual do boleto. As páginas 14 e 17 mostram os fluxos de
operações do SBO para contas a receber e contas a pagar respectivamente.
O título já foi importado no sistema, ou ainda o status do qual ele está partindo é
igual ao de destino. Ex: De Pago para Pago (Figura 91);
Figura 91: Status replicado
Intencionalmente para posterior inspeção pelo usuário.
Para auxiliar na identificação dos problemas, as colunas Motivo e Informações
Adicionais trazem a descrição da ocorrência (Figura 92), ou apenas o motivo pelo qual o título
caiu na aba Manual. Um exemplo da tela do assistente que se encontra na aba Manual pode ser
visto na Figura 93.
119
Figura 92: Ocorrências nas colunas Motivo e Informações adicionais
Figura 93: Assistente de Importação – Aba Manual
Não-Identificados
Os boletos que se encontram nesta situação, não tiveram sua contraparte encontrada no
sistema, ou seja, a identificação única do título que foi recuperada do arquivo de retorno não
condiz com nenhum dos títulos encontrados na base de dados do SAP Business One.
Isto indica que todos os métodos de identificação do título no sistema falharam, e que os
dados que estavam contidos naquela linha serão descartados.
Para sanar este problema, basta configurar corretamente um dos três métodos de
identificação que o BankSync oferece, todos descritos em Leiaute de Arquivo de Retorno.
120
Um exemplo de um título que não pode ser identificado encontra-se na Figura 94.
Figura 94: Assistente de Importação – Aba Não Identificado
7.2.3. Resultados
A última etapa deste processo é representada por um demonstrativo dos resultados da
importação. Nesta tela, podem ser encontradas diversas informações sobre os títulos e seus
respectivos documentos, bem como as transações aos quais estes agora fazem parte. Um
exemplo desta tela está disponível na Figura 95.
121
Figura 95: Assistente de Importação – Resultados
Após a realização da importação do arquivo, são realizadas as movimentações contábeis
dentro do SBO.
7.2.4. Reconciliação dos boletos
Conforme explicado anteriormente, um boleto que esteja no estado Pago dentro do SBO
não indica necessariamente que este já foi encerrado contabilmente. Um boleto só será
devidamente finalizado no sistema quando este for reconciliado contra um valor em um
demonstrativo de extrato bancário; ou em outras palavras, quando houver a confirmação da
entrada do dinheiro referente aquele boleto dentro da conta bancária da empresa, mediante uma
confirmação no extrato bancário.
Para que tal situação aconteça dentro do SBO, o usuário deverá importar para o sistema
os dados do extrato bancário. Para realizar tal processo, deve-se ter em mãos um arquivo de
extrato no modelo CNAB, disponibilizado pelo seu banco. Uma vez com este arquivo, o usuário
deverá utilizar o assistente de importação de extratos do BankSync
122
7.3. Importação do extrato bancário CNAB
Para iniciar o assistente, navegue até Módulos | Banco | BankSync | Importação de
Extrato Bancário (CNAB). Irá aparecer na tela um assistente do BankSync, conforme o
demonstrado na Figura 96.
Figura 96: Assistente para extratos CNAB - Apresentação
7.3.1. Filtragem
A etapa seguinte do assistente permite fazer a filtragem das linhas do extrato que não são
desejadas durante a importação. Segue um exemplo da tela na Figura 97.
123
Figura 97: Assistente para extratos CNAB - Filtragem
Dentre as opções de filtragem temos:
Leiautes: No momento da importação, devem-se informar quais dos leiautes de
extrato deverá ser utilizado;
OBS: o leiaute de extrato deve ser configurado no Contas bancárias da empresa,
especificamente na conta que você irá utilizar.
Arquivo: Este é o local onde deverá ser colocado o caminho até o arquivo CNAB
disponibilizado pelo banco. Pode-se utilizar o botão para usar o assistente de
busca de arquivos do Windows;
Data: Informando um período de data nestes campos, fará com que apenas linhas
do extrato cuja data esteja neste período sejam demonstradas na próxima etapa do
assistente;
Tipo de Lançamento: estes são os serviços que foram cadastrados no leiaute de
extrato CNAB e somente as linhas do extrato que apresentarem alguns dos serviços
124
marcados nesta grade serão exibidos na etapa seguinte. Caso não exista nenhum
serviço na grade, o programa irá interromper o avanço do assistente. Caso nenhum
dos serviços esteja marcado nesta grade, serão considerados todos os serviços
cadastrados para este leiaute;
Contas Bancárias: Aqui são mostradas todas as contas bancárias do cadastro de
Contas Bancárias da Empresa que estão associadas ao leiaute selecionado no
campo Leiaute desta tela do assistente. Caso não exista nenhuma conta na grade,
o programa irá interromper o avanço do assistente. Caso nenhuma das contas
esteja selecionada na grade, o programa irá considerar todas elas.
Uma vez que os filtros tenham sido escolhidos, ao clicar-se sobre o botão Seguinte
novamente, o programa irá carregar as linhas de extrato encontradas do arquivo na grade da
próxima etapa.
7.3.2. Escolha das linhas de extrato
Esta etapa do assistente permite a seleção das linhas de extrato que serão importadas
para o SAP Business One. Assim como a importação de arquivos de retorno, existem três
possibilidades para a identificação das linhas de extrato. Segue uma descrição delas.
Automática
Esta é a única aba que irá realizar realmente a importação das linhas de extrato no
sistema. Para que um extrato seja enviado para esta aba, é necessário que o Código da conta,
Código do banco e o Valor de identificação do registro estejam iguais aos cadastrados.
Também é necessário que o código do serviço encontrado no arquivo esteja cadastrado no
leiaute do extrato. A Figura 98 demonstra um exemplo desta tela.
125
Figura 98: Assistente para extratos CNAB - Automática
Somente os boletos que estiverem marcados na aba de Automática serão importados
para dentro do SBO. Estas linhas de extrato serão apresentadas em um demonstrativo ao final da
importação, na tela de resultados.
Manual
As linhas de extrato que se encontram na aba Manual (Figura 99) são porque
apresentaram uma identificação correta, com base no identificador de registros do extrato e
quanto ao código do banco, mas que falharam em outros quesitos como: o Tipo de lançamento
do extrato não é referente ao mesmo encontrado nele;
Qualquer que seja o motivo, as linhas do extrato que fizerem parte da aba Manual não
serão importadas para o sistema, devendo-se realizar as devidas correções para que estas linhas
apareçam na aba automática, caso deseje que o sistema as importe.
126
Figura 99: Assistente para extratos CNAB– Manual
Não-Identificados
A aba Não-Identificados apresenta as linhas de extrato cuja operação ou número da
conta do banco não foi encontrado no leiaute do extrato, ou no cadastro de Contas Bancárias da
Empresa. Assim como as linhas de extrato exibidas na aba Manual, as linhas exibidas nesta aba
não serão importadas no sistema. Um exemplo desta tela pode ser encontrado na Figura 100.
Figura 100: Assistente para extratos CNAB– Não-Identificados
127
7.3.3. Resultados
A aba de resultados apresenta um pequeno resumo das linhas de extrato que foram
importadas no sistema, conforme demonstrado na Figura 101.
Figura 101: Assistente para extratos CNAB - Resultados
Estas linhas do extrato que foram importadas no sistema podem ser encontradas na tela
Módulos | Banco | Extratos bancários e reconciliações externas | Processar extrato bancário
externo.
O cadastro destas linhas utiliza a conta contábil do banco que está cadastrada no campo
Conta contábil em Contas Bancárias da Empresa para o mesmo código do banco e número da
conta que foi encontrado na linha do extrato.
Uma vez feita esta importação das linhas de extrato para esta tela, o usuário do SBO
poderá partir para a reconciliação manual dos boletos.
Por padrão, a tela Processar extrato bancário externo (Figura 102) não vem com sua
visibilidade habilitada no sistema; para ativá-la, com a janela dos Módulos selecionada, clique
128
sobre o botão Configurações do Formulário e marque a checkbox da tela de
processamento de extrato bancário externo.
Figura 102: Processar extrato bancário externo
7.4. Processo de importação de boletos por DDA
O processo de Débito Direto Autorizado (DDA) adaptado para o SAP Business One se dá
por meio da importação de um arquivo de retorno, seguindo o modelo CNAB. Os dados
importados deste arquivo são utilizados para criar novos documentos de Contas a Pagar com
meio de pagamento por boleto, sendo estes associados a notas fiscais de entrada ou
lançamentos contábeis manuais de crédito ao fornecedor ou cliente. Este assistente permite
ainda que mais de um documento seja associado ao mesmo boleto, podendo ser eles uma
combinação de notas fiscais de entrada e lançamentos manuais.
Para iniciar o assistente de importação de boletos por DDA do BankSync, utilize o menu
que se encontra em Módulos | Banco | BankSync | Importação de Boletos por DDA. Uma tela
igual à demonstrada na Figura 103 será exibida, apresentando a tela de introdução do assistente.
129
Figura 103: Assistente de importação de boletos por DDA – Apresentação
7.4.1. Configurações
A primeira etapa do assistente envolve realizar as configurações para a criação dos novos
boletos. Nela, devem ser escolhidos:
Seleção do Banco em que será efetuado o processo de DDA;
A forma de pagamento para boletos de Contas a Pagar;
Os tipos de parceiros de negócio que serão aceitos nos documentos de notas fiscais
e lançamentos contábeis.
O arquivo que contém os dados dos boletos por DDA, obtido dos bancos, no modelo
CNAB;
Note que as opções de escolha do banco e seu respectivo número da conta são utilizados
para encontrar as formas de pagamento aceitas pelo assistente, que são as formas de
pagamento de entrada com meio de pagamento por boleto.
Note também que caso uma conta bancária da empresa não esteja aparecendo na
combobox de contas, é porque ela não esta associada a um leiaute de importação para DDA.
130
Figura 104: Assistente de importação de boletos por DDA – Configurações
Além das configurações, à direita da tela o importador possui os filtros por Dt. Vencimento
e Dt. Lançamento, duas opções adicionais para seleção dos títulos.
7.4.2. Seleção e correção dos boletos
A próxima etapa deste assistente apresenta um resumo das informações dos boletos que
foram recuperadas do arquivo CNAB. Para consultar um exemplo desta tela, veja a Figura 105.
131
Figura 105: Assistente de importação de boletos por DDA – Seleção dos boletos
Segue uma descrição das colunas desta etapa, com o seu significado e valor esperado:
Sel.
Indica as linhas com os dados dos boletos que serão enviados para a próxima etapa do
assistente, e que posteriormente serão inseridas no sistema.
PN: Código
Esta coluna deve possuir o código de um parceiro de negócio válido no SAP Business
One. Dependendo da opção escolhida na tela anterior, os valores válidos sugeridos por este
campo poderão ser fornecedores, clientes ou ambos.
Esta coluna tenta se auto-preencher também com base no CPF ou CNPJ do parceiro de
negócio. Caso no cadastro do PN estes valores estejam devidamente preenchidos (localizados no
campo na tela de Cadastro de parceiro de negócio, aba Contabilidade, aba Imposto, no botão
de Identificações fiscais – Figura 106), o BankSync irá trazer este campo automaticamente
preenchido.
132
Figura 106: Tela de Identificações fiscais do Parceiro de negócio
PN: Nome
Caso a identificação do PN pelo seu código fiscal, CPF ou CNPJ, tenha sido encontrada,
este campo mostra o nome do parceiro de negócio cadastrado no SBO. Do contrário, ele irá
trazer o valor que se encontra no arquivo de retorno CNAB do DDA.
Note que neste caso o nome encontrado no arquivo CNAB serve apenas como referência
para encontrar o código do parceiro de negócio dentro do SBO, e sua identificação deverá ser
feita manualmente através da lista de opções apresentadas na coluna do código do PN.
Valor
Este é o valor do boleto que foi recuperado do arquivo. Não é aconselhado alterá-lo, mas
caso haja a necessidade, ele está disponível para edição.
133
Lançamento
Esta será a data na qual o Contas a Pagar será gerado. Caso não venha configurado do
arquivo, sua data padrão é a de hoje.
Vencimento
Esta será a data de vencimento com qual o Contas a Pagar será gerado. Caso não venha
configurado do arquivo, sua data padrão é a de hoje.
Status
Esta coluna indica em qual estado o novo boleto deverá ser criado; Gerado ou Pago.
Pagamento
Caso a coluna Status tenha seu valor igual a Pago, então esta coluna será a data utilizada
para realizar a transação de pagamento dos boletos. Do contrário, ela será ignorada.
Código de Barras
Aqui é demonstrado o código de barras que foi recuperado do arquivo. Não é aconselhável
alterá-lo, mas o campo disponibiliza-se para alterações.
Observações
Podem-se adicionar aqui quaisquer observações referentes ao boleto que será criado.
Atribuição de títulos aos boletos.
134
8. Databases
Os databases são um conjunto de campos do banco de dados ou rotinas que realizam
algum cálculo específico, como por exemplo, os contadores de lote, que estão disponíveis para o
usuário na configuração dos leiautes de arquivo de remessa do BankSync.
Este capítulo tem como objetivo detalhar os databases disponíveis, especificando o que
cada um faz e também exemplificando o seu uso caso necessário.
Os databases estão disponíveis para configuração, na Definição do Registro do Leiaute
de Remessa, conforme Figura 107 abaixo:
Figura 107: Definição do registro - Databases
135
Ao clicar no botão Definição do Campo para uma linha do tipo Database, é possível
selecionar o database desejado conforme Figura 108 abaixo:
Figura 108: Definição do campo – Base de Dados (Databases)
8.1. Databases – Boleto
Boleto - Chave Única
Retorna a chave única do boleto no banco de dados – Campo BoeKey da tabela OBOE.
Boleto - Código de Barras
Retorna o código de barras do boleto – Campo Barcodenum da tabela OBOE.
136
Boleto - Data de Vencimento
Retorna a data de vencimento do boleto – Campo DueDate da tabela OBOE.
Boleto - Data do Documento
Retorna a data de lançamento do boleto – Campo PmntDate da tabela OBOE.
Boleto - Dígito do Nosso Número
Retorna o dígito verificador do nosso número – Campo OurNumChk da tabela OBOE.
Boleto - Endereço de Cobrança (Tipo Rua, Nº)
Retorna o Tipo do Logradouro + Rua + Nº da Rua – Campos AddrType, Street e StreetNo
da tabela CRD1.
Boleto - Linha Digitável
Retorna a linha digitável do boleto (47 dígitos) – Campo Barcoderep da tabela OBOE.
Boleto - Nosso Número
Retorna o nosso número gravado no boleto – Campo OurNum da tabela OBOE.
Boleto – Número do boleto
Retorna o número do boleto – Campo BoeNum da tabela OBOE.
Boleto - Referência 1
137
Retorna o número da referência do boleto – campo RefNum da tabela OBOE.
Boleto - Referência 2
Retorna a referência 2 do boleto – Campo Ref2 da tabela OBOE.
Boleto - Status [S-Enviado|G-Gerado|C-Cancelado]
Retorna “S” quando o status é “Enviado”, “G” para “Gerado” e “C” para “Cancelado” –
Campo BoeStatus da tabela OBOE.
Boleto - Valor de mora por dia de atraso
Retorna o valor da mora por dia de atraso calculado sobre a taxa configurada no campo “%
de juros sobre obrigações” do cadastro de Parceiros de Negócio – Campo IntrstRate da tabela
OCRD.
Boleto - Valor Total
Retorna o valor total do boleto – Campo BoeSum da tabela OBOE.
8.2. Databases - Cálculo
Cálculo - Amarração Horizontal (UNIBANCO)
Retorna um cálculo especifico para o UNIBANCO – Fórmula: (Numero do banco +
00000000000000) + Valor) * Tipo de Operação(5)
Cálculo - Digito de Controle - Agência (Bradesco)
138
Calcula o DV da agência de acordo com as regras do Bradesco. O número da agência é
multiplicado por 2 até 5, da direita para esquerda. Após isso, é feita a soma das multiplicações e
realizado o módulo 11. Caso o resto da divisão for igual a “0” ou “1”, o DV será “0”, caso contrário
o DV será igual a 11 menos o resto.
Cálculo - Digito de Controle - Conta (Bradesco)
Calcula o DV da conta bancária de acordo com as regras do Bradesco. O número da conta
é multiplicado por 2 até 7, da direita para esquerda. Após isso, é feita a soma das multiplicações e
realizado o módulo 11. Caso o resto da divisão for igual a “0” ou “1”, o DV será “0”, caso contrário
o DV será igual a 11 menos o resto.
Segundo Dígito Verificador do Nosso Número Banrisul
Retorna o segundo DV do Nosso Número para o banco Banrisul através do seguinte
calculo: O nosso número mais o primeiro DV são multiplicados por 2 até 7, da direita para
esquerda. Após isso, é feita a soma das multiplicações e realizado o módulo 11. Caso o resto da
divisão for igual a “0”, o DV será “0”, caso contrário o DV será igual a 11 menos o resto.
8.3. Databases - Cedente
Cedente – CNPJ
Retorna o CNPJ do cedente (Empresa) – Campo TaxIdNum da tabela OADM.
Cedente - Endereço da Empresa (CEP)
Retorna o CEP da empresa – Campo ZipCode da tabela ADM1.
139
Cedente - Endereço da Empresa (Cidade)
Retorna a cidade da empresa – Campo City da tabela ADM1.
Cedente - Endereço da Empresa (Complemento)
Retorna o complemento da empresa – Campo Building da tabela ADM1.
Cedente - Endereço da Empresa (Estado)
Retorna o estado da empresa – Campo State da tabela ADM1.
Cedente - Endereço da Empresa (Nº)
Retorna o número do endereço da empresa – Campo StreetNo da tabela ADM1.
Cedente - Endereço da Empresa (Rua)
Retorna a rua da empresa – Campo Street da tabela ADM1.
Cedente - Nome da Empresa
Retorna o nome da empresa – Campo CompnyName da tabela OADM.
8.4. Databases – Contas a Pagar
Contas a Pagar - Código do banco
Retorna a informação do campo “Pagamento para o código do banco” de uma conta a
pagar ou transferência bancária – Campo PBnkCode da tabela OVPM (Contas a Pagar) ou
OPDF (transferências).
140
Contas a Pagar - Número da Agência
Retorna a informação do campo “Pagamento a filial do banco” de uma conta a pagar ou
transferência bancária – Campo PBnkBranch da tabela OVPM (Contas a Pagar) ou OPDF
(transferências).
Contas a Pagar - Número da Conta
Retorna a informação do campo “Pagamento para a conta bancária nº” de uma conta a
pagar ou transferência bancária – Campo PBnkAccnt da tabela OVPM (Contas a Pagar) ou
OPDF (transferências).
Contas a Pagar - Dígito da Conta
Retorna o dígito da conta bancária para uma conta a pagar – Campo UsrNumber2 da
tabela OCRB.
8.5. Databases - Documento
Documento - Número da Nota Fiscal
Retorna o número da nota fiscal – Campo Serial das tabelas OINV (Contas a Receber) ou
OPCH (Contas a Pagar).
Documento - Número da Parcela
Retorna o número da parcela do documento – Campo InstId das tabelas OINV (Contas a
Receber), OPCH (Contas a Pagar) ou PDF2 (transferências).
141
Documento - Número Total de Prestações
Retorna o total de prestações do documento – Campo Installmnt das tabelas OINV
(Contas a Receber), OPCH (Contas a Pagar) ou PDF2 (transferências).
Documento - Quantidade de Notas Fiscais
Retorna “0” quando não existem NFs no boleto / transferência ou “1” quando existe pelo
menos uma NF no boleto / transferência.
8.6. Databases - Extra
(Extra)
Retorna a linha digitável do boleto para concessionárias (48 dígitos) – Campo Barcoderep
da tabela OBOE.
(Extra) Boleto - Nosso Número (Port/OurNum-Chk)
Retorna a carteira (C), nosso número (N) e DV (D) no formato “CC/NNNNNN-D” – Campos
PtfNum da tabela OPTF, OurNum e OurNumChk da tabela OBOE.
(Extra) Cedente - Identificação da Empresa
Retorna a seguinte string: “0” + Carteira + Agência + Nº da Conta + DV da Conta. Campos
PtfNum da tabela OPTF, Branch, Account e AccountChk da tabela DSC1.
(Extra) Sacado - Número da Nota Fiscal/Parcela
Retorna o número da NF e o número da parcela no formado “NF/P” – Campos Serial das
tabelas OINV (Contas a Receber) ou OPCH (Contas a Pagar) e campo InstId das tabelas RCT2
(Contas a Receber) ou VPM2 (Contas a Pagar).
142
(Extra) Código da Transação do LCM ou Serial na Nota Fiscal
Retorna o código da transação do LCM ou a Serial da NF de acordo com o documento.
Campo – DocEntry das tabelas RCT2 (Contas a Receber) ou VPM2 (Contas a Pagar) para LCM
e campo Serial das tabelas OINV (nota de saída) ou OPCH (nota de entrada) para NF.
8.7. Databases – Forma de Pagamento
Forma de Pagamento - Digito da Agência do Cedente
Retorna o DV da agência bancária parametrizada na forma de pagamento – Campo
ControlKey da tabela DSC1.
Forma de Pagamento - Código da Forma de pagamento
Retorna o código da forma de pagamento no banco de dados – Campo PayMethCod da
tabela OPYM.
Forma de Pagamento - Tipo de Documento
Retorna o tipo de documento da forma de pagamento – Campo DocType da tabela OPYM.
Forma de Pagamento – Aceite [Y] [N]
Retorna o aceite da forma de pagamento – Campo Accepted da tabela OPYM.
Forma de Pagamento - Agência do Cedente
Retorna a agência da empresa selecionada na forma de pagamento – Campo Branch da
tabela OPYM.
143
Forma de Pagamento - Código da Carteira
Retorna o código da carteira vinculada a forma de pagamento – Campo PtfCode da tabela
OPTF.
Forma de Pagamento - Código da Instrução 1
Retorna o código da instrução 1 especificada na forma de pagamento – Campo Instruct1
da tabela OPYM
Forma de Pagamento - Código da Instrução 2
Retorna o código da instrução 2 especificada na forma de pagamento – Campo Instruct2
da tabela OPYM
Forma de Pagamento - Digito da Conta do Cedente
Retorna o DV da conta bancária parametrizada na forma de pagamento – Campo
AccountChk da tabela DSC1.
Forma de Pagamento - Instrução 1
Retorna a descrição da instrução 1 informada na forma de pagamento – Campo
InstrDespt da tabela OIST.
Forma de Pagamento - Instrução 2
Retorna a descrição da instrução 2 informada na forma de pagamento – Campo
InstrDespt da tabela OIST.
144
Forma de Pagamento - Número da Carteira
Retorna o número da carteira parametrizada na forma de pagamento – Campo PtfNum da
tabela OPTF.
Forma de Pagamento - Número da Conta do Cedente
Retorna o número da conta bancária parametrizada na forma de pagamento – Campo
DflAccount da tabela OPYM.
Forma de Pagamento - Número do Acordo
Retorna o número do acordo da conta bancária parametrizada na forma de pagamento –
Campo AgreeNum da tabela DSC1.
Forma de Pagamento - Número do Contrato
Retorna o número do contrato da conta bancária parametrizada na forma de pagamento –
Campo U_Contract da tabela DSC1.
Forma de Pagamento – Observações
Retorna as observações do boleto – Campo Comments da tabela OBOE.
Forma de Pagamento - Qtde de Arquivos enviados
Retorna a quantidade de arquivos que já foram enviados ao banco – Campo U_OCounter
da tabela OPYM.
Forma de Pagamento - Código do Banco
Retorna o código do banco parametrizado na forma de pagamento – Campo BnkDflt da
tabela OPYM.
145
Forma de Pagamento - Nome do Banco
Retorna o nome do banco parametrizado na forma de pagamento – Campo BankName da
tabela ODSC.
8.8. Databases - Leiaute
Leiaute - Contador independente
O contador independente é incrementado cada vez que este é usado, e é resetado sempre
que um arquivo novo é processado.
Exemplo:
Supondo que o contador seja parametrizado no Header de lote do leiaute, então sempre
que um Header de lote for incluído no arquivo, o contador será incrementado.
Leiaute - Contador de lotes persistente
Retorna a quantidade de lotes contidos no arquivo.
Leiaute - Contador de Documentos do Lote
Retorna a quantidade de documentos contidos em um lote.
Leiaute - Contador de Linhas do Arquivo
Retorna a quantidade de linhas contidas no arquivo.
Leiaute - Contador de Lotes de Títulos
Retorna a quantidade de lotes com títulos/boletos no arquivo.
146
Leiaute - Contador de Linhas do Lote
Retorna a quantidade de linhas do lote, levando em conta o header, os detalhes e o trailler.
Leiaute – Contador de Linhas Internas do Lote
Retorna a quantidade de linhas dentro de um lote.
Leiaute – Data/Hora de Criação do Arquivo
Retorna a data e hora em que o arquivo de remessa foi criado.
Leiaute – Soma dos Documentos do Arquivo
Retorna o valor total de todos os documentos contidos no arquivo de remessa.
Leiaute – Tipo de transação
Retorna “0” se o tipo de transação dos boletos é descontado ou “1” se é de cobrança.
8.9. Databases - PN
PN – Agência
Retorna a agência bancária do parceiro de negócio – Campo DflBranch da tabela OCRD.
PN – CNPJ
Retorna o CNPJ do parceiro de negócio – Campo TaxId0 da tabela CRD7.
PN - Código do Banco
147
Retorna o código do banco do parceiro de negócio – Campo BankCode da tabela OCRD.
PN - Complemento do CNPJ (Filial e DV)
Retorna a filial e o dígito verificador do CNPJ do parceiro de negócio no formado “1234-DV”
– Campo TaxId0 da tabela CRD7.
PN - Corpo do CNPJ
Retorna a parte inicial do CNPJ do parceiro de negócio no formato “12123123” – Campo
TaxId0 da tabela CRD7.
PN - Corpo do CPF
Retorna a parte inicial do CPF do parceiro de negócio no formato “123123123” – Campo
TaxId4 ou TaxId7 da tabela CRD7.
PN - CPF
Retorna o CPF do parceiro de negócio - Campo TaxId4 ou TaxId7 da tabela CRD7.
PN - Dígito Verificador do CPF
Retorna apenas o dígito verificador do CPF do parceiro de negócio - Campo TaxId4 ou
TaxId7 da tabela CRD7.
PN - E-Mail
Retorna o e-mail do parceiro de negócio – Campo E_mail da tabela OCRD.
148
PN - Endereço de Cobrança (Bairro)
Retorna o bairro do endereço padrão de cobrança do parceiro de negócio – Campo Block
da tabela CRD1.
PN - Endereço de Cobrança (CEP)
Retorna o CEP do endereço padrão de cobrança do parceiro de negócio – Campo
ZipCode da tabela CRD1.
PN - Endereço de Cobrança (Cidade)
Retorna a cidade do endereço padrão de cobrança do parceiro de negócio – Campo City
da tabela CRD1.
PN - Endereço de Cobrança (Complemento)
Retorna o complemento do endereço padrão de cobrança do parceiro de negócio – Campo
Building da tabela CRD1.
PN - Endereço de Cobrança (Estado)
Retorna o estado do endereço padrão de cobrança do parceiro de negócio – Campo State
da tabela CRD1.
PN - Endereço de Cobrança (Nº)
Retorna o número do endereço padrão de cobrança do parceiro de negócio – Campo
StreetNo da tabela CRD1.
149
PN - Endereço de Cobrança (Rua)
Retorna a rua do endereço padrão de cobrança do parceiro de negócio – Campo Street da
tabela CRD1.
PN - Endereço de Cobrança (Rua, Nº)
Retorna o nome da rua e número do endereço padrão de cobrança do parceiro de negócio
no formato “Exemplo 123” – Campos Street e StreetNo da tabela CRD1.
PN - Endereço de Cobrança (Tipo Rua, Nº)
Retorna o tipo, o nome da rua e número do endereço padrão de cobrança do parceiro de
negócio no formato “Rua Exemplo, 123” – Campos AddrType, Street e StreetNo da tabela
CRD1.
PN - Nome do Parceiro de Negócios
Retorna o nome do parceiro de negócios – Campo CardName da tabela OCRD.
PN - Número da Conta
Retorna o número da conta bancária padrão do parceiro de negócios – Campo DflAccount
da tabela OCRD.
PN - Taxa de Juros
Retorna a taxa de juros definida para o parceiro de negócios – Campo IntrstRate da tabela
OCRD.
150
PN - Tipo de Pessoa [01-PJ|02-PF|00-Nenhum]
Retorna “01” para pessoa jurídica, “02” para pessoa física e “00” para nenhum. É retornado
“00” quando o parceiro de negócio não foi encontrado ou os campos TaxId0 e TaxId4 da tabela
CRD7 estão em branco.
PN - Chave de Controle
Retorna o ID Interno de controle do banco – Campo BankCtlKey da tabela OCRD.
PN - Digito Verificador da Agencia
Retorna o DV da agência do parceiro de negócios – Campo UsrNumber1 da tabela
OCRB.
9. DLL - Dynamic-Link Library
Segundo a Wikipédia, as Bibliotecas de Ligação Dinâmica (Dynamic-link library – DLL)
foram uma implementação feita pela Microsoft para o conceito de bibliotecas compartilhadas nos
sistemas operacionais Microsoft Windows e OS/2.
Uma DLL é um arquivo binário que contém um conjunto de funções que estão disponíveis
para qualquer outro programa que venha a necessitar de alguma destas funções.
Para utilizá-las, basta que o programa faça referência a DLL e suas funções. A Figura 109
explica em mais detalhes como este processo ocorre:
151
Figura 109: Processo de execução de uma DLL
O SAP Business One se aproveita deste recurso no momento em que ele gera um novo
Contas a Receber onde, se a forma de pagamento for do tipo boleto, o SAP Business One envia
uma solicitação para a DLL do banco associado à Forma de Pagamento, pedindo para que ela
lhe monte o código de barras e faça também o cálculo do dígito verificador do nosso número. Em
caso de sucesso, o SAP Business One recebe estes dois valores, e os grava respectivamente
nos campos BarcodeNum e OurNumChk da tabela de boletos OBOE. Em caso de falha, o SAP
Business One alerta o usuário com uma mensagem de texto em vermelho na barra de status
dele, mas que na maioria das vezes não é suficiente para uma correção precisa. A Figura 110
ilustra levemente este processo:
152
Figura 110: Fluxo de chamadas do Business One
As novas DLLs desenvolvidas pela empresa Sistema Informática Empresarial contam com
um recurso a mais para identificação de falhas. Ela utiliza um sistema de mensagens e Logs
(registros), em que toda vez que a DLL se comportar de uma maneira inesperada, é mostrado
para o usuário uma caixa de mensagem, detalhando o erro, ao mesmo tempo em que é gerado
um arquivo de Log, que pode ser encontrado na pasta %Temp%\BankSync\DLL Logs. Um
exemplo da mensagem mostrada pode ser vista na Figura 111 abaixo:
Figura 111: Mensagem de Erro da DLL.
Ao se deparar com este tipo de mensagem, caso o usuário não consiga realizar por conta
própria a correção, o procedimento padrão para que solicite suporte com a Sistema Informática
Empresarial, é que ele deverá abrir um chamado em nosso site, e adicionar como anexo o
arquivo de Log gerado, que possuirá em seu nome, o nome da DLL que acusou o erro, bem
como a data e hora em que o mesmo foi gerado.
153
As DLLs, desenvolvidas por nossa empresa para o SAP Business One estão programadas
para funcionarem apenas quando o add-on BankSync estiver em execução. Caso ela seja
invocada e o add-on esteja parado, o usuário será alertado do problema, usando o mecanismo de
alertas demonstrado anteriormente.
9.1. Código de Barras e Linha Digitável
Código de barras é uma representação gráfica de dados numéricos ou alfanuméricos. A
leitura dos dados é realizada por um tipo de scanner, conhecido como leitor de código de barras,
que emite um raio vermelho que percorre todas as barras. A captura de dados ocorre por forma
de reflexão da luz, que ocorre por entre os espaços em branco do código de barras, direto para
um aparelho que possa interpretá-los, como um visor ou computador.
De acordo com os padrões para códigos de barra estabelecidos pela FEBRABAN, os
bancos brasileiros devem utilizar o formato de código de barras 2 de 5, onde cada 5 barras
correspondem a um dígito alfanumérico, sendo que duas destas barras são longas. O
FEBRABAN também determina que o código de barras deva ser composto pelos seguintes dados
apresentados na Tabela 4:
Tabela 4: Estrutura dos dados do código de barras
Os dados chamados de Campos Livres devem ser preenchidos de acordo com o que o
manual de cada banco especifica. Segue a Tabela 5 demonstrando um exemplo de
preenchimento dos dados dos campos livres:
Ini Fim
1 3 3 Inteiro Identificação do Banco
4 4 1 Inteiro Código da Moeda ( 9 - Real)
5 5 1 Inteiro Digito Verificador do código de barras
6 9 4 Inteiro Fator de vencimento
10 19 10 Decimal(8,2) Valor nominal do título
20 44 25 Inteiro Campos Livres - De acordo com o banco emissor
Formatação dos dados do Código de Barras
PosiçãoTamanho Formato Conteúdo
154
Ini Fim
20 23 4 Inteiro Código da Agência (sem dígito)
24 25 2 Inteiro Código da Carteira
26 36 11 Inteiro Nosso Número (sem dígito)
37 43 7 Inteiro Conta do Cedente (sem dígito)
44 44 1 Decimal(8,2) Zero Fixo
Exemplo de preenchimento dos Campos Livres
PosiçãoTamanho Formato Conteúdo
Tabela 5: Exemplo de preenchimento dos Campos Livres
A linha digitável de um boleto foi criada para que este pudesse ser validado pelos bancos
quando seus leitores de código de barras estivessem inoperantes, ou inexistentes. A linha
digitável simboliza uma representação numérica do código de barras, acrescida de alguns dígitos,
usados para controle da conferência dos dados da própria linha digitável. É importante ressaltar
que a representação numérica da linha digitável é diferente da representação numérica do código
de barras, embora ambos contenham os mesmos dados. Em resumo, a linha digitável apresenta
3 dígitos numéricos a mais, que são os dígitos verificadores usados para consistência de seus
dados. O preenchimento da linha digitável é padrão para todos os bancos, conforme estabelecido
pela FEBRABAN, e seu formato de preenchimento é demonstrado na Tabela 6 abaixo:
Ini Fim
1 3 3 Inteiro Identificação do banco
4 4 1 Inteiro Código da moeda (9 - Real)
5 9 5 Inteiro Posições 20 à 24 do código de barras
10 10 1 Inteiro Dígito verificador do primeiro campo
11 20 10 Inteiro Posições 20 à 24 do código de barras
21 21 1 Inteiro Dígito verificador do segundo campo
22 31 10 Inteiro Posições 20 à 24 do código de barras
32 32 1 Inteiro Dígito verificador do terceiro campo
33 33 1 Inteiro Digito verificador do código de barras
34 37 4 Inteiro Fator de vencimento
38 47 10 Inteiro Valor nominal do título
PosiçãoTamanho Formato Conteúdo
Formatação dos dados da Linha Digitável
Tabela 6: Formatação dos dados da linha digitável
155
9.2. Configurações das DLLs no SAP Business One
O processo de configuração das DLLs se concentra em duas telas principais: O cadastro
de Contas Bancárias da Empresa e o cadastro de Formas de Pagamento. As Tabelas 7 e 8
demonstram os principais campos que são relevantes para o cálculo do código de barras das
DLLs.
Descrição Nome Tipo Tamanho
Código do banco BankCode Caracter 30
Nº da conta Account Caracter 50
Dígito de controle da conta AccountChk Caracter 1
Filial Branch Caracter 50 Agência
Chave de controle ControlKey Caracter 2 Digito da Agência
Nosso Número OurNum Inteiro -
Nº do acordo AgreeNum Caracter 4
Número do Contrato U_Contract Caracter 12
Campo TipoObservação
Contas Bancárias da Empresa - DSC1
Tabela 7: Campos da tabela Contas Bancárias da Empresa
Descrição Nome Tipo Tamanho
Código da moeda CurCode Caracter 2 9 = Real
Nº do portfólio PtfNum Caracter 4 Tabela OPTF
Formas de Pagamento - OPYM
Campo TipoObservação
Tabela 8: Campos da tabela Formas de Pagamento
Estes campos, com exceção do Código do Banco e o Código da Moeda, não fazem
parte obrigatoriamente do cálculo executado pela DLL para gerar o código de barras. Contudo, a
maioria dos bancos faz uso deles, e seu correto preenchimento pode evitar possíveis frustrações
com mensagens de erro com as DLLs. O campo Número do Contrato é o único destes campos
que deve ser preenchido apenas quando solicitado, pois seu uso é restrito apenas a alguns
bancos, os quais serão especificados nos manuais disponibilizados por esses bancos.
Quando uma forma de pagamento (Figura 112) é marcada como do tipo Recebido, com
meio de pagamento por Boleto, o botão extra é exibido na tela na opção Características do
156
boleto. É através dele que o usuário poderá informar o Código da moeda e Número do
portfólio/carteira, conforme na Figura 113 abaixo:
Figura 112: Configuração da Forma de Pagamento
157
Figura 113: Configurações específicas do boleto
O problema do campo nosso número
Na tela de cadastro de Contas Bancárias da Empresa, o campo Nosso número é
representado como sendo do tipo Inteiro de 32-bits. Os valores aceitos por este campo variam
de -2.147.483.648 até 2.147.483.647. Isto limita a quantidade de caracteres aceitos neste campo
a “10”, sendo que apenas “9” destes campos podem apresentar um valor de “0” a “9”. O último
campo pode ser representado apenas de “0” a “2”.
A maioria dos bancos reserva até 11 dígitos para o nosso número, porém não limitando a
valores maiores ainda. Para contornar este problema foi adotado o seguinte padrão:
Para situações em que o nosso número é menor ou igual a “9”, utiliza-se apenas o campo
do Nosso número (OurNum);
Para situações em que o nosso número está entre 10 e 13, utilizam-se os primeiros “9”
dígitos do nosso número (OurNum), complementando o restante com o campo Nº do Acordo
(AgreeNum), que vai até 4 caracteres;
Para situações em que o nosso número ultrapasse os 13 dígitos, utilize o campo Nº do
Contrato (U_Contract), caso o mesmo não esteja sendo utilizado pela DLL;
158
Se existir uma especificação especial da DLL em questão, tratando como deve ser feito o
preenchimento do campo nosso número, desconsiderar as condições anteriores e usar a
especificada pela DLL.
9.3. Particularidades das DLLs
Esta sessão apresenta as particularidades de cada DLL desenvolvida pela Sistema
Informática Empresarial. É de suma importância conferir as informações do seu respectivo banco
para configurar o BankSync e o Business One de forma correta, para obter sucesso na
comunicação bancária.
9.3.1. Banco ABC
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras:
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco - Fixo “237”.
Nosso Número Nº do Acordo Deve ser preenchido com dois dígitos como parte inicial
do nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com nove dígitos, totalizando 11
dígitos com o Nº do Acordo.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº.
9.3.2. Banco Banrisul
Devido a uma restrição do SAP Business One, que limita o tamanho do dígito verificador
do nosso número a apenas 1 dígito, a DLL deste banco irá retornar, sempre, apenas o primeiro
número do dígito verificador do nosso número. O segundo dígito verificador pode ser extraído a
159
partir do código de barras gerado pela DLL, que fica disponível no campo Barcodenum da tabela
OBOE. A posição do nosso número com o DV duplo no código de barras deve ser consultada no
manual do banco.
O tipo de cobrança é fixo com o valor “2” – Cobrança direta. Abaixo são listados os campos
requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
9.3.3. Banco Bradesco
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com dois dígitos como parte inicial
do nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com nove dígitos, totalizando 11
dígitos com o Nº do Acordo.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
160
9.3.4. Banco do Brasil
A DLL do Banco do Brasil atende os casos em que no número do acordo apresenta os
tamanhos de 4, 6 e 7 posições para cobrança registrada e o caso da cobrança não registrada, em
que o nosso número apresenta tamanho “17” livre. As particularidades da DLL para cada
utilização podem ser encontradas nos tópicos que seguem.
Convênio de 4 dígitos, carteira registrada
Neste caso, o campo número do contrato (U_Contract) deverá ser preenchido com exatos
4 dígitos, enquanto que o nosso número (OurNum) não poderá ultrapassar o tamanho limite de 7
dígitos, pois concatenados os dois deverão apresentar tamanho final de 11 dígitos.
Convênio de 6 dígitos, carteira registrada
Neste caso, o campo número do contrato (U_Contract) deverá ser preenchido com exatos
6 dígitos, enquanto que o nosso número (OurNum) não poderá ultrapassar o tamanho limite de 5
dígitos, pois concatenados os dois deverão apresentar tamanho final de 11 dígitos.
Convênio de 7 dígitos, carteira registrada
Embora parecido com os anteriores, quando utilizado o convênio de 7 dígitos do banco, o
campo número do contrato (U_Contract) deverá ser preenchido com exatos 7 dígitos, porém
como a concatenação do número do contrato com o nosso número (OurNum) deverá apresentar
um tamanho final de 17 dígitos e o campo nosso número é limitado em 9 dígitos, o primeiro dígito
da seqüência do nosso número deverá ser preenchido no campo Número do Acordo
(AgreeNum). Veja um exemplo do preenchimento dos campos quando o nosso número for
10004730003126004:
Número do Contrato: 1000473;
Número do Acordo: 0;
Nosso número: 003126004;
Carteira não-registrada
Para utilização da carteira não registrada, com nosso número livre de 17 posições, basta
preencher os primeiros 8 números do nosso número no campo Usuário nº 1 (UsrNumber1) e os 9
161
dígitos restantes no campo do Nosso Número (OurNum). Supondo como exemplo o número
00000011000000009 temos que o preenchimento dos campos deverá ser:
Número do Contrato: 00000011;
Nosso número: 000000009;
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido conforme especificação acima.
Nosso Número Usuário Nº 1 Deve ser preenchido conforme especificação acima.
Nosso Número Nosso Nº Deve ser preenchido conforme especificação acima.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 8 dígitos.
Número do Contrato Número do Contrato Deve ser preenchido conforme especificação acima.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
Quando o Número do Contrato possuir 7 dígitos, os seis primeiros caracteres do campo
livre serão preenchidos com zeros.
O DV do Nosso Número será calculado sobre o Número do Contrato + Nosso Nº, exceto
quando o Número do Contrato possuir 6 dígitos e o campo “Usuário Nº 1” estiver preenchido.
162
9.3.5. Banco BVA
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 5 dígitos. O nosso número final
será o Número do Contrato + Nosso Nº totalizando 11 dígitos.
Número do Contrato Número do Contrato Deve ser preenchido com 6 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira - Fixo “09”
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº.
9.3.6. Banco CitiBank
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com dois dígitos como parte inicial
do nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com nove dígitos, totalizando 11
dígitos com o Nº do Acordo.
Número do Contrato Número do Contrato Deve ser preenchido com 9 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 3 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
163
9.3.7. Banco Fibra
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com dois dígitos como parte inicial
do nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com nove dígitos, totalizando 11
dígitos com o Nº do Acordo.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº.
9.3.8. Banco Caixa Econômica Federal
Esta DLL atende tanto a modalidade SICOB e SIGCB. A modalidade SICOB atende aos
nossos números de tamanho 11 e 16, enquanto que a SIGCB possui exclusivamente o nosso
número de 17 posições. Para que a DLL saiba qual situação ela irá atender, é necessário que o
usuário personalize alguns dados.
O principal deles se encontra na tela de cadastro de formas de pagamento. No campo Tipo
de Transação (TrnsType), deve ser informado o valor 11, 16 ou 17, respectivamente a
quantidade de dígitos que existem no nosso número. Caso não seja informado nenhum valor, a
DLL assumirá que o formato desejado de nosso número é 11, para SICOB.
Os tópicos que seguem demonstram as particularidades existentes no modelo de nosso
número que foi escolhido.
164
Nosso Número de 11 posições
Utilizado nas carteiras Rápida (12) e Sem Registro (14). Para evitar uma exceção, o
usuário deve preencher o campo do portfólio com o número da carteira que deseja utilizar,
conforme demonstrado na Figura 113.
É necessário também que o usuário informe o no campo Usuário Nº (UsrNumber1), do
cadastro de contas bancárias da empresa (DSC1), o código da operação desta conta; Ex: 870.
Embora o nosso número final possua 11 posições, uma delas é reservada para o dígito
verificador, e outra é um valor constante. Sendo assim, sobram apenas 9 (ou 8, caso esteja
utilizando a carteira sem registro) posições válidas para o nosso número no SAP Business One.
Em resumo, deve-se utilizar apenas o campo nosso número do B1 para preencher o valor do
nosso número.
Nosso Número de 16 posições
O valor do nosso número, que pode ser alterado pelo usuário, possui tamanho igual a 14.
Sendo assim, devem ser preenchidos os 9 dígitos finais no campo Nosso Número (OurNum),
enquanto que os 5 primeiros devem ser preenchidos no campo Número do Contrato
(U_Contract), ambos da tela de contas bancárias da empresa. Se os valores que irão ficar no
campo U_Contract forem todos zeros, pode-se deixar o campo em branco. Exemplos:
Número 00004000180000
o U_Contract = 00004;
o OurNum = 000180000;
Número 00000087463001
o U_Contract = 00000 ou vazio;
o OurNum = 087463001;
Nosso Número de 17 posições
A modalidade de cobrança utilizada (1 – Registrada ou 2 – Sem registro) deve ser
informada no campo Nº Usuário 2 (UsrNumber2), na tela de contas bancárias da empresa. Caso
o usuário não informe a modalidade de cobrança, o programa irá assumir que se trata da
cobrança registrada(1).
165
O valor do nosso número, que pode ser alterado pelo usuário, possui tamanho igual a 15.
Sendo assim, devem ser preenchidos os 9 dígitos finais no campo Nosso Número (OurNum),
enquanto que os 6 primeiros devem ser preenchidos no campo Número do Contrato
(U_Contract), ambos da tela de contas bancárias da empresa. Se os valores que irão ficar no
campo U_Contract forem todos zeros, pode-se deixar o campo em branco. Exemplos:
Número 000004000180000
o U_Contract = 000004;
o OurNum = 000180000;
Número 000000087463001
o U_Contract = 000000 ou vazio;
o OurNum = 087463001;
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido conforme instruções acima.
Número do Contrato Número do Contrato Deve ser preenchido conforme instruções acima.
Usuário Nº 1 Usuário Nº 1 Deve ser preenchido conforme instruções acima.
Usuário Nº 2 Usuário Nº 2 Deve ser preenchido conforme instruções acima.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta
Para Nosso Número 11 posições: deve ser preenchido com 8 dígitos. Para Nosso Número 16 posições: deve ser preenchido com 5 dígitos. Para Nosso Número 17 posições: deve ser preenchido com 6 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Fixo “8” para Nosso Número 16 posições.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº.
166
9.3.9. Banco HSBC
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Número do Contrato Número do Contrato Deve ser preenchido com o número do cliente no banco,
contendo 5 dígitos, para formar o nosso número.
Nosso Número Nosso Nº Deve ser preenchido com 5 dígitos, totalizando 10 dígitos
com o Número do Contrato.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos – fixo “00”
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
9.3.10. Banco Itau
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 5 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 3 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
Caso o valor do boleto possua mais do que 10 caracteres, serão colocados 14 dígitos no
código de barras, sobrescrevendo os 4 dígitos do fator de vencimento.
167
Cálculo DV Nosso Número para carteiras 126, 131, 146, 150, 168.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Número.
Cálculo DV Nosso Número para demais carteiras
O DV do Nosso Número será calculado sobre o Número da Agência + Número da Conta
bancária + Carteira + Nosso Número.
9.3.11. Banco Mercantil
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com dois dígitos como parte inicial
do nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com 6 dígitos. O nosso número final será formado pelo Nº do Acordo + Carteira + Nosso Nº,
totalizando 10 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número do Contrato Número do Contrato Deve ser preenchido com 9 dígitos.
Usuário Nº 1 Usuário Nº 1 Deve ser preenchido com o número “2” para “Sem
desconto” ou com o número “0” para “Com desconto”.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre o Número da Agência + Nº do Acordo +
Carteira + Nosso Nº.
168
9.3.12. Banco Nordeste
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 7 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
DV da Conta Bancária Dígito de Controle da Conta Deve ser preenchido com 1 dígito.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
9.3.13. Banco Pine
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com 2 dígitos como parte inicial do
nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com 9 dígitos. O nosso número final será formado pelo Nº do Acordo + Nosso Nº, totalizando
11 dígitos.
Número do Contrato Número do Contrato Deve ser preenchido com 7 dígitos, referente a conta que
o banco Pine especifica.
Usuário Nº 1 Usuário Nº 1 Deve ser preenchido com 4 dígitos, referente a agência
que o banco Pine especifica.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº final.
169
9.3.14. Banco Real
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com 4 dígitos como parte inicial do
nosso número quando o tipo de cobrança não for registrada.
Nosso Número Nosso Nº
Para cobrança registrada: este campo deve ser preenchido com 7 dígitos. Para cobrança não registrada: este campo deve ser preenchido com 9 dígitos. O Nosso número final será composto pelo Nº do Acordo + Nosso Nº, totalizando 13 dígitos.
Número do Contrato Número do Contrato Deve ser preenchido com 7 dígitos, referente a conta que
o banco Pine especifica.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Tipo de Cobrança Local de pagamento
Quando este campo for preenchido com os caracteres “NR”, sem aspas, o BankSync irá considerar que o tipo de cobrança é “Não Registrada”. Quando este campo estiver em branco ou preenchido com qualquer outra informação, o BankSync irá considerar que o tipo de cobrança é “Registrada”.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre o + Nosso Nº final + Número da Agência +
Número da Conta bancária.
170
9.3.15. Banco Safra
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos. É considerado apenas
para Cobrança Direta Eletrônica.
Número do Contrato Número do Contrato Deve ser preenchido com 6 dígitos.
Número da Agência Filial Deve ser preenchido com 5 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 9 dígitos.
Tipo de cobrança Usuário Nº 1
Deve ser preenchido com o número “1”, sem aspas, ou estar em branco para que o BankSync considere como Cobrança Direta Eletrônica. Deve ser preenchido com o número “2”, sem aspas, para que o BankSync considere como Cobrança Express.
Campo livre Usuário Nº 2 Quando o tipo de cobrança for “Express”, serão
considerados 17 caracteres deste campo para formação do Campo Livre.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
9.3.16. Banco Safra (Bradesco Correspondente)
Abaixo são listados os campos requisitados pela DLL para confecção do código de
barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Fixo “237”
Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos. O nosso número final
é composto pelo Nosso Nº + DV Safra, calculado de acordo com o manual do banco Safra, totalizando 9 dígitos.
Número da Agência - Fixo “3114”
Número da Conta bancária
- Fixo “0176300”
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
Carteira - Fixo “09”
171
O DV do Nosso Número será calculado sobre a Carteira + Ano de Emissão do Boleto +
Nosso Nº final (8 dígitos + DV Safra), calculo este realizado de acordo com as especificações do
Bradesco.
9.3.17. Banco Santander
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Número do Acordo Nº do Acordo Deve ser preenchido com 3 dígitos como parte inicial do
nosso número quando o Número do Banco for “033”.
Nosso Número Nosso Nº
033 – 353 - 008: Devem conter 7 dígitos no Nosso Número
Número do Contrato Número do Contrato Deve ser preenchido com 7 dígitos – Código do Cedente.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 3 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
9.3.18. Banco Sicredi
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
172
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nosso Nº Deve ser preenchido com 9 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
DV da Agência Chave de controle Deve ser preenchido com 2 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 5 dígitos.
Tipo de cobrança Usuário Nº 1
Deve ser preenchido com o número “1”, sem aspas, para que o BankSync considere como “Cobrança Registrada”. Deve ser preenchido com o número “3”, sem aspas, ou em branco para que o BankSync considere como “Cobrança sem Registro”.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira - Fixo “1”
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Campo Livre é inserido na última posição do código de barras.
9.3.19. Banco Sofisa
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
173
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com 2 dígitos como parte inicial do
nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com 9 dígitos. O nosso número final será formado pelo Nº do Acordo + Nosso Nº, totalizando
11 dígitos.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº final.
9.3.20. Banco Unibanco
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco Código do Banco -
Nosso Número Nº do Acordo Deve ser preenchido com 1 dígito como parte inicial do
nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com 9 dígitos. O nosso número final será formado pelo Nº do Acordo + Nosso Nº, totalizando
10 dígitos.
Número da Agência Filial Deve ser preenchido com 5 dígitos, incluindo o DV.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
Ao final do código de barras é inserido um DV calculado sobre "1" + Nosso Nº final + DV
Nosso Número.
9.3.21. Banco BicBanco
174
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco - Fixo “237”
Nosso Número Nosso Nº Deve ser preenchido com 6 dígitos.
Radical Usuário Nº 1 Deve ser preenchido com 2 dígitos de acordo com a
especificação no manual do banco.
Matrícula Usuário Nº 2 Deve ser preenchido com 3 dígitos de acordo com a
especificação no manual do banco.
Número da Agência Filial Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Nº da Conta Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Radical + Matrícula + Nosso Nº.
9.3.22. Banco BicBanco (Correspondente Bradesco)
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
175
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco - Fixo “237”
Nosso Número Nosso Nº Deve ser preenchido com 6 dígitos.
Radical Usuário Nº 1 Deve ser preenchido com 2 dígitos de acordo com a
especificação no manual do banco.
Matrícula Usuário Nº 2 Deve ser preenchido com 3 dígitos de acordo com a
especificação no manual do banco.
Número da Agência Correspondente
Usuário Nº 3 Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Correspondente Usuário Nº 4 Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Radical + Matrícula + Nosso Nº.
9.3.23. Banco Sofisa (Correspondente)
Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.
176
Cadastro de Contas Bancárias da Empresa – DSC1
Campo Nome do campo no B1 Observação
Número do banco - Fixo “237”
Nosso Número Nº do Acordo Deve ser preenchido com 2 dígitos como parte inicial do
nosso número devido a limitação do campo “Nosso Nº” no Business One.
Nosso Número Nosso Nº Deve ser preenchido com 9 dígitos. O nosso número final será formado pelo Nº do Acordo + Nosso Nº, totalizando
11 dígitos.
Número da Agência Correspondente
Usuário Nº 4 Deve ser preenchido com 4 dígitos.
Número da Conta bancária
Correspondente Usuário Nº 3 Deve ser preenchido com 7 dígitos.
Cadastro de Formas de Pagamento – OPYM
Campo Nome do campo no B1 Observação
Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos.
Moeda Código da Moeda Deve ser preenchido com 1 dígito.
O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº.
9.3.24. Dummy
A DLL Dummy foi desenvolvida com o único intuito de pular a etapa da verificação do
código de barras e dígito verificador do nosso número, executados durante a criação de um novo
boleto de Contas a Receber.
Ela sempre irá validar estes valores, e irá retornar zeros tanto para o código de barras
quanto para o dígito verificador do nosso número.
9.3.25. Particularidade com o DV do Nosso Número
Alguns bancos como o Safra – Correspondente Bradesco utilizam mais de um DV para o
Nosso Número em seu processo bancário. Infelizmente o Business One permite a gravação de
177
apenas um DV sendo que alguns bancos precisam de mais um. Neste caso, você deve ficar
atento ao manual do banco, pois geralmente um dos DVs é gravado no código de barras, e caso
necessário, este deve ser extraído a partir do código de barras gravado no campo Barcodenum
da tabela OBOE.
10. Funcionalidades
10.1. OneShare
Essa ferramenta permite ao usuário efetuar os processos de importação e exportação dos
seguintes leiautes:
Leiautes de Remessa
Leiautes de Retorno
Leiautes de Extrato Bancário Simples
Leiautes de Extrato Bancário CNAB
Leiautes de Nomenclatura de Arquivo de Remessa
O OneShare proporciona para o usuário a facilidade e versatilidade ao importar seus
leiautes. De forma simplificada, você poderá fazer backups de seus leiautes, fazer transferência
deles para outra base ou até mesmo fazendo esse processo somente nos leiautes que desejar.
OBS: Está ferramenta está disponível apenas para as versões do BankSync superiores a
4.0.0.
10.1.1. Exportação de leiautes
Primeiramente execute seu SAP Business One, logo após inicie o add-on BankSync, e
percorra o seguinte caminho: Administração / Configuração / Banco / OneShare / Exportação de
Leiautes, conforme a Figura 114 abaixo:
178
Figura 114: Caminho do OneShare
Após abrir a janela de Exportação de Leiautes, clique no botão Seguinte conforme a
Figura 115:
179
Figura 115: Tela inicial da exportação de leiautes
Ao executar o procedimento acima, a próxima tela (Figura 116) irá solicitar ao usuário a
identificação do local para que sejam salvo os leiautes. Escolha o caminho no qual deseja salvar
os leiautes do BankSync pressione o botão seguinte:
180
Figura 116: Tela informando o caminho para salvar o arquivo de leiaute
Já na tela de seleção de leiautes do BankSync (Figura 117), o usuário deve identificar os
leiautes desejados para o processo de exportação. Cada opção de tipos de leiautes são indicados
pelas abas acima da grade de seleção:
181
Figura 117: Tela de seleção de leiautes a serem exportados
Depois de selecionados os leiautes desejados, clique no botão seguinte para finalizar a
exportação. Os arquivos exportados estarão no caminho em que o usuário indicou.
10.1.2. Importação de leiautes
Primeiramente execute seu SAP Business One, logo após inicie o add-on BankSync e
percorra o seguinte caminho: Administração / Configuração / Banco / OneShare / Importação de
Leiautes, conforme a Figura 118 abaixo:
182
Figura 118: Caminho do OneShare
Após abrir a janela de Importação de Leiautes, clique no botão “Seguinte” conforme a
Figura 119:
183
Ao executar o procedimento acima, a próxima tela (Figura 120) irá solicitar ao usuário a
identificação do local onde foram salvos os leiautes. Nela identifique o caminho e selecione o
botão Seguinte:
Figura 119: Tela inicial da exportação de leiautes
Figura 120: Tela que informará o caminho onde foi salvo o arquivo de leiaute
184
Após clicar no botão Adicionar, será aberta a tela na qual o usuário deve selecionar o
arquivo .share ou .zip referente aos leiautes que o mesmo deseja importar.
Selecionado o arquivo, o usuário deve clicar no botão “Seguinte” para que passe para o
processo de seleção de leiautes para importação.
Na tela de “Seleção de Leiautes para Importação” (Figura 121), o usuário marcará os
leiautes desejados por meio do campo Sel, após efetuar as escolhas clicar no botão Seguinte.
Selecionado o arquivo, o usuário deve clicar no botão Seguinte avançando para a próxima
etapa.
Figura 121: Tela de seleção de leiautes a serem importados
185
Ao efetuar a escolha dos leiautes desejados, o usuário passa para a tela de “Correção de
Dados dos Leiautes” (Figura 122).
Na tela de correção de dados o usuário poderá alterar determinados campos do leiaute
como: Código e Nome. Também está disponível a opção de “Sobrescrever” que irá sobrescrever
um leiaute já existente em sua base de dados caso o código for igual. Caso o usuário não deseje
a opção de sobrescrever baste ele trocar o código do leiaute em questão ou desmarcar a flag da
coluna “Sobrescrever”.
A coluna “Situação” (Figura 123) irá mostrar ao usuário se o leiaute que ele esta tentando
importar já está sendo utilizado no sistema ou não, identificando isso pelo código do leiaute. Caso
o código do leiaute seja igual a outro código já existente em sua base de dados, o status desta
coluna “Situação” será sobrescrever.
Figura 122: Tela de correção de informações referentes aos leiautes a serem importados
186
Figura 123: Tela de finalização de importação de leiautes
Após efetuar as alterações desejadas, o usuário deverá clicar no botão Seguinte para
finalizar a importação.
10.2. Consulta ao SERASA
Essa funcionalidade foi lançada a partir da versão 5.0.5 do BankSync, com ela você poderá
efetuar consultas ao SERASA, porém como pré-requisito é necessário a contratação de um
serviço sujeito a tarifas. Para contratar esse módulo de serviço, é preciso acessar o site:
www.consultacpf.com (Distribuidor autorizado SERASA Experian Online), telefone: +55 (11) 4063-
3214.
10.2.1. Configuração da consulta SERASA
Acessando o seguinte caminho: Módulos | Administração | Inicialização do Sistema |
Configurações SERASA (Figura 124), será apresentada uma tela onde poderá efetuar
configurações a respeito da funcionalidade de consulta ao SERASA.
187
Figura 124: Caminho para acesso ás configurações SERASA
Na aba Configuração (Figura 125), o campo WebService contém os endereços dos
WebServices de teste e de produção.
188
Figura 125: Configurações SERASA / aba Configuração
OBS: os campos WebService, Usuário e Senha são de preenchimento obrigatório.
Na aba Permissões de acesso (Figura 126) serão exibidos os usuários cadastrados no
sistema, permitindo configurar através da seleção, quais são os usuários que terão acesso para
realizar novas consultas e visualizar os históricos de pesquisas já existentes do SERASA.
Figura 126: Configurações SERASA / Aba Permissões de acesso
189
Na aba Informações (Figura 127), ao clicar no botão Consultar saldo será realizado uma
consulta no WebService do SERASA sendo preenchidos os campos Saldo atual e Mensagem
de acordo com o resultado do retorno do Webservice (Figura 128).
Figura 127: Configurações SERASA / Aba Informações
Figura 128: Configurações SERASA / Aba Informações / Consulta de Saldo
190
10.2.2. Utilização da consulta SERASA
No caminho: Módulos | Parceiro de negócios | Consultas SERASA, será possível o
acesso á tela de consultas ao SERASA (Figura 129).
Figura 129: Consultas SERASA
OBS: caso o usuário corrente não possua ao menos permissão para visualização das
consultas já realizadas, o sistema emitirá uma mensagem alertando o usuário e a abertura da tela
deverá ser cancelada.
Para realizar uma nova consulta deverá ser selecionado o Parceiro de negócio. Após
selecionar o Parceiro de negócio e clicar no botão Nova Consulta, será aberta a tela de Nova
consulta SERASA (Figura 130), onde será exibido a opção de realizar uma consulta Simples ou
Completa. Ao selecionar uma consulta completa será habilitado o botão Detalhar consulta, se
for uma consulta simples o botão permanecerá desabilitado.
191
Figura 130: Consultas SERASA / Nova Consulta SERASA
OBS: o botão Nova Consulta estará visível somente para os usuários que possuírem
permissão de consultar, que é configurado na aba Permissões de acesso.
Ao finalizar uma consulta com sucesso, à opção Nova consulta SERASA será fechada e
a grade Histórica de consultas da opção de Consultas SERASA será atualizada com novas
informações. Selecionando um histórico de uma consulta completa, o botão Detalhar consulta
será habilitado, dessa forma será aberta a tela de Consulta completa SERASA: Detalhes
(Figura 131) onde mostra em detalhes a consulta e o tipo de pendência.
192
Figura 131: Tela de Consulta completa SERASA
Para facilitar o acesso, é possível efetuar uma consulta ao SERASA diretamente no
cadastro do Parceiro de negócios, porém esse botão presente na tela de cadastro (Figura 132)
será visível apenas para o usuário logado que tiver permissão para Consultas SERASA.
Figura 132: Botão de Consulta SERASA
193
10.3. Lançamentos contábeis extras
Foi incluído o parâmetro BankSync.LanctoAdicionalPagtoBoleto (Figura 133) na tela de
Administração | Inicialização do Sistema | Configuração do BankSync que, ao ativa-lo utilizando
a informação true, irá efetuar lançamentos contábeis extras no momento da baixa dos títulos no
B1, para Contas a Receber.
Figura 133: Add-on Settings – Parâmetros do BankSync
Para que o processo insira esses lançamentos, é necessária a configuração das contas
contábeis nos campos Conta Contábil e Banco de Cobrança na tela de Administração |
Configuração | Banco | Contas bancárias da empresa (Figura 134):
194
Figura 134: Contas bancárias da empresa – Configuração das contas
Quando a transação movimenta um documento para o status Pago, conforme a Figura
135, os lançamentos extras são inseridos da seguinte forma:
Lançamentos Atuais
Geração do Boleto
D – Contas a Receber de Boletos (Determinação Contábil / Cadastro de PN)
C – Contas a Receber (Determinação Contábil / Cadastro de PN)
Depósito do Boleto (Registro no Banco)
D – Conta de Cobrança (Contas Bancárias da Empresa)
C – Conta de Apresentação do Boleto (Determinação Contábil / Cadastro do PN)
Pagamento do Boleto
D – Conta de Apresentação do Boleto (Determinação Contábil / Cadastro do PN)
C – Contas a Receber de Boletos (Determinação Contábil / Cadastro de PN)
Lançamentos Adicionais
Pagamento do Boleto
D – Conta Contábil (Contas Bancárias da Empresa)
C – Conta de Cobrança (Contas Bancárias da Empresa)
195
Figura 135: Lançamento contábil manual – Lançamentos extras
10.4. Backup periódico dos leiautes
A funcionalidade de backup de leiautes no modo automático e manual, permite efetuar
backups periódicos de todos os leiautes da base de dados, ou se desejar, fazer backup utilizando
o Control Panel do BankSync.
Acessando o Painel de Controle do add-on no seguinte caminho: C:\Program
Files\SAP\SAP Business One\AddOns\SIE\BankSync (caminho pode mudar de acordo com o tipo
de instalação do Business One), especificamente na aba DB Manager do Painel, existe o botão
Backup Layout (Figura 136) onde irá permitir o backup manual de todos os leiautes da base de
dados.
196
Figura 136: Painel de Controle – Botão Backup Layout
Após clicar no botão Backup Layout, irá aparecer uma janela (Figura 137) solicitando o
caminho na qual o usuário deseja salvar esse backup. “Selecionando esse caminho, o processo
será iniciado e posteriormente concluído, disponibilizando um arquivo de extensão “.zip” contendo
todos os leiautes da base de dados.
Figura 137: Painel de Controle – Caminho do Backup
197
Para efetuar o backup automático desses leiautes, é necessária a ativação de um
parâmetro no BankSync de acordo com as instruções abaixo:
Acessando o seguinte caminho do B1: Administração | Inicialização do sistema
| Configuração do BankSync, irá acionar uma tela que solicitará uma Senha de Acesso (Figura
138). Enviando o Código de Acesso para o e-mail [email protected], o Suporte Técnico
da Sistema Informática Empresarial, irá retornar com uma Senha de Acesso para efetuar as
devidas configurações.
Figura 138: Configuração do BankSync - Acesso Restrito
Após inserir a Senha de Acesso disponibilizada pela equipe técnica da Sistema Info, a tela
de parâmetros abaixo (Figura 139) será apresentada:
198
Figura 139: Configuração do BankSync – AddOn Settings
Modificando o parâmetro BankSync.AdministradorBackupLayout para o valor “true”,
uma nova opção no menu do B1 será adicionado (Figura 140). Porém será preciso reconectar o
add-on pelo Painel de Controle, marcando a opção Ativar Todos os Módulos e Forçar a
Verificação da Base (Figura 141).
199
Figura 140: Menu B1 – Nova opção
Figura 141: Painel de Controle - Conexão
200
Acessando a nova opção no menu do B1, a tela se solicitação de Senha de Acesso irá
aparecer novamente, tendo que solicita-la a equipe de Suporte Técnico da Sistema Info.
Inserindo a Senha de Acesso, a tela do Administrador de Backup Layouts será
apresentada conforme Figura 142. Nela é possível a parametrização do backup automático dos
leiautes, tendo as opções de backup: diário, semanal, quinzenal e mensal, podendo também
configurar o horário (hora e minuto) em que o backup será gerado.
Figura 142: Menu B1 – Administrador de Backup Layouts
Efetuando a parametrização conforme necessidade do usuário, será possível monitorar os
backups acessando a tabela @SIEBS_BKPL (Figura 143), onde registrará sempre o último
backup de leiautes executado na base de dados.
Figura 143: Gerador de Consultas – Tabela de Backups