Applicable Release:
SAP Business One 8.82 PL05
Brazil
English
April 2012
Table of Contents
Table of Contents .............................................................................................................................................. 2
Introduction ...................................................................................................................................................... 3
Glossary ............................................................................................................................................................. 3
Retorno File Import and Matching Wizard .................................................................................................... 4
Prerequisites ...................................................................................................................................................... 4
Settings for House Bank Accounts .................................................................................................................... 4
Defining Additional Codes in Payment Methods ............................................................................................... 5
Defining Retorno Operation Codes ................................................................................................................... 5
Duplicating Retorno Operation Codes ............................................................................................................... 6
Importing and Matching Retorno Files ............................................................................................................... 7
Loading Saved Files and Re-Matching Imported Transactions......................................................................... 9
Deleting Imported Files of Saved Wizard Runs ............................................................................................... 10
Payment Wizard Enhancements .................................................................................................................. 11
Alternative Posting Method for Bills of Exchange ..................................................................................... 15
Appendix A: BFP Tree Format Definition for CNAB240 and CNAB400 (Boleto Retorno) ...................... 16
Mapping or Constant Fields ............................................................................................................................. 17
Header Row Fields .......................................................................................................................................... 17
Body Row Fields .............................................................................................................................................. 18
Custom Validation Check Fields ...................................................................................................................... 20
Copyrights, Trademarks, and Disclaimers.................................................................................................. 21
Enhancements in Bill of Exchange Processing 3
Introduction
This document describes the enhancements towards business practice compliance implemented in SAP
Business One 8.82 PL05 to support bill of exchange processing.
Key enhancements:
Retorno File Import and Matching Wizard – enables you to automatically import retorno electronic
files provided by the different banks in Brazil, and clear bills of exchange created in SAP Business
One against the transactions included in the imported retorno file.
Payment Wizard – enhanced to support the processing of existing incoming bills of exchange and
the generation of bank files for bills of exchange in various statuses (Sent, Generated, Deposited,
and Paid).
Bank File Formats – the following are supported:
o Remessa CNAB240 for Banco do Brasil of Cobranca type (outbound bank file)
o Retorno CNAB240 for Banco do Brasil of Cobranca type (inbound bank file)
Possibility of mapping other bank file formats via the SAP Business One Electronic File Manager –
Format Definition add-on.
Alternative posting method for bills of exchange.
Glossary
Term Abbreviation Definition
Remessa bank file Remessa Outbound bank file that contains
instructions to be executed by
banks for a specified incoming or
outgoing bill of exchange (or even
bank transfer). The file needs to
be manually communicated to the
bank (generally uploaded via the
bank’s webpage).
Retorno bank file Retorno Inbound bank file that contains a
reply from a bank for a specified
incoming or outgoing bill of
exchange. The file needs to be
manually imported into SAP
Business One via the new
Retorno File Import and Matching
wizard, and its contents need to
be processed further (bill of
exchange updated).
Prerequisites
Settings for House Bank Accounts
1. From the SAP Business One Main Menu, choose Administration Setup Banking House
Bank Accounts. The House Bank Accounts – Setup window appears.
2. Define the following parameters for each house bank account you want to include in the Retorno File
Import and Matching wizard run:
Field Activity/Description
Fine Account Specify the G/L account for posting fines paid by a customer.
Interest Account Specify the G/L account for posting interest paid by a customer.
Discount Account Specify the G/L account for posting the amount of discount granted to
a customer in cases of early payment.
Service Fee Account Specify the G/L account used for posting the service fee paid by the
company.
Other Income Account Specify the G/L account for posting other incomes paid by a customer.
Other Expense Account Specify the G/L account for posting other expenses granted to a
customer or to be paid to the bank.
Retorno File Format Assign the default file format to the account.
IOF Tax Account Specify the G/L account for posting the IOF tax charges for financial
transactions.
Collection Code The special code expected by the bank
File Sequence – Next No. Sequence used in outbound bank files to distinguish between two sent
files
3. Choose Update.
Field Activity/Description
Bank Code From the dropdown menu, select the code of the bank in which you
have a house bank account.
File Format From the dropdown list, select the required file format to be used for
importing the retorno file. If you intend to use multiple file formats for
a given bank code, you have to define a separate retorno operation
code for each file format.
Occurence Code, Define a combination of occurrence code and movement code, and
Movement Code, BoE
indicate to which BoE status it applies.
Status
During the Retorno File Import and Matching wizard run, when the
defined combination of occurrence and movement codes is detected,
the wizard recommends updating the status of the given bill of
exchange to the status you specify here.
Any given bill of exchange status can be indicated by multiple
combinations of occurrence and movement codes.
Description Enter a meaningful description. It will appear in the matching
recommendations provided by the Retorno File Import and Matching
wizard.
Color Click a cell in a given row to set a color indicator for each
combination. The colors are then visible when the matching
recommendations are displayed.
3. After defining all required combinations for the selected bank code and file format, choose Update.
1. From the SAP Business One Main Menu, choose Administration Setup Banking Retorno
Operation Codes. The Retorno Operation Codes – Setup window appears.
2. Browse to the retorno operation code you want to duplicate by selecting the bank code and the file
format from the respective dropdown menus.
3. From the menu bar, choose Data Duplicate (or right-click or CTRL+D). A system message
appears notifying you that the rows of the displayed retorno operation code were duplicated. Choose
OK. The duplicated retorno operation code is displayed.
4. From the Bank Code and File Format dropdown menus, select the bank code and file format to
which you want to apply the duplicated retorno operation code. The Retorno Operation Codes –
Setup window is cleared.
5. From the menu bar, choose Data Restore. The duplicated rows are copied to the newly created
retorno operation code.
6. Make any additional adjustments as required. For example, you can delete specific rows, add
additional rows, change colors, and so on. To save your settings, choose Update.
3. In the Selection Criteria (step 2) window, specify the parameters related to the retorno file to import.
Choose Next.
Field Activity/Description
Due Date From, To By default, all the transactions appearing in the imported file are
included in the wizard run. To include transactions having a due
date within a defined date range only, specify this date range
here.
Bank Account Select the house bank account for which you want to import the
retorno file.
File Format The file format defined for the specified house bank is
populated automatically. Specify another file format if required
and available.
File Choose the Import button to open a browsing window where
you can locate the file you want to import. The path is then
populated in this field.
4. The Matching Recommendations (step 3) window lists the transactions found in the imported file and
the bills of exchange documents created in SAP Business One that can be cleared against them.
The colors of the rows represent the colors defined for the retorno operation codes.
The column Matched BoE displays the bill of exchange created in your SAP Business One company
that matches the imported transaction in the given row. In case such a bill of exchange is not
identified, this field is empty.
Press Tab to open the list of existing bills of exchange and manually select a matching bill of
exchange, if one exists.
The Requested BoE Status field indicates the BoE status to be assigned to the given bill of
exchange after the wizard is executed. You can change it manually if needed.
Select the checkbox in the rows of the transactions you want to match. Choose Next.
Note
The matching recommendations are rated as follows:
Automatic – when the BoE number, bank account, BP name, and transaction amount in
a bill of exchange existing in the SAP Business One company are identical to those of a
Field Activity/Description
Sequence No. Indicates the number of the imported file to distinguish it from the other files
Stamp Date The date on which the imported file was generated by the bank
Import Format The format of the imported file
Status ndicates whether the transactions from the file are matched or not:
Draft – indicates that the file is imported but its transactions are not yet
matched. The number of transactions that are not matched appears in
brackets. For example Draft (10) indicates that the imported file
contains 10 transactions that are not yet matched against the
respective bills of exchange in SAP Business One.
Executed – indicates that some or all of the transactions in this
imported file are matched against the respective bills of exchange in
SAP Business One. The number in brackets indicates the number of
matched transactions, for example Executed (23). Wizard runs with
the status Executed appear in green.
When some of the transactions in a given imported file are matched, and
some are not, there are two rows in the list to represent the two types of
transactions, with both rows having the same sequence number. For example,
a file containing ten transactions is imported. Six of them were not matched
and four were. The following rows appear in the list:
Sequence No. Status
33 Draft (6)
33 Executed (4)
3. To filter the list by bank account, from the Bank Account dropdown menu, select the required bank
account.
4. From the list, select the saved wizard run you would like to further process. The Rematch
Transactions checkbox appears. To try to match in the wizard run outstanding transactions that were
imported but were not matched in a previous run, select this checkbox.
Note
If you select an executed wizard run, this checkbox does not appear.
5. Follow step no. 3 onwards in the Importing and Matching Retorno Files section.
Note
When the Handle Existing BoE checkbox is selected, the Execute Payment Order Run radio
button in the Save Options (Step 7) window is disabled.
BoE Selection Criteria section – added to the Document Parameters (step 4) window. You can use it
to fine tune the range of bills of exchange to be included in the payment run. This section is available
only if the Handle Existing BoE checkbox is selected in the General Parameters (step 2) window,
and applies only for incoming bills of exchange.
House bank account details – in the Payment Methods – Selection Criteria (step 5) window, the
following newly added columns display the respective details relating to the bank accounts defined
for the displayed payment methods: Bank Code, Bank Name, Account Number, and Bank Account
Name.
Recommendation Report – detailed information is displayed for the bills of exchange included in the
payment run; some of the parameters can be updated manually if needed:
Field Activity/Description
BoE No. Drill down to the BoE record. You can edit this field only for non-
generated BoE objects, similarly to manual bill of exchange number
handling.
Bar Code Assign bar codes to outgoing payments (BoE from vendor), similarly
to manual outgoing payment handling.
Bank Code Displays the bank code of the house bank account linked to the
payment method in the payment row.
Bank Name Displays the bank name of the house bank account linked to the
payment method in the payment row.
Account No. Displays the number of the house bank account linked to the
payment method in the payment row.
Bank Account Name Displays the name of the house bank account linked to the payment
method in the payment row.
Field Activity/Description
BoE Our Number Displays the number assigned by the bank for the specific BoE
document.
BoE Current Status Displays the current status of the BoE (Generated, Deposited, Paid).
Remessa Movement Code, The default values of these fields are taken from the selected
BoE Instruction 1, BoE payment method (linked to a house bank account).
Instruction 2, BoE
Cancellation Instruction,
BoE Internal Portfolio ID
choose-from lists
BoE Discount Amount Enter the amount of discount to be granted to a customer who pays
by the BoE discount date, and the date for granting the discount to
the customer.
BoE Interest Amount Enter the amount of interest to be charged to a customer who does
not pay by the BoE interest date.
BoE Interest Date Enter the critical date for charging interest to a customer.
BoE Fine Amount Enter the amount of fine to be charged to a customer who does not
pay by the BoE fine date.
BoE Fine Date Enter the critical date for charging a fine to a customer. The default
value is the BoE due date.
IOF Tax Amount Enter the amount of financial transactions tax.
NF No., Series, Subseries, Displays the values of these fields as saved with documents linked
Model to the payment (e.g. Invoice)
Payment Run Summary – this step displays how many bills of exchange documents were created,
and for how many bills of exchange a request for status update was submitted through the given
payment run.
Note
Activating the alternative posting method is irreversible.
Once the Use Alternative Posting Method for Bill of Exchange checkbox is selected, the following behavior
applies:
When creating (either manually or through the payment wizard) a payment using bill of exchange as the
payment means, a new bill of exchange document is created. However, no posting or BoE transaction is
created. As a result, the original balance due of the invoice (for which the payment was created) is not
affected.
When updating the bill of exchange status from Generated to Deposited, no Journal Entry posting
transaction is created.
When updating the bill of exchange status from Deposited to Paid, the posting behind the transaction
involves the original marketing document for which the bill of exchange was created (Accounts
Receivable or Accounts Payable) and the Bank on Collection or Bank on Discounted G/L account. The
same applies when the bill of exchange status is changed from Paid to Deposited or from Paid to Failed
When the bill of exchange status is set to Paid, the invoice for which the bill of exchange was created is
reconciled with payment of Bill of Exchange payment mean.
If a certain field does not contain the expected characters, the Retorno File Import and Matching wizard
stops the import matching procedure with an error message and does not finish the import.
Note
All fields are defined as standard and mandatory.
MF fields with T_ or U_ prefix variations are marked as TU in the table below.