Get payables options for all business units
get
/fscmRestApi/resources/11.13.18.05/payablesOptions
Request
Query Parameters
-
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
finder: string
Used as a predefined finder to search the collection.
Format: ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>
The following are the available finder names and corresponding finder variables:- PrimaryKey: Finds the payables options with the specified primary key.
Finder Variables:- businessUnitId; integer; The unique business unit identifier.
- PrimaryKey: Finds the payables options with the specified primary key.
-
limit: integer
This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
-
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
offset: integer
Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
-
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
-
orderBy: string
This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
-
q: string
This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY
Format: ?q=expression1;expression2
You can use these queryable attributes to filter this collection resource using the q query parameter:- AccountingDateBasis; string; The date based on which accounting date is set during invoice entry.
- IncomeTaxCombinedFilingProgram; string; Indicates whether the organization participates in the Combined Filing Program for income tax reporting.
- USSGLTransactionCode; string; The USSGL Transaction Code for automatically generated interest invoices.
- USSGLTrxDescriptiveFlexfieldContext; string; The USSGL Transaction Code descriptive flexfield context column.
- accountForPayment; string; Defines when the accounting entries for payments will be created.
- allowAddressChange; string; Indicates if changes to the supplier payment address on manual payments or quick payments is allowed.
- allowAdjustmentsToPaidInvoicesFlag; boolean; Indicates whether adjustments to paid invoices is allowed.
- allowFinalMatchingFlag; boolean; Indicates whether final matching to purchase orders is allowed.
- allowForceApprovalFlag; boolean; Indicates the payables processors overrides the workflow and can manually approve invoices.
- allowInvoiceBackdatingForSelfServiceInvoicesFlag; boolean; Indicates whether a self-service invoice can have an invoice date prior to the system date.
- allowInvoiceDocumentCategoryOverrideFlag; boolean; Indicates whether users can override the default document category assigned to an invoice.
- allowMatchingDistributionOverrideFlag; boolean; Indicates whether the users can override the matching Accounting Flexfield for an invoice distribution matched to a purchase order distribution line.
- allowOverrideOfSupplierSiteBankAccountFlag; boolean; Indicate whether a user can charge the remit-to bank at the payment creation time.
- allowPayeeOverrideForThirdPartyPaymentsFlag; boolean; Allow override of remit-to supplier and address for third-party payments.
- allowPaymentDateBeforeTheSystemDateFlag; boolean; Indicates if the payment date can be prior to the system date.
- allowPaymentDocumentCategoryOverrideFlag; boolean; Indicates whether users can override the default document category (Sequential Numbering) for payments.
- allowRemitToSupplierOverrideForThirdPartyPaymentsFlag; boolean; Allow override of remit-to supplier and address for third-party payments.
- allowUnitPriceChangeForQuantityBasedMatchesForSelfServiceInvoices; string; A setting that indicates whether the unit price change is allowed for purchase orders matched to self-service invoices.
- alwaysTakeDiscFlag; boolean; Indicates if an available discount for the supplier will be taken, regardless of when the invoice is paid.
- amountTolerances; string; Services tolerance template identifier.
- attachmentMandatoryForSelfServiceInvoicesFlag; boolean; Makes attachments mandatory for invoices created through the supplier portal.
- bankChargeDeductionType; string; The type of deduction for bank charges. Valid values are Standard, Negotiated, or None.
- budgetDateBasis; string; The date based on which the budget date will be derived whether it is the accounting date, invoice date, or system date.
- businessUnitId; integer; Indicates the business unit ID for the Payables options.
- businessUnitName; string; Indicates the business unit name for the Payables and Procurement options.
- createInterestInvoicesFlag; boolean; Indicates whether interest invoices are automatically created for past due invoice payments.
- createdBy; string; The user who created the record.
- creationDate; string; The date when the record was created.
- disallowAttachmentDeleteFlag; boolean; Prevents the deletion of attachments for approved or validated invoices.
- discountAllocationMethod; string; The method for distributing discount amounts taken on invoice payments.
- enableInvoiceAccountCodingWorkflowFlag; boolean; Indicates the Invoice Routing option is enabled for the business unit.
- enableInvoiceApprovalFlag; boolean; Indicates whether invoice approval is enabled.
- excludeFreightFromDiscountCalculationFlag; boolean; Indicates that freight is excluded from the calculation when identifying the discount.
- excludeTaxFromDiscountCalculationFlag; boolean; Indicates the tax amount is to be excluded from the invoice amount when the invoice amount has an applicable discount calculated.
- federalIdentificationNumber; string; The Federal Tax Identification number of the company.
- glDateFromReceiptFlag; boolean; The date used as the accounting date during invoice entry.
- includeWitholdingDistInIncometaxreports; string; Indicates whether or not to include withholding distribution in income tax reports.
- incomeTaxRegion; string; The default income tax region assigned to invoice lines for 1099 suppliers.
- interestAllocationMethodFlag; boolean; The method used to display the interest allocation in the accounting option label. The value Y indicates that the interest allocation method is all invoice lines and the value N indicates that the interest allocation method is single distribution.
- interestExpenseDistribution; string; The Accounting Flexfield identifier for the interest expense account.
- invoiceCurrency; string; The invoice currency code that defaults on the invoices associated with the business unit.
- lastUpdateDate; string; The date when the record was last updated.
- lastUpdateLogin; string; The session login associated to the user who last updated the record.
- lastUpdatedBy; string; The user who last updated the record.
- ledgerCurrency; string; The currency of the ledger that the business unit is associated.
- ledgerId; integer; The name of the ledger that the business unit is associated.
- limitInvoiceToSinglePurchaseOrderForSelfServiceInvoicesFlag; boolean; Indicates whether a self-service invoice can be matched to multiple purchase orders.
- locationId; integer; The identifier for the headquarters location of your company.
- minimumInterestAmount; number; The minimum interest amount owed on a past due invoice for an interest invoice to be automatically created.
- payDateBasis; string; The date used for selecting invoices for payment.
- payGroup; string; The default pay group code used to group a category of suppliers or invoices into a single pay run. For example: employees, merchandise, nonmerchandise, government, domestic, and international.
- paymentCurrency; string; The payment currency code that defaults on the invoices associated with the business unit.
- paymentPriority; integer; A unique number between 1 (high) and 99 (low) that represents the priority of payment.
- paymentRequestPayGroup; string; The default pay group code for payment requests. It is used to group a category of invoices into a single pay run. Invoices could be sorted into groups for payment such as employees, merchandise, nonmerchandise, government, domestic, and international.
- paymentRequestPaymentPriority; integer; A unique number between 1 being high and 99 being low, that represents the priority of payment.
- paymentRequestPaymentTerms; string; The default payment terms identifier for payment requests.
- paymentTerms; string; The payment terms identifier that defaults on the supplier sites associated with the business unit.
- prepaymentPaymentTerms; string; The default payment terms for a prepayment. For example, a company may want to have immediate payment terms for all their prepayment type invoices.
- quantityTolerances; string; A unique identifier for a tolerance template that is used for goods tolerance.
- recalculateInvoiceInstallmentsFlag; boolean; Indicates the ability to recalculate payment installments.
- receiptAcceptanceDays; integer; The number of days in a receipt acceptance period.
- requireAccountingBeforeApproval; string; Indicates the accounting preference when invoice approval is enabled. The value N indicates that the accounting will happen regardless of approval status. The value Y indicates accounting is required before approval and the value A indicates that the approval is required before accounting.
- requireConversionRateEntryForPaymentsFlag; boolean; Indicates if conversion rates must be entered for multiple currency payments.
- requireInvoiceGroup; string; The setting that indicates whether an invoice group is mandatory during invoice entry.
- requireValidationBeforeApprovalFlag; boolean; Indicates that the Invoice Approval Workflow does not select any invoice for processing unless the invoice status is Validated.
- settlementDays; integer; The number of days added to the system date to calculate a settlement date for a prepayment.
- showAvailablePrepaymentsDuringInvoiceEntryFlag; boolean; Indicates whether available prepayments are shown during invoice entry.
- supplierTaxRegion; string; A value of Y indicates that the supplier tax region is used as the default Income Tax Region for 1099 invoice lines.
- termsDateBasis; string; The date used in combination with the payment terms and the invoice amount to create an invoice scheduled payment.
- transferPOdistributionAdditionalInformationFlag; boolean; A value of Y indicates the system will transfer descriptive flexfield information from a purchase order shipment to an invoice line and from the purchase order distribution to an invoice distribution during the purchase order matching.
- useDistributionFromPurchaseOrderFlag; boolean; Indicates whether the prepayment account should be built or defaulted.
-
totalResults: boolean
The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : payablesOptions
Type:
Show Source
object
-
count(required): integer
The number of resource instances returned in the current range.
-
hasMore(required): boolean
Indicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false.
-
items: array
Items
Title:
Items
The items in the collection. -
limit(required): integer
The actual paging size used by the server.
-
links(required): array
Links
Title:
Links
The link relations associated with the resource instance. -
offset(required): integer
The offset value used in the current page.
-
totalResults: integer
The estimated row count when "?totalResults=true", otherwise the count is not included.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : payablesOptions-item-response
Type:
Show Source
object
-
accountForPayment: string
Title:
Account for Payment
Maximum Length:30
Default Value:BOTH
Defines when the accounting entries for payments will be created. -
AccountingDateBasis: string
Title:
Accounting Date Basis
Maximum Length:25
Default Value:INVOICE
The date based on which accounting date is set during invoice entry. -
allowAddressChange: string
Title:
Allow override of supplier site address for single payments
Maximum Length:1
Default Value:N
Indicates if changes to the supplier payment address on manual payments or quick payments is allowed. -
allowAdjustmentsToPaidInvoicesFlag: boolean
Title:
Allow adjustments to paid invoices
Maximum Length:1
Default Value:false
Indicates whether adjustments to paid invoices is allowed. -
allowFinalMatchingFlag: boolean
Title:
Allow final matching
Maximum Length:1
Default Value:false
Indicates whether final matching to purchase orders is allowed. -
allowForceApprovalFlag: boolean
Title:
Allow force approval
Maximum Length:1
Default Value:false
Indicates the payables processors overrides the workflow and can manually approve invoices. -
allowInvoiceBackdatingForSelfServiceInvoicesFlag: boolean
Title:
Allow invoice backdating
Maximum Length:1
Indicates whether a self-service invoice can have an invoice date prior to the system date. -
allowInvoiceDocumentCategoryOverrideFlag: boolean
Title:
Allow document category override
Maximum Length:1
Default Value:false
Indicates whether users can override the default document category assigned to an invoice. -
allowMatchingDistributionOverrideFlag: boolean
Title:
Allow matching distribution override
Maximum Length:1
Default Value:false
Indicates whether the users can override the matching Accounting Flexfield for an invoice distribution matched to a purchase order distribution line. -
allowOverrideOfSupplierSiteBankAccountFlag: boolean
Title:
Allow override of supplier site bank account
Maximum Length:1
Default Value:false
Indicate whether a user can charge the remit-to bank at the payment creation time. -
allowPayeeOverrideForThirdPartyPaymentsFlag: boolean
Title:
Allow payee override for third-party payments
Maximum Length:1
Default Value:false
Allow override of remit-to supplier and address for third-party payments. -
allowPaymentDateBeforeTheSystemDateFlag: boolean
Title:
Allow payment date before the system date
Maximum Length:1
Default Value:false
Indicates if the payment date can be prior to the system date. -
allowPaymentDocumentCategoryOverrideFlag: boolean
Title:
Allow document category override
Maximum Length:1
Default Value:false
Indicates whether users can override the default document category (Sequential Numbering) for payments. -
allowRemitToSupplierOverrideForThirdPartyPaymentsFlag: boolean
Title:
Allow remit-to supplier override for third-party payments
Maximum Length:1
Default Value:false
Allow override of remit-to supplier and address for third-party payments. -
allowUnitPriceChangeForQuantityBasedMatchesForSelfServiceInvoices: string
Title:
Allow Unit Price Change for Quantity-Based Matches
Maximum Length:30
A setting that indicates whether the unit price change is allowed for purchase orders matched to self-service invoices. -
alwaysTakeDiscFlag: boolean
Title:
Always take discount
Maximum Length:1
Default Value:false
Indicates if an available discount for the supplier will be taken, regardless of when the invoice is paid. -
amountTolerances: string
Services tolerance template identifier.
-
attachmentMandatoryForSelfServiceInvoicesFlag: boolean
Title:
Require Attachment
Maximum Length:1
Default Value:false
Makes attachments mandatory for invoices created through the supplier portal. -
bankChargeDeductionType: string
Maximum Length:
1
The type of deduction for bank charges. Valid values are Standard, Negotiated, or None. -
budgetDateBasis: string
Title:
Budget Date Basis
Maximum Length:25
Default Value:ACC
The date based on which the budget date will be derived whether it is the accounting date, invoice date, or system date. -
businessUnitId: integer
(int64)
Indicates the business unit ID for the Payables options.
-
businessUnitName: string
Indicates the business unit name for the Payables and Procurement options.
-
createdBy: string
Read Only:
true
Maximum Length:64
The user who created the record. -
createInterestInvoicesFlag: boolean
Title:
Create interest invoices
Maximum Length:1
Default Value:false
Indicates whether interest invoices are automatically created for past due invoice payments. -
creationDate: string
(date-time)
Read Only:
true
The date when the record was created. -
disallowAttachmentDeleteFlag: boolean
Title:
Prevent Deletion of Invoice Attachments
Maximum Length:1
Default Value:false
Prevents the deletion of attachments for approved or validated invoices. -
discountAllocationMethod: string
Title:
Discount Allocation Method
Maximum Length:25
Default Value:SYSTEM
The method for distributing discount amounts taken on invoice payments. -
enableInvoiceAccountCodingWorkflowFlag: boolean
Title:
Enable invoice account coding workflow
Maximum Length:1
Default Value:false
Indicates the Invoice Routing option is enabled for the business unit. -
enableInvoiceApprovalFlag: boolean
Title:
Enable invoice approval
Maximum Length:1
Default Value:false
Indicates whether invoice approval is enabled. -
excludeFreightFromDiscountCalculationFlag: boolean
Title:
Exclude freight from calculation
Maximum Length:1
Default Value:false
Indicates that freight is excluded from the calculation when identifying the discount. -
excludeTaxFromDiscountCalculationFlag: boolean
Title:
Exclude tax from calculation
Maximum Length:1
Default Value:false
Indicates the tax amount is to be excluded from the invoice amount when the invoice amount has an applicable discount calculated. -
federalIdentificationNumber: string
Maximum Length:
20
The Federal Tax Identification number of the company. -
glDateFromReceiptFlag: boolean
Title:
Accounting Date Basis
Maximum Length:25
Default Value:false
The date used as the accounting date during invoice entry. -
includeWitholdingDistInIncometaxreports: string
Title:
Include withholding distributions in income tax reports
Maximum Length:1
Default Value:N
Indicates whether or not to include withholding distribution in income tax reports. -
IncomeTaxCombinedFilingProgram: string
Title:
Use combined filing program
Maximum Length:1
Default Value:N
Indicates whether the organization participates in the Combined Filing Program for income tax reporting. -
incomeTaxRegion: string
Title:
Income Tax Region
Maximum Length:10
The default income tax region assigned to invoice lines for 1099 suppliers. -
interestAllocationMethodFlag: boolean
Title:
Interest Allocation Method
Maximum Length:1
Default Value:false
The method used to display the interest allocation in the accounting option label. The value Y indicates that the interest allocation method is all invoice lines and the value N indicates that the interest allocation method is single distribution. -
interestExpenseDistribution: string
The Accounting Flexfield identifier for the interest expense account.
-
invoiceCurrency: string
Title:
Invoice Currency
Maximum Length:15
The invoice currency code that defaults on the invoices associated with the business unit. -
lastUpdateDate: string
(date-time)
Read Only:
true
The date when the record was last updated. -
lastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the record. -
lastUpdateLogin: string
Read Only:
true
Maximum Length:32
The session login associated to the user who last updated the record. -
ledgerCurrency: string
Maximum Length:
15
The currency of the ledger that the business unit is associated. -
ledgerId: integer
(int64)
The name of the ledger that the business unit is associated.
-
limitInvoiceToSinglePurchaseOrderForSelfServiceInvoicesFlag: boolean
Title:
Limit invoice to single purchase order
Maximum Length:1
Indicates whether a self-service invoice can be matched to multiple purchase orders. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
locationId: integer
(int64)
The identifier for the headquarters location of your company.
-
minimumInterestAmount: number
Title:
Minimum Interest Amount
The minimum interest amount owed on a past due invoice for an interest invoice to be automatically created. -
payDateBasis: string
Title:
Pay Date Basis
Maximum Length:25
Default Value:DISCOUNT
The date used for selecting invoices for payment. -
payGroup: string
Title:
Pay Group
Maximum Length:25
The default pay group code used to group a category of suppliers or invoices into a single pay run. For example: employees, merchandise, nonmerchandise, government, domestic, and international. -
paymentCurrency: string
Title:
Payment Currency
Maximum Length:15
The payment currency code that defaults on the invoices associated with the business unit. -
paymentPriority: integer
Title:
Payment Priority
A unique number between 1 (high) and 99 (low) that represents the priority of payment. -
paymentRequestPayGroup: string
Title:
Pay Group
Maximum Length:25
The default pay group code for payment requests. It is used to group a category of invoices into a single pay run. Invoices could be sorted into groups for payment such as employees, merchandise, nonmerchandise, government, domestic, and international. -
paymentRequestPaymentPriority: integer
Title:
Payment Priority
A unique number between 1 being high and 99 being low, that represents the priority of payment. -
paymentRequestPaymentTerms: string
The default payment terms identifier for payment requests.
-
paymentTerms: string
The payment terms identifier that defaults on the supplier sites associated with the business unit.
-
prepaymentPaymentTerms: string
The default payment terms for a prepayment. For example, a company may want to have immediate payment terms for all their prepayment type invoices.
-
quantityTolerances: string
A unique identifier for a tolerance template that is used for goods tolerance.
-
recalculateInvoiceInstallmentsFlag: boolean
Title:
Recalculate invoice installments
Maximum Length:1
Default Value:false
Indicates the ability to recalculate payment installments. -
receiptAcceptanceDays: integer
(int64)
Title:
Receipt Acceptance Days
The number of days in a receipt acceptance period. -
requireAccountingBeforeApproval: string
Title:
Require accounting before approval
Maximum Length:30
Default Value:N
Indicates the accounting preference when invoice approval is enabled. The value N indicates that the accounting will happen regardless of approval status. The value Y indicates accounting is required before approval and the value A indicates that the approval is required before accounting. -
requireConversionRateEntryForPaymentsFlag: boolean
Title:
Require conversion rate entry
Maximum Length:1
Default Value:false
Indicates if conversion rates must be entered for multiple currency payments. -
requireInvoiceGroup: string
Title:
Require invoice grouping
Maximum Length:1
The setting that indicates whether an invoice group is mandatory during invoice entry. -
requireValidationBeforeApprovalFlag: boolean
Title:
Require validation before approval
Maximum Length:1
Default Value:false
Indicates that the Invoice Approval Workflow does not select any invoice for processing unless the invoice status is Validated. -
settlementDays: integer
(int64)
Title:
Settlement Days
The number of days added to the system date to calculate a settlement date for a prepayment. -
showAvailablePrepaymentsDuringInvoiceEntryFlag: boolean
Title:
Show available prepayments during invoice entry
Maximum Length:1
Default Value:false
Indicates whether available prepayments are shown during invoice entry. -
supplierTaxRegion: string
Title:
Use supplier tax region
Maximum Length:1
Default Value:N
A value of Y indicates that the supplier tax region is used as the default Income Tax Region for 1099 invoice lines. -
termsDateBasis: string
Title:
Terms Date Basis
Maximum Length:25
Default Value:Invoice
The date used in combination with the payment terms and the invoice amount to create an invoice scheduled payment. -
transferPOdistributionAdditionalInformationFlag: boolean
Title:
Transfer PO distribution additional information
Maximum Length:1
Default Value:false
A value of Y indicates the system will transfer descriptive flexfield information from a purchase order shipment to an invoice line and from the purchase order distribution to an invoice distribution during the purchase order matching. -
useDistributionFromPurchaseOrderFlag: boolean
Title:
Use distribution from purchase order
Maximum Length:1
Default Value:false
Indicates whether the prepayment account should be built or defaulted. -
USSGLTransactionCode: string
Maximum Length:
30
The USSGL Transaction Code for automatically generated interest invoices. -
USSGLTrxDescriptiveFlexfieldContext: string
Maximum Length:
30
The USSGL Transaction Code descriptive flexfield context column.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.