Tạo đơn hàng

API tạo đơn hàng 247

CustomerAPICreateOrder

POST:/Api/Customer/CustomerAPICreateOrder

Headers

Name	Value
ClientID	Lấy từ api đăng nhập
Token	Lấy từ api đăng nhập

Name

Value

ClientID

Lấy từ api đăng nhập

Token

Lấy từ api đăng nhập

Body

Name Type Description

Name	Type	Description
ClientHubID	number	Mã địa chỉ khách hàng (Bắt buộc khi không truyền CusWareHouseID)
ReceiverPhone*	string	Số điện thoại người nhận
ReceiverName	string	Tên người nhận
ReceiverAddress*	string	Địa chỉ đầy đủ của người nhận (số nhà, tên đường, tên xã, tên huyện, tên tỉnh)
ReceiverProvinceName*	string	Tên Tỉnh/Thành phố người nhận
ReceiverDistrictName*	string	Tên Quận/Huyện người nhận
ReceiverWardName	string	Tên Phường/Xã người nhận
RealWeight	number	Trọng lượng thực tế (kg)
Length	number	Chiều dài (cm)
Width	number	Chiều rộng (cm)
Height	number	Chiều cao (cm)
Quantity	number	Số lượng kiện
Note	string	Ghi chú
ServiceTypeID*	string	Mã dịch vụ
MailerType	string	Mã loại hàng hóa vận chuyển: HH - Hàng hóa. TL - Tài liệu.
CODAmount	number	Tiền thu người nhận
ExternalCode	string	Mã vận đơn khách hàng
ReferenceCode	string	Mã tham chiếu khách hàng
SpecialInstructionId	number	Mã ghi chú đặc biệt chỉ đối với đơn hàng COD: 1 - Cho xem hàng. 0 - Không cho xem hàng.
InformFee	string	Giá trị kê khai. Các trường hợp lưu ý khi kê khai: 1 - Trọng lượng tính giá >= 2.5kg bắt buộc chọn Loại hình = HH(hàng hóa) 2 - Loại hình = HH bắt buộc nhập giá trị kê khai 3 - Đơn chọn DVBH (Dịch vụ bảo hiểm) thì bắt buộc nhập giá trị kê khai.
ExtraServices	array	Danh sách các dịch vụ gia tăng
DirectSenderName	string	Người đi gửi Thư/Hàng
Items	array	Danh sách hàng hóa đồng kiểm: { "No": 1, //Số thứ tự "ItemID": "ITEM1", //Mã hàng hóa "ItemName": "ITEMNAME", //Tên hàng hóa "UnitName": "", // Đơn vị tính "Qty": 3, // Số lượng "UnitPrice": 1200000, // Đơn giá(VNĐ) "Amount": 3600000, // Thành tiền "Notes": "Thiết bị điện tử", //Ghi chú về mặt hàng "Imeis": //Các số imei của từng mặt hàng cụ thể(nếu có truyền thông tin này sang thì sẽ đồng kiểm từng imei) [ { "No": 1, // Số thứ tự "Imei": "AM0123456"// Số emei }, { "No": 2, "Imei": "AM0123457"// Số emei } ] }
ContactPhone	string	SĐT người liên hệ gửi hàng(bắt buộc khi KH có địa chỉ gửi không cố định)
ContactName	string	Tên người liên hệ gửi hàng(bắt buộc khi KH có địa chỉ gửi không cố định)
SenderAddress	string	Địa chỉ đầy đủ người gửi, bao gồm: số nhà, tên đường, tên xã, tên huyện, tên tỉnh. (bắt buộc khi KH có địa chỉ gửi không cố định)
CusWareHouseID	string	Mã kho/shop (Bắt buộc khi không truyền ClientHubID)
Packages	array	`{ "PackageID": "HD000003/1", //Mã kiện, "Length": 100, // Kích thước (Dài - bắt buộc khi có nhập Rộng, Cao)(cm), "Width": 50, // Kích thước (Rộng - bắt buộc khi có nhập Dài, Cao)(cm), "Height": 80,// Kích thước (Cao - Bắt buộc khi có nhập Dài, Rộng)(cm), "RealWeight": 25// Trọng lượng thực của kiện (kg) }` (*)Số lượng Packages phải khớp với Quantity. Trường hợp Quantity = 1 thì Packages = []
COPAmt	number	Tiền COP (Cash on pickup)

ClientHubID

number

Mã địa chỉ khách hàng (Bắt buộc khi không truyền CusWareHouseID)

ReceiverPhone*

string

Số điện thoại người nhận

ReceiverName

string

Tên người nhận

ReceiverAddress*

string

Địa chỉ đầy đủ của người nhận (số nhà, tên đường, tên xã, tên huyện, tên tỉnh)

ReceiverProvinceName*

string

Tên Tỉnh/Thành phố người nhận

ReceiverDistrictName*

string

Tên Quận/Huyện người nhận

ReceiverWardName

string

Tên Phường/Xã người nhận

RealWeight

number

Trọng lượng thực tế (kg)

Length

number

Chiều dài (cm)

Width

number

Chiều rộng (cm)

Height

number

Chiều cao (cm)

Quantity

number

Số lượng kiện

Note

string

Ghi chú

ServiceTypeID*

string

Mã dịch vụ

MailerType

string

Mã loại hàng hóa vận chuyển: HH - Hàng hóa. TL - Tài liệu.

CODAmount

number

Tiền thu người nhận

ExternalCode

string

Mã vận đơn khách hàng

ReferenceCode

string

Mã tham chiếu khách hàng

SpecialInstructionId

number

Mã ghi chú đặc biệt chỉ đối với đơn hàng COD: 1 - Cho xem hàng. 0 - Không cho xem hàng.

InformFee

string

Giá trị kê khai. Các trường hợp lưu ý khi kê khai: 1 - Trọng lượng tính giá >= 2.5kg bắt buộc chọn Loại hình = HH(hàng hóa) 2 - Loại hình = HH bắt buộc nhập giá trị kê khai 3 - Đơn chọn DVBH (Dịch vụ bảo hiểm) thì bắt buộc nhập giá trị kê khai.

ExtraServices

array

Danh sách các dịch vụ gia tăng

DirectSenderName

string

Người đi gửi Thư/Hàng

Items

array

Danh sách hàng hóa đồng kiểm:

{
    "No": 1, //Số thứ tự
    "ItemID": "ITEM1", //Mã hàng hóa
    "ItemName": "ITEMNAME", //Tên hàng hóa
    "UnitName": "", // Đơn vị tính
    "Qty": 3, // Số lượng
    "UnitPrice": 1200000, // Đơn giá(VNĐ)
    "Amount": 3600000, // Thành tiền
    "Notes": "Thiết bị điện tử", //Ghi chú về mặt hàng
    "Imeis": //Các số imei của từng mặt hàng cụ thể(nếu có truyền thông tin này sang thì sẽ đồng kiểm từng imei)
    [
        {
            "No": 1, // Số thứ tự
            "Imei": "AM0123456"// Số emei
        },
        {
            "No": 2,
            "Imei": "AM0123457"// Số emei
        }
    ]
}

ContactPhone

string

SĐT người liên hệ gửi hàng(bắt buộc khi KH có địa chỉ gửi không cố định)

ContactName

string

Tên người liên hệ gửi hàng(bắt buộc khi KH có địa chỉ gửi không cố định)

SenderAddress

string

Địa chỉ đầy đủ người gửi, bao gồm: số nhà, tên đường, tên xã, tên huyện, tên tỉnh. (bắt buộc khi KH có địa chỉ gửi không cố định)

CusWareHouseID

string

Mã kho/shop (Bắt buộc khi không truyền ClientHubID)

Packages

array

{
    "PackageID": "HD000003/1", //Mã kiện,
    "Length": 100, // Kích thước (Dài - bắt buộc khi có nhập Rộng, Cao)(cm),
    "Width": 50, // Kích thước (Rộng - bắt buộc khi có nhập Dài, Cao)(cm),
    "Height": 80,// Kích thước (Cao - Bắt buộc khi có nhập Dài, Rộng)(cm),
    "RealWeight": 25// Trọng lượng thực của kiện (kg)
}

(*)Số lượng Packages phải khớp với Quantity. Trường hợp Quantity = 1 thì Packages = []

COPAmt

number

Tiền COP (Cash on pickup)

Response

{
    "Errors": [],
    "ErrorCode": "0",
    "OrderInfo": {
        "OrderCode": "HD000003",
        "ReferenceCode": "HD000003",
        "ExternalCode": "HD000003",
        "TotalServiceCost": 44176,
        "ExtraServices": [
            {
                "ServiceName": "Chuyển phát nhanh",
                "ServiceID": "DE",
                "Cost": 16800
            },
            {
                "ServiceName": "Hàng đông lạnh",
                "ServiceID": "HDL",
                "Cost": 15000
            },
            {
                "ServiceName": "Báo phát",
                "ServiceID": "BP",
                "Cost": 5000
            },
            {
                "ServiceName": "Phí xăng dầu",
                "ServiceID": "Fuel",
                "Cost": 3360
            },
            {
                "ServiceName": "Phí VAT",
                "ServiceID": "VAT",
                "Cost": 4016
            }
        ],
        "DeliveryType": "1"
    },
    "ErrorMessage": ""
}

{
    "IsError": true,
    "ErrorMessage": "Bạn cần đăng nhập để truy cập chức năng này."
}

Name	Type	Description
Errors	array object	Mảng các lỗi trả về
ErrorCode	string	Mã lỗi
ErrorMessage	string	Thông báo lỗi
OrderInfo	object	Thông tin đơn hàng tạo thành công
OrderCode	string	Mã đơn hàng
ReferenceCode	string	Mã tham chiếu khách hàng
ExternalCode	string	Mã đơn hàng khách hàng
TotalServiceCost	number	Tổng phí
ExtraService	array object	Danh sách các dịch vụ của đơn hàng
ServiceName	string	Tên dịch vụ
ServiceID	string	Mã dịch vụ
Cost	number	Phí dịch vụ
DeliveryTimeType	string	Đơn vị thực hiện phát: "1" - 247 phát "2" - Bên thứ 3 phát

Name

Type

Description

Errors

array object

Mảng các lỗi trả về

ErrorCode

string

Mã lỗi

ErrorMessage

string

Thông báo lỗi

OrderInfo

object

Thông tin đơn hàng tạo thành công

OrderCode

string

Mã đơn hàng

ReferenceCode

string

Mã tham chiếu khách hàng

ExternalCode

string

Mã đơn hàng khách hàng

TotalServiceCost

number

Tổng phí

ExtraService

array object

Danh sách các dịch vụ của đơn hàng

ServiceName

string

Tên dịch vụ

ServiceID

string

Mã dịch vụ

Cost

number

Phí dịch vụ

DeliveryTimeType

string

Đơn vị thực hiện phát: "1" - 247 phát "2" - Bên thứ 3 phát

Mẫu ví dụ

{
   "OrderInfo":{
      "ClientHubID":11583,
      "CusWareHouseID":"30984",
      "ContactName": "Trần Văn B",
      "ContactPhone": "0332318317",
      "SenderAddress": "145/6C Trần Bá Giao, Phường 5, Gò Vấp, HCM",      
      "ReceiverPhone":"0345555777",
      "ReceiverName":"Trương Chí Nhân",
      "ReceiverAddress":"326 Võ Văn Kiệt, phường Cô Giang, Quận 1, Hồ Chí Minh, Việt Nam",
      "ReceiverProvinceName":"Hồ Chí Minh",
      "ReceiverDistrictName":"Quận 1",
      "ReceiverWardName":"Phường Cô Giang",   
      "RealWeight":1,
      "Length":0,
      "Width":0,
      "Height":0,
      "Quantity":2,
      "Packages" :[
         {
            "PackageID":"HD000003/1",
            "Length":25,
            "Width":30,
            "Height": 10,
            "RealWeight": 5 
         },
         {
            "PackageID":"HD000003/2",
            "Length":33,
            "Width":25,
            "Height": 12,
            "RealWeight": 8.7
         }
      ],
      "Note":"Tài liệu",
      "ServiceTypeID":"DE",
      "MailerType":"HH",
      "CODAmount":0,
      "ExternalCode":"HD000003",
      "ReferenceCode": "HD000003",
      "SpecialInstructionId":1,
      "InformFee":500000,
      "COPAmt" : 25000,
      "ExtraServices":[
         {
            "ServiceID":"PTN",
            "Type":2
         },
         {
            "ServiceID":"BP",
            "Type":2
         }
      ],
      "Items":[
         {
            "No":1,
            "ItemID":"IP11BLUE",
            "ItemName":"Mô hình Iphone 11 Blue",
            "UnitName":"CAI",
            "Qty":2,
            "UnitPrice":220000,
            "UnitPricePromo":220000,
            "Amount":440000,
            "Notes":"",
            "Imeis":[
               {
                  "No":1,
                  "Imei":"353344667789"
               },
               {
                  "No":2,
                  "Imei":"373344667788"
               }
            ]
         },
         {
            "No":2,
            "ItemID":"OPSAMSUNGS20",
            "ItemName":"Ốp Samsung Galaxy S20",
            "UnitName":"CAI",
            "Qty":2,
            "UnitPrice":30000,
            "UnitPricePromo":30000,
            "Amount":60000,
            "Notes":""
         }
      ]
   }
}

Thông tin mã lỗi

1: Thông tin Phường/Xã không chính xác
2: Thông tin Quận/Huyện không chính xác
3: Thông tin Tỉnh/Thành không chính xác
4: Trùng mã đơn hàng
5: Server error
6: Có lỗi xảy ra trong quá trình xử lý
9: Lỗi chưa cập nhật ghi chú đặc biệt
10: Lỗi chưa truyền dịch vụ
11: Địa chỉ gửi hàng không hợp lệ
12: Tài khoản khách hàng không hợp lệ
15: Chưa truyền mã đơn hàng
16: Đơn hàng không hợp lệ
17: Địa chỉ người nhận không hợp lệ
18: Mã loại hàng hóa vận chuyển không hợp lệ
19: Số lượng kiện không hợp lệ
20: Chi tiết kiện không hợp lệ
21: Thông tin người gửi chưa đầy đủ
25: Tiền COP không hợp lệ

PreviousTính giá NextTạo địa chỉ gửi hàng

Last updated 2 days ago