Merge branch 'master' into master

Author: kurtlnz

xero-app-store.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero AppStore API
   description: These endpoints are for Xero Partners to interact with the App Store Billing platform
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/

xero-finance.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero Finance API
   description: The Finance API is a collection of endpoints which customers can use in the course of a loan application, which may assist lenders to gain the confidence they need to provide capital.
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/

xero-identity.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero OAuth 2 Identity Service API
   description: These endpoints are related to managing authentication tokens and identity for Xero API
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/

xero-payroll-au.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero Payroll AU API
   description: This is the Xero Payroll API for orgs in Australia region.
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/

xero-payroll-nz.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: "Xero Payroll NZ"
   description: "This is the Xero Payroll API for orgs in the NZ region."
   termsOfService: "https://developer.xero.com/xero-developer-platform-terms-conditions/"
@@ -1565,22 +1565,6 @@ paths:
           default: 25.89
           is_money: true
           object: employeeLeaveSetup
-        - sickLeaveHoursToAccrueAnnually:
-          key: sickLeaveHoursToAccrueAnnually
-          keyPascal: SickLeaveHoursToAccrueAnnually
-          keySnake: sick_leave_hours_to_accrue_annually
-          nonString: true
-          default: 100.0
-          is_money: true
-          object: employeeLeaveSetup
-        - sickLeaveMaximumHoursToAccrue:
-          key: sickLeaveMaximumHoursToAccrue
-          keyPascal: SickLeaveMaximumHoursToAccrue
-          keySnake: sick_leave_maximum_hours_to_accrue
-          is_money: true
-          nonString: true
-          default: 200.0
-          object: employeeLeaveSetup
         - sickLeaveOpeningBalance:
           key: sickLeaveOpeningBalance
           keyPascal: SickLeaveOpeningBalance
@@ -1659,9 +1643,7 @@ paths:
                   holidayPayOpeningBalance: 10
                   annualLeaveOpeningBalance: 100
                   negativeAnnualLeaveBalancePaidAmount: null
-                  sickLeaveHoursToAccrueAnnually: 20
                   sickLeaveToAccrueAnnually: 20
-                  sickLeaveMaximumHoursToAccrue: null
                   sickLeaveMaximumToAccrue: null
                   sickLeaveOpeningBalance: 10
                   sickLeaveScheduleOfAccrual: OnAnniversaryDate
@@ -1682,7 +1664,6 @@ paths:
             example:
               holidayPayOpeningBalance: 10
               annualLeaveOpeningBalance: 100
-              sickLeaveHoursToAccrueAnnually: 20
               sickLeaveToAccrueAnnually: 20
               sickLeaveOpeningBalance: 10
               sickLeaveScheduleOfAccrual: OnAnniversaryDate
@@ -1728,7 +1709,6 @@ paths:
                 leaveTypes:
                   - leaveTypeID: 0441497f-5dc7-4cd3-a90d-f2e07e21b2a6
                     scheduleOfAccrual: PercentageOfGrossEarnings
-                    hoursAccruedAnnually: 0
                     maximumToAccrue: 0
                     openingBalance: 0
                     rateAccruedHourly: null
@@ -1825,7 +1805,6 @@ paths:
                 leaveType:
                   leaveTypeID: 35da97ae-05b9-427f-9a98-69157ba42cec
                   scheduleOfAccrual: AnnuallyAfter6Months
-                  hoursAccruedAnnually: 10
                   maximumToAccrue: 80
                   openingBalance: 100
                   rateAccruedHourly: null
@@ -1852,13 +1831,12 @@ paths:
             example:
               leaveTypeID: 35da97ae-05b9-427f-9a98-69157ba42cec
               scheduleOfAccrual: AnnuallyAfter6Months
-              hoursAccruedAnnually: 10
               unitsAccruedAnnually: 10
               typeOfUnitsToAccrue: Hours
               openingBalanceTypeOfUnits: Hours
               maximumToAccrue: 80
               openingBalance: 100
-              rateAccruedHourly: 3.5
+              rateAccruedHourly: null
   /Employees/{EmployeeID}/PaymentMethods:
     parameters:
       - $ref: "#/components/parameters/requiredHeader"
@@ -6892,18 +6870,6 @@ components:
           format: double
           x-is-money: true
           example: 10.0
-        sickLeaveHoursToAccrueAnnually:
-          description: Deprecated use SickLeaveToAccrueAnnually
-          type: number
-          format: double
-          x-is-money: true
-          example: 100.5
-        sickLeaveMaximumHoursToAccrue:
-          description: Deprecated use SickLeaveMaximumToAccrue
-          type: number
-          format: double
-          x-is-money: true
-          example: 200.5
         SickLeaveToAccrueAnnually:
           description: Number of units accrued annually for sick leave. The type of units is determined by the property "TypeOfUnitsToAccrue" on the "Sick Leave" leave type
           type: number
@@ -6962,12 +6928,7 @@ components:
             - OnAnniversaryDate
             - PercentageOfGrossEarnings
             - NoAccruals
-        hoursAccruedAnnually:
-          description: Deprecated use UnitsAccruedAnnually
-          type: number
-          format: double
-          x-is-money: true
-        UnitsAccruedAnnually:
+        unitsAccruedAnnually:
           description: The number of units accrued for the leave annually. This is 0 when the ScheduleOfAccrual chosen is "NoAccruals"
           type: number
           format: double
@@ -6989,7 +6950,7 @@ components:
           description: The type of units for the opening balance
           type: string
         rateAccruedHourly:
-          description: The number of hours added to the leave balance for every hour worked by the employee. This is normally 0, unless the scheduleOfAccrual chosen is "OnHourWorked"
+          description: not supported in Payroll NZ
           type: number
           format: double
           x-is-money: true

xero-payroll-uk.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: "Xero Payroll UK"
   description: "This is the Xero Payroll API for orgs in the UK region."
   termsOfService: "https://developer.xero.com/xero-developer-platform-terms-conditions/"

xero-projects.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero Projects API
   description: This is the Xero Projects API
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/

xero-webhooks.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.1
 info:
   description: The Xero Webhooks API exposes event notifications relating to entities in the Xero Public API and can be used for a variety of purposes
   title: Xero Webhooks API
-  version: 9.3.0
+  version: 10.0.0
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/
   contact:
     name: Xero Platform Team
@@ -64,6 +64,43 @@ webhooks:
           $ref: "#/components/responses/200WebhookDataReceivedOk"
         "401":
           $ref: "#/components/responses/401InvalidWebhookData"
+  creditNotes:
+    post:
+      summary: Credit Notes Webhook Endpoint
+      description: Credit Note (Create, Update)
+      operationId: publishCreditNoteEvent
+      tags:
+        - Events
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/CreditNoteWebhookEvent"
+            examples:
+              creditNoteCreate:
+                summary: Credit Note Create Event
+                value:
+                  events:
+                    - resourceUrl: https://api.xero.com/api.xro/2.0/CreditNotes/55d84274-a3da-4829-a7c0-0cab601b95cc
+                      resourceId: 55d84274-a3da-4829-a7c0-0cab601b95cc
+                      tenantId: aef86862-2015-4b6b-88bc-d89032cecc50
+                      tenantType: ORGANISATION
+                      eventCategory: CREDITNOTE
+                      eventType: CREATE
+                      eventDateUtc: 2025-12-02T00:44:09.923
+                      data:
+                        Type: ACCPAYCREDIT
+                        Status: DRAFT
+                  firstEventSequence: 76
+                  lastEventSequence: 76
+                  entropy: FXNGWLCCGVANWHKILRUB
+      responses:
+        "200":
+          $ref: "#/components/responses/200WebhookDataReceivedOk"
+        "401":
+          $ref: "#/components/responses/401InvalidWebhookData"
+
+
 components:
   headers:
     x-xero-signature:
@@ -119,6 +156,9 @@ components:
                   - type: string
                     const: SUBSCRIPTION
                     description: For application subscription-related events
+                  - type: string
+                    const: CREDITNOTE
+                    description: For organisation credit note-related events
               tenantId:
                 type: string
                 format: uuid
@@ -155,6 +195,65 @@ components:
         entropy:
           type: string
           description: A random string used for security or validation purposes
+    CreditNoteWebhookEvent:
+      allOf:
+        - $ref: "#/components/schemas/WebhookEvent"
+        - type: object
+          properties:
+            events:
+              type: array
+              items:
+                allOf:
+                  - $ref: "#/components/schemas/WebhookEvent/properties/events/items"
+                  - type: object
+                    properties:
+                      eventCategory:
+                        const: CREDITNOTE
+                      data:
+                        type: object
+                        description: Additional data for credit note events
+                        required:
+                          - Type
+                          - Status
+                        properties:
+                          Type:
+                            type: string
+                            description: The type of credit note
+                            externalDocs:
+                              url: https://developer.xero.com/documentation/api/accounting/types#credit-notes
+                            oneOf:
+                              - type: string
+                                const: ACCPAYCREDIT
+                                description: An Accounts Payable(supplier) Credit Note
+                              - type: string
+                                const: ACCRECCREDIT
+                                description: An Account Receivable(customer) Credit Note
+                          Status:
+                            type: string
+                            description: The status of the credit note
+                            externalDocs:
+                              url: https://developer.xero.com/documentation/api/accounting/types#invoice-status-codes
+                            oneOf:
+                              - type: string
+                                const: DRAFT
+                                description: Draft credit note
+                              - type: string
+                                const: SUBMITTED
+                                description: Submitted credit note
+                              - type: string
+                                const: DELETED
+                                description: Deleted credit note
+                              - type: string
+                                const: AUTHORISED
+                                description: Authorised credit note
+                              - type: string
+                                const: PAID
+                                description: Paid credit note
+                              - type: string
+                                const: VOIDED
+                                description: Voided credit note
+                    required:
+                      - data
   responses:
     401InvalidWebhookData:
       description: Return a 401 status to indicate that the webhook subscription failed

xero_accounting.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: Xero Accounting API
-  version: 9.3.0
+  version: 10.0.0
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/
   contact:
     name: Xero Platform Team

xero_assets.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 9.3.0
+  version: 10.0.0
   title: Xero Assets API
   description: The Assets API exposes fixed asset related functions of the Xero Accounting application and can be used for a variety of purposes such as creating assets, retrieving asset valuations etc.
   termsOfService: https://developer.xero.com/xero-developer-platform-terms-conditions/