From 1c9c651e28d694a2cb92119b5f65aaa12037006d Mon Sep 17 00:00:00 2001
From: Mia Miu <xmia665@aucklanduni.ac.nz>
Date: Sun, 2 Aug 2026 18:52:33 +1200
Subject: [PATCH] docs: clarify invoice wrapper hash

---
 docs/accounting/AccountingApi.md    | 9 ++++-----
 docs/accounting/index.html          | 7 ++++---
 lib/xero-ruby/api/accounting_api.rb | 8 ++++----
 3 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/docs/accounting/AccountingApi.md b/docs/accounting/AccountingApi.md
index 3770ac3d..337bba4d 100644
--- a/docs/accounting/AccountingApi.md
+++ b/docs/accounting/AccountingApi.md
@@ -2068,7 +2068,7 @@ api_instance = xero_client.<api_set>
 
 
 xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
-invoices = {"Invoices":[{"Type":"ACCREC","Contact":{"ContactID":"430fa14a-f945-44d3-9f97-5df5e28441b8"},"LineItems":[{"Description":"Acme Tires","Quantity":2,"UnitAmount":20,"AccountCode":"200","TaxType":"NONE","LineAmount":40}],"Date":"2019-03-11","DueDate":"2018-12-10","Reference":"Website Design","Status":"AUTHORISED"}]} # Invoices | Invoices with an array of invoice objects in body of request
+invoices = {"Invoices":[{"Type":"ACCREC","Contact":{"ContactID":"430fa14a-f945-44d3-9f97-5df5e28441b8"},"LineItems":[{"Description":"Acme Tires","Quantity":2,"UnitAmount":20,"AccountCode":"200","TaxType":"NONE","LineAmount":40}],"Date":"2019-03-11","DueDate":"2018-12-10","Reference":"Website Design","Status":"AUTHORISED"}]} # Invoices | Wrapper hash with an `Invoices` array in the request body
 opts = {
   summarize_errors: false, # Boolean | If false return 200 OK and mix of successfully created objects and any with validation errors
 
@@ -2092,7 +2092,7 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **xero_tenant_id** | **String**| Xero identifier for Tenant | 
- **invoices** | [**Invoices**](Invoices.md)| Invoices with an array of invoice objects in body of request | 
+ **invoices** | [**Invoices**](Invoices.md)| Wrapper hash with an `Invoices` array in the request body |
  **summarize_errors** | **Boolean**| If false return 200 OK and mix of successfully created objects and any with validation errors | [optional] [default to false]
  **unitdp** | **Integer**| e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts | [optional] 
  **idempotency_key** | **String**| This allows you to safely retry requests without the risk of duplicate processing. 128 character max. | [optional] 
@@ -14795,7 +14795,7 @@ api_instance = xero_client.<api_set>
 
 xero_tenant_id = 'YOUR_XERO_TENANT_ID' # String | Xero identifier for Tenant
 invoice_id = '00000000-0000-0000-0000-000000000000' # String | Unique identifier for an Invoice
-invoices = {"Invoices":[{"Reference":"May the force be with you","InvoiceID":"00000000-0000-0000-0000-000000000000","LineItems":[],"Contact":{},"Type":"ACCPAY"}]} # Invoices | 
+invoices = {"Invoices":[{"Reference":"May the force be with you","InvoiceID":"00000000-0000-0000-0000-000000000000","LineItems":[],"Contact":{},"Type":"ACCPAY"}]} # Invoices | Wrapper hash with an `Invoices` array in the request body
 opts = {
   unitdp: 4, # Integer | e.g. unitdp=4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
 
@@ -14818,7 +14818,7 @@ Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **xero_tenant_id** | **String**| Xero identifier for Tenant | 
  **invoice_id** | [**String**](.md)| Unique identifier for an Invoice | 
- **invoices** | [**Invoices**](Invoices.md)|  | 
+ **invoices** | [**Invoices**](Invoices.md)| Wrapper hash with an `Invoices` array in the request body |
  **unitdp** | **Integer**| e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts | [optional] 
  **idempotency_key** | **String**| This allows you to safely retry requests without the risk of duplicate processing. 128 character max. | [optional] 
 
@@ -16648,4 +16648,3 @@ Name | Type | Description  | Notes
 
 - **Content-Type**: application/json
 - **Accept**: application/json
-
diff --git a/docs/accounting/index.html b/docs/accounting/index.html
index fa051bd4..6ac77614 100644
--- a/docs/accounting/index.html
+++ b/docs/accounting/index.html
@@ -12209,7 +12209,7 @@ <h2>Parameters</h2>
         Invoices
         </span>
         <div class="inner description marked">
-          Invoices with an array of invoice objects in body of request
+          Wrapper hash with an `Invoices` array in the request body
         </div>
       </div>
       <div class="inner required">
@@ -12218,7 +12218,7 @@ <h2>Parameters</h2>
     </div>
     <script type="application/ld+json">
       {
-  "description" : "Invoices with an array of invoice objects in body of request",
+  "description" : "Wrapper hash with an `Invoices` array in the request body",
   "content" : {
     "application/json" : {
       "schema" : {
@@ -41046,7 +41046,7 @@ <h2>Parameters</h2>
         Invoices
         </span>
         <div class="inner description marked">
-          
+          Wrapper hash with an `Invoices` array in the request body
         </div>
       </div>
       <div class="inner required">
@@ -41055,6 +41055,7 @@ <h2>Parameters</h2>
     </div>
     <script type="application/ld+json">
       {
+  "description" : "Wrapper hash with an `Invoices` array in the request body",
   "content" : {
     "application/json" : {
       "schema" : {
diff --git a/lib/xero-ruby/api/accounting_api.rb b/lib/xero-ruby/api/accounting_api.rb
index 721bc09b..5e859b47 100644
--- a/lib/xero-ruby/api/accounting_api.rb
+++ b/lib/xero-ruby/api/accounting_api.rb
@@ -2173,7 +2173,7 @@ def create_invoice_history_with_http_info(xero_tenant_id, invoice_id, history_re
 
     # Creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param invoices [Invoices] Invoices with an array of invoice objects in body of request
+    # @param invoices [Invoices] Wrapper hash with an `Invoices` array in the request body
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :summarize_errors If false return 200 OK and mix of successfully created objects and any with validation errors (default to false)
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
@@ -2186,7 +2186,7 @@ def create_invoices(xero_tenant_id, invoices, opts = {})
 
     # Creates one or more sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
-    # @param invoices [Invoices] Invoices with an array of invoice objects in body of request
+    # @param invoices [Invoices] Wrapper hash with an `Invoices` array in the request body
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :summarize_errors If false return 200 OK and mix of successfully created objects and any with validation errors
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
@@ -17093,7 +17093,7 @@ def update_expense_claim_with_http_info(xero_tenant_id, expense_claim_id, expens
     # Updates a specific sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
-    # @param invoices [Invoices] 
+    # @param invoices [Invoices] Wrapper hash with an `Invoices` array in the request body
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
     # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
@@ -17106,7 +17106,7 @@ def update_invoice(xero_tenant_id, invoice_id, invoices, opts = {})
     # Updates a specific sales invoices or purchase bills
     # @param xero_tenant_id [String] Xero identifier for Tenant
     # @param invoice_id [String] Unique identifier for an Invoice
-    # @param invoices [Invoices] 
+    # @param invoices [Invoices] Wrapper hash with an `Invoices` array in the request body
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :unitdp e.g. unitdp&#x3D;4 – (Unit Decimal Places) You can opt in to use four decimal places for unit amounts
     # @option opts [String] :idempotency_key This allows you to safely retry requests without the risk of duplicate processing. 128 character max.