ثبت سفارش

ثبت سفارش

برای اطلاعات بیشتر درباره چگونگی ثبت سفارش اینجا کلیک کنید.

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

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

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

{

	"register_type": 0,
	"shop_id":"7c4s979...",
	"address":"tehran-...",
	"city_code":"1",
	"province_code":"1",
	"description":null,
	"email":null,
	"employee_code":"-1",
	"first_name":"my first name",
	"last_name":"my last name",
	"mobile":"09011111111",
	"phone":null,
	"postal_code":"1313131313",
	"pay_type":"1",
	"order_type":"0",
	"box_id": 10,
	"kiosk_id": 101,
        "pre_paid_price": 0,
	"package_weight": 10,
	"presenter_code":999,
	"manual_id":"1",
        "has_insurance":"true",
        "content_type": 1,

	"products":[
		{
			"count": 1,
			"discount": 0,
			"price": 5000,
			"title": "my product title",
			"weight":500,
			"product_id": null

		}
	]
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "barcode": "21242000512705555221",
        "order_id": 16013,
        "status": 2,
        "first_name": "my first name",
        "last_name": "my last name",
        "state_code": "2",
        "city_code": "41",
        "insurance_price": 0,
        "insurance_tax": 0,
    }
}

#	توضیح	نوع	فیلد
	بارکد مرسوله	str	barcode *
	شناسه یکتا مرسوله	int	order_id *
	وضعیت مرسوله	int	status *
	نام گیرنده	str	first_name *
	نام خانوادگی گیرنده	str	last_name *
	کد استان	int	* state_code
	کد شهرستان	int	* city_code
	مبلغ بیمه	int	insurance_price *
	مالیات بیمه	int	insurance_tax *

لیست بسته‌های پستی

هنگام ثبت سفارش پستی می‌بایست ابعاد بسته بندی (box_id)، مشخص گردد. ابعاد بسته بندی شامل طول،عرض و ارتفاع پاکت و یا بسته ای می‌باشد که سفارش در آن قرار دارد. برای دریافت لیست بسته های پستی ،میتوانید به سرویس روبرو با متد درج شده درخواست ارسال کنید.
در انتخاب اندازه بسته‌بندی، بسته به اینکه سفارش شما در چه کارتن پستی، جای می‌گیرد، یکی از انواع کارتن های پستی سایز ۱ تا ۹ را انتخاب نمایید. اگر اندازه بسته شما، بیش از کارتن پستی سایز ۹ باشد،گزینه بیش تر از ۹ را انتخاب نمایید.

#	توضیح	نوع	فیلد*
	شناسه فروشگاه	str	* shop_id

https://api.tapin.ir/api/v2/public/order/post/packing-box/POST

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

{
    "shop_id": "fc45949a-921d-4b4f-1ade-ab5180f7dcve"
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "pk": 14,
                "length": 30,
                "width": 20,
                "height": 20,
                "title": "30*20*20 cm"
            },
            {
                "pk": 15,
                "length": 35,
                "width": 25,
                "height": 20,
                "title": "35*25*20 cm"
            }
        ],
        "count": 10,
        "page": 1,
        "total_count": 2
    }
}

لیست کیوسک های سفارشات پستی

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

#	توضیح	نوع	فیلد*
	شناسه فروشگاه	str	* shop_id
	کد استان	int	* province_code
	کد شهرستان	int	* city_code

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

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

{
    "shop_id": "fc45949a-921d-4b4f-1ade-ab5180f7dcve",
    "city_code": 1,
    "province_code": 1
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "pk": 101,
                "post_unit_id": 15,
                "company": "جابار",
                "address": "تهران، خيابان عباس آباد، خيابان مفتح شمالي، نرسيده به خيابان مطهري، اداره پست منطقه 15 ",
                "lat": 35.72616477637468,
                "lon": 51.427485457433356
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 3
    }
}