Cobre Bem Tecnologia

Cobre Bem Tecnologia

INSTITUTIONAL

Specialized in standardized payment method solutions for 16 years, Cobre Bem Tecnologia is the leader in the Brazilian billing market.

Internationally the company stands out because of its differentials.

More...

CONTACT US


COMMERCIAL:

comercial@cobrebem.com

Skype ID: cobrebemcomercial

São Paulo: +55 (11) 5041 2228

Rio de Janeiro: +55 (21) 2288 5990

Buenos Aires: +54 (11) 6841 9067

Dallas: +1 (469) 298-8901

Santiago: +56 (2) 570-8663

Mexico City: +52 (55) 2789-0325

Bogota: +57 (1) 381-9016


TECHNICAL SUPPORT:

suporte@cobrebem.com

Skype ID: cobrebemsuporte

Rio de Janeiro: +55 (21) 2288 5990


Click here for more information...

BETTER, EASIER AND SECURE, ALWAYS.
CobreBemX » Technical Manual

About

The CobreBemX is one component COM “not visual” distributed in the format of DLL that has the following features:

  • Printing of Boleto Bancário at Laser or Bubble – jet printer for several banks;
  • Boleto submission by e-mail;
  • Generation of Delivery File CNAB standard and Febraban 3.0 standard;
  • Reading of Return File CNAB standard and standard Febraban 3.0;
  • The Setup Wizard of current accounts;
  • Generation of Boletos Bancários On Line in Windows Enviroment;
  • Generation of Delivery File for debit at Current Account;
  • Reading of Return File to Debit at Current Account;
  • Approval of Credit Cards through the service Aprova Fácil.


Installation

The component CobreBemX, maybe installed in your local machine (Off Line mode) and / or at servers (On Line mode), see below the specifications:

Off Line Installation:

To install CobreBemX in you computer, follow the proceeds below:

  • Unpack the installation file at a directory that you wish;
  • Run the file “instalar.exe” to register the DLL in your Windows.

To install CobreBemX at you client´s computer, together with the software developed in separate, follow the procedures below:

  • Copy the file CobreBemX.dll to any directory of your client´s computer. Should be the same directory where the software is installed;;
  • Register the DLL in the Windows using, for example, the file “instalar.exe” which is inside the InstalShield, just include the file “CobreBemX.dll” in your application and request that the file is registred in the Windows by the installer.
  • Add in, also, the the image files that the client will need to use use the functions of Boleto Submission by E-mail, HTML Generation and Boleto Printing.

On Line Installation:

In the installations done at servers, the component CobreBemX to work needs to have the permission of application for the anonymous user of IIS.

Is good to remember that, the DLL should be register by your Host. Don´t forget to install also the license file(.conf) and the own script that will be used.

CobreBemX at the Windows Server 2003 and Windows Server 2008:

We realize that the DLL of CobreBemX may not function properly at the Windows Server2003 and Windows Server 2008, with applications written in ASP and / or C# executed through IIS. If it happens, the ISS returns as a blank page doing the normal end log without display any error message.

Click here to see the steps to install the CobreBemX in the Windows Server2003.

Click here to see the steps to install the CobreBemX in the Windows Server2008.


Go back to the index




Examples for Using of the Component

The CobreBemX maybe used with any kind of Database. The examples that come together with the component use the Database sort Paradox(Delphi) and sort Microsoft Access (Visual Basic), but you may use the Database that you wish to save your data.

In the directory “ Exemplos” which is contained in the installation, there are the program sources that show the features utilization of CobreBem X in the following languages:

  • Access 2000;
  • HTML + JavaScript;
  • Access 97;
  • HTML + VBScript;
  • AcucoBol;
  • Java;
  • ASP Aprovação Cartão Crédito;
  • NetExpress;
  • ASP Boleto On-Line;
  • PHP;
  • ASP Envio Boleto E-Mail;
  • PowerBuilder;
  • ASP Geração Arquivo Remessa;
  • Power Cobol;
  • ASP Impressão Boletos;
  • Progress;
  • ASP Leitura Arquivo Retorno;
  • SAP - Abap 4;
  • Clarion;
  • VisualBasic 5 com Banco de Dados;
  • Delphi com Banco de Dados;
  • VisualBasic com Banco de Dados;
  • Delphi Layouts Personalizados;
  • VisualBasic Layouts Personalizados;
  • Delphi sem Banco de Dados;
  • VisualBasic sem Banco de Dados;
  • Excel;
  • Visual DataFlex;
  • Five Win;
  • Visual FoxPro;
  • Visual FoxPro Geração Arquivo Remessa.

In the component CobreBemX who wish to use Delphi.net, may do the tests with the examples in C# (C Sharp), available in the web site.


Go back to the index




Testing

In the directory “ Exemplos/Licenças”, there is only the file “ Arquivo de Licença para Teste”, this one is used to make any kind of tests that you think is necessary, having available all the features that the component offers.

Follow the proceedure below to test CobreBemX:

  • Install CobreBemX DLL from Downloads CobreBemX;
  • Access the page Licenças de Teste para Todos os Bancos e Carteiras to select the bank and portfolio that you wish to use. After your selection click the Generate Archive button;
  • Integrate the component to your solution using as reference the examples available in our site in accordance to the programing language that best suits you.

In testing mode CobreBemX is restricted in two ways, as follows:

  • Date of Expiry - When a boleto bancário is sent via email or printed, notwithstanding the expiry date chosen at the moment of its creation, a fixed unchangeable date will be exhibited on the document
  • Value - The same above applies to the field labelled "valor" (value), where a fixed amount of R$1.90 will be shown.

Video:
License Test

Observation: In case the .conf archive is generated as test.conf.txt select the archive and rename it erasing the extension txt so that it now reads teste.conf.


Go back to the index




Licenses Keys – Definitely

When you acquire the CobreBemX will be conducted the keys to generate the licenses files for the banks and portfolio of the Merchant.

The license file is generated for each Merchant / Bank/ Portfolio and therefore doesn´t works for any bank/ portfolio, only for the one generated before.

A definitely license key allows the generation for the same Merchant, identificated by CPF if an individual or CNPJ if corporate entity, of as many license files as would be necessary for several Banks / Portfolio.

The license files maybe generated through of the URL : http://licenca.cobrebemx.com.br

When you fulfil the necessary informations and requests to generate the license file, automatically, will be started the download of the file, except for the brownser IE 5.5, that will be necessary to show the font code and save handly the file generated.

Video:
Definitive License

Observation: In case the .conf archive is generated as test.conf.txt select the archive and rename it erasing the extension txt so that it now reads teste.conf.


Go back to the index




Current Account Configuration

When you integrate the CobreBemX to your solution, will be necessary to configure the current account that will be used.

The datas of the current account should be always present, because without them won´t be possible to do any other command of the component.

To configure your current account you should always know exactly which informations that determinate bank and portfolio request and the format that this informations should be passed.

There are three ways to verify which are this datas, see:

  • In the menu “ Downloads” of this website from this link: Licenças para Desenvolvimento (Teste) aos bancos e carteiras disponíveis;
  • Using the method “ ConfiguraContaCorrente”, because this shows a screen of data request already considered the bank and the portfolio informed by the license file;
  • Building a personalized screen to the account configuration, using the properties which names are started at “Mascara”, “ Cabecalho” and ”Ajuda”. We put available in the download area, one example in Delphi of how to do it. To execute the download click here.

We present below through the movies, some of the data used to do the configuration of a current account..

Videos:
Part 1
Part 2
Part 3
Part 4
Part 5


Go back to the index




Collection Definition

After configurates you current account at the component, it makes necessary to define the collection, it means that, you need to create your Boleto Bancário.

See through the movies below how to define your collection:

Vídeos:
Part 1
Part 2
Part 3
Part 4
Part 5


Go back to the index




Debit at Current Account

To use this payment way, will be necessary:

  • Have the permission at the bank a portfolio of collection that allows the Debit at Current Account;
  • The Buyer should have an account at the same Bank that the Merchant.

The Debit at Current Account in the CobreBemX is a “normal” delivery file , it means that, is utilizated for Boleto sending. However, to use the debit, will be necessary to add two properties of the object DocumentosCobrança, they are:

  • AgenciaDebito - Report the buyer agency (without dots and traces);
  • ContaCorrenteDebito - Report the buyer current account (without dots and traces).

To CobreBemX generate the file at the layout of the debit at current account, should be passed the worth DebitoCC to the property CobreBemX.ArquivoRemessa.Layout.

Some banks doesn’t use this layout. To verify the layout supported by your bank access Características Bancos e Carteiras.


Go back to the index




Boleto Submission by E-mail

The component CobreBemX send several boletos to their clients in HTML format or like attached file using only a connection with their SMTP server.

To make the boleto sending by e-mail is necessary to pass the properties that refers to the license file, current account, agency, etc, as is shown below:

CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Servidor := 'Your Server'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Porta := Door number; CobreBemX.PadroesBoleto.PadroesBoletoEmail.URLImagensCodigoBarras := 'URL Bar Code'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.URLLogotipo := 'URL Image Logotype'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.Assunto := 'Email Subject'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.EmailFrom.Endereco := 'Merchant Email Address'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.EmailFrom.Nome := 'Merchant Name';

To servers that belongs to the kind safe, fulfil the properties:

CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Usuario := 'Username'; CobreBemX.PadroesBoleto.PadroesBoletoEmail.SMTP.Senha := 'Password';

To inform the way how your boleto will be sent, use the property:

CobreBemX.PadroesBoleto.PadroesBoletoEmail.PadroesEmail.FormaEnvio := feeSMTPBoletoHTML;

In the example above the boleto will be sent in HTML format, as the e-mail text.

This information could be changed by other sorts of sending, verify at the CobreBemX documentation the Formas de Envio that exists.

In the part where will be passed the datas of the collection document, should be included the following code lines:

EmailSacado := Boleto.EnderecosEmailSacado.Add; EmailSacado.Nome := 'Buyer Name'; EmailSacado.Endereco := 'Buyer Email Address'; Boleto.ControleProcessamentoDocumento.EnviaEmail := scpExecutar;

In the place of CobreBemX.imprimeboletos or CobreBemX.GravaArquivoRemessa, put CobreBemX.EnviaBoletosPorEmail.

Observation: Consider that the boleto is a variable of the sort Variant that recieves the worth CobreBemX.DocumentosCobranca.Add


Go back to the index




Boleto Layouts

The CobreBemX allows the personalization of the boletos with several kinds of layouts, that maybe changed by you (developer), as long as you have the necessity.

The layouts that have in their names the word “ Personalizado” could be changed through the HTML code. With this layouts, you could personalize the Buyer Reciept and / or Boleto Back.

To inform to CobreBemX that you will use a different layout of the kind Padrão, pass to the property LayoutBoleto one of the values mentioned below.

There are 22 kinds of layouts at the CobreBemX, they are:

  • Padrao
  • PadraoEnderecadoVerso
  • PadraoHTML
  • InvertidoEnderecadoVerso
  • PadraoReciboPersonalizadoHTML
  • PadraoEnderecadoVersoReciboPersonalizado
  • Invertido
  • InvertidoEnderecadoVersoReciboPersonalizado
  • CarnetReciboLateralDireita
  • PadraoVersoPersonalizado
  • CarnetReciboLateralEsquerda
  • InvertidoVersoPersonalizado
  • PadraoReciboPersonalizado
  • PadraoVersoPersonalizadoReciboPersonalizado
  • InvertidoReciboPersonalizado
  • InvertidoVersoPersonalizadoReciboPersonalizado
  • CarnetReciboLateralDireitaPersonalizado
  • CarnetReciboTopo
  • CarnetReciboLateralEsquerdaPersonalizado
  • CarnetReciboTopoPersonalizado
  • ReciboLateralEsquerda
  • ReciboLateralEsquerdaPersonalizado

See above the description of the layouts that maybe used at the CobreBemX:

  • Padrao - one boleto por page, buyer reciept in the top part of the boleto;
  • Invertido - one boleto by page, buyer reciept in the low part of the boleto; Model indicated to print at the printer 600HP series
  • CarnetReciboTopo - two boletos by page, reciept in the top of the boleto;
  • CarnetReciboLateralDireita - three boletos by page, buyer reciept, in the right side of the boleto;
  • CarnetReciboLateralEsquerda - three boletos by page, buyer reciept in the left side of the boleto.
  • EnderecadoVerso - One boleto by page with the sending data as mail for the post office, in boleto back.

If you choose to use one of the layouts that allows the personalization, you should inform the HTML code creating at the following properties:

  • HTMLReciboPersonalizado for the layouts that allows the buyer reciept configuration;
  • HTMLVersoPersonalizado for the layouts that allows the Boleto Back configuration;

In case of necessity to personalize the back and the buyer reciept, should be passed the HTML code in the two properties mentioned above, and the layout to be choosen could be “PadraoVersoPersonalizadoReciboPersonalizado” or “InvertidoVersoPersonalizadoReciboPersonalizado”.

The boletos could be customized as much in the On Line generation as in the Off Line, however to use a layout of the kind personalized in the online genaration, the layout name should be informed with the word “Impressao” in the end, see:

Example: CobreBemX.PadroesBoleto.PadroesBoletoEmail.LayoutBoletoEmail := 'CarnetReciboLateralEsquerdaImpressao';

Could be used anyone of the layouts mentioned above, since they have the word” Impressao” in the end.

We put available some HTML codes for examplificate, that are used in the generating of the standart reciept. Do the download of these, byclicking here. See next the layouts examples mentioned before:

Observation: In case of the layout is informed without the word Impressao, when is requested the boleto generation, the page will be displayed in blank.

Vídeo:
Layout Padrão
Layout Padrão Endereço no Verso
Layout Invertido Endereço no Verso
Layout Invertido
Layout Carnet Recibo Lateral Esquerda
Layout Carnet Recibo Lateral Direita
Layout Carnet Recibo Topo


Go back to the index




Online Generation

With the CobreBemX help, your application could do the collection through the internet in Windows Enviroment, in the collection ways: Boleto Bancário ad Credit Card (available when is used together with Aprova Fácil).

In our website we have put available examples of the online generation in several languages, to see, access Downloads CobreBemX.


Go back to the index




Delivery File

It is a file sent by the client to the bank that contains the collection to be processed, even if it's printed by the Merchant or by the Bank.

With this file, the bank will be warned of the collection to be sent to your client, before the collection could be processed, making possible to execute all the actions that were agreed before with the merchant.

Each bank and portfolio allowed together with the same merchant, has their layout defined.

Contact your manager or the Collecting Area in order to inform about which is the layout allowed in your bank.

We remember that the collecting processing, through the delivery file, ussually is used by portfolio of the kind “registrada”, unless the own bank would print your collecting.

Below, you could see a movie that shows how it takes to generate a delivery file.

Vídeo:
Arquivo de Remessa


Go back to the index




Return File

The file sent by the bank to the merchant to inform the settlements done, to confirm the draft reciept and the orders commaded by the current account owner.

The layout of the return file follow the standart of the layout allowed by your bank, according to your portfolio of collecting.

All bank puts available to the merchant the return file for that the merchant may manage collecting, independent of the collecting kind, it means that it could be registrated or without register.

Below, you may visualize a sequency of movies that demonstrate how to accomplish to do the charge of the return file.

Video:
Part 1
Part 2
Part 3
Part 4
Part 5

Observe through the movie the result of the reading of the return file, whose font code is in the movies above:

Vídeo:
Result


Go back to the index




Technical Documentation

The technical documentation of CobreBemX is formed by: Objects, Properties and Methods that exists in the component, including their respective definitions.

For that the Technical Documentation could be easyly understood is interesting to see the Hierarquia de Objetos.

The Hierarquia dos Objetos works as a “tree” where can be possible to see faster and easier the properties and objects that are contained at CobreBemX.

To more details, use the practical examples availables in Cobre Bem Tecnologia website, through the Downloads CobreBemX.

Observation: The CobreBemX documentation can be seen through the file “Documentação\CobreBemX.htm”, this is save automatically in your computer as the download of the component happens.

CobreBemX Technical documentation is available in another way. Through this item of the Tecnichal Manual, maybe accessed from: Documentação Técnica CobreBemX.


Go back to the index




Information to the Developer

We suggest the reading of the Billing Manual, and we advice that the client, future merchant, read the item “Orientação ao Cedente”, that is written in that manual.

The Billing Manual is available also in PDF in the support area of Cobre Bem Tecnologia website.


Go back to the index




Uninstallation

The CobreBemX is a component, so requests installation and uninstallation.

It uses a DLL and the configuration file (.conf) created stays save at the same directory where is installed the DLL of CobreBemX.

To withdraw the CobreBemX of your computer, just remove it of you computer, through of the execution of the file “Desinstalar.exe”.


Go back to the index




FAQ

There is in our website a place of FAQ (in Portuguese), that might help you answering your questions, to access Click here.

There is also few lines talking about collecting, to get more information see the Billing Manual available in our website.


Go back to the index




Follow us on Twitter
© 2011 Cobre Bem Tecnologia - Payment Gateway | All Rights reserved.