ویرایش فاکتور

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

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

پارامترهای Query

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

Content-Type: application/json

بدنه درخواست

number

required

شناسه فاکتوری است که می‌خواهید ویرایش کنید. این مقدار باید Id همان فاکتور موجود در دیدار باشد.

array

required

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

Show وابستگی‌ها

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

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

Show property

string

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

Show شرایط ارسال

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

string

عنوان زیرمحصول انتخاب‌شده برای این ردیف است؛ مثلا اگر محصول «تی‌شرت» باشد، این مقدار می‌تواند عنوان Variantی مثل «سبز - سایز L» باشد.

Show شرایط ارسال

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

string

required

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

string

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

string

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

string

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

string

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

Show شرایط ارسال

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

string

required

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

string

required

واحد شمارش یا فروش محصول در این ردیف است؛ مثلا عدد، کیلوگرم یا ساعت.

number | string

required

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

array

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

Show property

number

شناسه رکورد قیمت Variant در دیدار است.

number

شناسه ارزی است که این قیمت Variant براساس آن ثبت شده است.

number | string

قیمت Variant در ارزی است که CurrencyId همین عضو مشخص می‌کند.

string

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

boolean

مشخص می‌کند رکورد قیمت حذف‌شده در نظر گرفته می‌شود یا خیر؛ true یعنی حذف‌شده و false یعنی رکورد قیمت فعال است.

string

required

شناسه محصول اصلی این ردیف است. این مقدار باید Id محصول موجود در دیدار باشد، حتی اگر برای همان محصول یک VariantId هم ارسال می‌کنید.

Show وابستگی‌ها

مقدار این فیلد را از Id محصول بردارید.

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

string

required

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

number | string

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

number | string

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

number | string

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

number

required

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

string

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

Show مقادیر مجاز

Amount — تخفیف به‌صورت مبلغ ثابت در نظر گرفته می‌شود
Percent — تخفیف به‌صورت درصدی در نظر گرفته می‌شود

string

شناسه نوع فروش این ردیف است. در نمونه درخواست مقدار 00000000-0000-0000-0000-000000000000 ارسال شده و این فیلد جزو حداقل درخواست نیست.

object

این آبجکت در نمونه درخواست به‌صورت خالی ({}) ارسال شده است. جزو حداقل درخواست نیست.

object

اطلاعات فروشنده‌ای است که فاکتور به نام او صادر می‌شود. منظور از فروشنده در اینجا همان کسب‌وکار یا شرکتی است که از دیدار استفاده می‌کند، نه یک شرکتِ مشتری که به‌عنوان Contact داخل CRM ثبت شده است.

Show property

string

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

string

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

number

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

string

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

string

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

string

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

string

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

string

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

string

شهر آدرس فروشنده.

string

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

string

شماره تلفن فروشنده.

string

متن شرایط یا توضیحاتی است که فروشنده برای فاکتور در نظر گرفته است.

string

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

object

اطلاعات خریدار فاکتور است. خریدار می‌تواند یک Person یا یک Company باشد و اطلاعات این آبجکت را می‌توانید براساس اطلاعات همان شخص یا شرکت در دیدار پر کنید.

Show وابستگی‌ها

اگر خریدار شخص است، اطلاعات او را از رکورد Person و اگر شرکت است از رکورد Company بردارید.

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

Show property

string

نوع خریدار را مشخص می‌کند.

Show مقادیر مجاز

Person — خریدار یک شخص است
Company — خریدار یک شرکت است

string

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

string

نام خریدار برای نمایش روی فاکتور است. برای Person نام شخص و برای Company نام شرکت در این فیلد قرار می‌گیرد.

string

کد اقتصادی شرکت خریدار است.

Show شرایط ارسال

فقط زمانی ارسال کنید که BuyerInfo.BuyerType برابر Company است.

string

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

Show شرایط ارسال

فقط زمانی ارسال کنید که BuyerInfo.BuyerType برابر Company است.

string

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

string

شماره ثبت شرکت خریدار است.

Show شرایط ارسال

فقط زمانی ارسال کنید که BuyerInfo.BuyerType برابر Company است.

string

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

string

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

string

شهر آدرس خریدار.

string

کد پستی خریدار.

string

شماره موبایل خریدار.

string

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

object

ساختار آدرس خریدار است.

Show property

array

فهرست اجزای آدرس یا آدرس‌های عنوان‌دار خریدار است.

Show property

string

کلید یا نوع داخلی آدرس است.

string

عنوان قابل نمایش این آدرس؛ مثلا سایر یا منزل.

string

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

array

فهرست مقادیر تکمیل‌شده ساختار آدرس است. در نمونه ارائه‌شده این آرایه خالی است و ساختار اعضای آن مشخص نشده است.

string

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

string

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

object

اطلاعات تکمیلی ایجادکننده فاکتور است. در نمونه درخواست به‌صورت آبجکت خالی ({}) ارسال شده و جزو حداقل درخواست نیست.

string

required

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

Show وابستگی‌ها

مقدار این فیلد باید UserId یک User موجود در دیدار باشد.

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

string

تاریخ و زمان صدور فاکتور است.

number | string

مبلغ تعدیل نهایی فاکتور است که همراه جمع محاسبات فاکتور ارسال می‌شود.

array

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

string

required

شناسه بیزدامنه است.

number

required

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

string

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

Show وابستگی‌ها

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

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

string

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

قواعد و محدودیت‌ها

حداقل بدنه لازم برای ویرایش فاکتور شامل Id، Items، CreatorId، BizDomainId و CurrencyId است.
Id باید شناسه همان فاکتوری باشد که قصد ویرایش آن را دارید.
داخل هر عضو Items، فیلدهای Title، Description، Unit، UnitPrice، ProductId، ProductCode و Quantity الزامی هستند.
اگر محصول متغیر باشد، VariantId همان Variant انتخاب‌شده را هم ارسال کنید. برای محصول بدون Variant نیازی به VariantId نیست.
مقدار Items[].UnitPrice همان قیمت واحدی است که برای آن ردیف محصول روی فاکتور نمایش داده می‌شود.
BuyerInfo.BuyerType فقط یکی از دو مقدار Person یا Company را می‌پذیرد.
BuyerEconomicCode، BuyerNationalCode و BuyerRegistrationNumber فقط برای خریدار از نوع Company ارسال می‌شوند.

حداقل درخواست

{
  "Id": 2377484,
  "Items": [
    {
      "Title": "test product wp",
      "Description": "تست 1",
      "Unit": "عدد",
      "UnitPrice": "5300",
      "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
      "ProductCode": "didar120",
      "Quantity": 2
    }
  ],
  "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
  "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
  "CurrencyId": 259726
}

اگر محصول متغیر است، VariantId را هم داخل همان عضو Items اضافه کنید.

{
  "Id": 2377484,
  "Items": [
    {
      "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
      "VariantTitle": "test product wp - سبز",
      "Title": "test product wp",
      "TitleForInvoice": "test product wp - سبز",
      "newTitle": "",
      "Code": "didar120",
      "VariantCode": "didar123",
      "Description": "تست 1",
      "Unit": "number",
      "UnitPrice": "5300",
      "VariantPrices": [
        {
          "Id": 2931366,
          "CurrencyId": 259726,
          "Price": "5000",
          "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
          "IsDeleted": false
        }
      ],
      "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
      "ProductCode": "didar120",
      "Discount": 8000,
      "TaxPercent": "7",
      "DiscountPercent": "15",
      "Quantity": 2,
      "DiscountType": "Percent",
      "SaleTypeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "BizdomainProvider": {},
  "SellerInfo": {
    "SellerName": "نرم نگاران آرمیتیس",
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "QuoteExpirationDays": 5,
    "SellerEconomicCode": "",
    "SellerNationalCode": "",
    "SellerPostalCode": "",
    "SellerProvince": "تهران",
    "SellerGrandCity": "تهران",
    "SellerCity": "تهران",
    "SellerAddress": "آدرس تست فروشنده",
    "SellerPhone": "22353500",
    "InvoiceConditions": "شرایط پیش فرض فاکتور",
    "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
  },
  "BuyerInfo": {
    "BuyerType": "Company",
    "BuyerTitle": "",
    "BuyerName": "test company2",
    "BuyerEconomicCode": "",
    "BuyerNationalCode": "",
    "BuyerNationalID": "",
    "BuyerRegistrationNumber": "",
    "BuyerProvince": "",
    "BuyerGrandCity": "",
    "BuyerCity": "",
    "BuyerPostalCode": "5453534534",
    "BuyerMobilePhone": "0910111111",
    "BuyerFaxNumber": "",
    "BuyerAddress": {
      "KeyValues": [
        {
          "Key": "home",
          "Title": "منزل",
          "Value": "آدرس تست"
        }
      ],
      "FilledKeyValues": []
    },
    "BuyerPhone": "09101111111",
    "BuyerEmail": "test@gmail.com"
  },
  "Creator": {},
  "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
  "IssueDate": "2025-11-05T11:09:10.332Z",
  "Adjustment": "-7700",
  "DiscountRows": [],
  "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
  "CurrencyId": 259726,
  "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
  "Description": "توضیحات شرایط پیش فرض فاکتور"
}

curl --location '{{baseURL}}/api/AccountingInvoice/Update?apikey={{API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Id": 2377484,
  "Items": [
    {
      "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
      "VariantTitle": "test product wp - سبز",
      "Title": "test product wp",
      "TitleForInvoice": "test product wp - سبز",
      "newTitle": "",
      "Code": "didar120",
      "VariantCode": "didar123",
      "Description": "تست 1",
      "Unit": "number",
      "UnitPrice": "5300",
      "VariantPrices": [
        {
          "Id": 2931366,
          "CurrencyId": 259726,
          "Price": "5000",
          "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
          "IsDeleted": false
        }
      ],
      "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
      "ProductCode": "didar120",
      "Discount": 8000,
      "TaxPercent": "7",
      "DiscountPercent": "15",
      "Quantity": 2,
      "DiscountType": "Percent",
      "SaleTypeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "BizdomainProvider": {},
  "SellerInfo": {
    "SellerName": "نرم نگاران آرمیتیس",
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "QuoteExpirationDays": 5,
    "SellerEconomicCode": "",
    "SellerNationalCode": "",
    "SellerPostalCode": "",
    "SellerProvince": "تهران",
    "SellerGrandCity": "تهران",
    "SellerCity": "تهران",
    "SellerAddress": "آدرس تست فروشنده",
    "SellerPhone": "22353500",
    "InvoiceConditions": "شرایط پیش فرض فاکتور",
    "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
  },
  "BuyerInfo": {
    "BuyerType": "Company",
    "BuyerTitle": "",
    "BuyerName": "test company2",
    "BuyerEconomicCode": "",
    "BuyerNationalCode": "",
    "BuyerNationalID": "",
    "BuyerRegistrationNumber": "",
    "BuyerProvince": "",
    "BuyerGrandCity": "",
    "BuyerCity": "",
    "BuyerPostalCode": "5453534534",
    "BuyerMobilePhone": "0910111111",
    "BuyerFaxNumber": "",
    "BuyerAddress": {
      "KeyValues": [
        {
          "Key": "home",
          "Title": "منزل",
          "Value": "آدرس تست"
        }
      ],
      "FilledKeyValues": []
    },
    "BuyerPhone": "09101111111",
    "BuyerEmail": "test@gmail.com"
  },
  "Creator": {},
  "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
  "IssueDate": "2025-11-05T11:09:10.332Z",
  "Adjustment": "-7700",
  "DiscountRows": [],
  "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
  "CurrencyId": 259726,
  "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
  "Description": "توضیحات شرایط پیش فرض فاکتور"
}'

{
  "Response": {
    "Id": 2377484,
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "BizdomainProviderId": 145179,
    "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
    "Deal": {
      "Id": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
      "VisibilityType": 1,
      "OwnerId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
      "IsPaid": false,
      "IsDeleted": false,
      "CurrencyId": 259726,
      "Title": "معامله احسان نفری",
      "IsMine": false,
      "IsVisible": true,
      "CanViewPrice": true,
      "PersonId": "42e2bcd6-8e74-45c8-939f-c24e8098ccb4",
      "CompanyId": "00000000-0000-0000-0000-000000000000"
    },
    "FinalPrice": 2782.0,
    "CreatedOn": "2026-08-16T15:13:37.49Z",
    "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
    "Creator": null,
    "IssueDate": "2025-11-05T11:09:10.332Z",
    "IsCanceled": false,
    "InvoiceNumber": "30.0",
    "QuoteNumber": "",
    "QuoteFormattedNumber": null,
    "InvoiceFormattedNumber": "I-30",
    "InvoiceType": "Invoice",
    "FiscalYear": 0,
    "Items": [
      {
        "ThirdPartyInvoiceItemId": "7503166",
        "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
        "SaleTypeId": "00000000-0000-0000-0000-000000000000",
        "ProductCode": "didar120",
        "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
        "Title": "test product wp",
        "Description": "تست 1",
        "Unit": "number",
        "UnitPrice": 5300.0,
        "Quantity": 2.0,
        "Discount": 8000.0,
        "VariantCode": "didar123",
        "VariantTitle": "test product wp - سبز",
        "TaxPercent": 7,
        "Index": 0,
        "DiscountPercent": 15.0,
        "DiscountType": "Percent",
        "Price": 10600.0,
        "PriceAfterDiscount": 2600.0,
        "DiscountPrice": 0.0,
        "TaxPrice": 182.0,
        "FinalPrice": 2782.0,
        "ProductName": null
      }
    ],
    "Price": 10600.0,
    "Discount": 8000.0,
    "Tax": 182.0,
    "Description": "توضیحات شرایط پیش فرض فاکتور",
    "Logo": null,
    "CanEdit": true,
    "Adjustment": -7700.0,
    "DiscountRows": [],
    "QuoteExpirationDays": 0,
    "CurrencyId": 259726,
    "CurrencyCode": null,
    "BuyerInfo": {
      "BuyerType": "Company",
      "BuyerTitle": "",
      "BuyerName": "test company2",
      "BuyerEconomicCode": "",
      "BuyerNationalCode": "",
      "BuyerNationalID": "",
      "BuyerRegistrationNumber": "",
      "BuyerProvince": "",
      "BuyerGrandCity": "",
      "BuyerCity": "",
      "BuyerPostalCode": "5453534534",
      "BuyerMobilePhone": "0910111111",
      "BuyerFaxNumber": "",
      "BuyerAddress": {
        "KeyValues": [
          {
            "Key": "home",
            "Title": "منزل",
            "Value": "آدرس تست"
          }
        ],
        "FilledKeyValues": []
      },
      "BuyerPhone": "09101111111",
      "BuyerEmail": "test@gmail.com"
    },
    "SellerInfo": {
      "SellerName": "نرم نگاران آرمیتیس",
      "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
      "QuoteExpirationDays": 5,
      "SellerEconomicCode": "",
      "SellerNationalCode": "",
      "SellerPostalCode": "",
      "SellerProvince": "تهران",
      "SellerGrandCity": "تهران",
      "SellerCity": "تهران",
      "SellerAddress": "آدرس تست فروشنده",
      "SellerPhone": "22353500",
      "InvoiceConditions": "شرایط پیش فرض فاکتور",
      "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
    },
    "CurrencyIsSystemDefault": false,
    "InvoiceSignImageUrl": null,
    "AppExternalViewUrl": "http://app.didar.me/customer/invoice/323337373438342C36623637343061632D373636352D346334342D623765332D663431376565316537323435",
    "TotalPrice": 10600.0,
    "TotalDiscount": 8000.0,
    "TotalPriceAfterDiscount": 2600.0,
    "TotalTaxPrice": 182.0,
    "TotalFinalPrice": 2782.0,
    "FinalAdjustmentPrice": -4918.0,
    "ShowOnlinePayment": false
  }
}

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

{
  "Id": 2377484,
  "Items": [
    {
      "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
      "VariantTitle": "test product wp - سبز",
      "Title": "test product wp",
      "TitleForInvoice": "test product wp - سبز",
      "newTitle": "",
      "Code": "didar120",
      "VariantCode": "didar123",
      "Description": "تست 1",
      "Unit": "number",
      "UnitPrice": "5300",
      "VariantPrices": [
        {
          "Id": 2931366,
          "CurrencyId": 259726,
          "Price": "5000",
          "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
          "IsDeleted": false
        }
      ],
      "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
      "ProductCode": "didar120",
      "Discount": 8000,
      "TaxPercent": "7",
      "DiscountPercent": "15",
      "Quantity": 2,
      "DiscountType": "Percent",
      "SaleTypeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "BizdomainProvider": {},
  "SellerInfo": {
    "SellerName": "نرم نگاران آرمیتیس",
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "QuoteExpirationDays": 5,
    "SellerEconomicCode": "",
    "SellerNationalCode": "",
    "SellerPostalCode": "",
    "SellerProvince": "تهران",
    "SellerGrandCity": "تهران",
    "SellerCity": "تهران",
    "SellerAddress": "آدرس تست فروشنده",
    "SellerPhone": "22353500",
    "InvoiceConditions": "شرایط پیش فرض فاکتور",
    "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
  },
  "BuyerInfo": {
    "BuyerType": "Company",
    "BuyerTitle": "",
    "BuyerName": "test company2",
    "BuyerEconomicCode": "",
    "BuyerNationalCode": "",
    "BuyerNationalID": "",
    "BuyerRegistrationNumber": "",
    "BuyerProvince": "",
    "BuyerGrandCity": "",
    "BuyerCity": "",
    "BuyerPostalCode": "5453534534",
    "BuyerMobilePhone": "0910111111",
    "BuyerFaxNumber": "",
    "BuyerAddress": {
      "KeyValues": [
        {
          "Key": "home",
          "Title": "منزل",
          "Value": "آدرس تست"
        }
      ],
      "FilledKeyValues": []
    },
    "BuyerPhone": "09101111111",
    "BuyerEmail": "test@gmail.com"
  },
  "Creator": {},
  "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
  "IssueDate": "2025-11-05T11:09:10.332Z",
  "Adjustment": "-7700",
  "DiscountRows": [],
  "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
  "CurrencyId": 259726,
  "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
  "Description": "توضیحات شرایط پیش فرض فاکتور"
}

curl --location '{{baseURL}}/api/AccountingInvoice/Update?apikey={{API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "Id": 2377484,
  "Items": [
    {
      "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
      "VariantTitle": "test product wp - سبز",
      "Title": "test product wp",
      "TitleForInvoice": "test product wp - سبز",
      "newTitle": "",
      "Code": "didar120",
      "VariantCode": "didar123",
      "Description": "تست 1",
      "Unit": "number",
      "UnitPrice": "5300",
      "VariantPrices": [
        {
          "Id": 2931366,
          "CurrencyId": 259726,
          "Price": "5000",
          "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
          "IsDeleted": false
        }
      ],
      "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
      "ProductCode": "didar120",
      "Discount": 8000,
      "TaxPercent": "7",
      "DiscountPercent": "15",
      "Quantity": 2,
      "DiscountType": "Percent",
      "SaleTypeId": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "BizdomainProvider": {},
  "SellerInfo": {
    "SellerName": "نرم نگاران آرمیتیس",
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "QuoteExpirationDays": 5,
    "SellerEconomicCode": "",
    "SellerNationalCode": "",
    "SellerPostalCode": "",
    "SellerProvince": "تهران",
    "SellerGrandCity": "تهران",
    "SellerCity": "تهران",
    "SellerAddress": "آدرس تست فروشنده",
    "SellerPhone": "22353500",
    "InvoiceConditions": "شرایط پیش فرض فاکتور",
    "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
  },
  "BuyerInfo": {
    "BuyerType": "Company",
    "BuyerTitle": "",
    "BuyerName": "test company2",
    "BuyerEconomicCode": "",
    "BuyerNationalCode": "",
    "BuyerNationalID": "",
    "BuyerRegistrationNumber": "",
    "BuyerProvince": "",
    "BuyerGrandCity": "",
    "BuyerCity": "",
    "BuyerPostalCode": "5453534534",
    "BuyerMobilePhone": "0910111111",
    "BuyerFaxNumber": "",
    "BuyerAddress": {
      "KeyValues": [
        {
          "Key": "home",
          "Title": "منزل",
          "Value": "آدرس تست"
        }
      ],
      "FilledKeyValues": []
    },
    "BuyerPhone": "09101111111",
    "BuyerEmail": "test@gmail.com"
  },
  "Creator": {},
  "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
  "IssueDate": "2025-11-05T11:09:10.332Z",
  "Adjustment": "-7700",
  "DiscountRows": [],
  "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
  "CurrencyId": 259726,
  "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
  "Description": "توضیحات شرایط پیش فرض فاکتور"
}'

{
  "Response": {
    "Id": 2377484,
    "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
    "BizdomainProviderId": 145179,
    "DealId": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
    "Deal": {
      "Id": "6b6740ac-7665-4c44-b7e3-f417ee1e7245",
      "VisibilityType": 1,
      "OwnerId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
      "IsPaid": false,
      "IsDeleted": false,
      "CurrencyId": 259726,
      "Title": "معامله احسان نفری",
      "IsMine": false,
      "IsVisible": true,
      "CanViewPrice": true,
      "PersonId": "42e2bcd6-8e74-45c8-939f-c24e8098ccb4",
      "CompanyId": "00000000-0000-0000-0000-000000000000"
    },
    "FinalPrice": 2782.0,
    "CreatedOn": "2026-08-16T15:13:37.49Z",
    "CreatorId": "8bb84640-c11c-4349-97ab-d8f563c2f871",
    "Creator": null,
    "IssueDate": "2025-11-05T11:09:10.332Z",
    "IsCanceled": false,
    "InvoiceNumber": "30.0",
    "QuoteNumber": "",
    "QuoteFormattedNumber": null,
    "InvoiceFormattedNumber": "I-30",
    "InvoiceType": "Invoice",
    "FiscalYear": 0,
    "Items": [
      {
        "ThirdPartyInvoiceItemId": "7503166",
        "ProductId": "569984af-a8e4-4060-88c1-9481464c5e8f",
        "SaleTypeId": "00000000-0000-0000-0000-000000000000",
        "ProductCode": "didar120",
        "VariantId": "0a1721a1-ac91-49d3-bdcc-92d3ba9f2303",
        "Title": "test product wp",
        "Description": "تست 1",
        "Unit": "number",
        "UnitPrice": 5300.0,
        "Quantity": 2.0,
        "Discount": 8000.0,
        "VariantCode": "didar123",
        "VariantTitle": "test product wp - سبز",
        "TaxPercent": 7,
        "Index": 0,
        "DiscountPercent": 15.0,
        "DiscountType": "Percent",
        "Price": 10600.0,
        "PriceAfterDiscount": 2600.0,
        "DiscountPrice": 0.0,
        "TaxPrice": 182.0,
        "FinalPrice": 2782.0,
        "ProductName": null
      }
    ],
    "Price": 10600.0,
    "Discount": 8000.0,
    "Tax": 182.0,
    "Description": "توضیحات شرایط پیش فرض فاکتور",
    "Logo": null,
    "CanEdit": true,
    "Adjustment": -7700.0,
    "DiscountRows": [],
    "QuoteExpirationDays": 0,
    "CurrencyId": 259726,
    "CurrencyCode": null,
    "BuyerInfo": {
      "BuyerType": "Company",
      "BuyerTitle": "",
      "BuyerName": "test company2",
      "BuyerEconomicCode": "",
      "BuyerNationalCode": "",
      "BuyerNationalID": "",
      "BuyerRegistrationNumber": "",
      "BuyerProvince": "",
      "BuyerGrandCity": "",
      "BuyerCity": "",
      "BuyerPostalCode": "5453534534",
      "BuyerMobilePhone": "0910111111",
      "BuyerFaxNumber": "",
      "BuyerAddress": {
        "KeyValues": [
          {
            "Key": "home",
            "Title": "منزل",
            "Value": "آدرس تست"
          }
        ],
        "FilledKeyValues": []
      },
      "BuyerPhone": "09101111111",
      "BuyerEmail": "test@gmail.com"
    },
    "SellerInfo": {
      "SellerName": "نرم نگاران آرمیتیس",
      "BizDomainId": "67c7954d-1db7-41f5-8ed2-3bd055566636",
      "QuoteExpirationDays": 5,
      "SellerEconomicCode": "",
      "SellerNationalCode": "",
      "SellerPostalCode": "",
      "SellerProvince": "تهران",
      "SellerGrandCity": "تهران",
      "SellerCity": "تهران",
      "SellerAddress": "آدرس تست فروشنده",
      "SellerPhone": "22353500",
      "InvoiceConditions": "شرایط پیش فرض فاکتور",
      "QuoteConditions": "این پیش فاکتور صرفا جهت اعلام قیمت به شرکت متقاضی داده شده و هیچ ارزش دیگری ندارد5"
    },
    "CurrencyIsSystemDefault": false,
    "InvoiceSignImageUrl": null,
    "AppExternalViewUrl": "http://app.didar.me/customer/invoice/323337373438342C36623637343061632D373636352D346334342D623765332D663431376565316537323435",
    "TotalPrice": 10600.0,
    "TotalDiscount": 8000.0,
    "TotalPriceAfterDiscount": 2600.0,
    "TotalTaxPrice": 182.0,
    "TotalFinalPrice": 2782.0,
    "FinalAdjustmentPrice": -4918.0,
    "ShowOnlinePayment": false
  }
}

Update Invoice

ویرایش فاکتور

پارامترهای Query

Header درخواست

بدنه درخواست

قواعد و محدودیت‌ها

حداقل درخواست

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

​ویرایش فاکتور

​پارامترهای Query

​Header درخواست

​بدنه درخواست

​قواعد و محدودیت‌ها

​حداقل درخواست

​لینک‌های مرتبط

ویرایش فاکتور

پارامترهای Query

Header درخواست

بدنه درخواست

قواعد و محدودیت‌ها

حداقل درخواست

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