logotype
  • Key Features
  • What is VITA?
  • Why VITA?
  • Solutions
    • E-Invoicing
    • Value Added Tax (VAT)
    • Withholding Tax (WHT)
    • Zakat/Corporate Income Tax (CIT)
  • Services
    • Country By Country Reporting (CBCR)
    • Excise Duty
    • Customs Duty
    • Contract Information Filing
  • en_USEnglish
    • arالعربية
Let’s Connect
Experience VITA
logotype
  • Key Features
  • What is VITA?
  • Why VITA?
  • Solutions
    • E-Invoicing
    • Value Added Tax (VAT)
    • Withholding Tax (WHT)
    • Zakat/Corporate Income Tax (CIT)
  • Services
    • Country By Country Reporting (CBCR)
    • Excise Duty
    • Customs Duty
    • Contract Information Filing
  • en_USEnglish
    • arالعربية
Let’s Connect
Experience VITA
logotype
  • Key Features
  • What is VITA?
  • Why VITA?
  • Solutions
    • E-Invoicing
    • Value Added Tax (VAT)
    • Withholding Tax (WHT)
    • Zakat/Corporate Income Tax (CIT)
  • Services
    • Country By Country Reporting (CBCR)
    • Excise Duty
    • Customs Duty
    • Contract Information Filing
  • en_USEnglish
    • arالعربية
logotype
  • Key Features
  • What is VITA?
  • Why VITA?
  • Solutions
    • E-Invoicing
    • Value Added Tax (VAT)
    • Withholding Tax (WHT)
    • Corporate Income Tax
  • Services
    • Country By Country Reporting (CBCR)
    • Excise Duty
    • Customs Duty
    • Contract Information Filing
  • en_USEnglish
    • arالعربية
  • Let’s Connect
  • Experience VITA

VITA Documentation

Here you'll find the answers most valued by our partner's, along with detailed answers and relevant topics .

Getting Started

  • Overview
  • Account Setup

E-Invoicing API

  • Master Error Codes
  • Authentication
  • Getting Started
  • Sales Invoice
  • Credit Note
  • Debit Note

VITA API Documentation

  • Overview
  • Authentication
  • Integration Methods
  • VAT API
  • WHT API
  • Account Set Up

FAQ

  • E Invoicing
  • Type of Invoices
  • Phase I of KSA e-Invoicing
  • Phase II of KSA e-Invoicing
  • KSA e-Invoicing System and data storage
View Categories

Debit Note

Vita E-Invoicing allows you to create and print error-free e‑invoices with all the mandatory fields. The transactions are preemptively validated during invoice creation to identify violations, incorrect data entry, and missing mandatory fields. You can push invoices and their associated notes to the ZATCA portal in bulk for authentication. Your transactions will be authenticated and e-invoices ready within seconds.

URL : http://{{Host-Name}}/api/services/app/Einvoice/DebitNote

Method : Post

Request Headers

PARAMETERTYPEDESCRIPTION
accessTokenStringAccess tokens are used in token-based authentication to allow an application to access an API. The application receives an access token after a user successfully authenticates and authorizes access, then passes the access token as a credential when it calls the target API.

Request Parameters

{
    "generateDraft": false,
    "invoiceNumber": "212350",
    "issueDate": "2023-06-30 00:00:00.000",
    "dateOfSupply": "2023-06-30 00:00:00.000",
    "invoiceCurrencyCode": "SAR",
    "currencyCodeOriginatingCountry": "SA",
    "purchaseOrderId": "12312121",
    "billingReferenceId": "15151432",
    "latestDeliveryDate": "2023-06-30 00:00:00.000",
    "AccountName": "Saudi Arabian Glass Co. Ltd.",
    "AccountNumber": "0471040122",
    "IBAN": "SA5655000000004710400122",
    "BankName": "Banque Saudi Fransi",
    "SwiftCode": "BSFRSARI",
    "BranchName": "Jeddah Souk Branch",
    "BranchAddress": "P O Box 7888, Jeddah 21472, SAUDI ARABIA",
    "InvoiceNotes": "Test B2B Std Inv",
   "AdditionalData1": [
    {
      "exchangeRate": 1
    }
  ],
    "additionalData2": [],
    "location": "JEDDAH",
    "customerId": "556",
    "status": "OP",
    "paymentType": "45 NET",
     "Supplier": [
      {
          "RegistrationName": "Hussain Saleh Al Salah Est.",
          "VATID": "300789292500003",
          "GroupVATID": null,
          "CRNumber": "4030126297",
          "OtherID": null,
          "CustomerId": null,
          "Type": null,
          "FaxNo": "6040702",
          "Website": "",
          "Address": {
              "Street": "Al Wurud Dist.",
              "AdditionalStreet": "",
              "BuildingNo": "2222",
              "AdditionalNo": "6300",
              "City": "Jeddah",
              "PostalCode": "23221",
              "State": "",
              "Neighbourhood": null,
              "CountryCode": "SA",
              "Type": null,
              "Language": null,
              "AdditionalData1": []
          },
          "ContactPerson": {
              "Name": null,
              "EmployeeCode": null,
              "ContactNumber": "966505355760",
              "GovtId": null,
              "Email": null,
              "Address": null,
              "Location": null,
              "Type": null,
              "Language": null,
              "AdditionalData1": []
          },
          "Language": null,
          "AdditionalData1": []
      }
  ],
  "Buyer": [
      {
          "RegistrationName": "Nouf Nadeeem Saad Al Nadwi ",
          "VATID": "300789292500003",
          "GroupVATID": null,
          "CRNumber": null,
          "OtherID": null,
          "CustomerId": "3009679",
          "Type": "Buyer",
          "FaxNo": null,
          "Website": null,
          "Address": {
              "Street": "705 Saud Al Faisal Street 1234 Jeddah Al Khalidiyah ",
              "AdditionalStreet": null,
              "BuildingNo": null,
              "AdditionalNo": null,
              "City": "Jeddah ",
              "PostalCode": "21455",
              "State": "ALkhobar",
              "Neighbourhood": ".",
              "CountryCode": "SA",
              "Type": "Buyer",
              "Language": "EN",
              "AdditionalData1": []
          },
          "ContactPerson": {
              "Name": "Nouf ",
              "EmployeeCode": null,
              "ContactNumber": "567896545678",
              "GovtId": null,
              "Email": "naouf@gmail.com",
              "Address": null,
              "Location": null,
              "Type": "Buyer",
              "Language": null,
              "AdditionalData1": []
          },
          "Language": "EN",
          "AdditionalData1": []
      },
      {
          "RegistrationName": "Nouf Nadeeem Saad Al Nadwi ",
          "VATID": "",
          "GroupVATID": null,
          "CRNumber": null,
          "OtherID": null,
          "CustomerId": "3009679",
          "Type": "Buyer",
          "FaxNo": null,
          "Website": null,
          "Address": {
              "Street": "705 Saud Al Faisal Street 1234 Jeddah Al Khalidiyah ",
              "AdditionalStreet": "",
              "BuildingNo": "",
              "AdditionalNo": null,
              "City": "Jeddah ",
              "PostalCode": "21455",
              "State": "ALkhobar",
              "Neighbourhood": "",
              "CountryCode": "Saudi Arabia",
              "Type": "Buyer",
              "Language": "AR",
              "AdditionalData1": []
          },
          "ContactPerson": null,
          "Language": "AR",
          "AdditionalData1": []
      }
  ],
    "invoiceTypeCode": "383",
   "items": [
    {
      "identifier": "Sales",
      "name": "wer",
      "description": "wrewer",
      "quantity": 1,
      "uom": "PC",
      "unitPrice": 2112,
      "discountPercentage": 10,
      "discountAmount": 211.2,
      "netPrice": 1900.80,
      "vatRate": 15,
      "vatCode": "S",
      "vatAmount": 285.12,
      "lineAmountInclusiveVAT": 2185.92,
      "currencyCode": "SAR",
      "isOtherCharges": false
    }
  ],
  "invoiceSummary": {
    "netInvoiceAmount": 2112,
    "netInvoiceAmountCurrency": "SAR",
    "sumOfInvoiceLineNetAmount": 1900.8,
    "totalAmountWithoutVAT": 1900.8,
    "totalAmountWithoutVATCurrency": "SAR",
    "totalVATAmount": 285.12,
    "currencyCode": "SAR",
    "totalAmountWithVAT": 2185.92,
    "paidAmountCurrency": "SAR",
    "payableAmountCurrency": "SAR",
    "additionalData1": []
  },
    "vatDetails": [
        {
            "taxSchemeId": "203333",
            "vatCode": "S",
            "vatRate": 15,
            "excemptionReasonCode": null,
            "excemptionReasonText": null,
            "taxableAmount": 285.12,
            "taxAmount": 0,
            "currencyCode": "SAR"
        }
    ]
}

200 – Success

{
  "invoiceId": 0,
  "invoiceNumber": "string",
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "qrCodeUrl": "string",
  "pdfFileUrl": "string",
  "xmlFileUrl": "string"
}

401 – Unauthorized

{
    "result": null,
    "targetUrl": null,
    "success": false,
    "error": {
        "code": 0,
        "message": "Current user did not login to the application!",
        "details": null,
        "validationErrors": null
    },
    "unAuthorizedRequest": true,
    "__abp": true
}

400 – Bad Request

{
    "ValidationResults": {
        "Errors": [
            {
                "ErrorCode": "BR-02",
                "ErrorMessage": "An Invoice shall have an Invoice number   (BT-1)."
            },
            {
                "ErrorCode": "BR-KSA-04",
                "ErrorMessage": "The document issue date (BT-2)must be less or equal to thecurrent date"
            }
        ]
    },
    "Message": "Validation error occurred",
    "Status": "FAILED"
}

Click here for ZATCA mandated Error Response Codes
Credit Note

What is VITA?

VITA - Your Virtual Intelligent Tax Advisor

A global tax compliant platform, that examines, interprets and analyzes business accounting and tax records, provides data to manage tax strategies and minimizes liabilities enabling businesses to stay compliant and optimize financial statements.

 

VITA helps businesses to comply with local tax laws and regulations. It is accredited from ZATCA for E-Invoicing Phase I and II requirements.

Become channel partner

Quick Links

  • Home
  • About Us
  • Why VITA?
  • E-Invoice API Documentation
  • Contact Us
  • VITA FAQ

Solutions

  • E-Invoicing
  • Value Added Tax (VAT)
  • Withholding Tax (WHT)
  • Zakat/Corporate Income Tax (CIT)

Services

  • Country By Country Reporting
  • Excise Duty
  • Customs Duty
  • Contract Information Filing

Contact Vita

  • Request for Quote
  • Become a Channel Partner
  • Privacy Policy

sales@vita-xpro.com

+966 539769668, +966 504677016

Facebook-fLinkedin-inTwitterInstagram
logotype

Copyright © 2023 VITA. All Rights Reserved.

BACK TO TOP