Saudi Arabia: fields
Every GETS field a Saudi 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
325 fields · conditional fields are required only when the condition in their description is met
| Description | Enums | |||
|---|---|---|---|---|
| Invoice Currency | Mandatory | string | Document currency | |
| Document Number | Mandatory | string | Unique document number | |
| Document Base | Mandatory | string | Base document type (e.g., tax_invoice, credit_note, debit_note) | tax_invoiceTax invoicecredit_noteCredit notedebit_noteDebit notesimplified_invoiceSimplified invoicesimplified_credit_noteSimplified credit notesimplified_debit_noteSimplified debit note |
| Issue Date | Mandatory | date | Document issue date | |
| Exchange Rate | Conditional | number | Exchange rate when currency differs from tax currency Mandatory with the export modifier. Export requires exchange rate | |
| Invoice Period End | Conditional | date | End date of the invoiced period Mandatory with the summary or continuous_supply modifier. Summary invoice periodContinuous supply period | |
| Invoice Period Start | Conditional | date | Start date of the invoiced period Mandatory with the summary or continuous_supply modifier. Summary invoice periodContinuous supply period | |
| Note Issuance Reason | Conditional | string | Reason for credit/debit note Mandatory for credit notes, debit notes, simplified credit notes and simplified debit notes; optional for tax invoices and simplified invoices. ZATCA credit note requires note issuance reasonZATCA debit note requires note issuance reason | |
| Additional Notes | Optional | string | Additional notes | |
| Document ID | Optional | string | Internal system document identifier (UUID or database ID) | |
| Document Modifiers | Optional | array | Document modifiers (e.g., export, summary, self-billed) | exportExportsummarySummarycontinuous_supplyContinuous supplyb2gB2Gthird_partyThird partynominal_supplyNominal supplynominalNominalself_billedSelf billed |
| Document Variant | Optional | string | Document variant (e.g., B2B, B2C) | prepaymentPrepayment |
| Due Date | Optional | date | Payment due date | |
| Exchange Rate Date | Optional | date | Exchange rate date | |
| Exchange Source Currency | Optional | string | Exchange rate source currency | |
| Exchange Target Currency | Optional | string | Exchange rate target currency | |
| Invoice Period Frequency | Optional | string | Frequency of the billing period (monthly, weekly, etc.) | |
| Issue Time | Optional | string | Document issue time (HH:MM or HH:MM:SS:0000) | |
| Reference ID | Optional | string | Original invoice reference ID | |
| Reference Numbers | Optional | array | Reference to original invoice (notes) | |
| Tax Accounting Currency | Optional | string | Tax currency (often same as document currency) | |
| Seller City | Mandatory | string | Seller city | |
| Seller Country | Mandatory | string | Seller country code | |
| Seller Name | Mandatory | string | Seller company name | |
| Seller Registration Type | Mandatory | string | Seller registration type | |
| Seller Registration Value | Mandatory | string | Seller registration value | |
| Seller Tax ID Type | Mandatory | string | Seller tax ID type (VAT, TIN, etc.) | |
| Seller Tax ID Value | Mandatory | string | Seller tax ID value | |
| Seller Access Code Building | Optional | string | seller access code building | |
| Seller Access Code Gate | Optional | string | seller access code gate | |
| Seller Access Code Intercom | Optional | string | seller access code intercom | |
| Seller Address Type | Optional | string | seller address type | |
| Seller Address Usage | Optional | string | seller address usage | |
| Seller Apartment | Optional | string | seller apartment | |
| Seller Attention To | Optional | string | seller attention to | |
| Seller Building Name | Optional | string | seller building name | |
| Seller Building Number | Optional | string | Seller building number | |
| Seller Business Hours Close | Optional | string | seller business hours close | |
| Seller Business Hours Days | Optional | array | seller business hours days | |
| Seller Business Hours Open | Optional | string | seller business hours open | |
| Seller Care Of | Optional | string | seller care of | |
| Seller Delivery Instructions | Optional | string | seller delivery instructions | |
| Seller Delivery Point | Optional | string | seller delivery point | |
| Seller District | Optional | string | Seller district | |
| Seller Additional Number | Optional | string | Additional address number for seller (ZATCA requirement). | |
| Seller Floor | Optional | string | seller floor | |
| Seller Geo Location Latitude | Optional | number | seller geo location latitude | |
| Seller Geo Location Longitude | Optional | number | seller geo location longitude | |
| Seller Landmark | Optional | string | seller landmark | |
| Seller Plus Code | Optional | string | seller plus code | |
| Seller PO Box | Optional | string | seller po box | |
| Seller Post Office | Optional | string | seller post office | |
| Seller Room Number | Optional | string | seller room number | |
| Seller Street Name | Optional | string | seller street name | |
| Seller Street Number | Optional | string | seller street number | |
| Seller Sub District | Optional | string | seller sub district | |
| Seller Time Zone | Optional | string | seller time zone | |
| Seller Valid From | Optional | date | seller valid from | |
| Seller Valid To | Optional | date | seller valid to | |
| Seller Verification Date | Optional | date | seller verification date | |
| Seller Verification Source | Optional | string | seller verification source | |
| Seller Verified | Optional | string | seller verified | |
| Seller Ward | Optional | string | seller ward | |
| Seller What Three Words | Optional | string | seller what three words | |
| Seller Zone | Optional | string | seller zone | |
| Seller Address Line 1 | Optional | string | Seller address line 1 | |
| Seller Address Line 2 | Optional | string | Seller address line 2 | |
| Seller Address Line 3 | Optional | string | Seller address line 3 | |
| Seller Postal Code | Optional | string | Seller postal code | |
| Seller State/Province | Optional | string | Seller state/province | |
| Seller Business Activity | Optional | string | Seller business activity | |
| Seller Contact Email | Optional | string | Seller contact email | |
| Seller Contact Name | Optional | string | Seller contact name | |
| Seller Contact Phone | Optional | string | Seller contact phone | |
| Seller Industry Classification Code | Optional | string | Industry classification code | |
| Seller Industry Classification Description | Optional | string | Industry classification description | |
| Seller Industry Classification Scheme | Optional | string | Industry classification scheme | |
| Seller Party ID | Optional | string | Seller internal party ID | |
| Seller Trade Name | Optional | string | Seller trade name | |
| Buyer Name | Mandatory | string | Buyer company/name | |
| Buyer Country | Conditional | string | Buyer country code Mandatory for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Registration Type | Conditional | string | Buyer registration type Mandatory for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Registration Value | Conditional | string | Buyer registration value Mandatory for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Access Code Building | Optional | string | buyer access code building Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Access Code Gate | Optional | string | buyer access code gate Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Access Code Intercom | Optional | string | buyer access code intercom Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Address Type | Optional | string | buyer address type Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Address Usage | Optional | string | buyer address usage Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Apartment | Optional | string | buyer apartment Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Attention To | Optional | string | buyer attention to Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Building Name | Optional | string | buyer building name Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Building Number | Optional | string | Buyer building number Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Business Hours Close | Optional | string | buyer business hours close Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Business Hours Days | Optional | array | buyer business hours days Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Business Hours Open | Optional | string | buyer business hours open Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Care Of | Optional | string | buyer care of Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Delivery Instructions | Optional | string | buyer delivery instructions Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Delivery Point | Optional | string | buyer delivery point Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer District | Optional | string | Buyer district Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Additional Number | Optional | string | Additional address number for buyer (ZATCA requirement). Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Floor | Optional | string | buyer floor Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Geo Location Latitude | Optional | number | buyer geo location latitude Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Geo Location Longitude | Optional | number | buyer geo location longitude Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Landmark | Optional | string | buyer landmark Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Plus Code | Optional | string | buyer plus code Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer PO Box | Optional | string | buyer po box Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Post Office | Optional | string | buyer post office Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Room Number | Optional | string | buyer room number Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Street Name | Optional | string | buyer street name Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Street Number | Optional | string | buyer street number Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Sub District | Optional | string | buyer sub district Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Time Zone | Optional | string | buyer time zone Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Valid From | Optional | date | buyer valid from Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Valid To | Optional | date | buyer valid to Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Verification Date | Optional | date | buyer verification date Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Verification Source | Optional | string | buyer verification source Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Verified | Optional | string | buyer verified Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Ward | Optional | string | buyer ward Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer What Three Words | Optional | string | buyer what three words Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Zone | Optional | string | buyer zone Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Address Line 1 | Optional | string | Buyer address line 1 Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Address Line 2 | Optional | string | Buyer address line 2 Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Address Line 3 | Optional | string | Buyer address line 3 Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer City | Optional | string | Buyer city Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Postal Code | Optional | string | Buyer postal code Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer State/Province | Optional | string | Buyer state/province Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Business Activity | Optional | string | Buyer business activity Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Contact Email | Optional | string | Buyer contact email Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Contact Name | Optional | string | Buyer contact name Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Contact Phone | Optional | string | Buyer contact phone Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Industry Classification Code | Optional | string | Buyer industry code Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Industry Classification Description | Optional | string | Buyer industry description Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Industry Classification Scheme | Optional | string | Buyer industry scheme Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Party ID | Optional | string | Buyer internal party ID Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Tax ID Type | Optional | string | Buyer tax ID type Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Tax ID Value | Optional | string | Buyer tax ID value Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Buyer Trade Name | Optional | string | Buyer trade name Optional for tax invoices, credit notes and debit notes; not used in simplified invoices, simplified credit notes and simplified debit notes. | |
| Delivery Country | Conditional | string | Delivery country Mandatory with the third_party modifier. Third-party billing requires delivery party country | |
| Delivery Party Name | Conditional | string | Delivery party name Mandatory with the third_party modifier. Third-party billing requires delivery party name | |
| Delivery Tax ID Value | Conditional | string | Delivery tax ID value Mandatory with the third_party modifier. Third-party billing requires delivery party tax ID | |
| Delivery Access Code Building | Optional | string | delivery access code building | |
| Delivery Access Code Gate | Optional | string | delivery access code gate | |
| Delivery Access Code Intercom | Optional | string | delivery access code intercom | |
| Delivery Address Type | Optional | string | delivery address type | |
| Delivery Address Usage | Optional | string | delivery address usage | |
| Delivery Apartment | Optional | string | delivery apartment | |
| Delivery Attention To | Optional | string | delivery attention to | |
| Delivery Building Name | Optional | string | delivery building name | |
| Delivery Building Number | Optional | string | delivery building number | |
| Delivery Business Hours Close | Optional | string | delivery business hours close | |
| Delivery Business Hours Days | Optional | array | delivery business hours days | |
| Delivery Business Hours Open | Optional | string | delivery business hours open | |
| Delivery Care Of | Optional | string | delivery care of | |
| Delivery Delivery Instructions | Optional | string | delivery delivery instructions | |
| Delivery Delivery Point | Optional | string | delivery delivery point | |
| Delivery District | Optional | string | delivery district | |
| Delivery Floor | Optional | string | delivery floor | |
| Delivery Geo Location Latitude | Optional | number | delivery geo location latitude | |
| Delivery Geo Location Longitude | Optional | number | delivery geo location longitude | |
| Delivery Landmark | Optional | string | delivery landmark | |
| Delivery Plus Code | Optional | string | delivery plus code | |
| Delivery PO Box | Optional | string | delivery po box | |
| Delivery Post Office | Optional | string | delivery post office | |
| Delivery Room Number | Optional | string | delivery room number | |
| Delivery Street Name | Optional | string | delivery street name | |
| Delivery Street Number | Optional | string | delivery street number | |
| Delivery Sub District | Optional | string | delivery sub district | |
| Delivery Time Zone | Optional | string | delivery time zone | |
| Delivery Valid From | Optional | date | delivery valid from | |
| Delivery Valid To | Optional | date | delivery valid to | |
| Delivery Verification Date | Optional | date | delivery verification date | |
| Delivery Verification Source | Optional | string | delivery verification source | |
| Delivery Verified | Optional | string | delivery verified | |
| Delivery Ward | Optional | string | delivery ward | |
| Delivery What Three Words | Optional | string | delivery what three words | |
| Delivery Zone | Optional | string | delivery zone | |
| Delivery Address Line 1 | Optional | string | Delivery address line 1 | |
| Delivery Address Line 2 | Optional | string | Additional delivery address line | |
| Delivery Address Line 3 | Optional | string | Third delivery address line | |
| Delivery City | Optional | string | Delivery city | |
| Delivery Post Code | Optional | string | Postal code for delivery address | |
| Delivery Country Subdivision | Optional | string | State, emirate or province for delivery address | |
| Delivery Business Activity | Optional | string | Delivery business activity | |
| Delivery Contact Email | Optional | string | Delivery contact email | |
| Delivery Contact Name | Optional | string | Delivery contact name | |
| Delivery Contact Phone | Optional | string | Delivery contact phone | |
| Actual Delivery Date | Optional | date | Actual delivery date | |
| Actual Delivery Time | Optional | string | Actual delivery time | |
| Customs Declaration Number | Optional | string | customs declaration number | |
| Destination Port | Optional | string | Destination port | |
| Export Date | Optional | date | export date | |
| Freight | Optional | string | freight | |
| Freight Document | Optional | string | freight document | |
| Incoterms | Optional | string | Delivery terms (Incoterms) | |
| Origin Port | Optional | string | Origin port | |
| Special Terms | Optional | string | special terms | |
| Transport Mode | Optional | string | transport mode | |
| Delivery Industry Classification Code | Optional | string | Delivery industry classification code | |
| Delivery Industry Classification Description | Optional | string | Delivery industry classification description | |
| Delivery Industry Classification Scheme | Optional | string | Delivery industry classification scheme | |
| Delivery Party ID | Optional | string | Identifier for delivery party | |
| Delivery Peppol ID | Optional | string | Delivery party's Peppol network identifier | |
| Deliver to Legal Registration Type | Optional | string | Type of registration for delivery party | |
| Deliver to Legal Registration | Optional | string | Registration number for delivery party | |
| Delivery Tax ID Type | Optional | string | Delivery tax ID type | |
| Delivery Trade Name | Optional | string | Delivery party trade name | |
| Line Item ID | Mandatory | string | Line item identifier | |
| Line Item Total | Mandatory | number | Line item total | |
| Line Item Name | Mandatory | string | Line item name/description | |
| Item Net Price | Mandatory | number | Net unit price excluding VAT. | |
| Line Item Quantity | Mandatory | number | Line item quantity | |
| Line Item Tax Amount | Mandatory | number | Tax amount for the line item, excluding the net line amount. | |
| Line Item Unit Code | Mandatory | string | Unit code (PCE, KGM, etc.) | |
| Buyer Item Code | Optional | string | Buyer item code | |
| Commodity Classification Code | Optional | string | Commodity classification code | |
| Commodity Classification Description | Optional | string | Commodity classification description | |
| Commodity Classification Scheme | Optional | string | Commodity classification scheme | |
| Commodity Code | Optional | string | Tariff/commodity code | |
| Country Of Origin | Optional | string | Country of origin | |
| Line Item Description | Optional | string | Line item description | |
| Line Discount/Charge Amount | Optional | number | Discount/Charge amount | |
| Line Discount/Charge Base Amount | Optional | number | Discount/Charge base amount | |
| Line Discount/Charge ID | Optional | string | Discount/Charge ID | |
| Line Discount/Charge is Charge | Optional | boolean | Is charge or discount | |
| Line Discount/Charge Percentage | Optional | number | Discount/Charge percentage | |
| Line Discount/Charge Reason | Optional | string | Discount/Charge reason | |
| Line Discount/Charge Reason Code | Optional | string | Discount/Charge reason code | |
| Line Discount/Charge Tax Amount | Optional | number | Discount/Charge tax amount | |
| Line Discount/Charge Tax Category | Optional | string | Discount/Charge tax category | |
| Line Discount/Charge Tax Rate | Optional | number | Discount/Charge tax rate | |
| Line Taxable Value | Optional | number | Line taxable value | |
| Line Type | Optional | string | Line type | |
| Base Quantity | Optional | number | Base quantity | |
| Base Quantity Unit Code | Optional | string | Base quantity unit code | |
| Item Gross Price | Optional | number | Unit price before a price-level discount, excluding VAT. | |
| Line Related Document Type | Optional | string | Related document type | |
| Line Related Document ID | Optional | string | Related document ID | |
| Seller Item Code | Optional | string | Seller item code | |
| Standard Item Code ID | Optional | string | Standard item code ID | |
| Standard Item Code Scheme | Optional | string | Standard item code scheme | |
| Line Tax Category | Optional | string | Line tax category | |
| Tax Exemption Reason | Optional | string | Tax exemption reason | |
| Tax Exemption Reason Code | Optional | string | Tax exemption reason code | |
| Line Tax Rate | Optional | number | Line tax rate | |
| Line Rounding Amount | Optional | number | KSA line-level RoundingAmount (ZATCA Phase 2). | |
| Amount Due | Mandatory | number | Amount due | |
| Total Amount Excluding Tax | Mandatory | number | Total excluding tax | |
| Total Amount Including Tax | Mandatory | number | Total including tax | |
| Total Line Taxable Amount | Mandatory | number | Sum of line taxable values | |
| Total Tax Amount | Mandatory | number | Total tax amount | |
| Prepaid Amount | Optional | number | Prepaid amount | |
| Rounding Amount | Optional | number | Rounding adjustment | |
| Total Allowances | Optional | number | Total allowances | |
| Total Charges | Optional | number | Total charges | |
| Invoice Discount/Charge Amount | Optional | number | Allowance/charge amount | |
| Invoice Discount/Charge Base Amount | Optional | number | Base amount | |
| Invoice Discount/Charge Line ID | Optional | string | Allowance/Charge ID | |
| Invoice-level Is Charge | Optional | boolean | Charge (true) or allowance (false) | |
| Invoice Discount/Charge Percentage | Optional | number | Percent applied | |
| Invoice Discount/Charge Reason | Optional | string | Reason for allowance/charge | |
| Invoice Discount/Charge Reason Code | Optional | string | Reason code | |
| Invoice Discount/Charge Tax Amount | Optional | number | Tax amount | |
| Invoice Discount/Charge Tax Category | Optional | string | Tax category | |
| Invoice Discount/Charge Tax Rate | Optional | number | Tax rate | |
| Payee Account ID | Conditional | string | Payee account ID | |
| Card Holder Name | Optional | string | Card holder name | |
| Card Network | Optional | string | Card network ID | |
| Card PAN | Optional | string | Card primary account number | |
| Payee Account Name | Optional | string | Payee account name | |
| Payee Institution Branch | Optional | string | Payee institution branch | |
| Direct Debit Mandate Ref ID | Optional | string | Direct debit mandate reference | |
| Payer Financial Account | Optional | string | Payer financial account | |
| Payment ID | Optional | string | Payment identifier | |
| Payment Means Code | Optional | string | Payment method type. Must be one of: 'CASH', 'CREDIT', 'PAYMENT_TO_BANK_ACCOUNT', 'BANK_CARD', 'INSTRUMENT_NOT_DEFINED', 'CHEQUE', 'ACH', 'BANKER_DRAFT', 'OTHER'. Will be converted to numeric code for ZATCA XML. | |
| Payment Means Text | Optional | string | Payment method description | |
| Discount Amount | Optional | number | Discount amount | |
| Discount Due Date | Optional | date | Discount due date | |
| Payment Terms Note | Optional | string | Payment terms note | |
| Penalty Amount | Optional | number | Penalty amount | |
| Penalty Percentage | Optional | number | Penalty percent | |
| Settlement Discount Percentage | Optional | number | Settlement discount percent | |
| Supporting Document Type | Conditional | string | Type of supporting document Mandatory with the b2g modifier. B2G requires supporting document type | |
| Supporting Document ID | Conditional | string | Supporting document identifier Mandatory with the b2g modifier. B2G requires supporting document ID | |
| Attachment Checksum | Optional | string | Attachment checksum | |
| Attachment Content | Optional | string | Attachment base64 content | |
| Attachment Content URL | Optional | string | Attachment content URL | |
| Attachment Description | Optional | string | Attachment description | |
| Attachment Filename | Optional | string | Attachment file name | |
| Attachment Mime Code | Optional | string | Attachment mime code | |
| Attachment Size | Optional | number | Attachment size | |
| Supporting Document Description | Optional | string | Description of supporting document | |
| Supporting Document Issue Date | Optional | date | Supporting document issue date | |
| Supporting Document URL | Optional | string | Reference URL | |
| Contract Reference | Optional | string | Contract reference for KSA XML rendering. | |
| Digital Signature | Optional | string | Base64 encoded digital signature for ZATCA compliance. | |
| Invoice Counter Value | Optional | string | Invoice counter value (ICV) for ZATCA invoice sequencing. | |
| Previous Invoice Hash | Optional | string | Previous invoice hash (PIH) for ZATCA invoice chaining. | |
| Prepayment Adjustment Amount | Optional | number | Adjustment amount for the prepayment. | |
| Prepayment Date | Optional | date | Date of the prepayment. | |
| Prepayment ID | Optional | string | Identifier for prepayment reference. | |
| Prepayment Taxable Amount | Optional | number | Taxable amount for the prepayment. | |
| Prepayment Tax Amount | Optional | number | Tax amount for the prepayment. | |
| Prepayment Tax Category | Optional | string | Tax category for the prepayment. | |
| Prepayment Tax Rate | Optional | number | Tax rate for the prepayment. | |
| Prepayment Type Code | Optional | string | Type code for the prepayment. | |
| Purchase Order Reference | Optional | string | Purchase order reference for KSA XML rendering. | |
| QR Code | Optional | string | Base64 encoded QR code for ZATCA compliance. | |
| Destination Authority | Optional | string | Destination authority | |
| Destination Body | Optional | string | Email body | |
| Destination Country | Optional | string | Destination country | |
| Destination Document Type | Optional | string | Destination document type | |
| Destination Participant ID | Optional | string | Peppol participant ID | |
| Destination Recipients | Optional | array | Email recipients | |
| Destination Subject | Optional | string | Email subject | |
| Destination Type | Optional | string | Destination type for submission | |
| Is B2B | Optional | boolean | Business to Business flag | |
| Is Testbed | Optional | boolean | Testbed document flag | |
| Purpose | Optional | string | Document purpose (e.g., testbed, e-invoicing, mapping) | |
| Mode | Optional | string | Document processing mode | |
| Operation | Optional | string | Document operation type | |
| Source ID | Optional | string | Source identifier | |
| Source Name | Optional | string | Source name | |
| Source Type | Optional | string | Source type | |
| Source Version | Optional | string | Source version | |
| Version | Optional | string | Document version |