Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Page 1
Document Control
Change Record
5
7
Reviewers
Name Position
Audience
Name Position
12.1 & Above Product Support Team External
12.1 & Above Customers External
Contents
3
EMEA Add On-Whitepaper for Israel Open Format
1. Installations
These Add-On Localization Features are installed after the base install of Oracle E-Business Suite.
Following are the step by step process for installation of EMEA Add on - Israel Localization:
I) The Israel Add-On Localizations patches to be applied are available for download from MOS
(R12 EMEA Add-on Localizations - Israel (Doc ID 470635.1). Please ensure the prerequisites are
followed before installing the patch, especially the product splicing for CLE (EMEA Consulting
Localizations). For any CLE patch, the pre-requisite patch creates and installs the product EMEA
Consulting Localizations. This process is called product splicing. In the readme for this splicing
patch, detailed instructions are given for splicing. Once the patches are installed, please ensure
that the Post-installation steps are completed.
II) Once the Patchset for Israel Add on Localizations are applied, go through the different sections
of Add-On Localizations features on the same Note ID and the latest patches mentioned for those
features are to be applied. These patches creates the Localization Descriptive Flexfield definitions
for users to store additional information required for those features. The details are specified in
the Readme of each Add-On Localizations Feature Patch.
III) After that, follow the steps in the ‘Israel Add-On Localization Installation Manual' (Download
Installation Instructions Document from Section: Israel Add-on Localizations - Complete Set on
the same Note ID) to enable the Localization Descriptive Flexfields. These installation steps are
required to invoke Localization Descriptive Flexfield from the additional Menu extension on the
related application forms/ pages.
IV) Once above Installation steps are done, the setups explained in 'General Setups' section of
this Document are to be completed to enable the specific segments that capture the additional
information. It is necessary to provide the additional information for these Localization
Descriptive Flexfield segments either as a setup prerequisite or during the transaction entry
depending on where this additional information is required.
4
EMEA Add On-Whitepaper for Israel Open Format
2. Introduction
Welcome to Oracle EMEA Add-on Localizations whitepaper for Israel.
This Whitepaper includes information to help you understand the following aspects of the
Localization and to implement the Localization effectively for an Israeli customer.
• Overview of Reports.
• Mandatory Setup for these Reports.
• Reports Output analysis.
5
EMEA Add On-Whitepaper for Israel Open Format
3. Features Covered
Since 2006, Israel Tax Authority require the ERP and Accounting Software of all Israeli businesses
to provide ASCII files which will contain detailed information of the transactions created pertaining
to General Ledger and Sub-ledger transactions like Customer Receipts, Inventory Receipts,
Supplier invoices, Customer invoices, Sales Order, Return to Vendors, etc. The data should be
shared with the Israeli Tax Authority in two data files, namely BKMVDATA.txt and INI.txt
This document explains the Israel Open format solution, to meet the above requirement of Israeli
Tax Authority. The feature comprises of the below Concurrent Requests.
6
EMEA Add On-Whitepaper for Israel Open Format
4. Implementation and setups
a) Oracle's General Ledger, Oracle Payables, Oracle Receivables, Oracle Purchasing, Oracle Order
management, Oracle Inventory and Work In Progress (WIP) guides.
b) Installation setup steps as described later.
Assumptions:
Setup:
7
EMEA Add On-Whitepaper for Israel Open Format
There are some additional setup steps, which need to be performed for this solution to work. Details
about the same is specified in the further pages.
• Legal Entity setup and Open Format Solution necessary information has been completed.
• Localization Descriptive Flex field setup at Balancing Segment Values (BSV) has been
completed.
• Localization Descriptive Flex field setup at Receipt Class for each operating unit has been
completed.
• Localization Descriptive Flex field setup at Transaction Types for each operating unit has been
completed.
• Localization Descriptive Flex field setup at Receipts and this is used for capturing the additional
information related to credit card payments.
Profile Options:
• Set Profile Option 'CLE: IL OF File Path' with directory path, where the files need to be generated
under UTL_FILE_DIRECTORY.
• The BKMV and INI files in the directory path would be refreshed with every run of concurrent
program "CLE: Israeli Localization Open Format File Generation". So these files need to be saved on
a local directory before initiating subsequent run.
8
EMEA Add On-Whitepaper for Israel Open Format
Tax Authority Document Setup:
• Forms Personalization: The patch installs the following forms personalizations. These
needs to be added to required menu:
9
EMEA Add On-Whitepaper for Israel Open Format
Legal Entity setups:
In order to provide flat file per company, Legal Entity is defined and maintained through standard
organization including address, tax registration number. Balancing Segments that are eligible for
reporting are enabled.
The following information related to the Legal Entity defaults from the Legal Entity setup. However,
certain information which cannot be captured from the standard fields in Legal Entity setup are
captured in the contact information page of the Legal Entity.
Location information defaults from the location attached to the Legal Entity as the registered address
for the establishment where identifying flag is enabled.
Tax registration number is derived from the contact information where the last name is with TRN and
its corresponding value from the first name of the contact of the Legal Entity.
The file generation program can be run at a time only for one particular financial year. The year
parameter to the concurrent request validates that the entered dates belongs to the same calendar
year as per the associated GL Calendar.
10
EMEA Add On-Whitepaper for Israel Open Format
E-commerce Gateway:
The setups specified below, for E-Commerce gateway, would be available to review the data after
running the CLE: Israeli Localization Populating Open Format Tables request set.
The setups in E-Commerce Gateway are used to generate the flat file. The information derived are the
description, length of the field, type of padding and the character used for padding. The setups can be
modified, as and when required by the Israeli tax authority, in future, by the business users.
Navigation: e-Commerce Gateway -> Setup -> Code Conversion -> Define Code Conversion Category
IL Open Format Documents – Lists all the document types for which data need to be extracted to
BKMVDATA.TXT file. For each document, document code, description and table names are maintained.
CLE_IL_OF_XXXX – Maintain file structure mapping for each table in CLE_IL_OF_C100, CLE_IL_OF_D110.
For the Open format Document list, the below setups are present.
Navigation: e-Commerce Gateway -> Setup -> Code Conversion -> Define Code Conversion Values
11
EMEA Add On-Whitepaper for Israel Open Format
The below table represents the meaning of each column in the above setup.
Column Name Value Reference
Description Document Description
Key 1 Name of the table storing header information
Key 2 Name of the table storing document line information
Internal Value Document code in Tax Authority Design document
External1 End Position
Each Table is mapped to file position. The below screenshot illustrates the position for table
CLE_IL_OF_A100
The below table depicts the fields and their reference in this form.
Column Name Value Reference
Category Table Name
Description Column name in the table
Internal Value Start Position in the file record
External 1 End Position in the file record
External 2 File Segment length
External 3 Type of padding (L-Left, R- Right), if any
External 4 Padding Character
12
EMEA Add On-Whitepaper for Israel Open Format
Localization Descriptive Flex Fields:
Balancing Segments – Reporting Assignment: This LDFF is defined for identifying the balancing
segments value which are eligible for Israeli Tax Authority reporting. This is done in the BSV Assignment
OA Page for the particular setup in the Accounting Setup Manager. Only those BSVs for which Reporting
is set to 'Yes' are considered for reporting and populate data into the CLE tables. Information relating
to other BSVs are skipped.
Field Name Value
Application EMEA Add-on Localization Flex
Field Title Balancing Segment Flex fields Context
Reference Field None
Displayed Yes
Required Yes
Code Code: IL.IL_OF_BSV_INFO
Name: CLE: IL Additional BSV Information
Description: CLE: IL Additional BSV Information
13
EMEA Add On-Whitepaper for Israel Open Format
5. CLE: Israeli Localization Populating Open Format
Tables
The Concurrent Request Set CLE: Israeli Localization Populating Open Format Tables consists of eight
concurrent requests. Each concurrent program populates the CLE report tables with the data specific to a
document type.
The Requests are submitted sequentially and in case any of them goes into error, the data for the same is
rolled back. Subsequent concurrent program would continue even when any concurrent fails.
If the users want to run the concurrent program individually, they need to run them in the same sequence
as the Request Set. However, it is recommended not to run these requests individually.
Below are the list of concurrent program that are part of this request set.
80 CLE: C100 Documents A new report that summarizes Summary Report (the
Summary Report C100 records (count and amounts))
14
EMEA Add On-Whitepaper for Israel Open Format
Below are the list of parameters which will be passed to the request set.
The Request Set can be submitted from the Concurrent Request submission window. The report can be
submitted for any date range based on the business requirement.
The Parameters given to the Request set are cascaded to the individual requests.
15
EMEA Add On-Whitepaper for Israel Open Format
The log file of the individual concurrent program shows the number of records inserted into the CLE
Tables.
The output of CLE INI Counter report as below shows the number of records that are inserted into the CLE
Tables, by the individual concurrent requests in the request set.
16
EMEA Add On-Whitepaper for Israel Open Format
5.1 CLE: Israeli Localization Open Format Generate Header
Record (A100)
This program creates a unique sequence which helps in the identification for the information
related to a particular data file. This sequence is increased every time the request set is
submitted.
After successful execution of this concurrent program, CLE_IL_OF_A100 table is populated with
the parameter information for which the request set has been submitted. These parameter
information will later be accessed by the other child concurrent programs following this
concurrent program.
Only the Ledger, Legal Entity, Year, Start and End date, Future Use parameters and also BSV
enabled for this reporting are displayed as part of output.
17
EMEA Add On-Whitepaper for Israel Open Format
5.2 CLE: Israeli Localization Open Format Collect Acct
Index and Account Journals (B100)
The concurrent request populates the Flat File Data source with Accounting Index (B110) and Account
Journals (B100) Information. During the time of flat file generation, accounting Index and Account Journal
data are retrieved from the CLE_IL_OF_B110 and CLE_IL_OF_B100 tables.
There is no parameter for this concurrent program. Selection criteria information like Ledger, Legal Entity,
Year, Start Date, End Date, Constant and Future Use is defaulted from the CLE_IL_OF_A100 table.
Transactions which failed to populate the balance sheet code due to non-availability of tax authority
Document type code setup are displayed with the details.
There is no parameter for this concurrent program. Selection criteria information like Ledger, Legal Entity,
Year, Start Date, End Date, Constant and Future Use are defaulted from the CLE_IL_OF_A100 table.
18
EMEA Add On-Whitepaper for Israel Open Format
5.4 CLE: Israeli Localization Open Format Collect Inventory
Balances (M100)
This program is to populate the inventory related information into the respective tables. This program
does not have any parameters and derives the required selection criteria based on the parameter
information stored in CLE_IL_OF_A100 Table.
However, In case this program completes in warning, the data is rolled back. In such scenario, this
program can be run individually to populate the respective tables after making necessary corrections as
per the message in the log file.
Every time this request set or individual program is submitted, the data in this table is cleared first before
inserting any new records into the table.
This program is used for generating the footer record for the BKMVDATA.TXT. It provides the count of the
total number of records selected in the file. There are no specific validations. This information are stored
in CLE_IL_OF_Z900.
This program does not have any parameters and derives the required selection criteria based on the
parameter information stored in CLE_IL_OF_A100 Table.
This program is used for populating the CLE_IL_OF_INI_COUNTER and CLE_IL_OF_INI which stores the
count of qualified transaction information for each record type.
19
EMEA Add On-Whitepaper for Israel Open Format
5.7 CLE INI counter report
This program is run in order to present the counts of the qualified transaction information that has
populated the CLE_IL_OF_INI_COUNTER table.
If this request is submitted individually, the whole set of the requests of the CLE: Israeli Localization Open
Format File generation that preceded this request in the set, need to have been completed first in order
for the data to have populated the relative tables. This is why it is highly suggested to use the proposed
Request set.
20
EMEA Add On-Whitepaper for Israel Open Format
5.8 CLE C100 document summary
This program is run in order to depict in a summarized and presentable way (pdf) the amounts in ILS and
counts of all the qualified transaction that have populated the related information into the respective
tables per transaction document type.
Just like the INI Counter Report, if this request is submitted individually, the whole set of the requests of
the CLE: Israeli Localization Open Format File generation that preceded this request in the set, need to
have been completed first in order for the data to have populated the relative tables. This is why it is
highly suggested to use the proposed Request set.
The output of the program as shown below depicts the following columns
21
EMEA Add On-Whitepaper for Israel Open Format
6. CLE: Israeli Localization Open Format File Generation
BKMVDATA E-Text Program and CLE: Israeli Localization
Open Format File Generation INI E-Text Program
The concurrent program can be run from the concurrent request submission window. After completion of
the request set CLE: Israeli Localization Populating Open Format Tables has populated the data in the CLE
tables, this program can be run.
The program will verify whether the open format population programs have completed normally. If not,
the concurrent programs will not generate any output files.
This request creates output file and this file can be opened from View Output of SRS window in Firefox
browser and should be saved using Hebrew (IBM-862) encoding and also this file is placed at in output
directory as per the setup of the instance.
Selection criteria information like Ledger, Legal Entity, Year, Start Date, End Date, Constant and Future Use
are defaulted from the CLE_IL_OF_A100 table. The file creation program collects the information available
in the CLE tables.
There is a non-mandatory parameter namely ‘Report group’ for this concurrent program. This parameter
helps to segregate the data based on the group it belongs to. The grouping functionality is added to this
report to avoid the program going into warning because of the huge file size generated.
The values available for the parameter are populated from the lookup ‘CLE_F262_REPORTING_GROUPS’.
The parameter values can be selected from the list as specified below.
22
EMEA Add On-Whitepaper for Israel Open Format
Values for the Parameter Meaning
Delivery to inventory header and Delivery to Inventory Header C100-810 and Delivery to Inventory lines
lines - 810 D110-810.
Sales receipts header and lines Sales Receipts Header C100-400, 405 and Sales Receipts Lines D120-
- 400 , 405 400, 405.
Sales receipts remittance Sales Receipts Remittance Header C100-420 and Sales Receipts
header and lines - 420 Remittance Lines D120-420.
Sub inventory transfer header Sub-Inventory Transfer Header C100-830 and Sub-Inventory Transfer
and lines - 830 Lines D110-830.
WIP completion header and WIP Completion Header (In) C100-900 and WIP Completion Lines
lines In - 900 D110-900
WIP completion header Out - WIP Completion Header (Out) C100-910 - No lines
910
Sales Order header and lines - Sales Order Header C100-100 and Sales Order Lines D110-100
100
Sales order shipment header Sales Order Shipment Header C100-200 and Sales Order Shipment
and lines - 200 Lines D110-200
WIP completion return headers WIP Completion Return Headers C100 – 910 and WIP Completion
and lines- 910 Return Lines D110 - 910.
B100 journal lines Journal Lines (Will not have header info)
Inventory count adjustments Inventory count adjustments Header C100-840 and Inventory count
header and lines - 840 adjustments Lines D110-840
Issue from inventory header and Issue from Inventory Header C100-820 and Issue from Inventory lines
lines - 820 D110-820.
PO receipt header and lines - PO Receipt Header C100-600 and PO Receipt Lines D110-600.
600
Purchase invoice credit header Purchase Invoice Credit Header C100-710 and Purchase Invoice
and lines - 710 Credit Lines D110-710
Purchase invoice header and Purchase Invoice Header C100-700 and Purchase Invoice lines D110-
lines - 700 700.
Purchase order header and Purchase Order Header C100-500 and Purchase Order Lines D110-
lines - 500 500.
Sales invoice header and lines - Sales Invoice Header C100-300,305,330 and Sales Invoice Lines
300,305,330 D110-300,305,330.
Sales order return header and Sales Order Return Header C100-210 and Sales Order Return Lines
lines - 210 D110-210.
23
EMEA Add On-Whitepaper for Israel Open Format
When these programs are submitted individually from SRS, generates two output files namely
BKMVDATA.TXT and INI.TXT respectively. The BKMVDATA.TXT output file shows the detailed records of the
report group for which program is run and the INI.TXT output file shows the summary of the record count
inserted in the CLE tables of the report group for which program is run.
The BKMVDATA.TXT output file is generated based on the setup done in the E-Commerce Gateway for each
CLE table. The records in the data file are padded, if required as per the setup done in the E-Commerce
Gateway. The length for each information is decided by the user through the E-Commerce Gateway setup.
The INI.TXT output file shows the summary of the record count inserted in the CLE tables.
Once the BKMVDATA.txt file is generated, the user can read/interpret the output file with the below table.
The table denotes the start, end position of each value type for each tax authority document code. The
table also provides the total length in terms of each tax authority document code.
Tax Authority Document Code Start Position End Position Length Total Length
A100 95
Record Code 0 3 4
Future Use 4 12 9
Tax Identifier 13 21 9
Reference Key 22 36 15
Constant 37 44 8
Future Use 45 94 50
B100 317
Record Code 0 3 4
Future Use 4 12 9
Tax Identifier 13 21 9
Transaction Number 22 31 10
Transaction Line Number 32 36 5
Batch 37 44 8
Transaction Type 45 59 15
Audit Field1 60 79 20
Audit Type1 80 82 3
Audit Field2 83 102 20
Audit Type2 103 105 3
Details 106 155 50
Date 156 163 8
Effective Date 164 171 8
Account Key 172 186 15
Countra Account 187 201 15
Sign 202 202 1
Transaction Currency 203 205 3
Amount Without Vat 206 220 15
Non ILS Currency 221 235 15
Qty 236 247 12
Adjustment Reference1 248 257 10
Adjustment Reference2 258 267 10
Branch Identify 268 274 7
Update Date/Creation Date 275 282 8
User Name 283 291 9
Reference Key 292 316 25
Future Use 321 344 25
24
EMEA Add On-Whitepaper for Israel Open Format
Tax Authority Document Code Start Position End Position Length Total Length
B110 376
Record Code 0 3 4
Future Use 4 12 9
Tax Identifier 13 21 9
Account Key 22 36 15
Account Name 37 86 50
Balance Sheet Code 87 101 15
Balance Sheet Description 102 131 15
Customer/Vendor Street 132 181 50
Customer/Vendor Home Number 182 191 10
Customer/Vendor City 192 221 30
Customer/Vendor Zip Code 222 229 8
Customer/Vendor State 230 259 2
State Code 260 261 2
Summary Account 262 276 15
Beginning Balance 277 291 15
Total Dr without beginning balance 292 306 15
Total Cr without beginning Balance 307 321 15
Account Classification 322 325 4
Customer/Supplier Tax Identifier 326 334 9
Branch Identify 335 341 7
Open balance in foreign currency 342 356 15
Currency Code from the VS 357 359 3
Future Use 360 375 16
C100 444
Record Code 1 4 4
Future Use 5 13 9
Company Tax Identifier 14 22 9
Document Type 23 25 3
Document Number 26 45 20
Document Issue Date 46 53 8
Customer/Vendor Name 58 107 50
Customer/Vendor Street 108 157 50
Customer/Vendor House Number 158 167 10
Customer/Vendor City 168 197 30
Customer/Vendor Zip Code 198 205 8
Customer/Vendor State 206 235 30
Customer/Vendor State Code 236 237 2
Customer/Vendor Phone Number 238 252 15
Customer/Vendor tax identifier 253 261 9
Effective date 262 269 8
Non ILS Currency Amount 270 284 15
Document Amount without discount 288 302 15
Document Discount amount in ILS 303 317 15
Document amount with discount 318 332 15
without VAT in ILS
VAT amount in ILS 333 347 15
Document Amount including VAT in 348 362 15
receipt without WHT (in ILS)
Withholding tax amount in ILS 363 374 12
External supplier/customer number 375 389 15
Adjustment Field 390 399 10
25
EMEA Add On-Whitepaper for Israel Open Format
Tax Authority Document Code Start Position End Position Length Total Length
Canceled document (Canceled – 1) 400 400 1
Document date 401 408 8
Branch Identify 409 415 7
User name 416 424 9
Header ID 425 431 7
Future use 432 444 13
D110 339
Record Code 0 3 4
Future Use 4 12 9
Company Tax Identifier 13 21 9
Document Type 22 24 3
Document Number 25 44 20
Document Line Number 45 48 4
Document Classification 49 51 3
Document Classification Number 52 71 20
Deal Type 72 72 1
Internal Item 73 92 20
Line description 93 122 30
Vendor Name 123 172 50
Manufacturer Serial Number 173 202 30
Unit of Measure 203 222 20
Qty 223 239 17
Unit Price 240 254 15
Line discount 255 269 15
Total Line 270 284 15
Line VAT Rate 285 288 4
Branch Identify 289 295 7
Document Date 296 303 8
Header ID 304 310 7
Branch Identify 311 317 7
Future Use 318 338 21
D120 222
Record Code 0 3 4
Future Use 4 12 9
Company Tax Identifier 13 21 9
Document Classification 22 24 3
Document Number 25 44 20
Receipt Line 45 48 4
Receipt Method 49 49 1
Cheque Bank Number 50 59 10
Cheque Branch Number 60 69 10
Cheque Account Number 70 84 15
Cheque Number 85 94 10
Cheque Maturity Date 95 102 8
Line Amount 103 117 15
Clearing House 118 118 1
Credit Card Name 119 138 20
Credit Deal Type 139 139 1
Branch Identify 140 146 7
Document Date 147 154 8
Header ID 155 161 7
Future Use 162 221 60
26
EMEA Add On-Whitepaper for Israel Open Format
Tax Authority Document Code Start Position End Position Length Total Length
M100 298
Record Code 0 3 4
Record Number 4 12 9
Company Tax Identifier 13 21 9
Universal Item 22 41 20
Vendor Item 42 61 20
Internal Item 62 81 20
Item Description 82 131 50
Category Code 132 141 10
Category Description 142 171 30
Unit of Measure description 172 191 20
Item Beginning Balance 192 203 12
Item Receipts for period range 204 215 12
Item Issues for period range 216 227 12
Item cost for end of period out of 228 237 10
bondage (Inventory)
Item cost for end of period in 238 247 10
bondage (Inventory)
Future Use 248 297 50
Z900 110
Record Code 0 3 4
Future Use 4 12 9
Tax Identifier 13 21 9
Reference Key 22 36 15
Constant 37 44 8
Total qty of records in file 45 59 15
Future use 60 109 50
Post INI.txt file generation, it can be read/interpreted with the reference of two tables specified below.
The below table depicts the total length in terms of each tax authority document code.
Tax Authority Document Code Start Position
A000 466
B100 19
B110 19
C100 19
D110 19
D120 19
M100 19
Total 580
27
EMEA Add On-Whitepaper for Israel Open Format
The Following table denotes the start and end position of each value type for each tax authority document
code.
Description Length Start Position End Position
Record Code 4 0 3
Future Use 5 4 8
Total qty of records in BMKVDATA file 13 21 9
Tax Identifier 9 24 32
Reference Key 15 33 47
Constant 8 48 55
Software Registration Number 8 56 63
Software name 20 64 83
Software version 20 84 103
Tax Identifier of software manufacturer 9 104 112
Software manufacturer name 20 113 132
Software Type 1 133 133
Backup path 50 134 183
Software accounting type 1 184 184
Company registration number 9 186 194
Company Tax File 9 195 203
Future use 10 204 213
Company Name 50 214 263
Company street 50 264 313
Company location number 10 314 323
Company city 30 324 353
Company zip code 8 354 361
Tax year 4 362 365
Date Range (start) 8 366 373
Date Range (End) 8 374 381
Process start date 8 382 389
Process start time 4 390 393
Language code 1 394 394
Character set 1 395 395
Software zip code 20 396 415
Currency Code 3 416 418
Branch Information 1 419 419
Future use 46 420 465
28
EMEA Add On-Whitepaper for Israel Open Format
7. Creation of Eligible transaction for Report
Created a manual Journal in General Ledger responsibility.
29
EMEA Add On-Whitepaper for Israel Open Format
Ran the Concurrent Request Set
Upon Successful Completion verified that records were inserted into the respective back end
tables
30
EMEA Add On-Whitepaper for Israel Open Format
Submitted the Concurrent Program to generate the Flat File
31
EMEA Add On-Whitepaper for Israel Open Format
Once Completed Successfully, View the output to identify the transaction created.
32
EMEA Add On-Whitepaper for Israel Open Format
8. References
• What Are the Latest Patches for Israel Localizations? (Doc ID 1392259.1)
• How To Resolve Common Errors Encountered On CLE: Open Format Program Feature For Israel
(Doc ID 2163451.1)
33
EMEA Add On-Whitepaper for Israel Open Format