Payables Invoice Management

Logical Business Objects

Financials : Payables : Payables Credit Memo
Financials : Payables : Payables Credit Memo
Financials : Payables : Payables Credit Memo

Relationships

The following table describes how this service data object is related to other service data objects or business object services.

Relationship Type	Object or Service
Handles	Invoice Installment SDO
Handles	Payables Invoice Installments Descriptive Flexfield SDO
Handles	Invoice Status SDO
Handles	Payables Invoice Installments Global Flexfield SDO
Handles	Payables Invoice Payments Global Flexfield SDO
Handles	Invoice Hold SDO
Handles	Payment Status SDO

cancelInvoice

Cancel the selected invoice.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
businessUnitName	string	Business unit of invoice to be canceled.
supplierName	string	Supplier name associated with the invoice.
supplierNumber	string	Supplier number associated with the invoice.
invoiceNumber	string	Invoice number associated with the invoice.
voucherNumber	string	Voucher number associated with the invoice.

Response Payload

Element Name	Type	Description
result	string	Request code and message from invoice service.

createURLAttachment

Create the URL attachment to the invoice.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
imageURL	string	URL of the invoice image.
businessUnitName	string	Business unit of the invoice that the URL is attached to.
supplierName	string	Supplier name of the invoice that the URL is attached to.
supplierNumber	string	Supplier number of the invoice that the URL is attached to.
invoiceNumber	string	Invoice number of the invoice that the URL is attached to.
voucherNumber	string	Voucher number generated for the invoice.

Response Payload

Element Name	Type	Description
result	string	Request code and message from invoice service.

insertSingleHold

Place an invoice on hold.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
businessUnitName	string	Business unit associated with the invoice.
supplierName	string	Supplier name associated with the invoice.
supplierNumber	string	Supplier number associated with the invoice.
invoiceNumber	string	Invoice number associated with the invoice.
voucherNumber	string	Voucher number associated with the invoice.
holdLookupCode	string	Name of the hold that is applied on an invoice line.

Response Payload

Element Name	Type	Description
result	string	Request code and message from invoice service.

releaseSingleHold

Release a hold from an invoice.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
businessUnitName	string	Business unit associated with the invoice.
supplierName	string	Supplier name associated with the invoice.
supplierNumber	string	Supplier number associated with the invoice.
invoiceNumber	string	Invoice number associated with the invoice.
voucherNumber	string	Voucher number associated with the invoice.
holdLookupCode	string	Name of the hold that is to be released.
releaseLookupCode	string	Release name that released the hold on the invoice.

Response Payload

Element Name	Type	Description
result	string	Request code and message from invoice service.

getInvoiceInstallments

Retrieve installment information from an invoice.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
businessUnitName	string	Business unit associated with the invoice.
supplierName	string	Supplier name associated with the invoice.
supplierNumber	string	Supplier number associated with the invoice.
invoiceNumber	string	Invoice number associated with the invoice.
installmentNumber	long	Installment number associated with the installment.

Response Payload

Element Name	Type	Description
result	Invoice Installment SDO	Request code and message from invoice service.

updateInvoiceInstallments

Update installment information on an invoice.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
businessUnitName	string	Business unit associated with the invoice.
supplierName	string	Supplier name associated with the invoice.
supplierNumber	string	Supplier number associated with the invoice.
invoiceNumber	string	Invoice number associated with the invoice.
installmentNumber	string	Installment number associated with the installment.
dueDate	string	Due date associated with the installment.
firstDiscAmount	string	First discount amount associated with the installment.
firstDiscDate	string	First discount date associated with the installment.
secondDiscAmount	string	Second discount amount associated with the installment.
secondDiscDate	string	Second discount date associated with the installment.
thirdDiscAmount	string	Third discount amount associated with the installment.
thirdDiscDate	string	Third discount date associated with the installment.

Response Payload

Element Name	Type	Description
result	string	Request code and message from invoice service.

getInvoiceStatus

Query invoice status by primary key.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
invoiceId	long	Invoice identifier of the invoice that is being queried for invoice status.

Response Payload

Element Name	Type	Description
result	{http://xmlns.oracle.com/apps/financials/payables/invoices/transactions/invoiceService/}InvoiceStatusResult	Invoice status information including invoice hold and payment status.

findInvoiceStatus

Query invoice status by search criteria.

Life Cycle Status: Active

Request Payload

Element Name	Type	Description
findCriteria	{http://xmlns.oracle.com/adf/svc/types/}FindCriteria	Search criteria.
findControl	{http://xmlns.oracle.com/adf/svc/types/}FindControl	Find control.

Response Payload

Element Name	Type	Description
result	Invoice Status	Invoice status information including invoice hold and payment status.

Security

The following tables list the privileges required to perform the service operations, and the duty roles that each privilege is granted to.

Service Operations to Privileges Mapping

Operation Name	Privilege Code	Privilege Name	Privilege Description
getInvoiceStatus	AP_INV_VIEW_WEB_SERVICE_PRIV	View Payables Invoice by Web Service	Allows viewing of Oracle Fusion Payables invoices using a web service.
findInvoiceStatus	AP_INV_VIEW_WEB_SERVICE_PRIV	View Payables Invoice by Web Service	Allows viewing of Oracle Fusion Payables invoices using a web service.
All Operations	AP_INV_CREATE_WEB_SERVICE_PRIV	Create Payables Invoice by Web Service	Allows creation of Oracle Fusion Payables invoices.

Privileges to Duty Roles Mapping

Privilege Code	Granted to Duty Role Code	Granted to Duty Role Name	Granted To Duty Role Description
AP_INV_VIEW_WEB_SERVICE_PRIV	ORA_AP_PAYABLES_INVOICE_PROCESSING_DUTY	Payables Invoice Processing	Views invoices and related documents and takes action, such as approving and resolving holds.
AP_INV_CREATE_WEB_SERVICE_PRIV	ORA_AP_PAYABLES_INVOICE_PROCESSING_DUTY	Payables Invoice Processing	Views invoices and related documents and takes action, such as approving and resolving holds.
AP_INV_CREATE_WEB_SERVICE_PRIV	ORA_AP_PAYABLES_INVOICE_IMPORT_SUBMISSION_DUTY	Payables Invoice Import Submission	Submits Oracle Fusion Payables invoice import program.

Duty Roles to Duty or Job Roles Mapping

Duty Role Code	Granted to Duty or Job Role Code	Granted to Duty or Job Role Name	Granted To Duty or Job Role Description
ORA_AP_PAYABLES_INVOICE_IMPORT_SUBMISSION_DUTY	ORA_FUN_FSCM_LOAD_INTERFACE_ADMIN_DUTY	FSCM Load Interface Administration	Manages load interface file for import
ORA_AP_PAYABLES_INVOICE_PROCESSING_DUTY	ORA_EGP_ITEM_INQUIRY_DUTY	Item Inquiry	Queries and views items in the enterprise.
ORA_AP_PAYABLES_INVOICE_PROCESSING_DUTY	ORA_POZ_USE_REST_SERVICE_VIEW_SUPPLIER_PROFILE	Supplier Profile Viewing Using REST Service	Allows users to call the get method with the Supplier REST service for all rows.