گرفتن لیست فروشگاه‌ها

گرفتن لیست‌ فروشگاه‌ها

به منظور دریافت لیست و شناسه فروشگاه های دیگر خود،میتوانید به وب سرویس روبرو با متد درج شده درخواست ارسال کنید:

#	توضیحات	نوع	عنوان فیلد
	تعداد آیتم‌ها جهت نمایش در صفحه	int	count *
	شماره صفحه	int	page *

---

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه‌ها	str	id *
	نام فروشگاه	str	title *
	تعداد آیتم‌ها در صفحه	str	count *
	شماره صفحه	str	page *
	تعداد کل آیتم‌ها	str	total_count *

https://api.tapin.ir/api/v2/public/shop/list/POST

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

{
    "count":10,
    "page":1
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "id": "7c42379...",
                "title": "My Shop Title"
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 1
    }
}

.

ثبت فروشگاه

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

#	توضیحات	نوع	عنوان فیلد
	نام فروشگاه	str	shop_name *
	نام	str	first_name *
	نام خانوادگی	str	last_name *
	ایمیل	str	email *
	نام پدر	str	father_name *
	تلفن	str	phone
	موبایل	str	mobile *
	تاریخ تولد (میلادی)	str	birth_date *
	شماره شناسنامه	str	certificate_code *
	سریال شناسنامه	str	certificate_serial_number *
	محل تولد	str	birthday_location *
	کد ملی	str	national_code *
	آدرس	str	address *
	کد استان	int	* province
	کد شهر	int	* city
	کد پستی	str	postal_code *
	واحد	str	unit *
	طبقه	str	floor *
	پلاک	str	plaque *
	عرض جغرافیایی	float	latitude *
	طول جغرافیایی	float	longitude *
	وبسایت	str	website *
	ساعت کاری فروشگاه	str	available_hours *
	شناسه اینستاگرام	str	instagram_id *
	توضیحات فروشگاه	str	shop_description
	لوگو فروشگاه (به صورت base64 ) حداکثر ۱ مگابایت	str	logo_image *
	عکس کارت ملی (به صورت base64 ) حداکثر ۱ مگابایت	str	id_cart_image *
	آیا فروشگاه حقوقی هست	bool	is_legal_shop *
	نام شرکت (درصورت حقوقی بودن فروشگاه)	str	company_name
	کد اقتصادی شرکت (درصورت حقوقی بودن فروشگاه)	str	economic_code
	کد ملی شرکت (درصورت حقوقی بودن فروشگاه)	str	company_national_code
	شناسه ثبت شرکت (درصورت حقوقی بودن فروشگاه)	str	register_code

https://api.tapin.ir/api/v2/public/shop/create/POST

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

{
    "shop_name": "فروشگاه تست",
    "first_name": "نام",
    "last_name": "نام خانوادگی",
    "email": "test@gmail.com",
    "father_name": "نام پدر",
    "phone": "02166666666",
    "mobile": "09120000000",
    "birth_date": "1997-01-31",
    "certificate_code": "1111111111",
    "certificate_serial_number": "1111111111",
    "birthday_location": "تهران",
    "national_code": "1111111111",
    "address": "تهران",
    "province": 1,
    "city": 1,
    "postal_code": "1311111111",
    "unit": 1,
    "floor": 1,
    "plaque": 1,
    "latitude": 56.25,
    "longitude": 46.574,
    "website": "test.com",
    "available_hours": "12-24",
    "instagram_id": "@tapin",
    "shop_description": "توضیحات",
    "logo_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAIAAACwQdIgAAAAA3NCSVQICAjb4U/gAAAA10lEQVQokWN0tjFxNBfg5mRmwAtY3GyE2FgY8StiYGBggivCr5YJzpLWllIykmNiwq4eoY6JiUHJVN48xEhAghefOgjgFuQy9tPXsFVhYWXGp46BgYGRkVFGS9Iy3ERUXgifOghg52bT99DWc9Nk52JjYGBgwaUOAsQURYSkBO+cvI/TPDhgYWcWkOInYN73zz9uHr775vE7nOr+//v/+Oqzu6cf/P39D6f7vrz5ev3Q7Y+vPyNsR1Px78+/e2cfPbz0+P8/VFcic94//XD90O1vn35g2gAAJh45fIebGSgAAAAASUVORK5CYII=",
    "id_cart_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAIAAACwQdIgAAAAA3NCSVQICAjb4U/gAAAA10lEQVQokWN0tjFxNBfg5mRmwAtY3GyE2FgY8StiYGBggivCr5YJzpLWllIykmNiwq4eoY6JiUHJVN48xEhAghefOgjgFuQy9tPXsFVhYWXGp46BgYGRkVFGS9Iy3ERUXgifOghg52bT99DWc9Nk52JjYGBgwaUOAsQURYSkBO+cvI/TPDhgYWcWkOInYN73zz9uHr775vE7nOr+//v/+Oqzu6cf/P39D6f7vrz5ev3Q7Y+vPyNsR1Px78+/e2cfPbz0+P8/VFcic94//XD90O1vn35g2gAAJh45fIebGSgAAAAASUVORK5CYII=",
    "is_legal_shop": true,
    "company_name": "تاپین",
    "economic_code": "11111111",
    "company_national_code": "11111111",
    "register_code": "11111111"
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "id": "09443182-ccd7-4631-ae51-5dde361a06f6"
    }
}

جزییات و اطلاعات کامل فروشگاه

با داشتن شناسه فروشگاه خود و ارسال درخواست به وب سرویس روبرو با متد درج شده، مي‌توانید از جزئیات فروشگاه خود خبردار شوید.برای اطلاع بیشتر راجب وضعیت فروشگاه،به کادر راهنمایی زیر مراجعه کنید.

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

---

#	توضیحات	نوع	عنوان فیلد
	نام فروشگاه	str	title *
	پیام فروشگاه	str	shop_message *
	ساعات پاسخگویی	str	available_hours *
	کد استان	int	* Province_code
	کد شهرستان	int	* city_code
	آدرس	str	address *
	کد پستی	int	postal_code *
	شماره تماس	str	phone *
	لوگو فروشگاه	str	logo *
	نام مدیر فروشگاه	str	owner_first_name *
	نام خانوادگی مدیر فروشگاه	str	owner_last_name *
	نام کاربری مدیر فروشگاه	str	owner_username *
	موبایل مدیر فروشگاه	str	owner_mobile *
	هزینه خدمات پنل	int	service_price *
	مالیات خدمات پنل	int	service_price_tax *
	هزینه حق ثبت	int	post_service_price *
	مالیات حق ثبت	int	post_service_price_tax*
	هزینه ارسال اس ام اس	int	sms_price *
	مجموع کل مبلغی از فروشگاه بابت دریافت بارکد کم میشود	int	total_price *
	مالیات هزینه ارسال اس ام اس	int	sms_price_tax *
	این فیلد مشخص میکند که برای فروشگاه پیامک ارسال شود	boolean	send_sms *
	تاریخ ایجاد	str	created_at *
	وضعیت	int	status *

https://api.tapin.ir/api/v2/public/shop/detail/POST

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

{
    "shop_id":"7c45979e-926d-4a4f-8ade-ab5180f7daee"
}

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

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "title": "my shop title",
        "shop_message": "thank you",
        "available_hours": "09-21",
        "province_code": "2",
        "city_code": "1",
        "address": "tehran-...",
        "postal_code": "1111111111",
        "phone": "0216666666",
        "logo": "data:image/png;base64,iVBORw0KGgoAAAANS...",
        "owner_first_name": "my first name",
        "owner_last_name": "my last name",
        "owner_username": "my username",
        "owner_mobile": "09011111111",
        "service_price": 10000,
        "service_price_tax": 900,
        "post_service_price": 5000,
        "post_service_price_tax": 450,
        "sms_price": 5000,
        "sms_price_tax": 450,
        "send_sms": false,
        "total_price": 16350,
        "created_at": "1397-11-05 21:01",
        "status": 1,
        "status_display": "فعال"
    }
}

راهنمایی

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

status
value	key
غیرفعال	0
فعال	1
مسدود شده	2
ارسال اطلاعات به پست	3