Get payables options for all business units

get

/fscmRestApi/resources/11.13.18.05/payablesOptions

Request

Query Parameters
  • 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).
  • 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
  • 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.
  • 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.
  • 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
  • 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.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • 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
  • 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.
  • 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
  • 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".
  • 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 Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : payablesOptions
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : payablesOptions-item-response
Type: object
Show Source
Back to Top