• No results found

Solutions in E-Commerce

N/A
N/A
Protected

Academic year: 2021

Share "Solutions in E-Commerce"

Copied!
17
0
0

Loading.... (view fulltext now)

Full text

(1)

Solutions in E-Commerce

Technical Guidelines

for the Contracting Company

(2)

Summary

I. Presentation

Offered Advantages... 3

Requirements... 3

II. Payment Methods Debit Account via Internet... 4

BB Internet Credit... 4

Transaction slip... 4

III. Characteristics How it works... 5

Magnetic information exchange... 5

IV. Implantation Guide Agreement formalization... 6

Code development... 6

Simulations and approvals of the implementation... 6

Activation of the agreement... 6

V. Attachments 1. Flux of Payments... 7

2. Formalization... 8

Variables by using the forms... 8

a) Payment form Payment... 9

b) Return form ... 10

c) Sonda form... 10

Response of the Sonda form... 11

XML Structure... 11

“lojavirtual.dtd” Structure... 11

Response in a String form... 11

e) Sales Cancelation form... 14

3. Layout of the return file – debit account... 15

(3)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 3

I. Introduction

This manual provides the necessary information for the correct integration of the virtual store with Banco do Brasil´s payment environment and gives some basic clarifying information about BB electronic commerce and how it is operated. It considers variables to allow the management of the points in the Relationship Program of Banco do Brasil with partners.

The Electronic Commerce Solutions perform financial intermediation amongst companies and consumers (B2C) and amongst companies and companies (B2B), by offering a number payment options enabling the company to choose the most appropriate to their necessities.

This is a secure and complete service, which allows the follow-up of transactions in real time within the Account Debit via Internet and BB Internet Credit, in the back-office of the company, using the Financial Manager or their own management system.

Offered Advantages

Simplicity in the implementation;

All financial clearing on behalf of Banco do Brasil; Banco do Brasil´s reliability and security;

Lower fees and rates within the market;

The greatest Internet client base in Latin America. Requirements

Must be a client of Banco do Brasil; Have an updated register;

Join BB E-commerce regulation and formalize the agreements for the type of payment method chosen;

(4)

II. Payment Methods

Debit Account via Internet

This is a Cash payment method by charging the debit through the buyer’s current account (Natural Person – B2C or Legal Person – B2B) and credit to the company’s current account.

The corresponding credit of the purchase/service will be through the company’s account in D+N, according to the float previously negotiated with the relationship agency, grouped in a single launch.

The company will receive a RCB001 file with a demonstration of all payments, including the payments via BB Internet Credit, in case this option is used by buyers, as well as starting a check up transaction on the BB site to verify the payment status of the purchase or the service order.

BB Internet Credit

This is a term method payment, by granting financing for the buyer (Natural Person) and up front credit for the company’s current account.

The corresponding credit for the purchase or service will be effectuated in the company’s account in D+N, according to the float previously negotiated with the relationship agency, grouped with the payments made via Internet Debit Account, in a single launch.

The company will receive a RCB001 file with the demonstrations of payments, including the payments via Internet Account Debit, as well as, how to begin a check up transaction on the BB site, to verify the status of the purchase or service order.

In case the buyer wishes to cancel the purchase which has been already paid by this method, the company must fill out the specific form and forward it to the agency which holds the E-commerce agreement.

This form is available in item V. Attachments - 2.e.

Important: to contract the BB Internet Credit payment method, the company must also contract the Debit account method via Internet.

Bank Transaction Slip - Collection without registration

This form of payment generates a bank selling note printed by the buyer (Collection without registration). The corresponding credit for the purchase/service will be effectuated to the company’s account in D+N, according to the float previously negotiated with the agency’s relationship section, when the transaction slip has been settled. The company will receive a CBR643 or CNAB240 file with the demonstration of all payments.

(5)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 5

III. Characteristics

How it works

Starting from the site’s store, the computer (Natural Person or Legal Person) chooses the type of payment. At this instance the allowable payment methods are presented for the agreement contracted with the Bank (in case there is only one payment method contracted with the Bank, only this one will be presented).

When the Bank’s site shows up, a passage of parameters occur which identify the source and which forms of payment must be offered for the transaction which are being executed. The validation of the agreement is performed in the Bank’s environment.

The entire process of client’s authentication is involved in the transaction and verification of available funds (for payment methods that require such validation) as well as the processing of financial operations are conducted in a safe environment, ensuring data integrity throughout the flow of the transaction. The update of the database occurs in real time, allowing on-line status check up of the payment (check up only available for payments via Internet Debit Account or BB Internet Credit).

The Bank offers all the information related to the financial transactions performed in the clients company through the Financial Management or the clients own management system.

On-line Information Exchange

The data bank update, relating to the effective payments, is processed in real time, allowing on-line payment status check up for the Debit account method via internet and BB Internet Credit (recovery of the transaction slip only through file, the following day). See information concerning the Sonda forms, Return and Informa, starting from page 9.

Magnetic Information Exchange

In addition to the on-line information, the Bank provides daily information of all payments executed through various methods, especially through the Financial Manager, enabling to check all payments made the previous day through the generation of file-return.

Therefore when the agreement has been formalized, the company must choose one of the files exchange methods offered by the Bank. The files are:

• Debit Account via Internet and BB Internet Credit: file RCB001;

(6)

IV. Implantation Guide

Formalization of agreements

The following must be formalized in the company’s relationship agency:

− Agreement of Collection, to allow payment via internet Debit Account;

− Agreement of Collection and the agreement of BB Internet Credit, to allow the payment via BB

Internet Credit;

− Selling Note Agreement to allow the payment through a transaction slip;

− E-commerce agreement to allow the electronic exchange of parameters/information of the

forms.

The following attributes should be informed to the Bank:

− The client’s Site (URL) for Return and for Information (see detailed information of the variables

urlRetorno and urlInforma, starting from page 9);

− E-mail of the person in charge of the development/maintenance of the solution;

− Buying value limit: maximum value allowed for each transaction.

Important: Ask your manager for the Client’s Initial Guideline document, which has the complementary orientations regarding the agreement and its use in the solution (numbers of the e-commerce agreements and selling note).

The E-commerce agreement will have a status “9 – Not Active”. This situation allows the company to accomplish the development and the approval of the solution on their site.

Development of the code

The company must develop on the site’s environment, a code of the Payment Form structure to capture the variables related to the payment. The code structure of the forms must also be implemented on the site’s administration environment, which will allow on-line check up of the payment situation:

- Return (URL Retorno); - Inform (URL Informa); - Sonda.

The company responsible for the implementation must meet the following technical requirement:

− The Bank’s link should only be activated after the buyer has executed all the necessary steps

for the purchase (checkout), remaining only for the payment to be made;

The page which receives the posting of the form can not be opened in frame.

Example: the page can not have the tag html <frameset>.

Verify the implementation details in the attachments of this document, starting form page 9. Simulations and approval of the implementation

The company´s technical team should perform payment simulations, in a way to guarantee the perfect functioning of the solution. The approval is performed in the production environment.

While the situation for the agreement is “9 – Not Active” the payments performed by the option Debit through Internet Account will not affect the accounts involved. The Bank´s system will allow the part processing of the flux, indicating that this operation is a simulation, without any accounting effect. In this situation the word “Test” will be shown next to the name of the company.

Activation of the agreement

After the completion of the approval phase, the company should notify their relationship agency that they are able to execute E-commerce Solutions on their site.

(7)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 7

With this information the agreement will be activated. Please note that only after the agency confirms that the agreement has been activated the company may execute the Electronic Commerce Solutions on their site. After the activation of the agreement the word “Test” will no longer be shown. Important: a variable refTran should be sequential, it does not allow to reutilizing numbers used in the tests.

(8)

V. Attachments

1. FLUX OF PAYMENTS

1. The computer (Natural Person and/or Legal Person), after completing all the purchase phases, will request a checkout of the order on the contracting party’s site;

2. The purchase order is calculated and registered and the attributions of the purchase order are presented to the consumer on the contracting party’s site;

3. Variables of the “payment” form are put together on the contracting party’s site; Obs: Verify item “Forms – Payment”, for more details.

4. The purchase order is presented by the buyer for confirmation;

5. The buyer confirms the order and the seller’s site submits a Payment form on BB site;

6. The “Payment” form and the agreement are validated on the BB site and is checked whether the requested value is less or the same as the value prearranged on the agreement;

7. The agreement’s attributes are recovered by the Bank’s site (invented name of the agreement, urlRetorno of the contracting party’s site, urlretorno, urlInforma the contracting party’s site and the types of agreements which the company has with the Bank);

8. The BB site presents a page with the payment details. In case the type of payment has been chosen in item “5”, the screen will show only the type of payment selected. On the contrary, there will be banners shown with the options for the transaction slip, Account Debit via Internet(natural person and legal person) and BB Internet Credit (according to the payment methods agreed by the company);

9. As an example, the computer selects payment by Account Debit in an account via Internet – Natural Person;

10. The buyer informs his data, account and internet password to the agency and is authenticated by the Bank;

11. The buyer informs the final password to confirm the payment;

12. The BB site presents and a page informing electronic authentication of the payment (the client must print this page, which is their proof of payment). At this instance, the informa form is activated (more information on page 10), even when problems with payment occur (system error, lack of funds, lack of credit limit, etc). In case the computer is clicked on the Return to Store button, available on this page, the Return form will be activated (more information on page 10), which directs the client once again to the contracting party’s site;

OBS: The Informa form is available only for purchases performed by a Natural Person.

13. The server, the site or the application of the contracting party may add the Sonda form (more information on page 10), in case it is necessary to know the immediate situation of each payment, at the same moment when it receives the posted data by the informa form or Return (mentioned above), or at the moment after the finalization of the transaction. This form can only be used for payments via Internet Debit Account or BB Internet Credit and exchange of points through the Bank´s relationship Program.

14. The BB site returns the answer to the Sonda form;

15. BB makes available file(s) return(s) the following day after the liquidation of its commitments, according to the methods of payment, related to the payments made;

(9)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 9

2. FORMS

Variables used in the forms

For the operation of the E-commerce Solutions, variables are used which are shown below and should be used as indicated in each type of form.

Variables Size Type Description

Zip Code 8 Num Buyers Zip Code, without the hiphen which will be shown on the selling note

City 18 Alfa Buyers city, which will be shown on the selling note

Date of Payment 8 Num Date of payment accounting launch, in DDMMAAAA format

dtVenc 8 Num Due date of payment, in DDMMAAAA format.

OBS: future date is accepted only after the emission of the transaction slip.

Address 60 Alfa Buyers address, which will be shown on the transaction note selling note

format 2 Num

The format of the return forms for consultation submitted to the bank: 01 – HTML (Visual return in page of the Bank for manual control) 02 – XML (Return in tag XML)

03 – String (Return in String form)

idConv 6 Num Code of the E-commerce agreement supplied by the Bank

Information 3 Num

Shows the payment transaction situation 000 – transaction concluded

NNN – transaction not concluded, where NNN is a different number from 000 Important: sending the variable with code 000 does not guarantee the payment. The Sonda form must be effectuated for confirmation.

Msgloja 480 Alfa Instructions from the vender will presented on the charging transaction slip

Name 60 Alfa Name of the buyer, which will be presented on the selling note

refTran 17 Num

Assigned number generated and controlled by the contracting party, which identifies the purchase order in all the payment process. Each new transaction should generate another refTran number, not being able to be reused, especially the numbers used in the tests.

In case a selling note is bound to the E-commerce agreement, request the number of this agreement for their agency and verify:

a) for the selling note with 6 (six) positions the 17 positions are free; b) for the selling note with 7 (seven) positions inform:

CCCCCCCNNNNNNNNNN, where: CCCCCCC = number of the selling note NNNNNNNNNN = free positions

In case there is no selling note bound to the E-Commerce agreement, the 17 positions are free.

For the Points Relationship Program, a variable is composed in the following way:

CCCCCCCCCPPPPPPPP, where:

CCCCCCCCC: The Relationship Program assumes: 999999901 – The Client Relationship Program indicates 999999902 – Legal Person Relationship Program PPPPPPPP – Partner order Number

Situation 2 Num

Shows the situation of the payment: 00 – payment done

01 – payment not authorized 02 – error in the consulting process 03 – payment not found

10 – “idConv” Field invalid or zero

11 – value mentioned is invalid, zero or does not match the registered value registered

99 – Operation canceled by the client

tpPagamento

1 or 2

Num

According to the type of payment:

0 – All types employed by the contracting party 2 – Bank transaction slip

21 – 2nd issue of the transaction slip, previously generated 3 – Debit in an Internet Account

5 – BB Internet Credit

For the Points Relationship Program, a variable is composed in the following method:

(10)

the Client

62 – Type of payment with points of the Leal Person Relationship Program

Uf 2 Alfa The buyer’s situation will be presented in the selling note

urlInforma

60 Alfa

Completion of the address (URL) will be activated, showing that a transaction was finalized on the BB site, being up to the contracting party to activate the Sonda Form to confirm the financial liquidation of the purchase

The activated address (URL) is composed by the concatenation of two parts: - one part registered in the agency. Example: https://www.teste.com.br - one part will be the complement of the fixed part that will be informed in this variable (urlInforma). Example: “/InformaBB.asp?1358568“

In this case, the following address will be activated: https://www.teste.com.br/InformaBB.asp?1358568

Important: The activation of the Informa form does not mean, no matter what, the liquidation of the financial commitment. The contracting party must activate the Sonda form to confirm or wait for the availability of the file return the following working day after the payment has been done.

urlReturn 60 Alfa

(URL) address where the client will be directed to, through a Return form, in case it wishes to return identified to the contracting party’s site, beginning from the last page of the payment process, clicking on the available button on this page. Composed by the concatenation of the two parties:

- one part registered at the agency. Example: https://www.teste.com.br

- one part will be the complement of the registered part at the agency informed in this variable (urlRetorno). Example: /RetornoBB.asp?1358568 In this example, the client will be directed to the following site:

https://www.teste.com.br/RetornoBB.asp?1358568

Important: The sending of the Return form to the specified site does not mean in any way the liquidation of the financial commitment. The contracting party must activate the Sonda form confirm the transaction or wait for the availability of the return file the next following working day after the payment has been done.

Value 15 Num

Total value of the purchase in Reais, with cents with no formatting. Example: for R$ 195,72 write 19572

For the Points Relationship Program, a variable is composed in the following way:

Value in reais transaction, inform zero’s

qtdPontos 15 Num Exclusive value for the Points Relationship Program.

The number of points to be received in the Relationship Program.

valueSonda 15 Num Total value of the purchase in Reais, with cents without formatting. Example: for R$ 195,72 write 19572

a) Payment Form

Variables in the sending of the Payment form: The Contracting party site The Bank’s site

Variable Utilization

idConv Compulsory

refTran Compulsory

valor Compulsory (for the Points Relationship Program inform zeros) qtdPontos Compulsory (exclusive variable for the Points Relationship Points) dtVenc Compulsory

tpPagamento Compulsory

urlRetorno Compulsory

urlInforma Optional name Compulsory

Address Compulsory when transaction slip is allowed City Compulsory when transaction slip is allowed State Compulsory when transaction slip is allowed Zip code Compulsory when transaction slip is allowed msgstore optional

(11)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 11

OBS: For the generation of the 2nd issue of the selling note, a variable tpPayment will be filled out with “21” and all the fields must be identical as the 1st issue of the selling note. In case there is a need to alter the fields, it is necessary to request the generation of the transaction slip with a new refTran and with the tpPayment represented by “2”.

Structure of the Payment form

<form action="https://www16.bancodobrasil.com.br/site/mpag/" method="post" name="pagamento">

<input type="hidden" name="idConv" value="<%= idConv %>"> <input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="valor" value="<%= valor %>">

<input type="hidden" name="qtdPontos" value="<%= qtdPoints %>"> <input type="hidden" name="dtVenc" value="<%= dtVenc %>">

<input type="hidden" name="tpPagamento value= "<%= tpPayment %>"> <input type="hidden" name="urlRetorno" value="<%= urlReturn %>"> <input type="hidden" name="urlInforma" value="<%= urlInforma %>"> <input type="hidden" name="nome" value="<%= name %>">

<input type="hidden" name="endereço" value="<%= address %>"> <input type="hidden" name="cidade" value="<%= cidade %>"> <input type="hidden" name="uf" value="<%= uf %>">

<input type="hidden" name="cep" value="<%= cep %>">

<input type="hidden" name="msgloja" value="<%= msglojae %>"> </form>

b) Return Form

Variables in the sending of the Return form: The Bank’s site the contracting party’s site.

This form is added by the Banco do Brasil site, if the buyer after completing a payment, clicks on the return to Store button. It allows the contracting party to identify which client is returning to their site after completing the payment transaction or the issuing of the transaction slip on the BB site. It does not represent the liquidation of the financial commitment, which should be confirmed through the Sonda form (as shown in item d below).

Variable

Utilization

refTran Compulsory

idConv Compulsory

tpPagamento Compulsory

Structure of the Return form

<form action="return form of the contracting party registered at the Bank+complement*" method="post" name="return">

<!-- Return of variables for the Store -->

<input type="hidden" name="refTran" value=""> <input type="hidden" name="idConv" value=""> <input type="hidden" name="tpPayment" value=""> </form>

(*) complement is the content of the variable “urlReturn” obtained in the “payment” form

c) Informa Flux Form (For a Natural Person’s current account transaction)

Obs: The fixed part (registered at the Bank) of the URL address Informa should be the same URL Return.

(12)

2) When the proof of payment is presented, the Informa form is activated, with the following structure:

Example data:

E-commerce agreement number = 8308 Reference of the transaction = 52170785 Value of the transaction = R$ 2.567,89

Example 1 (concatenation without character "?")

A fixed part registers at the Bank: http://www.loja.com.br urlInforma variable content: /teste.jsp

the BB activates the address:

http://www.loja.com.br/teste.jsp?refTran=52170785&idConv=8308&valor=256789 Example 2 (concatenation with character "?"):

Fixed part registered at the Bank: http://www.loja.com.br

urlInforma Informa variable: /teste.jsp?parametroDaLoja=seila BB activates the address:

http://www.loja.com.br/teste.jsp?parametroDaLoja=seila&refTran=52170785&idConv=8308&val or=256789

That is, if the concatenation of the urlInforma registered with BB urlInforma sent in the payment form does not have the character "?", the bank will include at the end of the concatenation the character "?" and information? refTran = 52170785 & idConv = 8308 & value = 256789

In case the character "?" exists in this concatenation, the bank will include the character "&" at the end of this concatenation and the information

&refTran=52170785&idConv=8308&valor=256789

For the Points Relationship Program:

Variables of the Inform sending file: The Bank’s site The Contracting party’s site

This form is used by the BB to send the partner the information that an exchange transaction has occurred. With this information the partner activates the Sonda form to search for the transaction confirmation at BB.

Variable

Utilization

idConv Compulsory

refTran Compulsory

value Compulsory(inform zeros)

qtdPoints Compulsory

d) Sonda Form ( on-line consultation regarding the payment situation)

Variables in the sending of the Sonda form: The contracting party’s site The Bank’s site

Observation: on-line consultation available of payments done by Debit account via the Internet or BB Internet Credit.

Variable

Utilization

idConv Compulsory

refTran Compulsory

valueSonda Compulsory (for the Points Relationship Program inform the zero´s)

qtdPontos Compulsory(exclusive for the Relationship Points Program)

(13)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 13

Structure of the Sonda form

<form action=" https://www16.bb.com.br/site/mpag/REC3.jsp" method="post" name="sonda"> <input type="hidden" name="idConv" value="<%= idConv %>">

<input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="qtdPontos" value="<%= qtdPontos %>"> <input type="hidden" name="valSonda" value="<%= valor %>"> <input type="hidden" name="formato" value="<%= formato %>"> </form>

Response from the Sonda form

Variables in sending the response of the Sonda form: The Bank’s site the contracting party’s site

Variable

Utilization

refTran Compulsory valor Conditional idConv Compulsory tpPagamento Compulsory situacao Compulsory dataPagamento Compulsory

qtdPontos Compulsory(exclusively for the Points Relationship Program)

XML Structure

<?xml version='1.0' encoding='ISO-8859-1' standalone='no'?> <!DOCTYPE lojavirtual SYSTEM "lojavirtual.dtd">

<FORMULARIO>

<ENTRADA nome="reftran" valor=""/> <ENTRADA nome="valor" valor=""/> <ENTRADA nome="idConv" valor=""/> <ENTRADA nome="tpPagamento" valor=""/> <ENTRADA nome="situacao" valor=""/> <ENTRADA nome="dataPagamento" valor=""/> <ENTRADA nome="qtdPontos" valor=""/> </FORMULARIO>

Structure of the “lojavirtual.dtd”

<?xml version="1.0" encoding="ISO-8859-1"?> <!ELEMENT FORMULARIO (ENTRADA)+> <!ELEMENT ENTRADA (EMPTY)>

<!ATTLIST ENTRADA nome CDATA #REQUIRED valor CDATA #REQUIRED>

Response in a String form

String = aaaaaaaaaaaaaaaaa000000000000000bbbbbbcddeeeeeeeeqqqqqqqqqqqqqqq Where and is a Variable

aaaaaaaaaaaaaaaaa refTran 000000000000000 Value bbbbbb idConv c tpPagmento dd Situation eeeeeeee dataPagamento

(14)

e) Sales Cancelation Form

Place and date

To Banco do Brasil S.A. Agency (Name of Agency)

Dear Manager,

SALES CANCELATION – According to the regulation of Banco do Brasil´s Electronic Commerce, seventh Clause, point “i”, cancelation communication, as below:

idConv Code Sales date Sales value Order number

reftran (id.banco/id.loja) Code

2. I(we) authorize this Bank to chargeback our current account the value above.

Company’s Signature

(15)

---Version 015 TECHNICAL SUPPORT: 0800-729-0500 15

3. LAYOUT OF THE RETURN FILE – INTERNET DEBIT ACCOUNT HEADER OF THE RETURN FILE – REGISTRATION CODE A

Field Position Type Content

A1 01-01 Alfa (001) Register code of assumes “A”

A2 02-02 Num (001) Remittance code of assumes 2 (return sent by the Bank) A3 03-08 Num (006) Agreement number

A4 09-09 Alfa (001) Future use

A5 10-18 Num (009) Num |Return of the Electronic Exchange data sequential A6 19-22 Alfa (005) Future use

A7 23-42 Alfa (020) Name of company / institution A8 43-45 Num (003) Num |Bank code of the banking compensation A9 46-65 Alfa (020) Name of bank

A10 66-73 Num (008) Date of the file generation – AAAAMMDD - format A11 74-79 Num (006) File sequential number

A12 80-81 Num (002) FEBRABAN layout version adopted for registration type G A13 82-142 Alfa (061) Reserved for future use

A14 143-150 Alfa (008) In case of E-commerce this space will be empty

RETURN FILE DETAIL – REGISTRATION CODE G

Field Position Type Content

G1 01-01 Alfa (001) Register code assumes “G” G2 02-05 Num (004) Agency prefix number of credit

G3 06-06 Alfa (001) Verifying digit of the agency – module 11 G4 07-15 Num (009) Current account number of credit

G5 16-16 Alfa (001) Verifying digit number of current account-module 11 G6 17-21 Alfa (005) Future use

G7 22-29 Num (008) Payment date – AAAAMMDD format G8 30-37 Num (008) Date of credit – AAAAMMDD format G9 38-81 Alfa (044) Bar code – see specifications below G10 82-93 Num (010)v99 Received value

G11 94-100 Num (005)v99 Fee value

G12 101-108 Num (008) Register sequential number G13 109-112 Num (004) Prefix of the receiving agency G14 113-116 Alfa (004) Future use

G15 117-117 Num (001) Method of collection 1- Cash desk, 2 - Electronic, 3 - Internet G16 118-140 Alfa (023) Electronic authentication

G17 141-141 Num (001) Receiving method: 1- Money, 2 - Check, 3 – Not identified G18 142-150 Alfa (009) Future use

FIELD G9 – BAR CODE

Field Position Type Content

G9.1 01-01 Num (001) Code indentifying number of the product - assume 8 (collection) G9.2 02-02 Num (001) Sequential identification and company/institution identification method –

assume: 9

G9.3 03-03 Num (001) Real value or reference identifier – assumes 6 (real) G9.4 04-04 Num (001) General verifying digit – modulo 10

G9.5 05-15 Num (011) Value in reais

G9.6 16-19 Num (004) BB code at clearance. Assumes: 0001 G9.7 20-21 Num (002) Filled out with value ‘01’.

G9.8 22-27 Num (006) Agreement code RCB

G9.9 28-44 Num (017) Order number (and the value which was assigned to the variable

refTran generated by the contracting party) RETURN FILE TRAILER – REGISTRATION CODE Z

Field Position Type Content

Z1 01-01 X(001) Register code assume “Z”

Z2 02-07 9(006) Total of file registers, inclusive header and trailer Z3 08-24 9(017) Total value received from the free file

(16)

4. UPDATES HISTORY OF THIS DOCUMENT

Updating number: 015 Date of publication: 10.03.2009

Reason for update: Contemplates an inclusion of variables of the dealing with points in the Relationship Program at Banco do Brasil

Update number: 014.3 Date of publication: 09.04.2008 Reason for update: Inclusion of the Sales Cancelation Form.

Update number: 014.2 Date of publication: 23.10.2007 Reason for update: Inclusion of the variable urlInforma, available for Natural Person.

Update number: 014.1 Date of publication: 21.07.2006 Reason for update: Inclusion of the variable urlInforma and the revision of the entire manual. Update number: 013 Date of publication: 28.06.2006 Reason for update: Posting address altered and the exclusion of form variables.

Update number: 012 Date of publication: 26.05.2006 Reason for update: Inclusion of the payment option via BB Internet Credit

Update number: 011 Date of publication: 22.03.2006 Reason for update: Text of the variable description altered "refTran" and other editing adjustments Update number: 010 Date of publication: 09.07.2004 Reason for update: Editing Adjustments.

Update number: 009 Date of publication: 14.06.2004 Reason for update: Text of the variable description altered "refTran" and other editing adjustments. Update number: 008 Date of publication: 27.02.2003 Reason for update: Correction on page 19, detail in field G9 – Bar Codes

Update number: 007 Date of publication: 29.11.2002 Reason for update: - Inclusion of the configuration of the 2nd issuing of the selling note

Update number: 006 Date of publication: 13.11.2002 Reason for update: Alteration of the refTran from 12 positions to 17 positions in the www11 server Update number: 005 Date of publication: 13.05.2002 Reason for update: Alteration of the Guide´s name and inclusion of the technical support telephone

number

Update number: 004 Date of publication: 13.12.2001

Reason for update: Alteration of the address to where the payment form should be sent from Sonda. Inclusion of the debit account for Legal Person, and new format of the return of the sonda.

Update number: 003 Date of publication: 09.04.2001

Reason for update: Permits that the size of the variable refTran is in 17 positions, when the payment option is through a transaction slip (tpPagamento = 2). Only available for transactions which point to the www10 server.

Update number: 002 Date of publication: 12.03.2001 Reason for update: Return of the sonda – checks the payment situation, in XML format.

Alteration of the url systematic set up of the return page to the contracting party´s site. Alteration of the selling slip layout.

Update number: 001 Date of publication: 15.12.2000 Reason for update: Alteration of the URL for posting the payment form and checking the payment.

(17)

Version 015 TECHNICAL SUPPORT: 0800-729-0500 17 GLOSSARY Informa - Informs Sonda Pagamento - payment Pontos - points Valor - value Entrada - entry Nome - name

Loja virtual – virtual store Cep – zip code

Uf - state Cidade - city Dt.venc. - due date

References

Related documents