Xero · Schema

CreditNote

AccountingBank FeedsFinanceFinancial ServicesInvoicingPayrollSmall Business

Properties

Name Type Description
Type string See Credit Note Types
Contact object
Date string The date the credit note is issued YYYY-MM-DD. If the Date element is not specified then it will default to the current date based on the timezone setting of the organisation
DueDate string Date invoice is due – YYYY-MM-DD
Status string See Credit Note Status Codes
LineAmountTypes string
LineItems array See Invoice Line Items
SubTotal number The subtotal of the credit note excluding taxes
TotalTax number The total tax on the credit note
Total number The total of the Credit Note(subtotal + total tax)
CISDeduction number CIS deduction for UK contractors
CISRate number CIS Deduction rate for the organisation
UpdatedDateUTC string UTC timestamp of last update to the credit note
CurrencyCode string The specified currency code
FullyPaidOnDate string Date when credit note was fully paid(UTC format)
CreditNoteID string Xero generated unique identifier
CreditNoteNumber string ACCRECCREDIT – Unique alpha numeric code identifying credit note (when missing will auto-generate from your Organisation Invoice Settings)
Reference string ACCRECCREDIT only – additional reference number
SentToContact boolean 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 number The currency rate for a multicurrency invoice. If no rate is specified, the XE.com day rate is used
RemainingCredit number The remaining credit balance on the Credit Note
Allocations array See Allocations
AppliedAmount number The amount of applied to an invoice
Payments array See Payments
BrandingThemeID string See BrandingThemes
StatusAttributeString string A string to indicate if a invoice status
HasAttachments boolean boolean to indicate if a credit note has an attachment
HasErrors boolean A boolean to indicate if a credit note has an validation errors
ValidationErrors array Displays array of validation error messages from the API
Warnings array Displays array of warning messages from the API
InvoiceAddresses array An array of addresses used to auto calculate sales tax
View JSON Schema on GitHub

JSON Schema

xero-creditnote-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CreditNote",
  "title": "CreditNote",
  "externalDocs": {
    "url": "http://developer.xero.com/documentation/api/credit-notes/"
  },
  "properties": {
    "Type": {
      "description": "See Credit Note Types",
      "type": "string",
      "enum": [
        "ACCPAYCREDIT",
        "ACCRECCREDIT"
      ]
    },
    "Contact": {
      "$ref": "#/components/schemas/Contact"
    },
    "Date": {
      "description": "The date the credit note is issued YYYY-MM-DD. If the Date element is not specified then it will default to the current date based on the timezone setting of the organisation",
      "type": "string",
      "x-is-msdate": true
    },
    "DueDate": {
      "description": "Date invoice is due \u2013 YYYY-MM-DD",
      "type": "string",
      "x-is-msdate": true
    },
    "Status": {
      "description": "See Credit Note Status Codes",
      "type": "string",
      "enum": [
        "DRAFT",
        "SUBMITTED",
        "DELETED",
        "AUTHORISED",
        "PAID",
        "VOIDED"
      ]
    },
    "LineAmountTypes": {
      "$ref": "#/components/schemas/LineAmountTypes",
      "type": "string"
    },
    "LineItems": {
      "description": "See Invoice Line Items",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LineItem"
      }
    },
    "SubTotal": {
      "description": "The subtotal of the credit note excluding taxes",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "TotalTax": {
      "description": "The total tax on the credit note",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "Total": {
      "description": "The total of the Credit Note(subtotal + total tax)",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "CISDeduction": {
      "description": "CIS deduction for UK contractors",
      "readOnly": true,
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "CISRate": {
      "description": "CIS Deduction rate for the organisation",
      "type": "number",
      "format": "double",
      "readOnly": true,
      "x-is-money": true
    },
    "UpdatedDateUTC": {
      "description": "UTC timestamp of last update to the credit note",
      "type": "string",
      "x-is-msdate-time": true,
      "example": "/Date(1573755038314)/",
      "readOnly": true
    },
    "CurrencyCode": {
      "description": "The specified currency code",
      "$ref": "#/components/schemas/CurrencyCode",
      "type": "string"
    },
    "FullyPaidOnDate": {
      "description": "Date when credit note was fully paid(UTC format)",
      "type": "string",
      "x-is-msdate": true
    },
    "CreditNoteID": {
      "description": "Xero generated unique identifier",
      "type": "string",
      "format": "uuid"
    },
    "CreditNoteNumber": {
      "description": "ACCRECCREDIT \u2013 Unique alpha numeric code identifying credit note (when missing will auto-generate from your Organisation Invoice Settings)",
      "type": "string"
    },
    "Reference": {
      "description": "ACCRECCREDIT only \u2013 additional reference number",
      "type": "string"
    },
    "SentToContact": {
      "description": "Boolean to set whether the credit note in the Xero app should be marked as \u201csent\u201d. This can be set only on credit notes that have been approved",
      "readOnly": true,
      "type": "boolean"
    },
    "CurrencyRate": {
      "description": "The currency rate for a multicurrency invoice. If no rate is specified, the XE.com day rate is used",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "RemainingCredit": {
      "description": "The remaining credit balance on the Credit Note",
      "type": "number",
      "format": "double",
      "x-is-money": true
    },
    "Allocations": {
      "description": "See Allocations",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Allocation"
      }
    },
    "AppliedAmount": {
      "description": "The amount of applied to an invoice",
      "type": "number",
      "format": "double",
      "example": 2.0,
      "x-is-money": true
    },
    "Payments": {
      "description": "See Payments",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Payment"
      }
    },
    "BrandingThemeID": {
      "description": "See BrandingThemes",
      "type": "string",
      "format": "uuid"
    },
    "StatusAttributeString": {
      "description": "A string to indicate if a invoice status",
      "type": "string"
    },
    "HasAttachments": {
      "description": "boolean to indicate if a credit note has an attachment",
      "type": "boolean",
      "default": "false",
      "example": "false"
    },
    "HasErrors": {
      "description": "A boolean to indicate if a credit note has an validation errors",
      "type": "boolean",
      "default": "false",
      "example": "false"
    },
    "ValidationErrors": {
      "description": "Displays array of validation error messages from the API",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ValidationError"
      }
    },
    "Warnings": {
      "description": "Displays array of warning messages from the API",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ValidationError"
      }
    },
    "InvoiceAddresses": {
      "description": "An array of addresses used to auto calculate sales tax",
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/InvoiceAddress"
      }
    }
  },
  "type": "object"
}