# 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 %}