Oracle Apps Adapter 6.0 | webMethods Oracle Applications Adapter Documentation | webMethods Oracle Applications Adapter 12.2.7 Predefined Transaction Services Documentation | Procurement Predefined Transaction Services | Receive Requisition Service
 
Receive Requisition Service
This service is in the WmOAPRC1227 package and has the following fully-qualified service name: purchasing1227.intoOA.requisition:receiveRequisition.
This service loads requisition documents into Oracle Applications production tables. You can load multiple types of requisition documents, such as Internal and Purchase. This service handles multiple requisition records in a single document, and a single document can contain any combination of requisition types.
Each record in the business document is inserted, updated, or canceled according to the production data. The actual business operation (such as INSERT or UPDATE) is determined by the underlying Oracle Applications APIs and the data in the individual columns of the business document.
Data is loaded into the interface tables for both single and multiple distributions. The custom API calls the Oracle Applications API with a default parameter for multiple distributions.
While submitting the Import Requisition concurrent program to load the requisition records from interface tables to production tables, it is not possible to restrict the processing to only those records uploaded by the IS flow instance. The program will process all unprocessed records and error records from both the previous load and the interface table at the time of execution. While showing errors, it might display an error related to previously failed records, even if the current import process was successful. It is suggested to keep the interface table free of error records to minimize ambiguity.
Database Scripts
This service uses the following database scripts:
Script
Description
wm_install_into_req.sql
Runs the scripts listed below, except the uninstall script.
wm_into_req_pkg.sql
Installs WM_REQ_IMP_HANDLER_PKG.WM_HANDLE_ REQ, which calls the WM_CONC_REQUEST.WM_REQUEST_SUBMIT procedure to submit the Requisition import process.
wm_into_req_seq.sql
Creates the following components:
*WM_REQ_BATCH_S, which creates the Req_Batch_sequence_id sequence
*WM_REQ_DIST_S, which creates the Req_Dist_sequence_id
wm_drop_into_req.sql
Uninstalls all components created by wm_install_into_req.sql.
For more information about using database scripts, see Database Scripts.
Supporting Transaction Definitions
This service was built from the configured services defined in the following transaction definitions:
*setRequisitionTxn1227.txp
*RequisitionTxn1227.txp
For information about using the transaction definition files to customize this service, see Transaction Definitions.
Flow Control
This service uses the following flow steps to import inventory transactions:
*specifyDefaultSettings specifies the default parameter settings required for service execution. You should change these settings accordingly.
*specifyConcProgParams specifies the default parameter settings required for concurrent program execution. You should change these settings accordingly.
*pickSequence generates a sequence value for header sequence.
*bizDocMapping maps the incoming business data structure to the required data structure, which is similar to the interface table. This service uses the following services internally to provide required data feed during the mapping (each record of PO_REQ_LINE becomes an entry of PO_REQUISITIONS_INTERFACE_ALL):
*getOrgId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes ORGANIZATION_NAME as the input parameter, queries the table ORG_ORGANIZATION_DEFINITIONS, and gets the ORGANIZATION_ID corresponding to the ORGANIZATION_NAME.
*getVendorSiteId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes ADDRESS_LINE1, ADDRESS_LINE2, ADDRESS_LINE3, CITY, STATE, ZIP, COUNTRY, VENDOR_NAME, and ORGANIZATION_NAME as the input parameters, queries the AP_SUPPLIER_SITES_ALL, AP_SUPPLIERS, and ORG_ORGANIZATION_DEFINITIONS tables, and gets the VENDOR_SITE_ID corresponding to the passed values.
*getCategoryId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes CATEGORY as the input parameter, and returns the CATEGORY_ID.
*getItemNumber is a transformer for mapping the business document IData structure to the interface table IData structure. It takes ITEM as the input parameter, and returns the ITEM_NUMBER.
*getTaxCodeId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes TAX_NAME as the input parameter queries the AP_TAX_CODE_ALL to get the TAX_ID.
*getWIPEntityId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes WIP_ENTITY_NAME as the input parameter, and gets the WIP_ENTITY_ID corresponding to the input values.
*getWIPLineId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes WIP_LINE_CODE as the input parameter, and gets the WIP_LINE_ID corresponding to the input values.
*getCodeCombinationId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes CONCATENATED_SEGMENTS and SET_OF_BOOKS_NAME as the input parameters, and gets the CODE_COMBINATION_ID corresponding to the input values. This service appears in multiple places in bizDocMapping.
*getInventoryItemId returns the INVENTORY_ITEM_ID corresponding to the supplied ITEM_CODE and the ORGANIZATION_NAME. This service is a transformer in bizDocMapping.
*getKanbanCardId is a transformer for mapping the business document IData structure to the interface table IData structure. It queries MTL_KANBAN_CARDS table to get the KANBAN_CARD_ID for the corresponding input value.
*getLocationId is a transformer for mapping the business document IData structure to the interface table IData structure. This is a general service that gets the LOCATION_ID from HR_LOCATIONS, given ADDRESS_LINE_1, ADDRESS_LINE_2, ADDRESS_LINE_3, TOWN_OR_CITY, COUNTRY, and POSTAL_CODE.
*getProjectAndTaskId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes Project Name and Task Name as input, and returns Project ID and Task ID.
*getResourceId is a transformer for mapping the business document IData structure to the interface table IData structure. It takes BOM_RESOURCE_NAME as input, and returns BOM_RESOURCE_ID.
*convertToDateObject returns the outDate as a date object corresponding to the supplied inDate, which is in text format. This service is a transformer in bizDocMapping.
*pickSequence generates a sequence values for line sequence, distribution sequence, and custom batch sequence.
*setRequisitionTxn inserts data into the interface table. It takes data from the IData structure that results in the bizDocMapping service, and puts the data into the interface tables PO_REQUISITION_INTERFACE_ALL and PO_REQ_DIST_INTERFACE in Oracle Applications importRequisition imports data to the production table.
*importRequisition imports data to the production table.
*execRequisitionConcProg calls the underlying Oracle Applications concurrent program with the set of parameters set in the previous MAP, and returns the V_REQUEST_ID, V_STATUS, O_MESSAGE, and V_ERRMSG if errors occur during the process.
*checkRequisitionImportStatus checks the status of the concurrent program execution by checking the error Interface Table for any rejected record corresponding to the current request_id. If the query does not return any rows, it indicates successful import. If the query returns rows, it indicates that the concurrent program could not successfully import data in the production tables of Oracle Applications.
*getRequisitionImport_ERR gets the data import error for the specific request ID. This service takes request_id as an input, retrieves a data import error from INTERFACE_ERROR table, and appends the errorsDoc record list.
For more details on receive transactions, see Overview of Receive Service Transaction Processing.
Business Document Structure
This service uses the business document requisitionBizDoc. Its structure is as follows:
*1.0. PO_REQUISITIONS
*1.1. PO_REQ_LINES
*1.1.1. PO_REQ_DISTRIBUTIONS
1.0 PO_REQUISITIONS (Maps to PO_REQUISITIONS_INTERFACE_ALL)
Field Name
Maps to Column
Description
INTERFACE_SOURCE_
CODE
INTERFACE_SOURCE_
CODE
Required. Use values such as ICX, INV, MRP, MSC, ORDER ENTRY, or WIP.
REQUISITION_TYPE
REQUISITION_TYPE
Requisition type. Use values such as BLANKET, PLANNED, SCHEDULED, STANDARD, INTERNAL, or EXPENSE.
AUTHORIZATION_
STATUS
AUTHORIZATION_
STATUS
Required. Use values such as: APPROVED, CANCELLED, IN PROCESS, INCOMPLETE, PRE–APPROVED, REJECTED, REQUIRES REAPPROVAL, or RETURNED.
PREPARER_NAME
PREPARER_NAME
Required. Name of the person who has prepared the requisition.
APPROVER_NAME
APPROVER_NAME
Name of the person who has approved the requisition.
HEADER_DESCRIPTION
HEADER_DESCRIPTION
Description for the requisition.
NOTE_TO_APPROVER
NOTE_TO_APPROVER
USSGL_TRANSACTION_
CODE
USSGL_TRANSACTION_
CODE
United States standard general ledger transaction code.
KANBAN_CARD_
NUMBER
KANBAN_CARD_
ID
EMERGENCY_PO_
NUM
EMERGENCY_PO_
NUM
Purchase order number reserved in advance for an emergency requisition.
ORGANIZATION_
NAME
ORG_ID
Organization for which a requisition has been raised.
SET_OF_BOOKS_
NAME
Required for retrieving the Account ID using the transformer. See the transformer commonOA1227.utils: getCodeCombinationId.
1.1 PO_REQ_LINES (Maps to PO_REQUISITIONS_INTERFACE_ALL)
Field Name
Maps to Column
Description
DESTINATION_TYPE_
CODE
DESTINATION_TYPE_
CODE
Required. Use requisition destination type values such as: EXPENSES, INVENTORY, or SHOP FLOOR.
SOURCE_TYPE_CODE
SOURCE_TYPE_CODE
Conditionally required. Requisition source. Use values such as INVENTORY or VENDOR.
URGENT_FLAG
URGENT_FLAG
Indicates whether requisition is urgent.
RFQ_REQUIRED_
FLAG
RFQ_REQUIRED_
FLAG
Indicates whether a Request For Quotation (RFQ) is required before placement on a purchase order.
JUSTIFICATION
JUSTIFICATION
Purchase justification.
NOTE_TO_BUYER
NOTE_TO_BUYER
NOTE_TO_RECEIVER
NOTE_TO_RECEIVER
ITEM
ITEM_ID
Conditionally required. Item for which requisition is placed.
ITEM_DESCRIPTION
ITEM_DESCRIPTION
ITEM_REVISION
ITEM_REVISION
CATEGORY
CATEGORY_ID
Category of the item.
QUANTITY
QUANTITY
Required. Quantity ordered.
UNIT_PRICE
UNIT_PRICE
UNIT_OF_MEASURE
UNIT_OF_MEASURE
UOM_CODE
UOM_CODE
Unit of measurement code.
LINE_TYPE
LINE_TYPE
Requisition line type.
UN_NUMBER
UN_NUMBER
UN number.
HAZARD_CLASS
HAZARD_CLASS
REFERENCE_NUM
REFERENCE_NUM
Reference number.
SOURCE_
ORGANIZATION_
NAME
SOURCE_ORGANIZATION_
ID
Conditionally required.
SOURCE_SUBINVENTORY
SOURCE_SUBINVENTORY
Conditionally required.
DESTINATION_
ORGANIZATION_NAME
DESTINATION_
ORGANIZATION_ID
Destination organization name.
DESTINATION_
SUBINVENTORY
DESTINATION_
SUBINVENTORY
DELIVER_TO_
LOCATION_CODE
DELIVER_TO_
LOCATION_CODE
Deliver location code.
DELIVER_TO_LOCATION_
ADDRESS_LINE_1
DELIVER_TO_
LOCATION_ID
Address for the delivery location.
DELIVER_TO_LOCATION_
ADDRESS_LINE_2
DELIVER_TO_LOCATION_
ADDRESS_LINE_3
DELIVER_TO_LOCATION_
TOWN_OR_CITY
DELIVER_TO_LOCATION_
COUNTY
DELIVER_TO_LOCATION_
STATE
DELIVER_TO_LOCATION_
POSTAL_CODE
DELIVER_TO_LOCATION_
COUNTRY
DELIVER_TO_
REQUESTOR_NAME
DELIVER_TO_
REQUESTOR_NAME
Conditionally required.
AUTOSOURCE_FLAG
AUTOSOURCE_FLAG
Conditionally required. Value validated against PO_AUTOSOURCE_ DOCUMENTS_ALL.
AUTOSOURCE_DOC_
LINE_NUM
AUTOSOURCE_DOC_
LINE_NUM
Conditionally required.
DOCUMENT_TYPE_CODE
DOCUMENT_TYPE_CODE
Conditionally required.
SUGGESTED_
BUYER_NAME
SUGGESTED_
BUYER_NAME
Conditionally required.
SUGGESTED_
VENDOR_NAME
SUGGESTED_
VENDOR_NAME
Conditionally required.
SUGGESTED_VENDOR_
SITE_ADDRESS_1
SUGGESTED_
VENDOR_SITE_ID
Conditionally required. Supplier’s address.
SUGGESTED_VENDOR_
SITE_ADDRESS_2
SUGGESTED_VENDOR_
SITE_ADDRESS_3
SUGGESTED_VENDOR_
SITE_TOWN_OR_CITY
SUGGESTED_VENDOR_
SITE_TOWN_OR_COUNTY
SUGGESTED_VENDOR_
SITE_STATE
SUGGESTED_VENDOR_
SITE_POSTAL_CODE
SUGGESTED_VENDOR_
SITE_COUNTRY
SUGGESTED_
VENDOR_PHONE
SUGGESTED_
VENDOR_PHONE
Conditionally required. Supplier’s phone.
SUGGESTED_
VENDOR_CONTACT
SUGGESTED_
VENDOR_CONTACT
Conditionally required. Supplier’s contact person.
SUGGESTED_
VENDOR_ITEM
SUGGESTED_
VENDOR_ITEM_NUM
Supplier’s item number.
NEED_BY_DATE
NEED_BY_DATE
Required. Date the item is needed.
CURRENCY_CODE
CURRENCY_CODE
CURRENCY_
UNIT_PRICE
CURRENCY_
UNIT_PRICE
Conditionally required.
RATE
RATE
Conditionally required.
RATE_DATE
RATE_DATE
Conditionally required.
RATE_TYPE
RATE_TYPE
Conditionally required.
WIP_ENTITY_NAME
WIP_ENTITY_ID
Conditionally required.
WIP_LINE_CODE
WIP_LINE_ID
WIP_OPERATION_
SEQ_NUM
WIP_OPERATION_
SEQ_NUM
WIP operation sequence number within a routing.
WIP_RESOURCE_
SEQ_NUM
WIP_RESOURCE_
SEQ_NUM
WIP resource sequence number.
WIP_REPETITIVE_
SCHEDULE
WIP_REPETITIVE_
SCHEDULE_ID
Conditionally required.
BOM_RESOURCE
BOM_RESOURCE_ID
Conditionally required. Bill of materials resource.
TRANSACTION_
REASON_CODE
TRANSACTION_
REASON_CODE
TAX_CODE
TAX_CODE_ID
1.1.1 PO_REQ_DISTRIBUTIONS (Maps to PO_REQ_DIST_INTERFACE_ALL)
Field Name
Maps to Column
Description
PROJECT_
ACCOUNTING_
CONTEXT
PROJECT_
ACCOUNTING_
CONTEXT
Indicates whether project accounting is required.
EXPENDITURE_
ORGANIZATION_
NAME
EXPENDITURE_
ORGANIZATION_ID
Conditionally required. Project accounting expenditure organization.
PROJECT_NAME
PROJECT_ID
Conditionally required. For project accounting.
TASK_NAME
TASK_ID
Conditionally required. Project accounting task.
EXPENDITURE_
ITEM_DATE
EXPENDITURE_
ITEM_DATE
Project accounting expenditure date.
GL_DATE
GL_DATE
General Ledger date.
EXPENDITURE_TYPE
EXPENDITURE_TYPE
Conditionally required.
ALLOCATION_TYPE
ALLOCATION_TYPE
Specifies the method of allocation across distributions. Can be PERCENT.
ALLOCATION_VALUE
ALLOCATION_VALUE
Allocation split value.
QUANTITY
QUANTITY
Required. Quantity to be distributed.
CHARGE_ACCOUNT
CHARGE_ACCOUNT_ID
Required. General ledger charge account number.
ACCRUAL_ACCOUNT
ACCRUAL_ACCOUNT_ID
Conditionally required. General Ledger accrual account number.
BUDGET_ACCOUNT
BUDGET_ACCOUNT_ID
Conditionally required. General Ledger budget account number.
VARIANCE_ACCOUNT
VARIANCE_ACCOUNT_ID
Conditionally required. General Ledger variance account number.