Professional Documents
Culture Documents
SUBMITTED FOR
Approvals
MD050_Al shiaka_APPLICATION_INTERFACE_FUNCTIONA_DESIGN_V01
Document Control
Change Record
4
Reviewers
Name Position
Distribution
1
2
3
4
Note To Holders:
If you receive an electronic copy of this document and print it out, please
write your name on the equivalent of the cover page, for document
control purposes.
If you receive a hard copy of this document, please write your name on
the front cover, for document control purposes.
Contents
Document Control..........................................................................................ii
Introduction.....................................................................................................1
Purpose.......................................................................................................1
1. X Store Integration with Fusion Financials.....................................2
1.1 Sales Transaction...........................................................................3
1.1.1 Process Description.......................................................................3
1.1.2 Data Mapping Requirements......................................................3
1.1.3 Business Rules...............................................................................4
1.1.4 Journal Entries;..............................................................................4
1.1.5 Assumptions..................................................................................5
1.1.6 Application Setup Requirements................................................5
1.2 Return Transaction:......................................................................6
1.2.1 Process Description.......................................................................6
1.2.2 Data Mapping Requirements......................................................6
Credit Memo..............................................................................................6
Refund........................................................................................................7
1.2.3 Business Rules...............................................................................7
1.2.4 Journal Entries...............................................................................7
1.2.5 Assumptions..................................................................................8
1.2.6 Application Setup Requirements................................................8
1.3 Sales Exchange...............................................................................9
1.3.1 Process Description.......................................................................9
1.3.2 Data Mapping Requirements....................................................10
1.3.3 Business Rules.............................................................................10
1.3.4 Journal Entries.............................................................................10
1.3.5 Assumptions................................................................................12
1.3.6 Application Setup Requirements..............................................12
1.4 Receivables Receipt.....................................................................13
1.4.1 Process Description.....................................................................13
1.4.2 Data Mapping Requirements....................................................13
1.4.3 Business Rules.............................................................................13
1.4.4 Journal Entries.............................................................................14
1.4.5 Assumptions................................................................................18
1.4.6 Application Setup Requirements..............................................18
1.5 Foreign currency:........................................................................19
Business Rule...........................................................................................51
2.12.3 Assumptions...............................................................................51
2.12.4 Application Setup Requirements............................................51
2.13 Receipt items From Laundry Transaction...................................52
2.13.1. Process Description.....................................................................52
2.13.2 Data Mapping Requirements...................................................52
Business Rule...........................................................................................53
2.13.3 Assumptions...............................................................................53
2.13.4 Application Setup Requirements............................................53
2.14 Ship sales orders from stores.........................................................54
2.14.1. Process Description.....................................................................54
2.14.2 Data Mapping Requirements...................................................54
2.14.3 Business Rule..............................................................................54
2.14.4 Assumptions.................................................................................54
2.14.5 Application Setup Requirements............................................55
3. WMS Integration with Fusion Inventory..............................................56
3.1 Receive goods In WMS...............................................................57
3.1.1 Process Description........................................................................57
3.1.2 Data Mapping Requirements.......................................................57
3.1.3 Business Rules................................................................................58
3.1.4 Assumptions................................................................................58
3.1.5 Application Setup Requirements..............................................58
3.2 Purchase Order Return in WMS.....................................................59
3.2.1. Process Description.......................................................................59
3.2.2 Data Mapping Requirements....................................................59
3.2.3 Business Rules.............................................................................59
3.2.4 Assumptions................................................................................60
3.2.5 Application Setup Requirements..............................................60
3.3 Confirm Pick Slip in WMS...............................................................61
3.3.1. Process Description.......................................................................61
3.3.2 Data Mapping Requirements....................................................61
Business Rules.........................................................................................62
3.3.3 Assumptions................................................................................62
3.3.4Application Setup Requirements..................................................62
Open and Closed Issues...............................................................................63
Open Issues..............................................................................................63
Closed Issues............................................................................................63
Introduction
Purpose
The purpose of the Business Data Architecture document is to describe the business architecture elements
that affect subsequent set up of the applications and integration between different systems. This work
product is used to assist in the
S.N Direction
Interface name
o
1 Sales Transactions Inbound
2 Sales Return Inbound
3 Sales Exchange Inbound
4 Receivables Receipts Inbound
5 Foreign Currency Sales Inbound
6 Bank Transfer Inbound
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
6. Unit Price Price Alphanumeri Oracle
c
7. Amount Total Amount Alphanumeri Oracle
c
8. Currency NA Alphanumeri Oracle
c
9. Customer Name Customer Name Constant Oracle Walking Customer
10. Payment Terms NA Constant Oracle Immediate
11. Item Item_ID Numeric Oracle
12. Item Description Item_Desc Alphanumeri Oracle
c
13. UOM UOM Alphanumeri Oracle
c
14. PO Number Trans_Sequence Alphanumeri Oracle Combination (Store ID + Reg
c ID + Date + TRX Seq)
15. PO Date Business_Date Date Oracle
Dr. Receivables
Dr. Discount (if any)
Cr. Revenue
Cr. Tax
1.1.5 Assumptions
- No Assumptions.
Credit Memo
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
1. Business Unit Organization ID Alphanumeri Oracle
c
2. Transaction Source NA Constant Oracle X-Store Imported TRX
3. Transaction Type Store ID Alphanumeri Oracle CM-Store ID
c
4. Transaction Date Transaction Date Oracle
Date
5. Units Qty Alphanumeri Oracle In Minus
c
6. Unit Price Price Alphanumeri Oracle
c
7. Amount Total Amount Alphanumeri Oracle Immediate
c
8. Currency NA Alphanumeri Oracle
c
9. Customer Name Customer Name Constant Oracle Cash Customer
10. Payment Terms NA Alphanumeri Oracle
c
11. Item Item_ID Numeric Oracle
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
12. Item Description Item_Desc Alphanumeri Oracle
c
13. UOM UOM Alphanumeri Oracle
c
14. PO Number Trans_Sequence Alphanumeri Oracle Combination (Store ID + Reg
c ID + Date + TRX Seq)
15. PO Date Business_Date Date Oracle
Refund
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
1. Business Unit Organization ID Alphanumeri Oracle
c
2. Refund Amount Total Amount Numeric Oracle
3. Refund Date Transaction Date Oracle
Date
4. Accounting Date Transaction Date Oracle
Date
5. Refund Payment NA Alphanumeri Oracle Cash
Method c
Cr. Receivables
Cr. Discount (If any)
Fusion Refund:
Dr. Receivables
Cr. Refund (Clearing Account)
Fusion AP invoice:
Dr. Refund (Clearing Account)
Cr. Liability
1.2.5 Assumptions
- No Assumptions.
1- Return = Sales:
Ex. When the customer returns item with 100 SAR and buys another one for 100 SAR.
We will create a credit memo for the return and create an invoice for the new sales transaction with the
same PO number.
Then will apply the credit memo on the new invoice created.
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
e
Fusion AR Invoice:
Dr. Receivables
Dr. Discount (if any)
Cr. Revenue
Cr. Tax
Fusion AR Invoice:
Dr. Receivables
Dr. Discount (if any)
Cr. Revenue
Cr. Tax
Fusion Refund:
Dr. Receivables
Cr. Refund (Clearing Account)
Fusion AP Invoice:
Dr. Refund (Clearing Account)
Cr. Liability
Fusion AR Invoice:
Dr. Receivables
Dr. Discount (if any)
Cr. Revenue
Cr. Tax
Fusion AR Receipt:
Dr. Cash (will change based on tender type)
Cr. Receivables
1.3.5 Assumptions
- No Assumptions.
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Cash
Cr. Receivables
2- Visa, Mada, Span, Amex, Master Card, STC Pay, Apple Pay Tender Types:
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Bank Receivable Clearing Account
Cr. Receivables
Reconciliation (Fusion):
Dr. Bank
Cr. Bank Receivable Clearing Account
AlShiaka gives Coupons to their guests, to be used in one-time purchase from the showrooms;
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Marketing Expenses Account
Cr. Receivables
There is some customers i.e. ( جمعية البر،)عبد اللطيف جميل, that can purchase some vouchers from Alshiaka and
distribute it to some other people who use it in purchasing process from showrooms.
In this case, the main customer ( جمعية البر،)عبد اللطيف جميل, pays the amount in HQ so the AR Receipt will be
created directly from Fusion manually and will be applied manually on the invoices which will be flown
from Xstore.
All the sales transactions that will be done in Xstore using the Vouchers will have the main customer
name attached to it in order that the integration can flow the transaction on the same customer in Fusion.
If the walking customer pays using the STC Points or Apple points, the sales transaction should flow to
Fusion normally using the walking Customer attached to the invoice.
A dummy bank account will be created for STC and Apple that will be linked to their liability accounts.
Invoice and receipt will be created by integration, and receipt write off will be created as per the
commission percentage created on the DFF on the bank account.
The receipt will hit the STC bank account and GL liability account.
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. STC liability account
Dr. Commission (write off)
Cr. Receivables
AR invoice (Manual) at the end of the month:
Dr. Receivables
Cr. STC liability account
Receipt (Manual) at the end of the month:
Dr. Cash
Cr. Receivables
6- Loyalty points;
The loyalty points will be calculated and maintained in customer engagement then Xstore, no
calculations or points will be maintained in Fusion.
We will create a dummy bank account for redeeming the loyalty points.
A report from Xstore and Customer engagement (showing the new loyalty liability amounts added or
expired) should be submitted on monthly basis in order that a manual journal could be entered as per
this report
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Provision for loyalty points
Cr. Receivables
At the end of the month (Fusion GL Manual, based on a report from customer engagement)
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Employee Free Allowance
Cr. Receivables
8- Staff Discount
Fusion AR Invoice:
Dr. Receivables
Dr. Discount
Cr. Revenue
Receipt:
Dr. Cash
Cr. Receivables
1.4.5 Assumptions
- No Assumptions.
1.5.4 Assumptions
- No Assumptions.
1.6 E-Commerce
Invoices
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
1. Business Unit Organization ID Alphanumeri Oracle
c
2. Transaction Source NA Constant Oracle X-Store Imported TRX
3. Transaction Type Store ID Alphanumeri Oracle IN-Store ID
c
4. Transaction Date Transaction Date Oracle
Date
5. Units Qty Alphanumeri Oracle
c
6. Unit Price Price Alphanumeri Oracle
c
7. Amount Total Amount Alphanumeri Oracle
c
8. Currency NA Alphanumeri Oracle
c
9. Customer Name Customer Name Constant Oracle Walking Customer
10. Payment Terms NA Constant Oracle Immediate
11. Item Item_ID Numeric Oracle
12. Item Description Item_Desc Alphanumeri Oracle
c
13. UOM UOM Alphanumeri Oracle
Field Fusion Field Name X Store Field Type Owner Default Value Comments
No Name
c
14. PO Number Trans_Sequence Alphanumeri Oracle Combination (Store ID + Reg
c ID + Date + TRX Seq)
15. PO Date Business_Date Date Oracle
Receipts
Field Fusion Field Name X Store Field Name Type Owner Default Comments
No Value
1. Business Unit Organization ID Alphanumer Oracl
ic e
2. Receipt Method Tender Type Alphanumer Oracl Cash-Store ID
ic e
3. Receipt Number (Authorization Alphanumer Oracl Transaction Number in
Code) ic e case of Cash.
4. Amount Total amount of Numeric Oracl
the transaction. e
5. Receipt Date Transaction Date Date Oracl
e
6. Customer Customer Name Alphanumer Oracl Walking
ic e Customer
7. Applied Transaction X Store transaction Alphanumer Oracl
number ic e
8. Currency Currency
- The Shipping Company will be defined as a dummy bank and linked to its liability account, which will be cleared by
creating a payable invoice in the AP and payment.
- The Shipping Company will be defined also as a supplier.
- The shipping charges will be interfaced to Fusion as an amount in a separate line in Fusion with type freight.
- A DFF will be created on the dummy bank to maintain the commission percentage, which will be paid to the shipping
company, in order to generate a report which can help in calculating the shipping company commission.
Recording the amount needed from the shipping company based on a report at the end of the month:
AR invoice Manual:
Dr. Receivables (Aramex)
Cr. Aramex Liability Account
Credit memo to record the Shipping commission at the end of the month
Dr. Aramex Shipping Commission
Cr. Receivables (Aramex)
AR Receipt to receive the net from the shipping company at the end of the month
Dr. Cash
Cr. Receivables
Invoice:
Dr. Receivables
Cr. Revenue
Receipt:
Dr. Bank Receivable Clearing Account
Cr. Receivables
Reconciliation (Fusion):
Dr. Bank
Cr. Bank Receivable Clearing Account
1.6.5 Assumptions
- No Assumptions.
Field Fusion Field Name X Store Field Name Type Owner Default Comments
No Value
1. Business Unit Organization ID Alphanumer Oracl
ic e
2. Receipt Method Tender Type Alphanumer Oracl Cash-Store ID
ic e
3. Receipt Number (Authorization Alphanumer Oracl Transaction Number in
Code) ic e case of Cash.
4. Amount Total amount of Numeric Oracl
the transaction. e
5. Receipt Date Transaction Date Date Oracl
e
6. Receivable Activity None Constant Oracl Bank
e Deposit
7. Currency Currency
1.7.5 Assumptions
- No Assumptions.
2.1.1Process Description
Whenever Item is created/updated/ Inactivated in specific inventory organizations in Oracle fusion, the records will get populated to X Center which
will then be replicated automatically to X Store POS to be available for sales and other transactions in the respective store defined in the X Store POS
and mapped to the Inventory organization available in fusion
2.1.3Business Rules
Interface Mode:
Create: If a new item is created, to be newly interfaced to X Store
Update: if any of the major attributes is updated in fusion, then the updated values to be synchronized to X Store
a) Description
b) Category
c) Color
d) Size
e) Additional attribute
f) Item lot
Delete: if the item status is updated to “Inactive” in Oracle fusion, then same item should be deactivated in X Store
2.1.4Assumptions
All mandatory attributes of the items must be first defined, in order for the item to be interfaced to X Store including:
1- Item Definition: Item Code – Description – UOM – Customer Order enabled-item additional attribute –shippable…)
2- Categories assignments for the item
3- Organization (Branch) assignment (item should at least be assigned to one Inventory Organization)
4- Store ID in X Store will be mapped in a DFF on the inventory Organization definition
5- When an item assigned to different organization, there should be separate record for each organization, other field cannot be the same.
For example opening balance will be considered as an X store integration and will update x store on hand at the same time x Store return will not be
considered as an X Store integration to prevent looping it again to x store. So we do not recommend to do any transaction related to X store from oracle fusion
Examples:
Misc. transaction directly created in Fusion
It can be increment or decrement to on-hand
Physical Inventory (adjustment)
It can be increment or decrement to on-hand
It is done on daily, weekly and monthly basis
2.2.4 Assumptions
DFF will be defined on the sub inventories to flag the sub inventories for which this web service should consider its
transactions
1- PO Receiving
2- IMT ‘Internal Material Transfer’ from MWH
3- Receiving of Shipments from Other Stores
Once the Store manager receives the transferred items in X Store (populated from the previous web service) then this receiving transaction will be populated
to oracle fusion as a final receiving transaction (Put Away transaction)
2.3.4 Assumptions
N/A
2.
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1. Purchase order number PO Number Number
2. Purchase Order Line PO Line Number
3. Item Number Item ID Alpha
Numeric
4. Quantity Qty Number
5. Lot number Lot Number Alpha
Numeric
6. Expiry Date Expiry Date Date
7. Unit of Measure UOM Alpha
Numeric
8. Return to Return to Alpha Supplier/receiving Area
Numeric
9. Return Date Return Date Date
10. Integration STATUS Status Alpha
(Pending/Processed/Error) Numeric
11. Error reason Alpha
Numeric
2.4.4 Assumptions
After return process purchase order will back to status open again
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1. Shipment number Shipment number Alpha
Numeric
2. Shipped quantity Transaction quantity number
3. Item Code Item ID Alpha
Numeric
4. Lot Number Item lot
5. Expiry Date Expiry date Date
6. UOM UOM Alpha Primary
Numeric
7. Quantity Quantity Number
8. Transaction date Transaction Date Date
9. Source Sub inventory Source Sub inventory Alpha
Numeric
10. Distention Sub inventory
2.5.4 Assumptions
4.
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1. Transfer Order Number Request Number Available only in case of manual IMT
Number raised by X store.
Not Available in case of Automatic
replenishment (MIN-MAX).
2. Transfer Order Line Number Line Number Number
3. Supply Type Transfer
4. Item Number Item ID Alpha
Numeric
5. Quantity Qty Numeric
6. Unit of Measure UOM Alpha
Numeric
7. Source Organization Store ID Alpha
(Warehouse) Numeric
8. Destination Organization Store ID Alpha
(Requesting Numeric
Store)
9. Destination Sub inventory Store (Store ID) Store
Code
10. Requisition Date Transfer Date Date
11. Preparer Alpha Default
Numeric
12. Supply Order Reference Line NA
13. Integration STATUS Status Alpha
(Pending/Processed/Error) Numeric
14. Error reason NA
2.6.4 Assumptions
Inter- organization must to be defined between main warehouse and all stores
5.
Field Fusion Field Name X Store Field Name Type Owner Default Comments
No Value
Shipment number Shipment number Alpha
1.
Numeric
2. Shipped quantity Transaction quantity Number
Item Code Item ID Alpha
3.
Numeric
Lot Number Item lot Alpha
4.
Numeric
5. Expiry Date Expiry date Date
UOM UOM Alpha Primary
6.
Numeric
7. Quantity Quantity Number
8. Transaction date Transaction Date Date
Source Org & Sub Source Sub inventory Alpha
9.
inventory Numeric
Distention org & Sub Distention Sub inventory Alpha
10.
inventory Numeric
2.7.4 Assumptions
Inter- organization must to be defined between main warehouse and all stores
6.
Business Rules
Lot number and expiry date, need to be selected from X store from the “Issuing” Organization.
One price list will be defined in oracle fusion and Prices will be maintained in X store
2.8.2 Assumptions
No Assumptions
Business Rules
One price list will be defined in oracle fusion and Prices will be maintained in X store
2.9.3 Assumptions
No Assumptions
1.
2.10.4 Assumptions
N/A
N/A
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1 Transaction Number Transaction
Number
2 Transaction Gifts
Type(Gift and
adjustment )
3 Source Sales Accounting
(Account Alias
Name)
4 Organization Store ID
5 Item Code Item ID
6 Lot Number Item Lot
7 Expiry Date Expiry Date
8 UOM UOM
9 Sub inventory Sub inventory Normal
10 Quantity quantity
Business Rule.
2.11.3 Assumptions
No Assumptions
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1 Transaction Number Transaction
Number
2 Transaction Laundry issue
Type(issue to
laundry)
3 Source Issue Accounting
(Account Alias
Name)
4 Organization Store ID
5 Item Code Item ID
6 Lot Number Item Lot
7 Expiry Date Expiry Date
8 UOM UOM
9 Sub inventory Sub inventory Normal
10 Quantity quantity
Business Rule.
2.12.3 Assumptions
No Assumptions
Receipt transaction will be raised in X Store, then the same transaction will be interfaced to oracle as a miscellaneous Receipt and will increase
item on hand (balance) with transaction quantity
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
1 Transaction Number Transaction
Number
2 Transaction Laundry Receipt
Type(Receipt from
Laundry)
3 Source Issue Accounting
(Account Alias
Name)
4 Organization Store ID
5 Item Code Item ID
6 Lot Number Item Lot
7 Expiry Date Expiry Date
8 UOM UOM
9 Sub inventory Sub inventory Normal
10 Quantity quantity
Business Rule.
2.13.3 Assumptions
No Assumptions
Field Fusion Field Name X Store Field Type Owner Default Comments
No Name Value
Sales order Number Transaction
1
Number
2 Shipment number
4 Organization Store ID
5 Item Code Item ID
6 Lot Number Item Lot
7 Expiry Date Expiry Date
8 UOM UOM
9 Sub inventory Sub inventory Store
10 Quantity quantity
Sales order will be created in main warehouse and shipping will be from stores
2.14.4 Assumptions
No Assumptions
Once the Store manager receives items in MWS (populated from the previous web service) then this receiving transaction will be populated to oracle fusion as
a final receiving transaction (Put Away transaction)
3.1.4 Assumptions
N/A
7.
Field Fusion Field Name WMS Field Type Owner Default Comments
No Name Value
1 Purchase order number PO Number
2 Purchase Order Line PO Line
3 Item Number Item ID
4 Quantity Qty
5 Lot number Lot Number
6 Expiry Date Expiry Date
7 Unit of Measure UOM
8 Return to Return to Supplier/receiving Area
9 Return Date Return Date
10 Integration STATUS Status
(Pending/Processed/Error)
11 Error reason
3.2.4 Assumptions
After return process purchase order will back to status open again
8.
Field Fusion Field Name WMS Field Name Type Owner Default Comments
No Value
1 Pick slip Number Transaction
Number
2 Organization Store ID
3 Item Code Item ID
4 Picked Quantity Quantity
5 Lot Number Item Lot
6 Expiry Date Expiry Date
7 UOM UOM
8 Source Sub inventory Sub inventory Normal
Business Rules
Lot number and expiry date, need to be selected from X store from the “Issuing” Organization.
One price list will be defined in oracle fusion and Prices will be maintained in X store
3.3.3 Assumptions
No Assumptions
Open Issues
Closed Issues