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.
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. |