Tourwell Open APIs
  1. v1
Tourwell Open APIs
  • Tổng quan
  • Hướng dẫn xác thực
  • API Beta 1.0
  • API Zalo Mini App (Beta)
  • Khách hàng
    • v1
      • Get by id
      • Get all customer
      • Create customer
      • Update customer
      • Get order history
  • Đơn hàng
    • v1
      • Get by id
      • Get all order
      • Create order tour
      • Create order product
      • Create order hotel
      • Confirm payment order
  • Sản phẩm
    • v1
      • Create product
        POST
      • Get by id
        GET
      • Calendar pricing
        GET
  • Lịch khởi hành
  • Lead (Cơ hội)
    • v1
      • Get all lead
      • Get by id
      • Create lead
      • Update lead
  • Khách sạn
    • v1
      • Get all hotel
      • Get by id
  • Kế toán
    • Phiếu thu
      • v1
        • Get all receipt
    • Phiếu chi
      • v1
        • Get all payment
        • Confirm Payment
    • Hóa đơn
      • Update invoice
      • Issue Invoice
      • Get by id
      • Cancel invoice
  • Cấu hình
    • Zalo ZNS
      • Danh sách Tag
      • Get token
    • Địa điểm
      • Search
    • Nhân sự nội bộ
      • Search
    • Webhook
      • Hướng dẫn cài đặt
    • Trạng thái khách hàng
      • Get All
    • Loại dịch vụ
  1. v1

Create product

POST
/api/v1/products
API này cho phép người dùng tạo một sản phẩm mới bằng cách gửi thông tin sản phẩm qua yêu cầu POST

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Authorization
string 
required
Example:
Bearer {{YOUR_API_TOKEN}}
Body Params application/json
name
string 
required
Tên sản phẩm
type
string 
required
Danh sách loại sản phẩm:
package Tour trọn gói
combo Combo du lịch
visa Visa/Hộ chiếu
ticket Vé tham quan
train-ticket Vé tàu xe
market
string 
required
Thị trường
domestic Nội địa
outbound Outbound
inbound Inbound
description
string 
optional
Mô tả sản phẩm
is_active
boolean 
optional
Trạng thái kích hoạt sản phẩm
0 Ngừng kinh doanh
1 Đang kinh doanh
price_adult
integer 
optional
Đơn giá người lớn
number_of_day
integer 
required
Số ngày
Ví dụ: 3
number_of_night
integer 
required
Số đêm
Ví dụ: 2
included
string 
optional
Giá bao gồm
not_included
string 
optional
Giá không bao gồm
change_policy
string 
optional
Điều kiện hoàn hủy
surcharge_policy
string 
optional
Chính sách phụ thu
children_policy
string 
optional
Chính sách trẻ em
special_note
string 
optional
Lưu ý đặc biệt
schedule_refer_link
string 
optional
Link chương trình
code
string 
optional
Mã sản phẩm
star
integer 
optional
Hạng sao
Nhập (1,2,3,4,5)
keep_time
integer 
optional
Thời gian giữ chỗ:
1h nhập là 1
3h nhập là 3
vehicle
string 
optional
Phương tiện
departure_location
string 
optional
ID điểm khởi hành lấy tại Api địa điểm Tìm kiếm địa điểm
destination
array[string]
optional
schedules
array [object {2}] 
optional
Lịch trình theo từng ngày
title
string 
optional
Tiêu đề
content
string 
optional
Nội dung
Example
{
    "name": "Tour Hà Giang - Sông Nho Quế hùng vĩ 3 ngày 2 đêm từ Hà Nội 2024",
    "type": "package",
    "market": "domestic",
    "description": "Tour du lịch Hà Giang 3 ngày 2 đêm cuốn hút người ta bởi những khúc đường đèo đầy ấn tượng, bởi dòng sông Nho Quế hùng vĩ, bởi những mùa hoa nở đẹp, những bản làng yên bình hay những phiên chợ rực rỡ sắc màu. Tự hào là nhà tổ chức tour Hà Giang chất lượng số 1 trên thị trường. Hãy đồng hành cùng PYS Travel để có một chuyến đi ấn tượng, vui vẻ, an toàn và đáng nhớ!",
    "is_active": true,
    "price_adult": 2000000,
    "number_of_day": 3,
    "number_of_night": 2,
    "included": "Xe Ô tô đời mới đưa đón suốt hành trình.",
    "not_included": "Tiền tip lái xe, HDV",
    "change_policy": "Hủy tour ngay sau khi đăng ký đến 10 ngày trước ngày khởi hành, phạt 30% trên giá tour.",
    "surcharge_policy": "Phụ thu phòng đơn 400.000 VNĐ/ khách/ đêm (Áp dụng trong trường hợp khách muốn ở 01 mình 01 phòng trong suốt hành trình).",
    "children_policy": "Trẻ em dưới 5 tuổi miễn phí (ăn uống và ngủ cùng với bố mẹ, bố mẹ tự túc lo cho bé). Hai người lớn chỉ kèm 1 trẻ em, trẻ em thứ 2 trở đi tính giá 50% giá tour người lớn.",
    "special_note": "Do mùa lễ hội hoa tam giác mạch, số lượng khách hàng ghé thăm Hà Giang tăng cao nên số lượng phòng tại Yên Minh và Đồng Văn không đủ để phục vụ Quý khách, PYS Travel sẽ sắp xếp thêm phòng nghỉ tại Quản Bạ và Mèo Vạc đảm bảo dịch vụ chu đáo và đầy đủ lịch trình các điểm thăm quan cho Quý khách.",
    "schedule_refer_link": "https://tourwell.vn/",
    "departure_location": "1_country",
    "destination": [
      "1_country"
    ],
    "schedules": [
        {
            "title": "NGÀY 1: HÀ NỘI - QUẢN BẠ - YÊN MINH",
            "content": "Sáng: Xe và Hướng dẫn viên đón Quý khách tại Rạp Xiếc Trung Ương - 67 - 69 Trần Nhân Tông."
        },
        {
            "title": "NGÀY 2: YÊN MINH - CAO NGUYÊN ĐÁ ĐỒNG VĂN - SÔNG NHO QUẾ - MÃ PÍ LÈNG",
            "content": "Sáng: Quý khách thức dậy ăn sáng và làm thủ tục trả phòng. "
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://demo.tourwell.net/api/v1/products' \
--header 'Authorization: Bearer {{YOUR_API_TOKEN}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Tour Hà Giang - Sông Nho Quế hùng vĩ 3 ngày 2 đêm từ Hà Nội 2024",
    "type": "package",
    "market": "domestic",
    "description": "Tour du lịch Hà Giang 3 ngày 2 đêm cuốn hút người ta bởi những khúc đường đèo đầy ấn tượng, bởi dòng sông Nho Quế hùng vĩ, bởi những mùa hoa nở đẹp, những bản làng yên bình hay những phiên chợ rực rỡ sắc màu. Tự hào là nhà tổ chức tour Hà Giang chất lượng số 1 trên thị trường. Hãy đồng hành cùng PYS Travel để có một chuyến đi ấn tượng, vui vẻ, an toàn và đáng nhớ!",
    "is_active": true,
    "price_adult": 2000000,
    "number_of_day": 3,
    "number_of_night": 2,
    "included": "Xe Ô tô đời mới đưa đón suốt hành trình.",
    "not_included": "Tiền tip lái xe, HDV",
    "change_policy": "Hủy tour ngay sau khi đăng ký đến 10 ngày trước ngày khởi hành, phạt 30% trên giá tour.",
    "surcharge_policy": "Phụ thu phòng đơn 400.000 VNĐ/ khách/ đêm (Áp dụng trong trường hợp khách muốn ở 01 mình 01 phòng trong suốt hành trình).",
    "children_policy": "Trẻ em dưới 5 tuổi miễn phí (ăn uống và ngủ cùng với bố mẹ, bố mẹ tự túc lo cho bé). Hai người lớn chỉ kèm 1 trẻ em, trẻ em thứ 2 trở đi tính giá 50% giá tour người lớn.",
    "special_note": "Do mùa lễ hội hoa tam giác mạch, số lượng khách hàng ghé thăm Hà Giang tăng cao nên số lượng phòng tại Yên Minh và Đồng Văn không đủ để phục vụ Quý khách, PYS Travel sẽ sắp xếp thêm phòng nghỉ tại Quản Bạ và Mèo Vạc đảm bảo dịch vụ chu đáo và đầy đủ lịch trình các điểm thăm quan cho Quý khách.",
    "schedule_refer_link": "https://tourwell.vn/",
    "departure_location": "1_country",
    "destination": [
      "1_country"
    ],
    "schedules": [
        {
            "title": "NGÀY 1: HÀ NỘI - QUẢN BẠ - YÊN MINH",
            "content": "Sáng: Xe và Hướng dẫn viên đón Quý khách tại Rạp Xiếc Trung Ương - 67 - 69 Trần Nhân Tông."
        },
        {
            "title": "NGÀY 2: YÊN MINH - CAO NGUYÊN ĐÁ ĐỒNG VĂN - SÔNG NHO QUẾ - MÃ PÍ LÈNG",
            "content": "Sáng: Quý khách thức dậy ăn sáng và làm thủ tục trả phòng. "
        }
    ]
}'

Responses

🟢200Success
application/json
Body
success
boolean 
required
message
string 
required
data
object 
required
id
integer 
required
name
string 
required
Examples
{
    "success": true,
    "message": "The product created successfully",
    "data": {
        "id": 156,
        "name": "Tour Hà Giang - Sông Nho Quế hùng vĩ 3 ngày 2 đêm từ Hà Nội 2024"
    }
}
🟠422Parameter Error
Modified at 2025-03-29 11:51:44
Previous
v1
Next
Get by id
Built with