younifyd
Menu

Delete Credit Note Allocations

Deletes an Allocation from a Credit Note

DELETE/CreditNotes/{CreditNoteID}/Allocations/{AllocationID}

Use it in a workflow

  1. Add a step and choose the Xero connector.
  2. Pick the Delete Credit Note Allocations action (under Xero).
  3. Fill in the fields below, then reference the result from later steps as {{deleteCreditNoteAllocations.response.data}}.

Request

Path parameters

CreditNoteIDstring (uuid)required

Unique identifier for a Credit Note

AllocationIDstring (uuid)required

Unique identifier for Allocation object

Headers

xero-tenant-idstringrequired

Xero identifier for Tenant

Response

Returns 200 with an object. Read it in later steps with {{deleteCreditNoteAllocations.response.data.<field>}}.

AllocationIDstring (uuid)

Xero generated unique identifier

Invoiceobject
Typestring

See Invoice Types

One ofACCPAYACCPAYCREDITAPOVERPAYMENTAPPREPAYMENTACCRECACCRECCREDITAROVERPAYMENTARPREPAYMENT

Contactobject40 fields
LineItemsarray<object>18 fields

See LineItems

Datestring

Date invoice was issued – YYYY-MM-DD. If the Date element is not specified it will default to the current date based on the timezone setting of the organisation

DueDatestring

Date invoice is due – YYYY-MM-DD

LineAmountTypesstring

Line amounts are exclusive of tax by default if you don’t specify this element. See Line Amount Types

One ofExclusiveInclusiveNoTax

InvoiceNumberstring

ACCREC – Unique alpha numeric code identifying invoice (when missing will auto-generate from your Organisation Invoice Settings) (max length = 255)

Referencestring

ACCREC only – additional reference number

BrandingThemeIDstring (uuid)

See BrandingThemes

Urlstring

URL link to a source document – shown as “Go to [appName]” in the Xero app

CurrencyCodestring

3 letter alpha code for the currency – see list of currency codes

One ofAEDAFNALLAMDANGAOAARSAUDAWGAZNBAMBBDBDTBGNBHDBIFBMDBNDBOBBRLBSDBTNBWPBYNBYRBZDCADCDFCHFCLFCLPCNYCOPCRCCUCCUPCVECZKDJFDKK

CurrencyRatenumber (double)

The currency rate for a multicurrency invoice. If no rate is specified, the XE.com day rate is used. (max length = [18].[6])

Statusstring

See Invoice Status Codes

One ofDRAFTSUBMITTEDDELETEDAUTHORISEDPAIDVOIDED

SentToContactboolean

Boolean to set whether the invoice in the Xero app should be marked as “sent”. This can be set only on invoices that have been approved

ExpectedPaymentDatestring

Shown on sales invoices (Accounts Receivable) when this has been set

PlannedPaymentDatestring

Shown on bills (Accounts Payable) when this has been set

CISDeductionnumber (double)

CIS deduction for UK contractors

CISRatenumber (double)

CIS Deduction rate for the organisation

SubTotalnumber (double)

Total of invoice excluding taxes

TotalTaxnumber (double)

Total tax on invoice

Totalnumber (double)

Total of Invoice tax inclusive (i.e. SubTotal + TotalTax). This will be ignored if it doesn’t equal the sum of the LineAmounts

TotalDiscountnumber (double)

Total of discounts applied on the invoice line items

InvoiceIDstring (uuid)

Xero generated unique identifier for invoice

RepeatingInvoiceIDstring (uuid)

Xero generated unique identifier for repeating invoices

HasAttachmentsboolean

boolean to indicate if an invoice has an attachment

Default "false"

IsDiscountedboolean

boolean to indicate if an invoice has a discount

Paymentsarray<object>29 fields

See Payments

Prepaymentsarray<object>23 fields

See Prepayments

Overpaymentsarray<object>21 fields

See Overpayments

AmountDuenumber (double)

Amount remaining to be paid on invoice

AmountPaidnumber (double)

Sum of payments received for invoice

FullyPaidOnDatestring

The date the invoice was fully paid. Only returned on fully paid invoices

AmountCreditednumber (double)

Sum of all credit notes, over-payments and pre-payments applied to invoice

UpdatedDateUTCstring

UTC timestamp of last update to the invoice

UpdatedDateUTCStringstring

UTC ISO-8601 formatted timestamp of last update to the invoice

CreditNotesarray<object>

Details of credit notes that have been applied to an invoice

Attachmentsarray<object>6 fields

Displays array of attachments from the API

HasErrorsboolean

A boolean to indicate if a invoice has an validation errors

Default "false"

StatusAttributeStringstring

A string to indicate if a invoice status

ValidationErrorsarray<object>1 fields

Displays array of validation error messages from the API

Overpaymentobject
Typeobject

(schema truncated: exceeded maximum nesting depth)

Contactobject

(schema truncated: exceeded maximum nesting depth)

Dateobject

(schema truncated: exceeded maximum nesting depth)

Statusobject

(schema truncated: exceeded maximum nesting depth)

LineAmountTypesobject

(schema truncated: exceeded maximum nesting depth)

LineItemsobject

(schema truncated: exceeded maximum nesting depth)

SubTotalobject

(schema truncated: exceeded maximum nesting depth)

TotalTaxobject

(schema truncated: exceeded maximum nesting depth)

Totalobject

(schema truncated: exceeded maximum nesting depth)

UpdatedDateUTCobject

(schema truncated: exceeded maximum nesting depth)

UpdatedDateUTCStringobject

(schema truncated: exceeded maximum nesting depth)

CurrencyCodeobject

(schema truncated: exceeded maximum nesting depth)

OverpaymentIDobject

(schema truncated: exceeded maximum nesting depth)

CurrencyRateobject

(schema truncated: exceeded maximum nesting depth)

RemainingCreditobject

(schema truncated: exceeded maximum nesting depth)

Allocationsobject

(schema truncated: exceeded maximum nesting depth)

AppliedAmountobject

(schema truncated: exceeded maximum nesting depth)

Paymentsobject

(schema truncated: exceeded maximum nesting depth)

HasAttachmentsobject

(schema truncated: exceeded maximum nesting depth)

Referenceobject

(schema truncated: exceeded maximum nesting depth)

Attachmentsobject

(schema truncated: exceeded maximum nesting depth)

Prepaymentobject
Typeobject

(schema truncated: exceeded maximum nesting depth)

Contactobject

(schema truncated: exceeded maximum nesting depth)

Dateobject

(schema truncated: exceeded maximum nesting depth)

Statusobject

(schema truncated: exceeded maximum nesting depth)

LineAmountTypesobject

(schema truncated: exceeded maximum nesting depth)

LineItemsobject

(schema truncated: exceeded maximum nesting depth)

SubTotalobject

(schema truncated: exceeded maximum nesting depth)

TotalTaxobject

(schema truncated: exceeded maximum nesting depth)

Totalobject

(schema truncated: exceeded maximum nesting depth)

Referenceobject

(schema truncated: exceeded maximum nesting depth)

InvoiceNumberobject

(schema truncated: exceeded maximum nesting depth)

UpdatedDateUTCobject

(schema truncated: exceeded maximum nesting depth)

UpdatedDateUTCStringobject

(schema truncated: exceeded maximum nesting depth)

CurrencyCodeobject

(schema truncated: exceeded maximum nesting depth)

PrepaymentIDobject

(schema truncated: exceeded maximum nesting depth)

BrandingThemeIDobject

(schema truncated: exceeded maximum nesting depth)

CurrencyRateobject

(schema truncated: exceeded maximum nesting depth)

RemainingCreditobject

(schema truncated: exceeded maximum nesting depth)

Allocationsobject

(schema truncated: exceeded maximum nesting depth)

Paymentsobject

(schema truncated: exceeded maximum nesting depth)

AppliedAmountobject

(schema truncated: exceeded maximum nesting depth)

HasAttachmentsobject

(schema truncated: exceeded maximum nesting depth)

Attachmentsobject

(schema truncated: exceeded maximum nesting depth)

CreditNoteobject

Circular reference: #/components/schemas/CreditNote

Amountnumber (double)

the amount being applied to the invoice

Datestring

the date the allocation is applied YYYY-MM-DD.

IsDeletedboolean

A flag that returns true when the allocation is succesfully deleted

StatusAttributeStringstring

A string to indicate if a invoice status

ValidationErrorsarray<object>

Displays array of validation error messages from the API

Messagestring

Validation error message

json
{
  "Invoice": {
    "Type": "ACCPAY",
    "Contact": {
      "ContactID": "00000000-0000-0000-0000-000000000000",
      "MergedToContactID": "00000000-0000-0000-0000-000000000000",
      "ContactNumber": "string",
      "AccountNumber": "string",
      "ContactStatus": "ACTIVE",
      "Name": "string",
      "FirstName": "string",
      "LastName": "string",
      "CompanyNumber": "string",
      "EmailAddress": "string",
      "ContactPersons": [
        {
          "FirstName": "string",
          "LastName": "string",
          "EmailAddress": "string",
          "IncludeInEmails": false
        }
      ],
      "BankAccountDetails": "string"
    },
    "LineItems": [
      {
        "LineItemID": "00000000-0000-0000-0000-000000000000",
        "Description": "string",
        "Quantity": 0,
        "UnitAmount": 0,
        "ItemCode": "string",
        "AccountCode": "string",
        "AccountID": "00000000-0000-0000-0000-000000000000",
        "TaxType": "string",
        "TaxAmount": 0,
        "Item": {
          "Code": "string",
          "Name": "string",
          "ItemID": "00000000-0000-0000-0000-000000000000"
        },
        "LineAmount": 0,
        "Tracking": [
          {
            "TrackingCategoryID": "00000000-0000-0000-0000-000000000000",
            "TrackingOptionID": "00000000-0000-0000-0000-000000000000",
            "Name": "Region",
            "Option": "North"
          }
        ]
      }
    ],
    "Date": "string",
    "DueDate": "string",
    "LineAmountTypes": "Exclusive",
    "InvoiceNumber": "string",
    "Reference": "string",
    "BrandingThemeID": "00000000-0000-0000-0000-000000000000",
    "Url": "string",
    "CurrencyCode": "AED",
    "CurrencyRate": 0
  },
  "Amount": 0,
  "Date": "string",
  "AllocationID": "00000000-0000-0000-0000-000000000000",
  "Overpayment": {
    "Type": {},
    "Contact": {},
    "Date": {},
    "Status": {},
    "LineAmountTypes": {},
    "LineItems": {},
    "SubTotal": {},
    "TotalTax": {},
    "Total": {},
    "UpdatedDateUTC": {},
    "UpdatedDateUTCString": {},
    "CurrencyCode": {}
  },
  "Prepayment": {
    "Type": {},
    "Contact": {},
    "Date": {},
    "Status": {},
    "LineAmountTypes": {},
    "LineItems": {},
    "SubTotal": {},
    "TotalTax": {},
    "Total": {},
    "Reference": {},
    "InvoiceNumber": {},
    "UpdatedDateUTC": {}
  },
  "CreditNote": {},
  "IsDeleted": false,
  "StatusAttributeString": "string",
  "ValidationErrors": [
    {
      "Message": "string"
    }
  ]
}

Need more? See the Xero guide for connection setup and behaviour shared by every action.

Was this page helpful?
Delete Credit Note Allocations — Xero — Documentation