Tạo vận đơn bằng id địa điểm

Tự động truyền thông tin đơn hàng sang Nhất Tín các thông tin như kích thước , cân nặng , số điện thoại và nhiều thông tin khác. Từ đó sẽ tạo đơn giao nhận.

API Configuration

HTTP Request

POST /v1/bill/create-byID

No.	Parameter	Type	Mô tả
1	partner_id	Number	ID của khách hàng, xem trên cấu hình tài khoản khi đăng nhập vào https://khachhang.ntlogistics.vn/ (opens in a new tab)
2	ref_code	String	Số Đơn Hàng tham chiếu của khách hàng, ví dụ số Hóa Đơn, số đơn bán hàng...
3	package_no	Number	Số lượng kiện (để mặc định 1 nếu khách hàng rõ là bao nhiêu kiện hàng)
4	weight	Double	Trọng lượng đơn hàng do khách hàng ước lượng / đo dạc
5	width	Double	Chiều rộng kiện hàng, tính theo cm, có thể để mặc định là 0 nếu Khách hàng ko có thông số này
6	length	Double	Chiều dài kiện hàng, tính theo cm, có thể để mặc định là 0 nếu Khách hàng ko có thông số này
7	height	Double	Chiều cao kiện hàng, tính theo cm, có thể để mặc định là 0 nếu Khách hàng ko có thông số này
8	cargo_content	String	Mô tả sơ về hàng hóa của đơn vận chuyển
9	service_id	Number	Mã dịch vụ vận chuyển, tham chiếu vào trang Master Data để lấy mã
10	payment_method_id	Number	Mã hình thức thanh toán cước phí vận chuyển, tham chiếu vào trang Master Data để lấy mã
11	is_return_doc	int	Có chuyển hoàn chứng từ không (1: Có; 0: Không; Mặc định để 0)
12	cod_amount	Double	Số Tiền Thu Hộ nhà vận chuyển cần thu từ người nhận khi giao hàng
13	note	String	Ghi chú đơn hàng, lưu ý khi vận chuyển hàng hóa/ giao hàng
14	cargo_value	Double	Giá trị hàng hóa
15	cargo_type_id	Number	Mã Loại hàng hóa (chứng từ hay hàng hóa thông thường), tham chiếu trang Master Data để lấy ID
16	s_name	String	Tên người gửi
17	s_phone	String	Số điện thoại người gửi
18	s_address	String	Địa chỉ người gửi
19	s_ward_id	int	Phường/Xã người gửi
20	s_district_id	int	Quận/Huyện người gửi
21	s_province_id	int	Tỉnh/Thành phố người gửi
22	r_name	String	Tên người nhận
23	r_phone	String	Số điện thoại người nhận
24	r_address	String	Địa chỉ người nhận
25	r_ward_id	int	Phường/Xã người nhận
26	r_district_id	int	Quận/Huyện người nhận
27	r_province_id	int	Tỉnh/Thành phố người nhận
28	r_email	String	Email người nhận
29	utm_source	String	Nguồn Đồng Bộ dữ liệu (ví dụ api_digilife) để giúp hệ thống nhà vận chuyển có thêm thông tin phân tích khi có sự cố

JSON body respone

Name	Type	Description
success	boolean	Return `true` if create bill success, all other `false` means error. See `message` for further description.
message	string	Return Message of API Respond.
data	object	Data of API response.

Request

{
   "partner_id: 123736,
   "ref_code": "TEST-009",
   "package_no": 1,
   "height": 0,
   "s_name": "Shop A",
   "s_phone": "09xxxxxxx",
   "s_province_id": 50,
   "s_district_id": 5001,
   "s_ward_id": 28250,
   "s_address": "52A, Nguyễn Thái Bình",
   "r_name": "Nguyễn Văn A",
   "r_phone": "09xxxxxxx",
   "r_province_id": 50,
   "r_district_id": 5001,
   "r_ward_id": 28244,
   "r_address": "40 Út Tịch",
   "r_email": "emamil_nguoi_nhan@gmail.com",
   "cod_amount": 200000,
   "service_id": 10,
   "payment_method_id": 10,
   "cargo_type_id": 2,
   "cargo_content": "Quần áo",
   "cargo_value": 1000000,
   "note": "ghi chú đơn hàng",
   "utm_source": "api_nt",
   "is_return_doc": 0
  }

Response

{
"success": true,
"messsage": "",
"data":
        {
           "bill_id": 159840,
           "bill_code": "CP15984057",
           "ref_code": "TEST-009",
           "status_id": 2,
           "cod_amount": 200000,
           "service_id": 10,
           "payment_method": 10,
           "created_at": "2022-12-01 15:39:00",
           "main_fee": 33462,
           "cod_fee": 0,
           "insurr_fee": 5500,
           "lifting_fee": 0,
           "remote_fee": 0,
           "counting_fee": 0,
           "packing_fee": 0,
           "total_fee": 38962,
           "partner_address_id": 24371,
           "receiver_name": "Nguyễn Văn A",
           "receiver_phone": "09xxxxxxx",
           "receiver_address": "40 Út Tịch",
           "package_no": 1,
           "weight": 1.3,
           "cargo_content": "Quần áo",
           "cargo_value": 1000000,
           "note": "ghi chú đơn hàng"
        }
}

Kết nối dành cho sàn Địa điểm