BankSync Manual

Manual de configuração do

BankSync

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 Info, 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

1. Introdução ao BankSync _________________________________________________________ 12

2. Comunicação bancária ___________________________________________________________ 12

2.1. Boletos _____________________________________________________________________________ 13

2.2. Débito automático ___________________________________________________________________ 13

2.3. Transferências ______________________________________________________________________ 14

3. Comunicação bancária dentro do SAP Business One _______________________________ 15

3.1. Boletos _____________________________________________________________________________ 15

3.2. Boletos de Contas a Receber ________________________________________________________ 16

3.2.1 Enviado __________________________________________________________________________________ 16

3.2.2 Gerado ___________________________________________________________________________________ 16

3.2.3 Depositado _______________________________________________________________________________ 17

3.2.4 Pago _____________________________________________________________________________________ 17

3.2.5 Cancelado________________________________________________________________________________ 18

3.2.6 Sem êxito ________________________________________________________________________________ 19

3.3. Boletos de Contas a Pagar ___________________________________________________________ 19

3.3.1 Gerado ___________________________________________________________________________________ 20

3.3.2 Pago _____________________________________________________________________________________ 20

3.3.3 Cancelado________________________________________________________________________________ 20

3.4. Transferências ______________________________________________________________________ 21

3.5. Particularidades do processo adaptado _______________________________________________ 23

4. Informações técnicas ____________________________________________________________ 24

4.1. Tecnologia _________________________________________________________________________ 24

4.2. Conexão Remota ____________________________________________________________________ 24

4.3. Suporte Técnico ____________________________________________________________________ 24

4.4. Ajuda ______________________________________________________________________________ 25

5. Instalação _______________________________________________________________________ 29

5.1. Download do Software _______________________________________________________________ 29

5.2. Registro do Add-On no SBO _________________________________________________________ 30

5.3. Instalação do Add-On no SBO ________________________________________________________ 31

5.4. Primeira execução do BankSync _____________________________________________________ 34

5.4.1 Senha para o banco de dados _____________________________________________________________ 34

5.4.2 Dados padrões das tabelas do BankSync __________________________________________________ 35

5.4.3 Chave de ativação ________________________________________________________________________ 35

5.5. Licenças para Add-Ons da SAP ______________________________________________________ 36

4

5.5.1 Adquirindo uma licença ___________________________________________________________________ 37

5.5.2 Atribuindo as licenças ____________________________________________________________________ 37

5.6. Configurando usuários do BankSync no SBO _________________________________________ 38

6. Configurações ___________________________________________________________________ 39

6.1. Telas do SAP Business One _________________________________________________________ 39

6.1.1 Detalhes da empresa _____________________________________________________________________ 40

6.1.2 Configurações gerais _____________________________________________________________________ 42

6.1.3 Contas bancárias da empresa _____________________________________________________________ 43

6.1.4 Formas de pagamento ____________________________________________________________________ 46

6.1.4.1 Parâmetros do BankSync _________________________________________________________________ 52

6.2. Telas do BankSync __________________________________________________________________ 53

6.2.1 Nomenclatura de Arquivo de Remessa _____________________________________________________ 54

6.2.2 Leiaute de Arquivo de Remessa ___________________________________________________________ 58

6.2.2.1 Definição do Leiaute ______________________________________________________________________ 58

6.2.2.2 Definição do Registro _____________________________________________________________________ 62

6.2.2.3 Definição do Campo ______________________________________________________________________ 64

6.2.3 Leiaute de Arquivo de Retorno ____________________________________________________________ 75

6.2.3.1 Identificação _____________________________________________________________________________ 77

6.2.3.2 Ocorrências ______________________________________________________________________________ 84

6.2.3.3 Cobrança ________________________________________________________________________________ 89

6.2.3.4 Erros ____________________________________________________________________________________ 91

6.2.3.5 Validação Boletos ________________________________________________________________________ 93

6.2.4 Leiaute de Extrato Bancário (CNAB) _______________________________________________________ 96

6.2.4.1 Identificação _____________________________________________________________________________ 97

6.2.4.2 Serviço _________________________________________________________________________________ 102

7. Processos do BankSync_________________________________________________________ 104

7.1. Processo de remessas _____________________________________________________________ 104

7.1.1 Criando títulos no SBO __________________________________________________________________ 104

7.1.2 Criando uma nota fiscal __________________________________________________________________ 104

7.1.3 Gerando um título _______________________________________________________________________ 106

7.1.4 Geração da remessa _____________________________________________________________________ 108

7.1.5 Apresentação do assistente ______________________________________________________________ 108

7.1.6 Filtros ___________________________________________________________________________________ 108

7.1.7 Escolha dos títulos ______________________________________________________________________ 112

7.1.8 Resultados ______________________________________________________________________________ 113

7.2. Importação do arquivo de retorno ___________________________________________________ 114

7.2.1 Filtragem ________________________________________________________________________________ 115

7.2.2 Escolha dos títulos ______________________________________________________________________ 116

7.2.3 Resultados ______________________________________________________________________________ 122

7.2.4 Reconciliação dos boletos _______________________________________________________________ 123

7.3. Importação do extrato bancário CNAB _______________________________________________ 123

7.3.1 Filtragem ________________________________________________________________________________ 124

7.3.2 Escolha das linhas de extrato ____________________________________________________________ 125

7.3.3 Resultados ______________________________________________________________________________ 128

5

7.4. Administração e importação de boletos por DDA _____________________________________ 129

7.4.1 Importação do arquivo de DDA ___________________________________________________________ 129

7.4.2 Administração de boletos por DDA _______________________________________________________ 132

7.5. Administração e pagamento de transferências bancárias _____________________________ 134

7.5.1 Pagamento das transferências ___________________________________________________________ 134

7.5.2 Administração das transferências ________________________________________________________ 141

7.6. Administração de Cartão de Crédito _________________________________________________ 145

7.6.1 Parametrizações iniciais _________________________________________________________________ 145

7.6.2 Novo leiaute de Cartão de Crédito (VANS/Normal) _________________________________________ 150

7.6.3 Parametrizações do leiaute de VANS _____________________________________________________ 152

7.6.4 Processo ________________________________________________________________________________ 154

8. Databases ______________________________________________________________________ 160

8.1. Databases – Boleto _________________________________________________________________ 162

8.2. Databases - Cálculo ________________________________________________________________ 164

8.3. Databases - Cedente _______________________________________________________________ 164

8.4. Databases – Contas a Pagar ________________________________________________________ 165

8.5. Databases - Documento ____________________________________________________________ 166

8.6. Databases - Extra __________________________________________________________________ 167

8.7. Databases – Forma de Pagamento ___________________________________________________ 168

8.8. Databases - Leiaute ________________________________________________________________ 170

8.9. Databases - PN_____________________________________________________________________ 171

8.10. Databases - Transferência ________________________________________________________ 175

9. DLL - Dynamic-Link Library ______________________________________________________ 176

9.1. Código de Barras e Linha Digitável __________________________________________________ 178

9.2. Configurações das DLLs no SAP Business One ______________________________________ 180

9.3. Particularidades das DLLs __________________________________________________________ 183

9.3.1 Banco ABC ______________________________________________________________________________ 184

9.3.2 Banco América __________________________________________________________________________ 184

9.3.3 Banco Banrisul __________________________________________________________________________ 185

9.3.4 Banco Bancoob _________________________________________________________________________ 185

9.3.5 Banco Bradesco _________________________________________________________________________ 186

9.3.6 Banco do Brasil _________________________________________________________________________ 186

9.3.7 Banco CitiBank __________________________________________________________________________ 188

9.3.8 Banco Fibra _____________________________________________________________________________ 188

9.3.9 Banco Caixa Econômica Federal _________________________________________________________ 189

9.3.10 Banco HSBC ____________________________________________________________________________ 191

9.3.11 Banco Itaú ______________________________________________________________________________ 192

9.3.12 Banco Mercantil _________________________________________________________________________ 193

9.3.13 Banco Nordeste _________________________________________________________________________ 193

9.3.14 Banco Pine ______________________________________________________________________________ 194

6

9.3.15 Banco Safra _____________________________________________________________________________ 194

9.3.16 Banco Safra (Bradesco Correspondente) _________________________________________________ 195

9.3.17 Banco Santander ________________________________________________________________________ 195

9.3.18 Banco Sicoob (Correspondente Banco do Brasil) __________________________________________ 196

9.3.19 Banco Sicredi ___________________________________________________________________________ 197

9.3.20 Banco Sofisa ____________________________________________________________________________ 198

9.3.21 Banco BicBanco _________________________________________________________________________ 198

9.3.22 Banco BicBanco (Correspondente Bradesco) _____________________________________________ 199

9.3.23 Banco Sofisa (Correspondente) __________________________________________________________ 199

9.3.24 Dummy _________________________________________________________________________________ 200

9.3.25 Particularidade com o DV do Nosso Número ______________________________________________ 200

10. Funcionalidades ______________________________________________________________ 200

10.1. OneShare ________________________________________________________________________ 200

10.1.1 Exportação de leiautes ___________________________________________________________________ 201

10.1.2 Importação de leiautes ___________________________________________________________________ 204

10.2. Consulta ao SERASA _____________________________________________________________ 208

10.2.1 Configuração da consulta SERASA _______________________________________________________ 208

10.2.2 Utilização da consulta SERASA __________________________________________________________ 212

10.3. Lançamentos contábeis extras ____________________________________________________ 215

10.4. Backup periódico dos leiautes ____________________________________________________ 217

10.5. Geração e impressão de boletos __________________________________________________ 222

10.6. Geração de boletos em lote _______________________________________________________ 230

10.7. Leiaute de impressão de boletos __________________________________________________ 232

10.8. Compensação de Cheques ________________________________________________________ 233

10.8.1 Configurações ___________________________________________________________________________ 233

10.8.2 Processo e Contabilização _______________________________________________________________ 233

7

Índice de Figuras

FIGURA 1: ADMINISTRAÇÃO DE BOLETOS ........................................................................................................................................ 15

FIGURA 2: STATUS DO BOLETO DE CONTAS A RECEBER ................................................................................................................... 16

FIGURA 3: BOLETOS PAGOS RECONCILIADOS OU NÃO .................................................................................................................... 18

FIGURA 4: STATUS DOS BOLETOS DE CONTAS A PAGAR .................................................................................................................. 19

FIGURA 5: PROCESSO DAS TRANSFERÊNCIAS NO BANKSYNC ........................................................................................................... 22

FIGURA 6: STATUS DAS TRANSFERÊNCIAS DO BANKSYNC................................................................................................................ 22

FIGURA 7: TELA SOBRE BANKSYNC ................................................................................................................................................... 25

FIGURA 8: TELA DE ATUALIZAÇÕES DO BANKSYNC .......................................................................................................................... 26

FIGURA 9: TELA DE ACESSO A FAQS E MANUAIS DO BANKSYNC ...................................................................................................... 26

FIGURA 10: TELA DE ACESSO AO SUPORTE TÉCNICO DO BANKSYNC ............................................................................................... 27

FIGURA 11: TELA DO SITE DA SISTEMA INFO - DOWNLOADS ........................................................................................................... 28

FIGURA 12: TELA DE ATIVAÇÃO DO BANKSYNC ................................................................................................................................ 28

FIGURA 13: REGISTRANDO O ADD-ON NO SBO ................................................................................................................................ 30

FIGURA 14: CONFIGURAÇÃO DE INICIALIZAÇÃO DO ADD-ON .......................................................................................................... 31

FIGURA 15: INÍCIO DA INSTALAÇÃO DO ADD-ON NO SBO................................................................................................................ 32

FIGURA 16: INSTALAÇÃO – INFORMAÇÕES DO USUÁRIO ................................................................................................................ 33

FIGURA 17: INSTALAÇÃO – CAMINHO DA INSTALAÇÃO ................................................................................................................... 33

FIGURA 18: ATUALIZAÇÃO DA ESTRUTURA DA BASE DE DADOS ...................................................................................................... 34

FIGURA 19: REQUISITANDO A SENHA DO BANCO DE DADOS .......................................................................................................... 35

FIGURA 20: AVISO ANTES DE POVOAR AS TABELAS DO ADD-ON ..................................................................................................... 35

FIGURA 21: CHAVE DE ATIVAÇÃO ..................................................................................................................................................... 36

FIGURA 22: SELECIONANDO LICENÇA PARA UM USUÁRIO .............................................................................................................. 37

FIGURA 23: AUTORIZAÇÕES GERAIS POR USUÁRIO .......................................................................................................................... 38

FIGURA 24: DETALHES DA EMPRESA ................................................................................................................................................ 40

FIGURA 25: EXEMPLO DE MAIS DE UMA BASE NO SBO.................................................................................................................... 41

FIGURA 26: CONFIGURAÇÕES GERAIS .............................................................................................................................................. 42

FIGURA 27: CONTAS BANCÁRIAS DA EMPRESA ................................................................................................................................ 43

FIGURA 28: FORMA DE PAGAMENTO ............................................................................................................................................... 46

FIGURA 29: ESCOLHA DA CONTA BANCÁRIA DA EMPRESA .............................................................................................................. 48

FIGURA 30: PROPRIEDADES DO BOLETO .......................................................................................................................................... 48

FIGURA 31: LISTA DE CARTEIRAS ...................................................................................................................................................... 49

FIGURA 32: CADASTRAR CARTEIRA ................................................................................................................................................... 50

FIGURA 33: OPÇÃO PARA APROVAÇÃO ............................................................................................................................................ 50

FIGURA 34: ESCOLHER UMA DLL ...................................................................................................................................................... 51

FIGURA 35: CAMINHO PARA INSERIR A DLL ..................................................................................................................................... 51

FIGURA 36: PARÂMETROS DO BANKSYNC ........................................................................................................................................ 52

FIGURA 37: NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................................................................ 54

FIGURA 38: GRADE PARA DEFINIÇÕES DA NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................ 55

FIGURA 39: MODELO DE EXEMPLO .................................................................................................................................................. 57

FIGURA 40: LEIAUTE DE ARQUIVO DE REMESSA .............................................................................................................................. 59

FIGURA 41: LEIAUTE DE REMESSA – GRADE DE REGISTROS ............................................................................................................. 61

FIGURA 42: LEIAUTE DE REMESSA – SETAS DE MOBILIDADE ........................................................................................................... 62

FIGURA 43 TELA DE DEFINIÇÃO DE REGISTRO .................................................................................................................................. 62

FIGURA 44: DEFINIÇÃO DO CAMPO TEXTO FIXO .............................................................................................................................. 64

FIGURA 45: CONFIGURAÇÃO DA POSIÇÃO PARA CÓDIGO DE BARRAS ............................................................................................ 66

FIGURA 46 DEFINIÇÃO DO CAMPO DATABASE ................................................................................................................................. 67

8


FIGURA 48: DEFINIÇÃO DO CAMPO CATEGORIA .............................................................................................................................. 69


FIGURA 50: CONFIGURAÇÃO DA COLUNA CONDIÇÃO E VALOR ....................................................................................................... 72

FIGURA 51: DEFINIÇÃO DO CAMPO SQL SELECT............................................................................................................................... 73


FIGURA 53: LEIAUTE DE ARQUIVO DE RETORNO .............................................................................................................................. 76

FIGURA 54: LEIAUTE DE ARQUIVO DE RETORNO, CABEÇALHO ........................................................................................................ 77

FIGURA 55: ARQUIVO DE RETORNO ................................................................................................................................................. 77

FIGURA 56: LEIAUTE DE ARQUIVO DE RETORNO TÍTULO ................................................................................................................. 78

FIGURA 57: ARQUIVO DE RETORNO ................................................................................................................................................. 78

FIGURA 58: DETALHES DA EMPRESA IDENTIFICAÇÃO DA EMPRESA ................................................................................................ 79

FIGURA 59: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAÇÃO DO DOCUMENTO ....................................................................... 79

FIGURA 60: ARQUIVO DE RETORNO CHAVE ÚNICA .......................................................................................................................... 80

FIGURA 61: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAÇÃO ALTERNATIVA............................................................................. 80

FIGURA 62: PREENCHIMENTO DO CAMPO NOSSO NÚMERO........................................................................................................... 81

FIGURA 63: IDENTIFICAÇÃO ESPECIAL .............................................................................................................................................. 83

FIGURA 64: LEIAUTE DE ARQUIVO DE RETORNO - OCORRÊNCIAS ................................................................................................... 84

FIGURA 65: CÓDIGOS DE OCORRÊNCIAS .......................................................................................................................................... 85

FIGURA 66: LEIAUTE DE RETORNO – CUSTOMIZAÇÃO DA OCORRÊNCIA ......................................................................................... 87

FIGURA 67: LEIAUTE DE RETORNO – CUSTOMIZAÇÃO DA AÇÃO ..................................................................................................... 87

FIGURA 68: LEIAUTE DE RETORNO – AJUDA NA CUSTOMIZAÇÃO .................................................................................................... 88

FIGURA 69: LEIAUTE DE RETORNO – BOTÃO SUB OCORRÊNCIAS .................................................................................................... 89

FIGURA 70: LEIAUTE DE ARQUIVO DE RETORNO - COBRANÇA ........................................................................................................ 90

FIGURA 71: TIPO DE COBRANÇA PADRÃO ........................................................................................................................................ 91

FIGURA 72: LEIAUTE DE ARQUIVO DE RETORNO ERRO .................................................................................................................... 92

FIGURA 73: OCORRÊNCIAS DE ERROS, MANUAL DO BANCO ........................................................................................................... 93

FIGURA 74: LEIAUTE DE ARQUIVO DE RETORNO VALIDAÇÃO .......................................................................................................... 94

FIGURA 75: LEIAUTE DE ARQUIVO DE EXTRATO CNAB ..................................................................................................................... 97

FIGURA 76 LEIAUTE DE EXTRATO BANCÁRIO CNAB REGISTRO / IDENTIFICAÇÃO ............................................................................ 98

FIGURA 77: EXTRATO BANCÁRIO CNAB ............................................................................................................................................ 98

FIGURA 78: FORMATO DE VALOR ................................................................................................................................................... 100

FIGURA 79: FORMATO DO TIPO DE LANÇAMENTO ........................................................................................................................ 101

FIGURA 80: TELA DA ABA SERVIÇO ................................................................................................................................................. 102

FIGURA 81: CADASTRO DE CÓDIGOS E DESCRIÇÕES PARA SERVIÇOS DE EXTRATO BANCÁRIO ..................................................... 103

FIGURA 82: NOTA FISCAL DE SAÍDA ................................................................................................................................................ 105

FIGURA 83: LCM DA NOTA FISCAL DE SAÍDA .................................................................................................................................. 105

FIGURA 84: CONTAS A RECEBER ..................................................................................................................................................... 106

FIGURA 85: TELA DE MEIO DE PAGAMENTO .................................................................................................................................. 107

FIGURA 86: ASSISTENTE DE EXPORTAÇÃO - APRESENTAÇÃO ......................................................................................................... 108

FIGURA 87: CONFIGURAÇÃO DO TIPO DE DOCUMENTO................................................................................................................ 109

FIGURA 88: CONFIGURAÇÃO DO FILTRO DE DATA ......................................................................................................................... 109

FIGURA 89: CONFIGURAÇÃO DO FILTRO DE STATUS DO DOCUMENTO ......................................................................................... 109

FIGURA 90: CONFIGURAÇÃO DO FILTRO DE PAGAMENTOS ........................................................................................................... 110

FIGURA 91: CONFIGURAÇÃO DO FILTRO DE SITUAÇÃO DO DOCUMENTO .................................................................................... 110

FIGURA 92: CONFIGURAÇÃO DO FILTRO DE FORMA DE PAGAMENTO .......................................................................................... 110

FIGURA 93: CONFIGURAÇÃO DO FILTRO FILIAL .............................................................................................................................. 110

FIGURA 94: CONFIGURAÇÃO DO FILTRO DE TIPO DE TRANSAÇÃO ................................................................................................ 111

FIGURA 95: CONFIGURAÇÃO DO FILTRO DE CONTAS A PAGAR ..................................................................................................... 111

9

FIGURA 96: ALERTA ......................................................................................................................................................................... 112

FIGURA 97: ASSISTENTE DE EXPORTAÇÃO - ESCOLHA DOS TÍTULOS.............................................................................................. 112

FIGURA 98: ASSISTENTE DE EXPORTAÇÃO – RESULTADOS ............................................................................................................. 114

FIGURA 99: ASSISTENTE DE IMPORTAÇÃO – APRESENTAÇÃO........................................................................................................ 115

FIGURA 100: ASSISTENTE DE IMPORTAÇÃO – FILTRAGEM ............................................................................................................. 116

FIGURA 101: ASSISTENTE DE IMPORTAÇÃO – ABA AUTOMÁTICA ................................................................................................. 117

FIGURA 102: CONFIGURAÇÃO DO TIPO DE COBRANÇA ................................................................................................................. 118

FIGURA 103: CONTA CONTÁBIL – PARCEIRO DE NEGÓCIOS ........................................................................................................... 118

FIGURA 104: CONTA CONTÁBIL – CONTAS BANCÁRIAS DA EMPRESA ........................................................................................... 118

FIGURA 105: ASSISTENTE DE IMPORTAÇÃO – TELA DE RESULTADOS DA IMPORTAÇÃO DO ARQUIVO ......................................... 119

FIGURA 106: STATUS REPLICADO ................................................................................................................................................... 120

FIGURA 107: OCORRÊNCIAS NAS COLUNAS MOTIVO E INFORMAÇÕES ADICIONAIS ..................................................................... 120

FIGURA 108: ASSISTENTE DE IMPORTAÇÃO – ABA MANUAL ......................................................................................................... 121

FIGURA 109: ASSISTENTE DE IMPORTAÇÃO – ABA NÃO IDENTIFICADO ........................................................................................ 122

FIGURA 110: ASSISTENTE DE IMPORTAÇÃO – RESULTADOS .......................................................................................................... 122

FIGURA 111: ASSISTENTE PARA EXTRATOS CNAB - APRESENTAÇÃO.............................................................................................. 123

FIGURA 112: ASSISTENTE PARA EXTRATOS CNAB - FILTRAGEM ..................................................................................................... 124

FIGURA 113: ASSISTENTE PARA EXTRATOS CNAB - AUTOMÁTICA ................................................................................................. 126

FIGURA 114: ASSISTENTE PARA EXTRATOS CNAB– MANUAL ......................................................................................................... 127

FIGURA 115: ASSISTENTE PARA EXTRATOS CNAB– NÃO-IDENTIFICADOS ...................................................................................... 127

FIGURA 116: ASSISTENTE PARA EXTRATOS CNAB - RESULTADOS .................................................................................................. 128

FIGURA 117: PROCESSAR EXTRATO BANCÁRIO EXTERNO .............................................................................................................. 129

FIGURA 118: BOLETOS POR DDA – APRESENTAÇÃO ....................................................................................................................... 130

FIGURA 119: BOLETOS POR DDA – PARAMETRIZAÇÃO .................................................................................................................. 131

FIGURA 120: BOLETOS POR DDA – IMPORTAÇÃO DO ARQUIVO .................................................................................................... 131

FIGURA 121: BOLETOS POR DDA – FILTRO DO ADMINISTRADOR .................................................................................................. 132

FIGURA 122: BOLETOS POR DDA – ADMINISTRADOR DE BOLETOS ................................................................................................ 133

FIGURA 123: TRANSFERÊNCIAS BANCÁRIAS – MEIO DE PAGAMENTO .......................................................................................... 134

FIGURA 124: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – FILTROS ............................................................................ 135

FIGURA 125: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – FORMA DE PAGAMENTO SUGERIDA ................................ 136

FIGURA 126: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – PREENCHIMENTO DA FORMA DE PAGAMENTO .............. 137

FIGURA 127: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – FORMA DE PAGAMENTO UTILIZADA ............................... 137

FIGURA 128: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – FORMA DE PAGAMENTO NÃO SUGERIDA ....................... 138

FIGURA 129: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – SELEÇÃO DA FORMA DE PAGAMENTO ........................... 138

FIGURA 130: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – ATUALIZAÇÃO DA FORMA DE PAGAMENTO .................... 139

FIGURA 131: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – CAMPOS ADICIONAIS ....................................................... 139

FIGURA 132: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS – OBSERVAÇÕES DO DIÁRIO ............................................... 140

FIGURA 133: ASSISTENTE DE PARAMENTO PARA TRANSFERÊNCIAS – REFERÊNCIA DO MEIO DE PAGAMENTO .......................... 140

FIGURA 134: ADMINISTRAÇÃO DE TRANSFERÊNCIAS - FILTRO ...................................................................................................... 141

FIGURA 135: ADMINISTRAÇÃO DE TRANSFERÊNCIAS - ADMINISTRAÇÃO...................................................................................... 142

FIGURA 136: ASSISTENTE DE PAGAMENTO PARA TRANSFERÊNCIAS - PROCESSO ......................................................................... 143

FIGURA 137: CARTÃO DE CRÉDITO – PARÂMETROS ....................................................................................................................... 145

FIGURA 138: CARTÃO DE CRÉDITO – LEIAUTE DE RETORNO (IDENTIFICAÇÃO).............................................................................. 146

FIGURA 139: CARTÃO DE CRÉDITO – ARQUIVO EXEMPLO ............................................................................................................. 147

FIGURA 140: CARTÃO DE CRÉDITO – ABA VALIDAÇÃO ................................................................................................................... 147

FIGURA 141: CARTÃO DE CRÉDITO – LEIAUTE DE RETORNO (VALIDAÇÃO) .................................................................................... 148

FIGURA 142: CARTÃO DE CRÉDITO – FORMA DE PAGAMENTO ..................................................................................................... 149

FIGURA 143: CARTÃO DE CRÉDITO – LEIAUTE NORMAL................................................................................................................. 150

FIGURA 144: CARTÃO DE CRÉDITO – LEIAUTE DE VANS ................................................................................................................. 151

10

FIGURA 145: CARTÃO DE CRÉDITO – MENSAGEM DE MIGRAÇÃO ................................................................................................. 151

FIGURA 146: CARTÃO DE CRÉDITO – IMPORTAR LEIAUTE .............................................................................................................. 152

FIGURA 147: CARTÃO DE CRÉDITO – IDENTIFICAÇÃO VANS .......................................................................................................... 153

FIGURA 148: CARTÃO DE CRÉDITO – ARQUIVO VANS .................................................................................................................... 153

FIGURA 149: CARTÃO DE CRÉDITO – IDENTIFICAÇÃO DE VALORES VANS...................................................................................... 153

FIGURA 150: CARTÃO DE CRÉDITO – MEIO DE PAGAMENTO ......................................................................................................... 155

FIGURA 151: CARTÃO DE CRÉDITO – DEPÓSITO EM ABERTO ......................................................................................................... 155

FIGURA 152: CARTÃO DE CRÉDITO – IMPORTAÇÃO DO RETORNO ................................................................................................ 156

FIGURA 153: CARTÃO DE CRÉDITO – IMPORTAÇÃO DO RETORNO (IDENTIFICAÇÃO) .................................................................... 157

FIGURA 154: CARTÃO DE CRÉDITO – ADMINISTRADOR ................................................................................................................. 158

FIGURA 155: CARTÃO DE CRÉDITO – MENSAGEM DE VÍNCULO ..................................................................................................... 158

FIGURA 156: DEFINIÇÃO DO REGISTRO - DATABASES .................................................................................................................... 160

FIGURA 157: DEFINIÇÃO DO CAMPO – BASE DE DADOS (DATABASES) .......................................................................................... 161

FIGURA 158: PROCESSO DE EXECUÇÃO DE UMA DLL ..................................................................................................................... 176

FIGURA 159: FLUXO DE CHAMADAS DO BUSINESS ONE ................................................................................................................ 177

FIGURA 160: MENSAGEM DE ERRO DA DLL. ................................................................................................................................... 177

FIGURA 161: CONFIGURAÇÃO DA FORMA DE PAGAMENTO .......................................................................................................... 182

FIGURA 162: CONFIGURAÇÕES ESPECÍFICAS DO BOLETO .............................................................................................................. 182

FIGURA 163: CAMINHO DO ONESHARE .......................................................................................................................................... 201

FIGURA 164: TELA INICIAL DA EXPORTAÇÃO DE LEIAUTES ............................................................................................................. 202

FIGURA 165: TELA INFORMANDO O CAMINHO PARA SALVAR O ARQUIVO DE LEIAUTE ............................................................... 203

FIGURA 166: TELA DE SELEÇÃO DE LEIAUTES A SEREM EXPORTADOS ........................................................................................... 203

FIGURA 167: CAMINHO DO ONESHARE .......................................................................................................................................... 204

FIGURA 168: TELA INICIAL DA EXPORTAÇÃO DE LEIAUTES ............................................................................................................. 205

FIGURA 169: TELA QUE INFORMARÁ O CAMINHO ONDE FOI SALVO O ARQUIVO DE LEIAUTE ..................................................... 205

FIGURA 170: TELA DE SELEÇÃO DE LEIAUTES A SEREM IMPORTADOS ........................................................................................... 206

FIGURA 171: TELA DE CORREÇÃO DE INFORMAÇÕES REFERENTES AOS LEIAUTES A SEREM IMPORTADOS ................................. 207

FIGURA 172: TELA DE FINALIZAÇÃO DE IMPORTAÇÃO DE LEIAUTES.............................................................................................. 208

FIGURA 173: CAMINHO PARA ACESSO ÁS CONFIGURAÇÕES SERASA ............................................................................................ 209

FIGURA 174: CONFIGURAÇÕES SERASA / ABA CONFIGURAÇÃO .................................................................................................... 209

FIGURA 175: CONFIGURAÇÕES SERASA / ABA PERMISSÕES DE ACESSO ....................................................................................... 210

FIGURA 176: CONFIGURAÇÕES SERASA / ABA INFORMAÇÕES ...................................................................................................... 211

FIGURA 177: CONFIGURAÇÕES SERASA / ABA INFORMAÇÕES / CONSULTA DE SALDO ................................................................ 211

FIGURA 178: CONSULTAS SERASA .................................................................................................................................................. 212

FIGURA 179: CONSULTAS SERASA / NOVA CONSULTA SERASA ...................................................................................................... 213

FIGURA 180: TELA DE CONSULTA COMPLETA SERASA ................................................................................................................... 214

FIGURA 181: BOTÃO DE CONSULTA SERASA .................................................................................................................................. 214

FIGURA 182: ADD-ON SETTINGS – PARÂMETROS DO BANKSYNC .................................................................................................. 215

FIGURA 183: CONTAS BANCÁRIAS DA EMPRESA – CONFIGURAÇÃO DAS CONTAS ........................................................................ 216

FIGURA 184: LANÇAMENTO CONTÁBIL MANUAL – LANÇAMENTOS EXTRAS ................................................................................. 217

FIGURA 185: PAINEL DE CONTROLE – BOTÃO BACKUP LAYOUT .................................................................................................... 218

FIGURA 186: PAINEL DE CONTROLE – CAMINHO DO BACKUP ....................................................................................................... 218

FIGURA 187: CONFIGURAÇÃO DO BANKSYNC - ACESSO RESTRITO ................................................................................................ 219

FIGURA 188: CONFIGURAÇÃO DO BANKSYNC – ADDON SETTINGS ............................................................................................... 219

FIGURA 189: MENU B1 – NOVA OPÇÃO ......................................................................................................................................... 220

FIGURA 190: PAINEL DE CONTROLE - CONEXÃO ............................................................................................................................ 221

FIGURA 191: MENU B1 – ADMINISTRADOR DE BACKUP LAYOUTS ................................................................................................ 221

FIGURA 192: GERADOR DE CONSULTAS – TABELA DE BACKUPS .................................................................................................... 222

FIGURA 193: IMPRESSÃO DE BOLETOS – PAINEL DE CONTROLE .................................................................................................... 223

11

FIGURA 194: IMPRESSÃO DE BOLETOS – REGISTRO DE RELATÓRIOS ............................................................................................. 223

FIGURA 195: IMPRESSÃO DE BOLETOS – PARÂMETRO DE ATIVAÇÃO ........................................................................................... 224

FIGURA 196: IMPRESSÃO DE BOLETOS – BOTÃO “GERAR BOLETO” .............................................................................................. 225

FIGURA 197: IMPRESSÃO DE BOLETOS – FORMA DE PAGAMENTO DO PARCEIRO ........................................................................ 226

FIGURA 198: IMPRESSÃO DE BOLETOS – FORMA DE PAGAMENTO DA NF .................................................................................... 226

FIGURA 199: IMPRESSÃO DE BOLETOS – BOLETO IMPRESSO......................................................................................................... 227

FIGURA 200: IMPRESSÃO DE BOLETOS – CONTAS A RECEBER ....................................................................................................... 228

FIGURA 201: IMPRESSÃO DE BOLETO – IMPRIMIR BOLETO NO CR ................................................................................................ 229

FIGURA 202: IMPRESSÃO DE BOLETOS – SELEÇÃO DE LEIAUTES ................................................................................................... 229

FIGURA 203: GERAÇÃO DE BOLETOS EM LOTE – TELA PRINCIPAL ................................................................................................. 230

FIGURA 204: GERAÇÃO DE BOLETOS EM LOTE – SELEÇÃO DA FP .................................................................................................. 230

FIGURA 205: GERAÇÃO DE BOLETOS EM LOTE – MENSAGEM DE SUCESSO .................................................................................. 231

FIGURA 206: GERAÇÃO DE BOLETOS EM LOTE – IMPRESSÃO DOS BOLETOS................................................................................. 231

Índice de Tabelas

TABELA 1: AUTORIZAÇÕES PARA USUÁRIOS DO BANKSYNC ............................................................................................................ 39

TABELA 2: CHAVES DOS BOLETOS DAS EMPRESAS DO GRUPO ALGODÃO S.A ................................................................................. 42

TABELA 3: ESTRUTURA DOS DADOS DO CÓDIGO DE BARRAS ........................................................................................................ 178

TABELA 4: EXEMPLO DE PREENCHIMENTO DOS CAMPOS LIVRES .................................................................................................. 179

TABELA 5: FORMATAÇÃO DOS DADOS DA LINHA DIGITÁVEL ......................................................................................................... 180

TABELA 6: CAMPOS DA TABELA CONTAS BANCÁRIAS DA EMPRESA .............................................................................................. 180

TABELA 7: CAMPOS DA TABELA FORMAS DE PAGAMENTO ........................................................................................................... 181

12

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.

13

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. Débito automático

Débito automático é um serviço de cobrança bancária que possibilita as empresas cobrar

valores, podendo ser recorrentes ou não, como serviços de assinaturas de jornal, por meio de

débitos realizados de forma automatizada em dias pré-determinados na conta dos seus clientes.

Dentre as informações trocadas estão os dados dos débitos a serem realizados nas contas

dos clientes da empresa, que também são clientes do banco, e os dados de manutenção dos

clientes optantes por débito automático.

14

2.3. 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.

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.

15

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

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.

16

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 status 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 status 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 status de

aprovação, para que então ele seja aprovado, utilizado e impresso.

Quando um boleto é gerado com o status 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 status 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.

Quando um boleto passa para o status 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”.

17

Partindo do primeiro caso, em que o boleto é criado inicialmente como Gerado, o status 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 status dos 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 status 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 status 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 status, 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

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

18

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 status 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

status Gerado.

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.

19

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 status 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 status 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

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.

20

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 status 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 nesta situação pode ser deslocado para os outros dois status, Pago e

Cancelado.

3.3.2 Pago

O status 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 status Gerado e passá-lo posteriormente para Cancelado.

Passar o boleto para o status 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.

21

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.

22

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 status, similares aos de boletos de Contas a Pagar. Quando uma nova transferência é

criada, ela se encontra no status 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.

23

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.

24

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 Info no seguinte link:

http://www.sistemainfo.com.br/atendimento/service-desk/acesso-remoto.

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 Info para com o VAR será por meio

de chamados, que poderão ser cadastrados no site da Sistema Info utilizando um login e senha,

cadastrados pela própria equipe de Suporte SAP para o VAR.

http://www.sistemainfo.com.br/atendimento/service-desk/acesso-remoto

25

4.4. Ajuda

No menu superior do SAP Business One, acessando Ajuda | Sobre BankSync será

apresentada a tela abaixo referenciada na Figura 7:

Figura 7: Tela Sobre BankSync

Na tela de ajuda do BankSync, o usuário poderá acessar algumas informações a respeito

do produto como:

Atualizações

Ao clicar no botão Atualizações, o usuário será redirecionado para o seguinte link:

http://www.sistemainfo.com.br/manuais onde estará disponível todos os conteúdos referentes a

atualizações e releases do add-on (Figura 8).

http://www.sistemainfo.com.br/manuais

26

Figura 8: Tela de Atualizações do BankSync

Manuais e FAQ

Será encaminhado para o seguinte link: http://www.sistemainfo.com.br/manuais, que

utilizando os dados: Usuário - sap e Senha - sistema, terá acesso a todos os FAQs e Manuais do

add-on (Figura 9).

Figura 9: Tela de acesso a FAQs e Manuais do BankSync

http://www.sistemainfo.com.br/manuais

27

Suporte Técnico

Encaminhará o usuário ao seguinte link:

http://suporte.sistemainfo.com.br/suporte/index.php, que deverá utilizar seus dados de acesso

para abertura de chamados técnicos (Figura 10).

Figura 10: Tela de acesso ao Suporte Técnico do BankSync

Download

Direcionará o usuário para a página de download do BankSync, no seguinte link:

http://www.sistemainfo.com.br/atendimento/downloads/atualizacoes/banksync, onde terá

disponível a última versão do add-on para o SAP Business One versão 8.81, 8.82 e 9.0,

juntamente com o pacote completo das DLLs (Figura 11).

http://suporte.sistemainfo.com.br/suporte/index.php

http://www.sistemainfo.com.br/atendimento/downloads/atualizacoes/banksync

28

Figura 11: Tela do Site da Sistema Info - Downloads

Alterar licença

Será apresentada a tela de ativação da chave para o usuário (Figura 12). A tela estará

informando a chave atual do sistema, e caso o usuário deseje altera-la, basta sobrescrever a

chave existente e clicar em “Ativar”.

Figura 12: Tela de ativação do BankSync

29

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:


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.

2 Site SIE: www.sistemainfo.com.br

3 Free: Licença Free;


30

5.2. Registro do Add-On no SBO

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 13: Registrando o add-on no SBO

Nesta tela, demonstrada na Figura 13, 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.

31

Figura 14: 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 14 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.

32

Figura 15: 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 16) solicita informações

com relação à empresa do usuário, enquanto que a segunda (Figura 17) 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.

33

Figura 16: Instalação – Informações do usuário

Figura 17: Instalação – Caminho da instalação

34

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 18, 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 18: 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 19 demonstra a tela:

35

Figura 19: 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 20 mostra um exemplo da tela em questão:

Figura 20: 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 21. O campo da chave de ativação é o único no qual o

usuário deverá preencher dados.

OBS: Os campos que estão à esquerda da figura deverão ser ignorados por hora.

36

Caso o usuário não possua uma chave de ativação, este deverá entrar em contato com a

Sistema Info 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 21: Chave de ativação

OBS: Para ambientes OnDemand, a ativação será por base de dados, onde será validado

por CNPJ. Possui também uma validação da quantidade de licenças SAP do BankSync que estão

atribuídas para o determinado servidor/CNPJ.

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.

37

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:

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. Figura 22 demonstra este procedimento, utilizando no exemplo o usuário

manager.

Figura 22: Selecionando licença para um usuário

https://websmp104.sap-ag.de/smb/sbo/licensekeys

38

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

gerenciadas ficam em Módulos | Administração | Inicialização do sistema | Autorizações |

Autorizações gerais. Vide Figura 23 para um exemplo desta tela:

Figura 23: 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.

39

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

Este primeiro grupo de configurações expõe particularidades que devem ser tratadas em

telas do próprio SAP Business One.

40

6.1.1 Detalhes da empresa

Esta tela abaixo (Figura 24) 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 24: 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 25. Supondo que cada uma destas

bases hipotéticas gerasse remessas de boletos para um banco em comum; no momento em que

41

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 25: 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.

42

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 26: Configurações Gerais

43

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 27), acesse: Módulos | Administração |

Configurações | Banco | Contas bancárias da empresa.

Figura 27: 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:

44

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

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.

4 Para maiores detalhes sobre como deve ser feito o preenchimento do campo Nosso Número, consulte o capítulo

referente às DLL’s.

45

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.

Filial – U_Branch

5 Pressione TAB sobre ele, com o Add-on iniciado, para chamar uma Choose From List com a sugestão de valores;

46

Neste campo o usuário poderá selecionar a filial que deseja utilizar os dados para

exportação no arquivo de remessa. Caso o campo estiver em branco, os dados do cedente

sempre serão da Matriz.

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

28 para auxiliar na identificação dos campos:

Figura 28: Forma de pagamento

47

Código da forma de pagamento – PayMethCod

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 29, irá aparecer permitindo-lhe escolher uma conta.

48

Figura 29: 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 30).

Figura 30: Propriedades do boleto

49

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 31.

Figura 31: Lista de Carteiras

50

Clicando para editar, ou criar um novo registro, aparecerá à tela presente na Figura 32.

Figura 32: Cadastrar carteira

Enviar para aprovação – SendAccept

Quando esta opção estiver marcada (Figura 33), 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 33: 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.

51

Algoritmo do código de barras – BoeDLL

Este campo (Figura 34) 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 34: 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 34, e informe o caminho até sua DLL na tela que

aparece (Figura 35). 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 35: 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).

52

6.1.4.1 Parâmetros do BankSync

Ao clicar sobre o botão , que estará disponível apenas com o add-on

BankSync conectado, uma tela contendo algumas informações que são de relevância para o

BankSync será apresentada. Uma amostra da tela se encontra abaixo na Figura 36:

Figura 36: Parâmetros do BankSync

Segue abaixo o detalhamento de alguns campos contidos na tela acima:

Número sequencial da remessa: é automaticamente incrementada toda vez que

uma remessa, utilizando aquela forma de pagamento, é realizada;

53

Número sequencial do lote: é automaticamente incrementada toda vez que uma

remessa com lotes, utilizando aquela forma de pagamento, é realizada;

Leiautes (Retorno – Remessa – Retorno de cartão de crédito – Impressão de

boletos): parametrizado os leiautes que serão utilizados para cada processo,

executado pela forma de pagamento configurada;

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;

Conta contábil para despesas: é a conta (Débito) que deve ser utilizada para

aquela forma de pagamento, quando um boleto apresentar uma despesa em

cartório. A outra conta (Crédito) utilizada é a Conta bancária provisória, da tela de

Contas bancárias da empresa;

Sobrescrever contas contábeis: as contas parametrizadas nestes campos

sobrescreverão as contas parametrizadas em Determinação de contas contábeis

(Business One) e no Parceiro de negócios (Business One);

Débito automático: Quando selecionado classificará a forma de pagamento como

sendo de débito automático, após utilizada a forma de pagamento não será possivél

marcar ou desmarcar esta opção.

Código CIRT: os campos listados são específicos para geração do código CIRT,

que é impresso apenas no leiaute B do banco Santander;

OBS: os campos contidos em “Sobrescrever contas contáveis” devem ser alterados em

casos muito específicos, pois a má configuração destes poderá causar inconsistências em sua

contabilidade.

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.

54

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 37.

Figura 37: Nomenclatura de arquivo de remessa

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.

55

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 38: Grade para definições da Nomenclatura de arquivo de remessa

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.

56

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;

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.

57

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.

Visualizando o modelo de exemplo

Figura 39: Modelo de exemplo

Esta tela apresenta uma funcionalidade que permite ao usuário verificar como será gerada

a nomenclatura do arquivo.

58

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 40, que ilustra a estrutura de um arquivo de remessa e analisaremos o

que significa para cada tipo de campo mostrado nesta tela:

59

Figura 40: 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


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.

Nomenclatura - U_Filename

Campo que vincula o leiaute de nomenclatura com o leiaute de remessa em questão.

60

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

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

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;

61

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 Figura 41, 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é:

Figura 41: Leiaute de Remessa – Grade de registros

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.

62

No canto superior direto da tela de configuração do leiaute de remessa, possui duas setas

(Figura 42) onde permitirá ao usuário mover as linhas de registros já cadastradas no leiaute.

Figura 42: Leiaute de Remessa – Setas de mobilidade

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 43.

Figura 43 Tela de Definição de Registro

63

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.

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

64

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 44), que serão abordadas abaixo:

Figura 44: Definição do campo texto fixo

65

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

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

66

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 45.

Figura 45: 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,


67

Figura 46 Definição do campo database

Campo – Name



Propriedades Gerais

Tipo - U_Type



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)

68

8 - Hora (ddmmaaaa)


(0) - Esquerda

(1) - Direita


(*) - Zero

(0) - Espaço

(_) - Underscore

(-) - Hifen




Espaço.









69


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 48: Definição do campo categoria

Campo – Name



70

Propriedades Gerais

Tipo - U_Type



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)


(0) - Esquerda

(1) - Direita


(*) - Zero

(0) - Espaço

(_) - Underscore

(-) - Hifen

OBS: quando o campo for de formato Numérico, Decimal 2, Decimal 5, o seu


Alfanumérico, Alfabético ou Livre o seu alinhamento e preenchimento devem ser: Esquerda +

Espaço.

71










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

72

1 - Menor que

2 - Igual a

3 - Diferente de

4 - Maior que

5 - Maior que ou igual a

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 50.

Figura 50: 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,


73

Figura 51: Definição do campo SQL Select

Campo – Name



Propriedades Gerais

Tipo - U_Type



Formato - U_Format

0 - Livre

1 - Alfabético

2 - Alfanumérico

3 - Numérico

74

4 - 2 Decimais

5 - 5 Decimais

6 - Data (aaaammdd)

7 - Data (ddmmaa)

8 - Hora (ddmmaaaa)


(0) - Esquerda

(1) - Direita


(*) - Zero

(0) - Espaço

(_) - Underscore

(-) - Hifen




Espaço.








75


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 53) 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,

76

Figura 53: 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


Nome – Name


Tipo de Doc. - U_PayType

Para qual tipo de transação esse leiaute será: Contas a Pagar, Contas a Receber ou DDA.

77

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 54).

Figura 54: Leiaute de arquivo de retorno, Cabeçalho

Figura 55: Arquivo de retorno

78

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 55).

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 56: Leiaute de arquivo de retorno Título

Figura 57: 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 57), ou seja,

79

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 58), 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 60), 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 59).

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.

Figura 58: Detalhes da empresa Identificação da Empresa

Figura 59: Leiaute de arquivo de retorno Identificação do Documento

80

Figura 60: 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

O BankSync possui um outro tipo de identificação, chamada Identificação Alternativa,

que utiliza alguns campos para ler o arquivo de retorno: Portfólio, Nosso Número, Dígito e

Número da Nota Fiscal (Serial).

Para que o add-on identifique o arquivo corretamente, as informações parametrizadas na

identificação alternativa devem estar de acordo com a base de dados, pelo contrário, 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.

Caso o usuário deseje identificar o arquivo apenas pelo Nosso Número por exemplo, deve-

se preencher este campo conforme sua posição e tamanho no arquivo de retorno, e os demais

campos devem conter “0”. Veja o exemplo abaixo para configuração da identificação Alternativa

(Figura 61).

Figura 61: Leiaute de arquivo de retorno Identificação Alternativa

81

Os campos Nosso Número e Dígito são utilizados não só para identificação, mas também

para preenchimento do campo Nosso Número, encontrado na tela de Boletos – Contas a

receber (Figura 62). Caso o usuário deseje preencher ou atualizar a informação contida neste

campo, devem-se configurar os campos citados acima para que o add-on atualize-os conforme

contidos no arquivo de retorno.

Figura 62: Preenchimento do campo Nosso Número

OBS: Este processo de atualização será possível apenas se a Forma de pagamento que

esta sendo utilizada no processo, esteja configurada com a DLL Dummy (Verificar funcionalidade

da DLL no capítulo de particularidades das DLLs).

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.

82

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.

Tamanho - U_OurNmSiz

Informar o tamanho do nosso número.

Linha - U_OurNmLin


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


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.

83

Tamanho - U_SerialS

Informar o tamanho do dígito verificador do nosso número.

Linha - U_SerialL


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 63).

Figura 63: Identificação Especial

Tabela - U_SpecTbl

Informar a tabela na qual o usuário deseja fazer a identificação especial.

OBOE - Boletos

@SIEBS_OTRF - Transferências

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.

84

0 - Alfanumérico

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 64).

Figura 64: Leiaute de arquivo de retorno - Ocorrências

85

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


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.

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 65).

Figura 65: Códigos de Ocorrências

86

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 65).

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

toma a ação de Pagar, por exemplo, assim sendo, sempre que algum documento vir com a

ocorrência XX ele será movimentado para a gaveta de Pagamento, na administração de boletos

do Business One.

Abaixo segue as ocorrências disponíveis para movimentação de títulos:

0 – Nenhuma: não movimenta o título;

1 – Depositar: move o título para gaveta Depositado;

2 – Pagar: move o título para gaveta de Pagamento;

3 – Cancelar: move o título para gaveta de Cancelado;

4 – Falhar: move o título para gaveta de Sem Êxito;

5 – Gerado: move o título para gaveta de Gerado;

6 – Reconciliar: move o título para gaveta de Pagamento e reconcilia

automaticamente;

7 – Somente Tarifa: reconhece a linha de título como tarifa bancária;

8 – Alterar Vencimento: altera a data de vencimento atual do boleto, para a nova

data retornada no arquivo;

99 – Customizado

O botão Customizar que se encontra no inferior da tela (mesma ação 99 citada acima)

necessitará de uma condição para definir a ação de um título.

87

Figura 66: Leiaute de retorno – Customização da ocorrência

Selecionando uma linha de ocorrência e clicando no botão Customizar, a tela de

parametrização (Figura 67) irá aparecer.

Figura 67: Leiaute de retorno – Customização da ação

As variáveis disponíveis para uso na condição ficam na coluna do lado direito da tela. Ao

clicar na variável, sua nomenclatura será inserida automaticamente na tela no lado esquerdo,

88

onde é parametrizada a condição. Para auxiliar na formação da condição, o botão Ajuda

disponibiliza alguns exemplos (Figura 68):

Figura 68: Leiaute de retorno – Ajuda na Customização

No exemplo configurado na Figura 67, a condição exerce a seguinte finalidade:

%BoeSum% > 100 ? 2 : 1

Caso o Valor do Boleto (%BoeSum%) for Maior (>) que 100 (R$ 100,00), ele atualizará o

status do boleto para 2 (status de Pago), caso contrário assumirá 1 (status de Depositado).

Portanto a funcionalidade acima servirá caso em uma única ocorrência, você precise

utilizar mais de uma ação para tal, caso existe uma condição como a citada no exemplo acima;

Na mesma tela de leiaute de retorno, o botão Sub Ocorrências permitirá ao usuário

cadastrar sub ocorrências de acordo com o manual do banco, caso elas existam dentro de

determinadas ocorrências (Figura 69).

89

Figura 69: Leiaute de retorno – Botão Sub Ocorrências

Para configurar uma sub ocorrência, o usuário deve selecionar a linha de uma ocorrência e

clicar em seguida no botão informado. Na mesma tela uma grade ficará disponível, tendo então

que cadastra-las de acordo com o manual, da mesma maneira que são cadastradas as

ocorrências atualmente.

OBS: as ocorrências e sub ocorrências não podem estar na mesma posição no arquivo de

retorno.

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 70 referencia a aba Cobrança, possuindo alguns campos para configuração,

que serão vistos a seguir.

90

Figura 70: Leiaute de arquivo de retorno - Cobrança

Posição

Deve ser preenchida a posição de início do campo cobrança.

Tamanho

Informar o tamanho do campo cobrança.

Linha


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 71.

91

Figura 71: 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


banco.

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 72).

92

Figura 72: Leiaute de arquivo de retorno Erro

Campo

Posição - U_ErFd1Pos

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).

93

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 73):

Figura 73: 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


banco.

6.2.3.5 Validação Boletos

Na tela de validação (Figura 74), 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. Segue abaixo as especificações de alguns campos da aba Validação:

94

Figura 74: 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;

Somar taxa: o checkbox posicionado ao lado direito da linha do campo Valor

Depositado/Pago, irá permitir que o processo de retorno identifique a taxa do documento

caso ela venha subtraída do valor nominal do título;

Tarifa de cobrança: posição do arquivo em que o valor da tarifa retornada pelo banco se

encontra;

Momento da tarifa: a tarifa bancária pode vir no arquivo de retorno 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;

95

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$

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.

Juros/Multas: o campo Juros/Multas permitirá identificar esses lançamentos, caso

venham destacados separadamente do valor dos títulos do arquivo de retorno;

Nome: posição do arquivo em que o nome do sacado é retornado pelo banco;

Data de lançamento: posição do arquivo em que a data de lançamento do título se

encontra;

CPF/CNPJ: posição do arquivo em que a informação fiscal do parceiro é retornada;

Data de vencimento: posição do arquivo em que a data de vencimento do título se

encontra;

Código de barras: posição do arquivo em que o código de barras do título é encontrado

(campo disponível apenas para leiautes de DDA);

Data do pagamento: posição do arquivo em que a data do pagamento do título se

encontra (campo disponível apenas para leiautes de DDA);

Status do boleto sugerido: opção para informar o status em que o boleto se encontra

(Gerado ou Pago - campo disponível apenas para leiautes de DDA);

Número do pagamento: posição do arquivo em que o número do pagamento do título é

retornado (campo disponível apenas para leiautes de DDA);

96

Informação adicional: este campo é utilizado caso o banco retorne alguma informação

adicional, onde o usuário deseje leva-la como histórico para o administrador de boletos

por DDA (campo disponível apenas para leiautes de DDA);

Valor da comissão: posição do arquivo em que o valor da comissão é retornado (campo

disponível apenas para leiautes de Cartão de Crédito);

Valor do imposto: posição do arquivo em que o valor do imposto é retornado (campo

disponível apenas para leiautes de Cartão de Crédito);

Despesa: posição do arquivo em que o valor da despesa em cartório é retornado;

Momento da despesa: identifica em qual desses momentos (Pagar ou Depositas) o

usuário vai programar o add-on para identificar a despesa;

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 75) base acessar os

seguintes módulos: Módulos | Administração | Configurações | Banco | BankSync | Leiaute de

Extrato Bancário (CNAB).

97

Figura 75: Leiaute de arquivo de extrato CNAB

Código – Code


Nome – Name


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 76):

98

Figura 76 Leiaute de extrato bancário CNAB Registro / Identificação

Figura 77: 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 77).

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.

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.

99

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.

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

100

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.

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 78).

Figura 78: Formato de valor

101

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 79).

Figura 79: Formato do tipo de lançamento

OBS: a opção “Serviço” bloqueará os campos acima e identificará os débitos e

créditos do arquivo, utilizando os serviços cadastrados na aba Serviço do leiaute de

extrato CNAB;

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.

102

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

6.2.4.2 Serviço

A aba serviço (Figura 80) é 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 80: Tela da aba serviço

103

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

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 81 abaixo:

Figura 81: 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

104

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.

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.2 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.

105

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 82.

Figura 82: 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 83.

Figura 83: LCM da nota fiscal de saída

106

7.1.3 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 84.

Figura 84: Contas a Receber

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 85.

107

Figura 85: 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.

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.

108

7.1.4 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.5 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 86). 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 86: Assistente de exportação - Apresentação

7.1.6 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:

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 87). Também define algumas configurações especiais, que estão detalhadas

mais abaixo;

109

Figura 87: 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 check

Cancelado marcada (Figura 88);

Figura 88: 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, Pendente ou Pago (Figura 89);

Figura 89: Configuração do filtro de status do documento

Pagamentos: Somente deverá listar os boletos que estão vinculados a notas fiscais

bloqueadas ou desbloqueadas (Figura 90);

110

Figura 90: 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 91: 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 92).

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 92: Configuração do filtro de forma de pagamento

Filial: Permiti ao usuário selecionar a filial na qual ele deseja efetuar a exportação

dos títulos. Caso não utilizar o filtro, basta deixar a opção default Todas (Figura 93);

Figura 93: Configuração do filtro Filial

111

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.

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 94). 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 94: 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 95), 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 95: 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 96.

112

Figura 96: Alerta

7.1.7 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 97 como referência.

Figura 97: 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.

113

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.8 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 98.

114

Figura 98: 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.

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

115

isto, será exibida uma tela de introdução que irá explicar um pouco sobre o processo de retorno,

conforme a demonstrada na Figura 99. Clicando sobre o botão Seguinte, o assistente irá para a

sua próxima etapa.

Figura 99: 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 100) 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

transferências já foram associados as suas respectivas formas de pagamento no

momento de sua criação;

Filial: Caso a base estiver ativada para a funcionalidade de múltiplas filiais, o

usuário deverá selecionar a filial na qual os documentos do arquivo pertencem;

116

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 100: 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.

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.

117

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 101 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 101: Assistente de Importação – Aba Automática

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 102).

118

Figura 102: Configuração do tipo de cobrança

A seleção destas opções estará contabilizando da seguinte maneira no Business One:

Cobrança

Utilizará a conta do “Banco de cobrança” (Contas bancárias da empresa) e a conta de

“Apresentação de boleto” (Parceiro de negócios).

Descontado

Utilizará a conta do “Banco de desconto” (Contas bancárias da empresa) e a conta de

“Boleto descontado” (Parceiro de negócios).

Figura 103: Conta contábil – Parceiro de negócios

Figura 104: Conta contábil – Contas bancárias da empresa

Ele também poderá trocar de forma prática, a data de lançamento dos títulos identificados.

Essa parametrização será efetuada no campo Alteração Dt. Lançamento, no canto inferior

esquerdo da tela do assistente, selecionando os títulos e em seguida inserindo uma nova data.

119

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 105).

Figura 105: Assistente de Importação – Tela de resultados da importação do arquivo

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;

120

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 106);

Figura 106: 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 107), 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 108.

Figura 107: Ocorrências nas colunas Motivo e Informações adicionais

121

Figura 108: 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.

Um exemplo de um título que não pode ser identificado encontra-se na Figura 101.

122

Figura 109: 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 110.

Figura 110: Assistente de Importação – Resultados

123

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 status 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

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 111.

Figura 111: Assistente para extratos CNAB - Apresentação

124

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 112.

Figura 112: 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;

125

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

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 113 demonstra um exemplo desta tela.

126

Figura 113: 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 114) 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.

127

Figura 114: 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 115.

Figura 115: Assistente para extratos CNAB– Não-Identificados

128

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 116.

Figura 116: 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 117) não vem com sua

visibilidade habilitada no sistema; para ativá-la, com a janela dos Módulos selecionada, clique

sobre o botão Configurações do Formulário e marque a checkbox da tela de

processamento de extrato bancário externo.

129

Figura 117: Processar extrato bancário externo

7.4. Administração e 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..

Para iniciar o administrador e o assistente de importação de boletos por DDA do

BankSync, utilize o menu que se encontra em Módulos | Banco | Boletos por DDA.

7.4.1 Importação do arquivo de DDA

Ao acessar Módulos | Banco | Boletos por DDA | Importação de Boletos por DDA, será

apresentada a opção abaixo.

Na tela apresentada (Figura 118), o usuário deverá clicar no botão Seguinte para passar

ao próximo passo.

130

Figura 118: Boletos por DDA – apresentação

O assistente terá como função, transferir todos os títulos encontrados no arquivo para o

Administrador de Boletos por DDA. O assistente identificará as linhas do arquivo, possuindo uma

nota fiscal/LCM ou não, para que seja tudo vinculado no assistente por controle do usuário,

portanto será validado apenas o CNPJ do Parceiro de Negócio.

Na etapa demonstrada na Figura 119, o usuário deverá preencher os seguintes campos:

Banco: selecionar o banco que será utilizado para pagamento dos boletos;

Conta: selecionar a conta do banco que será utilizado para pagamento dos boletos;

Forma de Pagamento: selecionar a Forma de Pagamento parametrizada para essa

operação;

Arquivos: selecionar o arquivo de DDA enviado pelo banco para importação;

Filtros: caso necessário, o usuário poderá filtrar as linhas do arquivo por data de

vencimento e lançamento, conforme campos disponíveis na tela abaixo;

OBS: O leiaute de retorno DDA é parametrizado na tela de Contas bancárias da

empresa, sendo um leiaute por conta bancária;

131

Figura 119: Boletos por DDA – parametrização

Clicando no botão Seguinte, a próxima etapa irá detalhar todos os títulos contidos no

arquivo utilizado (Figura 120). O usuário terá liberdade de marcar apenas os títulos que deseja

importar para o administrador.

Figura 120: Boletos por DDA – importação do arquivo

132

OBS: Poderão ser importadas linhas de boletos que possuem ou não documentos criados

no B1.

Concluindo o processo de importação, clicando no botão Seguinte da tela acima, o usuário

poderá verificar o status de cada título importado no seguinte caminho: B1 | Banco | Boletos por

DDA | Administração de Boletos por DDA.

7.4.2 Administração de boletos por DDA

Ao acessar essa opção do menu, será apresentada primeiramente uma tela de filtros

(Figura 121), onde o usuário poderá configurá-la para encontrar com mais facilidade um

determinado documento, ou simplesmente clicar no botão OK para mostrar todos.

Figura 121: Boletos por DDA – filtro do administrador

O Administrador de Boletos por DDA do BankSync (Figura 122), tratará as linhas

importadas de um arquivo de retorno através das seguintes gavetas: Não Vinculado, Vinculado,

Gerado e Cancelado.

Todos os movimentos com o título de DDA deverá ser feito nesta opção, tanto a vinculação

de NF/LCM ao título, quanto à troca de status para que o DDA gere o “contas a pagar” com a nota

e parcela vinculadas ao título.

133

Figura 122: Boletos por DDA – administrador de boletos

Não Vinculado: Aparecerão todos os títulos que foram importados no assistente,

que possuem ou não uma nota vinculada a ele. Esta aba servirá para o usuário

vincular a nota fiscal/documento e parcela ao título escolhido.

Vinculado: Aparecerão os títulos que estão prontos para serem gerados o contas a

pagar, isso será possível após o usuário vincular os títulos na aba anterior a um

documento, deslocando posteriormente o titulo para esta aba.

Gerado: Apenas mostrará os títulos já importados e que já foram criados o contas a

pagar, não poderá ser enviado para mais nenhum status, mostrará também a data

que foi gerado o “pagamento”.

Cancelado: Na aba Não Vinculados, o usuário poderá anular a linha importada,

deslocando-a para a gaveta de Cancelados.

134

7.5. Administração e pagamento de transferências bancárias

O processo para administrar e pagar transferências dentro do SAP Business One, inicia-se

após criar uma nota fiscal de entrada ou LCM, onde ficará em aberto um título no Contas a Pagar

do B1. Assim esse título poderá ser pago manualmente escolhendo a opção de transferência

bancária ou então utilizando o assistente de pagamento do BankSync.

Para administrar as transferências dentro do Business One, utilize as opções encontrada

no menu Módulos | Banco | Transferências bancárias.

7.5.1 Pagamento das transferências

Possuindo títulos em aberto no Contas a Pagar do B1, o usuário poderá efetuar o

pagamento manual utilizando o meio de pagamento, ou então acessando o menu de Banco |

Transferências Bancárias | Assistente de Pagamento para Transferências.

Caso o usuário deseja pagar manualmente e administrar o título pelo BankSync, a opção

“Enviar para comunicação bancária” da tela de Meio de pagamento, deverá ser marcada,

conforme a Figura 123:

Figura 123: Transferências bancárias – Meio de pagamento

135

Utilizando a opção de pagamento pelo Assistente de pagamento de transferências, o

usuário poderá efetuar o pagamento de várias transferências de uma única vez, parametrizando

alguns filtros caso necessário (Figura 124):

Figura 124: Assistente de pagamento para transferências – Filtros

No lado esquerdo inferior do assistente, dentro de uma grade serão listadas todas as

Formas de Pagamento para transferências (Contas a Pagar), onde o usuário poderá trabalhar

com as formas de pagamento que foram sugeridas nas Notas Fiscais do Business One (Figura

125).

136

Figura 125: Assistente de pagamento para transferências – Forma de pagamento sugerida

O filtro citado acima possui algumas condições como:

Selecionar todas as Formas de Pagamento: o assistente irá listar todos e apenas os

documentos que foram sugeridas Formas de Pagamento;

Selecionar algumas das Formas de Pagamento: o assistente irá listar apenas os

documentos que foram sugeridas Formas de Pagamento de acordo com o selecionado;

Não selecionar as Formas de Pagamento: o assistente irá listar todos os documentos,

indiferentemente se foram ou não sugeridas Formas de Pagamento;

No passo seguinte do assistente, serão listados os documentos em aberto no Contas a

Pagar do Business One.

Na tela foi adicionada a coluna “Forma de Pagamento”, onde irá listar as formas de

pagamento sugeridas nas Notas Fiscais, ou caso não forem, estarão em branco para

preenchimento manual ou automático (Figura 126).

137

Figura 126: Assistente de pagamento para transferências – Preenchimento da Forma de Pagamento

Na parte inferior esquerda da tela do assistente, foi adicionado um campo para seleção de

Forma de Pagamento (Figura 127).

Figura 127: Assistente de pagamento para transferências – Forma de Pagamento utilizada

Caso o usuário deseja ignorar as formas de pagamento sugeridas nos documentos, ou

então selecionar formas de pagamento para as Notas Fiscais que estão sem sugestões, o mesmo

poderá utilizar este campo, pois após a seleção das linhas e em seguida da forma de pagamento,

a coluna “Forma de Pagamento” na grade é preenchida automaticamente.

138

Exemplo

Duas notas estão em aberta, porém não foram sugeridas Forma de Pagamento na

sua emissão. Na grade do assistente será apresentada a coluna em branco, possibilitando

ao usuário preenche-la com a Forma de Pagamento que desejar:

Figura 128: Assistente de pagamento para transferências – Forma de Pagamento não sugerida

Em seguida o usuário poderá informar qual Forma de Pagamento será utilizada para

pagamento das notas que foram selecionadas na grade:

Figura 129: Assistente de pagamento para transferências – Seleção da Forma de Pagamento

139

Após a seleção, o assistente automaticamente preenche ou atualiza a coluna Forma

de Pagamento da grade:

Figura 130: Assistente de pagamento para transferências – Atualização da Forma de Pagamento

A grade localizada no lado direito da tela do assistente, possui também alguns filtros em

relação aos Parceiros de Negócio, onde o usuário poderá filtrar por grupos de fornecedores, ou

até mesmo individualmente, marcando os parceiros para que os mesmos sejam apresentados na

próxima tela de seleção.

Dentre várias informações que o assistente trás em relação aos títulos encontrados, é

possível modificar as informações de dois campos na grade: Cp. Referência e Cp. Obs do

Diário. Ambas as colunas tratam-se de informações que estarão presentes no Contas a Pagar

destes títulos, assim que a transação for concluída (Figura 131).

Figura 131: Assistente de pagamento para transferências – Campos adicionais

140

Estas informações podem ser encontradas nos locais abaixo, de acordo com a Figura 132

e Figura 133:

Figura 132: Assistente de pagamento para transferências – Observações do Diário

Figura 133: Assistente de paramento para transferências – Referência do meio de pagamento

Após a seleção dos títulos, o usuário poderá clicar no botão Seguinte e assim o

pagamento das transferências selecionadas serão efetuados.

141

7.5.2 Administração das transferências

Ao acessar o seguinte caminho: Módulos | Banco | Transferências bancárias |

Administração de Transferências Bancárias, o usuário poderá administrar todas as

transferências lançadas na base de dados. Esta atividade é semelhante a de administração de

boletos do SAP Business One, porém para transferências.

Ao acessar a opção, a tela abaixo (Figura 134) para parametrização de filtros será

apresentada, fornecendo ao usuário opções para filtrar seus documentos conforme suas

necessidades.

Figura 134: Administração de transferências - Filtro

142

Após inserir ou não informações nos campos de filtros, clicando no botão OK, a tela

principal de administração irá ser apresentada, conforme Figura 135 abaixo:

Figura 135: Administração de transferências - Administração

A tela de Administração de transferências do BankSync, segue o mesmo padrão visual e

funcional da tela de Administração de boletos do SAP, permitindo ao usuário movimentar os

documentos entre as gavetas existentes: Enviada, Gerada, Paga e Cancelada.

Na Figura 136 abaixo, detalha o processo completo do pagamento de transferências pelo

add-on BankSync:

143

Figura 136: Assistente de pagamento para transferências - Processo

1. NF de Entrada: o usuário cria uma NF de entrada no B1 ou faz uso de uma NF que

ainda não foi paga;

2. Meio de Pagamento – CP: escolha de um meio para pagamento para o título

criado. Poderá ser pelo próprio Meio de pagamento do B1 (marcando a opção

“Enviar para comunicação bancária”) ou utilizando Assistente de Pagamento para

Transferências;

OBS: caso o usuário utilize o BankSync para tratar as transferências bancárias, é de

extrema importância que o mesmo administre o Contas a Pagar e os documentos de

1 - NF de Entrada

• Criação da NF de Entrada

2 - Meio de Pagamento - CP

• Manual

• Assistente de Pagamento para Transferências

3 - Esboço do Contas a Pagar

• Criação de um Esboço do Contas a Pagar do título

4 - Importação do arquivo

• Importação do arquivo de retorno do banco

• Status modificado para Pago

5 - Fechando Contas a Pagar

• Fechamendo do Contas a Pagar do SAP

144

marketing com o add-on conectado, caso contrário correrá o risco de pagar 2 vezes

um mesmo título, já que o add-on cria um Esboço e oculta o Contas a Pagar em

aberto do título em questão;

3. Esboço do Contas a Pagar: como a Administração de Transferências é de total

atividade do add-on, o BankSync gera um “Esboço” do Contas a Pagar do título para

que o mesmo não fique em aberto no Contas a Pagar do B1, pois o usuário poderá

paga-lo novamente caso o add-on esteja desconectado;

4. Importação do arquivo: após a exportação e envio do arquivo ao banco, o mesmo

retorna com o arquivo de retorno para importação na base de dados. Após a

importação dos títulos, eles devem assumir o status de Pago na Administração de

Transferências;

5. Fechando Contas a Pagar: assumindo o status de Pago, o Contas a Pagar do

título será encerrado;

145

7.6. Administração de Cartão de Crédito

A partir da versão 7.0.0, o BankSync comtempla a funcionalidade de administração de

cartão de crédito, onde o add-on irá tratar e automatizar o processo de importação dos

comprovantes e baixa dos depósitos no SAP Business One.

7.6.1 Parametrizações iniciais

No seguinte caminho: Administração / Inicialização do Sistema / Configuração Cartão de

Crédito, será possível parametrizar as contas contábeis onde serão efetuados os lançamentos,

conforme ilustrada na Figura 137:

Figura 137: Cartão de Crédito – Parâmetros

Acessando o caminho: Administração / Configuração / Banco / BankSync / Leiaute de

Arquivo de Retorno, o usuário poderá parametrizar o leiaute de retorno (Consta a receber) para

identificar o arquivo com lançamentos do cartão (Figura 138).

146

Figura 138: Cartão de Crédito – Leiaute de Retorno (identificação)

1. Checkbox Cartão de Crédito: indicará que o leiaute refere-se a cartão de crédito, alguns

campos em particular com a funcionalidade, serão habilitados ou desabilitados quando

selecionada a opção;

2. Contas a receber: será possível parametrizar o leiaute para cartão de crédito, somente

quando o mesmo for para Contas a receber;

3. Título: utilizado para identificar as linhas de comprovantes, sabendo que a primeira

posição das linhas três e quatro são compostas pelo número “2”, automaticamente o

BankSync irá identificar que existe dois comprovantes para uma operação (Figura 139).

1

2

3

4

147

Figura 139: Cartão de Crédito – Arquivo exemplo

4. Identificação do Documento: utilizado para identificação do comprovante. Esta

informação será parametrizada para ler o número do comprovante, servindo como chave

única dos títulos relacionados à venda com cartão de crédito;

Na aba “Validação” do leiaute de retorno (Figura 140), encontram-se alguns campos a

serem parametrizados para identificação dos mesmos no arquivo.

Data de lançamento: posição no arquivo em que a data de lançamento da transação

foi efetuada.

Data de vencimento: posição no arquivo em que a data prevista de pagamento da

transação se encontra.

OBS: verificar o formato de datas que a operadora utiliza.

Figura 140: Cartão de Crédito – Aba Validação

148

Na aba “Validação C. Crédito” do leiaute de retorno (Figura 141) será apresentado alguns

campos para auxiliar na identificação os comprovantes e também para identificação de valores.

Figura 141: Cartão de Crédito – Leiaute de Retorno (validação)

Identificação da operação: utilizado para identificar o tipo de registro detalhe da

operação, sabendo que a primeira posição da linha dois é composta pelo número

“1”, automaticamente o BankSync irá identificar que esta linha trata-se do registro da

operação.

Número único da operação: uma sequência de números que a própria operadora

disponibiliza e que serão utilizados para identificar quais comprovantes pertencem a

tal operação, pois os números da operação e da transação serão os mesmos.

Número único da transação: posição no arquivo que se encontra o número único

da operação, porém na linha do comprovante.

Quantidade de CVs aceitos: posição no arquivo que se encontra a quantidade de

vendas aceitas no registro de operação.

149

Valor da comissão: posição no arquivo em que se encontra o valor da comissão.

Valor do imposto: posição no arquivo em que se encontra o valor do imposto.

OBS: os valores de Comissão e Imposto identificados no arquivo serão lançados como

LCMs nas contas contábeis parametrizadas na tela de Parâmetros de Cartão de Crédito.

Para utilização do leiaute configurado, é necessário vincula-lo a uma forma de pagamento.

Acessando o seguinte caminho: Administração / Configuração / Banco / Forma de pagamento /

Parâmetros BankSync, um campo foi adicionado para inserir o código do leiaute para cartão de

crédito:

Figura 142: Cartão de Crédito – Forma de Pagamento

150

7.6.2 Novo leiaute de Cartão de Crédito (VANS/Normal)

A partir da versão 8.0.0 do BankSync, foi contemplado um novo leiaute de retorno para o

processo de cartão de crédito, onde atenderá tanto o processo normal quanto de VANS. O

usuário precisará apenas selecionar no Tipo de documento a opção que desejar.

As duas primeiras abas do leiaute (Identificação e Validação C. Credito) na 142, equivalem

ao processo padrão de importação do cartão de crédito (Normal), possui o mesmo modelo do

leiaute antigo que será mantido por tempo determinado.

Figura 143: Cartão de crédito – Leiaute Normal

151

Na aba VANS o usuário poderá configurar um novo leiaute para este processo, tendo

apenas que selecionar a opção “VANS” em Tipo de documento.

Figura 144: Cartão de crédito – Leiaute de VANS

O usuário terá a opção de migrar os leiautes antigos de cartão de crédito para o novo

padrão. Para fazer a migração, basta o usuário acessar o leiaute antigo e clicar no botão

Importar Leiaute (Figura 146).

Uma mensagem confirmando o processo será apresentada na barra inferior do SAP

Business One (Figura 145):

Figura 145: Cartão de crédito – Mensagem de migração

152

Figura 146: Cartão de crédito – Importar Leiaute

7.6.3 Parametrizações do leiaute de VANS

Primeiro passo para configuração do leiaute de cartão de crédito VANS, é localizar os

identificadores no arquivo de retorno.

A forma de identificação deste leiaute é semelhante à identificação do arquivo de Extrato

Simples, por meio de delimitadores, sinais que dividem uma informação da outra dentro do

arquivo de retorno.

153

Figura 147: Cartão de crédito – Identificação VANS

Figura 148: Cartão de crédito – Arquivo VANS

No exemplo do arquivo acima, uma “vírgula” separa uma informação da outra. Sendo

assim, o usuário deverá configurar os três primeiros identificadores: Cabeçalho, Registro e

Rodapé.

A mesma configuração deverá ser feita para os demais campos, conforme Figura 149:

Figura 149: Cartão de crédito – Identificação de valores VANS

154

As três colunas abaixo apresentadas no leiaute de VANS, possuem as seguintes funções:

Ativo: permite ao usuário ativar ou desativar uma determinada informação, de acordo com

a existência dela no arquivo de retorno de cartão;

Ordem: será informada a ordem em que a informação esta posicionada no arquivo de

retorno, levando em consideração o delimitador configurado.

Conforme exemplo do arquivo abaixo, cada informação sinalizada esta separa por seu

delimitador, onde o usuário terá de informar a ordem em que ela se encontra: 1, 2, 3, 4, 5 e

6.

Formato: Apresenta qual formato a informação esta representada no arquivo de retorno;

7.6.4 Processo

Gerando o “Contas a Receber” com meio de pagamento do tipo Cartão de Crédito (Figura

150), o depósito ficará em aberto para que o BankSync faça a automatização do processo na

importação do arquivo de retorno do comprovante (Figura 151).

OBS: o número do comprovante a ser digitado deve possuir apenas números, caso

contrário, ocasionará bloqueios na importação do arquivo.

155

Figura 150: Cartão de Crédito – Meio de pagamento

Figura 151: Cartão de Crédito – Depósito em aberto

O campo “Encargos bancários” localizado na direita da tela de Meio de pagamento do

Business One, permitirá ao usuário informar um valor de encargo que a operadora pode estar

cobrando pela operação. Quando informado, na baixa do comprovante é feito um lançamento

contábil para a operadora (Parceiro de negócio cadastrado no B1), de acordo com a

parametrização feita na tela de Configuração Cartão de Crédito, apresentada anteriormente.

156

Após as parametrizações iniciais e a geração do “Contas a Receber”, o usuário poderá

importar o arquivo de retorno acessando o seguinte caminho: Banco / Cartão de crédito /

Importação de Cartão de Crédito.

Na tela principal do assistente, será possível filtrar as informações pela data de

vencimento, inserir a Forma de Pagamento e o arquivo a ser importando (Figura 152):

Figura 152: Cartão de Crédito – Importação do retorno

OBS: A Forma de Pagamento estará disponível somente se o leiaute de retorno estiver

configurado na mesma.

No próximo passo do assistente, o mesmo irá identificar as linhas do arquivo obedecendo

algumas regras:

157

Figura 153: Cartão de Crédito – Importação do retorno (identificação)

As linhas identificadas aparecerão totalmente preenchidas caso o número do comprovante

a ser importado, possuir vinculo a um depósito em aberto na base de dados (Figura 153);

As linhas identificadas aparecerão com ausência de algumas informações, quando o

número do comprovante não possuir vínculo com nenhum depósito, ocorrendo geralmente

quando o mesmo for criado após a importação do arquivo. Neste caso a linha do

comprovante ficará em aberto no Administrador de Cartões de Crédito;

As linhas ocuparão a aba Manual, caso o comprovante já tenha sido importado e já esteja

no Administrador de Cartão de Crédito;

As linhas não serão apresentadas em nenhuma das abas quando ocorrer alguma

inconsistência na parametrização do leiaute de retorno;

OBS: em todos os casos para suporte do usuário, a coluna Motivo do assistente

disponibilizará informações em relação ao posicionamento da linha do comprovante.

Para administrar as linhas dos comprovantes, o usuário poderá acessar o seguinte

caminho: Banco / Cartão de Crédito / Administrador de Cartão de Crédito.

158

Figura 154: Cartão de Crédito – Administrador

Não Vinculado: os comprovantes que forem importados antes de gerar o “Contas a

Receber” estarão ocupando esta gaveta. Quando possuir vínculo entre as linhas

importadas e um depósito em aberto, ao acessar a gaveta será apresentada a mensagem

ilustrada na Figura 155 abaixo, informando ao usuário o vinculo existente:

Figura 155: Cartão de Crédito – Mensagem de vínculo

Vinculado: caso o usuário marque a opção “Sim”, de vincular o comprovante existente, o

mesmo será movimentado para a gaveta Vinculado, para que possa ser depositado

posteriormente pelo processo manual;

159

Depositado: estarão presentes nesta gaveta, os comprovantes que na importação do

arquivo de retorno já possuíam um depósito em aberto, ou forem manualmente

movimentados da gaveta de Vinculado. Neste status o depósito já está vinculado e baixado

(Figura 154);

Cancelado: o usuário poderá cancelar o depósito movimentando uma linha para a gaveta

“Cancelado”, onde o depósito ficará em aberto novamente para receber uma nova linha de

comprovante;

160

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 156 abaixo:

Figura 156: Definição do registro - Databases

161

Ao clicar no botão Definição do Campo para uma linha do tipo Database, é possível

selecionar o database desejado conforme Figura 157 abaixo:

Figura 157: Definição do campo – Base de Dados (Databases)

162

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.

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 (Traz o primeiro endereço de cobrança cadastrado, não marcado como padrão).

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

Retorna o número da referência do boleto – campo RefNum da tabela OBOE.

163

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.

Ex.: R$100,00 (Valor do Boleto) / 1% (Juros cadastrado no Parceiro de Negócios)

1% de R$100,00 = R$1,00

R$1,00 / 30 (Dias) = R$0,03333 (Valor impresso no arquivo de remessa)

Boleto - Valor Total com Juros de Mora

Retorna o valor total do boleto com o cálculo de juros de mora:

Ex.: R$100,00 (Valor do Boleto) / 1% (Juros cadastrados no Parceiro de Negócios)

1% de R$100,00 = R$1,00

R$1,00 / 30 (Dias) = R$0,03333 (Valor impresso no arquivo de remessa)

“5 dias de atraso”

R$100,00 + (R$0,03333 * 5) = R$100,166 (Valor total do boleto impresso no arquivo de

remessa)

Boleto - Valor Total

Retorna o valor total do boleto – Campo BoeSum da tabela OBOE.

164

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)

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.

165

Cedente - Endereço da Empresa (CEP)

Retorna o CEP da empresa – Campo ZipCode da tabela ADM1.

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.

Cedente - Nome da Filial

Retorna o nome da Filial – Campo BPLName da tabela OBPL.

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).

166

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.

Contas a Pagar – Número do Pagamento DDA

Retorna o número do pagamento do DDA – Campo PaymntNum da tabela

@SIEBS_CDDA.

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).

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).

167

Documento – Valor Bruto da Nota Fiscal

Retorna o valor bruto da nota fiscal sem considerar descontos e impostos.

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.

Documento – Data de Lançamento da Nota Fiscal

Retorna a data de lançamento da Nota Fiscal do boleto. Caso tenha duas ou mais notas, o

database retornará a data da última nota fiscal.

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 (N0/0)

Retorna o número da NF e o número da parcela no formado “N + (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).

168

Sacado – Número da Nota Fiscal/Parcela (0/0)

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).

(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.

Forma de Pagamento - Código da Carteira

Retorna o código da carteira vinculada a forma de pagamento – Campo PtfCode da tabela

OPTF.

169

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.

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.

170

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.

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.

171

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.

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.

172

PN – CNPJ

Retorna o CNPJ do parceiro de negócio – Campo TaxId0 da tabela CRD7.

PN - Código do Banco

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.

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.

173

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.

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

(Traz o endereço de cobrança padrão).

174

PN - Endereço de Cobrança (Tipo Rua, Nº, Complemento)

Retorna o tipo, o nome da rua, número e o complemento do endereço padrão de cobrança

do parceiro de negócio no formato “Rua Exemplo, 123, Complemento” – Campos AddrType,

Street, StreetNo e Building da tabela CRD1.

PN – Código do Parceiro de Negócios

Retorna o Código do parceiro de negócios – Campo Cardcode da tabela OCRD.

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.

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.

175

8.10. Databases - Transferência

Transferência - Data de Criação

Retorna a data de criação do documento – Campo DocDate da tabela OPDF.

Transferência - Data de Vencimento

Retorna a data de vencimento do documento – Campo DocDueDate da tabela OPDF.

Transferência - Nome do PN

Retorna o nome do parceiro de negócios – Campo CardName da tabela OPDF.

Transferência - Número do BankSync

Retorna o número da transferência – Campo TrnfsNum da tabela OPDF.

Transferência - Referência

Retorna a informação referência – Campo TrsfrRef da tabela OPDF.

Transferência - Valor

Retorna o valor da transferência – Campo TrsfrSum da tabela OPDF.

Transferência - N° Pagamento

Retorna o número do pagamento da transferência – Campo PaymtNum da tabela OPDF.

Transferência - TED(1)/DOC(2)

Condição, se TrsfrSum for maior que R$ 3.000,00 é TED, senão DOC

176

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 158

explica em mais detalhes como este processo ocorre:

Figura 158: 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

177

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 159

ilustra levemente este processo:

Figura 159: Fluxo de chamadas do Business One

As novas DLLs desenvolvidas pela empresa Sistema Info 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 160 abaixo:

Figura 160: 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 Info, é que

178

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.

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 3:

Tabela 3: Estrutura dos dados do código de barras

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

179

Os dados chamados de Campos Livres devem ser preenchidos de acordo com o que o

manual de cada banco especifica. Segue a Tabela 4 demonstrando um exemplo de

preenchimento dos dados dos campos livres:

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


Tabela 4: 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 5 abaixo:

180

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


21 21 1 Inteiro Dígito verificador do segundo campo


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


Formatação dos dados da Linha Digitável

Tabela 5: Formatação dos dados da linha digitável

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 Tabela 6 e

Tabela 7 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 6: Campos da tabela Contas Bancárias da Empresa

181

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 7: 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 161) é marcada como do tipo Recebido, com

meio de pagamento por Boleto, o botão extra é exibido na tela na opção Características do

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 162 abaixo:

182

Figura 161: Configuração da Forma de Pagamento

Figura 162: Configurações específicas do boleto

183

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;

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 Info. É

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.

184

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 Código 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


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 América




Número do banco Código do banco 755

Nosso Número Usuário N° 3 Deve ser preenchido com 1 dígito como primeiro caractere

do Nosso Número.

Nosso Número Nosso Nº Deve ser preenchido com nove dígitos.



Nº da Conta Deve ser preenchido com 5 ou 7 dígitos.

Código do Cedente Número do Contrato Deve ser preenchido com 10 dígitos.

OBS: a DLL irá tratar as carteiras sem registro e direta, onde a montagem da linha

digitável mudará de acordo com a utilização da carteira (cálculo presente no manual do banco).





185

9.3.3 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

partir da tabela @SIEBS_BOEC, nos campos U_OurNuChk e OnChkCmp.

OBS: O Código do cedente cadastrado no campo Número do Contrato, caso possua

apenas 7 dígitos, deve-se colocar 2 “zeros” no final do número. Ex.: CC = 1234567, então se

deve cadastrar CC = 123456700.

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.



Número do banco Código do Banco 041

Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos.






9.3.4 Banco Bancoob





Número da Carteira - Deve ser preenchido com 1 dígito.


Número da Modalidade Usuário n° 1 Deve ser preenchido com 2 dígitos.

Número do Cedente Número do Contrato Deve ser preenchido com 7 dígitos.

Nosso Número Nosso Número Deve ser preenchido com 7 dígitos (será completado com

0 a esquerda).

186

9.3.5 Banco Bradesco

Abaixo são listados os campos requisitados pela DLL para confecção do código de barras.















9.3.6 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.


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.

187


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

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:

Usuário n° 1: 00000011;

Nosso número: 000000009;





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 do Contrato Número do Contrato Deve ser preenchido conforme especificação acima.





Tamanho do NN Tipo de transação Informar “11” ou “17” como tamanho do NN

188

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.

9.3.7 Banco CitiBank




Número do Banco Código do Banco 745





Número do Contrato Número do Contrato Deve ser preenchido com 9 dígitos.





9.3.8 Banco Fibra

















189

9.3.9 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 caso utilize o Nosso Número de 11

posições, ou 17 caso utilizar o de 17 posições.

Os tópicos que seguem demonstram as particularidades existentes no modelo de nosso

número que foi escolhido.

Nosso Número de 11 posições

Utilizado nas carteiras Rápida (12), Sem Registro (14) e (11). 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 162.

Carteira Informações Campo do SAP Business One Qtd. Caracteres Complemento da DLL

14 Nosso Número Nosso Número 8 82

12 Nosso Número Nosso Número 9 9

11

Nosso Número Nosso Número – Usuário n° 2 Nosso Número = 9

Usuário n° 2 = 1 N/D

OBS: ao utilizar a carteira 11, caso o Nosso Número iniciar com “0”, não será necessário

preencher o campo Usuário n° 2, pois o preenchimento será automático.


Abaixo especificações para parametrização da DLL, onde atenderá o nosso número com

16 posições:

Informações Campo do SAP Business One Qtd. Caracteres

Complemento da DLL - Caractere “8”

Nosso Número Usuário n° 2 5

Nosso Número Nosso Número 9

190


A modalidade de cobrança utilizada (1 – Registrada ou 2 – Sem registro) deve ser

informada no campo Nº Usuário 3 (UsrNumber3), na tela de contas bancárias da empresa. Segue

abaixo maiores informações para parametrização da DLL da CEF:

Informações Campo do SAP Business One Qtd. Caracteres

Modalidade de Cobrança Usuário n° 3 1

Nosso Número Usuário n° 2 6

Nosso Número Nosso Número 9

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 Usuário n° 2 (UsrNumber2),

ambos da tela de contas bancárias da empresa.





Nosso Número Nosso Nº Deve ser preenchido conforme instruções acima.

Número do Contrato Número do Contrato Preencher com 6 caracteres

Usuário Nº 1 Usuário Nº 1 Código da Operação

Usuário Nº 2 Usuário Nº 2 Deve ser preenchido conforme instruções acima.



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.





191

9.3.10 Banco HSBC


Cobrança registrada:




Código do Cedente 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º da Conta Deve ser preenchido com 6 dígitos (Preenchimento com 0

automático).

Dígito da Conta Dígito de controle da conta Deve ser preenchido com 1 caractere (DV = 1 dígito).



Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos – fixo “00”


Cobrança não-registrada:



Número do Banco Código do Banco -

Código do Cedente Número do Contrato Deve ser preenchido com o número do cliente no banco,

contendo 7 dígitos.

Nosso Número Nosso Nº Deve ser preenchido com os últimos 9 dígitos do Nosso

Número.

Nosso Número Usuário N° 2 Deve ser preenchido com os 4 primeiros dígitos do Nosso Número. Caso sejam zeros, deixam o campo em branco.



Nº da Conta Deve ser preenchido com 6 dígitos (Preenchimento com

“0” automático).

Dígito da Conta Dígito de controle da conta Deve ser preenchido com 1 caractere (DV = 1 dígito).



Carteira Nº do Portfólio Deve ser preenchido com 2 dígitos – 4 ou 5 (válidas para

não-registrada).


São calculados três dígitos verificadores para o Nosso Número. Estes não fazem

parte do código de barras e da linha digitável do boleto.

192

No entanto, estes dígitos poderão ser incluídos no boleto impresso. Sendo assim,

toda a informação referente ao Nosso Número pode ser obtida na tabela de Controle de Boletos

do BankSync (SIEBS_BOEC).

Segue os campos utilizados:

Nosso Número: U_OurNumbr

D.V. 1: U_OurNuChk

D.V. 2 e 3: U_OnChkCmp

OBS: Caso o dígito da conta tiver 2 caracteres, utilizar o cadastro dos mesmos no campo

Usuário n° 1.

9.3.11 Banco Itaú













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.

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.

193

9.3.12 Banco Mercantil







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.



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”.





O DV do Nosso Número será calculado sobre o Número da Agência + Nº do Acordo +

Carteira + Nosso Nº.

9.3.13 Banco Nordeste









DV da Conta Bancária Dígito de Controle da Conta Deve ser preenchido com 1 dígito.





194

9.3.14 Banco Pine





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.





O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº final.

9.3.15 Banco Safra





Nosso Número Nosso Nº Deve ser preenchido com 8 dígitos. É considerado apenas

para Cobrança Direta Eletrônica.





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.




195

9.3.16 Banco Safra (Bradesco Correspondente)

Abaixo são listados os campos requisitados pela DLL para confecção do código de

barras.



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”


- Fixo “0176300”




Carteira - Fixo “09”

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





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.





196

9.3.18 Banco Sicoob (Correspondente Banco do Brasil)



Número do Banco Código do Banco -

Número do Convênio Número do Contrato -

Caso o número do convênio seja menor que 1.000.000, será o número do convênio +

nosso número:



Nosso Número Número do Contrato Deve conter no máximo 6 dígitos

Nosso Número Nosso Número Deve conter no máximo 5 dígitos

Número da Agência Filial Deve conter 4 dígitos

Número da Conta N° da Conta Deve conter 8 dígitos

Caso o número do convênio seja maior que 1.000.000, será o número do convênio +

nosso número:



Nosso Número Número do Contrato -

Nosso Número Nosso Número Deve conter no máximo 7 dígitos

Número da Agência Filial Deve conter 4 dígitos

Número da Conta N° da Conta Deve conter 8 dígitos

197

9.3.19 Banco Sicredi





Posto Usuário N° 2 Deve ser preenchido com 2 dígitos (2 dígitos obrigatórios).

Byte Usuário N° 3 Deve ser preenchido com 1 dígito.

Nosso Número Nosso N° Deve ser preenchido com 5 dígitos (completará com 0 a

esquerda).


DV da Agência Chave de controle Deve ser preenchido com 2 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”.



Carteira - Fixo “1”


O DV do Campo Livre é inserido na última posição do código de barras.

198

9.3.20 Banco Sofisa








11 dígitos.








O DV do Nosso Número será calculado sobre a Carteira + Nosso Nº final.

9.3.21 Banco BicBanco




Número do Banco - Fixo “237”


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









O DV do Nosso Número será calculado sobre a Carteira + Radical + Matrícula + Nosso Nº.

199

9.3.22 Banco BicBanco (Correspondente Bradesco)






Radical Usuário Nº 1 Deve ser preenchido com 2 dígitos de acordo com a


Matrícula Usuário Nº 2 Deve ser preenchido com 3 dígitos de acordo com a


Número da Agência Correspondente

Usuário Nº 3 Deve ser preenchido com 4 dígitos.


Correspondente Usuário Nº 4 Deve ser preenchido com 7 dígitos.





O DV do Nosso Número será calculado sobre a Carteira + Radical + Matrícula + Nosso Nº.

9.3.23 Banco Sofisa (Correspondente)








11 dígitos.

Número da Agência Correspondente

Usuário Nº 4 Deve ser preenchido com 4 dígitos.


Correspondente Usuário Nº 3 Deve ser preenchido com 7 dígitos.





200


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 Nosso Número e seu respectivo dígito verificador.

Utilizando algumas parametrizações no leiaute de retorno (Conforme página 80 do

manual), é possível atualizar as informações do Nosso Número e DV do boleto na importação do

arquivo de retorno.

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

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

201

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 163 abaixo:

Figura 163: Caminho do OneShare

Após abrir a janela de Exportação de Leiautes, clique no botão Seguinte conforme a

Figura 164:

202

Figura 164: Tela inicial da exportação de leiautes

Ao executar o procedimento acima, a próxima tela (Figura 165) 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:

203

Figura 165: Tela informando o caminho para salvar o arquivo de leiaute

Já na tela de seleção de leiautes do BankSync (Figura 166), 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:

Figura 166: Tela de seleção de leiautes a serem exportados

204

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 167 abaixo:

Figura 167: Caminho do OneShare

Após abrir a janela de Importação de Leiautes, clique no botão “Seguinte” conforme a

Figura 168:

205

Ao executar o procedimento acima, a próxima tela (Figura 169) 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 168: Tela inicial da exportação de leiautes

Figura 169: Tela que informará o caminho onde foi salvo o arquivo de leiaute

206

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 170), o usuário marcará os

leiautes desejados por meio do campo Sel, após efetuar as escolhas clicar no botão Seguinte.

Figura 170: Tela de seleção de leiautes a serem importados

207

Selecionado o arquivo, o usuário deve clicar no botão Seguinte avançando para a próxima

etapa.

Ao efetuar a escolha dos leiautes desejados, o usuário passa para a tela de “Correção de

Dados dos Leiautes” (Figura 171).

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 172) 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 171: Tela de correção de informações referentes aos leiautes a serem importados

208

Figura 172: 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 173), será apresentada uma tela onde poderá efetuar

configurações a respeito da funcionalidade de consulta ao SERASA.

http://www.consultacpf.com/

209

Figura 173: Caminho para acesso ás configurações SERASA

Na aba Configuração (Figura 174), o campo WebService contém os endereços dos

WebServices de teste e de produção.

Figura 174: Configurações SERASA / aba Configuração

210

OBS: os campos WebService, Usuário e Senha são de preenchimento obrigatório.

Na aba Permissões de acesso (Figura 175) 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 175: Configurações SERASA / Aba Permissões de acesso

Na aba Informações (Figura 176), 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 177).

211

Figura 176: Configurações SERASA / Aba Informações

Figura 177: Configurações SERASA / Aba Informações / Consulta de Saldo

212

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 178).

Figura 178: 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 179), 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.

213

Figura 179: 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 180) onde mostra em detalhes a consulta e o tipo de pendência.

214

Figura 180: 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 181)

será visível apenas para o usuário logado que tiver permissão para Consultas SERASA.

Figura 181: Botão de Consulta SERASA

215

10.3. Lançamentos contábeis extras

Foi incluído o parâmetro BankSync.LanctoAdicionalPagtoBoleto (Figura 182) 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 182: 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 183):

216

Figura 183: Contas bancárias da empresa – Configuração das contas

Quando a transação movimenta um documento para o status Pago, conforme a Figura

184, 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)

217

Figura 184: 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 185) onde irá permitir o backup manual de todos os leiautes da base de

dados.

218

Figura 185: Painel de Controle – Botão Backup Layout

Após clicar no botão Backup Layout, irá aparecer uma janela (Figura 186) 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 186: Painel de Controle – Caminho do Backup

219

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

187). Enviando o Código de Acesso para o e-mail [email protected], o Suporte Técnico

da Sistema Info, irá retornar com uma Senha de Acesso para efetuar as devidas configurações.

Figura 187: 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 188) será apresentada:

Figura 188: Configuração do BankSync – AddOn Settings

220

Modificando o parâmetro BankSync.AdministradorBackupLayout para o valor “true”,

uma nova opção no menu do B1 será adicionado (Figura 189). 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 190).

Figura 189: Menu B1 – Nova opção

221

Figura 190: Painel de Controle - Conexão

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 191. 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 191: 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 192), onde registrará sempre o último

backup de leiautes executado na base de dados.

222

Figura 192: Gerador de Consultas – Tabela de Backups

10.5. Geração e impressão de boletos

Em processos de contas a receber por boletos bancários, uma das atividades mais

utilizadas e importantes é a impressão dos boletos. Neste tópico será apresentada uma

funcionalidade do add-on BankSync, que permite ao usuário gerar e imprimir boletos

automaticamente após a criação de uma nota fiscal de saída, através de um único atalho.

A Sistema Info disponibilizará em sua instalação, leiautes de boletos para cinco bancos

diferentes, dentre eles: Banco do Brasil, Bradesco, Itaú, Santander, Caixa Econômica

Federal, HSBC registrada e HSBC não-registrada.

Para fazer uso destes leiautes, é necessário iniciar o add-on pelo painel de controle,

localizado na pasta de instalação do add-on. Com o add-on conectado, o usuário deverá acessar

o painel e clicar no botão Relatórios, encontrado na aba DB Manager do painel (Figura 193):

223

Figura 193: Impressão de boletos – Painel de controle

Assim que os relatórios dos bancos forem registrados no SAP Business One, ficarão

disponíveis na opção de relatórios perdidos da tela de Gerente de relatório e layout do Business

One (Figura 194), para que o usuário coloque-os no seguinte caminho: Módulo | Banco | Boleto |

Impressão de boletos.

Figura 194: Impressão de boletos – Registro de relatórios

224

Atualização

Para atualizar um relatório de impressão, não há necessidades de utilizar o Gerente de

layout do Business One, basta seguir os passos abaixo:

1. Substitua o novo arquivo .RPT pelo antigo, na pasta de relatórios do BankSync;

2. Abra o Painel de Controle do add-on e clique no botão Relatórios;

Após atividades citadas acima, para ativação desta funcionalidade, será necessário

configurar um parâmetro no caminho: Módulo | Administração | Inicialização do sistema

| Configuração do BankSync. Uma senha de acesso será solicitada, sendo que o usuário

deverá enviar o código de acesso por e-mail para a equipe de Suporte SAP da Sistema Info.

Ao receber a senha e incluí-la na tela de solicitação, o parâmetro

BankSync.EnableButtonGenerateBoleto (Figura 195) deverá possuir a informação “true” na

coluna Valor.

Figura 195: Impressão de boletos – Parâmetro de ativação

A ativação do parâmetro citado acima irá habilitar alguns botões em locais específicos para

geração do “Contas a receber” e a impressão dos boletos. Dentre estes locais específicos está a

tela de Nota Fiscal de Saída (Módulo | Vendas – C/R | Nota Fiscal de Saída), demonstrada na

Figura 196:

225

Figura 196: Impressão de boletos – Botão “Gerar Boleto”

Quando a nota fiscal estiver com status “Abrir”, ou seja, o “Contas a receber” não foi criado

ainda para esta NF, o BankSync habilitará o botão Gerar Boleto e acionando o mesmo, irá gerar

automaticamente o “Contas a receber” para aquela nota fiscal de saída.

A forma de pagamento que o add-on utilizará para gerar o “Contas a receber”, virá

configurada do parceiro de negócios, em seu cadastro na aba Execução do pagamento (Figura

197).

O usuário deverá habilitar as formas de pagamento que poderão ser utilizadas no processo

para aquele determinado parceiro, sendo assim a coluna Incluir deverá estar checada para as

formas de pagamento compatíveis com aquele PN:

226

Figura 197: Impressão de boletos – Forma de pagamento do parceiro

Incluindo as formas de pagamento para o determinado parceiro, ao gerar uma nota fiscal

para o mesmo, as mesmas formas de pagamento estarão disponíveis na aba Contabilidade da

tela de Nota Fiscal de Saída. A forma de pagamento selecionada será a mesma utilizada pelo

add-on para gerar o “Contas a Receber”.

Figura 198: Impressão de boletos – Forma de pagamento da NF

227

Ao clicar no botão Gerar Boleto, o “Contas a Receber” será gerado e também abrirá a tela

da impressão do boleto (Figura 199):

Figura 199: Impressão de boletos – Boleto impresso

Caso o “Contas a Receber” de uma determinada nota já tenha sido gerado, o botão Gerar

Boleto ainda ficará habilitado na nota fiscal acessada pelo usuário, permitindo o mesmo imprimir

novamente o boleto.

Na tela do “Contas a Receber”, o botão Imprimir Boleto (Figura 200) é habilitado

automaticamente, disponibilizando ao usuário a função de imprimir novamente o boleto

apresentado na tela.

228

Figura 200: Impressão de boletos – Contas a receber

Outro local onde permitirá o usuário imprimir os boletos já gerados no SAP Business One

encontra-se no seguinte caminho: Módulo | Banco | Boleto | Boleto – contas a receber.

Efetuando a pesquisa de um boleto ou encontrando-o no Administração de boletos, ao

acessa-lo estará disponível o botão Imprimir (Figura 201), que terá a mesma função do botão

Imprimir Boleto na tela da nota fiscal e do “Contas a Receber”, ou seja, imprimirá na tela para o

usuário, o boleto selecionado.

229

Figura 201: Impressão de boleto – Imprimir boleto no CR

Caso possua dois ou mais leiautes de impressão, o usuário poderá selecionar o leiaute

padrão em sua Forma de pagamento no botão Parâmetros BankSync, de acordo com a imagem

abaixo:

Figura 202: Impressão de boletos – seleção de leiautes

230

10.6. Geração de boletos em lote

Semelhante à função de gerar e imprimir boletos, a opção de Geração de boletos em lote

permitirá ao usuário, gerar boletos em grandes quantidades. Esta função pode ser encontrada no

caminho: Banco | Boleto | Geração de boletos em lote.

Na tela principal do gerador de boletos, ilustrada pela Figura 203 serão apresentadas as

notas fiscais de saída que possuem o status de “Aberta”.

Figura 203: Geração de boletos em lote – Tela principal

Selecionando as notas fiscais desejadas, o usuário terá de escolher a forma de pagamento

que irá utilizar na geração destes boletos, preenchendo o campo Forma de pagamento no canto

inferior esquerdo da tela principal de geração (Figura 204). Logo abaixo o usuário também terá a

opção Imprimir boletos após a geração, onde poderá ou não, imprimir os boletos após geração.

Figura 204: Geração de boletos em lote – Seleção da FP

231

Depois de efetuados os passos acima, clicando no botão Gerar Boletos, o BankSync irá

gerar automaticamente os boletos a partir das notas selecionadas. Uma mensagem de sucesso

da operação será apresentada na barra de status do Business One (Figura 205).

Figura 205: Geração de boletos em lote – Mensagem de sucesso

Concluindo o processo de geração de boletos, automaticamente o add-on irá imprimir na

tela, todos os boletos gerados pelo assistente (Figura 206).

Figura 206: Geração de boletos em lote – Impressão dos boletos

232

10.7. Leiaute de impressão de boletos

Quando impressos, os boletos buscam as informações da base de dados. Muitas delas são

baseadas em valores dependentes das transições do Business One, como: valor do boleto, data

de vencimento, nosso número e etc.

Porém algumas informações podem ser alteradas diretamente na base de dados, e assim

serão modificadas na impressão de boletos. Segue abaixo os principais campos parametrizáveis

(Figura 207):

Figura 207: Impressão de boletos – Campos

10.7.1 Local de Pagamento: campo PaymntPlc / tabela OPYM / tela Características do

boleto;

10.7.2 Beneficiário: campo BPLName / tabela OBPL / tela Filiais;

10.7.3 Instrução 1: campo Instruct1 / tabela OPYM / tela Características do boleto;

10.7.4 Instrução 2: campo Instruct1 / tabela OPYM / tela Características do boleto;

10.7.5 Carteira: campo PtpDespt / tabela OPYM / tela Características do boleto;

10.7.6 Aceite: campo Accepted / tabela OPYM / tela Características do boleto;

1

2

4

1 3

5

6

233

10.8. Compensação de Cheques

Atualmente no Business One, quando um usuário efetuar o pagamento de cheques, o B1

interpreta como se este cheque já tenha sido pago, porém nem sempre. Muitas vezes o cheque é

compensado/pago dias depois, então nestes casos o usuário poderá controlar estes pagamentos

através desta funcionalidade do BankSync.

10.8.1 Configurações

Caso o usuário deseja utilizar esta funcionalidade, na tela de Contas bancárias da

empresa, o mesmo deverá configurar a conta contábil na coluna Cheque a Compensar,

conforme abaixo (Figura 208):

Figura 208: Compensação de Cheques – Conta contábil

OBS: Caso a conta não estiver preenchida, o add-on irá entender que o usuário não

deseja utilizar a função de compensação de cheques, e o Business One fará a contabilização

padrão no pagamento.

10.8.2 Processo e Contabilização

Na geração do pagamento de cheques pelo Business One, sem a parametrização da conta

contábil acima, ficará da seguinte forma (Figura 209):

234

Figura 209: Compensação de Cheque – LCM Business One

Com a conta de Cheque a compensar configurada, o BankSync irá ignorar a conta padrão

do Business One (Coluna Conta contábil) e contabilizará uma conta de compensação de

cheques (Figura 210), que deve ser criada pelo usuário para controle.

Figura 210: Compensação de Cheques – LCM BankSync

No seguinte caminho Banco / Cheques para compensação / Compensação de cheque

será apresentada a tela de reconciliação de cheques.

Ao clicar na opção do menu, um filtro é apresentado para que o usuário informe o banco e

a conta bancária que deseja filtrar os cheques (Figura 211).

Figura 211: Compensação de Cheques – Filtro

235

Na tela de Compensação de cheque, na grade da esquerda serão apresentados os

cheques em aberto, e os cheques lançados pelo Business One para reconciliação, e na grade da

direita apresentadas as linhas de extratos importadas (Figura 212).

Figura 212: Compensação de Cheques – Tela de Reconciliação

Ao selecionar a linha de cheque e seu respectivo extrato, as informações referentes a este

cheque preencherão uma linha na grade inferior da tela. Assim o usuário poderá conferir e

selecionar o cheque. Para compensar basta clicar em “Reconciliação” (Figura 213).

Figura 213: Compensação de Cheques – Reconciliação

236

O LCM de compensação irá creditar a Conta contábil da tela de Contas bancárias da

empresa e debitar a conta de Cheque a compensar (Figura 214).

Figura 214: Compensação de Cheques – LCM Compensação

BankSync Manual

Documents

Transcript of BankSync Manual