# Tạo bưu gửi

## Create Order

<mark style="color:green;">`POST`</mark> `http://ws.ems.com.vn/api/v1/orders/create-v2`

API tạo bưu gửi.

#### Path Parameters

| Name            | Type   | Description |
| --------------- | ------ | ----------- |
| merchant\_token | string | *`Token`*   |

#### Headers

| Name   | Type   | Description            |
| ------ | ------ | ---------------------- |
| Accept | string | application/javascript |

#### Request Body

| Name            | Type    | Description                                                                                                                                |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| order\_code     | string  | *`Mã đơn hàng của khách hàng`*                                                                                                             |
| inventory       | string  | *`Mã điểm lấy hàng (nếu có)`*                                                                                                              |
| inventory\_name | string  | *`Tên điểm lấy hàng (Nếu bạn ko có mã điểm gửi hàng thì hãy nhập thông tin này)`*                                                          |
| from\_name      | string  | *`Tên người lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                                      |
| from\_phone     | string  | *`Số điện thoại liên người lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                       |
| from\_province  | string  | *`Mã tỉnh/thành phố lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                              |
| from\_district  | string  | *`Mã quận/huyện lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                                  |
| from\_ward      | string  | *`Mã phường/xã lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                                   |
| from\_address   | string  | *`Địa chỉ lấy hàng (Nếu bạn không có mã điểm lấy hàng thì hãy nhập thông tin này)`*                                                        |
| to\_name        | string  | *`Tên người nhận hàng`*                                                                                                                    |
| to\_phone       | string  | *`Số điện thoại người nhận`*                                                                                                               |
| to\_province    | string  | *`Mã tỉnh/thành phố nhận`*                                                                                                                 |
| to\_district    | string  | *`Mã quận/huyện nhận`*                                                                                                                     |
| to\_ward        | string  | *`Mã phường/xã nhận`*                                                                                                                      |
| to\_address     | string  | *`Địa chỉ người nhận`*                                                                                                                     |
| to\_postal      | string  | *`Mã bưu chính nơi nhận (Nếu có)`*                                                                                                         |
| to\_longitude   | string  |                                                                                                                                            |
| to\_latitude    | string  |                                                                                                                                            |
| product\_name   | string  | *`Tên sản phẩm`*                                                                                                                           |
| total\_amount   | number  | *`Giá trị sản phẩm (vnđ)`*                                                                                                                 |
| total\_quantity | number  | *`Số lượng`*                                                                                                                               |
| total\_weight   | number  | *`Khối lượng (gram)`*                                                                                                                      |
| money\_collect  | number  | *`Tiền thu hộ (vnđ)`*                                                                                                                      |
| description     | string  | *`Mô tả sản phẩm`*                                                                                                                         |
| size            | string  | <p>\[<em><code>length</code></em>x<em><code>width</code></em>x<em><code>height</code></em>] <br><em><code>'20x30x40'  (cm)</code></em></p> |
| service         | number  | *`Mã dịch vụ (Danh mục -> Danh sách dịch vụ)`*                                                                                             |
| checked         | boolean | *`Cho người nhận xem hàng (True: Có, False: Không)`*                                                                                       |
| fragile         | string  | *`Hàng dễ vỡ (True: Có, False: Không)`*                                                                                                    |
| vas             | array   | <p><em><code>Dịch vụ cộng thêm (Danh mục -> Danh sách dịch vụ cộng thêm)</code></em><br><em><code>\['cod', 'ptt']</code></em><br></p>      |
| payment\_config | boolean | *`Người nhận trả cước vận chuyển (True: Có, False: Không)`*                                                                                |

{% tabs %}
{% tab title="200 " %}

```php
Thành công:
{
    'code': 'success',
    'message': 'Thành công',
    'data': [
        'tracking_code': [string],
        'courier_code': '',
        'status_code': [string],
        'fee': [
            'fee': [number], // cước chính
            'remote_fee': [number] // cước vùng xa
        ],
        'vas': [
            'total_vas': [number], // tổng cước dịch vụ cộng thêm
            'vas_detail': [
                [
                'code': [string], // mã dịch vụ cộng thêm
                'fee': [number] // cước dịch vụ cộng thêm
                ]
            ] // chi tiết cước dịch vụ cộng thêm
        ],
        'money_collect': [number]
    ]
}

Thất bại:
{
    'code': 'error',
    'message': '.....',
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docws.ems.com.vn/tieng-viet/buu-gui/tao-buu-gui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.