جزییات سفارش

جزییات سفارش

به منظور دریافت و مشاهده جزئیات یک سفارش از طریق وب سرویس روبرو اقدام نمایید:

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

---

#	توضیح	نوع	فیلد
	شناسه سفارش	str	id *
	بارکد مرسوله	str	barcode *
	شناسه یکتا سفارش	int	order_id *
	وضعیت مرسوله	int	* status
	نام گیرنده	str	first_name *
	نام خانوادگی گیرنده	str	last_name *
	کد استان گیرنده	int	state_code *
	کد شهر گیرنده	int	city_code *
	آدرس گیرنده	str	address *
	کد پستی گیرنده	int	postal_code *
	ایمیل گیرنده	str	email *
	شماره تماس گیرنده	str	phone *
	شماره موبایل گیرنده	str	mobile *
	نوع پرداخت	int	* pay_type
	مبلغ بیمه	int	*insurance_price
	مالیات بیمه	int	*insurance_tax
	نوع سفارش	int	* order_type
	توضیحات	str	*description
	وزن بسته‌بندی	int	* package_weight
	وزن کل	int	* total_weight
	مبلغ کل فاکتور	int	factor_price *
	متن فاکتور	str	factor_title *
	تاریخ ساخت	str	created_at *
	تعداد محصول	int	count *
	تخفیف محصول	str	discount *
	مبلغ محصول	int	price *
	نام محصول	str	title *
	وزن محصول	int	* weight
	شناسه یکتا محصول	int	product_id *
	شناسه کیوسک جابار	int	kiosk_id *

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

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

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

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "id": "d95d0f45-6162-4ec3-bd29-09452c148b40",
        "barcode": "21292000411901545180",
        "order_id": 16013,
        "status": 2,
        "first_name": "my first name",
        "last_name": "my last name",
        "state_code": "2",
        "city_code": "41",
        "address": "tehran-...",
        "postal_code": "1343242123",
        "email": "",
        "phone": "02166810643",
        "mobile": "09011111111",
        "pay_type": "1",
        "order_type": 0,
        "description": "",
        "package_weight": 10,
        "insurance_price": 0,
        "insurance_tax": 0,
        "total_weight": 210,
        "factor_price": 552102,
        "factor_title": " نیازی به دریافت وجه نمی\u200cباشد (Online",
        "created_at": "1398-05-13 12:23",
        "kiosk_id": 101,
        "products": [
            {
                "count": 1,
                "discount": 0,
                "price": 500000,
                "title": "none",
                "weight": 200,
                "product_id": null
            }
        ],
    }
}

جزئیات سفارشات به صورت HTML

از طریق وب سرویس روبرو، امکان دریافت جزئیات سفارش در فرمت فاکتور وجود دارد.
فاکتور سفارش باید پرینت گرفته شود و به بسته بندی الصاق شود:

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

نکته

نکته:پاسخ موفق به صورت html بازگردانده میشود.

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

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

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

جزئیات گروهی سفارشات به صورت HTML

از ظریق وب سرویس روبرو، امکان دریافت جزئیات سفارشات در قالب فاکتور به صورت گروهی وجود دارد.
فاکتور سفارش باید پرینت گرفته شده و به بسته بندی الصاق گردد:

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	str	* shop_id
	شناسه یکتا سفارشات	List[int]	orders_id *

نکته

نکته :پاسخ موفق به صورت html بازگردانده میشود. در هر درخواست امکان فراخوانی فاکتور حداقل ۵۰ سفارش وجود دارد .

https://api.tapin.ir/api/v2/public/order/post/detail/html/bulk/POST

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

{
	"shop_id":"fc45949a-921d-4b4f-1ade-ab5180f7dcve",
	"orders_id":[16013]
}

لیست سفارشات

به منظور دریافت لیست سفارشات از وب سرویس روبرو این امکان فراهم میباشد:

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	str	* shop_id
	تعداد آیتم ها جهت نمایش در صفحه	int	count *
	شماره صفحه	int	page *
	شناسه یکتا سفارش	int	order_id
	بارکد	str	barcode
	کد شهرستان	int	city_code
	کد استان	int	province_code
	نام	str	first_name
	نام خانوادگی	str	last_name
	نوع پرداخت	int	pay_type
	نوع سفارش	int	order_type
	وضعیت مرسوله	int	* status
	تاریخ ثبت سفارش	str	created_at *

نکته

فیلد تاریخ ایجاد باید بصورت یکی از فرمت های زیر باشد:
{ "created_at": "1398-02-12 12:30" }

{ "created_at": "1398-02-12" }

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

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

{
	"shop_id":"fc45949a-921d-4b4f-1ade-ab5180f7dcve",
	"count":"10",
	"page":"1"
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "id": "d95d0f45-6162-4ec3-bd29-09452c148b40",
                "barcode": "21294720411963211126",
                "order_id": 16013,
                "status": 2,
                "first_name": "my first name",
                "last_name": "my last name",
                "mobile": "09122222222",
                "state_code": "2",
                "city_code": "41",
                "pay_type": "1",
                "order_type": 0,
                "created_at": "1398-05-13 12:23"
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 15
    }
}