VRBL: Invoice Lines

The details of the goods or services are specified in the invoice lines. You can also specify individual items.

A Document such as an invoice or credit usually contains invoice lines that detail individual elements or items in a transaction.

Depending on the country or business requirement, you can specify information at a Document or Line Level.

Invoice Lines

You use the Invoice Line object to capture information such as the following:

Elements

Here are the possible elements that can be used at the line level:

ElementDescription
InvoiceLineUse this element to model a line in an invoice.
InvoiceLine/InvoicePeriodYou can add an ID for a line.
NoteUse this element to add a note to a line.
InvoicedQuantityYou can add a quantity to your invoice lines.
LineExtensionAmountUse this element to specify the next amount on the line level.
InvoiceLine/Accounting CostUse this element to model references to how a buyer is referenced in the the accounting.
InvoiceLine/InvoicePeriodUse this element specify an invoice period on the Line level.
OrderLineReferenceUse this element to reference an order at the Line level.
DespatchLineReferenceA reference to a Dispatch Advice associated with a line.
DocumentReferenceUse this element to provide a reference to an additional document reference on which the invoice line is based.
InvoiceLine/AllowanceChargeUse this element to specify an allowance or charge at the line level.
Item/DescriptionUse this element to specify a description for an item.
Item/NameUse this element to specify a name for an item.
BuyersItemIdentificationUse this element to specify details about the buyers item.
SellersItemIdentificationUse this element to specify details about the Seller's item identification.
StandardItemIdentificationUse this element to specify information about standard item identification.
OriginCountryUse this element to specify information about the country of origin.
CommodityClassificationUse this element to specify information about classifying an item by type or nature.
ClassifiedTaxCategoryUse this element to specify tax information at line level.
AdditionalItemPropertyUse this element to specify details about any additional properties an item may have.
PriceDetailsUse this element to specify pricing details.

Multiple Lines and Items

Your documents may use a single invoice line or you may want to use multiple lines.

If you want you can specify multiple items, you can use multiple instances of the the Item element.

Alternatively, you can specify multiple invoice lines. See Invoice Lines.

Country Specific Configurations

Country specific configurations are explained in these topics:

Example

The following example is from the Malaysian Credit Note described in Malaysia: Example Documents:

  	<cac:InvoiceLine>
  		<cbc:ID>0001</cbc:ID>
  		<cbc:InvoicedQuantity unitCode="C62">5</cbc:InvoicedQuantity>
  		<cbc:LineExtensionAmount currencyID="MYR">6000.00</cbc:LineExtensionAmount>
  		<cac:TaxTotal>
  			<cbc:TaxAmount currencyID="MYR">0.00</cbc:TaxAmount>
  			<cac:TaxSubtotal>
  				<!-- MY: Tax amount and taxable amount mandatory on invoice line level -->
  				<cbc:TaxableAmount currencyID="MYR">6000.00</cbc:TaxableAmount>
  				<cbc:TaxAmount currencyID="MYR">0.00</cbc:TaxAmount>
  				<cac:TaxCategory>
  					<cac:TaxScheme>
  						<!-- Default value: VAT -->
  						<!-- MY tax type in "cac:ClassifiedTaxCategory\cbc:ID" -->
  						<cbc:ID>VAT</cbc:ID>
  					</cac:TaxScheme>
  				</cac:TaxCategory>
  			</cac:TaxSubtotal>
  		</cac:TaxTotal>
  		<cac:Item>
  			<cbc:Name>Laptop Peripherals 2</cbc:Name>
  			<cac:OriginCountry>
  				<cbc:IdentificationCode>MY</cbc:IdentificationCode>
  			</cac:OriginCountry>
  			<cac:CommodityClassification>
  				<!-- MY: Product Tariff Code (only goods) (optional) -->
  				<!-- identifier used for @listID not UNCL7143 compliant -->
  				<!-- use "MY" prefixed malaysian identification scheme identifiers -->
  				<cbc:ItemClassificationCode listID="VRBL:MY:PTC">9800.00.0010</cbc:ItemClassificationCode>
  			</cac:CommodityClassification>
  			<cac:CommodityClassification>
  				<!-- MY: Category of products or services code list (https://sdk.myinvois.hasil.gov.my/codes/classification-codes/) (mandatroy) -->
  				<!-- @listID - see above -->
  				<cbc:ItemClassificationCode listID="VRBL:MY:CLASS">VRBL:MY:003</cbc:ItemClassificationCode>
  			</cac:CommodityClassification>
  			<cac:ClassifiedTaxCategory>
  				<!-- MY Tax types code list: https://sdk.myinvois.hasil.gov.my/codes/tax-types/ (not UNCL5305 compliant) -->
  				<!-- MY original code:    E - Tax exemption -->
  				<!-- expected code:    MY:E - Tax exemption -->
  				<cbc:ID>VRBL:MY:E</cbc:ID>
  				<cbc:Percent>0.00</cbc:Percent>
  				<cbc:TaxExemptionReason>tax exemption reason free text description</cbc:TaxExemptionReason>
  				<cac:TaxScheme>
  					<!-- Default value: VAT -->
  					<!-- MY tax type in "cac:ClassifiedTaxCategory\cbc:ID" -->
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:ClassifiedTaxCategory>
  		</cac:Item>
  		<cac:Price>
  			<cbc:PriceAmount currencyID="MYR">1200.00</cbc:PriceAmount>
  		</cac:Price>
  		<cac:ItemPriceExtension>
  			<cbc:Amount currencyID="MYR">6000.00</cbc:Amount>
  		</cac:ItemPriceExtension>
  	</cac:InvoiceLine>

In This Section