Skip to main content

تغییر وضعیت سفارشات

About 4 min

تغییر وضعیت سفارشات

برای تغییر وضعیت سفارشات، لازم است وضعیت جدیدی (status)، که مایل به تغییر به آن هستید را در درخواست خود به وب سرویس روبرو با متد درج شده ارسال کنید. برای مشاهده وضعیت های سفارشات (status)، به بخش link icon وضعیت سفارش مراجعه کنید.

#توضیحاتنوععنوان فیلد
link icon شناسه فروشگاه str* link icon shop_id
شناسه یکتا سفارشintorder_id
وضعیتی که میخواهید به آن تغییر وضعیت دهیدintstatus


#توضیحاتنوععنوان فیلد
بارکد مرسولهstrbarcode *
شناسه یکتا مرسولهintorder_id *
وضعیت فعلی مرسولهintstatus *
نام گیرندهstrfirst_name *
نام خانوادگی گیرندهstrlast_name *
link icon کد استان int* link icon state_code
link icon کد شهرستان int* link icon city_code

نکته

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



https://api.tapin.ir/api/v2/public/order/post/change-status/POST
نمونه جیسون جهت ارسال
{
	"shop_id":"fc45949a-921d-4b4f-1ade-ab5180f7dcve",
	"order_id":16013,
	"status": 1
}

نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "barcode": "21192003111901543415",
        "order_id": 16012,
        "status": 1,
        "first_name": "my first name",
        "last_name": "my last name",
        "state_code": "2",
        "city_code": "41"
    }
}

نکته

تغییر وضعیت سفارشات تنها به صورت زیر از سمت فروشگاه امکان پذیر است :

از وضعیت به وضعیت
تحت بررسی حذف شده
تحت بررسی آماده به پرینت
آماده به پرینت حذف شده
آماده به پرینت آماده به ارسال
آماده به ارسالاشتباه در اعلام آماده به ارسال
اشتباه در اعلام آماده به ارسال حذف شده
.

تغییر وضعیت گروهی سفارشات

به منظور تغییر وضعیت سفارشات به صورت گروهی، به وب سرویس روبرو با متد درج شده درخواست ارسال کنید.
نتیجه وضعیت را میتوانید در link icon لیست کارها مشاهده نمایید

#توضیحنوععنوان فیلد
شناسه فروشگاهstr * shop_id
شناسه سفارشintid
وضعیتی که میخواهید به آن تغییر وضعیت دهیدintstatus





نکته

در صورت تغییر وضعیت سفارشات آماده به پرینت و اشتباه در اعلام آماده به ارسال ،هزینه ارسال کسر شده از پنل به صورت اتوماتیک به پنل بازگردانده نشده و جهت عودت هزینه بارکد سفارشات باید در سامانه تاپین در قالب تیکت ارسال شوند.



https://api.tapin.ir/api/v2/public/order/post/change-status/bulk/POST
نمونه جیسون جهت ارسال
{
    "orders": [
        {
            "id": "d95d0f45-6162-4ec3-bd29-09452c148b40"
        }
    ],
    "shop_id": "690a71b3-5cf5-45bf-9561-57e854e08972",
    "status": 80
}
نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {}

}

دریافت وضعیت سفارشات بدون فروشگاه

در صورت وجود بیش از یک فروشگاه با یک نام کاربری، به منظور دریافت آخرین وضعیت سفارشات بدون نیاز به شناسه فروشگاه، از وب سرویس روبرو اقدام نمایید.

نکته

در هر درخواست امکان فراخوانی وضعیت حداکثر ۲۰۰ سفارش وجود دارد.

#توضیحنوععنوان فیلد
شناسه یکتا سفارشاتlistorders_id *


https://api.tapin.ir/api/v2/public/order/post/get-status/report/POST
نمونه جیسون جهت ارسال
{
    "orders_id": [
        2735426
    ]
}
نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "status": 80,
                "barcode": "05102600001264713341122",
                "last_change_status": "2023-12-12T10:07:09.620789",
                "id": "000c209b-adff-48e1-9617-b99a0c899c71",
                "order_id": 2735426
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 1
    }
}
.

لیست وضعیت و بارکد سفارشات

از طریق وب سرویس روبرو امکان دریافت بارکد و وضعیت سفارشات با استفاده از شناسه سفارش میسر است.


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

راهنمایی

"orders" یک لیست از "orders id" ها است




#توضیحنوععنوان فیلد
شناسه مرسولهstrid
بارکد مرسولهstrbarcode
شناسه یکتا مرسولهintorder_id
وضعیت مرسولهintstatus

نکته

در هر درخواست امکان فراخوانی وضعیت حداکثر ۲۰۰ سفارش وجود دارد.



https://api.tapin.ir/api/v2/public/order/post/get-status/bulk/POST
نمونه جیسون جهت ارسال
{
    "shop_id": "690a71b3-5cf5-45bf-9561-57e854e08972",
    "orders": [
        {
            "id": "a93f6b7f-d05e-4bee-a700-deb0d16572bf"
        }
    ]
}


نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "order_id": 19393,
                "id": "a93f6b7f-d05e-4bee-a700-deb0d16572bf",
                "barcode": "",
                "status": 100
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 1
    }
}
.

دریافت آخرین تغییر وضعیت سفارشات در بازه روزانه

به منظور دریافت لیست سفارشات بر اساس تاریخ آخرین تغییر وضعیت آنها،از وب سرویس روبرو استفاده کنید.


#توضیحنوععنوان فیلد
شناسه فروشگاه strshop_id*
تعداد آیتم ها جهت نمایش در صفحهintcount *
شماره صفحهintpage *
تاریخstrdate


https://api.tapin.ir/api/v2/public/order/post/change-status/report/POST
نمونه جیسون جهت ارسال

{
    "shop_id": "590a71b2-5cf5-45xf-9561-57b854e08972",
    "count": 10,
    "page": 1,
    "date": "1402-07-26",
}
نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
           {
                "barcode": "012352312312162402033147",
                "order_id": 2331,
                "id": "ffe026a8-0c0a-4dae-85cf-e5164c59d9b8",
                "status": 0
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 1
    }
}
.

دریافت آخرین تغییر وضعیت سفارشات در بازه تاریخی مشخص

به منظور دریافت لیست سفارشات بر اساس بازه تاریخی آخرین تغییر وضعیت از وب سرویس روبرو استفاده نمایید.

#توضیحنوععنوان فیلد
شناسه فروشگاهstr * shop_id
تعداد آیتم ها جهت نمایش در صفحهintcount *
شماره صفحهintpage *
از تاریخstrfrom_date
تا تاریخstrto_date

نکته

در صورت عدم ارسال شناسه فروشگاه،تمامی مرسولات کاربر نمایش داده میشود.




https://api.tapin.ir/api/v2/public/order/post/change-status/report/last-change-status/POST
نمونه جیسون جهت ارسال

{
    "shop_id": "590a71b2-5cf5-45xf-9561-57b854e08972",
    "count": 10,
    "page": 1,
    "from_date": "2022-01-01",
    "to_date": "2023-05-01"
}
نمونه جیسون خروجی
{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
           {
                "barcode": "012352312312162402033147",
                "order_id": 2331,
                "id": "ffe026a8-0c0a-4dae-85cf-e5164c59d9b8",
                "status": 0,
                "last_change_status": "2023-01-31T11:58:22.146968",
                "shop_id": "590a71b2-5cf5-45xf-9561-57b854e08972"
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 1
    }
}
.