Try in playground

Malaysia: fields

Every GETS field a Malaysian document can carry, when it is required and the values it accepts.

  • Field is the name the Integration engine shows.
  • Requirement covers every document type, modifier and variant. Mandatory fields are always required and optional ones never are. Conditional fields are required only when the condition in their description is met.
  • Enums lists the values a field accepts when it takes only a fixed set.
  • To see the fields for one document type, modifier and variant next to a sample request, open List with sample request.

Payload fields

367 fields · conditional fields are required only when the condition in their description is met

DescriptionEnums
Invoice CurrencyMandatorystringDocument currency
Document NumberMandatorystringUnique document number
Document BaseMandatorystringThe base document type, such as tax_invoice or credit_note. Each country’s values are listed under Enums on its fields page.
tax_invoiceTax invoicecredit_noteCredit notedebit_noteDebit note
Issue DateMandatorydateDocument issue date
Issue TimeMandatorystringTime the document was issued. LHDN e-invoices take it in UTC, as hh:mm:ssZ. LHDN requires an issue time for each Malaysia e-invoice.
Reference IDConditionalstringOriginal invoice reference ID Mandatory for debit notes; optional for tax invoices and credit notes. With the refund variant: mandatory for tax invoices and credit notes. LHDN MyInvois Invoice v1.0 billing references (https://sdk.myinvois.hasil.gov.my/documents/invoice-v1-0/) require the original e-invoice reference used by Malaysia V2 DBT and SLF_DBT documents.Malaysia refund notes must identify the original e-invoice.
Additional NotesOptionalstringA textual note that gives unstructured information that is relevant to the Invoice as a whole.
Document IDOptionalstringInternal system document identifier (UUID or database ID)
Document ModifiersOptionalarrayModifiers that apply to the document, such as export. Send [] when none apply. Each country’s values are listed under Enums on its fields page.
self_billedSelf billedis_receiptIs receiptpeppolPeppolb2bB2B
Document VariantOptionalstringA variant of the base document type: refund. Leave it out for an ordinary document.
refundRefund
Due DateOptionaldatePayment due date
Exchange Rate DateOptionaldateExchange rate date
Exchange RateOptionalnumberExchange rate when currency differs from tax currency
Exchange Source CurrencyOptionalstringExchange rate source currency
Exchange Target CurrencyOptionalstringExchange rate target currency
Invoice Period EndOptionaldateEnd date of the invoiced period
Invoice Period FrequencyOptionalstringFrequency of the billing period (monthly, weekly, etc.)
Invoice Period StartOptionaldateStart date of the invoiced period
Note Issuance ReasonOptionalstringReason for credit/debit note
Reference NumbersOptionalarrayReference to original invoice (notes)
Tax Accounting CurrencyOptionalstringTax currency (often same as document currency)
Seller Address Line 1MandatorystringThe main address line in an address. LHDN requires the supplier address line.
Seller CityMandatorystringThe common name of the city, town or village, where the Seller address is located.
Seller CountryMandatorystringSeller country code
Seller Contact PhoneMandatorystringA phone number for the contact point. LHDN requires a supplier contact number.
Seller Industry Classification CodeMandatorystringIndustry classification code LHDN requires the supplier MSIC code.
Seller Industry Classification DescriptionMandatorystringIndustry classification description LHDN requires the supplier business activity description.
Seller NameMandatorystringSeller company name
Seller Registration TypeMandatorystringSeller registration type
Seller Registration ValueMandatorystringAn identifier issued by an official registrar that identifies the Seller as a legal entity or person.
Seller Tax ID TypeMandatorystringThe scheme of the TAX identifier.
Seller Tax ID ValueMandatorystringSeller tax ID value
Country Subentity Code (Seller)ConditionalstringMalaysia state code (e.g. 14 for Kuala Lumpur). Optional with the is_receipt modifier. Malaysia V2 receipt validation permits a receipt without a seller state code.
Seller Peppol IDConditionalstringSeller's Peppol network identifier for Peppol delivery Only with the peppol modifier: mandatory.
Seller Access Code BuildingOptionalstringseller access code building
Seller Access Code GateOptionalstringseller access code gate
Seller Access Code IntercomOptionalstringseller access code intercom
Seller Address TypeOptionalstringseller address type
Seller Address UsageOptionalstringseller address usage
Seller ApartmentOptionalstringseller apartment
Seller Attention ToOptionalstringseller attention to
Seller Building NameOptionalstringseller building name
Seller Building NumberOptionalstringSeller building number
Seller Business Hours CloseOptionalstringseller business hours close
Seller Business Hours DaysOptionalarrayseller business hours days
Seller Business Hours OpenOptionalstringseller business hours open
Seller Care OfOptionalstringseller care of
Seller Delivery InstructionsOptionalstringseller delivery instructions
Seller Delivery PointOptionalstringseller delivery point
Seller DistrictOptionalstringSeller district
Seller FloorOptionalstringseller floor
Seller Geo Location LatitudeOptionalnumberseller geo location latitude
Seller Geo Location LongitudeOptionalnumberseller geo location longitude
Seller LandmarkOptionalstringseller landmark
Seller Plus CodeOptionalstringseller plus code
Seller PO BoxOptionalstringseller po box
Seller Post OfficeOptionalstringseller post office
Seller Room NumberOptionalstringseller room number
Seller Street NameOptionalstringseller street name
Seller Street NumberOptionalstringseller street number
Seller Sub DistrictOptionalstringseller sub district
Seller Time ZoneOptionalstringseller time zone
Seller Valid FromOptionaldateseller valid from
Seller Valid ToOptionaldateseller valid to
Seller Verification DateOptionaldateseller verification date
Seller Verification SourceOptionalstringseller verification source
Seller VerifiedOptionalstringseller verified
Seller WardOptionalstringseller ward
Seller What Three WordsOptionalstringseller what three words
Seller ZoneOptionalstringseller zone
Seller Address Line 2OptionalstringAn additional address line in an address that can be used to give further details supplementing the main line.
Seller Address Line 3OptionalstringSeller address line 3
Seller Postal CodeOptionalstringThe identifier for an addressable group of properties according to the relevant postal service.
Seller State/ProvinceOptionalstringThe subdivision of a country. Such as a region, a county, a state, a province etc..
As a code 010203040506
Or as a name JOHORKEDAHKELANTANMELAKANEGERI_SEMBILANPAHANG
Seller Business ActivityOptionalstringSeller business activity
Seller Contact EmailOptionalstringAn e-mail address for the contact point.
Seller Contact NameOptionalstringA contact point for a legal entity or person.
Seller Industry Classification SchemeOptionalstringIndustry classification scheme
Seller Party IDOptionalstringSeller internal party ID
Seller Trade NameOptionalstringSeller trade name
Buyer Address Line 1MandatorystringThe main address line in an address. LHDN requires the buyer address line.
Buyer CountryMandatorystringBuyer country code
Buyer Contact PhoneMandatorystringA phone number for the contact point. LHDN requires a buyer contact number.
Buyer NameMandatorystringBuyer company/name
Buyer Registration TypeMandatorystringBuyer registration type
Buyer Registration ValueMandatorystringAn identifier issued by an official registrar that identifies the Buyer as a legal entity or person.
Buyer Tax ID TypeMandatorystringThe scheme of the TAX identifier. LHDN requires the buyer TIN type.
Buyer Tax ID ValueMandatorystringThe Buyer’s VAT identifier (also known as Buyer VAT identification number). The Buyer’s tax identifier (also known as Buyer tax identification number). For buyers in UAE which are registered under VAT should provide the Tax Registration Number (TRN). LHDN requires the buyer TIN.
Country Subentity Code (Buyer)ConditionalstringMalaysia state code (e.g. 14 for Kuala Lumpur). Optional with the is_receipt modifier. Malaysia V2 receipt validation permits a receipt without a buyer state code.
Buyer Peppol IDConditionalstringBuyer's Peppol network identifier for Peppol delivery Only with the peppol modifier: mandatory.
Buyer Access Code BuildingOptionalstringbuyer access code building
Buyer Access Code GateOptionalstringbuyer access code gate
Buyer Access Code IntercomOptionalstringbuyer access code intercom
Buyer Address TypeOptionalstringbuyer address type
Buyer Address UsageOptionalstringbuyer address usage
Buyer ApartmentOptionalstringbuyer apartment
Buyer Attention ToOptionalstringbuyer attention to
Buyer Building NameOptionalstringbuyer building name
Buyer Building NumberOptionalstringBuyer building number
Buyer Business Hours CloseOptionalstringbuyer business hours close
Buyer Business Hours DaysOptionalarraybuyer business hours days
Buyer Business Hours OpenOptionalstringbuyer business hours open
Buyer Care OfOptionalstringbuyer care of
Buyer Delivery InstructionsOptionalstringbuyer delivery instructions
Buyer Delivery PointOptionalstringbuyer delivery point
Buyer DistrictOptionalstringBuyer district
Buyer FloorOptionalstringbuyer floor
Buyer Geo Location LatitudeOptionalnumberbuyer geo location latitude
Buyer Geo Location LongitudeOptionalnumberbuyer geo location longitude
Buyer LandmarkOptionalstringbuyer landmark
Buyer Plus CodeOptionalstringbuyer plus code
Buyer PO BoxOptionalstringbuyer po box
Buyer Post OfficeOptionalstringbuyer post office
Buyer Room NumberOptionalstringbuyer room number
Buyer Street NameOptionalstringbuyer street name
Buyer Street NumberOptionalstringbuyer street number
Buyer Sub DistrictOptionalstringbuyer sub district
Buyer Time ZoneOptionalstringbuyer time zone
Buyer Valid FromOptionaldatebuyer valid from
Buyer Valid ToOptionaldatebuyer valid to
Buyer Verification DateOptionaldatebuyer verification date
Buyer Verification SourceOptionalstringbuyer verification source
Buyer VerifiedOptionalstringbuyer verified
Buyer WardOptionalstringbuyer ward
Buyer What Three WordsOptionalstringbuyer what three words
Buyer ZoneOptionalstringbuyer zone
Buyer Address Line 2OptionalstringAn additional address line in an address that can be used to give further details supplementing the main line.
Buyer Address Line 3OptionalstringBuyer address line 3
Buyer CityOptionalstringThe common name of the city, town or village, where the Buyer’s address is located.
Buyer Postal CodeOptionalstringThe identifier for an addressable group of properties according to the relevant postal service.
Buyer State/ProvinceOptionalstringThe subdivision of a country. Such as a region, a county, a state, a province etc..
Buyer Business ActivityOptionalstringBuyer business activity
Buyer Contact EmailOptionalstringAn e-mail address for the contact point.
Buyer Contact NameOptionalstringA contact point for a legal entity or person.
Buyer Industry Classification CodeOptionalstringBuyer industry code
Buyer Industry Classification DescriptionOptionalstringBuyer industry description
Buyer Industry Classification SchemeOptionalstringBuyer industry scheme
Buyer Party IDOptionalstringBuyer internal party ID
Buyer Trade NameOptionalstringBuyer trade name
Delivery Access Code BuildingOptionalstringdelivery access code building
Delivery Access Code GateOptionalstringdelivery access code gate
Delivery Access Code IntercomOptionalstringdelivery access code intercom
Delivery Address TypeOptionalstringdelivery address type
Delivery Address UsageOptionalstringdelivery address usage
Delivery ApartmentOptionalstringdelivery apartment
Delivery Attention ToOptionalstringdelivery attention to
Delivery Building NameOptionalstringdelivery building name
Delivery Building NumberOptionalstringdelivery building number
Delivery Business Hours CloseOptionalstringdelivery business hours close
Delivery Business Hours DaysOptionalarraydelivery business hours days
Delivery Business Hours OpenOptionalstringdelivery business hours open
Delivery Care OfOptionalstringdelivery care of
Delivery Delivery InstructionsOptionalstringdelivery delivery instructions
Delivery Delivery PointOptionalstringdelivery delivery point
Delivery DistrictOptionalstringdelivery district
Delivery FloorOptionalstringdelivery floor
Delivery Geo Location LatitudeOptionalnumberdelivery geo location latitude
Delivery Geo Location LongitudeOptionalnumberdelivery geo location longitude
Delivery LandmarkOptionalstringdelivery landmark
Delivery Plus CodeOptionalstringdelivery plus code
Delivery PO BoxOptionalstringdelivery po box
Delivery Post OfficeOptionalstringdelivery post office
Delivery Room NumberOptionalstringdelivery room number
Delivery Street NameOptionalstringdelivery street name
Delivery Street NumberOptionalstringdelivery street number
Delivery Sub DistrictOptionalstringdelivery sub district
Delivery Time ZoneOptionalstringdelivery time zone
Delivery Valid FromOptionaldatedelivery valid from
Delivery Valid ToOptionaldatedelivery valid to
Delivery Verification DateOptionaldatedelivery verification date
Delivery Verification SourceOptionalstringdelivery verification source
Delivery VerifiedOptionalstringdelivery verified
Delivery WardOptionalstringdelivery ward
Delivery What Three WordsOptionalstringdelivery what three words
Delivery ZoneOptionalstringdelivery zone
Delivery Address Line 1OptionalstringThe main address line in an address.
Delivery Address Line 2OptionalstringAdditional delivery address line
Delivery Address Line 3OptionalstringThird delivery address line
Delivery CityOptionalstringThe common name of the city, town or village, where the deliver to address is located.
Delivery CountryOptionalstringA code that identifies the country.
Country Subentity Code (Delivery)OptionalstringMalaysia state code (e.g. 14 for Kuala Lumpur).
Delivery Post CodeOptionalstringPostal code for delivery address
Delivery Country SubdivisionOptionalstringState, emirate or province for delivery address
Delivery Business ActivityOptionalstringDelivery business activity
Delivery Contact EmailOptionalstringDelivery contact email
Delivery Contact NameOptionalstringDelivery contact name
Delivery Contact PhoneOptionalstringDelivery contact phone
Actual Delivery DateOptionaldateActual delivery date
Actual Delivery TimeOptionalstringActual delivery time
Customs Declaration NumberOptionalstringcustoms declaration number
Destination PortOptionalstringDestination port
Export DateOptionaldateexport date
FreightOptionalstringfreight
Freight DocumentOptionalstringfreight document
IncotermsOptionalstringDelivery terms (Incoterms)
Origin PortOptionalstringOrigin port
Special TermsOptionalstringspecial terms
Transport ModeOptionalstringtransport mode
Delivery Industry Classification CodeOptionalstringDelivery industry classification code
Delivery Industry Classification DescriptionOptionalstringDelivery industry classification description
Delivery Industry Classification SchemeOptionalstringDelivery industry classification scheme
Delivery Party NameOptionalstringDelivery party name
Delivery Party IDOptionalstringIdentifier for delivery party
Delivery Peppol IDOptionalstringDelivery party's Peppol network identifier
Deliver to Legal Registration TypeOptionalstringType of registration for delivery party
Deliver to Legal RegistrationOptionalstringRegistration number for delivery party
Delivery Tax ID TypeOptionalstringDelivery tax ID type
Delivery Tax ID ValueOptionalstringDelivery tax ID value
Delivery Trade NameOptionalstringDelivery party trade name
Line Item DescriptionMandatorystringA description for an item. Malaysia requires a description for each product or service line item.
Line Item IDMandatorystringLine item identifier
Line Item TotalMandatorynumberLine item total
Item Net PriceMandatorynumberNet unit price excluding VAT.
Line Item QuantityMandatorynumberThe quantity of items (goods or services) that is charged in the Invoice line.
Line Item Tax AmountMandatorynumberTax amount for the line item, excluding the net line amount.
Line Tax CategoryMandatorystringThe VAT category code for the invoiced item. LHDN requires a tax type for each Malaysia invoice line.
Line Item Unit CodeMandatorystringUnit code (PCE, KGM, etc.)
Line Taxable ValueConditionalnumberThe total amount of the Invoice line (before tax). Mandatory with the peppol modifier. MY PINT requires the net amount for each invoice line.
Line Item NameConditionalstringLine item name/description Optional with the is_receipt modifier. Malaysia receipts use the mandatory product or service description and are not submitted individually to LHDN.
Line Tax RateConditionalnumberThe VAT rate, represented as percentage that applies to the invoiced item. LHDN requires a tax rate where the line uses a percentage tax rate.
Buyer Item CodeOptionalstringBuyer item code
Commodity Classification CodeOptionalstringCommodity classification code
Commodity Classification DescriptionOptionalstringCommodity classification description
Commodity Classification SchemeOptionalstringThe identification scheme shall be chosen from the entries in UNTDID 7143 [6].
Commodity CodeOptionalstringTariff/commodity code
Country Of OriginOptionalstringThe code identifying the country from which the item originates.
Line Discount/Charge AmountOptionalnumberDiscount/Charge amount
Line Discount/Charge Base AmountOptionalnumberDiscount/Charge base amount
Line Discount/Charge IDOptionalstringDiscount/Charge ID
Line Discount/Charge is ChargeOptionalbooleanIs charge or discount
Line Discount/Charge PercentageOptionalnumberDiscount/Charge percentage
Line Discount/Charge ReasonOptionalstringDiscount/Charge reason
Line Discount/Charge Reason CodeOptionalstringDiscount/Charge reason code
Line Discount/Charge Tax AmountOptionalnumberDiscount/Charge tax amount
Line Discount/Charge Tax CategoryOptionalstringDiscount/Charge tax category
Line Discount/Charge Tax RateOptionalnumberDiscount/Charge tax rate
Line TypeOptionalstringLine type
Base QuantityOptionalnumberThe number of item units to which the price applies.
Base Quantity Unit CodeOptionalstringBase quantity unit code
Item Gross PriceOptionalnumberUnit price before a price-level discount, excluding VAT.
Line Related Document TypeOptionalstringRelated document type
Line Related Document IDOptionalstringRelated document ID
Seller Item CodeOptionalstringSeller item code
Standard Item Code IDOptionalstringAn item identifier based on a registered scheme.
Standard Item Code SchemeOptionalstringThe identification scheme identifier of the Item standard identifier.
Tax Exemption ReasonOptionalstringA textual statement of the reason why the line amount is exempted from VAT or why no VAT is being charged.
Tax Exemption Reason CodeOptionalstringA coded statement of the reason for why the line amount is exempted from VAT.
Product Classification ClassMandatorystringMalaysia product classification class for commodity classification.
Item Price ExtensionMandatorynumberNet price multiplied by quantity for the line item.
Line Tax SchemeConditionalstringTax scheme for the line item (IBT-167). Typically VAT for Peppol/EN 16931 invoices. Only with the peppol modifier: mandatory. MY PINT requires the tax scheme for each invoice line.
Product Tax CodeOptionalstringMalaysia product tax code (PTC) for commodity classification.
Line Accounting ReferenceOptionalstringAccounting reference for the line item. Only with the peppol modifier: optional.
Attribute NameOptionalstringName of the line item attribute. Only with the peppol modifier: optional.
Attribute ValueOptionalstringValue of the line item attribute. Only with the peppol modifier: optional.
Line Buyer Accounting ReferenceOptionalstringBuyer accounting reference for the line item. Only with the peppol modifier: optional.
Commodity Classification VersionOptionalstringVersion of the commodity classification scheme. Only with the peppol modifier: optional.
Line Invoice Period EndOptionaldateEnd date of the invoiced period for this line. Only with the peppol modifier: optional.
Line Invoice Period StartOptionaldateStart date of the invoiced period for this line. Only with the peppol modifier: optional.
Line NoteOptionalstringFree text note for the line item. Only with the peppol modifier: optional.
Line Object IdentifierOptionalstringObject identifier for the line item. Only with the peppol modifier: optional.
Line Object Identifier SchemeOptionalstringScheme for the line item object identifier. Only with the peppol modifier: optional.
Order Line ReferenceOptionalstringReference to the corresponding order line. Only with the peppol modifier: optional.
Amount DueMandatorynumberThe outstanding amount that is requested to be paid.
Total Amount Excluding TaxMandatorynumberTotal excluding tax
Total Amount Including TaxMandatorynumberTotal including tax
Total Line Taxable AmountMandatorynumberSum of line taxable values
Total Tax AmountMandatorynumberTotal tax amount
Prepaid AmountOptionalnumberThe sum of amounts which have been paid in advance.
Rounding AmountOptionalnumberRounding adjustment
Total AllowancesOptionalnumberSum of all allowances on document level in the Invoice.
Total ChargesOptionalnumberSum of all charges on document level in the Invoice.
Tax Total AmountMandatorynumberTotal tax amount of the document. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal Taxable AmountMandatorynumberSum of the taxable amounts in this tax category and rate. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal AmountMandatorynumberTax amount for this tax category and rate. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal CategoryMandatorystringTax category code of this part of the breakdown, such as S for the standard rate. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal PercentageConditionalnumberTax rate of this category, as a percentage. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal Exemption ReasonConditionalstringWhy this category is exempt from tax, as text. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal Exemption Reason CodeConditionalstringWhy this category is exempt from tax, as a code. Send exactly one document tax total with its breakdown by tax type.
Tax Subtotal SchemeOptionalstringTax scheme of this part of the breakdown, normally VAT. Send exactly one document tax total with its breakdown by tax type.
Invoice Discount/Charge AmountOptionalnumberAllowance/charge amount
Invoice Discount/Charge Base AmountOptionalnumberBase amount
Invoice Discount/Charge Line IDOptionalstringAllowance/Charge ID
Invoice-level Is ChargeOptionalbooleanCharge (true) or allowance (false)
Invoice Discount/Charge PercentageOptionalnumberPercent applied
Invoice Discount/Charge ReasonOptionalstringReason for allowance/charge
Invoice Discount/Charge Reason CodeOptionalstringReason code
Invoice Discount/Charge Tax AmountOptionalnumberTax amount
Invoice Discount/Charge Tax CategoryOptionalstringTax category
Invoice Discount/Charge Tax RateOptionalnumberTax rate
Payee Account IDConditionalstringA unique identifier of the financial payment account, at a payment service provider, to which payment should be made.
Card Holder NameOptionalstringCard holder name
Card NetworkOptionalstringCard network ID
Card PANOptionalstringCard primary account number
Payee Account NameOptionalstringThe name of the payment account, at a payment service provider, to which payment should be made.
Payee Institution BranchOptionalstringAn identifier for the payment service provider where a payment account is located.
Direct Debit Mandate Ref IDOptionalstringDirect debit mandate reference
Payer Financial AccountOptionalstringPayer financial account
Payment IDOptionalstringPayment identifier
Payment Means CodeOptionalstringHow the payment is made, as a UNTDID 4461 payment means code, for example 30 for a credit transfer or 10 for cash.
Payment Means TextOptionalstringPayment method description
Discount AmountOptionalnumberThe payment amount that these terms apply to. When relevant, the amount includes tax.
Discount Due DateOptionaldateDiscount due date
Payment Terms NoteOptionalstringA textual description of the payment terms that apply to the amount due for payment (Including description of possible penalties).
Penalty AmountOptionalnumberPenalty amount
Penalty PercentageOptionalnumberPenalty percent
Settlement Discount PercentageOptionalnumberSettlement discount percent
Attachment ChecksumOptionalstringAttachment checksum
Attachment ContentOptionalstringAttachment base64 content
Attachment Content URLOptionalstringAttachment content URL
Attachment DescriptionOptionalstringAttachment description
Attachment FilenameOptionalstringAttachment file name
Attachment Mime CodeOptionalstringA code identifying the file type.
Attachment SizeOptionalnumberAttachment size
Supporting Document DescriptionOptionalstringDescription of supporting document
Supporting Document TypeOptionalstringType of supporting document
Supporting Document IDOptionalstringSupporting document identifier
Supporting Document Issue DateOptionaldateSupporting document issue date
Supporting Document URLOptionalstringReference URL
Buyer Electronic Address SchemeConditionalstringPeppol participant scheme identifier for buyer Only with the peppol modifier: mandatory.
Preceding Invoice Issue DateConditionaldateIssue date of the original preceding invoice (BT-26). Required for credit/debit notes and continuous supply. Only with the peppol modifier: conditional.
Seller Electronic Address SchemeConditionalstringScheme of the seller’s Peppol participant identifier (BT-34-1), for example 0088 for a GLN. Only with the peppol modifier: mandatory.
Invoice Total VAT Amount in Tax Accounting CurrencyConditionalnumberTotal VAT amount expressed in tax accounting currency (BT-111). Required when taxCurrency differs from document currency. Only with the peppol modifier: conditional.
Payment Account Identifier SchemeOptionalstringScheme for payment account identifier (BT-84-1). Typically IBAN for SEPA credit transfers. Only with the peppol modifier: optional.
Accounting CostOptionalstringBuyers accounting cost centre (BT-19). Only with the peppol modifier: optional.
Buyer Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for buyer identifier (BT-46-1). Defines the format and authority of the buyer identifier. Only with the peppol modifier: optional.
Buyer Accounting ReferenceOptionalstringAccounting reference provided by the buyer. Only with the peppol modifier: optional.
Bank Assigned Creditor IdentifierOptionalstringSEPA creditor identifier (BT-90). Required for direct debit mandates. Conditional for payment means 59 (SEPA direct debit). Only with the peppol modifier: optional.
Delivery Party Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for delivery party identifier. Only with the peppol modifier: optional.
Delivery Location IdentifierOptionalstringIdentifier for the actual delivery location (BT-71). Used for logistics and tracking when delivery party differs from buyer. Only with the peppol modifier: optional.
Delivery Location Identifier SchemeOptionalstringScheme for delivery location identifier (BT-71-1). E.g. 0088 for GLN-based location IDs. Only with the peppol modifier: optional.
Invoiced Object IdentifierOptionalstringObject identification by seller (BT-18). For specific object tracking and reference, e.g. meter point or project ID. Only with the peppol modifier: optional.
Invoiced Object Identifier SchemeOptionalstringScheme for invoiced object identifier (BT-18-1). Defines the format and authority of the object identifier. Only with the peppol modifier: optional.
Note Subject CodeOptionalstringSubject code for document-level notes. Only with the peppol modifier: optional.
Payee Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for payee identifier (BT-61-1). Defines the format and authority of the payee identifier. Only with the peppol modifier: optional.
Payment Terms AmountOptionalnumberPayment terms monetary amount (BT-176). E.g. minimum payment amount or installment amount. Only with the peppol modifier: optional.
Payment Terms Due DateOptionaldatePayment terms due date (BT-177). The date by which payment must be made according to agreed terms. Only with the peppol modifier: optional.
Payment Terms Instructions IDOptionalstringIdentifier for payment terms instructions (BT-187). Used to reference agreed payment terms. Only with the peppol modifier: optional.
Registration Number SchemeOptionalstringScheme for seller legal registration identifier (BT-30-1). E.g. CBE, Handelsregister. Only with the peppol modifier: optional.
Remittance InformationOptionalstringPayment remittance information text (BT-83). Free text or structured reference for payment reconciliation. Only with the peppol modifier: optional.
Remittance Information SchemeOptionalstringScheme for remittance information (BT-83-1). Identifies the type of payment reference used. Only with the peppol modifier: optional.
Seller Additional Legal InformationOptionalstringAdditional legal information about the seller (BT-33). E.g. legal form (SPRL, SA, BV, NV, ASBL). Only with the peppol modifier: optional.
Seller Identifier SchemeOptionalstringISO/IEC 6523 scheme ID for seller identifier (BT-29-1). Defines the format and authority of the seller identifier. Only with the peppol modifier: optional.
Tax Point DateOptionaldateDate when VAT becomes accountable (BT-7). Critical for VAT compliance and tax period determination. Only with the peppol modifier: optional.
Tax Point Date CodeOptionalstringCode indicating the tax point date type. Only with the peppol modifier: optional.
Billing Reference IDOptionalstringOriginal invoice ID for billing references (credit notes, prepayments, etc.).
CertEX AuthorizationOptionalstringMalaysia export authorization number (CertEX) for AdditionalAccountID.
Original E-Invoice Reference UUIDOptionalstringLHDN UUID of the original e-invoice referenced by a corrective document.
Prepayment IDOptionalstringIdentifier for a prepaid payment.
Shipment Charge IndicatorOptionalbooleanWhether the shipment allowance is a charge (true) or discount (false).
Destination AuthorityOptionalstringDestination authority
Destination BodyOptionalstringEmail body
Destination CountryOptionalstringDestination country
Destination Document TypeOptionalstringDestination document type
Destination Participant IDOptionalstringPeppol participant ID
Destination RecipientsOptionalarrayEmail recipients
Destination SubjectOptionalstringEmail subject
Destination TypeOptionalstringDestination type for submission
Is B2BOptionalbooleanBusiness to Business flag
Is TestbedOptionalbooleanTestbed document flag
PurposeOptionalstringDocument purpose (e.g., testbed, e-invoicing, mapping)
ModeOptionalstringDocument processing mode
OperationOptionalstringDocument operation type
Source IDOptionalstringSource identifier
Source NameOptionalstringSource name
Source TypeOptionalstringSource type
Source VersionOptionalstringSource version
VersionOptionalstringDocument version

Required fields by document type

The table’s requirements as lists of GETS paths. A conditional field is required only when the condition in its description is met. Fields a modifier or variant makes mandatory are listed under it.

Every document type

Mandatory: header.documentType.base, header.documentNumber, header.issueDate, header.issueTime, header.currency, parties.seller.name, parties.seller.address.country, parties.seller.address.city, parties.seller.taxIds[].type, parties.seller.taxIds[].value, parties.seller.industryClassification.code, parties.seller.industryClassification.description, parties.seller.registrationNumbers[].type, parties.seller.registrationNumbers[].value, parties.seller.contact.phone, parties.seller.address.addressLine1, parties.buyer.name, parties.buyer.address.country, parties.buyer.taxIds[].type, parties.buyer.taxIds[].value, parties.buyer.registrationNumbers[].type, parties.buyer.registrationNumbers[].value, parties.buyer.contact.phone, parties.buyer.address.addressLine1, lineItems[].id, lineItems[].name, lineItems[].quantity, lineItems[].unitCode, lineItems[].lineTotal, lineItems[].taxAmount, lineItems[].description, lineItems[].taxCategory, lineItems[].price.amount, totals.totalAmountExcludingTax, totals.totalAmountIncludingTax, totals.amountDue, totals.totalLineTaxableAmount, totals.totalTaxAmount, parties.seller.address.extensions.my_countrySubentityCode, parties.buyer.address.extensions.my_countrySubentityCode, lineItems[].extensions.my_itemPriceExtension, lineItems[].extensions.my_commodityClassificationClass, taxTotals[].taxAmount, taxTotals[].taxSubtotals[].taxableAmount, taxTotals[].taxSubtotals[].taxAmount, taxTotals[].taxSubtotals[].taxCategory

Conditional: lineItems[].taxRate, payment.paymentMeans[].creditTransferInfo.payeeFinancialAccountId, taxTotals[].taxSubtotals[].percent, taxTotals[].taxSubtotals[].taxExemptionReason, taxTotals[].taxSubtotals[].taxExemptionReasonCode

Tax invoice (tax_invoice)

Nothing beyond the fields every document type needs.

Credit note (credit_note)

Nothing beyond the fields every document type needs.

Debit note (debit_note)

Also mandatory: header.referenceId

Modifiers and variants

  • self_billed (modifier): no further mandatory fields.
  • is_receipt (modifier): no further mandatory fields.
  • peppol (modifier): mandatory: lineItems[].lineTaxableValue, parties.seller.peppolId, parties.buyer.peppolId, extensions.peppol_seller_peppolIdScheme, extensions.peppol_buyer_peppolIdScheme, lineItems[].extensions.peppol_taxScheme.
  • b2b (modifier): no further mandatory fields.
  • refund (variant): mandatory for tax invoices and credit notes: header.referenceId.