Manual Funcional

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

SBO: SAP Business One

Sumrio
Sumrio
1. Introduo ao BankSync _________________________________________________________ 11 2. Comunicao bancria ___________________________________________________________ 11
2.1. 2.2. Boletos _____________________________________________________________________________ 12 Transferncias ______________________________________________________________________ 12

3. Comunicao bancria dentro do SAP Business One _______________________________ 13

3.1. 3.2. Boletos _____________________________________________________________________________ 13 Boletos de Contas a Receber ________________________________________________________ 14
Enviado __________________________________________________________________________________ 14 Gerado ___________________________________________________________________________________ 14 Depositado _______________________________________________________________________________ 15 Pago _____________________________________________________________________________________ 15 Cancelado________________________________________________________________________________ 16 Sem xito ________________________________________________________________________________ 17

3.2.1. 3.2.2. 3.2.3. 3.2.4. 3.2.5. 3.2.6.

3.3.

Boletos de Contas a Pagar ___________________________________________________________ 17

Gerado ___________________________________________________________________________________ 18 Pago _____________________________________________________________________________________ 18 Cancelado________________________________________________________________________________ 18

3.3.1. 3.3.2. 3.3.3.

3.4. 3.5.

Transferncias ______________________________________________________________________ 19 Particularidades do processo adaptado _______________________________________________ 21

4. Informaes tcnicas ____________________________________________________________ 22

4.1. 4.2. 4.3. Tecnologia _________________________________________________________________________ 22 Conexo Remota ____________________________________________________________________ 22 Suporte Tcnico ____________________________________________________________________ 22

5. Instalao _______________________________________________________________________ 23
5.1. 5.2. 5.3. 5.4. Download do Software_______________________________________________________________ 23 Registro do Add-On no SBO _________________________________________________________ 23 Instalao do Add-On no SBO________________________________________________________ 25 Primeira execuo do BankSync _____________________________________________________ 28
Senha para o banco de dados _____________________________________________________________ 28 Dados padres das tabelas do BankSync __________________________________________________ 29 Chave de ativao ________________________________________________________________________ 29

5.4.1. 5.4.2. 5.4.3.

5.5.

Licenas para Add-Ons da SAP ______________________________________________________ 30 3

5.5.1. 5.5.2.

Adquirindo uma licena ___________________________________________________________________ 30 Atribuindo as licenas ____________________________________________________________________ 31

5.6.

Configurando usurios do BankSync no SBO _________________________________________ 31

6. Configuraes ___________________________________________________________________ 33
6.1. Telas do SAP Business One _________________________________________________________ 33
Detalhes da empresa _____________________________________________________________________ 34 Configuraes gerais _____________________________________________________________________ 36 Contas bancrias da empresa _____________________________________________________________ 37 Formas de pagamento ____________________________________________________________________ 40 Parmetros do BankSync _________________________________________________________________ 46 6.1.1. 6.1.2. 6.1.3. 6.1.4. 6.1.5.

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

Filtragem ________________________________________________________________________________ 114 Escolha dos ttulos ______________________________________________________________________ 115 Resultados ______________________________________________________________________________ 120 Reconciliao dos boletos _______________________________________________________________ 121

7.2.1. 7.2.2. 7.2.3. 7.2.4.

7.3.

Importao do extrato bancrio CNAB _______________________________________________ 122

Filtragem ________________________________________________________________________________ 122 Escolha das linhas de extrato ____________________________________________________________ 124 Resultados ______________________________________________________________________________ 127

7.3.1. 7.3.2. 7.3.3.

7.4.

Processo de importao de boletos por DDA _________________________________________ 128

Configuraes ___________________________________________________________________________ 129 Seleo e correo dos boletos __________________________________________________________ 130

7.4.1. 7.4.2.

8. Databases ______________________________________________________________________ 134

8.1. 8.2. 8.3. 8.4. 8.5. 8.6. 8.7. 8.8. 8.9. Databases Boleto _________________________________________________________________ 135 Databases - Clculo ________________________________________________________________ 137 Databases - Cedente _______________________________________________________________ 138 Databases Contas a Pagar ________________________________________________________ 139 Databases - Documento ____________________________________________________________ 140 Databases - Extra __________________________________________________________________ 141 Databases Forma de Pagamento___________________________________________________ 142 Databases - Leiaute ________________________________________________________________ 145 Databases - PN_____________________________________________________________________ 146

9. DLL - Dynamic-Link Library ______________________________________________________ 150

9.1. 9.2. 9.3. Cdigo de Barras e Linha Digitvel __________________________________________________ 153 Configuraes das DLLs no SAP Business One ______________________________________ 155 Particularidades das DLLs __________________________________________________________ 158
Banco ABC ______________________________________________________________________________ 158 Banco Banrisul __________________________________________________________________________ 158 Banco Bradesco _________________________________________________________________________ 159 Banco do Brasil _________________________________________________________________________ 160 Banco BVA ______________________________________________________________________________ 162 Banco CitiBank __________________________________________________________________________ 162 Banco Fibra _____________________________________________________________________________ 163 Banco Caixa Econmica Federal _________________________________________________________ 163 Banco HSBC ____________________________________________________________________________ 166 Banco Itau ______________________________________________________________________________ 166 Banco Mercantil _________________________________________________________________________ 167 Banco Nordeste _________________________________________________________________________ 168 Banco Pine ______________________________________________________________________________ 168 Banco Real ______________________________________________________________________________ 169 Banco Safra _____________________________________________________________________________ 170 Banco Safra (Bradesco Correspondente) _________________________________________________ 170 Banco Santander ________________________________________________________________________ 171 Banco Sicredi ___________________________________________________________________________ 171 Banco Sofisa ____________________________________________________________________________ 172 Banco Unibanco _________________________________________________________________________ 173 Banco BicBanco _________________________________________________________________________ 173 Banco BicBanco (Correspondente Bradesco) _____________________________________________ 174 Banco Sofisa (Correspondente) __________________________________________________________ 175

9.3.1. 9.3.2. 9.3.3. 9.3.4. 9.3.5. 9.3.6. 9.3.7. 9.3.8. 9.3.9. 9.3.10. 9.3.11. 9.3.12. 9.3.13. 9.3.14. 9.3.15. 9.3.16. 9.3.17. 9.3.18. 9.3.19. 9.3.20. 9.3.21. 9.3.22. 9.3.23.

9.3.24. 9.3.25.

Dummy _________________________________________________________________________________ 176 Particularidade com o DV do Nosso Nmero ______________________________________________ 176

10.

Funcionalidades ______________________________________________________________ 177

OneShare ________________________________________________________________________ 177
Exportao de leiautes ___________________________________________________________________ 177 Importao de leiautes ___________________________________________________________________ 181 10.1.1. 10.1.2.

10.1.

10.2.
10.2.1. 10.2.2.

Consulta ao SERASA _____________________________________________________________ 186

Configurao da consulta SERASA _______________________________________________________ 186 Utilizao da consulta SERASA __________________________________________________________ 190

10.3. 10.4.

Lanamentos contbeis extras ____________________________________________________ 193 Backup peridico dos leiautes ____________________________________________________ 195

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

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

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

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

10

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.

11

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

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

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

13

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

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
15

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

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

17

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

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.

19

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.

20

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.

21

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.

22

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 registrlo 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 3

Site SIE: www.sistemainfo.com.br Free: Licena Free;

23

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.

24

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.

25

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.

26

Figura 10: Instalao Informaes do usurio

Figura 11: Instalao Caminho da instalao

27

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:

28

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

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

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
31

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.

32

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

33

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
34

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.

35

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

36

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

 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

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

referente s DLLs.

38

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;

39

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

40

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.

41

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

42

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 tela, vista na Figura 25. ao lado do campo Id portflio interno. Isto ir abrir uma nova

43

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

44

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
45

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 , o qual est disponvel apenas para formas de

Ao clicar sobre o boto

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:

46

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.

47

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

48

 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

49

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

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.

51

 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 disponvel acessando os seguintes mdulos: Mdulos Configuraes | Banco | BankSync | Leiaute de Arquivo de Remessa, 6.2.2.1. Definio do Leiaute | Administrao |

A definio de leiaute de arquivo de remessa nos serve como um esqueleto de nosso arquivo .txt, que ser gerado na exportao de arquivo de remessa, ele ir ser gerado exatamente na estrutura definida, na definio do leiaute. Verificamos um exemplo acompanhando a Figura 34, que ilustra a estrutura de um arquivo de remessa e analisaremos o que significa para cada tipo de campo mostrado nesta tela:

52

Figura 34: Leiaute de arquivo de remessa

Os campos que sero descritos abaixo, so referentes tela de leiaute de arquivo de remessa, parte de definio do leiaute e como devem ser seus respectivos preenchimentos: Cdigo Code Um cdigo nico para este cadastro. Nome Name Nome dado para o leiaute. Tipo de Doc. - U_PayType Para qual tipo de transao esse leiaute, ser para Contas a Pagar ou Contas a Receber.

53

 Nomenclatura - U_Filename Campo que vincula o leiaute de nomenclatura com o leiaute de remessa em questo. Aceita Caracteres Diacrticos - U_Diacriti Permite que ao gerar os arquivos de remessa, possam sair no mesmo, caracteres como ( , . ^ ~ ) dentre outros. Maisculas - U_IsUpper Faz com que toda a vez que for gerada uma remessa, todos os campos alfanumricos saiam com suas letras no formato maisculas. 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. Descrio - U_Descript Informada descrio que ter aquela linha especfica do arquivo de remessa, na maioria dos casos, podendo ser um Cabealho, 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 no 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 obrigatria, e sempre ir sair no arquivo de remessa. Tipo de Dados DataType

de grande importncia para a maioria dos bancos finalizar com uma linha em branco o arquivo .txt, pois o site do banco identifica que o arquivo

no foi finalizado caso ele no tenha uma linha em branco;

54

Ir identificar o que esta linha ser no arquivo de remessa, as opes para definio de tipos de dados so estas: Cabealho de Arquivo Cabealho de Ttulo Todos os Ttulos Ttulos do Prprio Banco Ttulos do Prprio Banco - Registrados Ttulos do Prprio Banco - No Registrados Ttulos de Outros Bancos Rodap de Ttulo Cabealho de Transferncia Cabealho de Transferncia - Prprio Banco Cabealho de Transferncia - Outros Bancos Rodap de Transferncia Rodap de Arquivo Herdar do Nvel Anterior

Nvel - U_Level O nvel ir definir ao sistema a ordem de impresso dos arquivos de remessa, lembrando sempre que dados como cabealho e rodap, sempre tem de ser do mesmo nvel. Segue abaixo na Tabela 3, um exemplo simples de nivelamento dos arquivos de remessa, contado que temos um registro de cabealho, um registro de detalhe e um registro de rodap:

Tabela 3: Nivelamento do arquivo de remessa

55

 Tamanho - U_Size O campo ir definir o tamanho do arquivo de remessa, ou seja, se for um CNAB 400, o tamanho deste campo deve ser 400. Neste caso cada linha do arquivo remessa ir sair com 400 caracteres, caso seja CNAB 240 o tamanho do campo deve ser 240, e cada linha do arquivo de remessa ter 240 caracteres. 6.2.2.2. Definio do Registro

Utilizando o boto Definio do Registro ou clicando duas vezes sobre ele, ir abrir a tela de definio de registro. Aps informar todo o contedo referente definio do leiaute, sero informadas as linhas do arquivo, ou seja, todos os dados que a linha em questo ir conter, conforme a Figura 35.

Figura 35 Tela de Definio de Registro

56

 Registro Name Essa linha contm a mesma informao que foi dada na tela de Definio de Leiaute, ele somente replica esse nome para a tela de Definio de Registros. Descrio - U_Name Informar descrio que ter o campo, referente linha do arquivo de remessa em questo, ou seja, o que este campo significa. OBS: a descrio dos campos independente do nvel (Cabealho, 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 informaes para a correta configurao do leiaute de remessa. Posio - U_Position Este campo um auto contador, ele se ajusta conforme a quantidade de caracteres do campo anterior, somando assim automaticamente. Iniciando sempre da posio um, o tamanho mximo permitido baseado no campo Tamanho da tela de Definio de Leiaute, ou seja, o contador vai acusar erro caso a posio do ultimo campo, somado a quantidade do prximo 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 questo. 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 prpria configurao informa, FIXO. 1 - Data Base: Um campo data base um tipo de campo que permite ao usurio buscar dados de campos do SBO, como por exemplo: Nome do PN, Endereo do PN, dentre outros campos.

57

 2 Categoria: Este tipo de campo nos possibilita criar mais de uma condio para um nico campo, por exemplo, quando vier um nmero 0 eu gostaria que este campo me trouxesse o Nome do PN, caso venha 1 gostaria que retornasse o Nome do Cedente, ou seja, em um nico campo o usurio poder possuir dois tipos de retorno. 3 - SQL Select: O BankSync possibilita ao usurio informar uma consulta SQL Select para que retorne o valor desejado. Alguns campos do Business One no tem opo em nosso tipo de campo Data Base. Sendo assim o usurio 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.

Definio do Campo

Na Definio do Campo, o usurio informa o formato deste campo, o alinhamento e o preenchimento do mesmo, alm de sua posio e suas propriedades especficas.

Texto Fixo
Para a definio de um campo Texto Fixo, necessrio realizar algumas configuraes, (Figura 36), que sero abordadas abaixo:

58

Figura 36: Definio do campo texto fixo

Campo Name O nome que sempre vir neste campo o mesmo nome que o usurio j definiu no campo Descrio, na tela de Definio de Registro.

Propriedades Gerais

Tipo - U_Type O tipo de documento ser sempre o mesmo que estiver no campo Tipo da tela de Definio de Registro. Formato - U_Format 0 - Livre 1 - Alfabtico
59

2 - Alfanumrico 3 - Numrico 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) - Espao (_) - Underscore (-) - Hifen

OBS: quando o campo for de formato Numrico, Decimal 2 ou Decimal 5, o seu alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato Alfanumrico, Alfabtico ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda + Espao. Posio - U_Pos / Tamanho - U_Siz Digamos que o usurio tenha um campo de 44 posies, por exemplo, um cdigo de barras, e ele gostaria de pegar apenas os 3 primeiros dgitos desse cdigo de barras, que seria o nmero do banco. Dessa forma o usurio deve preencher o campo Posio, com a posio em que ele se encontra, que neste caso a posio 1 (os trs primeiros dgitos do cdigo de barras), e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso 3. A configurao ir ficar conforme a Figura 37.

60

Figura 37: Configurao da posio para cdigo de barras

Propriedades Especficas

Texto Fixo - U_Text No campo Texto Fixo, o usurio deve preencher com os caracteres que ele sempre deseja que saia em seu arquivo de remessa, pois como o prprio campo diz Fixo, ou seja, sempre sair com os caracteres que estiverem preenchidos neste campo.

Database
Para a definio de um campo Database, necessrio realizar algumas configuraes, (Figura 38), que sero abordadas abaixo:

61

Figura 38 Definio do campo database

Campo Name O nome que sempre vir neste campo o mesmo nome que o usurio j definiu no campo Descrio, na tela de Definio de Registro.

Propriedades Gerais

Tipo - U_Type O tipo de documento ser sempre o mesmo que estiver no campo Tipo da tela de Definio de Registro.
62

 Formato - U_Format

0 - Livre 1 - Alfabtico 2 - Alfanumrico 3 - Numrico 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) - Espao (_) - Underscore (-) - Hifen

OBS: quando o campo for de formato Numrico, Decimal 2 ou Decimal 5, o seu alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato Alfanumrico, Alfabtico ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda + Espao. Posio - U_Pos / Tamanho - U_Siz Digamos que o usurio tenha um campo de 44 posies, por exemplo, um cdigo de barras, e ele gostaria de pegar apenas os 3 primeiros dgitos desse cdigo de barras, que seria o nmero do banco. Dessa forma o usurio deve preencher o campo Posio, com a posio em que ele se encontra, que neste caso a posio 1 (os trs primeiros dgitos do cdigo de barras),

63

e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso 3. A configurao ir ficar conforme a Figura 39.

Figura 39: Configurao da posio para cdigo de barras

Propriedades Especficas

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, Endereo do PN, dentre outros campos de tabelas do Business One que temos disponveis como bases de dados (data base).

Categoria
Para a definio de um campo Categoria, necessrio realizar algumas configuraes, (Figura 40), que sero abordadas abaixo:

64

Figura 40: Definio do campo categoria

Campo Name O nome que sempre vir neste campo o mesmo nome que o usurio j definiu no campo Descrio, na tela de Definio de Registro. Propriedades Gerais

Tipo - U_Type O tipo de documento ser sempre o mesmo que estiver no campo Tipo da tela de Definio de Registro. Formato - U_Format

0 - Livre 1 - Alfabtico
65

2 - Alfanumrico 3 - Numrico 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) - Espao (_) - Underscore (-) - Hifen

OBS: quando o campo for de formato Numrico, Decimal 2, Decimal 5, o seu alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato Alfanumrico, Alfabtico ou Livre o seu alinhamento e preenchimento devem ser: Esquerda + Espao. Posio - U_Pos / Tamanho - U_Siz Digamos que o usurio tenha um campo de 44 posies, por exemplo, um cdigo de barras, e ele gostaria de pegar apenas os 3 primeiros dgitos desse cdigo de barras, que seria o nmero do banco. Dessa forma o usurio deve preencher o campo Posio, com a posio em que ele se encontra, que neste caso a posio 1 (os trs primeiros dgitos do cdigo de barras), e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso 3. A configurao ir ficar conforme a Figura 41.

66

Figura 41: Configurao da posio para cdigo de barras

Propriedades Especficas

Tipo de Retorno: U_RetType 0 Texto Fixo 1 Base de Dados

Valor Padro - U_Text A informao configurada nesse campo ser utilizada quando nenhumas das condies presentes na grade forem verdadeiras. Grade de Dados

Condio - U_CondOp Este campo sempre vai estar preenchido com a condio que o usurio deseja que o addon faa, como por exemplo: 0 - Menor que ou igual a 1 - Menor que 2 - Igual a 3 - Diferente de 4 - Maior que 5 - Maior que ou igual a

67

 Valor - U_CondVal O campo valor sempre vai conter o valor para o add-on efetuar a condio, como por exemplo: digamos que a condio selecionada seja 0 Menor que ou igual a, e no campo Valor, para que o add-on efetue essa condio, o usurio coloque 5, ento o sistema vai sempre verificar a condio Menor que ou igual a 5, conforme a Figura 42.

Figura 42: Configurao da coluna condio e valor

Texto Fixo - U_Text Quando preenchido o campo texto fixo, ele far a condio 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 usurio.

SQL Select
Para a definio de um campo SQL Select, necessrio realizar algumas configuraes, (Figura 43), que sero abordadas abaixo:

68

Figura 43: Definio do campo SQL Select

Campo Name O nome que sempre vir neste campo o mesmo nome que o usurio j definiu no campo Descrio, na tela de Definio de Registro.

Propriedades Gerais

Tipo - U_Type O tipo de documento ser sempre o mesmo que estiver no campo Tipo da tela de Definio de Registro. Formato - U_Format

0 - Livre
69

1 - Alfabtico 2 - Alfanumrico 3 - Numrico 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) - Espao (_) - Underscore (-) - Hifen

OBS: quando o campo for de formato Numrico, Decimal 2 ou Decimal 5, o seu alinhamento e preenchimento devem ser: Direita + Zero. Quando o campo for de formato Alfanumrico, Alfabtico ou Livre, o seu alinhamento e preenchimento devem ser: Esquerda + Espao. Posio - U_Pos / Tamanho - U_Siz Digamos que o usurio tenha um campo de 44 posies, por exemplo, um cdigo de barras, e ele gostaria de pegar apenas os 3 primeiros dgitos desse cdigo de barras, que seria o nmero do banco. Dessa forma o usurio deve preencher o campo Posio, com a posio em que ele se encontra, que neste caso a posio 1 (os trs primeiros dgitos do cdigo de barras), e no campo Tamanho, ele informa o tamanho do valor que ele deseja, neste caso 3. A configurao ir ficar conforme a Figura 44.

70

Figura 44: Configurao da posio para cdigo de barras

SQL Select

Select - U_Select Neste campo deve conter a consulta SQL que o usurio deseja utilizar, lembrando que o usurio deve colocar a consulta sem a palavra Select, pois est palavra j est implementada no prprio 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 esto contidos dentro do arquivo de retorno, e retornar estes ao sistema, para que sejam assim importados e efetuados os pagamentos ou recebimentos dos documentos que j foram enviados ao banco. Os leiautes de arquivo de retorno (Figura 45) contm algumas abas para cadastro que sero explicadas posteriormente. Para cadastrar um Leiaute de Arquivo de Retorno, basta acessar os seguintes mdulos: Mdulos | Administrao | Configuraes | Banco | BankSync | Leiaute de Arquivo de Retorno,
71

Figura 45: Leiaute de Arquivo de Retorno

Os campos que sero descritos abaixo, so referentes tela de leiaute de arquivo de retorno parte fixa. Aps descrevermos estes, vamos analisar os campos que esto contidos em suas respectivas abas (Identificao, Ocorrncias, Erros, Validao). Cdigo Code Um cdigo nico para este cadastro. Nome Name Nome dado para o leiaute. Tipo de Doc. - U_PayType Para qual tipo de transao esse leiaute ser: Contas a Pagar, Contas a Receber ou DDA.
72

6.2.3.1.

Identificao

Nmero de Linhas de um Ttulo - U_LineCnt Informar neste campo o nmero de linhas de ttulos que possuem o seu arquivo de retorno. Muitas vezes os bancos colocam alguns dos valores dos ttulos ou datas, na segunda linha do ttulo. Caso a quantidade informada for 1, o add-on ir capturar valores diferentes do desejado, pois estar procurando na linha incorreta.

Cabealho

Identificao - U_HeadVl Informamos neste campo qual a identificao que define o cabealho de nosso arquivo de retorno. Posio - U_HeadPs Cadastramos neste campo a posio desta identificao. Tamanho - U_HeadSz Neste campo informamos o tamanho desta identificao. Para melhor visualizar, segue abaixo um exemplo de cadastro (Figura 46).

Figura 46: Leiaute de arquivo de retorno, Cabealho

73

Figura 47: Arquivo de retorno

Sabendo que a primeira posio da primeira linha composta por 0, automaticamente o BankSync ir identificar isso como sendo o Cabealho do Arquivo de Retorno (Figura 47).

Ttulo

Identificao - U_IdValue Informamos neste campo qual a identificao que define os ttulos de nosso arquivo de retorno. Posio - U_IdPos Cadastramos neste campo a posio desta identificao. Tamanho - U_IdSiz Neste campo informamos o tamanho desta identificao. Para melhor visualizar, segue abaixo um exemplo de cadastro (Figura 48).

Figura 48: Leiaute de arquivo de retorno Ttulo

74

Figura 49: Arquivo de retorno

Sabendo que a primeira posio da segunda linha composta por 1, automaticamente o BankSync ir identificar isso como sendo um ttulo de seu arquivo de retorno (Figura 49), ou seja, cada vez que conter o nmero 1 na primeira posio da linha, ser mais um ttulo para o add-on identificar.

Identificao do Documento

Posio - U_BoEKPos O BankSync permite ao usurio cadastrar na tela de Detalhes da Empresa, Mdulos | Administrao | Inicializao do Sistema | Detalhes da Empresa, o campo Chave nica da Empresa (Figura 50), ao gerar o arquivo de remessa. Temos um campo que configuramos para utilizar esta informao, cujo valor um database chamado Boleto - Chave nica, composto por Chave nica da Empresa + OBOE.BoeKey. baseado neste dado, que sai na remessa e tambm vem no arquivo de retorno (Figura 52), que o BankSync ir identificar o ttulo dentro do Business One, bastando neste campo informar qual a posio que ele comea. Para melhor visualizar veja o exemplo de cadastro abaixo (Figura 51). Tamanho - U_BoEKSiz Informar o tamanho desta identificao do documento, ou seja, quantos caracteres ele ir possuir. Linha - U_BoEKLin Em qual linha do ttulo esta identificao se encontra.
75

Figura 50: Detalhes da empresa Identificao da Empresa

Figura 51: Leiaute de arquivo de retorno Identificao do Documento

Figura 52: Arquivo de retorno chave nica

Na hora da importao do arquivo de retorno o BankSync efetua a seguinte verificao, partindo da posio 38, conta 25 caracteres, na linha informada, e avalia se o documento em questo realmente consta em sua base do Business One.

Identificao Alternativa do Boleto A primeira verificao que o BankSync faz a identificao do documento. Caso esta identificao no funcione por algum motivo de configurao, o BankSync passa para outro tipo de identificao, a Identificao Alternativa, que utiliza quatro campos para se identificar; Portflio, Nosso Nmero, Dgito Verificador do Nosso Nmero e Nmero da Nota Fiscal (Serial). Para o BankSync identificar qualquer documento, pela identificao especial, todas as informaes devem vir de maneira correta, ou seja, caso alguma das informaes no baterem com os dados reais deste ttulo, o add-on automaticamente desconsiderar esta identificao e passar para a Identificao Especial que ser vista no prximo tpico deste manual.

76

Caso ento o usurio j saiba que, por exemplo, o Nosso Nmero e o Dgito Verificador esto incorretos em seu arquivo de retorno, o prprio usurio deve preencher tais campos com 0 na posio, 0 no tamanho e 0 na linha, assim o add-on ir buscar apenas os campos configurados, e desta forma a Identificao Alternativa funcionar. Veja o exemplo abaixo (Figura 53).

Figura 53: Leiaute de arquivo de retorno Identificao Alternativa

Portflio

Posio - U_PortPos Deve ser preenchida a posio de incio do nmero do portflio. Tamanho - U_PortSiz Informar o tamanho do portflio. Linha - U_PortLin Cadastrar em qual linha os caracteres se encontra.

Nosso Nmero

Posio - U_OurNmPos Deve ser preenchida a posio de incio do nosso nmero.

77

 Tamanho - U_OurNmSiz Informar o tamanho do nosso nmero. Linha - U_OurNmLin Cadastrar em qual linha os caracteres se encontra.

Dgito

Posio - U_ONmCkPos Deve ser preenchida a posio de incio do dgito verificador do nosso nmero. Tamanho - U_ONmCkSiz Informar o tamanho do dgito verificador do nosso nmero. Linha - U_ONmCkLin Cadastrar em qual linha os caracteres se encontra.

Nmero da Nota Fiscal

Posio - U_SerialP Deve ser preenchida a posio de incio do dgito verificador do nosso nmero. Tamanho - U_SerialS Informar o tamanho do dgito verificador do nosso nmero. Linha - U_SerialL Cadastrar em qual linha os caracteres se encontra.

78

Identificao Especial A identificao especial a ltima tentativa feita pelo add-on para identificar o ttulo em questo. Ele baseia-se em apenas um dado que o usurio poder escolher, bastando configurar o campo Tabela e escolher o Campo que voc quer utilizar de acordo com a informao que voc busca. Segue exemplo de cadastro deste campo Identificao Especial (Figura 54).

Figura 54: Identificao Especial

Tabela - U_SpecTbl Informar a tabela na qual o usurio deseja fazer a identificao especial. OBOE - Boletos OPYM - Forma de Pagamento OPTF - Portflio @SIEBS_BOEC - BankSync: Controle de Boletos OINV - Nota Fiscal de Sada RCT2 - Notas Fiscais de Contas a Receber

Campo - U_SpecFld Aps selecionar a tabela desejada, o campo Campo ir trazer todos os campos disponveis desta tabela para utilizao do usurio, bastando o mesmo escolher o campo desejado. Formato - U_SpecFor Escolher o formato referente ao campo escolhido no campo Campo. 0 - Alfanumrico
79

1 - Numrico

Posio - U_SpecPos Deve ser preenchida a posio de incio do campo em questo. Tamanho - U_SpecSiz Informar o tamanho do campo em questo. Linha - U_SpecLin Cadastrar em qual linha os caracteres se encontram. 6.2.3.2. Ocorrncias

Em seu arquivo de retorno, o banco envia uma ocorrncia, essa nada mais do que uma informao do acontecimento, que ocorreu com seu documento dentro do banco, se ele foi pago, depositado, rejeitado, dentre outras opes (Figura 55).

80

Figura 55: Leiaute de arquivo de retorno - Ocorrncias

Posio - U_IdOcoPos Deve ser preenchida a posio de incio do campo ocorrncia. Tamanho - U_IdOcoSiz Informar o tamanho do campo ocorrncia. Linha - IdOcoLin Cadastrar em qual linha os caracteres se encontram. Entrada Normal - U_IdOkVal Deve ser informado o valor que o banco estipulou em seu manual, para conhecimento de quando o arquivo simplesmente deu entrada no banco, ou quando ele foi depositado.

81

 Liquidao - U_IdPayVal Deve ser informado o valor que o banco estipulou em seu manual, para quando o arquivo foi liquidado, ou seja, Pago.

Identificao de Ocorrncias

O banco informa em seu manual, vrias ocorrncias que tem de ser cadastradas na grid de Identificao de Ocorrncias, note abaixo um exemplo de uma lista de ocorrncias de um banco qualquer (Figura 56).

Figura 56: Cdigos de Ocorrncias

Cdigo - U_IdOcor Cdigo informado neste campo tem de ser o mesmo cdigo que informa o manual do banco, como mostra o exemplo da figura acima (Figura 56). Descrio - U_DescOcor Descrio informada neste campo tem de ser a mesma descrio que informa o manual do banco. Ao - U_Action Aps cadastrar o cdigo da ocorrncia junto com sua descrio, o usurio pode definir no campo Ao, uma ao para este documento, ou seja, quando ele vier com a ocorrncia XX ele
82

toma a ao de Pagar, por exemplo, assim sendo, sempre que algum documento vir com a ocorrncia XX ele vai para a gaveta de Pago, na administrao de boletos. 0 - Nenhuma 1 - Depositar 2 - Pagar 3 - Cancelar 4 - Falhar 5 - Gerado 99 Customizado

6.2.3.3. Cobrana

Nessa tela possvel efetuar a configurao de cobrana padro que os ttulos iro apresentar. A Figura 57 referencia a aba Cobrana, possuindo alguns campos para configurao, que sero vistos a seguir.

Figura 57: Leiaute de arquivo de retorno - Cobrana

83

 Posio Deve ser preenchida a posio de incio do campo cobrana. Tamanho Informar o tamanho do campo cobrana. Linha Cadastrar em qual linha os caracteres se encontram. Tipo Padro Seleciona se os ttulos sero importados com o Tipo de Cobrana padro, tendo as opes de acordo com a Figura 58.

Figura 58: Tipo de cobrana padro

Grid

Cdigo Cdigo informado neste campo tem de ser o mesmo cdigo de Tipo de Cobrana que informa o manual do banco. Descrio Descrio informada neste campo tem de ser a mesma descrio que informa o manual do banco.

84

 Tipo de Cobrana Definir o Tipo de Cobrana que aquele cdigo 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 so apresentados em seu arquivo de retorno, por meio de ocorrncias. O processo igual ao de ocorrncias de pagamentos, a nica diferena que o erro possui cinco campos para ocorrncias, enquanto a ocorrncia de pagamento possui apenas um campo. Segue abaixo um exemplo da aba de Erros (Figura 59).

Figura 59: Leiaute de arquivo de retorno Erro

Campo

Posio - U_ErFd1Pos

85

Deve ser preenchida a posio de incio do campo erro (Essa informao vale para todos os campos de erro).

Tamanho - U_ErFd1Siz Informar o tamanho do campo erro (Essa informao vale para todos os campos de erro). Linha - U_ErFd1Lin Cadastrar em qual linha os caracteres se encontram (Essa informao vale para todos os campos de erro).

Grid de Cadastro de Descrio dos Erros Os dados cadastrados nessa grid so os mesmos que o banco informa em seu manual, conforme mostra o exemplo abaixo (Figura 60):

Figura 60: Ocorrncias de Erros, Manual do Banco

Cdigo - U_IdErr O Cdigo informado neste campo tem de ser o mesmo cdigo que informa o manual do banco. Descrio - U_DescErr
86

Descrio informada neste campo tem de ser a mesma descrio que informa o manual do banco. 6.2.3.5. Validao Boletos

Na tela de validao (Figura 61), so cadastrados campos onde o BankSync buscar no arquivo de retorno os dados de seu documento, como: Valor, Datas, Nome, Tarifa Bancria. Aps verificar e buscar tais valores, efetuado no processo de importao a validao desses valores para o Business One.

Figura 61: Leiaute de arquivo de retorno Validao

Valor Pago ou Depositado Este campo vai retornar ao add-on, o valor do pagamento do documento, valor que entrou no banco.

87

Posio - U_ValPos Deve ser preenchida a posio de incio do valor do pagamento. Tamanho - U_ValSiz Informar o tamanho do campo valor pago. Linha - U_ValLin Cadastrar em qual linha os caracteres se encontram. Decimais - U_ValDec Informar quantas casas decimais o add-on deve considerar.

Tarifa de Cobrana

Posio - TaCPos Deve ser preenchida a posio de incio do valor da tarifa de cobrana. Tamanho - TaCSiz Informar o tamanho do campo tarifa de cobrana. Linha - TaCLin Cadastrar em qual linha os caracteres se encontram. Decimais - TaCDec Informar quantas casas decimais o add-on deve considerar.

Momento da Tarifa - U_TaxMomen A tarifa bancria pode vir no arquivo de remessa em duas situaes: 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 usurio vai programar o add-on para identificar a tarifa bancria. 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$

88

1,50 por documento e o documento do usurio de R$ 10,00, o valor do boleto seria de R$ 11,50 pois a tarifa j estava destacada, ou seja, inclusa no valor do documento.

Nome

Posio - U_NamePos Deve ser preenchida a posio de incio do Nome do Sacado. Tamanho - U_NameSiz Informar o tamanho do campo nome. Linha - U_NameLin Cadastrar em qual linha os caracteres se encontram.

Tipo de Transao

Posio - U_PstTpPos Deve ser preenchida a posio de incio do tipo de transao. OBS: campo no obrigatrio, apenas para consultas para diferenciar documentos;

Tamanho - U_PstTpSiz Informar o tamanho do campo tipo de transao. Linha - U_PstTpLin Cadastrar em qual linha os caracteres se encontram.

Data de Transao

Posio - U_DtProPos Deve ser preenchida a posio de incio da data de transao. Tamanho - U_DtProSiz O tamanho preenchido automaticamente, juntamente com a escolha do formato da data.

Linha - U_DtProLin
89

Cadastrar em qual linha os caracteres se encontram. Formato - U_DtProFor Escolher um formato de data que o manual do banco especificar como padro para suas datas. o 0 - ddmmaaaa o 1 - mmddaaaa o 2 - aaaammdd o 3 - ddmmaa o 4 - aammdd OBS: vale salientar: dd = dia , mm = ms , aaaa = ano;

Local - U_HeadTtl Escolher o local do arquivo de retorno que o BankSync deve considerar a data de lanamento, se do ttulo, ou seja, do documento, ou se do cabealho (Header). o 0 - Ttulo o 1 - Header.

6.2.3.6.

Validao DDA

Para trabalhar com o DDA o tipo de validao que o BankSync faz um pouco diferente, ele utiliza campos exclusivos para importao de arquivos DDA, como vamos ver no exemplo abaixo (Figura 62).

90

Figura 62: Leiaute de retorno Validao DDA

Valor do Boleto Este campo vai retornar ao add-on o valor do pagamento do documento. Posio - U_ValPos Deve ser preenchida a posio de incio do valor do pagamento. Tamanho - U_ValSiz Informar o tamanho do campo valor pago. Linha - U_ValLin Cadastrar em qual linha os caracteres se encontram. Nome

Posio - U_NamePos Deve ser preenchida a posio de incio do Nome. Tamanho - U_NameSiz
91

Informar o tamanho do campo Nome.

Linha - U_NameLin Cadastrar em qual linha os caracteres se encontram.

Data de Lanamento

Posio - U_DtProPos Deve ser preenchida a posio de incio da data de lanamento. Tamanho - U_DtProSiz O tamanho preenchido automaticamente, juntamente com a escolha do formato da data.

Linha - U_DtProLin Cadastrar em qual linha os caracteres se encontra. Formato - U_DtProFor Escolher um formato de data que o manual do banco especificar como padro para suas datas. o 0 ddmmaaaa o 1- mmddaaaa o 2- aaaammdd o 3- ddmmaa o 4 aammdd OBS: vale salientar: dd = dia , mm = ms , aaaa = ano;

CPF/CNPJ

Posio - U_CpfPos Deve ser preenchida a posio de incio do CNPJ ou CPF. Tamanho - U_CpfSize Informar o tamanho do campo valor pago. Vale lembrar que os dados destes campos no contm caracteres diacrticos, como ou /, sendo assim, o tamanho deste campo deve ser apenas a quantidade de caracteres numricos.

Linha - U_CpfLine
92

Cadastrar em qual linha os caracteres se encontram. Data de Vencimento

Posio - U_DtMatPos Deve ser preenchida a posio de incio da data de vencimento. Tamanho - U_DtMatSiz O tamanho preenchido automaticamente, juntamente com a escolha do formato da data.

Linha - U_DtMatLin Cadastrar em qual linha os caracteres se encontram. Formato - U_DtMatFor Escolher um formato de data que o manual do banco especificar como padro para suas datas. o 0 ddmmaaaa o 1- mmddaaaa o 2- aaaammdd o 3- ddmmaa o 4 aammdd OBS: vale salientar: dd = dia , mm = ms , aaaa = ano;

Cdigo de barras

Posio - U_BCodPos Deve ser preenchida a posio de incio do Cdigo de Barras. Tamanho - U_BCodSiz Informar o tamanho do campo Cdigo de Barras. Linha - U_BCodLin Cadastrar em qual linha os caracteres se encontram.

Data de Pagamento

Posio - U_DtPayPos
93

Deve ser preenchida a posio de incio da data de pagamento. Tamanho - U_DtPaySiz O tamanho preenchido automaticamente, juntamente com a escolha do formato da data. Linha - U_DtPayLin Cadastrar em qual linha os caracteres se encontram. Formato - U_DtPayFor Escolher um formato de data que o manual do banco especificar como padro para suas datas. o 0 ddmmaaaa o 1- mmddaaaa o 2- aaaammdd o 3- ddmmaa o 4 aammdd OBS: vale salientar: dd = dia , mm = ms , aaaa = ano; Status do Boleto sugerido - U_BoeStats Quando o usurio importa o arquivo de DDA, pode ser escolhido o tipo de operao que o usurio deseja configurar seu Contas a Pagar, para que os documentos mudem diretamente para a gaveta de Pago na tela de administrao de boletos, ou que o documento continue na gaveta de Gerado. Para isso basta escolher uma destas opes do combobox Status do Boleto Sugerido. 0 - Gerado 1 Pago

6.2.4.

Leiaute de Extrato Bancrio (CNAB)

Sempre que efetuamos uma movimentao em nossa conta bancria, ao final das transaes podemos tirar um extrato de quais movimentaes foram efetuadas. O extrato bancrio CNAB faz exatamente isso, s que em um padro CNAB, que permite ao usurio importar este arquivo por meio do BankSync e assim fazer suas reconciliaes dos documentos. Para acessar a tela de cadastro de leiaute de extrato CNAB (Figura 63) base acessar os

94

seguintes mdulos: Mdulos | Administrao | Configuraes | Banco | BankSync | Leiaute de Extrato Bancrio (CNAB).

Figura 63: Leiaute de arquivo de extrato CNAB

Cdigo Code Um cdigo nico para este cadastro. Nome Name Nome dado para o leiaute.

95

6.2.4.1. Registro

Identificao

Identificao - U_RegIdent No campo identificao temos de descrever, o que em nosso arquivo de extrato CNAB, ser linhas de documentos ou de transaes. O manual do banco sempre nos traz essa informao, para melhor visualizao segue o exemplo abaixo (Figura 64):

Figura 64 Leiaute de extrato bancrio CNAB Registro / Identificao

Figura 65: Extrato bancrio CNAB

Neste caso sempre que informar E na posio 14 com tamanho 1, o BankSync ir identificar isso como uma linha de transao (Figura 65).

Posio - U_RegPos Deve ser preenchida a posio de incio da Identificao. Tamanho - U_RegSiz Informar o tamanho do campo Identificao.

96

Banco

Cd. Banco O cdigo do banco sempre formado por 3 caracteres numricos, desta forma deve ser preenchido os campos, posio e tamanho do cdigo do banco. OBS: neste caso o BankSync ir procurar em seu arquivo de retorno CNAB, primeiro a identificao, como vimos no exemplo anterior E na posio 14 e ir identificar que essa linha uma transao. Aps isso ele ir procurar os caracteres que se encontram na posio e tamanho para retornar ao add-on, ou seja, retornar o cdigo do banco.

Posio - U_BkCodPos Deve ser preenchida a posio de incio do Cdigo do Banco. Tamanho - U_BkCodSiz Informar o tamanho do campo Cdigo do Banco.

N da Conta O nmero da conta sempre formado por caracteres numricos, desta forma devem ser preenchidos os campos posio e tamanho da conta. Posio - BkAcNPos Deve ser preenchida a posio de incio do Nmero da Conta. Tamanho - BkAcNSiz Informar o tamanho do campo Nmero da Conta.

Lanamento

Data

Posio - U_LnDtePos Deve ser preenchida a posio de incio da data.

97

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

Referncia

Posio - U_LnRefPos Deve ser preenchida a posio de incio de referncia. Tamanho - U_LnRefSiz Informar o tamanho do campo referncia. Formato - U_LnRefFmt Escolher um formato do campo referncia. o 0 - Texto

Detalhes

Posio - U_LnDetPos Deve ser preenchida a posio de incio de detalhes. Tamanho - U_LnDetSiz Informar o tamanho do campo detalhes. Formato - U_LnDetFmt Escolher um formato do campo detalhes.
98

o 0 Texto
Valor

Posio - U_LnVlrPos Deve ser preenchida a posio de incio do valor. Tamanho - U_LnVlrSiz Informar o tamanho do campo valor. Formato - U_LnVlrFmt Escolher um formato do campo valor (Figura 66).

Figura 66: Formato de valor

Tipo Lanamento

Posio - U_LnTypPos Deve ser preenchida a posio de incio do tipo de lanamento.

Tamanho - U_LnTypSiz Informar o tamanho do campo tipo de lanamento. Formato - U_LnTypFmt Escolher um formato do campo tipo de lanamento (Figura 67).

Figura 67: Formato do tipo de lanamento

99

 N Documento

Posio - U_LnDcNPos Deve ser preenchida a posio de incio do nmero do documento. Tamanho - U_LnDcNSiz Informar o tamanho do campo nmero do documento. Formato - U_LnDcNFmt Escolher um formato do campo nmero do documento. o 0 Texto

Cdigo Externo

Posio - U_LnExCPos Preencher a posio do campo cdigo externo. Tamanho - U_LnExCSiz Informar o tamanho do campo cdigo externo. Formato - U_LnExCFmt Escolher um formato do campo cdigo externo. o 0 - Texto

N Extrato

Posio - U_LnExNPos Informar a posio do campo nmero do extrato. Tamanho - U_LnExNSiz Informar o tamanho do campo nmero do extrato. Formato - U_LnExNFmt Escolher um formato do campo nmero do extrato. o 0 Texto

100

6.2.4.2.

Servio

A aba servio (Figura 68) bem semelhante a parte de cadastros de ocorrncias no leiaute de arquivo de retorno. Ela identifica um servio que o prprio usurio cadastra de acordo com o manual do banco em questo. Cada servio formado por um Tipo, Cdigo, Descrio e um Tipo de transao. Ao verificar a posio e o tamanho deste servio no arquivo texto de extrato bancrio, o add-on ir efetuar o processo de importao deste extrato.

Figura 68: Tela da aba servio

Posio - U_SrvPos Deve ser preenchida a posio de incio do servio. Tamanho - U_SrvSiz Informar o tamanho do campo servio.

Tipos

Tipo - U_LineType

101

O manual do banco informa ao usurio qual o tipo referente ao cdigo do servio, ex: 101 - Crdito, 201 Dbito. o 0 - Crdito o 1 - Dbito

Cdigo - U_TrnsCode O manual do banco informa ao usurio quais os cdigos de servio que ele deve cadastrar em sua grade de seleo, como mostra a Figura 69 abaixo:

Figura 69: Cadastro de cdigos e descries para Servios de extrato bancrio

Descrio - U_U_Descript A descrio tambm retirada do manual do banco, conforma mostra o exemplo acima.

Tipo Transao - U_TrnsType o 0 - Referncia de Pagamento o 1 - Nota de depsito com n de referncia o 2 - Doc Num o 3 - No tomar nenhuma ao

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 prprio add-on.
102

Primeiramente sero tratados os processos de remessas e em seguida, ser apresentado o processo de gerao de boletos de Contas a Pagar com base no Dbito Direto Autorizado (DDA).

7.1. Processo de remessas

O processo de remessas envolve enviar arquivos de texto, com os dados de seus ttulos para o banco, e importar o retorno enviado pelo banco para o seu sistema. Iniciaremos pela gerao de remessas para o banco, detalhando a partir da gerao de uma Nota Fiscal de Sada. Sero apresentadas as particularidades para gerao de boletos de Contas a Pagar, Contas a Receber e transferncias de Contas a Pagar. Na sequncia, ser demonstrado como deve ser feita a importao de um arquivo de retorno e como devem ser interpretados os dados apresentados na grade de importao. Uma vez que tenhamos arquivos de retorno importados no sistema, passaremos para a parte de reconciliao dos boletos, com base no extrato bancrio CNAB. 7.1.1. Criando ttulos no SBO

Este tpico explica ao usurio como gerar ttulos que podem ser enviados para a remessa. Ele ser breve, pois foge um pouco do foco deste manual, que explicar as particularidades do BankSync. 7.1.1.1. Criando uma nota fiscal

Existem diversas maneiras de se criar uma nota fiscal no SBO. Adotaremos aqui a forma mais simples, onde navegaremos diretamente at sua tela de cadastro e criaremos uma nova nota. Iniciamos por uma nota fiscal de sada. Para isto, navegamos at a tela de criao de uma nota fiscal de sada, que se encontra em Mdulos | Vendas | Nota Fiscal de Sada. Ao fazer isto, veremos uma tela similar demonstrada na Figura 70.

103

Figura 70: Nota fiscal de sada

Basta agora informar um parceiro de negcio, um item que possua estoque positivo, escolher o imposto aplicado a ele e clicar sobre o boto Inserir. Ao final da criao desta nota fiscal, ser gerado um LCM, conforme demonstrado em Figura 71.

Figura 71: LCM da nota fiscal de sada

104

7.1.1.2.

Gerando um ttulo

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 sada ou lanamento de crdito para um fornecedor, ou a de Contas a Pagar, caso seja para o pagamento de uma nota fiscal de entrada ou um lanamento de dbito para um cliente. Aps 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 sada, iremos criar agora um Contas a Receber baseado nela. Para isto, navegue at Mdulos | Banco | Contas a Receber | Contas a Receber. Ser exibida a tela demonstrada na Figura 72.

Figura 72: Contas a Receber

105

Informe um parceiro de negcio, que ser um cliente neste caso, e selecione o documento que deseja pagar dentre os que so exibidos na grade da tela. Uma vez escolhido, clique sobre o cone da sacola de dinheiro , localizado na barra de cones de acesso rpido, e uma tela onde

deve ser informado o meio de pagamento ir aparecer, exemplificada na Figura 73.

Figura 73: Tela de meio de pagamento

Escolhemos como meio de pagamento o Boleto. Selecionamos uma das formas de pagamento disponveis 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 boto OK para retornarmos a tela anterior. Nela, clicamos sobre o boto Inserir. Agora temos em nosso sistema um novo boleto de Contas a Receber criado. Note que no foi criado nenhum lanamento contbil decorrente da criao deste ttulo. Tal situao ocorreu por causa de duas condies do sistema: O primeiro se deve ao fato de que o ttulo de Contas a Receber que foi criado ainda est com seu status em aberto. Isto aconteceu porque, para o SBO, um ttulo pago por boleto s ser encerrado uma vez que o boleto tenha sido Pago e Reconciliado.

106

O segundo motivo para nenhum lanamento ter sido gerado ocorreu por ter criado o boleto com seu status igual a Enviado. Isso evitou que o SBO gerasse uma transao de troca de status do boleto, do status Enviado para Gerado, que iria gerar uma movimentao entre as contas do parceiro de negcio associado ao boleto.

7.1.2.

Gerao da remessa invocando o

O processo de criao de uma remessa, utilizando o BankSync, inicia

assistente de gerao do arquivo de remessa, que se encontra em Mdulos | Banco | BankSync | Exportao de Arquivo de Remessa. Ser ento demonstrado um assistente que ir guiar o usurio pelo processo de gerao dos arquivos de remessa. 7.1.2.1. Apresentao do assistente

Em geral, os assistentes do BankSync seguem um padro e a primeira etapa deles ser sempre uma tela de apresentao do assistente (Figura 74). Ela faz uma breve introduo do processo que ser executado, sendo neste caso o de gerao do arquivo de remessa para o banco.

Figura 74: Assistente de exportao - Apresentao

7.1.2.2.

Filtros

A prxima etapa possibilita filtrar os boletos que faro parte dos arquivos de remessa. Nessa tela possvel filtrar os boletos por:
107

Tipo do documento: Informa se sero listados os meios de pagamento (boletos e transferncias) ligados a documentos de Contas a Receber ou Contas a Pagar (Figura 75). Tambm define algumas configuraes especiais, que esto detalhadas mais abaixo;

Figura 75: Configurao do tipo de documento

Nmero do documento: No caso, o nmero do boleto, campo OBOE.BoeNum; Datas: Permite filtrar o boleto pela data de lanamento, vencimento, do documento ou ainda a data em que o boleto foi cancelado. Para que o filtro de data de cancelamento seja efetuado, a opo de Status do documento dever ter a checkbox Cancelado marcada (Figura 76);

Figura 76: Configurao do filtro de data

Parceiros de negcio Status do documento: Somente devero aparecer os boletos cujo status forem iguais a Enviado, Gerado, Cancelado ou Pendente (Figura 77);

Figura 77: Configurao do filtro de status do documento

108

Pagamentos: Somente dever listar os boletos que esto vinculados a notas fiscais bloqueadas ou desbloqueadas (Figura 78);

Figura 78: Configurao do filtro de pagamentos

Situao do documento: Permite listar os documentos que ainda no foram exportados, que j foram exportados, ou ainda ambos;

Figura 79: Configurao do filtro de situao do documento

Forma de Pagamento: Aqui so listadas todas as formas de pagamento disponveis para o tipo de documento previamente selecionado (pagar ou receber) (Figura 80). Note, ser gerado um documento para cada forma de pagamento selecionada e caso nenhuma seja marcada, sero mostrado ttulos de todas as formas de pagamento.

Figura 80: Configurao do filtro de forma de pagamento

Alm das opes 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 especficos.

109

No caso de selecionado para Tipo de Documento a opo de Contas a Receber, pode-se escolher se o tipo de transao ser para Cobrana ou ento Descontado (Figura 81). Qualquer que seja a opo, isto no obrigar o boleto a ser pago neste formato. Esta opo existe apenas para ser utilizada em conjunto com o campo database Leiaute Tipo de Transao, dos Leiautes de Arquivo de Remessa.

Figura 81: Configurao do filtro de tipo de transao

Caso a opo do Tipo de Documento seja a de Contas a Pagar, a tela possibilita realizar a filtragem por banco do boleto, o qual identificvel atravs da recuperao do cdigo do banco que se encontra no cdigo de barras/linha digitvel do mesmo. Em conjunto com a opo de filtragem por banco existe a opo Inverter Seleo (Figura 82), que filtra todos os bancos, com exceo do selecionado. O uso destas opes feito geralmente com leiautes para Contas a Pagar, de bancos que aceitam boletos de outros bancos.

Figura 82: Configurao do filtro de Contas a Pagar

Para boletos de Contas a Pagar, o sistema emite um alerta para aqueles que cuja formao do cdigo de barras no atenda ao esperado, conforme demonstrado na Figura 83.

110

Figura 83: Alerta

7.1.2.3.

Escolha dos ttulos

Na etapa seguinte do assistente, so mostrados todos os boletos ou transferncias que sero adicionados aos arquivos de remessa. Segue uma descrio das colunas presentes nesta grade. Para uma melhor visualizao, utilize a Figura 84 como referncia.

Figura 84: Assistente de exportao - Escolha dos ttulos

Marcando o checkbox da coluna Sel., o usurio estar confirmando a incluso daquele ttulo 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 vrios ttulos de uma nica vez.
111

Para marcar ou desmarcar todos os ttulos de uma nica vez, basta um nico clique sobre o cabealho da coluna Sel.

Tipo A coluna tipo informa se a linha em questo apresenta um boleto (B), ou uma transferncia (T).

Nota/Parcela A primeira letra desta coluna indica qual o documento que originou o boleto. Notas fiscais (N) e Lanamentos contbeis manuais (L). O nmero que vm antes da barra (/) representa o nmero da serial, caso o documento seja uma nota, ou ento o nmero da transao (OJDT.TransId), caso o documento seja um lanamento contbil manual. Por fim, o nmero que vem aps a barra indica qual a parcela que foi associada ao boleto. OBS: caso a numerao venha zerada, isto significa que o boleto foi atribudo a mais de um documento. 7.1.2.4. Resultados

Uma vez que o usurio avance para a prxima e ltima etapa, o assistente ir iniciar a gerao dos arquivos de remessa. Nesta tela, o programa demonstrar em tempo real em qual etapa o gerador de arquivos se encontra, postando mensagens para a grade presente na tela, conforme demonstrado na Figura 85.

112

Figura 85: Assistente de exportao Resultados

Caso ocorra alguma falha nesta etapa do assistente, ele ir apresentar para o usurio uma mensagem de erro, enquanto que ao mesmo tempo ele ir parar qualquer processo que estiver executando. Sendo assim, para tentar novamente a criao do arquivo de remessa, o usurio dever tentar concertar o problema apresentado pelo programa e depois executar novamente o assistente de exportao. Caso o programa encerre com sucesso, ter ento gerado os arquivos de remessas nos locais apontados pelo leiaute de nomenclatura de arquivo. OBS: o BankSync no realiza o envio do arquivo gerado para o banco, devido complicaes e da no padronizao dos servios prestados pelos bancos nesta rea. O processo de selecionar o arquivo e enviar para o banco deve ser feito automaticamente pelo cliente.

7.2. Importao do arquivo de retorno

O processo de importao do retorno bancrio tem origem quando o banco disponibiliza para o cliente um arquivo CNAB contendo as situaes dos boletos enviados previamente para o banco, geralmente feito atravs de um retorno por e-mail.

113

Sendo assim, uma vez que o cliente obtenha este arquivo, para dar incio ao processo, ele dever navegar at Mdulos | Banco | BankSync | Importao de Arquivo de Retorno. Feito isto, ser exibida uma tela de introduo que ir explicar um pouco sobre o processo de retorno, conforme a demonstrada na Figura 86. Clicando sobre o boto Seguinte, o assistente ir para a sua prxima etapa.

Figura 86: Assistente de Importao Apresentao

7.2.1.

Filtragem

A primeira opo de interao do usurio com o assistente vem na forma de escolha dos filtros (Figura 87) que sero aplicados a importao dos ttulos. Dentre as opes de filtros tmse: Tipo do documento: Indica se o retorno contm ttulos que esto associados a documentos de Contas a Pagar ou a receber; Data de vencimento: Caso sejam preenchidos, ttulos que estejam fora dos limites estipulados no sero 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
114

transferncias j foram associados as suas respectivas formas de pagamento no momento de sua criao; 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 operao, o boto que se encontra ao lado deste campo, oferece um assistente

que ajuda o usurio a encontrar este arquivo;

Figura 87: Assistente de Importao Filtragem

Uma vez que os filtros tenham sido escolhidos, ao clicar-se sobre o boto Seguinte novamente, o programa ir carregar os ttulos encontrados do arquivo na grade da prxima etapa. 7.2.2. Escolha dos ttulos

Ao se deparar com a tela de escolha dos ttulos, pode-se perceber que existem trs abas nesta tela: Automtica, Manual e No-Identificados. Seus propsitos e particularidades so explicados a seguir.

115

Automtica Esta a principal aba das trs e a que indica que o ttulo est pronto para ser atualizado no sistema. Nela possvel escolher quais os ttulos para realizar a importao no sistema, bem como ajustar a data de lanamento que recuperada do arquivo. Importante ressaltar que a coluna Data do Lanamento desta grade ser utilizada para firmar a data em que a transao ocorreu. Em outras palavras, no caso de uma importao de dados referentes aos boletos, ser criada uma transao de boletos do SAP Business One e agrupados nela todos os boletos cujas datas pertencem ao mesmo intervalo. A Figura 88 ilustra um exemplo de cenrio de importao, onde todos os ttulos presentes representam boletos no sistema. OBS: alm das datas diferenciadas, para que um boleto passe do status de Gerado para Pago, ele precisa primeiro ser passado para o status Depositado.

Figura 88: Assistente de Importao Aba Automtica

116

Antes que o usurio 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 ento pela de Cobrana (Figura 89).

Figura 89: Configurao do tipo de cobrana

Ele tambm pode inserir um pequeno texto que ser adicionado transao da troca de status do boleto. Ao clicar sobre o boto Seguinte, o assistente ir exibir a grade de resultados, que contm um demonstrativo de todos os ttulos que foram atualizados no sistema, separados por mudana de status (Figura 90).

Figura 90: Assistente de Importao Tela de resultados da importao do arquivo

117

Manual O BankSync utiliza a aba Manual para separar os ttulos que ele no sabe qual ao tomar, deixando a cargo do usurio quais aes sero efetuadas posteriormente na tela de Administrao de boletos do SBO ou configuradas no prprio leiaute de retorno na aba Ocorrncias. Os ttulos que caem na aba manual o fazem geralmente por um dos motivos seguintes: A ocorrncia encontrada no arquivo no est cadastrada no leiaute de retorno, sendo assim o programa no sabe que ao tomar; A ocorrncia encontrada no arquivo foi cadastrada no leiaute de retorno, porm no foi atribuda nenhuma ao para ser tomada quando esta ocorrncia fosse encontrada; Quando houver uma ocorrncia de alterao de vencimento cuja nova data de vencimento seja igual data de vencimento atual do ttulo; Quando a ao selecionada para a ocorrncia no for permitida pelo SBO, o que depende da situao atual do boleto. As pginas 14 e 17 mostram os fluxos de operaes do SBO para contas a receber e contas a pagar respectivamente. O ttulo j foi importado no sistema, ou ainda o status do qual ele est partindo igual ao de destino. Ex: De Pago para Pago (Figura 91);

Figura 91: Status replicado

Intencionalmente para posterior inspeo pelo usurio.

Para auxiliar na identificao dos problemas, as colunas Motivo e Informaes Adicionais trazem a descrio da ocorrncia (Figura 92), ou apenas o motivo pelo qual o ttulo caiu na aba Manual. Um exemplo da tela do assistente que se encontra na aba Manual pode ser visto na Figura 93.

118

Figura 92: Ocorrncias nas colunas Motivo e Informaes adicionais

Figura 93: Assistente de Importao Aba Manual

No-Identificados Os boletos que se encontram nesta situao, no tiveram sua contraparte encontrada no sistema, ou seja, a identificao nica do ttulo que foi recuperada do arquivo de retorno no condiz com nenhum dos ttulos encontrados na base de dados do SAP Business One. Isto indica que todos os mtodos de identificao do ttulo no sistema falharam, e que os dados que estavam contidos naquela linha sero descartados. Para sanar este problema, basta configurar corretamente um dos trs mtodos de identificao que o BankSync oferece, todos descritos em Leiaute de Arquivo de Retorno.
119

Um exemplo de um ttulo que no pode ser identificado encontra-se na Figura 94.

Figura 94: Assistente de Importao Aba No Identificado

7.2.3.

Resultados

A ltima etapa deste processo representada por um demonstrativo dos resultados da importao. Nesta tela, podem ser encontradas diversas informaes sobre os ttulos e seus respectivos documentos, bem como as transaes aos quais estes agora fazem parte. Um exemplo desta tela est disponvel na Figura 95.

120

Figura 95: Assistente de Importao Resultados

Aps a realizao da importao do arquivo, so realizadas as movimentaes contbeis dentro do SBO. 7.2.4. Reconciliao dos boletos

Conforme explicado anteriormente, um boleto que esteja no estado Pago dentro do SBO no 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 bancrio; ou em outras palavras, quando houver a confirmao da entrada do dinheiro referente aquele boleto dentro da conta bancria da empresa, mediante uma confirmao no extrato bancrio. Para que tal situao acontea dentro do SBO, o usurio dever importar para o sistema os dados do extrato bancrio. Para realizar tal processo, deve-se ter em mos um arquivo de extrato no modelo CNAB, disponibilizado pelo seu banco. Uma vez com este arquivo, o usurio dever utilizar o assistente de importao de extratos do BankSync

121

7.3. Importao do extrato bancrio CNAB

Para iniciar o assistente, navegue at Mdulos | Banco | BankSync | Importao de Extrato Bancrio (CNAB). Ir aparecer na tela um assistente do BankSync, conforme o demonstrado na Figura 96.

Figura 96: Assistente para extratos CNAB - Apresentao

7.3.1.

Filtragem

A etapa seguinte do assistente permite fazer a filtragem das linhas do extrato que no so desejadas durante a importao. Segue um exemplo da tela na Figura 97.

122

Figura 97: Assistente para extratos CNAB - Filtragem

Dentre as opes de filtragem temos: Leiautes: No momento da importao, devem-se informar quais dos leiautes de extrato dever ser utilizado;

OBS: o leiaute de extrato deve ser configurado no Contas bancrias 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 boto busca de arquivos do Windows; para usar o assistente de

Data: Informando um perodo de data nestes campos, far com que apenas linhas do extrato cuja data esteja neste perodo sejam demonstradas na prxima etapa do assistente;

Tipo de Lanamento: estes so os servios que foram cadastrados no leiaute de extrato CNAB e somente as linhas do extrato que apresentarem alguns dos servios
123

marcados nesta grade sero exibidos na etapa seguinte. Caso no exista nenhum servio na grade, o programa ir interromper o avano do assistente. Caso nenhum dos servios esteja marcado nesta grade, sero considerados todos os servios cadastrados para este leiaute; Contas Bancrias: Aqui so mostradas todas as contas bancrias do cadastro de Contas Bancrias da Empresa que esto associadas ao leiaute selecionado no campo Leiaute desta tela do assistente. Caso no exista nenhuma conta na grade, o programa ir interromper o avano 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 boto Seguinte novamente, o programa ir carregar as linhas de extrato encontradas do arquivo na grade da prxima etapa. 7.3.2. Escolha das linhas de extrato

Esta etapa do assistente permite a seleo das linhas de extrato que sero importadas para o SAP Business One. Assim como a importao de arquivos de retorno, existem trs possibilidades para a identificao das linhas de extrato. Segue uma descrio delas. Automtica Esta a nica aba que ir realizar realmente a importao das linhas de extrato no sistema. Para que um extrato seja enviado para esta aba, necessrio que o Cdigo da conta, Cdigo do banco e o Valor de identificao do registro estejam iguais aos cadastrados. Tambm necessrio que o cdigo do servio encontrado no arquivo esteja cadastrado no leiaute do extrato. A Figura 98 demonstra um exemplo desta tela.

124

Figura 98: Assistente para extratos CNAB - Automtica

Somente os boletos que estiverem marcados na aba de Automtica sero importados para dentro do SBO. Estas linhas de extrato sero apresentadas em um demonstrativo ao final da importao, na tela de resultados.

Manual As linhas de extrato que se encontram na aba Manual (Figura 99) so porque apresentaram uma identificao correta, com base no identificador de registros do extrato e quanto ao cdigo do banco, mas que falharam em outros quesitos como: o Tipo de lanamento do extrato no referente ao mesmo encontrado nele; Qualquer que seja o motivo, as linhas do extrato que fizerem parte da aba Manual no sero importadas para o sistema, devendo-se realizar as devidas correes para que estas linhas apaream na aba automtica, caso deseje que o sistema as importe.

125

Figura 99: Assistente para extratos CNAB Manual

No-Identificados A aba No-Identificados apresenta as linhas de extrato cuja operao ou nmero da conta do banco no foi encontrado no leiaute do extrato, ou no cadastro de Contas Bancrias da Empresa. Assim como as linhas de extrato exibidas na aba Manual, as linhas exibidas nesta aba no sero importadas no sistema. Um exemplo desta tela pode ser encontrado na Figura 100.

Figura 100: Assistente para extratos CNAB No-Identificados

126

7.3.3.

Resultados

A aba de resultados apresenta um pequeno resumo das linhas de extrato que foram importadas no sistema, conforme demonstrado na Figura 101.

Figura 101: Assistente para extratos CNAB - Resultados

Estas linhas do extrato que foram importadas no sistema podem ser encontradas na tela Mdulos | Banco | Extratos bancrios e reconciliaes externas | Processar extrato bancrio externo. O cadastro destas linhas utiliza a conta contbil do banco que est cadastrada no campo Conta contbil em Contas Bancrias da Empresa para o mesmo cdigo do banco e nmero da conta que foi encontrado na linha do extrato. Uma vez feita esta importao das linhas de extrato para esta tela, o usurio do SBO poder partir para a reconciliao manual dos boletos. Por padro, a tela Processar extrato bancrio externo (Figura 102) no vem com sua visibilidade habilitada no sistema; para ativ-la, com a janela dos Mdulos selecionada, clique

127

sobre o boto Configuraes do Formulrio processamento de extrato bancrio externo.

e marque a checkbox da tela de

Figura 102: Processar extrato bancrio externo

7.4. Processo de importao de boletos por DDA

O processo de Dbito Direto Autorizado (DDA) adaptado para o SAP Business One se d por meio da importao de um arquivo de retorno, seguindo o modelo CNAB. Os dados importados deste arquivo so utilizados para criar novos documentos de Contas a Pagar com meio de pagamento por boleto, sendo estes associados a notas fiscais de entrada ou lanamentos contbeis manuais de crdito ao fornecedor ou cliente. Este assistente permite ainda que mais de um documento seja associado ao mesmo boleto, podendo ser eles uma combinao de notas fiscais de entrada e lanamentos manuais. Para iniciar o assistente de importao de boletos por DDA do BankSync, utilize o menu que se encontra em Mdulos | Banco | BankSync | Importao de Boletos por DDA. Uma tela igual demonstrada na Figura 103 ser exibida, apresentando a tela de introduo do assistente.

128

Figura 103: Assistente de importao de boletos por DDA Apresentao

7.4.1.

Configuraes

A primeira etapa do assistente envolve realizar as configuraes para a criao dos novos boletos. Nela, devem ser escolhidos: Seleo do Banco em que ser efetuado o processo de DDA; A forma de pagamento para boletos de Contas a Pagar; Os tipos de parceiros de negcio que sero aceitos nos documentos de notas fiscais e lanamentos contbeis. O arquivo que contm os dados dos boletos por DDA, obtido dos bancos, no modelo CNAB; Note que as opes de escolha do banco e seu respectivo nmero da conta so utilizados para encontrar as formas de pagamento aceitas pelo assistente, que so as formas de pagamento de entrada com meio de pagamento por boleto. Note tambm que caso uma conta bancria da empresa no esteja aparecendo na combobox de contas, porque ela no esta associada a um leiaute de importao para DDA.

129

Figura 104: Assistente de importao de boletos por DDA Configuraes

Alm das configuraes, direita da tela o importador possui os filtros por Dt. Vencimento e Dt. Lanamento, duas opes adicionais para seleo dos ttulos. 7.4.2. Seleo e correo dos boletos

A prxima etapa deste assistente apresenta um resumo das informaes dos boletos que foram recuperadas do arquivo CNAB. Para consultar um exemplo desta tela, veja a Figura 105.

130

Figura 105: Assistente de importao de boletos por DDA Seleo dos boletos

Segue uma descrio das colunas desta etapa, com o seu significado e valor esperado: Sel.

Indica as linhas com os dados dos boletos que sero enviados para a prxima etapa do assistente, e que posteriormente sero inseridas no sistema. PN: Cdigo

Esta coluna deve possuir o cdigo de um parceiro de negcio vlido no SAP Business One. Dependendo da opo escolhida na tela anterior, os valores vlidos sugeridos por este campo podero ser fornecedores, clientes ou ambos. Esta coluna tenta se auto-preencher tambm com base no CPF ou CNPJ do parceiro de negcio. Caso no cadastro do PN estes valores estejam devidamente preenchidos (localizados no campo na tela de Cadastro de parceiro de negcio, aba Contabilidade, aba Imposto, no boto de Identificaes fiscais Figura 106), o BankSync ir trazer este campo automaticamente preenchido.

131

Figura 106: Tela de Identificaes fiscais do Parceiro de negcio

PN: Nome

Caso a identificao do PN pelo seu cdigo fiscal, CPF ou CNPJ, tenha sido encontrada, este campo mostra o nome do parceiro de negcio cadastrado no SBO. Do contrrio, ele ir trazer o valor que se encontra no arquivo de retorno CNAB do DDA. Note que neste caso o nome encontrado no arquivo CNAB serve apenas como referncia para encontrar o cdigo do parceiro de negcio dentro do SBO, e sua identificao dever ser feita manualmente atravs da lista de opes apresentadas na coluna do cdigo do PN. Valor

Este o valor do boleto que foi recuperado do arquivo. No aconselhado alter-lo, mas caso haja a necessidade, ele est disponvel para edio.

132

Lanamento

Esta ser a data na qual o Contas a Pagar ser gerado. Caso no venha configurado do arquivo, sua data padro a de hoje. Vencimento

Esta ser a data de vencimento com qual o Contas a Pagar ser gerado. Caso no venha configurado do arquivo, sua data padro a de hoje. Status

Esta coluna indica em qual estado o novo boleto dever ser criado; Gerado ou Pago. Pagamento

Caso a coluna Status tenha seu valor igual a Pago, ento esta coluna ser a data utilizada para realizar a transao de pagamento dos boletos. Do contrrio, ela ser ignorada. Cdigo de Barras

Aqui demonstrado o cdigo de barras que foi recuperado do arquivo. No aconselhvel alter-lo, mas o campo disponibiliza-se para alteraes. Observaes

Podem-se adicionar aqui quaisquer observaes referentes ao boleto que ser criado. Atribuio de ttulos aos boletos.

133

8. Databases
Os databases so um conjunto de campos do banco de dados ou rotinas que realizam algum clculo especfico, como por exemplo, os contadores de lote, que esto disponveis para o usurio na configurao dos leiautes de arquivo de remessa do BankSync. Este captulo tem como objetivo detalhar os databases disponveis, especificando o que cada um faz e tambm exemplificando o seu uso caso necessrio. Os databases esto disponveis para configurao, na Definio do Registro do Leiaute de Remessa, conforme Figura 107 abaixo:

Figura 107: Definio do registro - Databases

134

Ao clicar no boto Definio do Campo para uma linha do tipo Database, possvel selecionar o database desejado conforme Figura 108 abaixo:

Figura 108: Definio do campo Base de Dados (Databases)

8.1. Databases Boleto

Boleto - Chave nica

Retorna a chave nica do boleto no banco de dados Campo BoeKey da tabela OBOE.

Boleto - Cdigo de Barras

Retorna o cdigo de barras do boleto Campo Barcodenum da tabela OBOE.

135

Boleto - Data de Vencimento

Retorna a data de vencimento do boleto Campo DueDate da tabela OBOE.

Boleto - Data do Documento

Retorna a data de lanamento do boleto Campo PmntDate da tabela OBOE.

Boleto - Dgito do Nosso Nmero

Retorna o dgito verificador do nosso nmero Campo OurNumChk da tabela OBOE.

Boleto - Endereo de Cobrana (Tipo Rua, N)

Retorna o Tipo do Logradouro + Rua + N da Rua Campos AddrType, Street e StreetNo da tabela CRD1.

Boleto - Linha Digitvel

Retorna a linha digitvel do boleto (47 dgitos) Campo Barcoderep da tabela OBOE.

Boleto - Nosso Nmero

Retorna o nosso nmero gravado no boleto Campo OurNum da tabela OBOE.

Boleto Nmero do boleto

Retorna o nmero do boleto Campo BoeNum da tabela OBOE.

Boleto - Referncia 1
136

Retorna o nmero da referncia do boleto campo RefNum da tabela OBOE.

Boleto - Referncia 2

Retorna a referncia 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 obrigaes do cadastro de Parceiros de Negcio Campo IntrstRate da tabela OCRD.

Boleto - Valor Total

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

8.2. Databases - Clculo

Clculo - Amarrao Horizontal (UNIBANCO)

Retorna um clculo especifico para o UNIBANCO Frmula: (Numero do banco + 00000000000000) + Valor) * Tipo de Operao(5) Clculo - Digito de Controle - Agncia (Bradesco)

137

Calcula o DV da agncia de acordo com as regras do Bradesco. O nmero da agncia multiplicado por 2 at 5, da direita para esquerda. Aps isso, feita a soma das multiplicaes e realizado o mdulo 11. Caso o resto da diviso for igual a 0 ou 1, o DV ser 0, caso contrrio o DV ser igual a 11 menos o resto.

Clculo - Digito de Controle - Conta (Bradesco)

Calcula o DV da conta bancria de acordo com as regras do Bradesco. O nmero da conta multiplicado por 2 at 7, da direita para esquerda. Aps isso, feita a soma das multiplicaes e realizado o mdulo 11. Caso o resto da diviso for igual a 0 ou 1, o DV ser 0, caso contrrio o DV ser igual a 11 menos o resto.

Segundo Dgito Verificador do Nosso Nmero Banrisul

Retorna o segundo DV do Nosso Nmero para o banco Banrisul atravs do seguinte calculo: O nosso nmero mais o primeiro DV so multiplicados por 2 at 7, da direita para esquerda. Aps isso, feita a soma das multiplicaes e realizado o mdulo 11. Caso o resto da diviso for igual a 0, o DV ser 0, caso contrrio o DV ser igual a 11 menos o resto.

8.3. Databases - Cedente

Cedente CNPJ

Retorna o CNPJ do cedente (Empresa) Campo TaxIdNum da tabela OADM.

Cedente - Endereo da Empresa (CEP)

Retorna o CEP da empresa Campo ZipCode da tabela ADM1.

138

Cedente - Endereo da Empresa (Cidade)

Retorna a cidade da empresa Campo City da tabela ADM1.

Cedente - Endereo da Empresa (Complemento)

Retorna o complemento da empresa Campo Building da tabela ADM1.

Cedente - Endereo da Empresa (Estado)

Retorna o estado da empresa Campo State da tabela ADM1.

Cedente - Endereo da Empresa (N)

Retorna o nmero do endereo da empresa Campo StreetNo da tabela ADM1.

Cedente - Endereo da Empresa (Rua)

Retorna a rua da empresa Campo Street da tabela ADM1.

Cedente - Nome da Empresa

Retorna o nome da empresa Campo CompnyName da tabela OADM.

8.4. Databases Contas a Pagar

Contas a Pagar - Cdigo do banco

Retorna a informao do campo Pagamento para o cdigo do banco de uma conta a pagar ou transferncia bancria Campo PBnkCode da tabela OVPM (Contas a Pagar) ou OPDF (transferncias).

139

Contas a Pagar - Nmero da Agncia

Retorna a informao do campo Pagamento a filial do banco de uma conta a pagar ou transferncia bancria Campo PBnkBranch da tabela OVPM (Contas a Pagar) ou OPDF (transferncias).

Contas a Pagar - Nmero da Conta

Retorna a informao do campo Pagamento para a conta bancria n de uma conta a pagar ou transferncia bancria Campo PBnkAccnt da tabela OVPM (Contas a Pagar) ou OPDF (transferncias).

Contas a Pagar - Dgito da Conta

Retorna o dgito da conta bancria para uma conta a pagar Campo UsrNumber2 da tabela OCRB.

8.5. Databases - Documento

Documento - Nmero da Nota Fiscal

Retorna o nmero da nota fiscal Campo Serial das tabelas OINV (Contas a Receber) ou OPCH (Contas a Pagar).

Documento - Nmero da Parcela

Retorna o nmero da parcela do documento Campo InstId das tabelas OINV (Contas a Receber), OPCH (Contas a Pagar) ou PDF2 (transferncias).

140

Documento - Nmero Total de Prestaes

Retorna o total de prestaes do documento Campo Installmnt das tabelas OINV (Contas a Receber), OPCH (Contas a Pagar) ou PDF2 (transferncias). Documento - Quantidade de Notas Fiscais

Retorna 0 quando no existem NFs no boleto / transferncia ou 1 quando existe pelo menos uma NF no boleto / transferncia.

8.6. Databases - Extra

(Extra)

Retorna a linha digitvel do boleto para concessionrias (48 dgitos) Campo Barcoderep da tabela OBOE.

(Extra) Boleto - Nosso Nmero (Port/OurNum-Chk)

Retorna a carteira (C), nosso nmero (N) e DV (D) no formato CC/NNNNNN-D Campos PtfNum da tabela OPTF, OurNum e OurNumChk da tabela OBOE.

(Extra) Cedente - Identificao da Empresa

Retorna a seguinte string: 0 + Carteira + Agncia + N da Conta + DV da Conta. Campos PtfNum da tabela OPTF, Branch, Account e AccountChk da tabela DSC1.

(Extra) Sacado - Nmero da Nota Fiscal/Parcela

Retorna o nmero da NF e o nmero 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).

141

(Extra) Cdigo da Transao do LCM ou Serial na Nota Fiscal

Retorna o cdigo da transao 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 sada) ou OPCH (nota de entrada) para NF.

8.7. Databases Forma de Pagamento

Forma de Pagamento - Digito da Agncia do Cedente

Retorna o DV da agncia bancria parametrizada na forma de pagamento Campo ControlKey da tabela DSC1.

Forma de Pagamento - Cdigo da Forma de pagamento

Retorna o cdigo 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 - Agncia do Cedente

Retorna a agncia da empresa selecionada na forma de pagamento Campo Branch da tabela OPYM.

142

Forma de Pagamento - Cdigo da Carteira

Retorna o cdigo da carteira vinculada a forma de pagamento Campo PtfCode da tabela OPTF.

Forma de Pagamento - Cdigo da Instruo 1

Retorna o cdigo da instruo 1 especificada na forma de pagamento Campo Instruct1 da tabela OPYM

Forma de Pagamento - Cdigo da Instruo 2

Retorna o cdigo da instruo 2 especificada na forma de pagamento Campo Instruct2 da tabela OPYM

Forma de Pagamento - Digito da Conta do Cedente

Retorna o DV da conta bancria parametrizada na forma de pagamento Campo AccountChk da tabela DSC1.

Forma de Pagamento - Instruo 1

Retorna a descrio da instruo 1 informada na forma de pagamento Campo InstrDespt da tabela OIST.

Forma de Pagamento - Instruo 2

Retorna a descrio da instruo 2 informada na forma de pagamento Campo InstrDespt da tabela OIST.

143

Forma de Pagamento - Nmero da Carteira

Retorna o nmero da carteira parametrizada na forma de pagamento Campo PtfNum da tabela OPTF.

Forma de Pagamento - Nmero da Conta do Cedente

Retorna o nmero da conta bancria parametrizada na forma de pagamento Campo DflAccount da tabela OPYM.

Forma de Pagamento - Nmero do Acordo

Retorna o nmero do acordo da conta bancria parametrizada na forma de pagamento Campo AgreeNum da tabela DSC1.

Forma de Pagamento - Nmero do Contrato

Retorna o nmero do contrato da conta bancria parametrizada na forma de pagamento Campo U_Contract da tabela DSC1. Forma de Pagamento Observaes

Retorna as observaes 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 - Cdigo do Banco

Retorna o cdigo do banco parametrizado na forma de pagamento Campo BnkDflt da tabela OPYM.

144

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, ento sempre que um Header de lote for includo no arquivo, o contador ser incrementado.

Leiaute - Contador de lotes persistente

Retorna a quantidade de lotes contidos no arquivo.

Leiaute - Contador de Documentos do Lote

Retorna a quantidade de documentos contidos em um lote.

Leiaute - Contador de Linhas do Arquivo

Retorna a quantidade de linhas contidas no arquivo.

Leiaute - Contador de Lotes de Ttulos

Retorna a quantidade de lotes com ttulos/boletos no arquivo.

145

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 Criao 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 transao

Retorna 0 se o tipo de transao dos boletos descontado ou 1 se de cobrana.

8.9. Databases - PN

PN Agncia

Retorna a agncia bancria do parceiro de negcio Campo DflBranch da tabela OCRD.

PN CNPJ

Retorna o CNPJ do parceiro de negcio Campo TaxId0 da tabela CRD7.

PN - Cdigo do Banco
146

Retorna o cdigo do banco do parceiro de negcio Campo BankCode da tabela OCRD.

PN - Complemento do CNPJ (Filial e DV)

Retorna a filial e o dgito verificador do CNPJ do parceiro de negcio no formado 1234-DV Campo TaxId0 da tabela CRD7.

PN - Corpo do CNPJ

Retorna a parte inicial do CNPJ do parceiro de negcio no formato 12123123 Campo TaxId0 da tabela CRD7.

PN - Corpo do CPF

Retorna a parte inicial do CPF do parceiro de negcio no formato 123123123 Campo TaxId4 ou TaxId7 da tabela CRD7.

PN - CPF

Retorna o CPF do parceiro de negcio - Campo TaxId4 ou TaxId7 da tabela CRD7.

PN - Dgito Verificador do CPF

Retorna apenas o dgito verificador do CPF do parceiro de negcio - Campo TaxId4 ou TaxId7 da tabela CRD7.

PN - E-Mail

Retorna o e-mail do parceiro de negcio Campo E_mail da tabela OCRD.

147

PN - Endereo de Cobrana (Bairro)

Retorna o bairro do endereo padro de cobrana do parceiro de negcio Campo Block da tabela CRD1. PN - Endereo de Cobrana (CEP)

Retorna o CEP do endereo padro de cobrana do parceiro de negcio Campo ZipCode da tabela CRD1.

PN - Endereo de Cobrana (Cidade)

Retorna a cidade do endereo padro de cobrana do parceiro de negcio Campo City da tabela CRD1.

PN - Endereo de Cobrana (Complemento)

Retorna o complemento do endereo padro de cobrana do parceiro de negcio Campo Building da tabela CRD1.

PN - Endereo de Cobrana (Estado)

Retorna o estado do endereo padro de cobrana do parceiro de negcio Campo State da tabela CRD1.

PN - Endereo de Cobrana (N)

Retorna o nmero do endereo padro de cobrana do parceiro de negcio Campo StreetNo da tabela CRD1.

148

PN - Endereo de Cobrana (Rua)

Retorna a rua do endereo padro de cobrana do parceiro de negcio Campo Street da tabela CRD1.

PN - Endereo de Cobrana (Rua, N)

Retorna o nome da rua e nmero do endereo padro de cobrana do parceiro de negcio no formato Exemplo 123 Campos Street e StreetNo da tabela CRD1.

PN - Endereo de Cobrana (Tipo Rua, N)

Retorna o tipo, o nome da rua e nmero do endereo padro de cobrana do parceiro de negcio no formato Rua Exemplo, 123 Campos AddrType, Street e StreetNo da tabela CRD1. PN - Nome do Parceiro de Negcios

Retorna o nome do parceiro de negcios Campo CardName da tabela OCRD.

PN - Nmero da Conta

Retorna o nmero da conta bancria padro do parceiro de negcios Campo DflAccount da tabela OCRD.

PN - Taxa de Juros

Retorna a taxa de juros definida para o parceiro de negcios Campo IntrstRate da tabela OCRD.

149

PN - Tipo de Pessoa [01-PJ|02-PF|00-Nenhum]

Retorna 01 para pessoa jurdica, 02 para pessoa fsica e 00 para nenhum. retornado 00 quando o parceiro de negcio no foi encontrado ou os campos TaxId0 e TaxId4 da tabela CRD7 esto 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 agncia do parceiro de negcios Campo UsrNumber1 da tabela OCRB.

9. DLL - Dynamic-Link Library

Segundo a Wikipdia, as Bibliotecas de Ligao Dinmica (Dynamic-link library DLL) foram uma implementao feita pela Microsoft para o conceito de bibliotecas compartilhadas nos sistemas operacionais Microsoft Windows e OS/2. Uma DLL um arquivo binrio que contm um conjunto de funes que esto disponveis para qualquer outro programa que venha a necessitar de alguma destas funes. Para utiliz-las, basta que o programa faa referncia a DLL e suas funes. A Figura 109 explica em mais detalhes como este processo ocorre:

150

Figura 109: Processo de execuo 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 solicitao para a DLL do banco associado Forma de Pagamento, pedindo para que ela lhe monte o cdigo de barras e faa tambm o clculo do dgito verificador do nosso nmero. Em caso de sucesso, o SAP Business One recebe estes dois valores, e os grava respectivamente nos campos BarcodeNum e OurNumChk da tabela de boletos OBOE. Em caso de falha, o SAP Business One alerta o usurio com uma mensagem de texto em vermelho na barra de status dele, mas que na maioria das vezes no suficiente para uma correo precisa. A Figura 110 ilustra levemente este processo:

151

Figura 110: Fluxo de chamadas do Business One

As novas DLLs desenvolvidas pela empresa Sistema Informtica Empresarial contam com um recurso a mais para identificao 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 usurio uma caixa de mensagem, detalhando o erro, ao mesmo tempo em que gerado um arquivo de Log, que pode ser encontrado na pasta %Temp%\BankSync\DLL Logs. Um exemplo da mensagem mostrada pode ser vista na Figura 111 abaixo:

Figura 111: Mensagem de Erro da DLL.

Ao se deparar com este tipo de mensagem, caso o usurio no consiga realizar por conta prpria a correo, o procedimento padro para que solicite suporte com a Sistema Informtica Empresarial, que ele dever abrir um chamado em nosso site, e adicionar como anexo o arquivo de Log gerado, que possuir em seu nome, o nome da DLL que acusou o erro, bem como a data e hora em que o mesmo foi gerado.

152

As DLLs, desenvolvidas por nossa empresa para o SAP Business One esto programadas para funcionarem apenas quando o add-on BankSync estiver em execuo. Caso ela seja invocada e o add-on esteja parado, o usurio ser alertado do problema, usando o mecanismo de alertas demonstrado anteriormente.

9.1. Cdigo de Barras e Linha Digitvel

Cdigo de barras uma representao grfica de dados numricos ou alfanumricos. A leitura dos dados realizada por um tipo de scanner, conhecido como leitor de cdigo de barras, que emite um raio vermelho que percorre todas as barras. A captura de dados ocorre por forma de reflexo da luz, que ocorre por entre os espaos em branco do cdigo de barras, direto para um aparelho que possa interpret-los, como um visor ou computador. De acordo com os padres para cdigos de barra estabelecidos pela FEBRABAN, os bancos brasileiros devem utilizar o formato de cdigo de barras 2 de 5, onde cada 5 barras correspondem a um dgito alfanumrico, sendo que duas destas barras so longas. O FEBRABAN tambm determina que o cdigo de barras deva ser composto pelos seguintes dados apresentados na Tabela 4:

Formatao dos dados do Cdigo de Barras Posio Ini Fim 1 3 4 4 5 5 6 9 10 19 20 44 Tamanho 3 1 1 4 10 25 Formato Contedo

Inteiro Identificao do Banco Inteiro Cdigo da Moeda ( 9 - Real) Inteiro Digito Verificador do cdigo de barras Inteiro Fator de vencimento Decimal(8,2) Valor nominal do ttulo Inteiro Campos Livres - De acordo com o banco emissor
Tabela 4: Estrutura dos dados do cdigo de barras

Os dados chamados de Campos Livres devem ser preenchidos de acordo com o que o manual de cada banco especifica. Segue a Tabela 5 demonstrando um exemplo de preenchimento dos dados dos campos livres:

153

Exemplo de preenchimento dos Campos Livres Posio Ini Fim 20 23 24 25 26 36 37 43 44 44 Tamanho 4 2 11 7 1 Formato Inteiro Inteiro Inteiro Inteiro Decimal(8,2) Contedo Cdigo da Agncia (sem dgito) Cdigo da Carteira Nosso Nmero (sem dgito) Conta do Cedente (sem dgito) Zero Fixo

Tabela 5: Exemplo de preenchimento dos Campos Livres

A linha digitvel de um boleto foi criada para que este pudesse ser validado pelos bancos quando seus leitores de cdigo de barras estivessem inoperantes, ou inexistentes. A linha digitvel simboliza uma representao numrica do cdigo de barras, acrescida de alguns dgitos, usados para controle da conferncia dos dados da prpria linha digitvel. importante ressaltar que a representao numrica da linha digitvel diferente da representao numrica do cdigo de barras, embora ambos contenham os mesmos dados. Em resumo, a linha digitvel apresenta 3 dgitos numricos a mais, que so os dgitos verificadores usados para consistncia de seus dados. O preenchimento da linha digitvel padro para todos os bancos, conforme estabelecido pela FEBRABAN, e seu formato de preenchimento demonstrado na Tabela 6 abaixo:

Formatao dos dados da Linha Digitvel Ini 1 4 5 10 11 21 22 32 33 34 38 Posio Fim 3 4 9 10 20 21 31 32 33 37 47 Tamanho 3 1 5 1 10 1 10 1 1 4 10 Formato Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Inteiro Contedo Identificao do banco Cdigo da moeda (9 - Real) Posies 20 24 do cdigo de barras Dgito verificador do primeiro campo Posies 20 24 do cdigo de barras Dgito verificador do segundo campo Posies 20 24 do cdigo de barras Dgito verificador do terceiro campo Digito verificador do cdigo de barras Fator de vencimento Valor nominal do ttulo

Tabela 6: Formatao dos dados da linha digitvel

154

9.2. Configuraes das DLLs no SAP Business One

O processo de configurao das DLLs se concentra em duas telas principais: O cadastro de Contas Bancrias da Empresa e o cadastro de Formas de Pagamento. As Tabelas 7 e 8 demonstram os principais campos que so relevantes para o clculo do cdigo de barras das DLLs.

Contas Bancrias da Empresa - DSC1 Campo Tipo Observao Descrio Nome Tipo Tamanho Cdigo do banco BankCode Caracter 30 N da conta Account Caracter 50 Dgito de controle da conta AccountChk Caracter 1 Filial Branch Caracter 50 Agncia Chave de controle ControlKey Caracter 2 Digito da Agncia Nosso Nmero OurNum Inteiro N do acordo AgreeNum Caracter 4 Nmero do Contrato U_Contract Caracter 12
Tabela 7: Campos da tabela Contas Bancrias da Empresa

Formas de Pagamento - OPYM Campo Tipo Descrio Nome Tipo Tamanho Cdigo da moeda CurCode Caracter 2 N do portflio PtfNum Caracter 4
Tabela 8: Campos da tabela Formas de Pagamento

Observao 9 = Real Tabela OPTF

Estes campos, com exceo do Cdigo do Banco e o Cdigo da Moeda, no fazem parte obrigatoriamente do clculo executado pela DLL para gerar o cdigo de barras. Contudo, a maioria dos bancos faz uso deles, e seu correto preenchimento pode evitar possveis frustraes com mensagens de erro com as DLLs. O campo Nmero do Contrato o nico destes campos que deve ser preenchido apenas quando solicitado, pois seu uso restrito apenas a alguns bancos, os quais sero especificados nos manuais disponibilizados por esses bancos. Quando uma forma de pagamento (Figura 112) marcada como do tipo Recebido, com meio de pagamento por Boleto, o boto extra exibido na tela na opo Caractersticas do
155

boleto. atravs dele que o usurio poder informar o Cdigo da moeda e Nmero do portflio/carteira, conforme na Figura 113 abaixo:

Figura 112: Configurao da Forma de Pagamento

156

Figura 113: Configuraes especficas do boleto

O problema do campo nosso nmero Na tela de cadastro de Contas Bancrias da Empresa, o campo Nosso nmero 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 dgitos para o nosso nmero, porm no limitando a valores maiores ainda. Para contornar este problema foi adotado o seguinte padro: Para situaes em que o nosso nmero menor ou igual a 9, utiliza-se apenas o campo do Nosso nmero (OurNum); Para situaes em que o nosso nmero est entre 10 e 13, utilizam-se os primeiros 9 dgitos do nosso nmero (OurNum), complementando o restante com o campo N do Acordo (AgreeNum), que vai at 4 caracteres; Para situaes em que o nosso nmero ultrapasse os 13 dgitos, utilize o campo N do Contrato (U_Contract), caso o mesmo no esteja sendo utilizado pela DLL;

157

Se existir uma especificao especial da DLL em questo, tratando como deve ser feito o preenchimento do campo nosso nmero, desconsiderar as condies anteriores e usar a especificada pela DLL.

9.3. Particularidades das DLLs

Esta sesso apresenta as particularidades de cada DLL desenvolvida pela Sistema Informtica Empresarial. de suma importncia conferir as informaes do seu respectivo banco para configurar o BankSync e o Business One de forma correta, para obter sucesso na comunicao bancria.

9.3.1.

Banco ABC

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras:

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 N do Acordo Nosso N Filial N da Conta Observao Fixo 237. Deve ser preenchido com dois dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com nove dgitos, totalizando 11 dgitos com o N do Acordo. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N.

9.3.2.

Banco Banrisul

Devido a uma restrio do SAP Business One, que limita o tamanho do dgito verificador do nosso nmero a apenas 1 dgito, a DLL deste banco ir retornar, sempre, apenas o primeiro nmero do dgito verificador do nosso nmero. O segundo dgito verificador pode ser extrado a
158

partir do cdigo de barras gerado pela DLL, que fica disponvel no campo Barcodenum da tabela OBOE. A posio do nosso nmero com o DV duplo no cdigo de barras deve ser consultada no manual do banco. O tipo de cobrana fixo com o valor 2 Cobrana direta. Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco Nosso N Filial N da Conta Observao Deve ser preenchido com 8 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Moeda Nome do campo no B1 Cdigo da Moeda Observao Deve ser preenchido com 1 dgito.

9.3.3.

Banco Bradesco

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco N do Acordo Nosso N Filial N da Conta Observao Deve ser preenchido com dois dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com nove dgitos, totalizando 11 dgitos com o N do Acordo. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

159

9.3.4.

Banco do Brasil

A DLL do Banco do Brasil atende os casos em que no nmero do acordo apresenta os tamanhos de 4, 6 e 7 posies para cobrana registrada e o caso da cobrana no registrada, em que o nosso nmero apresenta tamanho 17 livre. As particularidades da DLL para cada utilizao podem ser encontradas nos tpicos que seguem. Convnio de 4 dgitos, carteira registrada Neste caso, o campo nmero do contrato (U_Contract) dever ser preenchido com exatos 4 dgitos, enquanto que o nosso nmero (OurNum) no poder ultrapassar o tamanho limite de 7 dgitos, pois concatenados os dois devero apresentar tamanho final de 11 dgitos. Convnio de 6 dgitos, carteira registrada Neste caso, o campo nmero do contrato (U_Contract) dever ser preenchido com exatos 6 dgitos, enquanto que o nosso nmero (OurNum) no poder ultrapassar o tamanho limite de 5 dgitos, pois concatenados os dois devero apresentar tamanho final de 11 dgitos. Convnio de 7 dgitos, carteira registrada Embora parecido com os anteriores, quando utilizado o convnio de 7 dgitos do banco, o campo nmero do contrato (U_Contract) dever ser preenchido com exatos 7 dgitos, porm como a concatenao do nmero do contrato com o nosso nmero (OurNum) dever apresentar um tamanho final de 17 dgitos e o campo nosso nmero limitado em 9 dgitos, o primeiro dgito da seqncia do nosso nmero dever ser preenchido no campo Nmero do Acordo (AgreeNum). Veja um exemplo do preenchimento dos campos quando o nosso nmero for 10004730003126004: Nmero do Contrato: 1000473; Nmero do Acordo: 0; Nosso nmero: 003126004;

Carteira no-registrada Para utilizao da carteira no registrada, com nosso nmero livre de 17 posies, basta preencher os primeiros 8 nmeros do nosso nmero no campo Usurio n 1 (UsrNumber1) e os 9

160

dgitos restantes no campo do Nosso Nmero (OurNum). Supondo como exemplo o nmero 00000011000000009 temos que o preenchimento dos campos dever ser: Nmero do Contrato: 00000011; Nosso nmero: 000000009;

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nosso Nmero Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nmero do Contrato Nome do campo no B1 Cdigo do Banco N do Acordo Usurio N 1 Nosso N Filial N da Conta Nmero do Contrato Observao Deve ser preenchido conforme especificao acima. Deve ser preenchido conforme especificao acima. Deve ser preenchido conforme especificao acima. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 8 dgitos. Deve ser preenchido conforme especificao acima.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

Quando o Nmero do Contrato possuir 7 dgitos, os seis primeiros caracteres do campo livre sero preenchidos com zeros. O DV do Nosso Nmero ser calculado sobre o Nmero do Contrato + Nosso N, exceto quando o Nmero do Contrato possuir 6 dgitos e o campo Usurio N 1 estiver preenchido.

161

9.3.5.

Banco BVA

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero do Contrato Nome do campo no B1 Cdigo do Banco Nosso N Nmero do Contrato Observao Deve ser preenchido com 5 dgitos. O nosso nmero final ser o Nmero do Contrato + Nosso N totalizando 11 dgitos. Deve ser preenchido com 6 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 Cdigo da Moeda Observao Fixo 09 Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N.

9.3.6.

Banco CitiBank

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nosso Nmero Nmero do Contrato Nome do campo no B1 Cdigo do Banco N do Acordo Nosso N Nmero do Contrato Observao Deve ser preenchido com dois dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com nove dgitos, totalizando 11 dgitos com o N do Acordo. Deve ser preenchido com 9 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 3 dgitos. Deve ser preenchido com 1 dgito.

162

9.3.7.

Banco Fibra

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco N do Acordo Nosso N Filial N da Conta Observao Deve ser preenchido com dois dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com nove dgitos, totalizando 11 dgitos com o N do Acordo. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N.

9.3.8.

Banco Caixa Econmica Federal

Esta DLL atende tanto a modalidade SICOB e SIGCB. A modalidade SICOB atende aos nossos nmeros de tamanho 11 e 16, enquanto que a SIGCB possui exclusivamente o nosso nmero de 17 posies. Para que a DLL saiba qual situao ela ir atender, necessrio que o usurio personalize alguns dados. O principal deles se encontra na tela de cadastro de formas de pagamento. No campo Tipo de Transao (TrnsType), deve ser informado o valor 11, 16 ou 17, respectivamente a quantidade de dgitos que existem no nosso nmero. Caso no seja informado nenhum valor, a DLL assumir que o formato desejado de nosso nmero 11, para SICOB. Os tpicos que seguem demonstram as particularidades existentes no modelo de nosso nmero que foi escolhido.

163

Nosso Nmero de 11 posies Utilizado nas carteiras Rpida (12) e Sem Registro (14). Para evitar uma exceo, o usurio deve preencher o campo do portflio com o nmero da carteira que deseja utilizar, conforme demonstrado na Figura 113. necessrio tambm que o usurio informe o no campo Usurio N (UsrNumber1), do cadastro de contas bancrias da empresa (DSC1), o cdigo da operao desta conta; Ex: 870. Embora o nosso nmero final possua 11 posies, uma delas reservada para o dgito verificador, e outra um valor constante. Sendo assim, sobram apenas 9 (ou 8, caso esteja utilizando a carteira sem registro) posies vlidas para o nosso nmero no SAP Business One. Em resumo, deve-se utilizar apenas o campo nosso nmero do B1 para preencher o valor do nosso nmero. Nosso Nmero de 16 posies O valor do nosso nmero, que pode ser alterado pelo usurio, possui tamanho igual a 14. Sendo assim, devem ser preenchidos os 9 dgitos finais no campo Nosso Nmero (OurNum), enquanto que os 5 primeiros devem ser preenchidos no campo Nmero do Contrato (U_Contract), ambos da tela de contas bancrias da empresa. Se os valores que iro ficar no campo U_Contract forem todos zeros, pode-se deixar o campo em branco. Exemplos: Nmero 00004000180000
o o U_Contract = 00004; OurNum = 000180000;

Nmero 00000087463001
o o U_Contract = 00000 ou vazio; OurNum = 087463001;

Nosso Nmero de 17 posies A modalidade de cobrana utilizada (1 Registrada ou 2 Sem registro) deve ser informada no campo N Usurio 2 (UsrNumber2), na tela de contas bancrias da empresa. Caso o usurio no informe a modalidade de cobrana, o programa ir assumir que se trata da cobrana registrada(1).

164

O valor do nosso nmero, que pode ser alterado pelo usurio, possui tamanho igual a 15. Sendo assim, devem ser preenchidos os 9 dgitos finais no campo Nosso Nmero (OurNum), enquanto que os 6 primeiros devem ser preenchidos no campo Nmero do Contrato (U_Contract), ambos da tela de contas bancrias da empresa. Se os valores que iro ficar no campo U_Contract forem todos zeros, pode-se deixar o campo em branco. Exemplos: Nmero 000004000180000
o o U_Contract = 000004; OurNum = 000180000;

Nmero 000000087463001
o o U_Contract = 000000 ou vazio; OurNum = 087463001;

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero do Contrato Usurio N 1 Usurio N 2 Nmero da Agncia Nome do campo no B1 Cdigo do Banco Nosso N Nmero do Contrato Usurio N 1 Usurio N 2 Filial Observao Deve ser preenchido conforme instrues acima. Deve ser preenchido conforme instrues acima. Deve ser preenchido conforme instrues acima. Deve ser preenchido conforme instrues acima. Deve ser preenchido com 4 dgitos. Para Nosso Nmero 11 posies: deve ser preenchido com 8 dgitos. Para Nosso Nmero 16 posies: deve ser preenchido com 5 dgitos. Para Nosso Nmero 17 posies: deve ser preenchido com 6 dgitos.

Nmero da Conta bancria

N da Conta

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Fixo 8 para Nosso Nmero 16 posies. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N.

165

9.3.9.

Banco HSBC

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nmero do Contrato Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco Nmero do Contrato Nosso N Filial N da Conta Observao Deve ser preenchido com o nmero do cliente no banco, contendo 5 dgitos, para formar o nosso nmero. Deve ser preenchido com 5 dgitos, totalizando 10 dgitos com o Nmero do Contrato. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos fixo 00 Deve ser preenchido com 1 dgito.

9.3.10.

Banco Itau

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco Nosso N Filial N da Conta Observao Deve ser preenchido com 8 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 5 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 3 dgitos. Deve ser preenchido com 1 dgito.

Caso o valor do boleto possua mais do que 10 caracteres, sero colocados 14 dgitos no cdigo de barras, sobrescrevendo os 4 dgitos do fator de vencimento.

166

Clculo DV Nosso Nmero para carteiras 126, 131, 146, 150, 168. O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso Nmero.

Clculo DV Nosso Nmero para demais carteiras O DV do Nosso Nmero ser calculado sobre o Nmero da Agncia + Nmero da Conta bancria + Carteira + Nosso Nmero.

9.3.11.

Banco Mercantil

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 Cdigo do Banco N do Acordo Observao Deve ser preenchido com dois dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com 6 dgitos. O nosso nmero final ser formado pelo N do Acordo + Carteira + Nosso N, totalizando 10 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 9 dgitos. Deve ser preenchido com o nmero 2 para Sem desconto ou com o nmero 0 para Com desconto.

Nosso Nmero Nmero da Agncia Nmero do Contrato Usurio N 1

Nosso N Filial Nmero do Contrato Usurio N 1

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre o Nmero da Agncia + N do Acordo + Carteira + Nosso N.

167

9.3.12.

Banco Nordeste

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero da Agncia Nmero da Conta bancria DV da Conta Bancria Nome do campo no B1 Cdigo do Banco Nosso N Filial N da Conta Dgito de Controle da Conta Observao Deve ser preenchido com 7 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos. Deve ser preenchido com 1 dgito.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

9.3.13.

Banco Pine

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 Cdigo do Banco N do Acordo Observao Deve ser preenchido com 2 dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com 9 dgitos. O nosso nmero final ser formado pelo N do Acordo + Nosso N, totalizando 11 dgitos. Deve ser preenchido com 7 dgitos, referente a conta que o banco Pine especifica. Deve ser preenchido com 4 dgitos, referente a agncia que o banco Pine especifica.

Nosso Nmero Nmero do Contrato Usurio N 1

Nosso N Nmero do Contrato Usurio N 1

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N final.

168

9.3.14.

Banco Real

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 Cdigo do Banco N do Acordo Observao Deve ser preenchido com 4 dgitos como parte inicial do nosso nmero quando o tipo de cobrana no for registrada. Para cobrana registrada: este campo deve ser preenchido com 7 dgitos. Para cobrana no registrada: este campo deve ser preenchido com 9 dgitos. O Nosso nmero final ser composto pelo N do Acordo + Nosso N, totalizando 13 dgitos. Deve ser preenchido com 7 dgitos, referente a conta que o banco Pine especifica. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Nosso Nmero

Nosso N

Nmero do Contrato Nmero da Agncia Nmero da Conta bancria

Nmero do Contrato Filial N da Conta

Cadastro de Formas de Pagamento OPYM

Campo Nome do campo no B1 Observao Quando este campo for preenchido com os caracteres NR, sem aspas, o BankSync ir considerar que o tipo de cobrana No Registrada. Quando este campo estiver em branco ou preenchido com qualquer outra informao, o BankSync ir considerar que o tipo de cobrana Registrada. Deve ser preenchido com 1 dgito.

Tipo de Cobrana

Local de pagamento

Moeda

Cdigo da Moeda

O DV do Nosso Nmero ser calculado sobre o + Nosso N final + Nmero da Agncia + Nmero da Conta bancria.

169

9.3.15.

Banco Safra

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero do Contrato Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco Nosso N Nmero do Contrato Filial N da Conta Observao Deve ser preenchido com 8 dgitos. considerado apenas para Cobrana Direta Eletrnica. Deve ser preenchido com 6 dgitos. Deve ser preenchido com 5 dgitos. Deve ser preenchido com 9 dgitos. Deve ser preenchido com o nmero 1, sem aspas, ou estar em branco para que o BankSync considere como Cobrana Direta Eletrnica. Deve ser preenchido com o nmero 2, sem aspas, para que o BankSync considere como Cobrana Express. Quando o tipo de cobrana for Express, sero considerados 17 caracteres deste campo para formao do Campo Livre.

Tipo de cobrana

Usurio N 1

Campo livre

Usurio N 2

Cadastro de Formas de Pagamento OPYM

Campo Moeda Nome do campo no B1 Cdigo da Moeda Observao Deve ser preenchido com 1 dgito.

9.3.16.

Banco Safra (Bradesco Correspondente)

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.
Cadastro de Contas Bancrias da Empresa DSC1
Campo Nmero do banco Nosso Nmero Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Observao Fixo 237 Deve ser preenchido com 8 dgitos. O nosso nmero final composto pelo Nosso N + DV Safra, calculado de acordo com o manual do banco Safra, totalizando 9 dgitos. Fixo 3114 Fixo 0176300

Nosso N -

Cadastro de Formas de Pagamento OPYM

Campo Moeda Carteira Nome do campo no B1 Cdigo da Moeda Observao Deve ser preenchido com 1 dgito. Fixo 09

170

O DV do Nosso Nmero ser calculado sobre a Carteira + Ano de Emisso do Boleto + Nosso N final (8 dgitos + DV Safra), calculo este realizado de acordo com as especificaes do Bradesco.

9.3.17.

Banco Santander

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nmero do Acordo Nosso Nmero Nmero do Contrato Nome do campo no B1 Cdigo do Banco N do Acordo Nosso N Nmero do Contrato Observao Deve ser preenchido com 3 dgitos como parte inicial do nosso nmero quando o Nmero do Banco for 033. 033 353 - 008: Devem conter 7 dgitos no Nosso Nmero Deve ser preenchido com 7 dgitos Cdigo do Cedente.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 3 dgitos. Deve ser preenchido com 1 dgito.

9.3.18.

Banco Sicredi

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.
171

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nmero da Agncia DV da Agncia Nmero da Conta bancria Nome do campo no B1 Cdigo do Banco Nosso N Filial Chave de controle N da Conta Observao Deve ser preenchido com 9 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 2 dgitos. Deve ser preenchido com 5 dgitos. Deve ser preenchido com o nmero 1, sem aspas, para que o BankSync considere como Cobrana Registrada. Tipo de cobrana Usurio N 1 Deve ser preenchido com o nmero 3, sem aspas, ou em branco para que o BankSync considere como Cobrana sem Registro.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 Cdigo da Moeda Observao Fixo 1 Deve ser preenchido com 1 dgito.

O DV do Campo Livre inserido na ltima posio do cdigo de barras.

9.3.19.

Banco Sofisa

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

172

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 Cdigo do Banco N do Acordo Observao Deve ser preenchido com 2 dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com 9 dgitos. O nosso nmero final ser formado pelo N do Acordo + Nosso N, totalizando 11 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Nosso Nmero Nmero da Agncia Nmero da Conta bancria

Nosso N Filial N da Conta

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N final.

9.3.20.

Banco Unibanco

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 Cdigo do Banco N do Acordo Observao Deve ser preenchido com 1 dgito como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com 9 dgitos. O nosso nmero final ser formado pelo N do Acordo + Nosso N, totalizando 10 dgitos. Deve ser preenchido com 5 dgitos, incluindo o DV.

Nosso Nmero Nmero da Agncia

Nosso N Filial

Cadastro de Formas de Pagamento OPYM

Campo Moeda Nome do campo no B1 Cdigo da Moeda Observao Deve ser preenchido com 1 dgito.

Ao final do cdigo de barras inserido um DV calculado sobre "1" + Nosso N final + DV Nosso Nmero. 9.3.21. Banco BicBanco
173

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Radical Matrcula Nmero da Agncia Nmero da Conta bancria Nome do campo no B1 Nosso N Usurio N 1 Usurio N 2 Filial N da Conta Observao Fixo 237 Deve ser preenchido com 6 dgitos. Deve ser preenchido com 2 dgitos de acordo com a especificao no manual do banco. Deve ser preenchido com 3 dgitos de acordo com a especificao no manual do banco. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Radical + Matrcula + Nosso N.

9.3.22.

Banco BicBanco (Correspondente Bradesco)

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.

174

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Radical Matrcula Nmero da Agncia Correspondente Nmero da Conta bancria Correspondente Nome do campo no B1 Nosso N Usurio N 1 Usurio N 2 Usurio N 3 Usurio N 4 Observao Fixo 237 Deve ser preenchido com 6 dgitos. Deve ser preenchido com 2 dgitos de acordo com a especificao no manual do banco. Deve ser preenchido com 3 dgitos de acordo com a especificao no manual do banco. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Radical + Matrcula + Nosso N.

9.3.23.

Banco Sofisa (Correspondente)

Abaixo so listados os campos requisitados pela DLL para confeco do cdigo de barras.
175

Cadastro de Contas Bancrias da Empresa DSC1

Campo Nmero do banco Nosso Nmero Nome do campo no B1 N do Acordo Observao Fixo 237 Deve ser preenchido com 2 dgitos como parte inicial do nosso nmero devido a limitao do campo Nosso N no Business One. Deve ser preenchido com 9 dgitos. O nosso nmero final ser formado pelo N do Acordo + Nosso N, totalizando 11 dgitos. Deve ser preenchido com 4 dgitos. Deve ser preenchido com 7 dgitos.

Nosso Nmero Nmero da Agncia Correspondente Nmero da Conta bancria Correspondente

Nosso N Usurio N 4 Usurio N 3

Cadastro de Formas de Pagamento OPYM

Campo Carteira Moeda Nome do campo no B1 N do Portflio Cdigo da Moeda Observao Deve ser preenchido com 2 dgitos. Deve ser preenchido com 1 dgito.

O DV do Nosso Nmero ser calculado sobre a Carteira + Nosso N.

9.3.24.

Dummy

A DLL Dummy foi desenvolvida com o nico intuito de pular a etapa da verificao do cdigo de barras e dgito verificador do nosso nmero, executados durante a criao de um novo boleto de Contas a Receber. Ela sempre ir validar estes valores, e ir retornar zeros tanto para o cdigo de barras quanto para o dgito verificador do nosso nmero.

9.3.25.

Particularidade com o DV do Nosso Nmero

Alguns bancos como o Safra Correspondente Bradesco utilizam mais de um DV para o Nosso Nmero em seu processo bancrio. Infelizmente o Business One permite a gravao de
176

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 cdigo de barras, e caso necessrio, este deve ser extrado a partir do cdigo de barras gravado no campo Barcodenum da tabela OBOE.

10. Funcionalidades

10.1. OneShare
Essa ferramenta permite ao usurio efetuar os processos de importao e exportao dos seguintes leiautes: Leiautes de Remessa Leiautes de Retorno Leiautes de Extrato Bancrio Simples Leiautes de Extrato Bancrio CNAB Leiautes de Nomenclatura de Arquivo de Remessa

O OneShare proporciona para o usurio a facilidade e versatilidade ao importar seus leiautes. De forma simplificada, voc poder fazer backups de seus leiautes, fazer transferncia deles para outra base ou at mesmo fazendo esse processo somente nos leiautes que desejar. OBS: Est ferramenta est disponvel apenas para as verses do BankSync superiores a 4.0.0.

10.1.1.

Exportao de leiautes

Primeiramente execute seu SAP Business One, logo aps inicie o add-on BankSync, e percorra o seguinte caminho: Administrao / Configurao / Banco / OneShare / Exportao de Leiautes, conforme a Figura 114 abaixo:

177

Figura 114: Caminho do OneShare

Aps abrir a janela de Exportao de Leiautes, clique no boto Seguinte conforme a Figura 115:

178

Figura 115: Tela inicial da exportao de leiautes

Ao executar o procedimento acima, a prxima tela (Figura 116) ir solicitar ao usurio a identificao do local para que sejam salvo os leiautes. Escolha o caminho no qual deseja salvar os leiautes do BankSync pressione o boto seguinte:

179

Figura 116: Tela informando o caminho para salvar o arquivo de leiaute

J na tela de seleo de leiautes do BankSync (Figura 117), o usurio deve identificar os leiautes desejados para o processo de exportao. Cada opo de tipos de leiautes so indicados pelas abas acima da grade de seleo:

180

Figura 117: Tela de seleo de leiautes a serem exportados

Depois de selecionados os leiautes desejados, clique no boto seguinte para finalizar a exportao. Os arquivos exportados estaro no caminho em que o usurio indicou.

10.1.2.

Importao de leiautes

Primeiramente execute seu SAP Business One, logo aps inicie o add-on BankSync e percorra o seguinte caminho: Administrao / Configurao / Banco / OneShare / Importao de Leiautes, conforme a Figura 118 abaixo:

181

Figura 118: Caminho do OneShare

Aps abrir a janela de Importao de Leiautes, clique no boto Seguinte conforme a Figura 119:

182

Figura 119: Tela inicial da exportao de leiautes

Ao executar o procedimento acima, a prxima tela (Figura 120) ir solicitar ao usurio a identificao do local onde foram salvos os leiautes. Nela identifique o caminho e selecione o boto Seguinte:

Figura 120: Tela que informar o caminho onde foi salvo o arquivo de leiaute

183

Aps clicar no boto Adicionar, ser aberta a tela na qual o usurio deve selecionar o arquivo .share ou .zip referente aos leiautes que o mesmo deseja importar. Selecionado o arquivo, o usurio deve clicar no boto Seguinte para que passe para o processo de seleo de leiautes para importao. Na tela de Seleo de Leiautes para Importao (Figura 121), o usurio marcar os leiautes desejados por meio do campo Sel, aps efetuar as escolhas clicar no boto Seguinte.

Figura 121: Tela de seleo de leiautes a serem importados

Selecionado o arquivo, o usurio deve clicar no boto Seguinte avanando para a prxima etapa.

184

Figura 122: Tela de correo de informaes referentes aos leiautes a serem importados

Ao efetuar a escolha dos leiautes desejados, o usurio passa para a tela de Correo de Dados dos Leiautes (Figura 122). Na tela de correo de dados o usurio poder alterar determinados campos do leiaute como: Cdigo e Nome. Tambm est disponvel a opo de Sobrescrever que ir sobrescrever um leiaute j existente em sua base de dados caso o cdigo for igual. Caso o usurio no deseje a opo de sobrescrever baste ele trocar o cdigo do leiaute em questo ou desmarcar a flag da coluna Sobrescrever. A coluna Situao (Figura 123) ir mostrar ao usurio se o leiaute que ele esta tentando importar j est sendo utilizado no sistema ou no, identificando isso pelo cdigo do leiaute. Caso o cdigo do leiaute seja igual a outro cdigo j existente em sua base de dados, o status desta coluna Situao ser sobrescrever.

185

Figura 123: Tela de finalizao de importao de leiautes

Aps efetuar as alteraes desejadas, o usurio dever clicar no boto Seguinte para finalizar a importao.

10.2. Consulta ao SERASA

Essa funcionalidade foi lanada a partir da verso 5.0.5 do BankSync, com ela voc poder efetuar consultas ao SERASA, porm como pr-requisito necessrio a contratao de um servio sujeito a tarifas. Para contratar esse mdulo de servio, preciso acessar o site: www.consultacpf.com (Distribuidor autorizado SERASA Experian Online), telefone: +55 (11) 40633214. 10.2.1. Configurao da consulta SERASA

Acessando o seguinte caminho: Mdulos | Administrao | Inicializao do Sistema | Configuraes SERASA (Figura 124), ser apresentada uma tela onde poder efetuar configuraes a respeito da funcionalidade de consulta ao SERASA.

186

Figura 124: Caminho para acesso s configuraes SERASA

Na aba Configurao (Figura 125), o campo WebService contm os endereos dos WebServices de teste e de produo.

187

Figura 125: Configuraes SERASA / aba Configurao

OBS: os campos WebService, Usurio e Senha so de preenchimento obrigatrio.

Na aba Permisses de acesso (Figura 126) sero exibidos os usurios cadastrados no sistema, permitindo configurar atravs da seleo, quais so os usurios que tero acesso para realizar novas consultas e visualizar os histricos de pesquisas j existentes do SERASA.

Figura 126: Configuraes SERASA / Aba Permisses de acesso

188

Na aba Informaes (Figura 127), ao clicar no boto Consultar saldo ser realizado uma consulta no WebService do SERASA sendo preenchidos os campos Saldo atual e Mensagem de acordo com o resultado do retorno do Webservice (Figura 128).

Figura 127: Configuraes SERASA / Aba Informaes

Figura 128: Configuraes SERASA / Aba Informaes / Consulta de Saldo

189

10.2.2.

Utilizao da consulta SERASA

No caminho: Mdulos | Parceiro de negcios | Consultas SERASA, ser possvel o acesso tela de consultas ao SERASA (Figura 129).

Figura 129: Consultas SERASA

OBS: caso o usurio corrente no possua ao menos permisso para visualizao das consultas j realizadas, o sistema emitir uma mensagem alertando o usurio e a abertura da tela dever ser cancelada. Para realizar uma nova consulta dever ser selecionado o Parceiro de negcio. Aps selecionar o Parceiro de negcio e clicar no boto Nova Consulta, ser aberta a tela de Nova consulta SERASA (Figura 130), onde ser exibido a opo de realizar uma consulta Simples ou Completa. Ao selecionar uma consulta completa ser habilitado o boto Detalhar consulta, se for uma consulta simples o boto permanecer desabilitado.

190

Figura 130: Consultas SERASA / Nova Consulta SERASA

OBS: o boto Nova Consulta estar visvel somente para os usurios que possurem permisso de consultar, que configurado na aba Permisses de acesso. Ao finalizar uma consulta com sucesso, opo Nova consulta SERASA ser fechada e a grade Histrica de consultas da opo de Consultas SERASA ser atualizada com novas informaes. Selecionando um histrico de uma consulta completa, o boto Detalhar consulta ser habilitado, dessa forma ser aberta a tela de Consulta completa SERASA: Detalhes (Figura 131) onde mostra em detalhes a consulta e o tipo de pendncia.

191

Figura 131: Tela de Consulta completa SERASA

Para facilitar o acesso, possvel efetuar uma consulta ao SERASA diretamente no cadastro do Parceiro de negcios, porm esse boto presente na tela de cadastro (Figura 132) ser visvel apenas para o usurio logado que tiver permisso para Consultas SERASA.

Figura 132: Boto de Consulta SERASA

192

10.3. Lanamentos contbeis extras

Foi includo o parmetro BankSync.LanctoAdicionalPagtoBoleto (Figura 133) na tela de Administrao | Inicializao do Sistema | Configurao do BankSync que, ao ativa-lo utilizando a informao true, ir efetuar lanamentos contbeis extras no momento da baixa dos ttulos no B1, para Contas a Receber.

Figura 133: Add-on Settings Parmetros do BankSync

Para que o processo insira esses lanamentos, necessria a configurao das contas contbeis nos campos Conta Contbil e Banco de Cobrana na tela de Administrao | Configurao | Banco | Contas bancrias da empresa (Figura 134):

193

Figura 134: Contas bancrias da empresa Configurao das contas

Quando a transao movimenta um documento para o status Pago, conforme a Figura 135, os lanamentos extras so inseridos da seguinte forma: Lanamentos Atuais Gerao do Boleto D Contas a Receber de Boletos (Determinao Contbil / Cadastro de PN) C Contas a Receber (Determinao Contbil / Cadastro de PN) Depsito do Boleto (Registro no Banco) D Conta de Cobrana (Contas Bancrias da Empresa) C Conta de Apresentao do Boleto (Determinao Contbil / Cadastro do PN) Pagamento do Boleto D Conta de Apresentao do Boleto (Determinao Contbil / Cadastro do PN) C Contas a Receber de Boletos (Determinao Contbil / Cadastro de PN) Lanamentos Adicionais Pagamento do Boleto D Conta Contbil (Contas Bancrias da Empresa) C Conta de Cobrana (Contas Bancrias da Empresa)
194

Figura 135: Lanamento contbil manual Lanamentos extras

10.4. Backup peridico dos leiautes

A funcionalidade de backup de leiautes no modo automtico e manual, permite efetuar backups peridicos 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 instalao do Business One), especificamente na aba DB Manager do Painel, existe o boto Backup Layout (Figura 136) onde ir permitir o backup manual de todos os leiautes da base de dados.
195

Figura 136: Painel de Controle Boto Backup Layout

Aps clicar no boto Backup Layout, ir aparecer uma janela (Figura 137) solicitando o caminho na qual o usurio deseja salvar esse backup. Selecionando esse caminho, o processo ser iniciado e posteriormente concludo, disponibilizando um arquivo de extenso .zip contendo todos os leiautes da base de dados.

Figura 137: Painel de Controle Caminho do Backup

196

Para efetuar o backup automtico desses leiautes, necessria a ativao de um parmetro no BankSync de acordo com as instrues abaixo: Acessando o seguinte caminho do B1: Administrao | Inicializao do sistema | Configurao do BankSync, ir acionar uma tela que solicitar uma Senha de Acesso (Figura 138). Enviando o Cdigo de Acesso para o e-mail sap@sistemainfo.com.br, o Suporte Tcnico da Sistema Informtica Empresarial, ir retornar com uma Senha de Acesso para efetuar as devidas configuraes.

Figura 138: Configurao do BankSync - Acesso Restrito

Aps inserir a Senha de Acesso disponibilizada pela equipe tcnica da Sistema Info, a tela de parmetros abaixo (Figura 139) ser apresentada:

197

Figura 139: Configurao do BankSync AddOn Settings

Modificando o parmetro BankSync.AdministradorBackupLayout para o valor true, uma nova opo no menu do B1 ser adicionado (Figura 140). Porm ser preciso reconectar o add-on pelo Painel de Controle, marcando a opo Ativar Todos os Mdulos e Forar a Verificao da Base (Figura 141).

198

Figura 140: Menu B1 Nova opo

Figura 141: Painel de Controle - Conexo

199

Acessando a nova opo no menu do B1, a tela se solicitao de Senha de Acesso ir aparecer novamente, tendo que solicita-la a equipe de Suporte Tcnico da Sistema Info. Inserindo a Senha de Acesso, a tela do Administrador de Backup Layouts ser apresentada conforme Figura 142. Nela possvel a parametrizao do backup automtico dos leiautes, tendo as opes de backup: dirio, semanal, quinzenal e mensal, podendo tambm configurar o horrio (hora e minuto) em que o backup ser gerado.

Figura 142: Menu B1 Administrador de Backup Layouts

Efetuando a parametrizao conforme necessidade do usurio, ser possvel monitorar os backups acessando a tabela @SIEBS_BKPL (Figura 143), onde registrar sempre o ltimo backup de leiautes executado na base de dados.

Figura 143: Gerador de Consultas Tabela de Backups

200