From 3449148dd41d0a760bbf178782db38a58170b557 Mon Sep 17 00:00:00 2001
From: Jonathan Hatlee <jonathan.hatlee@xero.com>
Date: Fri, 29 May 2026 21:35:17 -0400
Subject: [PATCH 1/2] XBIVE-13942: Adds spec for invoice backorders and
 backorder-specific item fields

---
 xero_accounting.yaml | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/xero_accounting.yaml b/xero_accounting.yaml
index a9c5fbe0b..9c0b96d06 100644
--- a/xero_accounting.yaml
+++ b/xero_accounting.yaml
@@ -7605,6 +7605,7 @@ paths:
         - $ref: "#/components/parameters/summarizeErrors"
         - $ref: "#/components/parameters/unitdp"
         - $ref: "#/components/parameters/idempotencyKey"
+        - $ref: "#/components/parameters/allowBackorders"
       responses:
         "200":
           description: Success - return response of type Invoices array with newly created Invoice
@@ -8217,6 +8218,7 @@ paths:
         - $ref: "#/components/parameters/InvoiceID"
         - $ref: "#/components/parameters/unitdp"
         - $ref: "#/components/parameters/idempotencyKey"
+        - $ref: "#/components/parameters/allowBackorders"
       responses:
         "200":
           description: Success - return response of type Invoices array with updated Invoice
@@ -8730,6 +8732,28 @@ paths:
                     IsTrackedAsInventory: false
                     IsSold: true
                     IsPurchased: true
+                  - ItemID: 5a70a272-a481-4bcf-a8ca-efffd923ab48
+                    Code: fg78Ac
+                    Description: Fender Stratocaster Sunburst
+                    PurchaseDescription: Fender Stratocaster Sunburst
+                    UpdatedDateUTC: /Date(1552331874000+0000)/
+                    PurchaseDetails:
+                      UnitPrice: 1500.0000
+                      COGSAccountCode: "500"
+                      TaxType: ""
+                    SalesDetails:
+                      UnitPrice: 5000.0000
+                      AccountCode: "200"
+                      TaxType: OUTPUT2
+                    Name: Fender Stratocaster
+                    IsTrackedAsInventory: true
+                    InventoryAssetAccountCode: "140"
+                    TotalCostPool: 0.00
+                    QuantityOnHand: 0.0000
+                    QuantityAvailable: 0.0000
+                    QuantityOnBackOrder: 0.0000
+                    IsSold: true
+                    IsPurchased: true
     put:
       security:
         - OAuth2:
@@ -8977,6 +9001,8 @@ paths:
                     InventoryAssetAccountCode: "630"
                     TotalCostPool: 25000.00
                     QuantityOnHand: 10.0000
+                    QuantityAvailable: 10.0000
+                    QuantityOnBackOrder: 0.0000
                     IsSold: true
                     IsPurchased: true
                     ValidationErrors: []
@@ -19577,6 +19603,14 @@ components:
       example: KEY_VALUE
       schema:
         type: string
+    allowBackorders:
+      in: query
+      name: allowBackorders
+      x-snake: allow_backorders
+      description: Allows an invoice to be created even when one or more line items contain tracked inventory where the invoice quantity would cause the available quantity to go negative
+      example: true
+      schema:
+        type: boolean
     includeOnline:
       in: query
       name: IncludeOnline

From 05929551a06ca95b4c30dccc8bdf590d206e82c1 Mon Sep 17 00:00:00 2001
From: Jonathan Hatlee <jonathan.hatlee@xero.com>
Date: Sat, 30 May 2026 09:39:56 -0400
Subject: [PATCH 2/2] XBIVE-13942: Adds `allowBackorders` field to POST
 /Invoices

---
 xero_accounting.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/xero_accounting.yaml b/xero_accounting.yaml
index 9c0b96d06..e374854cb 100644
--- a/xero_accounting.yaml
+++ b/xero_accounting.yaml
@@ -7918,6 +7918,7 @@ paths:
         - $ref: "#/components/parameters/summarizeErrors"
         - $ref: "#/components/parameters/unitdp"
         - $ref: "#/components/parameters/idempotencyKey"
+        - $ref: "#/components/parameters/allowBackorders"
       responses:
         "200":
           description: Success - return response of type Invoices array with newly created Invoice