Credit note
Stay organized with collections
Save and categorize content based on your preferences.
To improve readability, maintain consistency, and enhance interoperability, we
use the UBL 2.4 CreditNote schema to represent credit notes and cancel invoices
(complete invoice reversals). The CreditNote schema uses mostly the same fields
as the Invoice schema. This section indicates the dedicated elements for credit
memos and cancellations.
1.0 Credit note type code
Identifier of the document type. We use 381 to represent Credit Note and Cancel
Invoice.
Path |
Description |
Example |
cbc:CreditNoteTypeCode |
Type of the invoice. Supported values: 381 for Credit Note, 381 for Cancel Invoice |
381 |
Example
<CreditNote>
...
<cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
...
</CreditNote>
2.0 Invoice document reference
The BillingReference/InvoiceDocumentReference section provides information
related to the original invoice for invoice memos and cancellations. This
element is repeated when several invoice references are present (e.g., Google
commercial invoice ID, vendor generated ID, tax authority generated reference).
The attribute schemeID is used to identify the invoice issuer.
Path |
Description |
Example |
cbc:ID |
Preceding invoice number - Identifier of a previously issued invoice |
GCEMEAD000000099 |
cbc:ID @schemeID |
Identifier of the type of the invoice issuer |
Google, Vendor, local tax authority |
cbc:IssueDate |
Issue date - Issue date of the previously issued invoice. The format is "YYYY-MM-DD" |
2023-05-28 |
<CreditNote>
...
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID schemeID="Google">GCEMEAD000000099</cbc:ID>
<cbc:IssueDate>2023-05-28</cbc:IssueDate>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
...
</CreditNote>
3.0 Credit note line items
Line items are individual goods or services enumerated in the credit note. The
schema supports one or multiple credit note line items per credit note document.
3.1 cac:CreditNoteLine
This section details each item or service for which a credit is issued,
including unique identifiers, credited quantities, and unit prices. It provides
a complete breakdown of the amounts before taxes associated with each credited
line item.
Path |
Description |
Example |
cbc:ID |
Unique identifier for this line item; for an aggregated line item invoice the value is 1 |
1 |
cbc:CreditedQuantity |
Quantity of the item credited; for an aggregated line item the value is 1 |
1 |
cbc:LineExtensionAmount @currencyID |
Total amount for the line item in the original currency, excluding taxes |
1000 |
cac:Item/cbc:Name |
Name of the item |
Google Cloud |
cac:Price/cbc:PriceAmount @currencyID |
Unit price of the item in the original currency |
1000 |
<CreditNote>
...
<cac:CreditNoteLine>
<cbc:ID>1</cbc:ID>
<cbc:CreditedQuantity>1</cbc:CreditedQuantity>
<cbc:LineExtensionAmount currencyID="USD">1000</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>Google Cloud</cbc:Name>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="USD">1000</cbc:PriceAmount>
</cac:Price>
</cac:CreditNoteLine>
...
</CreditNote>
3.2 cac:CreditNoteLine/cac:TaxTotal
This section contains the total tax amount for the line item, as well as the
taxable amount, tax amount, and tax category.
Path |
Description |
Example |
cbc:TaxAmount @currencyID |
Total tax amount in the original currency for the line item |
70 |
cac:TaxSubtotal/cbc:TaxableAmount @currencyID |
Taxable amount in the original currency for the line item |
1000 |
cac:TaxSubtotal/cbc:TaxAmount @currencyID |
Tax amount in the original currency for the line item |
70 |
cac:TaxSubtotal/cac:TaxCategory/cbc:Percent |
Tax rate applied to the line item |
7.00 |
cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID |
Type of tax for this subtotal |
VAT |
<CreditNote>
...
<cac:CreditNoteLine>
...
<cac:TaxTotal>
<cbc:TaxAmount currencyID="USD">70</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="USD">70</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:Percent>7.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
</cac:CreditNoteLine>
...
</CreditNote>
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-11-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-14 UTC."],[[["\u003cp\u003eCredit notes and invoice cancellations are represented using the UBL 2.4 CreditNote schema, ensuring consistency and interoperability.\u003c/p\u003e\n"],["\u003cp\u003eA dedicated \u003ccode\u003eCreditNoteTypeCode\u003c/code\u003e with a value of 381 is used to identify credit notes and invoice cancellations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eBillingReference/InvoiceDocumentReference\u003c/code\u003e section provides details about the original invoice being credited or cancelled, including its ID, issue date, and issuer.\u003c/p\u003e\n"],["\u003cp\u003eCredit note line items, detailed within the \u003ccode\u003ecac:CreditNoteLine\u003c/code\u003e element, provide a breakdown of credited quantities, unit prices, and total amounts for each item or service.\u003c/p\u003e\n"],["\u003cp\u003eTax information for each line item is captured in the \u003ccode\u003ecac:CreditNoteLine/cac:TaxTotal\u003c/code\u003e section, specifying tax amounts, taxable amounts, tax rates, and tax categories.\u003c/p\u003e\n"]]],[],null,["# Credit note\n\nTo improve readability, maintain consistency, and enhance interoperability, we\nuse the UBL 2.4 CreditNote schema to represent credit notes and cancel invoices\n(complete invoice reversals). The CreditNote schema uses mostly the same fields\nas the Invoice schema. This section indicates the dedicated elements for credit\nmemos and cancellations.\n\n1.0 Credit note type code\n-------------------------\n\nIdentifier of the document type. We use 381 to represent Credit Note and Cancel\nInvoice.\n\n| **Path** | **Description** | **Example** |\n|----------------------------|------------------------------------------------------------------------------------|-------------|\n| **cbc:CreditNoteTypeCode** | Type of the invoice. Supported values: 381 for Credit Note, 381 for Cancel Invoice | 381 |\n\n**Example** \n\n \u003cCreditNote\u003e\n ...\n \u003ccbc:CreditNoteTypeCode\u003e381\u003c/cbc:CreditNoteTypeCode\u003e\n ...\n \u003c/CreditNote\u003e\n\n2.0 Invoice document reference\n------------------------------\n\nThe BillingReference/InvoiceDocumentReference section provides information\nrelated to the original invoice for invoice memos and cancellations. This\nelement is repeated when several invoice references are present (e.g., Google\ncommercial invoice ID, vendor generated ID, tax authority generated reference).\nThe attribute schemeID is used to identify the invoice issuer.\n\n| **Path** | **Description** | **Example** |\n|----------------------|--------------------------------------------------------------------------------------|-------------------------------------|\n| **cbc:ID** | Preceding invoice number - Identifier of a previously issued invoice | GCEMEAD000000099 |\n| **cbc:ID @schemeID** | Identifier of the type of the invoice issuer | Google, Vendor, local tax authority |\n| **cbc:IssueDate** | Issue date - Issue date of the previously issued invoice. The format is \"YYYY-MM-DD\" | 2023-05-28 |\n\n \u003cCreditNote\u003e\n ...\n \u003ccac:BillingReference\u003e\n \u003ccac:InvoiceDocumentReference\u003e\n \u003ccbc:ID schemeID=\"Google\"\u003eGCEMEAD000000099\u003c/cbc:ID\u003e\n \u003ccbc:IssueDate\u003e2023-05-28\u003c/cbc:IssueDate\u003e\n \u003c/cac:InvoiceDocumentReference\u003e\n \u003c/cac:BillingReference\u003e\n ...\n \u003c/CreditNote\u003e\n\n3.0 Credit note line items\n--------------------------\n\nLine items are individual goods or services enumerated in the credit note. The\nschema supports one or multiple credit note line items per credit note document.\n\n### 3.1 cac:CreditNoteLine\n\nThis section details each item or service for which a credit is issued,\nincluding unique identifiers, credited quantities, and unit prices. It provides\na complete breakdown of the amounts before taxes associated with each credited\nline item.\n\n| **Path** | **Description** | **Example** |\n|-------------------------------------------|------------------------------------------------------------------------------------------|--------------|\n| **cbc:ID** | Unique identifier for this line item; for an aggregated line item invoice the value is 1 | 1 |\n| **cbc:CreditedQuantity** | Quantity of the item credited; for an aggregated line item the value is 1 | 1 |\n| **cbc:LineExtensionAmount @currencyID** | Total amount for the line item in the original currency, excluding taxes | 1000 |\n| **cac:Item/cbc:Name** | Name of the item | Google Cloud |\n| **cac:Price/cbc:PriceAmount @currencyID** | Unit price of the item in the original currency | 1000 |\n\n \u003cCreditNote\u003e\n ...\n \u003ccac:CreditNoteLine\u003e\n \u003ccbc:ID\u003e1\u003c/cbc:ID\u003e\n \u003ccbc:CreditedQuantity\u003e1\u003c/cbc:CreditedQuantity\u003e\n \u003ccbc:LineExtensionAmount currencyID=\"USD\"\u003e1000\u003c/cbc:LineExtensionAmount\u003e\n \u003ccac:Item\u003e\n \u003ccbc:Name\u003eGoogle Cloud\u003c/cbc:Name\u003e\n \u003c/cac:Item\u003e\n \u003ccac:Price\u003e\n \u003ccbc:PriceAmount currencyID=\"USD\"\u003e1000\u003c/cbc:PriceAmount\u003e\n \u003c/cac:Price\u003e\n \u003c/cac:CreditNoteLine\u003e\n ...\n \u003c/CreditNote\u003e\n\n### 3.2 cac:CreditNoteLine/cac:TaxTotal\n\nThis section contains the total tax amount for the line item, as well as the\ntaxable amount, tax amount, and tax category.\n\n| **Path** | **Description** | **Example** |\n|----------------------------------------------------------|-------------------------------------------------------------|-------------|\n| **cbc:TaxAmount @currencyID** | Total tax amount in the original currency for the line item | 70 |\n| **cac:TaxSubtotal/cbc:TaxableAmount @currencyID** | Taxable amount in the original currency for the line item | 1000 |\n| **cac:TaxSubtotal/cbc:TaxAmount @currencyID** | Tax amount in the original currency for the line item | 70 |\n| **cac:TaxSubtotal/cac:TaxCategory/cbc:Percent** | Tax rate applied to the line item | 7.00 |\n| **cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID** | Type of tax for this subtotal | VAT |\n\n \u003cCreditNote\u003e\n ...\n \u003ccac:CreditNoteLine\u003e\n ...\n \u003ccac:TaxTotal\u003e\n \u003ccbc:TaxAmount currencyID=\"USD\"\u003e70\u003c/cbc:TaxAmount\u003e\n \u003ccac:TaxSubtotal\u003e\n \u003ccbc:TaxableAmount currencyID=\"USD\"\u003e1000\u003c/cbc:TaxableAmount\u003e\n \u003ccbc:TaxAmount currencyID=\"USD\"\u003e70\u003c/cbc:TaxAmount\u003e\n \u003ccac:TaxCategory\u003e\n \u003ccbc:Percent\u003e7.00\u003c/cbc:Percent\u003e\n \u003ccac:TaxScheme\u003e\n \u003ccbc:ID\u003eVAT\u003c/cbc:ID\u003e\n \u003c/cac:TaxScheme\u003e\n \u003c/cac:TaxCategory\u003e\n \u003c/cac:TaxSubtotal\u003e\n \u003c/cac:TaxTotal\u003e\n \u003c/cac:CreditNoteLine\u003e\n ...\n \u003c/CreditNote\u003e"]]