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 |
JSON Schema
{
"$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"
}