From 6f8ac6fac460bbfb638a6225ed7f76352ad7faad Mon Sep 17 00:00:00 2001 From: Github Actions Date: Fri, 4 Sep 2026 02:50:52 +0000 Subject: [PATCH] Releasing 18.2.0 (OAS: 19.0.0) --- Gemfile.lock | 2 +- docs/accounting/Invoice.md | 10 +++++-- docs/accounting/index.html | 26 +++++++++++------ docs/app_store/index.html | 2 +- docs/assets/index.html | 2 +- docs/files/index.html | 2 +- docs/finance/index.html | 2 +- docs/payroll_au/index.html | 2 +- docs/payroll_au_v2/index.html | 2 +- docs/payroll_nz/index.html | 2 +- docs/payroll_uk/index.html | 4 +-- docs/projects/index.html | 2 +- lib/xero-ruby/models/accounting/invoice.rb | 28 ++++++++++++++++--- .../models/payroll_uk/employment_status.rb | 1 + lib/xero-ruby/version.rb | 4 +-- 15 files changed, 62 insertions(+), 29 deletions(-) diff --git a/Gemfile.lock b/Gemfile.lock index 53563a88..58c63620 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,7 +1,7 @@ PATH remote: . specs: - xero-ruby (18.1.0) + xero-ruby (18.2.0) faraday (>= 2.0, < 3.0) json (~> 2.1, >= 2.1.0) json-jwt (~> 1.16, >= 1.16.3) diff --git a/docs/accounting/Invoice.md b/docs/accounting/Invoice.md index 3cbb469b..cf0575dd 100644 --- a/docs/accounting/Invoice.md +++ b/docs/accounting/Invoice.md @@ -22,10 +22,12 @@ Name | Type | Description | Notes **planned_payment_date** | **Date** | Shown on bills (Accounts Payable) when this has been set | [optional] **cis_deduction** | **BigDecimal** | CIS deduction for UK contractors | [optional] **cis_rate** | **BigDecimal** | CIS Deduction rate for the organisation | [optional] -**sub_total** | **BigDecimal** | Total of invoice excluding taxes | [optional] -**total_tax** | **BigDecimal** | Total tax on invoice | [optional] -**total** | **BigDecimal** | Total of Invoice tax inclusive (i.e. SubTotal + TotalTax). This will be ignored if it doesn’t equal the sum of the LineAmounts | [optional] +**sub_total** | **BigDecimal** | Total of invoice excluding taxes. Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can SubTotal be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with TotalTax and Total, it is validated against the calculated line item totals (see RoundingAmount); it is ignored in all other cases. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET) | [optional] +**total_tax** | **BigDecimal** | Total tax on invoice. Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can TotalTax be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with SubTotal and Total, it is validated against the calculated line item totals (see RoundingAmount); it is ignored in all other cases. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET) | [optional] +**total** | **BigDecimal** | Total of Invoice tax inclusive (i.e. SubTotal + TotalTax + RoundingAmount). Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can Total be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with SubTotal and TotalTax, it is validated against the calculated line item totals plus RoundingAmount; in all other cases this will be ignored if it does not equal the sum of the LineAmounts. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET) | [optional] **total_discount** | **BigDecimal** | Total of discounts applied on the invoice line items | [optional] +**rounding_amount** | **BigDecimal** | An optional rounding adjustment added to SubTotal + TotalTax to give Total (i.e. Total = SubTotal + TotalTax + RoundingAmount). Only applies to ACCPAY and ACCREC invoices, and only if this opt-in capability has been enabled for your organisation. Not validated while the invoice is DRAFT. For SUBMITTED and AUTHORISED invoices, RoundingAmount is only applied when SubTotal, TotalTax and Total are all supplied together, and must be between -0.10 and 0.10 – values outside this range are rejected with a validation error (on DRAFT invoices, an out-of-range value is ignored instead). This field is only settable and only returned via the Create and Update endpoints (POST/PUT) and when retrieving a single invoice by ID (GET by ID) – it is not returned when listing invoices (GET) | [optional] +**entered_total** | **BigDecimal** | The total amount as originally entered for the invoice, before any RoundingAmount adjustment is applied. Only applies to ACCPAY and ACCREC invoices, and only if this opt-in capability has been enabled for your organisation. Can only be set while the invoice is DRAFT; once the invoice is no longer DRAFT this reflects Total. This field is only settable and only returned via the Create and Update endpoints (POST/PUT) and when retrieving a single invoice by ID (GET by ID) – it is not returned when listing invoices (GET) | [optional] **invoice_id** | **String** | Xero generated unique identifier for invoice | [optional] **repeating_invoice_id** | **String** | Xero generated unique identifier for repeating invoices | [optional] **has_attachments** | **Boolean** | boolean to indicate if an invoice has an attachment | [optional] [default to false] @@ -74,6 +76,8 @@ instance = XeroRuby::Accounting::Invoice.new(type: null, total_tax: null, total: null, total_discount: null, + rounding_amount: null, + entered_total: null, invoice_id: null, repeating_invoice_id: null, has_attachments: false, diff --git a/docs/accounting/index.html b/docs/accounting/index.html index 69a51549..90e2f7cf 100644 --- a/docs/accounting/index.html +++ b/docs/accounting/index.html @@ -2576,8 +2576,7 @@ }, "SentToContact" : { "type" : "boolean", - "description" : "Boolean to set whether the credit note in the Xero app should be marked as “sent”. This can be set only on credit notes that have been approved", - "readOnly" : true + "description" : "Boolean to set whether the credit note in the Xero app should be marked as “sent”. This can be set only on credit notes that have been approved" }, "CurrencyRate" : { "type" : "number", @@ -3204,23 +3203,20 @@ }, "SubTotal" : { "type" : "number", - "description" : "Total of invoice excluding taxes", + "description" : "Total of invoice excluding taxes. Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can SubTotal be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with TotalTax and Total, it is validated against the calculated line item totals (see RoundingAmount); it is ignored in all other cases. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET)\n", "format" : "double", - "readOnly" : true, "x-is-money" : true }, "TotalTax" : { "type" : "number", - "description" : "Total tax on invoice", + "description" : "Total tax on invoice. Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can TotalTax be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with SubTotal and Total, it is validated against the calculated line item totals (see RoundingAmount); it is ignored in all other cases. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET)\n", "format" : "double", - "readOnly" : true, "x-is-money" : true }, "Total" : { "type" : "number", - "description" : "Total of Invoice tax inclusive (i.e. SubTotal + TotalTax). This will be ignored if it doesn’t equal the sum of the LineAmounts", + "description" : "Total of Invoice tax inclusive (i.e. SubTotal + TotalTax + RoundingAmount). Calculated automatically by Xero from the invoice's line items. Only for ACCPAY and ACCREC invoices, where this opt-in capability is enabled for your organisation, can Total be supplied on write – on a SUBMITTED or AUTHORISED invoice supplied together with SubTotal and TotalTax, it is validated against the calculated line item totals plus RoundingAmount; in all other cases this will be ignored if it does not equal the sum of the LineAmounts. This write behaviour, and the returned value reflecting it, only applies to the Create and Update endpoints (POST/PUT) and to retrieving a single invoice by ID (GET by ID) – it does not apply when listing invoices (GET)\n", "format" : "double", - "readOnly" : true, "x-is-money" : true }, "TotalDiscount" : { @@ -3230,6 +3226,18 @@ "readOnly" : true, "x-is-money" : true }, + "RoundingAmount" : { + "type" : "number", + "description" : "An optional rounding adjustment added to SubTotal + TotalTax to give Total (i.e. Total = SubTotal + TotalTax + RoundingAmount). Only applies to ACCPAY and ACCREC invoices, and only if this opt-in capability has been enabled for your organisation. Not validated while the invoice is DRAFT. For SUBMITTED and AUTHORISED invoices, RoundingAmount is only applied when SubTotal, TotalTax and Total are all supplied together, and must be between -0.10 and 0.10 – values outside this range are rejected with a validation error (on DRAFT invoices, an out-of-range value is ignored instead). This field is only settable and only returned via the Create and Update endpoints (POST/PUT) and when retrieving a single invoice by ID (GET by ID) – it is not returned when listing invoices (GET)\n", + "format" : "double", + "x-is-money" : true + }, + "EnteredTotal" : { + "type" : "number", + "description" : "The total amount as originally entered for the invoice, before any RoundingAmount adjustment is applied. Only applies to ACCPAY and ACCREC invoices, and only if this opt-in capability has been enabled for your organisation. Can only be set while the invoice is DRAFT; once the invoice is no longer DRAFT this reflects Total. This field is only settable and only returned via the Create and Update endpoints (POST/PUT) and when retrieving a single invoice by ID (GET by ID) – it is not returned when listing invoices (GET)\n", + "format" : "double", + "x-is-money" : true + }, "InvoiceID" : { "type" : "string", "description" : "Xero generated unique identifier for invoice", @@ -6506,7 +6514,7 @@