Create Invoice

ایجاد فاکتور جدید در دیدار همراه با ردیف‌های محصول، اطلاعات خریدار و فروشنده و تنظیمات مالی سند

ایجاد فاکتور

فاکتور سند نهایی فروش محصولات یا خدمات به مشتری است.‎ با این Endpoint می‌توانید ردیف‌های فاکتور، تعداد، قیمت، تخفیف، مالیات و اطلاعات خریدار و فروشنده را ثبت کنید و در صورت نیاز، فاکتور را به یک معامله متصل کنید.‎

POST {{baseURL}}/api/AccountingInvoice/Create?apikey={{API_KEY}}

پارامترهای Query

پارامتر	نوع	وضعیت	توضیح
apikey	string	الزامی	کلید API دیدار.

Header درخواست

Content-Type: application/json

بدنه درخواست

Items[] · array · required

فهرست ردیف‌های محصول یا خدمت داخل فاکتور یا پیش‌فاکتور است. هر عضو یک ردیف مستقل با محصول، تعداد، قیمت، تخفیف و مالیات می‌سازد.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Show property

Items[].VariantId · string

شناسه زیرمحصول انتخاب‌شده برای این ردیف است.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Show شرایط ارسال

اگر محصول زیرمحصول ندارد، این فیلد را ارسال نکنید یا مطابق نمونه null بفرستید.

Items[].VariantTitle · string

عنوان زیرمحصول انتخاب‌شده است و روی ردیف سند مالی نمایش داده می‌شود.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Show شرایط ارسال

فقط برای ردیفی معنا دارد که زیرمحصول مشخصی انتخاب شده است.

Items[].Title · string

عنوان ردیف محصول یا خدمت که در فاکتور نمایش داده می‌شود.

Items[].Id · string

شناسه ردیف موجود در فاکتور یا پیش‌فاکتور؛ در ویرایش برای تطبیق ردیف ارسالی با ردیف ذخیره‌شده استفاده می‌شود.

Items[].TitleForInvoice · string

عنوان محصول برای نمایش در فاکتور.

Items[].ProductCode · string

کد اختصاصی محصول.

Items[].VariantCode · string

کد زیرمحصول انتخاب‌شده برای این ردیف است.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Show شرایط ارسال

فقط برای ردیفی ارسالش کنید که زیرمحصول مشخصی انتخاب شده است.

Items[].Description · string

توضیحات تکمیلی این ردیف در فاکتور.

Items[].Unit · string

واحد شمارش یا فروش محصول در این ردیف.

Items[].UnitPrice · string

قیمت هر واحد محصول پیش از تخفیف و مالیات.

Items[].VariantPrices[] · array

فهرست قیمت‌های زیرمحصول به تفکیک ارز.

Show property

Items[].VariantPrices[].Id · number

شناسه رکورد قیمت زیرمحصول؛ در ویرایش برای تطبیق قیمت ارسالی با قیمت ذخیره‌شده استفاده می‌شود.

Items[].VariantPrices[].CurrencyId · number

شناسه ارز قیمت زیرمحصول.

Items[].VariantPrices[].Price · string

قیمت زیرمحصول در ارز مشخص‌شده.

Items[].VariantPrices[].VariantId · string

شناسه زیرمحصولی است که این قیمت به آن تعلق دارد.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Items[].VariantPrices[].IsDeleted · boolean

مشخص می‌کند رکورد قیمت زیرمحصول حذف شده است یا فعال است.

Items[].ProductId · string

شناسه محصولی است که این ردیف فاکتور به آن مربوط می‌شود.

Show وابستگی‌ها

شناسه و اطلاعات محصول یا زیرمحصول را از Endpointهای محصول بردارید.

• Create Product — اگر محصول هنوز ساخته نشده است
• Search Products — برای جست‌وجوی محصول
• Get Product By Codes — اگر کد محصول را دارید

Items[].Discount · string

مبلغ تخفیف این ردیف.

Items[].TaxPercent · string

درصد مالیات قابل اعمال روی این ردیف محصول

Items[].DiscountPercent · number

درصد تخفیف این ردیف محصول

Items[].Quantity · number

تعداد محصول یا خدمت در این ردیف.

Items[].DiscountType · string

روش محاسبه تخفیف ردیف، مانند مبلغ ثابت یا درصدی. مقادیر: Amount Percent

Show مقادیر مجاز

• Amount — Discount به‌صورت مبلغ ثابت محاسبه می‌شود
• Percent — DiscountPercent به‌صورت درصد محاسبه می‌شود

Items[].SaleTypeId · string

شناسه نوع فروش محصول در این ردیف. بصورت پیشفرض مقدار این فیلد برابر است با مقدار زیر: 00000000-0000-0000-0000-000000000000

BizdomainProvider · object

اطلاعات سرویس‌دهنده یا اتصال خارجی فعال برای بیزدامنه.

SellerInfo · object · required

اطلاعات هویتی، ثبتی و تماس فروشنده است که روی فاکتور یا پیش‌فاکتور درج می‌شود.

Show property

SellerInfo.SellerName · string

نام حقیقی یا حقوقی فروشنده که در سربرگ فاکتور یا پیش‌فاکتور نمایش داده می‌شود.

SellerInfo.BizDomainId · string · required

شناسه بیزدامنه فروشنده که اطلاعات سند مالی به آن تعلق دارد.

SellerInfo.QuoteExpirationDays · number

تعداد روزهای اعتبار پیش‌فاکتور از زمان صدور.

SellerInfo.SellerEconomicCode · string

کد اقتصادی فروشنده برای صدور فاکتور رسمی.

SellerInfo.SellerNationalCode · string

شناسه ملی فروشنده حقیقی برای درج در سند رسمی.

SellerInfo.SellerPostalCode · string

کد پستی فروشنده.

SellerInfo.SellerProvince · string

استان نشانی فروشنده.

SellerInfo.SellerGrandCity · string

شهرستان یا محدوده شهری اصلی فروشنده.

SellerInfo.SellerCity · string

شهر نشانی فروشنده.

SellerInfo.SellerAddress · string

نشانی کامل فروشنده برای درج در سند.

SellerInfo.SellerPhone · string

شماره تلفن فروشنده برای درج در سند.

SellerInfo.InvoiceConditions · string

شرایط و توضیحات فروشنده که در فاکتور نمایش داده می‌شود.

SellerInfo.QuoteConditions · string

شرایط و توضیحات فروشنده که در پیش‌فاکتور نمایش داده می‌شود.

BuyerInfo · object · required

اطلاعات هویتی، ثبتی و تماس خریدار است که روی فاکتور یا پیش‌فاکتور درج می‌شود.

Show وابستگی‌ها

اطلاعات خریدار را از شخص یا شرکت مرتبط بردارید و در فیلدهای همین آبجکت قرار دهید؛ خود BuyerInfo فقط یک Id دریافت نمی‌کند.

• Create Person — ساخت شخص خریدار
• Get Person By Id — دریافت اطلاعات شخص
• Get Person By Mobile — پیداکردن شخص با موبایل
• Search Person — جست‌وجوی شخص
• Create Company — ساخت شرکت خریدار
• Get Company By Id — دریافت اطلاعات شرکت
• Search Company — جست‌وجوی شرکت

Show property

BuyerInfo.BuyerType · string

نوع خریدار، مانند شخص حقیقی یا حقوقی؛ تعیین می‌کند کدام اطلاعات هویتی و ثبتی در سند معتبر و قابل نمایش باشند.

BuyerInfo.BuyerTitle · string

عنوان یا نام تجاری خریدار برای نمایش در فاکتور یا پیش‌فاکتور.

BuyerInfo.BuyerName · string

نام خریدار برای درج در سند مالی.

BuyerInfo.BuyerEconomicCode · string

کد اقتصادی خریدار برای صدور فاکتور رسمی.

BuyerInfo.BuyerNationalCode · string

کد ملی خریدار حقیقی برای اسناد رسمی.

BuyerInfo.BuyerNationalID · string

شناسه ملی خریدار حقوقی برای اسناد رسمی.

BuyerInfo.BuyerRegistrationNumber · string

شماره ثبت خریدار حقوقی.

BuyerInfo.BuyerProvince · string

استان نشانی خریدار.

BuyerInfo.BuyerGrandCity · string

شهرستان یا محدوده شهری اصلی خریدار.

BuyerInfo.BuyerCity · string

شهر نشانی خریدار.

BuyerInfo.BuyerPostalCode · string

کد پستی خریدار برای درج در سند رسمی.

BuyerInfo.BuyerMobilePhone · string

شماره تلفن همراه خریدار.

BuyerInfo.BuyerFaxNumber · string

شماره فکس خریدار.

BuyerInfo.BuyerAddress · object

ساختار نشانی خریدار؛ اجزای نشانی و مقادیر تکمیلی در این آبجکت قرار می‌گیرند.

Show property

BuyerInfo.BuyerAddress.KeyValues[] · array

فهرست اجزای نشانی خریدار؛ هر عضو عنوان و مقدار یکی از بخش‌های نشانی را نگهداری می‌کند.

Show property

BuyerInfo.BuyerAddress.KeyValues[].Key · string

کلید داخلی جزء نشانی برای تشخیص نوع آن در ساختار آدرس.

BuyerInfo.BuyerAddress.KeyValues[].Title · string

عنوان جزء نشانی، مانند خیابان، پلاک یا واحد.

BuyerInfo.BuyerAddress.KeyValues[].Value · string

مقدار ثبت‌شده برای این جزء از نشانی خریدار.

BuyerInfo.BuyerAddress.FilledKeyValues[] · array

فهرست اجزای تکمیل‌شده نشانی خریدار.

BuyerInfo.BuyerPhone · string

شماره تلفن ثابت خریدار برای درج در سند.

BuyerInfo.BuyerEmail · string

نشانی ایمیل خریدار.

Creator · object

اطلاعات کاربری که رکورد را ایجاد کرده است.

CreatorId · string

شناسه Userی است که به‌عنوان ایجادکننده رکورد ثبت می‌شود.

Show وابستگی‌ها

این فیلد نام کاربر را نمی‌پذیرد؛ باید UserId یک User موجود در دیدار را بفرستید.

• User List — مقدار UserId کاربر موردنظر را بردارید

IssueDate · string

تاریخ صدور فاکتور یا پیش‌فاکتور.

Adjustment · string

مبلغ تخفیف نهایی که به جمع فاکتور اضافه یا از آن کم می‌شود.

DiscountRows[] · array

فهرست ردیف‌های تخفیف که هرکدام بخشی از تخفیف کل را مشخص می‌کنند.

Show property

DiscountRows[].DiscountName · string

عنوان این ردیف تخفیف که دلیل یا نوع تخفیف را در سند مالی نمایش می‌دهد.

DiscountRows[].RowPrice · string

مبلغ تخفیف یا تعدیل مربوط به این ردیف محاسباتی.

BizDomainId · string

شناسه بیزدامنه‌ای که داده یا تنظیمات به آن تعلق دارد.

CurrencyId · number

شناسه ارزی که مبالغ درخواست بر اساس آن ثبت یا محاسبه می‌شوند.

DealId · string

شناسه معامله‌ای است که فاکتور، پیش‌فاکتور یا فیلتر باید به آن مرتبط باشد.

Show وابستگی‌ها

مقدار این فیلد باید Id یک معامله موجود در دیدار باشد.

• Create Deal — اگر معامله هنوز ساخته نشده است
• Get Deal By Id — اگر Id معامله را دارید
• Search Deal — برای جست‌وجوی معامله

Description · string

توضیحات تکمیلی رکورد برای ثبت اطلاعاتی که در سایر فیلدها جای نمی‌گیرند.

Request Body (JSON)

{
    "Items": [
        {
            "Id": "9646c644-5d35-4678-bcb7-98ca370c952d",
            "Price": 120000,
            "Unit": "عدد",
            "UnitPrice": 120000,
            "TaxPrice": 12000,
            "Title": "product1 - product1-1",
            "TitleForInvoice": "product1",
            "Description": "",
            "Discount": 0,
            "DiscountPercent": 0,
            "DiscountType": "Amount",
            "EditorId": "00000000-0000-0000-0000-000000000000",
            "CreatedDate": "2026-07-28T14:20:04Z",
            "CreatorId": "58f610e7-061a-4efc-9a87-af7b31bde808",
            "ModifiedDate": "0001-01-01T00:00:00Z",
            "DealId": "b00449d3-5d9d-4154-a1fd-ea478e6b9b1c",
            "PriceAfterDiscount": 120000,
            "ProductCode": "100",
            "ProductId": "d62ae600-e151-404a-9030-84485e665017",
            "Quantity": 1,
            "SaleTypeId": "00000000-0000-0000-0000-000000000000",
            "TaxPercent": 10,
            "VariantCode": "1",
            "VariantId": "57b4205e-1d64-4f67-9610-a9251d993de8",
            "VariantTitle": "product1-1",
            "itemStockSummary": [],
            "ExistInSepidyar": false
        },
        {
            "Id": "1162288f-10c0-4c3f-b25a-129616582d99",
            "Price": 500000,
            "Unit": "عدد",
            "UnitPrice": 500000,
            "TaxPrice": 50000,
            "Title": "product2",
            "TitleForInvoice": "product2",
            "Description": "",
            "Discount": 0,
            "DiscountPercent": 0,
            "DiscountType": "Amount",
            "EditorId": "00000000-0000-0000-0000-000000000000",
            "CreatedDate": "2026-07-28T14:20:04Z",
            "CreatorId": "58f610e7-061a-4efc-9a87-af7b31bde808",
            "ModifiedDate": "0001-01-01T00:00:00Z",
            "DealId": "b00449d3-5d9d-4154-a1fd-ea478e6b9b1c",
            "PriceAfterDiscount": 500000,
            "ProductCode": "101",
            "ProductId": "6a76de58-b3ab-456a-8e0b-635a620f1599",
            "Quantity": 1,
            "SaleTypeId": "00000000-0000-0000-0000-000000000000",
            "TaxPercent": 10,
            "VariantCode": null,
            "VariantId": null,
            "VariantTitle": null,
            "itemStockSummary": [],
            "ExistInSepidyar": false
        }
    ],
    "BizdomainProvider": {},
    "SellerInfo": {
        "SellerName": "زیما",
        "BizDomainId": "b8233b92-7a57-42a3-8f3e-59fdbbb6c833",
        "QuoteExpirationDays": 3,
        "SellerEconomicCode": "",
        "SellerNationalCode": "",
        "SellerPostalCode": "",
        "SellerProvince": "",
        "SellerGrandCity": "",
        "SellerCity": "",
        "SellerAddress": "",
        "SellerPhone": "",
        "InvoiceConditions": "",
        "QuoteConditions": ""
    },
    "BuyerInfo": {
        "BuyerType": "Person",
        "BuyerTitle": "",
        "BuyerName": "nafari",
        "BuyerEconomicCode": "",
        "BuyerNationalCode": "16546545",
        "BuyerNationalID": "",
        "BuyerRegistrationNumber": "",
        "BuyerProvince": "",
        "BuyerGrandCity": "",
        "BuyerCity": "",
        "BuyerPostalCode": "68965",
        "BuyerMobilePhone": "09122526427",
        "BuyerFaxNumber": "",
        "BuyerAddress": {
            "KeyValues": [
                {
                    "Key": "سایر",
                    "Title": "سایر",
                    "Value": ""
                }
            ],
            "FilledKeyValues": []
        },
        "BuyerPhone": "",
        "BuyerEmail": ""
    },
    "Creator": {},
    "IssueDate": "2026-07-28T14:23:49.846Z",
    "Adjustment": "-100000",
    "DiscountRows": [],
    "BizDomainId": "b8233b92-7a57-42a3-8f3e-59fdbbb6c833",
    "CurrencyId": 258325,
    "DealId": "b00449d3-5d9d-4154-a1fd-ea478e6b9b1c",
    "InvoiceFormattedNumber": "I-3",
    "InvoiceNumber": 3,
    "Description": ""
}

Request Response (JSON)

{
  "Response": {
    "Id": 2329527,
    "BizDomainId": "b8233b92-7a57-42a3-8f3e-59fdbbb6c833",
    "BizdomainProviderId": 144125,
    "DealId": "b00449d3-5d9d-4154-a1fd-ea478e6b9b1c",
    "Deal": null,
    "FinalPrice": 682000.0,
    "CreatedOn": "0001-01-01T00:00:00Z",
    "CreatorId": "00000000-0000-0000-0000-000000000000",
    "Creator": {
      "LoggedInStatus": "LoggedIn",
      "ConfirmationCode": "00000000-0000-0000-0000-000000000000",
      "Password": "",
      "GenderTitle": "مرد",
      "RegisterDate": "0001-01-01T00:00:00Z",
      "ThumbnailUrl": "/PortalData/Subsystems/Profile/UserPics/Thumbnail/UP_00000000-0000-0000-0000-000000000000.jpg",
      "Title": "آقاي",
      "UserName": null,
      "CustomProperties": {},
      "HasPicture": false,
      "PictureUrl": "/PortalData/Subsystems/Profile/UserPics/nopicture.png",
      "FirstName": "",
      "LastName": "",
      "DisplayName": " ",
      "SSN": "",
      "Gender": 0,
      "JobId": "00000000-0000-0000-0000-000000000000",
      "BirthDate": "2026-07-28T14:24:10.2431139Z",
      "CountryId": "00000000-0000-0000-0000-000000000000",
      "ProvinceId": "00000000-0000-0000-0000-000000000000",
      "CityId": "00000000-0000-0000-0000-000000000000",
      "PostalCode": "",
      "Address": "",
      "PictureFileName": "nopicture.png",
      "HomePhone": "",
      "OfficePhone": "",
      "MobilePhone": "",
      "EmergencyPhone": "",
      "Email": "",
      "Website": "",
      "CommonUserId": "00000000-0000-0000-0000-000000000000",
      "EmailConfirm": false,
      "Active": "Active",
      "VerifiedSentEmailDate": "2026-07-28T14:24:10.2431139Z",
      "VerifiedSentEmailCount": 1,
      "Code": 0
    },
    "IssueDate": "2026-07-28T14:23:49.846Z",
    "IsCanceled": false,
    "InvoiceNumber": "3.0",
    "QuoteNumber": "",
    "QuoteFormattedNumber": null,
    "InvoiceFormattedNumber": "I-3",
    "InvoiceType": "Invoice",
    "FiscalYear": 0,
    "Items": [
      {
        "ThirdPartyInvoiceItemId": "7360031",
        "ProductId": "d62ae600-e151-404a-9030-84485e665017",
        "SaleTypeId": "00000000-0000-0000-0000-000000000000",
        "ProductCode": "100",
        "VariantId": "57b4205e-1d64-4f67-9610-a9251d993de8",
        "Title": "product1 - product1-1",
        "Description": "",
        "Unit": "عدد",
        "UnitPrice": 120000.0,
        "Quantity": 1.0,
        "Discount": 0.0,
        "VariantCode": "1",
        "VariantTitle": "product1-1",
        "TaxPercent": 10,
        "Index": 0,
        "DiscountPercent": 0.0,
        "DiscountType": "Amount",
        "Price": 120000.0,
        "PriceAfterDiscount": 120000.0,
        "DiscountPrice": 0.0,
        "TaxPrice": 12000.0,
        "FinalPrice": 132000.0,
        "ProductName": null
      },
      {
        "ThirdPartyInvoiceItemId": "7360032",
        "ProductId": "6a76de58-b3ab-456a-8e0b-635a620f1599",
        "SaleTypeId": "00000000-0000-0000-0000-000000000000",
        "ProductCode": "101",
        "VariantId": null,
        "Title": "product2",
        "Description": "",
        "Unit": "عدد",
        "UnitPrice": 500000.0,
        "Quantity": 1.0,
        "Discount": 0.0,
        "VariantCode": null,
        "VariantTitle": null,
        "TaxPercent": 10,
        "Index": 0,
        "DiscountPercent": 0.0,
        "DiscountType": "Amount",
        "Price": 500000.0,
        "PriceAfterDiscount": 500000.0,
        "DiscountPrice": 0.0,
        "TaxPrice": 50000.0,
        "FinalPrice": 550000.0,
        "ProductName": null
      }
    ],
    "Price": 620000.0,
    "Discount": 0.0,
    "Tax": 62000.0,
    "Description": "",
    "Logo": null,
    "CanEdit": false,
    "Adjustment": -100000.0,
    "DiscountRows": [],
    "QuoteExpirationDays": 0,
    "CurrencyId": 258325,
    "CurrencyCode": null,
    "BuyerInfo": {
      "BuyerType": "Person",
      "BuyerTitle": "",
      "BuyerName": "nafari",
      "BuyerEconomicCode": "",
      "BuyerNationalCode": "16546545",
      "BuyerNationalID": "",
      "BuyerRegistrationNumber": "",
      "BuyerProvince": "",
      "BuyerGrandCity": "",
      "BuyerCity": "",
      "BuyerPostalCode": "68965",
      "BuyerMobilePhone": "09122526427",
      "BuyerFaxNumber": "",
      "BuyerAddress": {
        "KeyValues": [
          {
            "Key": "سایر",
            "Title": "سایر",
            "Value": ""
          }
        ],
        "FilledKeyValues": []
      },
      "BuyerPhone": "",
      "BuyerEmail": ""
    },
    "SellerInfo": {
      "SellerName": "زیما",
      "BizDomainId": "b8233b92-7a57-42a3-8f3e-59fdbbb6c833",
      "QuoteExpirationDays": 3,
      "SellerEconomicCode": "",
      "SellerNationalCode": "",
      "SellerPostalCode": "",
      "SellerProvince": "",
      "SellerGrandCity": "",
      "SellerCity": "",
      "SellerAddress": "",
      "SellerPhone": "",
      "InvoiceConditions": "",
      "QuoteConditions": ""
    },
    "CurrencyIsSystemDefault": false,
    "InvoiceSignImageUrl": null,
    "AppExternalViewUrl": "http://app.didar.me/customer/invoice/323332393532372C62303034343964332D356439642D343135342D613166642D656134373865366239623163",
    "TotalPrice": 620000.0,
    "TotalDiscount": 0.0,
    "TotalPriceAfterDiscount": 620000.0,
    "TotalTaxPrice": 62000.0,
    "TotalFinalPrice": 682000.0,
    "FinalAdjustmentPrice": 582000.0,
    "ShowOnlinePayment": false
  },
  "Timer": ":0 :68",
  "SessionId": "06bb2ad4-2cdc-4afa-b3d9-4551a0a7f04e",
  "UserId": "58f610e7-061a-4efc-9a87-af7b31bde808",
  "BizDomainId": "b8233b92-7a57-42a3-8f3e-59fdbbb6c833",
  "LimitPackage": null
}

لینک های مرتبط:

• Search Deal
• Get Deal By Id
• Create Person
• Get Person By Id
• Get Person By Mobile
• Search Person
• Create Company
• Get Company By Id
• Search Company
• Search Products
• Get Product By Codes