Skip Headers
Oracle® Invoice Matching Operations Guide
Release 13.2.9
E73506-01
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

7 PeopleSoft Enterprise Financials Integration

This chapter describes the integration between Oracle Retail systems and PeopleSoft Enterprise Financials, as developed and supported by Oracle Application Integration Architecture (AIA).

When the option to integrate is chosen, selected information is shared among the systems. Integration and validation services are in place to ensure the shared data matches.

The primary benefit of this integration is that clients can "drill forward" or "drill back" between the systems to research the outcome--or origin--of financial transactions. Drilling functionality is facilitated by an AIA layer, which maps, retrieves and routes information called by each system.


Note:

This chapter addresses the points within Oracle Retail systems that are essential to integration. For more information about the entire integration process, including mapping to PeopleSoft Enterprise Financials data and settings, see the AIA document, Oracle Retail Merchandising Integration Pack for PeopleSoft Enterprise Financials 2.5 - Implementation Guide. For more information about Web services, see the following chapters in the Oracle Retail Merchandising System Operations Guide, Volume 2: "Service Provider Implementations API Designs" and "Web Services."

Participating Applications

The following applications are included in the integration covered by this chapter:

  • Oracle Retail Merchandising System (RMS)

  • Oracle Retail Sales Audit (ReSA)

  • Oracle Retail Invoice Matching (ReIM)

  • Oracle Retail Integration Bus

Assumptions and Dependencies

  • The option to integrate should be selected during initial setup of the RMS system.

  • ReIM accesses RMS to determine if integration is active. Initial setup of RMS must occur prior to the integration of ReIM.

  • When a PeopleSoft user performs a drill back, data is presented through an Oracle Business Intelligence Publishing report.

  • When drilling forward to PeopleSoft Enterprise Financials, users have view-only access.

  • The URLs for the AIA Web services that are anecessary for this integration must be maintained in the RMS_RETAIL_SERVICE_REPORT_URL table and in the ReIM integration.properties file.

  • Real time account validation is done only when the financial integration with PeopleSoft Enterprise Financials is ON.

  • Partners must be set up as suppliers in PeopleSoft. Then the partner must be manually set up in RMS using the RMS Supplier ID that was generated when the PeopleSoft supplier was interfaced to Oracle Retail. Partner functionality within RMS and ReIM can then proceed normally. The RMS supplier generated as part of this process is not used.

Data Constraints

  • The Location ID field is restricted to eight characters, to accommodate PeopleSoft Operating Unit, which has a maximum of eight characters.

  • The Ext_Doc_ID field is restricted to 30 characters, because the corresponding PeopleSoft field has only 30 characters. Characters beyond 30 are truncated.

  • RMS allows for four decimals, and PeopleSoft allows only three. Truncation may occur when data is passed to PeopleSoft Enterprise Financials.

  • ReIM values in the IM_CURRENCY_LOCALE are restricted to three decimals, because the corresponding PeopleSoft Enterprise Financials field can accept no more than three decimal positions.

Data Setup

Integration of Oracle Retail and PeopleSoft Enterprise Financials relies on synchronization of essential data, such as rates and terms. Through careful discussions, users of both systems determine the common codes and descriptions that will best serve their business needs.

Once agreement is reached, this information is set up and maintained. Depending on volume, some shared information is set up in either Oracle Retail or PeopleSoft Enterprise Financials-and electronically transferred to the other system. Otherwise, shared information is set up manually within each system, and users of both systems must ensure that codes and descriptions match.

RMS Data Setup and Configuration

The following is information about RMS data setup and configuration.

RMS System Options

As part of the RMS system options setup, set the following options as indicated:

  • FINANCIAL_IND = Y

This system_option indicates that the Oracle Retail system is integrated with a financial system:

  • FINANCIAL_AP = A

A value of A indicates that the financial system to which RMS is interfaced is Oracle Peoplesoft Enterprise Financials through Oracle Application Integration Architecture (AIA).

  • GL_ROLL_UP can be D/S/C

  • MULTIPLE_SET_OF_BOOKS_IND = Y

  • SUPPLIER_SITE_IND = Y

  • ORG_UNIT_IND = Y

Organization Units

Use the Organizational Unit window (RMS Start Menu > Control > Setup > Org Unit >Edit) to define organizational units in RMS that match those being set up in Peoplesoft Enterprise Financials. When an organizational unit is entered in RMS, the valid organizational units are those that are associated with the set of books (SOB) that is being used for the general ledger interface.

Currency Exchange Rates

Currency exchange rate is used to translate the monetary value of one currency in terms of another. Depending on business needs, a Currency Exchange Rate Type of Operational or Consolidation is selected for use in all transactions.

This value is set up manually in RMS and mapped to PeopleSoft Enterprise Financials through the Currency Exchange Type mapping Window. Currency Exchange Rate data is owned by PeopleSoft Enterprise Financials, and updates are sent to Oracle Retail applications.

Determine the Exchange Type being sent by Oracle PeopleSoft Financials (for example, Consolidation or Operational) that you want RMS to use. Then update the FIF_CURRENCY_XREF for mapping the external exchange type being sent by Oracle Peoplesoft Financials with RMS Exchange Type.

For example, for Consolidation and Operational exchange types, the FIF_CURRENCY_XREF table holds the following entries:

FIF_EXCHANGE_TYPE RMS_EXCHANGE_TYPE

C

C

O

O


Supplier Address Types

Within RMS, supplier information (such as Order From and Remit To addresses) is used in generating purchase orders. PeopleSoft uses supplier information for payment generation. It is important, then, that this information is synchronized.


Suppliers are created in Peoplesoft Enterprise Financials and exported to RMS. When FINANCIAL_AP is set to A, suppliers cannot be created using the RMS forms. However, after the supplier exists in RMS, all data values for the supplier (except supplier name and status) continue to be updated using the RMS forms. The association of supplier sites to organization units is accessed only in view mode through RMS forms. One supplier site per supplier organization unit combination can be marked as primary payment site.

Where SYSTEM_OPTIONS.FINANCIAL_AP is A, disable auto generate supplier/partner numbers and associated check boxes.


Note:

Supplier information is created, updated and inactivated only in the PeopleSoft Enterprise Financials accounting system. This information is transferred from PeopleSoft Enterprise Financials to Oracle Retail, where additional retail-specific attributes may be maintained.

Country Codes

When country codes are defined and seeded in RMS, ensure that country codes are mapped to PeopleSoft country codes through AIA DVM mapping. The following is an example of AIA DVM Mapping for COUNTRY_CODE:

COUNTRY_CODE
PSFT_01 COMMON RETL_01

USA

700

US

CAN

701

CA



Note:

For more mapping examples, see "AIA DVM Mapping Examples" later in this chapter.

Financial Calendar

The financial calendar within Oracle Retail systems is manually set up and maintained separately from the PeopleSoft financial calendar.

Freight Terms

A freight term is an agreement between the retailer and a supplier regarding transportation charges for goods delivered by the supplier. Freight terms are used by RMS as purchase orders are generated.

Within the RMS system, freight terms are set up and maintained manually. They also are maintained in PeopleSoft Enterprise Financials.

Payment Terms and Currency Exchange Rates

This data is created and updated in Oracle Peoplesoft Financials and exported to RMS. It is not created or updated in RMS.

PeopleSoft Enterprise Financials Org Units and Site IDs

The data concepts of Org Units and Site IDs in RMS mirror the data maintained in Oracle PeopleSoft Enterprise Financials. RMS forms are used to manage and view Oracle Org Units and Site IDs. The RMS windows for Store and Warehouse maintenance allows for the association of each store and warehouse with an Org Unit. The following is an example of the Organizational Unit form:


Store and Warehouse Maintenance

The organizational unit is found on the Store Maintenance and Warehouse forms, which allow the PeopleSoft Enterprise Financials operating unit to be associated with the store or warehouse. When RMS is set up for single-channel operation, the organizational unit is set at the physical warehouse level. When RMS is set up for multi-channel operation, the organizational unit is set up at the virtual warehouse level. Financial sales audit and inventory information can then be identified through interface routines and posted to the appropriate general ledger accounts. An organizational unit must be designated for each store and warehouse location in RMS. The following are examples of the Store Maintenance and Warehouse Maintenance forms:


Note:

When working with PeopleSoft Enterprise Financials, be sure to create locations names (such as stores, WH, and virtual WH) with eight or fewer characters. Locations in Oracle Retail applications are mapped to Operating Unit in PeopleSoft Enterprise Financials, where operating unit cannot exceed eight characters.



RMS General Ledger Setup

Within RMS and ReSA, manual setup is required for the initial load of chart of accounts information, including valid segment combinations of Chart of Accounts segment/ChartField values for each business unit. Valid segment combinations are created and stored in general ledger cross reference tables. Once setup is complete, transaction data can be assigned to specific account codes.

Ongoing maintenance of Chart of Accounts information (such as adding, changing or deleting segment/ChartField values) also is completed manually. Any segment combination that is valid in Oracle Retail applications also must be valid in PeopleSoft Enterprise Financials. In this regard, PeopleSoft Enterprise Financials is the system of record, in that it verifies segment combinations created or updated within Oracle Retail. PeopleSoft Enterprise Financials issues a message when an Oracle Retail segment combination is invalid, and the retail user must correct the appropriate cross reference table.

The RMS table FIF_GL_SETUP holds the PeopleSoft Enterprise Financials Set of Books IDs to post financials. This table requires manual setup after the Set of Books IDs are determined. Where system indicator Multiple Set of Books ID is set to N, FIF_GL_SETUP must hold a single Set of Books (SOB )record.

The Set of Books IDs is associated with the chart of accounts when setting up general ledger cross reference.

RMS General Ledger Cross Reference

Navigate: RMS main menu > Finance> GL Cross Reference. The General Ledger Search window opens. Map Chart of Accounts to department, class, subclass, set of books, location, and transaction codes using the GL cross reference form in RMS.


ReSA General Ledger Cross Reference

Navigate: ReSA main menu > Action > Sales Audit > Control > Setup > GL Account Maintenance. The General Ledger Search Form window opens. Where SYSTEM_OPTIONS.FINANCIAL_AP is A, the form requires the entry of valid segment combinations.


Configuring Drill Back and Forward Web Services

Retail web services table, RETAIL_SERVICE_REPORT_URL, must be updated with appropriate URLs to integrate with PeopleSoft Enterprise Financials.

  • The records in the table for Services (indicated by RS_TYPE=S) for Account Validation (RAV) and Drill Forward (RDF), must be updated with the URL information from AIA where the services are hosted.


    Note:

    If Web services are secure, then the SYS_ACCOUNT column must be populated with authentication information in the form of user name/password.

  • The records in the table for Reports (indicated by RS_TYPE=R) for both RMS and ReIM reports , must be updated with the URL information from the BIP Server where the reports are hosted.

ReIM Data Setup and Configuration

This section discusses data setup and configuration.

System Options

As part of the RMS system options setup script, set the following options as indicated:

  • FINANCIAL_IND = Y

  • FINANCIAL_AP = A

As part of the ReIM system options setup script, DEFAULT_PAY_NOW_TERMS should be updated with the default term ID.


IM_CURRENCY_LOCALE

Because PeopleSoft Enterprise Financials uses only three decimals, the transactions generated by the Oracle Retail ReIM application must not include more than three decimals.

Update im_currency_locale set currency_cost_dec=3.

Prerequisite: The currency_rates table in RMS should be loaded initially by PeopleSoft Enterprise Financials.

Chart of Accounts Setup

The chart of accounts is set up manually in Oracle Retail applications and in PeopleSoft Enterprise Financials. All account combinations are set up in each Set of Books. The following is an example of the GL Cross Reference screen:



Note:

Chart of Accounts is updated in Oracle Retail applications only after the account is validated through PeopleSoft Enterprise Financials.

Segment Mapping

The retailer determines how many segments are populated. Up to 20 account segments may be specified. The following is an example of how segments are mapped between the ReIM transaction table and PeopleSoft Enterprise Financials:

ReIM Segments PeopleSoft Enterprise Financials Fields

Segment 1

PRODUCT

Segment 2

ACCOUNT

Segment 3

ALTACCT

Segment 4

OPERATING_UNIT

Segment 5

FUND_CODE

Segment 6

DEPTID

Segment 7

PROGRAM_CODE

Segment 8

CLASS_FLD

Segment 9

BUDGET_REF

Segment 10

BUSINESS_UNIT_PC

Segment 11

PROJECT_ID

Segment 12

ACTIVITY_ID

Segment 13

RESOURCE_TYPE

Segment 14

RESOURCE_CATEGORY

Segment 15

RESOURCE_SUB_CAT

Segment 16

CHARTFIELD1

Segment 17

CHARTFIELD2

Segment 18

CHARTFIELD3

Segment 19

AFFILIATE

Segment 20

AFFILIATE_INTRA1


If any one of the values in the 20 segments does not match the corresponding PeopleSoft field value, the account combination is considered invalid. The following error message is issued to the user: "Account combination is invalid in the financial system."

Segments 1 and 2 may be set up as dynamic at the Location level, or Segments 4 and 5 can be dynamic at the Department and Class level respectively. Segments defined as dynamic are allowed to be null for certain types of Basic Transaction or Reason Code cross-reference types. When a segment is null, the segment is assigned dynamically when transactions are posted. (Non-dynamic segments cannot be blank.) Validation applies to the segment combination, not to individual segments.


Note:

For Tran code TAP, all segments must have a value regardless of whether the segment is dynamic.

Running the Initial Load from PeopleSoft Enterprise Financials

The initial load for ReIM is run by PeopleSoft Enterprise Financials and includes the following information:

  • Suppliers

  • Payment Terms

  • Currency Rates


Note:

The view, mv_currency_conversion_rates should be refreshed once the initial loads of currencies from PeopleSoft Enterprise Financials are loaded to ReIM.

integration.properties File Setup

To accommodate integration, the integration.properties file within ReIM must be updated with the appropriate URLs for the account validation and drill forward Web services, as listed below:

#webservice provider URL for drill forwardwebservice.financial.drill.forward=@webservice.drill.forward@#webservice provider URL for account validationwebservice.financial.account.validation=@webservice.account.validation@  #webservice username and password for account validationwebservice.financial.account.validation.username=@webservice.account.validation.username@webservice.financial.account.validation.password=@webservice.account.validation.password@

Reporting

Reports are created by Business Intelligence Publisher for the following:

  • Merchandise Invoice

  • Non-Merchandise Invoice

  • Credit Note

  • Credit Memo

  • Debit Memo

  • Receipt Write-Off

The URL for each report must be updated in the table, retail_service_report_url. The following table provides sample URLs:

Document Type Report Name Sample Report URL

MRCHI

Merchandise invoice document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/invreport.xdo

NMRCHI

Non-Merchandise invoice document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/invreport.xdo

CRDNT

Credit Note document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/crnreport.xdo

CRDMEC

Credit Memo cost document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/memoreport.xdo

CRDMEQ

Credit Memo quantity document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/memoreport.xdo

DEBMEC

Debit Memo cost document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/imemoreport.xdo

DEBMEQ

Debit Memo quantity document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/memoreport.xdo

DEBMEV

Debit Memo Tax document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/memoreport.xdo

RWO

Receipt Write Off document Report

http://mspdv126.us.oracle.com:7777/xmlpserver_nonsso/

Guest/REIM13/Finance/invreport/rworeport.xdo


ReIM Transactional Maintenance

Integration to PeopleSoft Enterprise Financials includes a number of transactions, as described below.

Calculation of TRANS_AMOUNT

The TRANS_AMOUNT field in the im_financial_stage table stores the value of the journal entry to be posted to PeopleSoft Enterprise Financials. (The currency for the calculated amount is the currency assigned to the transaction.) The TRANS_AMOUNT value is calculated as follows:

Row Description DEBIT_CREDIT_IND TRANS_AMOUNT Value

Normal

Debit

Transaction Amount

Normal

Credit

(-1) * Transaction Amount

VAT

Debit

Transaction Amount * TaxRate

VAT

Credit

(-1) * Transaction Amount * Tax Rate



Note:

Transaction Amount is taken from the database column, IM_FINANCIALS_STAGE.AMOUNT.

Generation of Outgoing Data

A staging table accommodates the outgoing transfer of data. The reference key assigned to each document or receipt is used to find data on this table.

Outgoing Data

From To Transactions

ReIM

PeopleSoft Accounts Payable

InvoicesDebit MemosCredit MemosCredit Notes

ReIM

PeopleSoft General Ledger

General Ledger accounting entries resulting from the Invoice Matching process, including:Pre-paid invoicesReceipt Write-offs

RMS

PeopleSoft General Ledger

Accounting entry data (potentially very high volume)

ReSA

PeopleSoft General Ledger

Accounting entry data (potentially very high volume)


Validation of Accounts When Posting Financial Entries

Valid accounts are stored in the ReIM table, IM_VALID_ACCOUNTS, which includes the Set of Books ID (sob_id) and 20 segments. An AIA Web service validates accounts against the PeopleSoft Enterprise Financials system. Valid accounts are posted to IM_VALID_ACCOUNTS; invalid accounts are posted to IM_POSTING_DOC_ERROR. The following steps describe the validation process:

  1. The ReIM system invokes the account validation Web service to validate the account. (A URL for the AIA Web service is configured in the integration.properties file.)

  2. The posting batch job checks the accounts to be posted against the IM_VALID_ACCOUNTS table.

  3. If the account entries are in the table, the transaction is posted to the G/L or AP tables.

  4. If the account does not exist in the table, a collection of accounts is built. These collected accounts are validated against the PeopleSoft Enterprise Financials system, and a status is returned.

    • If the status of the collected accounts is valid, the accounts are inserted in the IM_VALID_ACCOUNTS table, and the transactions are posted to the staging tables.

    • If the status of the accounts is NOT valid, the entire collection is flagged as errors, and transactions are postedto IM_POSTING_DOC_ERROR.


Note:

ReIM completes the first level of account validation and posts the transaction to staging tables. It is assumed the second level of account validation is done at the end of the extraction process (where transactions are moved from ReIM staging tables to PeopleSoft). If account validation fails at this point, Oracle Data Integrator (ODI) or PeopleSoft must change the account information before transactions are loaded to PeopleSoft, and the account change must be communicated to ReIM .

Maintenance of Valid Accounts

As account information is changed in the PeopleSoft system, the same changes are communicated to, and manually completed in, the ReIM system. After ReIM is updated accordingly, the AccountPurge Batch is run to clear the valid accounts maintained locally in ReIM.

The AccountPurge Batch can clear all valid accounts in the IM_VALID_ACCOUNTS table or only those that are considered updates in PeopleSoft.

Usage:

AccountPurge batch-alias-name  PURGE [ALL | <Accounts>]

Where

The first argument is batch alias name.

The second argument is the word PURGE.

The third argument is either ALL or specific accounts to be deleted from the local table.

Building and Posting Reference IDs

Drill back and drill forward functionality uses Reference ID to locate documents and receipts. A Reference ID is a combination of document type and document (or receipt) ID, as illustrated in the table below:

Type Doc ID Receipt ID Reference ID

Merchandise Invoice

101

Null

MRCHI#101

Non-Merchandise Invoice

102

Null

NMRCHI#102

Receipt

Null

103

RECEIPT#103


For documents, the Resolution Posting Batch program builds the Reference ID using the standard, Document Type + DeLimiter + Doc_id. For receipts, the program builds the Reference ID using the standard, Document Type + DeLimiter + Receipt_id.

To enable drill down functionality, Reference IDs are loaded to staging tables. FinancialsAPStageDao and FinancialsGLStageDao are populated, as are IM_RWO_SHIPMENT_HIST and IM_RWO_SHIPSKU_HIST.

Drilling Back to RMS, ReSA and ReIM - Overview

Drilling back allows users to view the source of posted PeopleSoft transactions that originated in Oracle Retail systems (from a voucher to an invoice, for example).

When drilling back from PeopleSoft Enterprise Financials, users are not directed to an actual screen within RMS, ReIM or ReSA. Rather, a retail Web service generates and launches a URL to a BI Publisher report. The report contains the information that typically appears on the appropriate retail screen.

Depending on the information requested by the user, the AIA layer maps a common ID (for example, Transaction ID or Document ID) to the appropriate retail application. As part of the extraction process, the Reference_ID in the staging tables is considered the retail key, which is sent to AIA. The AIA layer invokes the retail exposed Web service for the BI Publisher report URL using a common function like the following:

GET_REPORT_URL() -     O_error_message     IN OUT     RTK_ERRORS.RTK_TEXT%TYPE     O_rpt_url           IN OUT     RETAIL_SERVICE_REPORT_URL.URL%TYPE     I_ref_key           IN         KEY_MAP_GL.REFERENCE_TRACE_ID%TYPE

Information from the reference key determines what kind of report URL to issue. For example, if the retail key has a prefix of RMS, the RMS_REPORT_URL function is called. Similarly, if the retail key has a prefix of ReIM, the ReIM_REPORT_URL function is called to retreive the appropriate ReIM URL. If the key does not have a prefix (or does not match any key in the retail systems), an error message is launched.

Drilling Back to RMS and ReSA - Detail

The following function determines which RMS report to return to the user:

RMS_REPORT_URL() -     O_error_message     IN OUT     RTK_ERRORS.RTK_TEXT%TYPE     O_rpt_url           IN OUT     RETAIL_SERVICE_REPORT_URL.URL%TYPE     I_ref_key           IN         KEY_MAP_GL.REFERENCE_TRACE_ID%TYPE

The appropriate report URL is found and issued as follows:

  1. The ref_trace_type is found on KEY_MAP_GL by matching I_ref_key with the KEY_MAP_GL.REFERENCE_TRACE_ID column.

  2. When ref type is determined, the re_trace_type is used to find the appropriate report URL on the RETAIL_SERVICE_REPORT_URL table.

  3. The value of I_ref_key is appended to the end of the URL retrieved from the table.

  4. The URL is sent back to the calling function.

  5. If I_ref_key does not exist on KEY_MAP_GL, an error message is sent back to the calling function.

Drilling Back From ReIM - Detail

The following drill back options are available for viewing information within the ReIM system:

  • Using Document ID, users can drill back to ReIM to view information related to a voucher or payment. The report includes information from im_doc_head and im_invoice_detail, the same data shown on the Document Maintenance Header screen within ReIM.

  • Using the Receipt ID, users can drill back to view information from the Receipt Write-off History screen. Receipt write-offs occur either when an open receipt is closed in ReIM or if a receipt is purged in RMS before it is fully matched. Details come from the IM_RWO_SHIPMENT_HIST and IM_RWO_SHIPSKU_HIST tables.

The function below determines which of the two ReIM reports to return to the user:

RMS_REPORT_URL() -     O_error_message     IN OUT     RTK_ERRORS.RTK_TEXT%TYPE     O_rpt_url           IN OUT     RETAIL_SERVICE_REPORT_URL.URL%TYPE     I_ref_key           IN         KEY_MAP_GL.REFERENCE_TRACE_ID%TYPE

The I_ref_key contains the reference ID, which ultimately determines the type of report required. The appropriate BI Publisher report URL is found on the RETAIL_SERVICE_REPORT_URL table.

In general, if the reference ID has a prefix of RECEIPT, the report type (RS_CODE) is RCPT. Otherwise, the report type is DOC. For example:

Reference ID Report Type (RS_CODE)

MRCHI#101

DOC

NMRCHI#102

DOC

RECEIPT#103

RCPT


The following is an example of a BI Publisher URL that is generated upon drilling back to PeopleSoft Enterprise Financials for information on an invoice in ReIM, using Document ID as the search parameter:

http://mspdev6970vip:7777/BIPublisher/Guest/ReIM/13.0.3/doc/tsf_det.xdo ?doc_id=101

Where

  • http://mspdev6970vip:7777/BIPublisher = the BI Publisher application server address and port

  • Guest/ReIM/13.0.3 = the directory/folder location

  • doc/tsf_det.xdo ? = report name (Document Report)

  • doc_id=101 = the parameter name and value (Document ID 101)

The following is an example of an Oracle Business Intelligence Publisher URL that is generated upon drilling back to PeopleSoft Enterprise Financials for information on an invoice in ReIM, using Receipt ID as the search parameter:

http://mspdev6970vip:7777/BIPublisher/Guest/ReIM/13.0.3/doc/tsf_det.xdo ?receipt_id=101

Where

  • http://mspdev6970vip:7777/BIPublisher = the BI Publisher application server address and port

  • Guest/ReIM/13.0.3 = the directory/folder location

  • doc/tsf_det.xdo ? = report name (Receipt Report)

  • receipt_id=101 = the parameter name and value (Receipt ID 101)

Drilling Forward

Drilling forward allows users to see detailed information about retail transactions that have been posted to PeopleSoft Enterprise Financials. When drilling forward, users are directed to selected "view-only" screens.

Drilling Forward From RMS/ReSA to PeopleSoft Enterprise Financials

The following forms may be used to drill forward from RMS/ReSA:

  • RMS StartMenu->Finance->Transaction Data View (trandata.fmb)

  • RMS StartMenu->Ordering->Fixed Deals->Fixed Deal Transaction Data View (fdltrandata.fmb)

  • RMS StartMenu->Action->Sales Audit->Sales Audit Transaction Data View (satrandata.fmb)

Drilling Forward From ReIM to PeopleSoft Enterprise Financials

For drilling forward, the AIA Web service uses the Invoice ID and Accounting Entry parameters. The ReIM system uses these parameters together as the Reference ID.

  • From the Document Maintenance screen, users can drill forward to PeopleSoft Enterprise Financials accounts payable to view voucher and payment status. The information is displayed on a read-only Payment Doc Status Inquiry screen. Drill forward access to the accounts payable system is available only for pre-paid invoices (but not for manually pre-paid invoices).

    To drill down to the payables screens, the user invokes the Web service as follows:

    Invoice ID parameter = Reference ID
    
    Accounting Entry parameter = null
    
  • From the Receipt Write-off History screen in ReIM, users can drill forward to the PeopleSoft G/L system to view the status of related journal entries. Drill forward access to the G/L system is available only for pre-paid and manually pre-paid invoices.


    Note:

    For more information on drilling forward, see the OracleRetail Merchandising Integration Pack for PeopleSoft Enterprise Financials: Financial Operations Control 2.5 - Implementation Guide.

AIA DVM Mapping Examples

The following tables illustrate possible AIA DVM Mapping values:


Note:

Cross references for the following examples are: Set of Books to General Ledger Business Unit, and Org Unit to Accounts Payable Business Unit.

BUSINESS_UNIT
PSFT_01 COMMON RETL_01

US001

100

111111111111111

CAN01

101

222222222222222


BUSINESS_UNIT_AP
PSFT_01 COMMON RETL_01

US001

200

333333333333333

US002

201

444444444444444

CAN01

202

555555555555555


LANGUAGE_CODE
PSFT_01 COMMON RETL_01

ENG

500

1


STATE
PSFT_01 COMMON RETL_01

CA

900

CA

NY

901

NY

MD

902

MD

MI

903

MI

NF

904

NF


CURRENCYEXCHANGE_CONVERSIONTYPECODE
PSFT_01 COMMON RETL_01

CRRNT

600

C


CURRENCY_CODE
PSFT_01 COMMON RETL_01

USD

400

USD

CAD

401

CAD

AUD

402

AUD

ESP

403

ESP

EUR

404

EUR

FRF

405

FRF

GBP

406

GBP

INR

407

INR

JPY

408

JPY


SUPPLIERPARTY_STATUSCODE
PSFT_01 COMMON RETL_01

E

800

I

A

801

A

I

802

I

X

803

I


SUPPLIERPARTY_ADDRESSTYPE
PSFT_01 COMMON RETL_01

REMT

1000

06

ORDR

1001

04


CHARTOFACCOUNTS_ACCOUNTSTATUS
COMMON PSFT_01 RETL_01

true

true

valid

false

false

invalid