ویرایش سفارش

ویرایش سفارش

با این سرویس می‌توانید اطلاعات یک سفارش ثبت ‌شده را ویرایش کنید.
تمام فیلد های سفارشات در وضعیت تحت بررسی قابل ویرایش هستند.
برای سفارشات در وضعیت آماده به پرینت فقط فیلدهایی قابل ویرایش‌اند که در شبکه پست نیز قابل ویرایش باشند. برای این سفارشات سایر اطلاعات مرسوله (مانند نوع سفارش، نوع پرداخت، استان و شهر مقصد، کیوسک، بیمه و...) از خود سفارش خوانده می‌شوند و از این مسیر قابل تغییر نیستند؛ در صورت نیاز به تغییر آن‌ها، سفارش را حذف و مجدداً ثبت نمایید.

سفارش در وضعیت‌های تحت بررسی، آماده به پرینت و منتظر استعلام قابل ویرایش است:

• سفارش بدون بارکد: پس از ویرایش، سفارش در وضعیت منتظر استعلام قرار می‌گیرد و پس از استعلام مجدد نرخ (به صورت خودکار)، به وضعیت تحت بررسی باز می‌گردد.
• سفارش بارکددار (آماده به پرینت): در صورت تغییر اطلاعات مؤثر، ویرایش در همان لحظه به شبکه پست نیز اعمال شده و هزینه‌ها به‌روز می‌شوند.

شناسه‌ی سفارش

برای مشخص کردن سفارش مورد ویرایش، باید دقیقاً یکی از سه فیلد زیر ارسال شود. ارسال هیچ‌کدام یا بیش از یکی، خطای اعتبارسنجی برمی‌گرداند:

#	توضیحات	نوع	فیلد
	شناسه مرسوله	str	id
	شناسه یکتا مرسوله	int	order_id
	شناسه دستی سفارش	str	manual_id

فیلدهای قابل ویرایش

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	str	* shop_id
	آدرس گیرنده (حداکثر 300 کاراکتر)	str	address *
	کد شهرستان	int	city_code
	کد استان	int	province_code
	توضیحات (حداکثر 250 کاراکتر)	str	description
	ایمیل	str	email *
	کد کارمند	int	employee_code
	نام (حداکثر 30 کاراکتر)	str	first_name *
	نام خانوادگی (حداکثر 40 کاراکتر)	str	last_name *
	شماره موبایل	str	mobile *
	شماره تلفن	str	phone
	کدپستی	int	postal_code
	نوع پرداخت سفارش	int	pay_type
	نوع سفارش	int	order_type
	شناسه بسته پستی	int	* box_id
	شناسه نوع بسته بندی	int	packet_type
	مبلغ پیش‌ پرداخت (اگر نوع پرداخت «پرداخت در محل» باشد قابل تنظیم است)	int	pre_paid_price
	وزن بسته بندی	int	* package_weight
	تعداد محصول	int	count *
	تخفیف محصول	int	discount *
	مبلغ محصول	int	price
	نام محصول (حداکثر 100 کاراکتر)	int	title
	وزن کالا	int	weight
	شناسه یکتا محصول	int	product_id
	بیمه کالا ( ارسال این فیلد برای سفارش های آنلاین اجباری هست در صورت عدم انتخاب توسط سیستم مقدار دهی میشود.)	int	has_insurance
	شناسه کیوسک پستی	int	kiosk_id
	مدت زمان نگهداری مرسوله در لاکر	int	duration
	مرسوله با قابلیت چرخش	bool	parcel_turning

نکته

وزن نهایی، ارزش و محتوای مرسوله از روی لیست محصولات (products) و وزن بسته‌بندی (package_weight) سمت سامانه محاسبه می‌شوند؛ بنابراین در هر ویرایش، لیست کامل محصولات سفارش باید ارسال شود.

ویرایش سفارشات آماده به پرینت

برای سفارشات با وضعیت آماده به پرینت (معلق) امکان ویرایش فیلد های زیر وجود ندارد:

1. order_type

2. pay_type

3. province_code

4. city_code

5. kiosk_id

6. has_insurance

ارسال این فیلدها با مقدار «بدون تغییر» مجاز است و نادیده گرفته می‌شود؛ اما در صورت تلاش برای تغییر مقدار آن‌ها، درخواست با خطای کد 2005 رد می‌شود و لیست فیلدهای غیرمجاز در پاسخ باز می‌گردد.

---

#	توضیح	نوع	فیلد
	بارکد مرسوله	str	barcode *
	شناسه مرسوله	str	id *
	شناسه یکتا مرسوله	int	order_id *
	وضعیت مرسوله	int	* status
	نام گیرنده	str	first_name *
	نام خانوادگی گیرنده	str	last_name *
	کد استان	int	* state_code
	کد شهرستان	int	* city_code
	هزینه ارسال	int	send_price *
	مالیات هزینه ارسال	int	send_price_tax *
	مبلغ بیمه	int	insurance_price *
	مالیات بیمه	int	insurance_tax *
	تاریخ ایجاد	str	created_at *
	جمع کل	int	total_price *
	مبلغ کل تخفیف هزینه ارسال	int	total_send_price_discount *
	ارزش کل مرسوله	int	product_price *
	مبلغ پیش‌ پرداخت	int	pre_paid_price *
	مبلغ کل قابل پرداخت توسط گیرنده	int	final_pay_price *

https://api.tapin.ir/api/v2/public/order/post/edit/POST

نمونه جیسون جهت ارسال

{
  "order_id": 16013,
  "shop_id": "7c4s979...",
  "address": "تست ادیت",
  "city_code": "91",
  "province_code": "7",
  "description": "تست",
  "email": null,
  "first_name": "تست",
  "last_name": "تست",
  "mobile": "09011111111",
  "content_type": 2,
  "phone": "02122222",
  "postal_code": "1313131313",
  "pay_type": "1",
  "order_type": "3",
  "package_weight": 1000,
  "box_id": 1,
  "packet_type": 2,
  "pre_paid_price": 0,
  "products": [
    {
      "count": 2,
      "discount": 0,
      "price": 100000000,
      "title": "تست 1",
      "weight": 1000,
      "product_id": null
    }
  ],
  "kiosk_id": 1,
  "duration": 48,
  "parcel_turning": true,
  "has_insurance": true
}

نمونه جیسون خروجی

{
  "returns": {
    "status": 200,
    "message": "عملیات با موفقیت انجام شد."
  },
  "entries": {
    "barcode": "21242000512705555221",
    "id": "ebb7b63d-9eaf-4b7d-af7b-5235bcd428e6",
    "order_id": 16013,
    "status": 100,
    "first_name": "my first name",
    "last_name": "my last name",
    "state_code": "1",
    "city_code": "1",
    "send_price": 343980,
    "send_price_tax": 34398,
    "insurance_price": 50000,
    "insurance_tax": 5000,
    "created_at": "2026-02-18 12:07:17.362534",
    "total_price": 870628,
    "total_send_price_discount": 69432,
    "product_price": 500000,
    "pre_paid_price": 0,
    "final_pay_price": 0
  }
}

خطاهای متداول
کد	توضیح
300	پارامترهای ارسالی نامعتبر (شامل ارسال هیچ‌کدام یا بیش از یکی از شناسه‌ها)
315	سفارش مورد نظر یافت نشد
341	وضعیت فعلی سفارش اجازه ویرایش نمی‌دهد
770	بیش از یک سفارش با شناسه دستی ارسالی وجود دارد — با id یا order_id ویرایش کنید
2005	تلاش برای تغییر فیلدهای غیرقابل‌ویرایش (لیست فیلدها در پاسخ باز می‌گردد)
2006	پاسخ نامعتبر از درگاه پست در ویرایش مرسوله
2007	امکان ویریاش اطلاعات ارسال کننده برای سفارشاتی که بدون ارسال کننده ثبت شده است وجود ندارد