Field Mapping Payload Reference
Complete field mapping reference for all Unify API v3 payload fields organized by country.
Last Updated: 2024 · Scope: SA · MY · BE · DE · AE
Overview
This page provides a comprehensive field mapping reference organized by country sections. Each table includes:
- Parameter: Human-readable field name (what the field represents, not JSON paths)
- Required: Whether the field is mandatory (
Yes), optional (No), or conditional (Conditional)
- What It Means: Clear explanation of the field's purpose and business context
- Example: Realistic example values for that field
Quick Navigation
Select your country:
Saudi Arabia (SA)
| Parameter | Required | What It Means | Example |
|---|
| Document Type | Yes | The type of document being submitted (Invoice, Credit Note, or Debit Note). Determines the base document classification for KSA e-invoicing. | tax_invoice |
| Document ID | Yes | Unique identifier for the invoice within the seller's sequence. Must be unique per seller and follow KSA format. | INV-2024-001 |
| Issue Date | Yes | The date the invoice was created in YYYY-MM-DD format. Used for ZATCA tax period determination. | 2024-01-15 |
| Issue Time | Yes | The time the invoice was created in HH:MM:SS format. Used for precise timestamping with ZATCA. | 14:30:00 |
| Document Currency | Yes | ISO 4217 currency code. Defaults to SAR for KSA. Exchange rate required when currency differs from SAR. | SAR |
| Exchange Rate | Conditional | Currency conversion rate (required only when currency differs from SAR). | 3.75 |
| VAT Currency | No | Currency used for VAT calculations. Defaults to document currency. | SAR |
| Supply Start Date | Conditional | Required for period-based invoices. Start date of the supply period. | 2024-01-01 |
| Supply End Date | Conditional | End date of the supply period. Used for consolidated invoices. | 2024-01-31 |
| Billing Frequency | Conditional | Frequency of billing for consolidated invoices (monthly, quarterly, annually, weekly). | monthly |
| Due Date | No | Payment due date. Optional but recommended for cash flow management. | 2024-02-15 |
| Reference Invoice Number | Conditional | Reference to original invoice for credit/debit notes. Required for corrective documents. | INV-2023-999 |
| Note Issuance Reason | Conditional | Reason for issuing credit/debit note. Required for corrective documents. | Goods returned |
Seller Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Seller Name | Yes | Legal registered name of the seller. Must match business registration with ZATCA. | Tech Solutions LLC |
| Seller ID | No | Internal ERP identifier for the seller. Optional but useful for system integration. | SEL-001 |
| VAT Number Type | Yes | VAT identification scheme for KSA (usually VAT or GVAT). | VAT |
| VAT Number Value | Yes | KSA VAT number in 15-digit format. Must be valid and registered with ZATCA. | 310075588700003 |
| Additional Seller ID Number | Yes | Commercial registration number (CRN). Required for business registration compliance. | 1234567890 |
| Additional Seller ID Type | Yes | Registration scheme type (CRN - Commercial Registration). | CRN |
| Seller Industry Classification | Yes | Industry classification code for business activity identification. | 61110 |
| Seller Contact Number | Yes | Seller contact phone number. Required for ZATCA communication. | +966501234567 |
| Seller Email | No | Contact email. Optional but useful for electronic communication. | info@techsolutions.sa |
| Address Line 1 | Yes | Primary street address. Must be complete and accurate for ZATCA verification. | King Fahd Road |
| Address Line 2 | No | Secondary address information. | Suite 100 |
| Building Number | Yes | Building number. Required in KSA for precise location identification. | 123 |
| District/Neighbourhood | Yes | District or neighbourhood. Required for local area identification. | Olaya |
| City | Yes | City name. Must match official city names for tax jurisdiction. | Riyadh |
| State | Yes | State name. Required for tax jurisdiction and regional compliance. | Riyadh Region |
| Postal Code | Yes | Postal/ZIP code. Required for address validation. | 11478 |
| Country | Yes | Country code. Must be 'SA' for KSA addresses. | SA |
| Seller Peppol ID | No | Peppol network identifier for cross-border e-invoicing. Optional for KSA. | 9930:SAxxxxxxxxxxxxxx |
Buyer Information Fields (B2B)
| Parameter | Required | What It Means | Example |
|---|
| Buyer Name | Conditional | Buyer name. Required for B2B transactions, optional for B2C. | ABC Corporation |
| Buyer ID | No | Internal identifier for the buyer. Optional for system integration. | BUYER-001 |
| Buyer VAT Number Type | Conditional | VAT identification scheme. Required for B2B transactions. | VAT |
| Buyer VAT Number Value | Conditional | Buyer VAT number in 15-digit format. Required for B2B transactions. | 301234567890001 |
| Buyer Additional ID Number | Conditional | Buyer registration number. Required for B2B transactions. | 9876543210 |
| Buyer Additional ID Type | Conditional | Buyer registration scheme type. Required for B2B transactions. | CRN |
| Buyer Peppol ID | No | Buyer Peppol identifier for cross-border transactions. Optional. | 9930:SAyyyyyyyyyyyyyyyy |
| Buyer Contact Number | Conditional | Buyer contact phone. Required for B2B transactions. | +966501111111 |
| Buyer Email | No | Buyer contact email. Optional but recommended. | info@abccorp.sa |
| Buyer Address Line 1 | Conditional | Buyer primary address. Required for B2B transactions. | Prince Road |
| Buyer Address Line 2 | No | Buyer secondary address. | Floor 5 |
| Buyer Building Number | No | Buyer building number. Optional. | 456 |
| Buyer District | No | Buyer district. Optional. | Downtown |
| Buyer City | Conditional | Buyer city. Required for B2B transactions. | Jeddah |
| Buyer State | Conditional | Buyer state. Required for B2B transactions. | Makkah Region |
| Buyer Postal Code | Conditional | Buyer postal code. Required for B2B transactions. | 21461 |
| Buyer Country | Conditional | Buyer country code. | SA |
Line Items Fields
| Parameter | Required | What It Means | Example |
|---|
| Line Item ID | Yes | Unique identifier for each line item. Used for referencing items in the invoice. | LINE-001 |
| Item Description | Yes | Detailed description of the product or service. Supports multi-language. | Professional consulting services |
| Item Name | No | Short item name for product identification. Optional. | Consultation |
| Unit Price | Yes | Price per unit. Must be accurate for VAT calculations. | 1000.00 |
| Line Item Qty | Yes | Quantity of items ordered. Used for total calculations. | 5 |
| Units of Measurement | No | Unit code (PCE for pieces, HUR for hours, SET for sets). | HUR |
| Line Item Discount | No | Discount amount for this line. Applied before VAT. | 100.00 |
| Discount Rate | No | Discount percentage. | 10 |
| Discount Reason Code | No | Code explaining the discount. | 95 |
| Charge Amount | No | Any additional charges for this line. | 50.00 |
| Charge Reason Code | No | Code explaining the charge. | AA |
| Line Item Taxable Amount | Yes | Total line amount before VAT. Calculated as (Qty × Price) - Discounts. | 4900.00 |
| VAT Category Code | Yes | VAT category (S=Standard 15%, Z=Zero, E=Exempt, O=Out of scope). | S |
| VAT Rate On Line Item | Yes | VAT rate percentage. | 15 |
| Line Item VAT Amount | Yes | VAT amount for this line. Calculated as Taxable Amount × Rate. | 735.00 |
| Line Item Sub Total | Yes | Total including VAT. Calculated as Taxable Amount + VAT. | 5635.00 |
| Item Classification Code | Conditional | Product classification code. Required for goods. | 39301 |
| Item Classification Name | No | Description of the classification. Optional. | Consulting Services |
| VAT Exemption Reason Code | Conditional | Exemption code (required if VAT Category = Exempt). | VATEX-SA-32 |
| VAT Exemption Reason Text | Conditional | Text explaining the exemption. | Export of services |
Totals and Amounts Fields
| Parameter | Required | What It Means | Example |
|---|
| Summation of Line Taxable Values | Yes | Sum of all line item taxable amounts. Used for VAT verification. | 14700.00 |
| Total Taxable Amount Excluding VAT | Yes | Total invoice amount before VAT. | 14700.00 |
| VAT Total | Yes | Total VAT amount for entire invoice. Sum of line VAT amounts. | 2205.00 |
| Invoice Total Amount | Yes | Final amount payable including VAT. | 16905.00 |
| Discount at document level | Conditional | Document-level discount. Applied after line-level calculations. | 500.00 |
| Amount Due for Payment | Yes | Final amount due. Calculated as total - prepaid amounts. | 16405.00 |
| Pre-Paid Amount | No | Amount already paid in advance. | 0.00 |
| Rounding Amount | No | Rounding adjustment amount. Must be within acceptable limits. | 0.05 |
Payment Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Payment Means | Yes | Payment method code (CASH, CREDIT, PAYMENT_TO_BANK_ACCOUNT, BANK_CARD, INSTRUMENT_NOT_DEFINED). | PAYMENT_TO_BANK_ACCOUNT |
| Payee Bank Account Number | Conditional | Supplier's IBAN for payment. Required for bank transfers. Format: SA + 22 digits. | SA1234567890123456789012 |
| Payment Terms description | No | Free-text description of payment terms. | Payment due within 30 days |
| Prepayment Reference Number | No | Reference number for prepayments. Optional. | PREP-2024-001 |
KSA Digital Fields
| Parameter | Required | What It Means | Example |
|---|
| Invoice Counter Value | Yes | Sequential counter for ZATCA digital signature. Required for compliance. | 1 |
| Previous Invoice Hash | Yes | Hash of previous invoice for chain verification. Required for ZATCA. | NWZlY2E3YzcxNzQ... |
| QR Code | Yes | Base64 encoded QR data. Required for ZATCA compliance. | A0A0A0A0A0A0A0... |
| Digital Signature | Yes | Digital signature data for authenticity. Required for ZATCA. | MEUCIQD... |
| Prepayment ID | Conditional | Unique identifier for prepayments. | PREP-001 |
| Prepayment Issue Date & Time | Conditional | Date when prepayment issued. | 2024-01-10 |
| Prepayment Issue Time | Conditional | Time when prepayment issued. | 10:00:00 |
| Prepayment Document Type Code | Conditional | Document type for prepayment (always '386' for KSA). | 386 |
| Prepayment VAT Category Code | Conditional | VAT category for prepayment. Must match final invoice. | S |
| Prepayment VAT Rate | Conditional | VAT rate for prepayment. Must match final invoice. | 15 |
| Prepayment Taxable Amount | Conditional | Taxable amount of prepayment. | 1000.00 |
| Prepayment Tax Amount | Conditional | VAT amount of prepayment. | 150.00 |
| Prepayment Adjustment Amount | Conditional | Adjustment amount for prepayment. | 0.00 |
Malaysia (MY)
| Parameter | Required | What It Means | Example |
|---|
| E-Invoice Type Code | Yes | E-Invoice type (01=Invoice, 02=Credit Note, 03=Debit Note). Maps to LHDN requirements. | 01 |
| E-Invoice Code / Number | Yes | Unique identifier for the e-invoice. Must be unique per seller. | INV-MY-2024-001 |
| E-Invoice Date | Yes | Date the e-invoice was issued in YYYY-MM-DD format. | 2024-01-15 |
| E-Invoice Time | Yes | Time the e-invoice was issued in HH:MM:SS format. | 14:30:00 |
| Invoice Currency Code | Yes | ISO 4217 currency code. Defaults to MYR for Malaysia. | MYR |
| Currency Exchange Rate | Conditional | Exchange rate (required only when currency differs from MYR). | 4.65 |
| Tax Currency | No | Currency used for tax calculations. Defaults to document currency. | MYR |
| Billing Period Start Date | Conditional | Start date for period-based invoices. | 2024-01-01 |
| Billing Period End Date | Conditional | End date for period-based invoices. | 2024-01-31 |
| Frequency of Billing | Conditional | Billing frequency (monthly, quarterly, annually, weekly). | monthly |
| Due Date | No | Payment due date. Optional but recommended. | 2024-02-15 |
| Original E-Invoice Reference Number | Conditional | Reference to original e-invoice for credit/debit notes. | INV-MY-2023-999 |
| Note Issuance Reason | Conditional | Reason for issuing credit/debit note. | Goods returned |
Seller Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Supplier's Name | Yes | Legal registered name of the supplier. Must match LHDN registration. | Tech Solutions Sdn Bhd |
| Supplier ID | No | Internal ERP identifier for the supplier. Optional. | SEL-001 |
| Supplier's TIN | Yes | Tax identification scheme (usually TIN). | TIN |
| Supplier's TIN Number | Yes | Malaysia TIN number in format C12345678901. | C12345678901 |
| Supplier's Registration Number | Yes | Business registration number (BRN). | BRN1234567 |
| Supplier's Registration scheme ID | Yes | Registration scheme type. | BRN |
| Supplier's SST Registration Number | Conditional | SST registration number. Required for SST-registered businesses. | SST-001-12345678 |
| Supplier's Tourism Tax Registration Number | Conditional | Tourism tax registration. Required for hospitality businesses. | TTX-001-12345678 |
| Supplier's MSIC Code | Yes | MSIC code for business activity identification with LHDN. | 61110 |
| Seller Peppol ID | No | Peppol network identifier for cross-border e-invoicing. | 0177:C12345678901 |
| Supplier's Contact Number | Yes | Contact phone number. Required for LHDN communication. | +60312345678 |
| Supplier's e-mail | No | Contact email. Optional but useful. | info@techsolutions.my |
| Address Line 1 | Yes | Primary street address. Must be complete and accurate. | Jalan Merdeka |
| Address Line 2 | No | Secondary address information. | Unit 200 |
| Building Number | No | Building number. Optional. | 123 |
| District | No | District. Optional. | Kuala Lumpur |
| City Name | Yes | City name. Must match official city names. | Kuala Lumpur |
| State | Yes | State. Required for tax jurisdiction. | Wilayah Persekutuan |
| Postal Zone | Yes | Postal code. Required for address validation. | 50460 |
| Country | Yes | Country code. Must be 'MY' for Malaysia. | MY |
| Supplier's Business Activity | Yes | Description of business activities. Supports multi-language. | Information Technology Consulting |
Line Items Fields
| Parameter | Required | What It Means | Example |
|---|
| Line ID | Yes | Unique identifier for each line item. | LINE-001 |
| Description | Yes | Detailed description of product or service. Supports multi-language. | Professional consulting services for IT projects |
| Item Name | No | Short item name. Optional. | Consultation |
| Unit Price | Yes | Price per unit. Must be accurate for SST calculations. | 1000.00 |
| Quantity | Yes | Quantity of items. Used for total calculations. | 5 |
| Measurement | No | Unit code (PCE, HUR, SET, etc.). Optional. | HUR |
| Total Excluding Tax | Yes | Line total before SST. Calculated as (Qty × Price) - Discounts. | 4900.00 |
| Tax Type | Yes | Tax type (TX=Taxable, Z=Zero-rated, E=Exempt). | TX |
| Tax Rate | Yes | SST rate (6% for services, 10% for goods, 0% for zero-rated). | 6 |
| Tax Amount | Yes | SST amount for line. Calculated as Taxable Amount × Rate. | 294.00 |
| Line Total | Yes | Total including SST. Calculated as Taxable + Tax. | 5194.00 |
Totals and Amounts Fields
| Parameter | Required | What It Means | Example |
|---|
| Sum of Line Level Taxable Amounts | Yes | Sum of all line taxable amounts. Used for SST verification. | 14700.00 |
| Total Excluding Tax | Yes | Total invoice amount before SST. | 14700.00 |
| Total Tax Amount | Yes | Total SST amount for entire invoice. | 882.00 |
| Invoice Total Including Tax | Yes | Final amount payable including SST. | 15582.00 |
| Total Payable Amount | Yes | Final amount due after prepayments. | 15082.00 |
Malaysia Digital Fields
| Parameter | Required | What It Means | Example |
|---|
| Issuer's Digital Signature | Yes | Digital signature for LHDN compliance. Required. | MEUCIQD... |
| LHDN Submission ID | Yes | LHDN submission tracking ID. Required. | LHDN-2024-001 |
Belgium (BE)
| Parameter | Required | What It Means | Example |
|---|
| Invoice Type Code | Yes | Document type (380=Invoice, 381=Credit Note, 383=Debit Note). Must be valid UBL type. | 380 |
| Document Number | Yes | Unique invoice number. Must follow Belgium format. | BE-INV-2024-001 |
| Issue Date | Yes | Invoice issue date in YYYY-MM-DD format. Required for all invoices. | 2024-01-15 |
| Issue Time | No | Invoice issue time in HH:MM:SSZ format. Optional but recommended. | 14:30:00Z |
| Document Currency Code | Yes | ISO 4217 currency code. Defaults to EUR for Belgium. | EUR |
| Exchange Rate | Conditional | Exchange rate (required only when currency differs from EUR). | 1.10 |
| Due Date | Yes | Payment due date. Required for B2B transactions in Belgium. | 2024-02-15 |
| Reference ID | Conditional | Reference to original invoice for credit/debit notes. | BE-INV-2023-999 |
| Note Issuance Reason | Conditional | Reason for credit/debit note. Required for corrective documents. | Goods returned |
Seller Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Seller Name | Yes | Legal registered name. Must match business registration. | Tech Solutions SPRL |
| Tax ID Type | Yes | Tax ID scheme. Fixed value: VAT for Belgium. | VAT |
| Tax ID Value | Yes | Belgian VAT number. Format: BE + 10 digits. Must be valid. | BE0123456789 |
| Registration Number | Yes | Company registration number (CBE). Format: 0123.456.789. | 0123.456.789 |
| Street Name | Yes | Street name. Must be complete and accurate. | Avenue Louise |
| Building Number | Yes | Building number. Required. | 123 |
| City | Yes | City name. Required. | Bruxelles |
| Postal Code | Yes | Postal code. Format: 4 digits. | 1050 |
| Country | Yes | Country code. Must be "BE". | BE |
| Seller Phone | No | Contact phone number. Optional but recommended. | +32212345678 |
| Seller Email | No | Contact email. Optional but recommended. | info@techsolutions.be |
| Seller Peppol ID | No | Peppol endpoint identifier. Format: 9925:BE0123456789. | 9925:BE0123456789 |
Buyer Information Fields (B2B)
| Parameter | Required | What It Means | Example |
|---|
| Buyer Name | Conditional | Buyer name. Required for B2B transactions. | ABC Corporation |
| Buyer Tax ID Type | Conditional | Tax ID scheme. Required for B2B. Fixed value: VAT. | VAT |
| Buyer Tax ID Value | Conditional | Buyer VAT number. Must be valid EU VAT. | BE0987654321 |
| Buyer Registration Number | Conditional | Buyer company registration (CBE). Format: 0987.654.321. | 0987.654.321 |
| Buyer Street Name | Conditional | Buyer street name. Required for B2B. | Rue de la Loi |
| Buyer Building Number | No | Buyer building number. Optional. | 16 |
| Buyer City | Conditional | Buyer city. Required for B2B. | Bruxelles |
| Buyer Postal Code | Conditional | Buyer postal code. Format: 4 digits. | 1000 |
| Buyer Country | Conditional | Buyer country. Required for B2B. | BE |
| Buyer Phone | No | Buyer contact phone. Optional. | +32287654321 |
| Buyer Email | No | Buyer contact email. Optional. | info@abccorp.be |
Line Items Fields
| Parameter | Required | What It Means | Example |
|---|
| Line ID | Yes | Unique identifier for each line item. | LINE-001 |
| Item Name | Yes | Short item name. Required. | Service conseil |
| Item Description | No | Detailed description. Optional. | Professional consulting services |
| Item Price | Yes | Unit price. Required. | 100.00 |
| Invoiced Quantity | Yes | Quantity invoiced. Required. | 10.00 |
| Unit Code | Yes | Unit of measurement. UN/ECE format. | HUR |
| Line Taxable Amount | Yes | Line taxable amount excluding VAT. Required. | 950.00 |
| VAT Category | Yes | VAT category. Required. | S |
| VAT Rate | Yes | VAT rate percentage. Must match Belgian rates. | 21.0 |
| Line Tax Amount | Yes | VAT amount for line. Required. | 21.00 |
| Line Total | Yes | Line total including VAT. Required. | 121.00 |
Totals and Amounts Fields
| Parameter | Required | What It Means | Example |
|---|
| Total Line Taxable Amount | Yes | Sum of all line taxable amounts. | 1900.00 |
| Total Amount Excluding Tax | Yes | Total excluding VAT. | 1850.00 |
| Total Tax Amount | Yes | Total VAT amount. | 388.50 |
| Total Amount Including Tax | Yes | Total including VAT. | 2238.50 |
| Amount Due | Yes | Final amount due. | 1738.50 |
Payment Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Payment Means Code | No | Payment means code. UN/ECE 4461 format. | 30 |
| Payee IBAN | Conditional | Payee IBAN. Required for credit transfer. | BE6853900754703 |
| Payee Account Name | No | Payee account holder name. Optional. | Tech Solutions SPRL |
| BIC Code | Conditional | Bank BIC/SWIFT code. Required for credit transfer. | KREDBEBB |
| Payment Terms | Yes | Payment terms description. Required for B2B. | Net 30 days |
Germany (DE)
| Parameter | Required | What It Means | Example |
|---|
| Document Type | Yes | Document Type for XRechnung. | 380 |
| Invoice Number | Yes | Invoice number. Required. | RG2024-001 |
| Issue Date | Yes | Invoice issue date. Required. | 2024-01-15 |
| Currency Code | Yes | Currency code. Defaults to EUR. | EUR |
| Payment Due Date | No | Payment due date. Optional. | 2024-02-15 |
Seller Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Seller Name | Yes | Seller name. Required. | Tech Solutions GmbH |
| Tax ID Type | Yes | Tax ID scheme. | VAT |
| Tax ID Value | Yes | Tax ID number. Must be valid. | DE123456789 |
| Legal Registration ID | Yes | Business registration ID. | HRB123456 |
| Address Line 1 | Yes | Street address. | Hauptstrasse 123 |
| Seller City | Yes | City name. | Berlin |
| Seller Postal Code | Yes | Postal code. | 10115 |
| Seller Country Code | Yes | Country code. | DE |
Line Items Fields
| Parameter | Required | What It Means | Example |
|---|
| Item Name | Yes | Item name. Required. | Beratungsleistungen |
| Item Price | Yes | Unit price. Required. | 100.00 |
| Invoiced Quantity | Yes | Quantity. Required. | 10 |
| Line Taxable Amount | Yes | Line taxable amount. Required. | 1000.00 |
| VAT Category | Yes | VAT category. Required. | S |
| VAT Rate | Yes | VAT rate percentage. Required. | 19.0 |
| Line Tax Amount | Yes | VAT amount. Required. | 190.00 |
| Line Total | Yes | Line total with VAT. Required. | 1190.00 |
Totals and Amounts Fields
| Parameter | Required | What It Means | Example |
|---|
| Total Line Taxable Amount | Yes | Sum of line taxable amounts. | 1900.00 |
| Total Amount Excluding Tax | Yes | Total excluding VAT. | 1900.00 |
| Total Tax Amount | Yes | Total VAT amount. | 361.00 |
| Total Amount Including Tax | Yes | Total including VAT. | 2261.00 |
| Amount Due | Yes | Amount due for payment. | 2261.00 |
United Arab Emirates (AE)
| Parameter | Required | What It Means | Example |
|---|
| Invoice type code | Yes | Document type (invoice, credit_note, debit_note). | invoice |
| Invoice number | Yes | Unique invoice number. Required. | INV-AE-2024-001 |
| Invoice issue date | Yes | Invoice issue date. Required. | 2024-01-15 |
| Invoice issue time | Yes | Invoice issue time. Required. | 14:30:00 |
| Invoice currency code | Yes | Currency code. Defaults to AED. | AED |
| Payment due date | No | Payment due date. Optional. | 2024-02-15 |
Seller Information Fields
| Parameter | Required | What It Means | Example |
|---|
| Seller name | Yes | Legal registered name. Required. | Tech Solutions LLC |
| Seller VAT identifier | Yes | VAT number for UAE. Required. | 123456789012345 |
| Seller legal registration identifier | Yes | Business registration number. Required. | REG-123456 |
| Seller address line 1 | Yes | Street address. Required. | Sheikh Zayed Road |
| Seller city | Yes | City name. Required. | Dubai |
| Seller post code | Yes | Postal code. Required. | 00000 |
| Seller country code | Yes | Country code. Required. | AE |
| Seller contact telephone number | No | Contact phone. Optional. | +971234567890 |
| Seller contact email address | No | Contact email. Optional. | info@techsolutions.ae |
Buyer Information Fields (B2B)
| Parameter | Required | What It Means | Example |
|---|
| Buyer name | Conditional | Buyer name. | ABC Corporation |
| Buyer VAT identifier | Conditional | Buyer VAT number. | 123456789012346 |
| Buyer legal registration identifier | Conditional | Business registration number. | REG-654321 |
| Buyer address line 1 | Conditional | Street address. | Al Khaleej Road |
| Buyer city | Conditional | City name. | Abu Dhabi |
| Buyer post code | Conditional | Postal code. | 00000 |
| Buyer country | Conditional | Country code. | AE |
Line Items Fields
| Parameter | Required | What It Means | Example |
|---|
| Line Item ID | Yes | Unique line identifier. Required. | LINE-001 |
| Item Name | Yes | Item name. Required. | Consulting Services |
| Unit Price | Yes | Unit price. Required. | 1000.00 |
| Invoiced Quantity | Yes | Quantity. Required. | 5 |
| Line Taxable Amount | Yes | Taxable amount. Required. | 5000.00 |
| Line Total | Yes | Total with VAT. Required. | 5250.00 |
Totals and Amounts Fields
| Parameter | Required | What It Means | Example |
|---|
| Total Line Taxable Amount | Yes | Sum of line taxable amounts. | 5000.00 |
| Total Amount Excluding Tax | Yes | Total excluding VAT. | 5000.00 |
| Total Amount Including Tax | Yes | Total including VAT. | 5250.00 |
| Amount Due | Yes | Amount due for payment. | 5250.00 |
Data Formatting Guidelines
- Dates: All dates must be in
YYYY-MM-DD format (e.g., 2024-01-15)
- Times: All times must be in
HH:MM:SS or HH:MM:SSZ format (e.g., 14:30:00)
- Decimal Amounts: Use
. as decimal separator (e.g., 1000.00)
- Currency Codes: Follow ISO 4217 standard (e.g., SAR, MYR, EUR, AED)
- Country Codes: Follow ISO 3166-1 alpha-2 standard (e.g., SA, MY, BE, DE, AE)
- Phone Numbers: Include country code (e.g.,
+966501234567)
- Amounts: Always include two decimal places (e.g.,
1234.56)
See Also
