ثبت پیش فاکتور – راهنمای سپیدار سیستم

/api/Quotations/

GET

Parameter	Description
GenerationVersion	نسخه API
Authorization	توکن از نوع JWT برای اعتبارسنجی کاربر
IntegrationID	کد دستگاه
ArbitraryCode	یک GUID یکتا
EncArbitraryCode	نسخه کد شده ArbitraryCode به کمک کلید عمومی

Request

Parameter	Type	Required	Description
GUID	string	*	شناسه یکتا برای جلوگیری از ثبت تکراری
CurrencyRef	int	*	شناسه ارز
Rate	double	*	نرخ تبدیل ارزی
Date	?datetime	–	تاریخ (اختیاری. در صورت عدم ارسال، تاریخ روز سرور در نظر گرفته خواهد شد.)
ExpirationDate	datetime	*	تاریخ اعتبار
CustomerRef	int	*	شناسه مشتری
AddressRef	?int	–	شناسه آدرس (اختیاری)
SaleTypeRef	int	*	شناسه نوع فروش
DiscountOnCustomer	double	*	تخفیف مشتری
Price	double	*	مبلغ ناخالص
Discount	double	*	تخفیف
Tax	double	*	مالیات
Duty	double	*	عوارض
Addition	double	*	اضافات
Items	[]QuotationItem_New	*	آرایه‌ای از اقلام پیش فاکتور

JSON

{
  "GUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "CurrencyRef": 1,
  "Rate": 0,
  "Date": "2024-04-24",
  "ExpirationDate": "2024-04-24",
  "CustomerRef": 1,
  "AddressRef": 1,
  "SaleTypeRef": 1,
  "DiscountOnCustomer": 0,
  "Price": 0,
  "Discount": 0,
  "Tax": 0,
  "Duty": 0,
  "Addition": 0,
  "Description": "string",
  "Items": [
    {
      "RowID": 1,
      "ItemRef": 1,
      "TracingRef": 1,
      "StockRef": 1,
      "Quantity": 0,
      "SecondaryQuantity": 0,
      "Fee": 0,
      "Price": 0,
      "Description": "string",
      "PriceInfoPercentDiscount": 0,
      "PriceInfoPriceDiscount": 0,
      "PriceInfoDiscountRate": 0,
      "AggregateAmountPercentDiscount": 0,
      "AggregateAmountPriceDiscount": 0,
      "AggregateAmountDiscountRate": 0,
      "CustomerDiscount": 0,
      "CustomerDiscountRate": 0,
      "Discount": 0,
      "DiscountParentRef": 1,
      "Tax": 0,
      "Duty": 0,
      "Addition": 0
    }
  ]
}

Response

200

Parameter	Type	Description
ID	Int	شناسه پیش‌فاکتور
GUID	String	شناسه یکتا برای جلوگیری از ثبت تکراری
Number	Int	شماره پیش‌فاکتور
Date	Datetime	تاریخ
CurrencyRef	Int	شناسه ارز
CustomerRef	Int	شناسه مشتری
AddressRef	?Int	شناسه آدرس
SaleTypeRef	Int	شناسه نوع فروش
DiscountOnCustomer	Double	تخفیف مشتری
Price	Double	مبلغ ناخالص
Discount	Double	تخفیف
Tax	Double	مالیات
Duty	Double	عوارض
Addition	Double	اضافات
NetPrice	Double	مبلغ خالص
Items	[]QuotationItem	آرایه‌ای از اقلام پیش‌فاکتور

JSON

{
  "ID": 1,
  "GUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Number": 0,
  "Date": "2024-04-24",
  "Closed": true,
  "CurrencyRef": 1,
  "CustomerRef": 1,
  "AddressRef": 1,
  "SaleTypeRef": 1,
  "Items": [
    {
      "QuotationItemID": 1,
      "RowID": 1,
      "ItemRef": 1,
      "TracingRef": 1,
      "StockRef": 1,
      "Quantity": 0,
      "SecondaryQuantity": 0,
      "Fee": 0,
      "Price": 0,
      "Description": "string",
      "PriceInfoPercentDiscount": 0,
      "PriceInfoPriceDiscount": 0,
      "PriceInfoDiscountRate": 0,
      "AggregateAmountPercentDiscount": 0,
      "AggregateAmountPriceDiscount": 0,
      "AggregateAmountDiscountRate": 0,
      "CustomerDiscount": 0,
      "CustomerDiscountRate": 0,
      "Discount": 0,
      "DiscountParentRef": 1,
      "Tax": 0,
      "Duty": 0,
      "Addition": 0,
      "NetPrice": 0
    }
  ],
  "DiscountOnCustomer": 0,
  "Price": 0,
  "Discount": 0,
  "Tax": 0,
  "Duty": 0,
  "Addition": 0,
  "NetPrice": 0,
  "Description": "string",
  "ExpirationDate": "2024-04-24T05:32:04.338Z"
}

400

Code	Message	Description
400	شناسه سند نباید خالی باشد.	شناسه GUID ارسال نشده است.
400	کالای نامعتبر	در حال حاضر امکان انتخاب این کالا وجود ندارد.
400	شناسه کالای مشمول تخفیف پیدا نشد.	شناسه تخفیف اشتباه است.
400	“متن خطای بیزینسی”	در هنگام ذخیره پیش‌فاکتور خطایی رخ داده است.