MMaannuuaall FFuunncciioonnaall

2

Apresentao do Documento

O Manual do BankSync tem como objetivo explicar aos usurios do sistema, os pontos

principais no que diz respeito instalao, configurao e conhecimentos relacionados a rea e

usabilidade do software.

Inicialmente feita uma introduo sobre o que o BankSync, sua histria, seus objetivos

e algumas particularidades que o software possui. Para auxiliar no entendimento do produto,

tambm explicado nesta sesso um pouco sobre o processo de comunicao bancria.

Na sequncia, demonstrado como feita a instalao do software, desde seu download

no site da Sistema Informtica Empresarial, passando pelo registro do add-on no SBO1 e

atribuindo uma licena para os usurios do SBO.

Uma vez feita instalao, o manual traz as configuraes que devem ser feitas, tanto em telas

do SBO quanto do prprio BankSync. Esta configurao acontece de maneira sequencial e segui-

la recomendvel.

Quando encerradas as configuraes, inicia-se a apresentao dos processos realizados

pelo BankSync. Nesta sesso so demonstradas as telas e explicado em mais detalhes alguns

filtros e funcionalidades do add-on.

Feita a apresentao dos processos, so demonstradas algumas telas que permitem um

controle administrativo dos boletos e transferncias geradas pelo BankSync.

1 SBO: SAP Business One

3

Sumrio

Sumrio

1. Introduo ao BankSync _________________________________________________________ 11

2. Comunicao bancria ___________________________________________________________ 11

2.1. Boletos _____________________________________________________________________________ 12

2.2. Transferncias ______________________________________________________________________ 12

3. Comunicao bancria dentro do SAP Business One _______________________________ 13

3.1. Boletos _____________________________________________________________________________ 13

3.2. Boletos de Contas a Receber ________________________________________________________ 14

3.2.1. Enviado __________________________________________________________________________________ 14

3.2.2. Gerado ___________________________________________________________________________________ 14

3.2.3. Depositado _______________________________________________________________________________ 15

3.2.4. Pago _____________________________________________________________________________________ 15

3.2.5. Cancelado________________________________________________________________________________ 16

3.2.6. Sem xito ________________________________________________________________________________ 17

3.3. Boletos de Contas a Pagar ___________________________________________________________ 17

3.3.1. Gerado ___________________________________________________________________________________ 18

3.3.2. Pago _____________________________________________________________________________________ 18

3.3.3. Cancelado________________________________________________________________________________ 18

3.4. Transferncias ______________________________________________________________________ 19

3.5. Particularidades do processo adaptado _______________________________________________ 21

4. Informaes tcnicas ____________________________________________________________ 22

4.1. Tecnologia _________________________________________________________________________ 22

4.2. Conexo Remota ____________________________________________________________________ 22

4.3. Suporte Tcnico ____________________________________________________________________ 22

5. Instalao _______________________________________________________________________ 23

5.1. Download do Software _______________________________________________________________ 23

5.2. Registro do Add-On no SBO _________________________________________________________ 23

5.3. Instalao do Add-On no SBO ________________________________________________________ 25

5.4. Primeira execuo do BankSync _____________________________________________________ 28

5.4.1. Senha para o banco de dados _____________________________________________________________ 28

5.4.2. Dados padres das tabelas do BankSync __________________________________________________ 29

5.4.3. Chave de ativao ________________________________________________________________________ 29

5.5. Licenas para Add-Ons da SAP ______________________________________________________ 30

4

5.5.1. Adquirindo uma licena ___________________________________________________________________ 30

5.5.2. Atribuindo as licenas ____________________________________________________________________ 31

5.6. Configurando usurios do BankSync no SBO _________________________________________ 31

6. Configuraes ___________________________________________________________________ 33

6.1. Telas do SAP Business One _________________________________________________________ 33

6.1.1. Detalhes da empresa _____________________________________________________________________ 34

6.1.2. Configuraes gerais _____________________________________________________________________ 36

6.1.3. Contas bancrias da empresa _____________________________________________________________ 37

6.1.4. Formas de pagamento ____________________________________________________________________ 40

6.1.5. Parmetros do BankSync _________________________________________________________________ 46

6.2. Telas do BankSync __________________________________________________________________ 48

6.2.1. Nomenclatura de Arquivo de Remessa _____________________________________________________ 48

6.2.2. Leiaute de Arquivo de Remessa ___________________________________________________________ 52

6.2.2.1. Definio do Leiaute _________________________________________________________________ 52

6.2.2.2. Definio do Registro ________________________________________________________________ 56

6.2.2.3. Definio do Campo __________________________________________________________________ 58

6.2.3. Leiaute de Arquivo de Retorno ____________________________________________________________ 71

6.2.3.1. Identificao _________________________________________________________________________ 73

6.2.3.2. Ocorrncias _________________________________________________________________________ 80

6.2.3.3. Cobrana ____________________________________________________________________________ 83

6.2.3.4. Erros ________________________________________________________________________________ 85

6.2.3.5. Validao Boletos ____________________________________________________________________ 87

6.2.3.6. Validao DDA _______________________________________________________________________ 90

6.2.4. Leiaute de Extrato Bancrio (CNAB) _______________________________________________________ 94

6.2.4.1. Identificao _________________________________________________________________________ 96

6.2.4.2. Servio _____________________________________________________________________________ 101

7. Processos do BankSync_________________________________________________________ 102

7.1. Processo de remessas _____________________________________________________________ 103

7.1.1. Criando ttulos no SBO __________________________________________________________________ 103

7.1.1.1. Criando uma nota fiscal _____________________________________________________________ 103

7.1.1.2. Gerando um ttulo ___________________________________________________________________ 105

7.1.2. Gerao da remessa _____________________________________________________________________ 107

7.1.2.1. Apresentao do assistente _________________________________________________________ 107

7.1.2.2. Filtros ______________________________________________________________________________ 107

7.1.2.3. Escolha dos ttulos __________________________________________________________________ 111

7.1.2.4. Resultados ____________________________________________________________________________ 112

7.2. Importao do arquivo de retorno ___________________________________________________ 113

7.2.1. Filtragem ________________________________________________________________________________ 114

7.2.2. Escolha dos ttulos ______________________________________________________________________ 115

7.2.3. Resultados ______________________________________________________________________________ 120

7.2.4. Reconciliao dos boletos _______________________________________________________________ 121

7.3. Importao do extrato bancrio CNAB _______________________________________________ 122

7.3.1. Filtragem ________________________________________________________________________________ 122

7.3.2. Escolha das linhas de extrato ____________________________________________________________ 124

7.3.3. Resultados ______________________________________________________________________________ 127

5

7.4. Processo de importao de boletos por DDA _________________________________________ 128

7.4.1. Configuraes ___________________________________________________________________________ 129

7.4.2. Seleo e correo dos boletos __________________________________________________________ 130

8. Databases ______________________________________________________________________ 134

8.1. Databases Boleto _________________________________________________________________ 135

8.2. Databases - Clculo ________________________________________________________________ 137

8.3. Databases - Cedente _______________________________________________________________ 138

8.4. Databases Contas a Pagar ________________________________________________________ 139

8.5. Databases - Documento ____________________________________________________________ 140

8.6. Databases - Extra __________________________________________________________________ 141

8.7. Databases Forma de Pagamento ___________________________________________________ 142

8.8. Databases - Leiaute ________________________________________________________________ 145

8.9. Databases - PN_____________________________________________________________________ 146

9. DLL - Dynamic-Link Library ______________________________________________________ 150

9.1. Cdigo de Barras e Linha Digitvel __________________________________________________ 153

9.2. Configuraes das DLLs no SAP Business One ______________________________________ 155

9.3. Particularidades das DLLs __________________________________________________________ 158

9.3.1. Banco ABC ______________________________________________________________________________ 158

9.3.2. Banco Banrisul __________________________________________________________________________ 158

9.3.3. Banco Bradesco _________________________________________________________________________ 159

9.3.4. Banco do Brasil _________________________________________________________________________ 160

9.3.5. Banco BVA ______________________________________________________________________________ 162

9.3.6. Banco CitiBank __________________________________________________________________________ 162

9.3.7. Banco Fibra _____________________________________________________________________________ 163

9.3.8. Banco Caixa Econmica Federal _________________________________________________________ 163

9.3.9. Banco HSBC ____________________________________________________________________________ 166

9.3.10. Banco Itau ______________________________________________________________________________ 166

9.3.11. Banco Mercantil _________________________________________________________________________ 167

9.3.12. Banco Nordeste _________________________________________________________________________ 168

9.3.13. Banco Pine ______________________________________________________________________________ 168

9.3.14. Banco Real ______________________________________________________________________________ 169

9.3.15. Banco Safra _____________________________________________________________________________ 170

9.3.16. Banco Safra (Bradesco Correspondente) _________________________________________________ 170

9.3.17. Banco Santander ________________________________________________________________________ 171

9.3.18. Banco Sicredi ___________________________________________________________________________ 171

9.3.19. Banco Sofisa ____________________________________________________________________________ 172

9.3.20. Banco Unibanco _________________________________________________________________________ 173

9.3.21. Banco BicBanco _________________________________________________________________________ 173

9.3.22. Banco BicBanco (Correspondente Bradesco) _____________________________________________ 174

9.3.23. Banco Sofisa (Correspondente) __________________________________________________________ 175

6

9.3.24. Dummy _________________________________________________________________________________ 176

9.3.25. Particularidade com o DV do Nosso Nmero ______________________________________________ 176

10. Funcionalidades ______________________________________________________________ 177

10.1. OneShare ________________________________________________________________________ 177

10.1.1. Exportao de leiautes ___________________________________________________________________ 177

10.1.2. Importao de leiautes ___________________________________________________________________ 181

10.2. Consulta ao SERASA _____________________________________________________________ 186

10.2.1. Configurao da consulta SERASA _______________________________________________________ 186

10.2.2. Utilizao da consulta SERASA __________________________________________________________ 190

10.3. Lanamentos contbeis extras ____________________________________________________ 193

10.4. Backup peridico dos leiautes ____________________________________________________ 195

7

ndice de Figuras

FIGURA 1: ADMINISTRAO DE BOLETOS ........................................................................................................................................ 13

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

FIGURA 3: BOLETOS PAGOS RECONCILIADOS OU NO .................................................................................................................... 16

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

FIGURA 5: PROCESSO DAS TRANSFERNCIAS NO BANKSYNC ........................................................................................................... 20

FIGURA 6: STATUS DAS TRANSFERNCIAS DO BANKSYNC................................................................................................................ 20

FIGURA 7: REGISTRANDO O ADD-ON NO SBO .................................................................................................................................. 24

FIGURA 8: CONFIGURAO DE INICIALIZAO DO ADD-ON ............................................................................................................ 25

FIGURA 9: INCIO DA INSTALAO DO ADD-ON NO SBO.................................................................................................................. 26

FIGURA 10: INSTALAO INFORMAES DO USURIO ................................................................................................................ 27

FIGURA 11: INSTALAO CAMINHO DA INSTALAO ................................................................................................................... 27

FIGURA 12: ATUALIZAO DA ESTRUTURA DA BASE DE DADOS ...................................................................................................... 28

FIGURA 13: REQUISITANDO A SENHA DO BANCO DE DADOS .......................................................................................................... 29

FIGURA 14: AVISO ANTES DE POVOAR AS TABELAS DO ADD-ON ..................................................................................................... 29

FIGURA 15: CHAVE DE ATIVAO ..................................................................................................................................................... 30

FIGURA 16: SELECIONANDO LICENA PARA UM USURIO .............................................................................................................. 31

FIGURA 17: AUTORIZAES GERAIS POR USURIO .......................................................................................................................... 32

FIGURA 18: DETALHES DA EMPRESA ................................................................................................................................................ 34

FIGURA 19: EXEMPLO DE MAIS DE UMA BASE NO SBO.................................................................................................................... 35

FIGURA 20: CONFIGURAES GERAIS .............................................................................................................................................. 36

FIGURA 21: CONTAS BANCRIAS DA EMPRESA ................................................................................................................................ 37

FIGURA 22: FORMA DE PAGAMENTO ............................................................................................................................................... 40

FIGURA 23: ESCOLHA DA CONTA BANCRIA DA EMPRESA .............................................................................................................. 42

FIGURA 24: PROPRIEDADES DO BOLETO .......................................................................................................................................... 43

FIGURA 25: LISTA DE CARTEIRAS ...................................................................................................................................................... 44

FIGURA 26: CADASTRAR CARTEIRA ................................................................................................................................................... 44

FIGURA 27: OPO PARA APROVAO ............................................................................................................................................ 45

FIGURA 28: ESCOLHER UMA DLL ...................................................................................................................................................... 45

FIGURA 29: CAMINHO PARA INSERIR A DLL ..................................................................................................................................... 46

FIGURA 30: PARMETROS DO BANKSYNC ........................................................................................................................................ 47

FIGURA 31: NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................................................................ 48

FIGURA 32: GRADE PARA DEFINIES DA NOMENCLATURA DE ARQUIVO DE REMESSA ................................................................ 49

FIGURA 33: MODELO DE EXEMPLO .................................................................................................................................................. 52

FIGURA 34: LEIAUTE DE ARQUIVO DE REMESSA .............................................................................................................................. 53

FIGURA 35 TELA DE DEFINIO DE REGISTRO .................................................................................................................................. 56

FIGURA 36: DEFINIO DO CAMPO TEXTO FIXO .............................................................................................................................. 59

FIGURA 37: CONFIGURAO DA POSIO PARA CDIGO DE BARRAS ............................................................................................ 61

FIGURA 38 DEFINIO DO CAMPO DATABASE ................................................................................................................................. 62

FIGURA 39: CONFIGURAO DA POSIO PARA CDIGO DE BARRAS ............................................................................................ 64

FIGURA 40: DEFINIO DO CAMPO CATEGORIA .............................................................................................................................. 65

FIGURA 41: CONFIGURAO DA POSIO PARA CDIGO DE BARRAS ............................................................................................ 67

FIGURA 42: CONFIGURAO DA COLUNA CONDIO E VALOR ....................................................................................................... 68

FIGURA 43: DEFINIO DO CAMPO SQL SELECT............................................................................................................................... 69

FIGURA 44: CONFIGURAO DA POSIO PARA CDIGO DE BARRAS ............................................................................................ 71

FIGURA 45: LEIAUTE DE ARQUIVO DE RETORNO .............................................................................................................................. 72

8

FIGURA 46: LEIAUTE DE ARQUIVO DE RETORNO, CABEALHO ........................................................................................................ 73

FIGURA 47: ARQUIVO DE RETORNO ................................................................................................................................................. 74

FIGURA 48: LEIAUTE DE ARQUIVO DE RETORNO TTULO ................................................................................................................. 74

FIGURA 49: ARQUIVO DE RETORNO ................................................................................................................................................. 75

FIGURA 50: DETALHES DA EMPRESA IDENTIFICAO DA EMPRESA ................................................................................................ 76

FIGURA 51: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAO DO DOCUMENTO ....................................................................... 76

FIGURA 52: ARQUIVO DE RETORNO CHAVE NICA .......................................................................................................................... 76

FIGURA 53: LEIAUTE DE ARQUIVO DE RETORNO IDENTIFICAO ALTERNATIVA............................................................................. 77

FIGURA 54: IDENTIFICAO ESPECIAL .............................................................................................................................................. 79

FIGURA 55: LEIAUTE DE ARQUIVO DE RETORNO - OCORRNCIAS ................................................................................................... 81

FIGURA 56: CDIGOS DE OCORRNCIAS .......................................................................................................................................... 82

FIGURA 57: LEIAUTE DE ARQUIVO DE RETORNO - COBRANA ........................................................................................................ 83

FIGURA 58: TIPO DE COBRANA PADRO ........................................................................................................................................ 84

FIGURA 59: LEIAUTE DE ARQUIVO DE RETORNO ERRO .................................................................................................................... 85

FIGURA 60: OCORRNCIAS DE ERROS, MANUAL DO BANCO ........................................................................................................... 86

FIGURA 61: LEIAUTE DE ARQUIVO DE RETORNO VALIDAO .......................................................................................................... 87

FIGURA 62: LEIAUTE DE RETORNO VALIDAO DDA ........................................................................................................................ 91

FIGURA 63: LEIAUTE DE ARQUIVO DE EXTRATO CNAB ..................................................................................................................... 95

FIGURA 64 LEIAUTE DE EXTRATO BANCRIO CNAB REGISTRO / IDENTIFICAO ............................................................................ 96

FIGURA 65: EXTRATO BANCRIO CNAB ............................................................................................................................................ 96

FIGURA 66: FORMATO DE VALOR ..................................................................................................................................................... 99

FIGURA 67: FORMATO DO TIPO DE LANAMENTO .......................................................................................................................... 99

FIGURA 68: TELA DA ABA SERVIO ................................................................................................................................................. 101

FIGURA 69: CADASTRO DE CDIGOS E DESCRIES PARA SERVIOS DE EXTRATO BANCRIO ..................................................... 102

FIGURA 70: NOTA FISCAL DE SADA ................................................................................................................................................ 104

FIGURA 71: LCM DA NOTA FISCAL DE SADA .................................................................................................................................. 104

FIGURA 72: CONTAS A RECEBER ..................................................................................................................................................... 105

FIGURA 73: TELA DE MEIO DE PAGAMENTO .................................................................................................................................. 106

FIGURA 74: ASSISTENTE DE EXPORTAO - APRESENTAO ......................................................................................................... 107

FIGURA 75: CONFIGURAO DO TIPO DE DOCUMENTO................................................................................................................ 108

FIGURA 76: CONFIGURAO DO FILTRO DE DATA ......................................................................................................................... 108

FIGURA 77: CONFIGURAO DO FILTRO DE STATUS DO DOCUMENTO ......................................................................................... 108

FIGURA 78: CONFIGURAO DO FILTRO DE PAGAMENTOS ........................................................................................................... 109

FIGURA 79: CONFIGURAO DO FILTRO DE SITUAO DO DOCUMENTO .................................................................................... 109

FIGURA 80: CONFIGURAO DO FILTRO DE FORMA DE PAGAMENTO .......................................................................................... 109

FIGURA 81: CONFIGURAO DO FILTRO DE TIPO DE TRANSAO ................................................................................................ 110

FIGURA 82: CONFIGURAO DO FILTRO DE CONTAS A PAGAR ..................................................................................................... 110

FIGURA 83: ALERTA ......................................................................................................................................................................... 111

FIGURA 84: ASSISTENTE DE EXPORTAO - ESCOLHA DOS TTULOS.............................................................................................. 111

FIGURA 85: ASSISTENTE DE EXPORTAO RESULTADOS ............................................................................................................. 113

FIGURA 86: ASSISTENTE DE IMPORTAO APRESENTAO........................................................................................................ 114

FIGURA 87: ASSISTENTE DE IMPORTAO FILTRAGEM ............................................................................................................... 115

FIGURA 88: ASSISTENTE DE IMPORTAO ABA AUTOMTICA ................................................................................................... 116

FIGURA 89: CONFIGURAO DO TIPO DE COBRANA ................................................................................................................... 117

FIGURA 90: ASSISTENTE DE IMPORTAO TELA DE RESULTADOS DA IMPORTAO DO ARQUIVO ........................................... 117

FIGURA 91: STATUS REPLICADO ..................................................................................................................................................... 118

FIGURA 92: OCORRNCIAS NAS COLUNAS MOTIVO E INFORMAES ADICIONAIS ....................................................................... 119

FIGURA 93: ASSISTENTE DE IMPORTAO ABA MANUAL ........................................................................................................... 119

FIGURA 94: ASSISTENTE DE IMPORTAO ABA NO IDENTIFICADO .......................................................................................... 120

9

FIGURA 95: ASSISTENTE DE IMPORTAO RESULTADOS ............................................................................................................ 121

FIGURA 96: ASSISTENTE PARA EXTRATOS CNAB - APRESENTAO ................................................................................................ 122

FIGURA 97: ASSISTENTE PARA EXTRATOS CNAB - FILTRAGEM ....................................................................................................... 123

FIGURA 98: ASSISTENTE PARA EXTRATOS CNAB - AUTOMTICA ................................................................................................... 125

FIGURA 99: ASSISTENTE PARA EXTRATOS CNAB MANUAL ........................................................................................................... 126

FIGURA 100: ASSISTENTE PARA EXTRATOS CNAB NO-IDENTIFICADOS ...................................................................................... 126

FIGURA 101: ASSISTENTE PARA EXTRATOS CNAB - RESULTADOS .................................................................................................. 127

FIGURA 102: PROCESSAR EXTRATO BANCRIO EXTERNO .............................................................................................................. 128

FIGURA 103: ASSISTENTE DE IMPORTAO DE BOLETOS POR DDA APRESENTAO ................................................................. 129

FIGURA 104: ASSISTENTE DE IMPORTAO DE BOLETOS POR DDA CONFIGURAES ............................................................... 130

FIGURA 105: ASSISTENTE DE IMPORTAO DE BOLETOS POR DDA SELEO DOS BOLETOS ..................................................... 131

FIGURA 106: TELA DE IDENTIFICAES FISCAIS DO PARCEIRO DE NEGCIO ................................................................................. 132

FIGURA 107: DEFINIO DO REGISTRO - DATABASES .................................................................................................................... 134

FIGURA 108: DEFINIO DO CAMPO BASE DE DADOS (DATABASES) .......................................................................................... 135

FIGURA 109: PROCESSO DE EXECUO DE UMA DLL ..................................................................................................................... 151

FIGURA 110: FLUXO DE CHAMADAS DO BUSINESS ONE ................................................................................................................ 152

FIGURA 111: MENSAGEM DE ERRO DA DLL. ................................................................................................................................... 152

FIGURA 112: CONFIGURAO DA FORMA DE PAGAMENTO .......................................................................................................... 156

FIGURA 113: CONFIGURAES ESPECFICAS DO BOLETO .............................................................................................................. 157

FIGURA 114: CAMINHO DO ONESHARE .......................................................................................................................................... 178

FIGURA 115: TELA INICIAL DA EXPORTAO DE LEIAUTES ............................................................................................................. 179

FIGURA 116: TELA INFORMANDO O CAMINHO PARA SALVAR O ARQUIVO DE LEIAUTE ............................................................... 180

FIGURA 117: TELA DE SELEO DE LEIAUTES A SEREM EXPORTADOS ........................................................................................... 181

FIGURA 118: CAMINHO DO ONESHARE .......................................................................................................................................... 182

FIGURA 119: TELA INICIAL DA EXPORTAO DE LEIAUTES ............................................................................................................. 183

FIGURA 120: TELA QUE INFORMAR O CAMINHO ONDE FOI SALVO O ARQUIVO DE LEIAUTE ..................................................... 183

FIGURA 121: TELA DE SELEO DE LEIAUTES A SEREM IMPORTADOS ........................................................................................... 184

FIGURA 122: TELA DE CORREO DE INFORMAES REFERENTES AOS LEIAUTES A SEREM IMPORTADOS ................................. 185

FIGURA 123: TELA DE FINALIZAO DE IMPORTAO DE LEIAUTES.............................................................................................. 186

FIGURA 124: CAMINHO PARA ACESSO S CONFIGURAES SERASA ............................................................................................ 187

FIGURA 125: CONFIGURAES SERASA / ABA CONFIGURAO .................................................................................................... 188

FIGURA 126: CONFIGURAES SERASA / ABA PERMISSES DE ACESSO ....................................................................................... 188

FIGURA 127: CONFIGURAES SERASA / ABA INFORMAES ...................................................................................................... 189

FIGURA 128: CONFIGURAES SERASA / ABA INFORMAES / CONSULTA DE SALDO ................................................................ 189

FIGURA 129: CONSULTAS SERASA .................................................................................................................................................. 190

FIGURA 130: CONSULTAS SERASA / NOVA CONSULTA SERASA ...................................................................................................... 191

FIGURA 131: TELA DE CONSULTA COMPLETA SERASA ................................................................................................................... 192

FIGURA 132: BOTO DE CONSULTA SERASA .................................................................................................................................. 192

FIGURA 133: ADD-ON SETTINGS PARMETROS DO BANKSYNC .................................................................................................. 193

FIGURA 134: CONTAS BANCRIAS DA EMPRESA CONFIGURAO DAS CONTAS ........................................................................ 194

FIGURA 135: LANAMENTO CONTBIL MANUAL LANAMENTOS EXTRAS ................................................................................. 195

FIGURA 136: PAINEL DE CONTROLE BOTO BACKUP LAYOUT .................................................................................................... 196

FIGURA 137: PAINEL DE CONTROLE CAMINHO DO BACKUP ....................................................................................................... 196

FIGURA 138: CONFIGURAO DO BANKSYNC - ACESSO RESTRITO ................................................................................................ 197

FIGURA 139: CONFIGURAO DO BANKSYNC ADDON SETTINGS ............................................................................................... 198

FIGURA 140: MENU B1 NOVA OPO ......................................................................................................................................... 199

FIGURA 141: PAINEL DE CONTROLE - CONEXO ............................................................................................................................ 199

FIGURA 142: MENU B1 ADMINISTRADOR DE BACKUP LAYOUTS ................................................................................................ 200

10

FIGURA 143: GERADOR DE CONSULTAS TABELA DE BACKUPS .................................................................................................... 200

ndice de Tabelas

TABELA 1: AUTORIZAES PARA USURIOS DO BANKSYNC ............................................................................................................ 33

TABELA 2: CHAVES DOS BOLETOS DAS EMPRESAS DO GRUPO ALGODO S.A ................................................................................. 36

TABELA 3: NIVELAMENTO DO ARQUIVO DE REMESSA ..................................................................................................................... 55

TABELA 4: ESTRUTURA DOS DADOS DO CDIGO DE BARRAS ........................................................................................................ 153

TABELA 5: EXEMPLO DE PREENCHIMENTO DOS CAMPOS LIVRES .................................................................................................. 154

TABELA 6: FORMATAO DOS DADOS DA LINHA DIGITVEL ......................................................................................................... 154

TABELA 7: CAMPOS DA TABELA CONTAS BANCRIAS DA EMPRESA .............................................................................................. 155

TABELA 8: CAMPOS DA TABELA FORMAS DE PAGAMENTO ........................................................................................................... 155

11

1. Introduo ao BankSync

O BankSync uma soluo projetada para atender a complexidade dos servios de

pagamentos e cobrana executados pelos Bancos que integram o Sistema Bancrio Brasileiro,

totalmente integrado ao produto SAP Business One e a nica soluo homologada para este

fim, fornecendo os dados para gerao dos arquivos de comunicao bancria e registro das

ocorrncias.

O BankSync possui as seguintes funcionalidades:

Criar leiautes dinmicos de remessa e retorno no padro CNAB, atendendo as

necessidades dos bancos brasileiros;

Automatizar as situaes que um boleto pode assumir dentro do SBO;

Enviar e receber as transferncias e boletos do SBO;

Realizar a importao de arquivos de extrato, no padro CNAB, para o SBO;

Tambm possui a funcionalidade de integrao dos dados de DDA, caso a empresa for

optante do DDA possvel importar os dados de pagamentos diretamente para a base do

cliente;

Importar e Exportar leiautes para outras bases;

Automatizar a reconciliao bancria, evitando erros na reconciliao manual e aperfeioar

o tempo utilizado para tal atividade;

2. Comunicao bancria

A comunicao bancria um servio disponibilizado pelos bancos que permite que

pessoas fsicas e jurdicas troquem informaes e solicitem operaes com seus bancos. Dentre

as opes disponveis, esto o envio de dados de ttulos para a cobrana de clientes,

manipulao da aplicao do patrimnio obtido em cobranas, pagamentos de despesas para

terceiros, entre outros.

12

2.1. Boletos

O principal meio de comunicao bancria feito atravs do uso de boletos, que so

ttulos que representam um valor que se tem a receber de um cliente, ou para pagar para um

terceiro. So conhecidos tambm por bloquetos de cobrana.

Qualquer pessoa, fsica ou jurdica, pode emitir boletos de cobrana, bastando apenas que

este se registre em sua agncia para aderir modalidade.

Existem duas modalidade utilizadas para boletos de cobrana, chamados de cobrana

registrada e no-registrada:

Registrada: so gerados pelo cedente e as informaes do documento so enviadas

para o banco atravs de um arquivo de remessa. Estes dados so gerenciados pela

instituio financeira que pode realizar servios, como o protesto de ttulos quando

inadimplentes;

No-Registrada: funcionam como os de cobrana registrada s que as informaes do

documento no necessitam ser enviadas para o banco. Portanto, todo servio de

verificao e protesto fica a encargo do cedente;

Estes servios apresentam um custo para seus utilizadores, chamado de tarifa. O custo

dos bloquetos de cobrana registrados so cobrados quando o arquivo de remessa enviado ao

banco. O custo dos bloquetos de cobrana no-registrada, por sua vez, s cobrado do cedente

quando o sacado efetua o pagamento. De certa forma, os bloquetos de cobrana registrados

podem ser chamados de pr-pagos, enquanto os no registrados podem ser chamados de ps-

pagos.

2.2. Transferncias

Outra maneira de realizar movimentaes de capital para o pagamento de ttulo atravs

da transferncia de valores de uma conta para outra. Fazendo uso de transferncias, uma

pessoa, fsica ou jurdica, pode realizar o pagamento de ttulos na mesma maneira que faria

utilizando um boleto, mas sem a necessidade de um papel impresso.

Algumas das modalidades de transferncias mais utilizadas so o DOC e a TED. O DOC,

ou Documento de Ordem de Crdito, utilizado para transferncias com valores mais baixos e o

dinheiro liberado apenas no dia til seguinte ao do processamento da operao.

13

Uma Transferncia Eletrnica Disponvel (TED) uma operao na qual os correntistas

realizam operaes interbancos para valores iguais ou acima dos R$3.000,00, alm disso, este

um meio mais rpido para transferir recursos, pois, como no h necessidade da operao

passar pelo sistema de compensao dos bancos, o dinheiro fica disponvel no mesmo dia, desde

que o emitente tenha saldo na conta.

3. Comunicao bancria dentro do SAP Business One

3.1. Boletos

O controle de boletos dentro do SAP Business One feito originalmente atravs de uma

tela especfica para a administrao dos boletos, localizada em Mdulos | Banco | Boleto |

Administrao de boletos, demonstrada na Figura 1.

Figura 1: Administrao de Boletos

14

Um boleto no pode migrar de uma gaveta para qualquer outra. Existem restries e

propsitos para a existncia 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 intermedirias.

Na sesso que segue, sero explicados os significados de cada uma destas gavetas,

separados pelo tipo do boleto, que pode ser de Contas a Receber e de Contas a Pagar.

3.2. Boletos de Contas a Receber

Os boletos de Contas a Receber apresentam um controle maior, pois so gerenciados

desde o momento de sua criao.

A Figura 2 demonstra os estados que um boleto de Contas a Receber pode assumir no

sistema. Na sequncia, so descritos o que cada uma destas situaes representa no sistema.

Figura 2: Status do boleto de Contas a Receber

3.2.1. Enviado

O estado de enviado, tambm chamado de criado, um dos status iniciais que um boleto

pode assumir no sistema. Ele representa o momento em que o boleto passou a existir

virtualmente dentro de seu sistema. Para o SBO, o sistema sugere que este seja um estado de

aprovao, para que ento ele seja aprovado, utilizado e impresso.

Quando um boleto gerado com o estado de Enviado, no h qualquer lanamento

contbil feito no sistema por parte do documento de Contas a Receber que foi criado.

3.2.2. Gerado

Um boleto que apresenta o estado de Gerado pode apresentar dois significados

dependendo se o boleto foi criado diretamente com o status de Gerado, ou se ele migrou do

status de enviado para o de gerado.

15

Quando um boleto passa para o estado de gerado realizada uma movimentao da conta

contbil de Contas a Receber Nacionais/Internacionais para a conta contbil de Contas a

Receber por Boletos.

Partindo do primeiro caso, em que o boleto criado inicialmente como Gerado, o estado

de gerado tem basicamente o mesmo significado que os boletos com status de Enviado, exceto

que o boleto j se encontra aprovado, caso o usurio esteja utilizando o cenrio proposto pelo

SBO.

No segundo cenrio, quando o boleto passa de enviado para gerado, significa que o boleto

j foi submetido para a comunicao bancria atravs de uma remessa. Em outras palavras, o

BankSync troca automaticamente o estado de boletos que esto com a situao 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 esto a

caminho do processamento pelo banco, estaro sempre com o status de Gerado. Note tambm

que caso o boleto tenha sido criado inicialmente com o estado de Gerado, o BankSync possui um

controle interno utilizado para identificar quais boletos j foram inseridos em uma remessa ou

no, ento ambos os cenrios so compatveis com o Add-on.

3.2.3. Depositado

Esta situao utilizada pelos bancos para informar ao cedente que o banco recebeu os

dados do seu boleto e que agora ele est sobre custdia dele.

Quando o boleto passado do status de Gerado para Depositado, ocorre um lanamento

contbil movimentando as contas contbeis de Cobrana da conta bancria da empresa e a de

Apresentao de boletos.

3.2.4. Pago

Este estado indica que o boleto foi pago pelo cliente, e muitas vezes os bancos s iro

mandar dados do boleto no arquivo de retorno quando o boleto for pago.

Porm, existe uma particularidade neste estado, pois para o SAP Business One, quando

um boleto foi pago pelo seu cliente, isto no significa que a sua empresa recebeu o dinheiro

ainda. A confirmao deste recebimento do dinheiro feita atravs de um demonstrativo no

16

extrato bancrio, o qual deve ser reconciliado no sistema contra o boleto. Como os bancos no

informam a qual boleto cada linha do extrato referente, esta reconciliao deve ser executada

manualmente pelo usurio do SBO.

Os boletos que se encontram reconciliados no sistema aparecem na gaveta dos boletos

pagos juntamente com os que ainda no foram. Para identificar se um boleto j foi reconciliado ou

no, basta observar nas colunas Reconciliada e N da reconciliao 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 no foram.

Figura 3: Boletos pagos reconciliados ou no

OBS: as colunas Reconciliada e N da reconciliao externa no aparecem por padro

no programa. Deve-se clicar no boto de Configuraes do Formulrio e marc-las para

exibio.

3.2.5. Cancelado

Um boleto que se encontra nos estados de Enviado e Gerado pode ser cancelados. Esta

operao ir reverter o lanamento contbil manual criado pelos boletos que se encontram no

estado Gerado.

17

A operao de cancelamento de um boleto irreversvel e ir encerrar tambm o Contas a

Receber ao qual o boleto estava associado. O ttulo vinculado ao Contas a Receber passar para

a situao aberta novamente.

3.2.6. Sem xito

Esta operao tem o propsito similar ao de cancelamento, exceto que funciona apenas

para os boletos que esto no estado Pago.

Uma vez que um boleto caia na situao Sem xito, feito um lanamento da Conta

Contbil Do Banco para o Contas a Receber Nacionais daquele cliente.

OBS: deve ser tomada a devida cautela ao executar esta operao, pois caso o boleto no

tenha sido reconciliado ainda no sistema, pode ficar uma falha na contabilidade, tendo em vista

que nunca houve um lanamento da Conta Contbil de Cobrana/Desconto do Banco para a

Conta Contbil 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 preocupaes quanto a sua origem e emisso fazem parte do papel do

cedente.

importante ressaltar que o boleto de Contas a Pagar deve receber algumas informaes

a mais do que os de Contas a Receber, como o nmero do boleto e sua linha digitvel.

A Figura 4 demonstra os estados que um boleto de Contas a Pagar pode assumir no

sistema. Na sequncia, so descritos o que cada uma destas situaes representa no sistema.

Figura 4: Status dos boletos de Contas a Pagar

18

Alguns usurios utilizam o campo Cdigo de Barras do boleto de Contas a Pagar para

informarem o cdigo lido do boleto pela leitora de barras, enquanto que outros inserem neste

campo o valor da linha digitvel do boleto.

O valor que preenchido neste campo salvo na tabela OBOE, no campo BarcodeRep

que reservado pelo SBO para guardar a representao, ou linha digitvel do cdigo de barras.

Para o SBO, o preenchimento deste campo indiferente, j que o valor armazenado

apenas para posteriores consultas. Porm, para o BankSync, os trs primeiros dgitos deste

campo so 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 usurio escolha preencher neste campo, ambos apresentam nos

primeiros trs nmeros o Cdigo do banco.

3.3.1. Gerado

Todos os boletos para Contas a Pagar so criados com o estado igual a Gerado. Neste

momento gerado um lanamento contbil da conta contbil Contas a Pagar Nacionais para o

Contas a Pagar por Boleto.

Um boleto neste estado pode ser deslocado para os outros dois estados, Pago e

Cancelado.

3.3.2. Pago

O estado Pago indica que o boleto foi efetivamente pago para o cedente e quando um

boleto deslocado para este status, criado um lanamento contbil das contas de Contas a

Pagar por Boleto do parceiro de negcio para a conta Conta Contbil do Banco.

Um boleto que se encontra na situao de Pago no pode ser diretamente cancelado,

porm possvel retorn-lo para o estado Gerado e pass-lo posteriormente para Cancelado.

Passar o boleto para o estado Gerado ir gerar um lanamento de estorno do lanamento 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 no pode mais ser

movimentado pelas abas. Tambm criado um estorno para o lanamento do status de Gerado

do boleto.

19

3.4. Transferncias

As transferncias no SBO ocorrem de uma maneira mais simplificada, quando comparado

aos boletos.

Quando determinando o meio de pagamento por transferncia de um Contas a Pagar, o

usurio deve apenas escolher uma conta da qual ser retirado o dinheiro e informar uma

referncia qualquer para a transferncia. Feito isto, o Contas a Pagar ser criado considerando

que a transferncia j ocorreu e realizando as devidas contabilizaes.

Porm, para a maior parte dos clientes este comportamento indesejado, tendo em vista

que este cenrio impede o uso da comunicao bancria, j que o cliente s poder criar os

Contas a Pagar uma vez que a transferncia j tenha ocorrido.

Para auxiliar neste problema, o BankSync adotou uma soluo alternativa para a criao

das transferncias. Com o BankSync ligado e atravs da tela Mdulos | Banco | Contas a Pagar |

Contas a Pagar, no momento em que o usurio tenta inserir o novo Contas a Pagar no sistema,

o BankSync intervm criando, ao invs 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 ento

o verdadeiro Contas a Pagar seja criado e contabilizando no sistema. Para auxiliar no

entendimento do processo adotado pelo BankSync, veja a Figura 5.

20

Figura 5: Processo das transferncias no BankSync

Figura 6: Status das transferncias do BankSync

Como pode ser observado nas figuras Figura 5 e Figura 6, o processo do BankSync possui

quatro estados, similares aos de boletos de Contas a Pagar. Quando uma nova transferncia

criada, ela se encontra no estado de Enviado, passando para Gerado uma vez que ela se

encontre em uma remessa. Aps a importao de um retorno, a transferncia pode passar para

Pago ou Cancelado. Se ela passar para Pago, ento ser gerado um documento de Contas a

Pagar a partir do rascunho gerado inicialmente. Caso contrrio, o rascunho anterior ser

cancelado e enviado para a aba de cancelados.

21

3.5. Particularidades do processo adaptado

Infelizmente, a soluo adotada pelo BankSync gera alguns transtornos para o usurio,

tendo em vista que o add-on prioriza a segurana dos dados s comodidades do usurio dentro

SAP Business One.

A primeira destas particularidades se d quanto consulta dos novos ttulos criados pelo

BankSync. A tela de Contas a Pagar no ir mostrar nenhum novo registro quando voc criar um

novo pagamento por transferncia, pois o documento criado um rascunho.

Tentar consultar eles na tela de rascunho tambm ir resultar em fracasso, pois o

BankSync esconde os rascunhos gerados por ele prprio, para evitar que o usurio tente gerar

outro Contas a Pagar a partir dele.

A nica forma efetiva para a consulta destes rascunhos atravs da tela Mdulos | Banco |

Transferncias Bancrias | Administrao de Transferncias Bancrias. Esta tela similar a

de Administrao de boletos do SBO.

Outro inconveniente causado pelo uso de rascunhos, que documentos vinculados a

rascunhos ainda iro tentar aparecer na tela de Contas a Pagar aps a escolha do parceiro de

negcio, j que eles apenas deixam de aparecer quando esto ligados a um Contas a Pagar real.

O BankSync se encarrega desta tarefa excluindo da tela de Contas a Pagar os ttulos que

j esto associados a um rascunho no cancelado.

O problema surge quando o BankSync no est em execuo, pois os documentos que j

esto vinculados a rascunhos podero ser pagos novamente, causando inconsistncias para o

add-on. Cabe aqui uma sugesto ao usurio, informando ao mesmo que toda operao

envolvendo Contas a Pagar e Contas a Receber, deve ser feita com o BankSync ativo.

22

4. Informaes tcnicas

4.1. Tecnologia

Os recursos tecnolgicos 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 atravs de duas API (Application Protocol Interface):

o Data Interface API (DI-API): a interface de dados prov os mtodos e atributos

necessrios para a manipulao da base de dados. Atravs dela possvel recuperar,

editar, inserir e atualizar dados.

o User Interface API (UI-API): a interface de usurio prov a interao com a

aplicao. Atravs dela possvel inserir, modificar e remover funcionalidades visuais.

4.2. Conexo Remota

O servidor e o cliente obrigatoriamente devem estar na mesma sub-rede. Caso exista a

necessidade desse acesso remoto, deve-se faz-lo atravs do software Team Viewer que a

equipe de suporte utiliza, efetuando esses acessos apenas nas verses 5 e 6.

O Team Viewer est disponvel no site da Sistema Informtica Empresarial no seguinte

link: http://www.sistemainfo.com.br/conteudo.php?mnu=atendimento_acessoremoto.

4.3. Suporte Tcnico

O suporte ao cliente inicialmente ser prestado pelo VAR, que mantm o trato com o

cliente. O atendimento da equipe de Suporte SAP da Sistema Informtica Empresarial para com o

VAR ser por meio de chamados, que podero ser cadastrados no site da Sistema Informtica

utilizando um login e senha, cadastrados pela prpria equipe de Suporte SAP para o VAR.

23

5. Instalao

Este captulo ir gui-lo por todo o processo que envolve a instalao e configurao 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 ativao, como realizar a aquisio de uma

licena para utilizao do add-on dentro do SBO no site da SAP, como atribuir esta licena para

um usurio e como configurar as permisses mnimas para que este usurio possa usar o add-on

sem restries por parte do SBO.

5.1. Download do Software

O primeiro quesito para a instalao do software navegar at nosso site2. O endereo

direto para a pgina de download est atualmente no link abaixo:

http://www.sistemainfo.com.br/conteudo.php?mnu=solucoes_BankSync_download

Esta pgina contm a ltima verso disponvel do add-on, bem como as DLLs que podem

ser utilizadas com as formas de pagamento do SBO.

Este processo segue o padro estabelecido pelo produto SAP Business One. O grupo de

objetos enviado ao VAR para que este possa efetuar a instalao do add-on no ambiente do

Cliente composto pelos seguintes itens:

BankSync Setup.ard: arquivo que define os registros necessrios para a instalao do

produto;

BankSync Setup.exe: arquivo que executa o processo de instalao do add-on dentro

do SAP Business One;

necessrio salientar que este add-on foi desenvolvido sobre a Plataforma Microsoft .Net,

sendo assim, necessrio que o cliente tenha o .Net Framework 3.5 instalado em cada mquina

que deseja utilizar o add-on. Este framework free3 e tem sua distribuio feita pelo site de sua

fabricante, a Microsoft.

5.2. Registro do Add-On no SBO

2 Site SIE: www.sistemainfo.com.br

3 Free: Licena Free;

24

Uma vez feito o download so descompactados os arquivos, deve-se efetuar o login no

SBO com um usurio com permisses para alterao nos registros de add-ons (geralmente o

usurio manager), e navegar at a tela de Mdulos | Administrao | Add-Ons | Administrao

de add-on.

Figura 7: Registrando o add-on no SBO

Nesta tela, demonstrada na Figura 7, deve-se selecionar o boto Registrar add-on. Ele ir

abrir uma nova janela, onde deve clicar no boto , e informar para o programa onde se

encontra o arquivo BankSync.ard. Encontrado o caminho do programa, selecione OK.

25

Figura 8: Configurao de inicializao 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 atribudos empresa. Configure os dados da

grade conforme a Figura 8 e clique sobre o boto 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 instncia do SAP Business One for iniciada.

5.3. Instalao do Add-On no SBO

Agora que o add-on j est registrado dentro do SBO, hora de realizar a sua instalao.

Para isso, v at o menu Mdulos | Administrao | 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 boto Instalar, ser dado incio ao Assistente de Instalao do

BankSync.

26

Figura 9: Incio da instalao do add-on no SBO

As imagens a seguir demonstram apenas as telas do instalador do BankSync que

apresentam configuraes para o usurio preencher. A primeira (Figura 10) solicita informaes

com relao empresa do usurio, enquanto que a segunda (Figura 11) pede para que seja

definido o local onde o add-on ser instalado.

OBS: o caminho padro geralmente atende as necessidades dos usurios.

recomendado que este caminho no seja alterado.

27

Figura 10: Instalao Informaes do usurio

Figura 11: Instalao Caminho da instalao

28

Uma vez escolhidas estas configuraes, o add-on iniciar a sua instalao. At este

momento, o BankSync no ter criado, ainda, nenhum objeto dentro do SAP Business One.

Porm, caso o usurio tenha informado para o add-on executar automaticamente junto com o

SBO, prossiga imediatamente para a prxima etapa: Primeira execuo do BankSync.

5.4. Primeira execuo do BankSync

Quando o BankSync for executado pela primeira vez, ele ir solicitar algumas informaes

para o usurio. As sesses que vm na sequncia demonstram com mais detalhes os

procedimentos que devem ser tomados.

OBS: durante o processo da primeira execuo da BankSync, fique atento para a tela

mostrada na Figura 12, pois ela ir aparecer sempre que houver uma alterao na estrutura da

base de dados. Para que o add-on possa continuar sua instalao sem imprevistos, clique

sempre em Sim toda vez que esta tela aparecer.

Figura 12: Atualizao da estrutura da base de dados

5.4.1. Senha para o banco de dados

A primeira destas informaes a senha do usurio sa do banco de dados, a qual ser

guardada pelo add-on, para que posteriormente ele possa fazer consultas base de dados. A

Figura 13 demonstra a tela:

29

Figura 13: Requisitando a senha do banco de dados

5.4.2. Dados padres das tabelas do BankSync

Aps alguns minutos, o add-on ir alertar o usurio de que ele precisa inserir os dados

padres dentro da base de dados, e que este processo levar alguns minutos. Alm de poder

ocasionar travamentos para outros usurios do sistema. Selecione Sim para prosseguir

normalmente pela instalao. Se desejar continuar esta operao em outra ocasio, selecione

No para parar a execuo do add-on. A Figura 14 mostra um exemplo da tela em questo:

Figura 14: Aviso antes de povoar as tabelas do Add-On

5.4.3. Chave de ativao

Por ltimo, o BankSync ir requisitar ao usurio para que este informe a sua chave de

ativao, conforme demonstrado na Figura 15. O campo da chave de ativao o nico no qual o

usurio dever preencher dados.

30

OBS: Os campos que esto esquerda da figura devero ser ignorados por hora.

Caso o usurio no possua uma chave de ativao, este dever entrar em contato com a

Sistema Informtica Empresarial para solicitar a sua chave, via e-mail ou telefone. Esta chave

ser nica para cada instalao de servidor do SBO e estar vincula a chave de hardware, cdigo

do sistema e cdigo da instalao do SBO. Sem esta chave de ativao o produto no poder ser

inicializado.

Figura 15: Chave de ativao

5.5. Licenas para Add-Ons da SAP

Para que o add-on possa ser inicializado no SAP Business One, necessrio que o VAR

obtenha uma licena de uso diretamente no site da SAP. Esta sesso informa o usurio sobre

como esta licena pode ser adquirida, e onde ela deve ser utilizada dentro do SBO.

5.5.1. Adquirindo uma licena

Os passos para adquirir esta licena fazem parte da prpria documentao da SAP,

disponveis no link:

31

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

5.5.2. Atribuindo as licenas

Uma vez que uma ou mais licenas tenham sido adquiridas e registradas no servidor de

licenas do SAP Business One, necessrio ainda atribu-las a usurios do SBO. Para atribuir

uma licena no sistema, navegue at Mdulos | Administrao | Licena | Administrao de

licenas, e selecione o usurio que deseja atribuir uma licena do add-on na grade de Usurios.

Em seguida, marque a licena do BankSync, na grade de Licenas Externas, e finalize clicando

no boto Atualizar. A Figura 16 demonstra este procedimento, utilizando no exemplo o usurio

manager.

Figura 16: Selecionando licena para um usurio

5.6. Configurando usurios do BankSync no SBO

Uma vez que seus usurios estejam com as permisses para o uso do BankSync

configuradas, deve-se ainda garantir que estes possuam acessos as telas do mesmo. Este

controle mantido pelo prprio SAP Business One, e o local onde estas opes podem ser

32

gerenciadas ficam em Mdulos | Administrao | Inicializao do sistema | Autorizaes |

Autorizaes gerais. Vide Figura 17 para um exemplo desta tela:

Figura 17: Autorizaes gerais por usurio

Para garantir o acesso as principais telas utilizadas pelo BankSync, necessrio configurar

as permisses para o usurio em questo conforme demonstrado na Tabela 1.

33

Tabela 1: Autorizaes para usurios do BankSync

6. Configuraes

Esta sesso do manual ir demonstrar para o usurio como preparar o add-on, realizando

todas as configuraes necessrias para seu uso dentro do SBO.

Em um primeiro momento, sero explicadas as configuraes que precisaro ser

realizadas nas telas do prprio SBO e, na sequncia, passaro a ser explicadas as telas do

prprio BankSync.

Cada item ser inicialmente apresentado com uma breve introduo sobre o propsito da

tela, seguido de um detalhamento mais aprofundado sobre o propsito de seus campos; em

alguns casos, passando a oferecer dicas sobre o seu preenchimento, ou apontando para

exemplos em que seu uso se faz necessrio.

Nas telas apresentadas, itens importantes para o BankSync sero destacados em

vermelho. Estes e outros itens sero descritos em mais detalhes a cada tela apresentada.

6.1. Telas do SAP Business One

34

Este primeiro grupo de configuraes expe particularidades que devem ser tratadas em

telas do prprio SAP Business One.

6.1.1. Detalhes da empresa

Esta tela abaixo (Figura 18) pode ser encontrada em Mdulos | Administrao | Inicializao

do Sistema | Detalhes da Empresa. Na aba Dados contbeis existe um nico campo de usurio

que de interesse para o BankSync, que o Chave nica da empresa.

Figura 18: Detalhes da Empresa

Quando temos casos em que a empresa contratante do SBO emite boletos em mais de

uma base de dados, utilizamos este campo para distinguir de qual base o boleto foi lanado, para

evitar confuses com as numeraes internas do SBO.

Para facilitar a compreenso de seu uso e importncia, vamos utilizar como exemplo as

empresas do grupo Algodo S.A, demonstrado na Figura 19. Supondo que cada uma destas

bases hipotticas gerasse remessas de boletos para um banco em comum; no momento em que

35

o retorno do banco fosse ser importado para dentro do SBO, poderiam existir nele boletos

emitidos de cada uma das bases citadas no exemplo.

Figura 19: Exemplo de mais de uma base no SBO

Isto causaria um conflito, no que diz respeito identificao dos boletos que esto no

arquivo com os que esto nas bases das empresas, pois a maneira principal de identificao

utilizada pelo BankSync pela chave primria da tabela de boletos OBOE.BoeKey, ou seja, em

um mesmo retorno bancrio, se existissem dois boletos com o mesmo cdigo (Ex: OBOE.BoeKey

= 1), porm de bases diferentes, o BankSync no 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 identificao. 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 padro que dado quando h uma nova instalao do

BankSync, UNC. As bases ALPHA e BETHA esto devidamente configuradas, com uma chave

nica distinta para cada uma delas; enquanto que a base DELTA no possui qualquer

identificao. Como no existem chaves repetidas, no haver problemas de identificao entre

as bases, com exceo a base DELTA, pois esta no possui chave nica, e poder causar

problemas at para as outras bases.

36

Tabela 2: Chaves dos boletos das empresas do grupo Algodo S.A

6.1.2. Configuraes gerais

A tela de Configuraes gerais, disponvel em Mdulos | Administrao | Inicializao do

Sistema | Configuraes gerais, apresenta vrias configuraes importantes para o SBO, porm

para o BankSync, apenas o campo Pasta Boleto que se encontra na aba Caminho, de

extrema importncia.

Este caminho serve para indicar onde se encontram as DLLs no momento em que o SBO

vai criar um boleto de Contas a Receber. Para que as DLLs apaream na lista de Algoritmos de

cdigo de barras, em Formas de pagamento, necessrio que elas estejam na pasta Boleto,

dentro do diretrio onde o SBO fora instalado. Geralmente este diretrio C:\Arquivos de

Programas\SAP\SAP Business One\Boleto.

Figura 20: Configuraes Gerais

37

OBS: importante ressaltar que o diretrio que o SBO usa para buscas as DLLs que

podero ser escolhidas na tela de Forma de Pagamento no necessariamente o mesmo de

onde ele ir buscar as DLLs no momento em que o SBO ir criar um boleto de Contas a

Receber. Isto geralmente causa confuso entre os usurios. 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 bancrias da empresa

O cadastro de contas bancrias da empresa possibilita o cadastro de contas bancrias

para uso dentro do sistema, em especial para a contabilizao de pagamentos e recebimentos.

Este cadastro utilizado principalmente em conjunto com a Forma de Pagamento; e alguns dos

campos presentes nesta tela so requisitos para o uso apropriado das DLLs associadas s

formas de pagamento. Para acessar esta tela (Figura 21), acesse: Mdulos | Administrao |

Configuraes | Banco | Contas bancrias da empresa.

Figura 21: Contas bancrias da empresa

O preenchimento da maioria de seus campos de fcil compreenso, contudo existem

alguns que precisam de especial ateno e que so destacados na sequncia:

38

Cdigo do Banco BankCode

Cdigo utilizado para identificao do banco;

Nmero da conta Account

Nmero da conta bancria da empresa. Informe apenas nmeros, e no informe os dgitos

verificadores, j que estes possuem um campo prprio para eles;

Filial Branch

Este campo o nmero da agncia do banco onde a empresa possui a conta. Informar o

valor sem os dgitos verificadores e utilize apenas nmeros;

Chave de controle ControlKey

Utilize este campo para informar o dgito verificador da Agncia, caso ela tenha algum;

Dgito de controle da conta AccountChk

Informe o dgito verificador do nmero da conta da empresa neste campo. Em caso de

existirem mais de um dgito verificador para o nmero da conta, utilize o campo Usurio n 1

(DSC1.UsrNumber1);

Nosso Nmero OurNum

Informe aqui o nmero que deseja para o prximo 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;

Nmero do Acordo AgreeNum

Este campo deve ser utilizado para complementar o campo Nosso Nmero;

Conta contbil GLAccount

4 Para maiores detalhes sobre como deve ser feito o preenchimento do campo Nosso Nmero, consulte o captulo

referente s DLLs.

39

Esta a conta contbil que ir ser utilizada quando o boleto for finalmente finalizado.

Importante ressaltar que um boleto s ser finalizado aps o mesmo ter sido consolidado.

Dependendo do seu tipo de contabilidade, caso queira que suas movimentaes bancrias

sejam diferentes para cada conta ou banco, aconselhamos criar uma conta contbil para cada

banco. O mesmo deve ser feito para a Conta contbil provisria, a conta do Banco de

cobrana e a conta do Banco de desconto, que esto descritos na sequncia.

Conta contbil provisria GLIntrAct

Esta conta utilizada quando o boleto foi reconciliado e a Forma de Pagamento est

marcada com a opo Lanar na conta contbil provisria.

Banco de cobrana BankCollec

Conta utilizada quando o boleto passado para o status de pago, e a maneira escolhida

para seu pagamento foi a de cobrana.

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 cdigo do leiaute de extrato CNAB para importaes de extrato

neste banco.

Leiaute de Importao por DDA U_CodeILAY

Informe neste campo o cdigo do leiaute de retorno bancrio, para importaes de

arquivos para DDA. Este campo mostrar apenas leiautes marcados como DDA, no cadastro de

leiautes de retorno. Somente contas bancrias da empresa que possuem este campo preenchido

estaro disponveis para seleo durante o assistente de Importao de Boletos por DDA.

Nmero do Contrato U_Contract

Este campo de uso especial para as DLLs do BankSync.

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

40

6.1.4. Formas de pagamento

Localizada em Mdulos | Administrao | Configuraes | Banco | Formas de pagamento,

as formas de pagamento so 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

transferncias de Contas a Pagar.

Veja na sequncia, como deve ser feito o preenchimento de seus campos. Utilize a Figura

22 para auxiliar na identificao dos campos:

Figura 22: Forma de pagamento

Cdigo da forma de pagamento PayMethCod

41

Informe um cdigo para a forma de pagamento. Aconselha-se a utilizar um cdigo que

indique o tipo, a conta e o banco ao qual a forma de pagamento pertence, mas no h nada que

lhe impea de utilizar da forma que melhor achar.

Descrio Descript

Uma descrio mais significativa, do que o cdigo, para o mtodo 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 mtodo ser utilizado no pagamento de contas. Dependendo

das combinaes utilizadas entre Tipo de Pagamento e Meio de Pagamento, alguns

componentes podem aparecer, ou no.

Banco da empresa BankCountr, BankDflt, DflAccount, Branch, BankCtlKey

Aqui, deve-se escolher uma das contas bancrias da empresa que foram cadastradas

anteriormente. Para facilitar a escolha, clique sobre o boto , que est ao lado do campo Pas.

Uma tela, conforme demonstrado na Figura 23, ir aparecer permitindo-lhe escolher uma conta.

42

Figura 23: Escolha da conta bancria da empresa

Caractersticas do Boleto

Destaca-se em especial, o boto . Este boto est disponvel apenas quando o Tipo de

Pagamento for Recebido, e o Meio de Pagamento for Boleto. Ao clicar-se sobre ele, uma nova

janela ir aparecer (Figura 24).

43

Figura 24: Propriedades do boleto

Nesta tela, devem ser preenchidos os dados conforme instrudo no manual CNAB do

banco em questo. Alguns campos foram adicionados a partir da verso 8.82 do SBO como:

Instruo de cancelamento, Cdigo de ocorrncia e Cdigo de movimento que um campo

Obrigatrio para gerar a remessa pelo BankSync.

Mas importante citar o preenchimento de dois campos alm dos citados acima, que so

particularmente importantes para as DLLs: O N do portflio e o Cdigo da Moeda.

Primeiro, com relao ao cdigo da moeda, a no ser que seja especificado de maneira

diferente, este cdigo dever ser sempre 9 ou 0. O cdigo 9 simboliza a moeda Real, enquanto

0 simboliza um valor neutro, e que o banco ir trat-lo em sua moeda padro, ou de outra

maneira especificada pelo manual do banco.

Com relao ao campo do portflio, tambm chamado de carteira no banco, o valor que

interessa para o programa o que est presente em N do portflio. Para cadastrar/editar este

valor, basta clicar sobre o boto ao lado do campo Id portflio interno. Isto ir abrir uma nova

tela, vista na Figura 25.

44

Figura 25: Lista de Carteiras

Clicando para editar, ou criar um novo registro, aparecer tela presente na Figura 26.

Figura 26: Cadastrar carteira

Enviar para aprovao SendAccept

45

Quando esta opo estiver marcada (Figura 27), novos boletos sero sugeridos para

serem criados com o status de Enviado, ao invs de Gerado. Isto permite para o usurio um

controle mais facilitado dos boletos que j fazem parte de uma remessa, pois eles estaro com o

status igual a Gerado.

Figura 27: Opo para aprovao

OBS: Caso esta opo no esteja marcada, novos boletos sero criados com o status de

Gerado. Porm, isto no ser problema para o BankSync, pois ele possui um controle interno dos

boletos que j foram includos em uma remessa.

Algoritmo do cdigo de barras BoeDLL

Este campo (Figura 28) aparece apenas quando a Forma de pagamento est com Meio

de pagamento igual a Recebido e Tipo de pagamento igual a Boleto. neste campo que o

usurio escolhe onde e qual das DLL de forma de pagamento ele ir utilizar.

Figura 28: Escolher uma DLL

Caso a DLL que voc esteja procurando no esteja disponvel na lista, clique sobre a

opo Definir Novo, mostrado na Figura 28, e informe o caminho at sua DLL na tela que

46

aparece (Figura 29). Isto far com que a DLL seja copiada para a pasta, considerando uma

instalao padro do SBO, no caminho: C:\Arquivos de Programas\SAP\SAP Business

One\Boleto.

Figura 29: Caminho para inserir a DLL

OBS: para evitar erros, mantenha as DLLs atualizadas e se possvel na pasta de

instalao do SBO, que geralmente encontra-se no seguinte caminho (C:\Arquivos de

Programas\SAP\SAP Business One\Boleto).

6.1.5. Parmetros do BankSync

Ao clicar sobre o boto , o qual est disponvel apenas para formas de

pagamento para Boletos de Recebido e Pago, ou para Transferncias de Pago. Ir aparecer

uma tela contendo algumas informaes que so de relevncia para o BankSync. Uma amostra

da tela se encontra abaixo na Figura 30:

47

Figura 30: Parmetros do BankSync

O campo de Nmero Sequencial de Remessa automaticamente incrementado toda vez

que uma remessa, utilizando aquela forma de pagamento, realizada.

Os campos de Leiaute de Remessa e Leiaute de Retorno apontam para o leiaute que

dever ser usado no momento em que um processo de remessa ou retorno, for utilizar esta forma

de pagamento. Caso o tipo da Forma de pagamento seja de Recebido, apenas leiautes de

Contas a Receber iro aparecer; se for de Pago, aparecero apenas os de Contas a Pagar.

Por ltimo, a Conta contbil para tarifas bancrias a conta que deve ser utilizada, para

aquela forma de pagamento, quando um boleto apresentar uma tarifa cobrada pelo banco.

Os campos que esto abaixo de conta contbil para tarifas bancrias no devem ser

alterados. Eles so utilizados apenas em casos muito especiais, e a m configurao destes

poder causar inconsistncias em sua contabilidade.

48

6.2. Telas do BankSync

Esta sesso do manual ir demonstrar e explicar as telas de configurao apresentadas

pelo BankSync.

OBS: no iremos apresentar a tela de leiaute de Extrato Bancrio (no CNAB), por ser um

leiaute raramente utilizado. possvel importar arquivos de extrato do banco, que so separados

por , por meio de uma prpria tela do SBO.

6.2.1. Nomenclatura de Arquivo de Remessa

O cadastro de Nomenclatura de Arquivo de Remessa tem por objetivo, oferecer uma

regra de nomenclatura personalizvel para os arquivos gerados pelas remessas do BankSync.

Esta tela est disponvel em Mdulos | Administrao | Configuraes | Banco | BankSync |

Nomenclatura de arquivo de remessa, um exemplo desta tela encontra-se abaixo na Figura 31.

Figura 31: Nomenclatura de arquivo de remessa

49

Cdigo - Code

Um cdigo nico para este cadastro.

Descrio Name

Descrio para a nomenclatura.

Diretrio base U_BasePath

Este o diretrio em que o BankSync ir criar seu arquivo de remessa.

OBS: caso o diretrio esteja errado e/ou a pasta no exista, o BankSync acusar um erro.

Criar subdiretrio pelo nome da Forma de Pagamento U_Subdirs

Caso esta opo esteja marcada, o BankSync ir criar o arquivo de remessa dentro de

uma pasta adicional ao caminho em diretrio base, utilizando como nome para este nova pasta, o

cdigo da forma de pagamento.

Exemplificando, imaginem que a forma de pagamento tenha um cdigo igual a P0001, os

arquivos de remessa gerados para esta forma de pagamento, seriam localizados no diretrio

C:\BankSync\Export\P0001.

Definio de Nomenclatura

Figura 32: Grade para definies da Nomenclatura de arquivo de remessa

50

Nesta grade, podemos personalizar como ser feita a montagem do nome do arquivo

gerado pela remessa. Os botes Adicionar linha e Remover linha manipula a quantidade de

linhas para montar a estrutura do nome. Segue uma descrio das colunas desta grade:

Para auxiliar nos exemplos, vamos assumir que o leiaute em questo 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 tambm de descrio. Ajuda a identificar o propsito desta linha.

Pos U_Position

A posio que o contedo desta linha ir assumir dentro do nome do arquivo montado.

Em nosso exemplo, a posio para a data da remessa inicia na quarta posio 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 espaos faltantes feito com base no tipo, conforme

demonstrado no prximo tpico.

Tipo U_Type

O tipo do registro serve como uma validao da linha, para garantir que o pedao em

questo do nome atenda a um dos critrios pr-estabelecidos. Os valores que ele pode assumir

so:

Texto Fixo: Utilizado quando o programa no deva apresentar um tratamento para este

campo;

Contador: Representa um valor numrico que ir aumentar a cada nova remessa gerada;

Contador dirio: Idntico ao Contador, exceto que a cada novo dia, o contador

reiniciado para 1 novamente;

51

Datetime: Indica que o valor final uma data, e ir tentar converter a data informada em

contedo, caso esta seja diferente de vazia;

Contedo U_Value

Contedo o valor que ser utilizado no nome do arquivo. No caso de Datetime, se o

campo Contedo estiver vazio, o sistema pegar a data de hoje. Para os campos Contador e

Contador Dirio, deve-se colocar pelo menos o valor 1 para que o programa comece a

incrementar a partir dele.

Formato U_Value

Formato define que validao dever ser utilizada, e como o valor dever ser mostrado no

nome do arquivo.

A formatao que ele ir apresentar e se existir alguma particularidade, esto descritos na

sequncia:

Livre: O programa no realiza qualquer validao sobre este trecho do nome;

Maiscula: Converte todo o valor presente em Contedo para letras maisculas;

Minscula: Converte todo o valor presente em Contedo para letras minsculas;

Numrico: Converte o valor para um nmero, descartando os pedaos de Contedo que

no forem numricos;

Data/Hora: Quando formatado como data, o valor que ser utilizado o do dia atual do

relgio de seu sistema operacional. As letras presentes ao lado de Data indicam qual o formato

que ela ir adotar:

d: Dia; m: Ms; y: Ano; H: Hora; m: Minuto;

Quando as letras aparecem mais de uma vez, a formatao ir forar com que zeros

estejam presentes quando o nmero no alcanar a quantidade de letras. Ex: dia 2 de outubro de

2010, para a mscara dd/mm, ser formatado como 02/10.

52

Visualizando o modelo de exemplo

Figura 33: Modelo de exemplo

Esta tela apresenta uma funcionalidade que permite ao usurio verificar como ser gerada

a nomenclatura do arquivo.

Ao clicar sobre o boto Ver Exemplo, o programa ir gerar sobre o campo Exemplo o

nome que aquele leiaute ir produzir aps gerar uma remessa. Importante ressaltar que antes de

visualizar o exemplo, deve-se salvar qualquer alterao pendente na tela, pois do contrrio, 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 padro CNAB oferecido pelos bancos, para efetuar os pagamentos ou recebimentos

eletrnicos. Cada leiaute de arquivo de remessa tem suas prprias particularidades dependendo,

lgico, do banco em questo, mas todos sem excees utilizam-no como base, o padro

Febraban (Federao Brasileira de Bancos). O cadastro de arquivo de leiaute de remessa

encontra-se di