logotype
  • السمات الرئيسيه
  • ما هي فيتا؟
  • لماذا فيتا؟
  • الحلول
    • الفوترة الإلكترونية
    • ضريبة القيمة المضافة
    • ضريبة الاستقطاع
    • Zakat/Corporate Income Tax (CIT)
  • خدمات
    • التقرير الخاص بكل دولة
    • الرسوم على السلع الانتقائية
    • الرسوم الجمركية
    • تقديم معلومات العقد
  • en_USEnglish
    • arالعربية
دعونا نتواصل
تجربة منصة فيتا
logotype
  • السمات الرئيسيه
  • ما هي فيتا؟
  • لماذا فيتا؟
  • الحلول
    • الفوترة الإلكترونية
    • ضريبة القيمة المضافة
    • ضريبة الاستقطاع
    • Zakat/Corporate Income Tax (CIT)
  • خدمات
    • التقرير الخاص بكل دولة
    • الرسوم على السلع الانتقائية
    • الرسوم الجمركية
    • تقديم معلومات العقد
  • en_USEnglish
    • arالعربية
دعونا نتواصل
تجربة منصة فيتا
logotype
  • السمات الرئيسيه
  • ما هي فيتا؟
  • لماذا فيتا؟
  • الحلول
    • الفوترة الإلكترونية
    • ضريبة القيمة المضافة
    • ضريبة الاستقطاع
    • Zakat/Corporate Income Tax (CIT)
  • خدمات
    • التقرير الخاص بكل دولة
    • الرسوم على السلع الانتقائية
    • الرسوم الجمركية
    • تقديم معلومات العقد
  • en_USEnglish
    • arالعربية
logotype
  • السمات الرئيسيه
  • ما هي فيتا؟
  • لماذا فيتا؟
  • الحلول
    • الفوترة الإلكترونية
    • ضريبة القيمة المضافة
    • ضريبة الاستقطاع
    • ضريبة دخل الشركات
  • خدمات
    • التقرير الخاص بكل دولة
    • الرسوم على السلع الانتقائية
    • الرسوم الجمركية
    • تقديم معلومات العقد
  • en_USEnglish
    • arالعربية
  • دعونا نتواصل
  • تجربة منصة فيتا

وثائق فيتا

ستجد هنا الإجابات الأكثر تقديرًا من قبل شركائنا، بالإضافة إلى الإجابات التفصيلية والموضوعات ذات الصلة.

ابدء

  • Overview
  • Account Setup

واجهة برمجة تطبيقات الفواتير الإلكترونية

  • Master Error Codes
  • Authentication
  • ابدء
  • Sales Invoice
  • Credit Note
  • Debit Note

فيتا وثائق واجهة برمجة تطبيقات

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

الأسئلة الشائعة

  • الفوترة الإلكترونية
  • نوع الفاتورة
  • المرحلة الأولى للفوترة الإلكترونية في المملكة العربية السعودية
  • المرحلة الثانية للفوترة الإلكترونية في المملكة العربية السعودية
  • نظام الفوترة الإلكترونية في المملكة العربية السعودية وتخزين البيانات
View Categories

Credit 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 : https://{{Host-Name}}/api/services/app/Einvoice/CreditNote

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": "381",
   "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
Sales InvoiceDebit Note

ما هي فيتا؟

فيتا - مستشارك الضريبي الذكي الافتراضي

منصة عالمية متوافقة مع الضرائب، تقوم بفحص وتفسير وتحليل محاسبة الأعمال والسجلات الضريبية ، وتوفر بيانات لإدارة الاستراتيجيات الضريبية وتقليل الالتزامات التي تمكن الشركات من البقاء متوافقة مع تحسين القوائم المالية.

 

تساعد فيتا الشركات على الامتثال لانظمة ولوائح الضرائب المحلية وهي معتمدة من هيئة الزكاة والضريبة والجمارك فيما يتعلق بمتطلبات المرحلتين الأولى والثانية من الفوترة الإلكترونية.

Become channel partner

روابط سريعة

  • الصفحة الرئيسية
  • من نحن؟
  • لماذا فيتا؟
  • مستندات واجهة برمجة تطبيقات الفوترة الإلكترونية
  • اتصل بنا
  • الأسئلة المتداولة حول فيتا

الحلول

  • الفوترة الإلكترونية
  • ضريبة القيمة المضافة
  • ضريبة الاستقطاع
  • Zakat/Corporate Income Tax (CIT)

خدمات

  • التقرير الخاص بكل دولة
  • الرسوم على السلع الانتقائية
  • الرسوم الجمركية
  • تقديم معلومات العقد

تواصل مع فيتا

  • اطلب عرض اسعار
  • اصبح شريكا لنا
  • سياسه الخصوصيه

sales@vita-xpro.com

+966 539769668, +966 504677016

Facebook-fLinkedin-inTwitterInstagram
logotype

حقوق النشر © 2023 فيتا.كل الحقوق محفوظة.

العودة إلى الأعلى