Manual

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

PrezadoCliente,
OCobreBemXumcomponenteCOM''novisual''distribudosobaformadeDLL,possuindoas
seguintesfuncionalidades:
ImpressodeBoletosBancriosemimpressorasLaserouJatodeTintaparadiversoBancos;
EnviodeBoletosporEMail;
GeraodeArquivoRemessapadroCNABepadroFEBRABAN3.0;
LeituradeArquivoRetornopadroCNABepadroFEBRABAN3.0;
WizarddeConfiguraodeContasCorrentes;
GeraodeBoletosBancriosOnLinenoambienteWindows;
GeraodeArquivoRemessaparaDbitoemContaCorrente;
LeituradeArquivoRetornodeDbitoemContaCorrente;
IntegraosoluodeAutomatizaodeCartodeCrditoAprovaFcil.
Esperamos atravs desta documentao orientlo da melhor forma possvel e aproveitamos a
oportunidadeparacolocarmonosinteiramentesuadisposioparamaioresesclarecimentos.
ParaentraremcontatoconoscoutilizeoscanaisdecontatodisponibilizadosnaURLabaixo:
http://www.cobrebem.com/contato.html

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

NDICE
1.Instalao...........................................................................................................................................4
2.ExemplosparaUtilizaodoComponente.......................................................................................5
3.RealizaodeTestes..........................................................................................................................6
4.ChavesdeLicenasDefinitivas......................................................................................................7
5.ConfiguraodeContasCorrentes....................................................................................................9
6.DefiniodaCobrana....................................................................................................................11
7.DbitoemContaCorrente...............................................................................................................13
8.EnviodeBoletoporEMail............................................................................................................14
9.LayoutsdeBoletos..........................................................................................................................15
10.GeraoOnLine...........................................................................................................................16
11.ArquivoRemessa...........................................................................................................................16
12.ArquivoRetorno............................................................................................................................17
13.DocumentaoTcnica.................................................................................................................20
14.InformaoaoDesenvolvedor.......................................................................................................20
15.Desinstalao.................................................................................................................................21
16.DvidasFrequentes.......................................................................................................................21

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

1.Instalao
Para utilizar o componente CobreBemX, se faz necessrio instalar o CobreBemX em seu
computador.
Procedimento:
1. Descompacteoarquivodeinstalaoemumdiretriodesejado;
2. Executeoarquivo''Instalar.exe''pararegistraraDLLnoseuservidor.
Casovocsejadesenvolvedor,vocprecisarinstalaroCobreBemXnocomputadordoseuCliente
emconjuntocomoprogramadesenvolvidoparte.
Procedimento:
1. CopieoarquivoCobreBemX.dllparaqualquerdiretriodocomputadordocliente.Depreferncia
quesejaomesmodiretrioondeoprogramaestinstalado;
2. Registre a DLL no Windows utilizando, o arquivo ''Instalar.exe'' contido na instalao do
CobreBemX.CasoestejautilizandoumprogramadeinstalaocomoWiseouInstalShield,basta
incluir o arquivo ''CobreBemX.dll'' em sua aplicao e solicite que o mesmo seja registrado no
Windowspeloinstalador;
3. IncluatambmosarquivosdeimagemqueoclienteirnecessitarparautilizarasfunesdeEnviode
BoletoporEMail,GeraodeHTMLdeBoletoeImpressodeBoletos.Sugerimosquetodossejam
instalados.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

EstruturadeInstalao

2.ExemplosparaUtilizaodoComponente
fornecido no diretrio ''Exemplos'' que acompanha a instalao do componente, fontes que
demontramasfuncionalidadesexistentesnoCobreBemX,nasseguinteslinguagens:
Access2000

Delphi

Java

Progress

Access97

Excel

NetExpress

VisualBasic

AcucoBol

FiveWin

PHP

VisualDataFlex

ASP

HTML+JavaScript

PowerBuilder

VisualFoxPro

Clarion

HTML+VBScript

PowerCobol

ASPAbap4

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

Vejaabaixoalgumasdaslinguagensqueoferecemmaisdeumexemplo:
ASPAprovaoCartoCrdito

DelphiLayoutsPersonalizados

ASPBoletoOnLine

DelphisemBancodeDados

ASPEnvioBoletoEMail

VisualBasic5comBancodeDados

ASPGeraoArquivoRemessa

VisualBasiccomBancodeDados

ASPImpressoBoletos

VisualBasicLayoutsPersonalizados

ASPLeituraArquivoRetorno

VisualBasicsemBancodeDados

DelphicomBancosdeDados

VisualFoxProGeraoArquivoRemessa

O CobreBemX pode ser utilizado com qualquer tipo de Banco de Dados. Os exemplos que
acompanhamocomponenteutilizamBancodeDadostipoParadox(Delphi)eMicrosoftAccess(Visual
Basic).

3.RealizaodeTestes
Nodiretrio''Exemplos/Licenas'',hapenaso''arquivodelicenaparateste'',utilizadopararealizar
quaisquertiposdetestesnecessrio,tendodisponveltodasasfuncionalidadesqueocomponenteoferece.
Para efetuar os testes sigaas instrues contidas na pgina ''Caractersticas Bancos e Carteiras''
acessandoaatravsdaURL:http://www.cobrebem.com/cgibin/GeraArquivoLicencaTeste.
Estando na pgina "Caracterstica Bancos e Carteiras", escolha o banco e carteira que sero
utilizadoseobservealistadepropriedades,oslayoutspara:geraodearquivosderemessa,leiturade
arquivosderetorno,geraodeboletosimpressoseboletosporemailqueseroexibidosparaobancoe
carteiraescolhidos.
Cliquenoboto"GerarArquivo",paraefetuarodownloaddoarquivodelicenadetestedobancoe
carteiraselecionadosanteriormente.
Aoutilizaralicenadeteste,observequeaspropriedades"ValorDocumento","NomeCedente"e
"DataVencimento" estaro com os valores fixos, respectivamente, "1,90", "Cedente de Teste" e
"01/08/2007".
TelaondeseroinformadosoBancoeaCarteiraparageraodoarquivo.conf

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

TeladeGeraodeArquivodeConfiguraodeTeste

4.ChavesdeLicenasDefinitivas
Ao adquirir o CobreBemX sero encaminhadas as chaves de licena para gerar os arquivos de
licenasparaosbancosecarteirasdoseuCedente.
OarquivodelicenageradoparacadaCedente/Banco/Carteiraeportantonoserveparaqualquer
banco,somenteparaogeradoanteriormente.
UmaChavedeLicenaDefinitivapermiteageraoparaummesmoCedente,identificadopelo
CPFouCNPJdequantosarquivosdelicenaforemnecessriosparadiversosBancos/Carteiras.
OsarquivosdelicenadeverosergeradosatravsdaURL:http://licenca.cobrebemx.com.br.
AoacessaraURLcitadaanteriormente,preenchacorretamentetodososcampos:
1. Nocampo"ChavedeLicenas",encaixeaschavesquelheforamenviadas.
2. Nocampo"CNPJ/CPF",informeoCNPJouoCPF,quedeveestarvlidoeativonaReceitaFederal.
ComoocedenteseridentificadopeloCNPJouCPFinformadonessecampo,oqueforinformado
serverificadonaReceitaFederal.Somentemarqueaopo"NomeFantasia",sedesejarqueseja
exibidonoboletoonomefantasiadocedente.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

3. Emseguida,informeoCEPeRamodeAtividade.
4. SelecioneoBancoqueserutilizadonascobranas,dentrealistaapresentada.Casooseubancono
estejanestalista,nosenvieomanualdecobranadomesmoparaquepossamosinclulojuntoao
componenteCobreBemX.Depois,selecioneacarteirautilizada(essainformaomuitoimportante
paraqueacobranasejarealizadacorretamente,nadvida,entreemcontatocomaaradecobrana
doseubanco).
Importante: Vale ressaltar que para utilizar a modalidade de cobrana Boleto Bancrio, o
Cedente dever ter uma conta corrente habilitada para sua cobrana junto ao Banco de sua
preferncia.
Leiacomatenoo"ContratodeLicenadeUso",aoconcordarcomostermosexibidos,cliqueem
"Aceito".Sendoassim,iraparecerumanovapgina,comosdadosrelativosaolicenciamentodoCedente,
verifiquesetodososdadoscontidosnessapginaestocorretos,seno,cliquenoboto"AlterarDados".
Setodosasinformaesestiveremcorretas,cliquenoboto"GerarLicena".Informeodiretrio
ondedeversergravadooarquivodeconfigurao(.conf).

TelaondeseroinformadososdadosdoCedente

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

5.ConfiguraodeContasCorrentes
Ao integrar o CobreBemX sua soluo, ser necessrio configurar a conta corrente que ser
utilizada.
Osdadosdecontacorrentedeveroestarpresentessempre,poissemelesnoserpossvelrealizar
nenhumoutrocomandodocomponente.
Para configurar sua conta corrente voc dever saber exatamente quais informaes aquele
determinadoBancoeCarteirasolicitameoformatocujaessasinformaesdeveroserpassadas.
Htrsformasdevocverificarquaissoessesdados,veja:
ApartirdaURL:http://www.cobrebem.com/cgibin/GeraArquivoLicencaTeste;
Utilizandoomtodo"ConfiguraContaCorrente",poisesteexibeumateladesolicitaodosdados
jconsiderandooBancoeaCarteirainformadopeloarquivodelicena;
Construindoumatelapersonalizadaparaaconfiguraodaconta,utilizandoaspropriedadescujos
nomessoiniciadosem"Mascara","Cabecalho"e"Ajuda".NositedaCobreBemTecnologia,
nomenu "Download",nolink''MaisDownloads'',humexemploemDelphiqueorientacomo
fazla.
ApresentamosabaixoalgumaspropriedadesutilizadasparaaConfiguraodeumacontacorrente:
Propriedade"ArquivoLicenca"(Tipo:String)
Utilizadaparainformaroarquivodelicenaqueserusadoparagerarosboletos,ocaminho
doarquivodelicenadeverserocamihofisicoeabsolutotantoparageraodeboletosonline
comoDesktop.
Propriedade"CodigoAgencia"(Tipo:String)
Utilizada para informar o nmero da agncia do banco que ser utilizada para gerar os
boletos.
Propriedade"NumeroContaCorrente"(Tipo:String)
Utilizadaparainformaronmerodacontacorrentequeserutilizadaparagerarosboletos.
Propriedade"CodigoCedente"(Tipo:String)
Utilizadaparainformarocdigodocedenteoualgumaoutrainformaonecessriapara
configuraracontacorrente.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

Propriedade"OutroDadoConfiguracao1"(Tipo:String)
Estapropriedadeusadacomocampoauxiliarnoprocessodeconfiguraoesomente
usadoquandonecessrio.
Propriedade"OutroDadoConfiguracao2"(Tipo:String)
Estapropriedadeusadacomocampoauxiliarnoprocessodeconfiguraoesomente
usadoquandonecessrio.
Importante:Parasaberoquedeveserpassadoparaaspropriedadesdeconfiguraodeconta
corrente,ouseja,ocontedo,bastaacessaraseguinteURL: http://www.cobrebem.com/cgi
bin/GeraArquivoLicencaTeste.

PropriedadesrelacionadasaoNossoNmero:

InicioNossoNumero(Tipo:String)Utilizadaparainformaroinciodanumeraodocampo
"nossonumero".

FimNossoNumero (Tipo: String) Usada para informar o fim da numerao do campo

nossonumero.

ProximoNossoNumero(Tipo:String)Estapropriedadecontmainformaodo
ltimonossonmerogerado.

ExistemduasformasdetrataroNossoNmero:
Primeira:
OCobreBemXirnumerarsequencialmenteosdocumentosdecobranautilizandoparaisso
osvaloresdaspropriedadescitadasacima.
Segunda:
O seu programa informar o valor desejado na propriedade "NossoNumero", do Objeto
IDocumentoCobranca.OCobreBemXvaiselimitaraformatarecalcularosdgitosverificadoresdo
NossoNmero.
Importante: Existe um mtodo chamado "ConfiguraContaCorrente", que quando utilizado
exibeumatelaparaoCedenteconfigurarosdadosdecontacorrente,comamscaracorreta
paraobancoecarteirautilizadopeloarquivodelicena(.conf).Mesmoutilizandoessemtodo,
vocprecisainformar,tambm,apropriedade"ProximoNossoNumero",queinformaoltimo
nossonumerogerado.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

10

Asintaxedeexemploficariadaseguinteforma:
CobreBemX.ConfiguraContaCorrente;
CobreBemX.ProximoNossoNumero:='15';
Comovistoacima,paravocpersonalizarologotipodoseuboleto,bastaadicionaraoseucdigoa
seguintelinha:

CobreBemX.PadroesBoleto.PadroesBoletoImpresso.ArquivoLogotipo:=
'c:\CobreBemX\Imagens\BannerCBX.gif';
Apropriedade"ArquivoLogotipo",doTipoString,utilizadaparadefinirocaminhofsicoonde
estologotipoaserusadonoboleto.
Paraaconfecodologotipoutilizepreferencialmenteotamanhode234x60pixelsparaqueno
hajanenhumadistorodesuaimagem.
Informarsempreapropriedade"CaminhoImagensCodigoBarras",poissemelaocdigodebarras
noserexibido,veja:
CobreBemX.PadroesBoleto.PadroesBoletoImpresso.CaminhoImagensCodigoBarras:='C:\Documentsand
Settings\Imagens\';

6.DefiniodaCobrana
Apsconfigurarasuacontacorrentenocomponente,sefaznecessriodefiniracobrana,ouseja,
criarseusboletosbancrio.
Paraaemissododocumentodecobrana(BoletoBancrio)utilizadoasseguintespropriedades:
(...)
Boleto:=CobreBemX.DocumentosCobranca.Add;
Boleto.NumeroDocumento:='12345';
Boleto.NomeSacado:='Teste';
Boleto.CPFSacado:='111.111.11111';
Boleto.EnderecoSacado:='RuadeTeste';
Boleto.BairroSacado:='BairrodeTeste';
http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

11

Boleto.CidadeSacado:='CidadedeTeste';
Boleto.EstadoSacado:='RJTESTE';
Boleto.CepSacado:='01001001';
Boleto.DataDocumento:='11/10/2005';
Boleto.DataVencimento:='10/09/2005';
Boleto.ValorDocumento:=14;
Boleto.PadroesBoleto.Demonstrativo := 'Referente a compras na WEB<br><b>O melhor site da
Internet</b>';
Boleto.PadroesBoleto.InstrucoesCaixa:='Nodispensarjurosemultaapsovencimento';
CobreBemX.ImprimeBoletos;
Propriedade"NumeroDocumento"(Tipo:String)
Utilizadaparainformarumnmeroparacontroleprprioutlizeporexemploparainformaro
nmerodopedidooudanotafiscal.
Propriedade"DataVencimento"(Tipo:String)
Sevocdesejargerarumboleto"semdatadevencimentodefinida"coloqueotexto"vista"
nestapropriedade.Seestapropriedadeestiverebrancoserverificadoovalordestapropriedade
comoPrazoVencimento.Quandoinformado,estapropriedade,deverseguiroformatodd/mm/aaaa.
Propriedade"ValorDocumento"(Tipo:Double)
Utilizada para informar o valor do documento. Nesta propriedade ser informado valor
liquidododocumento.

Propriedade"ValorDesconto"(Tipo:Double)
Utilizadoparainformarovalordodescontoaserconcedidosobreovalordodocumento.
Esta propriedade segue as mesmas regras de formatao da propriedadeValorDocumento.
Observao:VocpoderespecificaroPercentualdoDescontoouoValordesejado.
Paraasmensagensnoboleto,utilizeasseguintespropriedades:
PropriedadeDemonstrativo(Tipo:String)
UtilizadaparainformarocontedodocampoDemonstrativodoboleto,estecampolivre
podendoserpersonalizadocomoporexemploinserirumaimagemoucdigohtml.
Propriedade"InstrucoesCaixa"(Tipo:String)
Utilizadaparasetarasinformaesqueseroexibidasnocampo"instruesdecaixa"dos
boletosestecampotambmsuportacdigohtml.Almdasinstruesquesopassadasestecampo
doboletotambmreceberaasinstruesdejurosemulta,casoelesexistam.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

12

Finalmente,necessriopassaromtodoparaquepossasercriadoosboletos.
Utilizeomtodo"ImprimeBoletos",eleirverificatodaacoleodocumentosdecobrana,eem
seguidasurgirumatelade"PreView".
Paraimprimirosboletossempreview,bastautilizaromtodo"ImprimeBoletosSemPreview",ele
equivalenteaomtodo"ImprimeBoletos",pormnoexibeateladepreviewdaimpressoenviandoos
boletosdiretamenteparaaimpressoraselecionadacomopadronoWindows.

7.DbitoemContaCorrente
Parautilizarestemeiodepagamento,necessrio:
TeracontacorrentehabilitadajuntoaobancoemumacarteiradecobranaquepermitaoDbitoem
ContaCorrente;
OSacadodevepossuircontanomesmoBancoqueoCedente.
ODbitoemContaCorrente,noCobreBemXtratadocomoumarquivoderemessa''comum'',ou
seja,semelhanteaoutilizadoparaemissodeboletos.SendoqueparautilizaromeiodepagamentoDbito
Automtico em Conta Corrente, de suma importncia a incluso duas propriedades do objeto
DocumentosCobranca,soelas:

AgenciaDebitoInformeaAgnciadoSacado;
ContaCorrenteDebitoInformeaContaCorrentedoSacado.
ParaoCobreBemXgeraroarquivonolayoutdedbitoemcontacorrente,deverser passadoo
valorDebitoCCparaapropriedadeCobreBemX.ArquivoRemessa.Layout.
Algunsbancosnoutilizamestelayout.Paraverificarolayoutsuportadopeloseubancoacessea
URLaseguir:http://www.cobrebem.com/cgibin/GeraArquivoLicencaTeste.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

13

8.EnviodeBoletoporEMail
O componente CobreBemX envia diversos boletos aos seus clientes em formato html ou como
arquivoanexadoutilizandoapenasumaconexocomoseuservidorSMTP.
Para realizar o envio do boleto por email necessrio que sejam informadas as propriedades
referentes ao arquivode licena, conta corrente, agncia, entre outras pertinentes cobrana, conforme
abaixo:
CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Servidor:='SEUSERVIDOR';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Porta:=NMERODAPORTA;
CobreBemX.PadroesBoleto.PadroesBoletoEmail.URLImagensCodigoBarras:='URLCDIGO
DEBARRAS';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.URLLogotipo:='URLIMAGEMLOGOTIPO';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.Assunto:='ASSUNTOEMAIL';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.EmailFrom.Endereco:=
'ENDEREOEMAILCEDENTE';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.EmailFrom.Nome:=
NOMECEDENTE;
Paraservidoresdotiposeguros,preenchaaspropriedades:
CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Usuario:='NOMEDOUSURIO';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Senha:='SENHADOUSURIO';
CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.FormaEnvio
:=feeSMTPBoletoHTML;

NoexemploacimaoboletoserenviadoemformatoHTML,ouseja,nocorpodoemail.

Estainformaopodeseralteradaporoutrasformasdeenvio,verifiquenomanualdoCBX
naseguinteURL:http://www.cobrebem.com/FormaEnvioEmailEnum.html.
NaparteondeseropassadososdadosdoDocumentosCobranca,deveroserincludasasseguintes
linhasdecdigo:

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

14

EmailSacado:=Boleto.EnderecosEmailSacado.Add;
EmailSacado.Nome:='NOMESACADO';
EmailSacado.Endereco:='ENDEREOEMAILSACADO';
Boleto.ControleProcessamentoDocumento.EnviaEmail:=scpExecutar;

9.LayoutsdeBoletos
OCobreBemXpossibilitaapersonalizaodosboletoscomdiversostiposdelayouts,quepodem
sermodificadosconformesuanecessidade.
Oslayoutsquepossuemnonomeapalavra''Personalizado''poderoseralteradosatravsdecdigo
HTML.Existem20tiposdelayoutsnoCobreBemX,segueabaixoalgunsdeles:
Padrao

PadraoEndereadoVerso

PadraoHTML

InvertidoEndereadoVerso

PadraoReciboPersonalizadoHTML

PadraoEndereadoVersoReciboPersonalizado

Invertido

InvertidoEndereadoVersoReciboPersonalizado

CarnetReciboLateralDireita

PadraoVersoPersonalizado

CarnetReciboLateralEsquerda

InvertidoVersoPersonalizado

PadraoReciboPersonalizado

PadraoVersoPersonalizadoReciboPersonalizado

InvertidoReciboPersonalizado

InvertidoVersoPersonalizadoReciboPersonalizado

CarnetReciboLateralDireitaPersonalizado

CarnetReciboTopo

CarnetReciboLateralEsquerdaPersonalizado

CarnetReciboTopoPersonalizado

Olayoutdoboletotemqueserinformadonapropriedade"LayoutBoleto".Osvaloresvlidos
estodisponveisnacoleoLayoutsBoletodaclasseContaCorrente.Senenhumvalorfor
atribudoaestapropriedadeserutilizadoovalor"Padrao".
Ousodapropriedadeficariadaseguinteforma,vejaasintaxe:

CobreBemX.PadroesBoleto.PadroesBoletoImpresso.LayoutBoleto:='CarnetReciboLateralDireita';
OscdigosHTMLdeveroserinformadosnaspropriedades:

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

15

HTMLReciboPersonalizadoparaos layouts que permitem a formataodoRecibo do Sacado;

HTMLVersoPersonalizado para os layouts que permitem formatao do Verso do Boleto;
CasosejanecessriopersonalizaroVersoeoRecibodoSacadodoBoleto,deverserpassadoo
cdigo HTML nas duas propriedades citadas acima, e o layout a ser escolhido poder ser:
PadroVersoPersonalizadoReciboPersonalizado;
InvertidoVersoPersonalizadoReciboPersonalizado

10.GeraoOnLine
Com o auxlio do CobreBemX, sua aplicao poder realizar Boletos On Line no ambiente
Windows.
Emnossositedisponibilizamosexemplosdageraodeboletosonlineemdiversaslinguagens,para
visualizaracesseaURLaseguir:http://www.cobrebem.com/downloads/cbx.html.

11.ArquivoRemessa
umarquivoenviadopeloCedenteparaoBancocontendoascobranasaseremprocessadas,seja
elaimpressaporeleoupeloBanco.ComestearquivooBancotercinciadacobrana,seuvencimento,
valoretc.Antesmesmodelaserprocessada,sendopossvelexecutartodasasaesacordadaspreviamente
com

Cedente.

CadaBancoeCarteirapossuilayoutsespecficos.ConversecomoseuGerenteoucomaarade
cobranaparaseinformarsobrequaloseulayouthabilitadoparasuacobranajuntoaobanco.

Lembramosqueoprocessamentodecobranaatravsdearquivoremessanormalmenteutilizado
porcarteirasdotipo"registrada",salvo,seoprprioBancoforimprimirasuacobrana.
TodasaspropriedadesqueserocitadasabaixoestolocalizadasnoObjetoIArquivoRemessa.Para
acriaodearquivosderemessa,noCobreBemX,bastautilizarasseguintespropriedades:
Propriedade"Arquivo"(Tipo:String)
Utilizada para especificar o nome do arquivo de remessa a ser gravado, caso no seja
informado,elesercriadocomopradroespecificadoparaaquelebanco.
Propriedade"DataGravacao"(Tipo:String)
Utilizadaparaespecificaradatadegravaodoarquivoderemessa,casono
sejainformadoserusadoadatadamquina.
http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

16

Propriedade"Diretorio"(Tipo:String)
Utilizadaparaespecificarodiretrioondesergravadooarquivoderemessa,casono
sejainformadasergravadonomesmodiretrioondeseencontraoarquivodelicena.Obrigatrio
informarquandoutilizarArquivoLicencaTexto.
Propriedade"Layout"(Tipo:String)
Utilizadaparainformarolayoutdoarquivoderemessaaserusado,ospadresmaiscomuns
soFEBRABAN240eCNAB400.Oslayoutsdisponiveisdependerodobancoecarteiraqueest
sendo usado, utilize a coleo ILayoutsArquivoRemessa para listar os layouts disponiveis.
Importante:Sevocinformarumlayoutquenoexista,oarquivoderemessairsercriadoem
branco.
Propriedade"Sequencia"(Tipo:Integer)
Utilizadaparainformarasequnciadosarquivosderemessagerados,casonoseja
informadosergravadosemprecomovalorpadro1.
Propriedade"TipoImpressao"(Tipo:String)
Utilizadaparainformarotipodeimpressoqueserusadopelobancoapartirdosdados
contidosnaremessa.Estapropriedadesserusadacasosejaobancoquemvaiemitirosboletos.
Apspassartodasaspropriedadesnecessriasparaacriaodoarquivoderemessa,bastavoc
adicionar os dados na coleo DocumentosCobranca (utilizando as propriedades). E, no final, passe o
mtodo

"GravaArquivoRemessa".

12.ArquivoRetorno
Arquivo enviado pelo Banco ao Cedente para informar as liquidaes ocorridas, confirmar o
recebimentodosttulosedasinstruescomandadaspelocorrentista.
OlayoutdoArquivoRetornoobedeceapadronizaomedianteaolayouthabilitadojuntoaoseu
BancoedeacordocomsuaCarteiradeCobrana.

TodoBancodisponibilizaparaoCedenteoArquivoRetornoparaqueomesmopossagerenciarsua
cobrana,independenteseotipodacobranaforregistradaousemregistro.
TodasaspropriedadesqueserocitadasabaixoestolocalizadasnoObjetoIArquivoRetorno.Para
carregar arquivos de retorno, no CobreBemX, basta utilizar as seguinte propriedades abaixo:
Propriedade"Arquivo"(Tipo:String)
Utilizadaparaespecificaronomedoarquivoasercarregadocasonosejainformadoo
mesmoprocurapeloarquivopadrocomnomeRETORNO.TXT.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

17

Propriedade"DataGravacao"(Tipo:String)
Propriedadereadonlyquecarregaapartirdoarquivoderetornoqueexibeadatade
gravaodoarquivo.
Propriedade"Diretorio"(Tipo:String)
Utilizadaparaespecificarocaminhofsicodeondesercarregadooarquivoderetornocaso
nosejainformadoodiretriopadroseromesmoondeestoarquivodelicena.Obrigatrioser
informadocasoestejautilizandoArquivoLicencaTexto.
Propriedade"Layout"(Tipo:String)
Utilizadaparainformar olayout doarquivode retornoa ser carregado, os padres mais
comunssoFEBRABAN240eCNAB400.Oslayoutsdisponiveisdependerodobancoecarteiraque
estsendousado,utilizeacoleoILayoutsArquivoRetornoparalistaroslayoutsdisponiveis.
Importante:Sevocinformarumlayoutquenoexistaouinformarolayouterrado,oresultado
docarregamentodoarquivoderetornoserembranco.
Propriedade"Sequencia"(Tipo:Integer)
Propriedadereadonlyqueindicaasequenciadoarquivoderetorno.
Apspassartodasaspropriedadesnecessriasparaocarregamentodoarquivoderetorno,
bastautilizaromtodo"CarregaArquivosRetorno",queserveparacarregaroarquivoretorno
dobanco,populandoacoleoOcorrenciaCobranca.
Emseguida,bastaleraspropriedadesdacoleoOcorrenciaCobranca.
Exemplodecargadearquivoderetorno:BancodoBrasil(001)carteira18.
var
Boleto:Variant;
CobreBemX:Variant;
i,j:integer;
begin
CobreBemX:=CreateOleObject('CobreBemX.ContaCorrente');
CobreBemX.ArquivoLicenca:='C:\00118.conf';
CobreBemX.CodigoAgencia:='12345';
CobreBemX.NumeroContaCorrente:='123456789';
CobreBemX.CodigoCedente:='123456';
CobreBemX.OutroDadoConfiguracao1:='019';
CobreBemX.InicioNossoNumero:='00001';
CobreBemX.FimNossoNumero:='99999';
CobreBemX.ProximoNossoNumero:='15';
http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

18

CobreBemX.ArquivoRetorno.Diretorio:='C:\';
CobreBemX.ArquivoRetorno.Arquivo:='RetornoBB.txt';
CobreBemX.ArquivoRetorno.Layout:='FEBRABAN240';
CobreBemX.CarregaArquivosRetorno;
fori:=0toCobreBemX.OcorrenciasCobranca.Count1do
begin
ListBox1.Items.Add('NossoNumero='+CobreBemX.OcorrenciasCobranca[i].NossoNumero);

ListBox1.Items.Add('CodigoOcorrencia=' +
CobreBemX.OcorrenciasCobranca[i].CodigoOcorrencia);

ListBox1.Items.Add('DataOcorrencia=' +
CobreBemX.OcorrenciasCobranca[i].DataOcorrencia);

ListBox1.Items.Add('Pagamento='
FloatToStr(CobreBemX.OcorrenciasCobranca[i].Pagamento));

ListBox1.Items.Add('DataCredito='+CobreBemX.OcorrenciasCobranca[i].DataCredito);

ListBox1.Items.Add('ValorPago='
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorPago));

ListBox1.Items.Add('ValorMultaPaga=' +
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorMultaPaga));

ListBox1.Items.Add('ValorJurosPago=' +
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorJurosPago));

ListBox1.Items.Add('ValorTaxaCobranca=' +
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorTaxaCobranca));

ListBox1.Items.Add('ValorCredito='
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorCredito));

ListBox1.Items.Add('NumeroDocumento=' +
CobreBemX.OcorrenciasCobranca[i].NumeroDocumento);

ListBox1.Items.Add('ValorDesconto='
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorDesconto));

ListBox1.Items.Add('ContaCorrente='
CobreBemX.OcorrenciasCobranca[i].ContaCorrente);

ListBox1.Items.Add('CodigoCedente='
CobreBemX.OcorrenciasCobranca[i].CodigoCedente);

ListBox1.Items.Add('Banco='+CobreBemX.OcorrenciasCobranca[i].Banco);
ListBox1.Items.Add('Carteira='+CobreBemX.OcorrenciasCobranca[i].Carteira);
ListBox1.Items.Add('Agencia='+CobreBemX.OcorrenciasCobranca[i].Agencia);

ListBox1.Items.Add('NumeroControle=' +
CobreBemX.OcorrenciasCobranca[i].NumeroControle);

ListBox1.Items.Add('ValorOutrosAcrescimos=' +
FloatToStr(CobreBemX.OcorrenciasCobranca[i].ValorOutrosAcrescimos));
forj:=0toCobreBemX.OcorrenciasCobranca[i].MotivosOcorrencia.Count1do
ListBox1.Items.Add('Motivo('+IntToStr(i)+')='+
CobreBemX.OcorrenciasCobranca[i].MotivosOcorrencia[j].Codigo+''+
http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

19

CobreBemX.OcorrenciasCobranca[i].MotivosOcorrencia[j].Descricao);
ListBox1.Items.Add('');
end;

13.DocumentaoTcnica
ADocumentaoTcnicadoCobreBemXestcompostaportodososObjetos,Propriedades
eMtodosexistentesnocomponente,incluindosuasrespectivasdefinies.
ParaqueaDocumentaoTcnicadoCobreBemXsejacompreendidamaisfacilmenteinteressante
visualizaraHierarquiadeObjetos(anexoI).
A Hierarquia de Objetos, funciona, como uma rvore, onde ser possvel visualizar de maneira
rpidaefcilaspropriedadeseobjetosexistentesnoCobreBemX.
Para maiores detalhes, utilize os exemplos prticos disponibilizados no site da Cobre Bem
Tecnologia,apartirdaURLhttp://www.cobrebem.com/downloads/cbx.html

.
A documentao do CobreBemX pode ser visualizada atravs do arquivo
''Documentacao\CobreBemX.htm'', este salvo automaticamente em seu computador ao ser realizado o
downloddocomponente.Nestearquivocontmalistadosobjetossuportados,seguidosdesuaspropriedades
emtodos.
VoctambmpoderacessaraDocumentaoTcnicadoCobreBemXtravsdaURLinformadaa
seguir:http://www.cobrebem.com/IContaCorrente.htm

l.

14.InformaoaoDesenvolvedor
DisponibilizamosnositedaCobreBemTecnologia,umManualdeNoesBsicasdeCobrana.
Neste,hinformaes/orientaespertinentecobrana.
Sugerimosquevoc,desenvolvedorasleiaatentamenteeprincipalmenteaconselhamosqueseja
orientadoaseucliente,futuroCedente,sobrealeituradoitem''OrientaoparaoCedente''existenteno
referidoManual.
AcesseomesmoatravsdaURL:http://www.cobrebem.com/nocoesdecobranca.html.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

20

15.Desinstalao
OCobreBemXumcomponente,logorequerinstalaoedesinstalao.
EleutilizaumaDLLeoarquivodeconfigurao(.conf)criadoficaarmazenadonomesmo
diretrioondeestinstaladoaDLLdoCobreBemX.
PararetiraroCobreBemXdoseucomputador,bastaremovlodeseucomputador,atravsda
execuodoarquivo''Desinstalar.exe''.

16.DvidasFrequentes
Na opo Dvidas Frequentes http://

www.cobrebem.com/faq/cbx.html

separamos algumas
dvidasqueusualmenteatendemosnonossosetordesuporte.
Emcasodedvidas,porgentileza,entreemcontatocomnossaequipedesuporteatravsdoemail
suporte@cobrebem.com.
ParamaioresinformaessobreCobrana,sugerimosaleituradoManualdeNoesBsicasde
Cobrana,disponibilizadoaparirdaURL:http://www.cobrebem.com/nocoesdecobranca.html.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

21

AnexoI
Apsvisualizaraimagemabaixo,vocacessaraDocumentaodoCobreBemXcommaisfacilidade
deinterpretao.

http://www.cobrebem.comManualTcnicoSoluoCobreBemXVerso1.0.13.10.18

22