Skip to main content
← Web Service Payloads & REST API Examples

REST · Financials — Payables

What is the REST API payload to create a Payables invoice in Oracle Fusion?

POST /invoices — REST payload to create a Payables invoice

REST APIOracle Fusion · Financials · APHigh confidenceCurated

The Payables Invoices REST resource creates an invoice header and its lines in one call. Minimum useful body: InvoiceNumber, InvoiceAmount, InvoiceDate, InvoiceCurrency, BusinessUnit, Supplier, SupplierSite, plus an invoiceLines child array with LineNumber, LineAmount and a distribution combination or distribution set.

Endpoint

POSThttps://<your-fusion-host>/fscmRestApi/resources/11.13.18.05/invoices

Purpose

Create a standard Payables invoice. Send an HTTP POST with Basic auth (or OAuth) and Content-Type application/json. The response returns the generated InvoiceId and the created invoiceLines.

Parameters

InvoiceNumberrequiredSupplier's invoice number — unique per supplier.
InvoiceAmountrequiredGross invoice amount in the invoice currency.
InvoiceDaterequiredInvoice date (YYYY-MM-DD).
InvoiceCurrencyrequiredCurrency code, e.g. USD.
BusinessUnitrequiredName of the invoicing business unit.
SupplierrequiredSupplier name (or SupplierNumber).
SupplierSiterequiredSupplier site code used for pay/purchasing defaulting.
invoiceLinesrequiredChild array — one object per line with LineNumber, LineAmount and an account (DistributionCombination) or DistributionSet.

Example request

Request
{
  "InvoiceNumber": "INV-2026-00817",
  "InvoiceAmount": 1500,
  "InvoiceDate": "2026-08-24",
  "InvoiceCurrency": "USD",
  "BusinessUnit": "US1 Business Unit",
  "Supplier": "Office Supplies Inc",
  "SupplierSite": "MAIN",
  "Description": "August office supplies",
  "ImportSource": "External",
  "invoiceLines": [
    {
      "LineNumber": 1,
      "LineAmount": 1500,
      "LineType": "Item",
      "DistributionCombination": "01-000-6410-0000-000"
    }
  ]
}

Example response

Response
{
  "InvoiceId": 300000123456789,
  "InvoiceNumber": "INV-2026-00817",
  "InvoiceAmount": 1500,
  "InvoiceCurrency": "USD",
  "InvoiceType": "Standard",
  "Supplier": "Office Supplies Inc",
  "ValidationStatus": "NEVER_VALIDATED",
  "links": [
    { "rel": "self", "href": ".../invoices/300000123456789" },
    { "rel": "child", "name": "invoiceLines", "href": ".../invoices/300000123456789/child/invoiceLines" }
  ]
}

Call lifecycle

  1. 01

    Basic auth or OAuth 2.0 bearer token.

    • User needs the Payables invoice create privilege
    • Content-Type: application/json
  2. 02
  3. 03
  4. 04

Related questions

GroundingCurated

Retrieved from the curated Oracle knowledge layer — table metadata, joins and process flows.

Need a variation, or a different service?

Continue in Ask Oracle AI