# Sử dụng API Giao hàng Nhanh để tính giá cước vận chuyển (ok)

<figure><img src="https://2494213435-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LYjAG13rAPdbArSfRyB%2Fuploads%2FhK1Y4bL69kABPFERRCAY%2Fimage.png?alt=media&#x26;token=aa3707af-ba38-4c72-b0e1-f5c06f8072f4" alt=""><figcaption></figcaption></figure>

```
https://online-gateway.ghn.vn/shiip/public-api/master-data/province
token: 42d073a5-1f9c-11ed-8a70-52fa25d1292f-deletelionel
```

```json
{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "ProvinceID": 269,
            "ProvinceName": "Lào Cai",
            "CountryID": 1,
            "Code": "20",
            "NameExtension": [
                "Lào Cai",
                "Tỉnh Lào Cai",
                "T.Lào Cai",
                "T Lào Cai",
                "laocai"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891384 +0700 +07 m=+0.010448463",
            "UpdatedAt": "2019-12-05 15:41:26.891384 +0700 +07 m=+0.010449016",
            "AreaID": 1,
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "103.191.145.200",
            "UpdatedEmployee": 209749,
            "UpdatedSource": "internal",
            "UpdatedDate": "2024-06-19T10:40:21.091Z"
        },
        {
            "ProvinceID": 268,
            "ProvinceName": "Hưng Yên",
            "CountryID": 1,
            "Code": "321",
            "NameExtension": [
                "Hưng Yên",
                "Tỉnh Hưng Yên",
                "T.Hưng Yên",
                "T Hưng Yên",
                "hungyen"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.89138 +0700 +07 m=+0.010444468",
            "UpdatedAt": "2019-12-05 15:41:26.891383 +0700 +07 m=+0.010447473",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 267,
            "ProvinceName": "Hòa Bình",
            "CountryID": 1,
            "Code": "218",
            "NameExtension": [
                "Hòa Bình",
                "Tỉnh Hòa Bình",
                "T.Hòa Bình",
                "T Hòa Bình",
                "hoabinh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891378 +0700 +07 m=+0.010443042",
            "UpdatedAt": "2019-12-05 15:41:26.891379 +0700 +07 m=+0.010443604",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 266,
            "ProvinceName": "Sơn La",
            "CountryID": 1,
            "Code": "22",
            "NameExtension": [
                "Sơn La",
                "Tỉnh Sơn La",
                "T.Sơn La",
                "T Sơn La",
                "sonla"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891377 +0700 +07 m=+0.010441659",
            "UpdatedAt": "2019-12-05 15:41:26.891378 +0700 +07 m=+0.010442220",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 265,
            "ProvinceName": "Điện Biên",
            "CountryID": 1,
            "Code": "230",
            "NameExtension": [
                "Điện Biên",
                "Tỉnh Điện Biên",
                "T.Điện Biên",
                "T Điện Biên",
                "dienbien"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891376 +0700 +07 m=+0.010440285",
            "UpdatedAt": "2019-12-05 15:41:26.891376 +0700 +07 m=+0.010440840",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 264,
            "ProvinceName": "Lai Châu",
            "CountryID": 1,
            "Code": "231",
            "NameExtension": [
                "Lai Châu",
                "Tỉnh Lai Châu",
                "T.Lai Châu",
                "T Lai Châu",
                "laichau"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891374 +0700 +07 m=+0.010438850",
            "UpdatedAt": "2019-12-05 15:41:26.891375 +0700 +07 m=+0.010439440",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 263,
            "ProvinceName": "Yên Bái",
            "CountryID": 1,
            "Code": "29",
            "NameExtension": [
                "Yên Bái",
                "Tỉnh Yên Bái",
                "T.Yên Bái",
                "T Yên Bái",
                "yenbai"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891369 +0700 +07 m=+0.010433883",
            "UpdatedAt": "2019-12-05 15:41:26.89137 +0700 +07 m=+0.010434449",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 262,
            "ProvinceName": "Bình Định",
            "CountryID": 1,
            "Code": "56",
            "NameExtension": [
                "Bình Định",
                "Tỉnh Bình Định",
                "T.Bình Định",
                "T Bình Định",
                "binhdinh",
                "Binh Dinh",
                "binh dinh"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891368 +0700 +07 m=+0.010432542",
            "UpdatedAt": "2019-12-05 15:41:26.891368 +0700 +07 m=+0.010433091",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "35.247.155.234",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2021-12-14T01:46:02.443Z"
        },
        {
            "ProvinceID": 261,
            "ProvinceName": "Ninh Thuận",
            "CountryID": 1,
            "Code": "68",
            "NameExtension": [
                "Ninh Thuận",
                "Tỉnh Ninh Thuận",
                "T.Ninh Thuận",
                "T Ninh Thuận",
                "ninhthuan"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891367 +0700 +07 m=+0.010431149",
            "UpdatedAt": "2019-12-05 15:41:26.891367 +0700 +07 m=+0.010431707",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 260,
            "ProvinceName": "Phú Yên",
            "CountryID": 1,
            "Code": "57",
            "NameExtension": [
                "Phú Yên",
                "Tỉnh Phú Yên",
                "T.Phú Yên",
                "T Phú Yên",
                "phuyen"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891365 +0700 +07 m=+0.010429716",
            "UpdatedAt": "2019-12-05 15:41:26.891366 +0700 +07 m=+0.010430285",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 259,
            "ProvinceName": "Kon Tum",
            "CountryID": 1,
            "Code": "60",
            "NameExtension": [
                "Kon Tum",
                "Tỉnh Kon Tum",
                "T.Kon Tum",
                "T Kon Tum",
                "kontum",
                "contum"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891364 +0700 +07 m=+0.010428268",
            "UpdatedAt": "2019-12-05 15:41:26.891364 +0700 +07 m=+0.010428815",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 258,
            "ProvinceName": "Bình Thuận",
            "CountryID": 1,
            "Code": "62",
            "NameExtension": [
                "Bình Thuận",
                "Tỉnh Bình Thuận",
                "T.Bình Thuận",
                "T Bình Thuận",
                "binhthuan"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891362 +0700 +07 m=+0.010426889",
            "UpdatedAt": "2019-12-05 15:41:26.891363 +0700 +07 m=+0.010427426",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 253,
            "ProvinceName": "Bạc Liêu",
            "CountryID": 1,
            "Code": "781",
            "NameExtension": [
                "Bạc Liêu",
                "Tỉnh Bạc Liêu",
                "T.Bạc Liêu",
                "T Bạc Liêu",
                "baclieu"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891359 +0700 +07 m=+0.010424038",
            "UpdatedAt": "2019-12-05 15:41:26.89136 +0700 +07 m=+0.010424597",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 252,
            "ProvinceName": "Cà Mau",
            "CountryID": 1,
            "Code": "780",
            "NameExtension": [
                "Cà Mau",
                "Tỉnh Cà Mau",
                "T.Cà Mau",
                "T Cà Mau",
                "camau"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891358 +0700 +07 m=+0.010422541",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 250,
            "ProvinceName": "Hậu Giang",
            "CountryID": 1,
            "Code": "711",
            "NameExtension": [
                "Hậu Giang",
                "Tỉnh Hậu Giang",
                "T.Hậu Giang",
                "T Hậu Giang",
                "haugiang"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718500,
            "CreatedAt": "2019-12-05 15:41:26.891356 +0700 +07 m=+0.010421054",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 249,
            "ProvinceName": "Bắc Ninh",
            "CountryID": 1,
            "Code": "241",
            "NameExtension": [
                "Bắc Ninh",
                "Tỉnh Bắc Ninh",
                "T.Bắc Ninh",
                "T Bắc Ninh",
                "bacninh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891355 +0700 +07 m=+0.010419696",
            "UpdatedAt": "2019-12-05 15:41:26.891356 +0700 +07 m=+0.010420252",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 248,
            "ProvinceName": "Bắc Giang",
            "CountryID": 1,
            "Code": "240",
            "NameExtension": [
                "Bắc Giang",
                "Tỉnh Bắc Giang",
                "T.Bắc Giang",
                "T Bắc Giang",
                "bacgiang"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891354 +0700 +07 m=+0.010418324",
            "UpdatedAt": "2019-12-05 15:41:26.891354 +0700 +07 m=+0.010418877",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 247,
            "ProvinceName": "Lạng Sơn",
            "CountryID": 1,
            "Code": "25",
            "NameExtension": [
                "Lạng Sơn",
                "Tỉnh Lạng Sơn",
                "T.Lạng Sơn",
                "T Lạng Sơn",
                "langson"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891352 +0700 +07 m=+0.010416972",
            "UpdatedAt": "2019-12-05 15:41:26.891353 +0700 +07 m=+0.010417531",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 246,
            "ProvinceName": "Cao Bằng",
            "CountryID": 1,
            "Code": "26",
            "NameExtension": [
                "Cao Bằng",
                "Tỉnh Cao Bằng",
                "T.Cao Bằng",
                "T Cao Bằng",
                "caobang"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891351 +0700 +07 m=+0.010415552",
            "UpdatedAt": "2019-12-05 15:41:26.891351 +0700 +07 m=+0.010416110",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 245,
            "ProvinceName": "Bắc Kạn",
            "CountryID": 1,
            "Code": "281",
            "NameExtension": [
                "Bắc Kạn",
                "Tỉnh Bắc Kạn",
                "T.Bắc Kạn",
                "T Bắc Kạn",
                "backan",
                "baccan"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.89135 +0700 +07 m=+0.010414153",
            "UpdatedAt": "2019-12-05 15:41:26.89135 +0700 +07 m=+0.010414725",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 244,
            "ProvinceName": "Thái Nguyên",
            "CountryID": 1,
            "Code": "280",
            "NameExtension": [
                "Thái Nguyên",
                "Tỉnh Thái Nguyên",
                "T.Thái Nguyên",
                "T Thái Nguyên",
                "thainguyen"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891348 +0700 +07 m=+0.010412755",
            "UpdatedAt": "2019-12-05 15:41:26.891349 +0700 +07 m=+0.010413345",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 243,
            "ProvinceName": "Quảng Nam",
            "CountryID": 1,
            "Code": "510",
            "NameExtension": [
                "Quảng Nam",
                "Tỉnh Quảng Nam",
                "T.Quảng Nam",
                "T Quảng Nam",
                "quangnam"
            ],
            "IsEnable": 1,
            "RegionID": 5,
            "RegionCPN": 3,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891346 +0700 +07 m=+0.010410982",
            "UpdatedAt": "2019-12-05 15:41:26.891347 +0700 +07 m=+0.010411789",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 242,
            "ProvinceName": "Quảng Ngãi",
            "CountryID": 1,
            "Code": "55",
            "NameExtension": [
                "Quảng Ngãi",
                "Tỉnh Quảng Ngãi",
                "T.Quảng Ngãi",
                "T Quảng Ngãi",
                "quangngai"
            ],
            "IsEnable": 1,
            "RegionID": 5,
            "RegionCPN": 3,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891344 +0700 +07 m=+0.010408521",
            "UpdatedAt": "2019-12-05 15:41:26.891345 +0700 +07 m=+0.010409541",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 241,
            "ProvinceName": "Đắk Nông",
            "CountryID": 1,
            "Code": "501",
            "NameExtension": [
                "Đắk Nông",
                "Tỉnh Đắk Nông",
                "T.Đắk Nông",
                "T Đắk Nông",
                "Đăk Nông",
                "daknong",
                "dacnong",
                "dak nong"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891342 +0700 +07 m=+0.010406889",
            "UpdatedAt": "2019-12-05 15:41:26.891343 +0700 +07 m=+0.010407449",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "35.247.155.234",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2021-12-14T01:45:00.798Z"
        },
        {
            "ProvinceID": 240,
            "ProvinceName": "Tây Ninh",
            "CountryID": 1,
            "Code": "66",
            "NameExtension": [
                "Tây Ninh",
                "Tỉnh Tây Ninh",
                "T.Tây Ninh",
                "T Tây Ninh",
                "tayninh"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891341 +0700 +07 m=+0.010405469",
            "UpdatedAt": "2019-12-05 15:41:26.891341 +0700 +07 m=+0.010406037",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 239,
            "ProvinceName": "Bình Phước",
            "CountryID": 1,
            "Code": "651",
            "NameExtension": [
                "Bình Phước",
                "Tỉnh Bình Phước",
                "T.Bình Phước",
                "T Bình Phước",
                "binhphuoc"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891339 +0700 +07 m=+0.010404045",
            "UpdatedAt": "2019-12-05 15:41:26.89134 +0700 +07 m=+0.010404628",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 238,
            "ProvinceName": "Quảng Trị",
            "CountryID": 1,
            "Code": "53",
            "NameExtension": [
                "Quảng Trị",
                "Tỉnh Quảng Trị",
                "T.Quảng Trị",
                "T Quảng Trị",
                "quangtri"
            ],
            "IsEnable": 1,
            "RegionID": 5,
            "RegionCPN": 3,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891336 +0700 +07 m=+0.010400845",
            "UpdatedAt": "2019-12-05 15:41:26.891337 +0700 +07 m=+0.010401479",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 237,
            "ProvinceName": "Quảng Bình",
            "CountryID": 1,
            "Code": "52",
            "NameExtension": [
                "Quảng Bình",
                "Tỉnh Quảng Bình",
                "T.Quảng Bình",
                "T Quảng Bình",
                "quangbinh"
            ],
            "IsEnable": 1,
            "RegionID": 5,
            "RegionCPN": 3,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.89133 +0700 +07 m=+0.010394677",
            "UpdatedAt": "2019-12-05 15:41:26.891331 +0700 +07 m=+0.010395288",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 236,
            "ProvinceName": "Hà Tĩnh",
            "CountryID": 1,
            "Code": "39",
            "NameExtension": [
                "Hà Tĩnh",
                "Tỉnh Hà Tĩnh",
                "T.Hà Tĩnh",
                "T Hà Tĩnh",
                "hatinh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891329 +0700 +07 m=+0.010393259",
            "UpdatedAt": "2019-12-05 15:41:26.891329 +0700 +07 m=+0.010393837",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 235,
            "ProvinceName": "Nghệ An",
            "CountryID": 1,
            "Code": "38",
            "NameExtension": [
                "Nghệ An",
                "Tỉnh Nghệ An",
                "T.Nghệ An",
                "T Nghệ An",
                "nghean"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891327 +0700 +07 m=+0.010391805",
            "UpdatedAt": "2019-12-05 15:41:26.891328 +0700 +07 m=+0.010392390",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 234,
            "ProvinceName": "Thanh Hóa",
            "CountryID": 1,
            "Code": "37",
            "NameExtension": [
                "Thanh Hóa",
                "Tỉnh Thanh Hóa",
                "T.Thanh Hóa",
                "T Thanh Hóa",
                "thanhhoa"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891325 +0700 +07 m=+0.010390100",
            "UpdatedAt": "2019-12-05 15:41:26.891326 +0700 +07 m=+0.010390825",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 233,
            "ProvinceName": "Ninh Bình",
            "CountryID": 1,
            "Code": "30",
            "NameExtension": [
                "Ninh Bình",
                "Tỉnh Ninh Bình",
                "T.Ninh Bình",
                "T Ninh Bình",
                "ninhbinh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891323 +0700 +07 m=+0.010387239",
            "UpdatedAt": "2019-12-05 15:41:26.891324 +0700 +07 m=+0.010388515",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 232,
            "ProvinceName": "Hà Nam",
            "CountryID": 1,
            "Code": "351",
            "NameExtension": [
                "Hà Nam",
                "Tỉnh Hà Nam",
                "T.Hà Nam",
                "T Hà Nam",
                "hanam"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891307 +0700 +07 m=+0.010371600",
            "UpdatedAt": "2019-12-05 15:41:26.891317 +0700 +07 m=+0.010382159",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 231,
            "ProvinceName": "Nam Định",
            "CountryID": 1,
            "Code": "350",
            "NameExtension": [
                "Nam Định",
                "Tỉnh Nam Định",
                "T.Nam Định",
                "T Nam Định",
                "namdinh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891304 +0700 +07 m=+0.010368963",
            "UpdatedAt": "2019-12-05 15:41:26.891305 +0700 +07 m=+0.010369968",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 230,
            "ProvinceName": "Quảng Ninh",
            "CountryID": 1,
            "Code": "33",
            "NameExtension": [
                "Quảng Ninh",
                "Tỉnh Quảng Ninh",
                "T.Quảng Ninh",
                "T Quảng Ninh",
                "quangninh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.8913 +0700 +07 m=+0.010364176",
            "UpdatedAt": "2019-12-05 15:41:26.8913 +0700 +07 m=+0.010365128",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 229,
            "ProvinceName": "Phú Thọ",
            "CountryID": 1,
            "Code": "210",
            "NameExtension": [
                "Phú Thọ",
                "Tỉnh Phú Thọ",
                "T.Phú Thọ",
                "T Phú Thọ",
                "phutho"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891297 +0700 +07 m=+0.010361666",
            "UpdatedAt": "2019-12-05 15:41:26.891298 +0700 +07 m=+0.010362667",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 228,
            "ProvinceName": "Tuyên Quang",
            "CountryID": 1,
            "Code": "27",
            "NameExtension": [
                "Tuyên Quang",
                "Tỉnh Tuyên Quang",
                "T.Tuyên Quang",
                "T Tuyên Quang",
                "tuyenquang"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891294 +0700 +07 m=+0.010359059",
            "UpdatedAt": "2019-12-05 15:41:26.891295 +0700 +07 m=+0.010360123",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 227,
            "ProvinceName": "Hà Giang",
            "CountryID": 1,
            "Code": "219",
            "NameExtension": [
                "Hà Giang",
                "Tỉnh Hà Giang",
                "T.Hà Giang",
                "T Hà Giang",
                "hagiang"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 5,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891292 +0700 +07 m=+0.010356434",
            "UpdatedAt": "2019-12-05 15:41:26.891293 +0700 +07 m=+0.010357495",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 226,
            "ProvinceName": "Thái Bình",
            "CountryID": 1,
            "Code": "36",
            "NameExtension": [
                "Thái Bình",
                "Tỉnh Thái Bình",
                "T.Thái Bình",
                "T Thái Bình",
                "thaibinh"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891289 +0700 +07 m=+0.010353730",
            "UpdatedAt": "2019-12-05 15:41:26.89129 +0700 +07 m=+0.010354792",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 225,
            "ProvinceName": "Hải Dương",
            "CountryID": 1,
            "Code": "320",
            "NameExtension": [
                "Hải Dương",
                "Tỉnh Hải Dương",
                "T.Hải Dương",
                "T Hải Dương",
                "haiduong"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891286 +0700 +07 m=+0.010350972",
            "UpdatedAt": "2019-12-05 15:41:26.891287 +0700 +07 m=+0.010351969",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 224,
            "ProvinceName": "Hải Phòng",
            "CountryID": 1,
            "Code": "31",
            "NameExtension": [
                "Hải Phòng",
                "TP.Hải Phòng",
                "TP. Hải Phòng",
                "TP Hải Phòng",
                "Thành phố Hải Phòng",
                "haiphong"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891281 +0700 +07 m=+0.010346052",
            "UpdatedAt": "2019-12-05 15:41:26.891282 +0700 +07 m=+0.010347093",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 223,
            "ProvinceName": "Thừa Thiên Huế",
            "CountryID": 1,
            "Code": "54",
            "NameExtension": [
                "Thừa Thiên Huế",
                "Thừa Thiên - Huế",
                "Tỉnh Thừa Thiên - Huế",
                "T.Thừa Thiên - Huế",
                "T Thừa Thiên - Huế",
                "hue",
                "thuathienhue",
                "Tỉnh Thừa Thiên Huế"
            ],
            "IsEnable": 1,
            "RegionID": 5,
            "RegionCPN": 3,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891279 +0700 +07 m=+0.010343391",
            "UpdatedAt": "2019-12-05 15:41:26.89128 +0700 +07 m=+0.010344321",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "103.191.145.200",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2024-01-09T07:06:28.897Z"
        },
        {
            "ProvinceID": 221,
            "ProvinceName": "Vĩnh Phúc",
            "CountryID": 1,
            "Code": "211",
            "NameExtension": [
                "Vĩnh Phúc",
                "Tỉnh Vĩnh Phúc",
                "T.Vĩnh Phúc",
                "T Vĩnh Phúc",
                "vinhphuc"
            ],
            "IsEnable": 1,
            "RegionID": 6,
            "RegionCPN": 4,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891276 +0700 +07 m=+0.010341021",
            "UpdatedAt": "2019-12-05 15:41:26.891277 +0700 +07 m=+0.010341955",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 220,
            "ProvinceName": "Cần Thơ",
            "CountryID": 1,
            "Code": "710",
            "NameExtension": [
                "Cần Thơ",
                "TP.Cần Thơ",
                "TP. Cần Thơ",
                "TP Cần Thơ",
                "Thành phố Cần Thơ",
                "cantho"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891274 +0700 +07 m=+0.010338564",
            "UpdatedAt": "2019-12-05 15:41:26.891275 +0700 +07 m=+0.010339570",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 219,
            "ProvinceName": "Kiên Giang",
            "CountryID": 1,
            "Code": "77",
            "NameExtension": [
                "Kiên Giang",
                "Tỉnh Kiên Giang",
                "T.Kiên Giang",
                "T Kiên Giang",
                "kiengiang"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891271 +0700 +07 m=+0.010335801",
            "UpdatedAt": "2019-12-05 15:41:26.891272 +0700 +07 m=+0.010336808",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 218,
            "ProvinceName": "Sóc Trăng",
            "CountryID": 1,
            "Code": "79",
            "NameExtension": [
                "Sóc Trăng",
                "Tỉnh Sóc Trăng",
                "T.Sóc Trăng",
                "T Sóc Trăng",
                "soctrang"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891266 +0700 +07 m=+0.010330445",
            "UpdatedAt": "2019-12-05 15:41:26.891267 +0700 +07 m=+0.010331390",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 217,
            "ProvinceName": "An Giang",
            "CountryID": 1,
            "Code": "76",
            "NameExtension": [
                "An Giang",
                "Tỉnh An Giang",
                "T.An Giang",
                "T An Giang",
                "angiang"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891261 +0700 +07 m=+0.010325439",
            "UpdatedAt": "2019-12-05 15:41:26.891262 +0700 +07 m=+0.010326449",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 216,
            "ProvinceName": "Đồng Tháp",
            "CountryID": 1,
            "Code": "67",
            "NameExtension": [
                "Đồng Tháp",
                "Tỉnh Đồng Tháp",
                "T.Đồng Tháp",
                "T Đồng Tháp",
                "dongthap"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891258 +0700 +07 m=+0.010322799",
            "UpdatedAt": "2019-12-05 15:41:26.891259 +0700 +07 m=+0.010323710",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 215,
            "ProvinceName": "Vĩnh Long",
            "CountryID": 1,
            "Code": "70",
            "NameExtension": [
                "Vĩnh Long",
                "Tỉnh Vĩnh Long",
                "T.Vĩnh Long",
                "T Vĩnh Long",
                "vinhlong"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891255 +0700 +07 m=+0.010320049",
            "UpdatedAt": "2019-12-05 15:41:26.891256 +0700 +07 m=+0.010321117",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 214,
            "ProvinceName": "Trà Vinh",
            "CountryID": 1,
            "Code": "74",
            "NameExtension": [
                "Trà Vinh",
                "Tỉnh Trà Vinh",
                "T.Trà Vinh",
                "T Trà Vinh",
                "travinh"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891253 +0700 +07 m=+0.010317269",
            "UpdatedAt": "2019-12-05 15:41:26.891254 +0700 +07 m=+0.010318328",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 213,
            "ProvinceName": "Bến Tre",
            "CountryID": 1,
            "Code": "75",
            "NameExtension": [
                "Bến Tre",
                "Tỉnh Bến Tre",
                "T.Bến Tre",
                "T Bến Tre",
                "bentre"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.89125 +0700 +07 m=+0.010314751",
            "UpdatedAt": "2019-12-05 15:41:26.891251 +0700 +07 m=+0.010315735",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 212,
            "ProvinceName": "Tiền Giang",
            "CountryID": 1,
            "Code": "73",
            "NameExtension": [
                "Tiền Giang",
                "Tỉnh Tiền Giang",
                "T.Tiền Giang",
                "T Tiền Giang",
                "tiengiang"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891248 +0700 +07 m=+0.010312275",
            "UpdatedAt": "2019-12-05 15:41:26.891249 +0700 +07 m=+0.010313220",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 211,
            "ProvinceName": "Long An",
            "CountryID": 1,
            "Code": "72",
            "NameExtension": [
                "Long An",
                "Tỉnh Long An",
                "T.Long An",
                "T Long An",
                "longan"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891245 +0700 +07 m=+0.010309861",
            "UpdatedAt": "2019-12-05 15:41:26.891246 +0700 +07 m=+0.010310907",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 210,
            "ProvinceName": "Đắk Lắk",
            "CountryID": 1,
            "Code": "500",
            "NameExtension": [
                "Đắk Lắk",
                "Tỉnh Đắk Lắk",
                "T.Đắk Lắk",
                "T Đắk Lắk",
                "Đăk Lăk",
                "daklak",
                "daclac",
                "daklac",
                "daclak"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.89124 +0700 +07 m=+0.010304970",
            "UpdatedAt": "2019-12-05 15:41:26.891241 +0700 +07 m=+0.010306014",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "203.205.29.215",
            "UpdatedEmployee": 1718600,
            "UpdatedSource": "internal",
            "UpdatedDate": "2020-09-28T06:49:13.2Z"
        },
        {
            "ProvinceID": 209,
            "ProvinceName": "Lâm Đồng",
            "CountryID": 1,
            "Code": "63",
            "NameExtension": [
                "Lâm Đồng",
                "Tỉnh Lâm Đồng",
                "T.Lâm Đồng",
                "T Lâm Đồng",
                "lamdong"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891237 +0700 +07 m=+0.010301841",
            "UpdatedAt": "2019-12-05 15:41:26.891238 +0700 +07 m=+0.010302884",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 208,
            "ProvinceName": "Khánh Hòa",
            "CountryID": 1,
            "Code": "58",
            "NameExtension": [
                "Khánh Hòa",
                "Tỉnh Khánh Hòa",
                "T.Khánh Hòa",
                "T Khánh Hòa",
                "khanhhoa"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891235 +0700 +07 m=+0.010299210",
            "UpdatedAt": "2019-12-05 15:41:26.891236 +0700 +07 m=+0.010300275",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 207,
            "ProvinceName": "Gia Lai",
            "CountryID": 1,
            "Code": "59",
            "NameExtension": [
                "Gia Lai",
                "Tỉnh Gia Lai",
                "T.Gia Lai",
                "T Gia Lai",
                "gialai"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 2,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891232 +0700 +07 m=+0.010296656",
            "UpdatedAt": "2019-12-05 15:41:26.891233 +0700 +07 m=+0.010297610",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 206,
            "ProvinceName": "Bà Rịa - Vũng Tàu",
            "CountryID": 1,
            "Code": "64",
            "NameExtension": [
                "Bà Rịa - Vũng Tàu",
                "Tỉnh Bà Rịa - Vũng Tàu",
                "T.Bà Rịa - Vũng Tàu",
                "T Bà Rịa - Vũng Tàu",
                "Bà Rịa Vũng Tàu",
                "bariavungtau",
                "vungtau",
                "Bà Rịa-Vũng Tàu",
                "bà rịa-vũng tàu"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891229 +0700 +07 m=+0.010294114",
            "UpdatedAt": "2019-12-05 15:41:26.89123 +0700 +07 m=+0.010295059",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "35.247.155.234",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2021-12-14T01:44:12.178Z"
        },
        {
            "ProvinceID": 205,
            "ProvinceName": "Bình Dương",
            "CountryID": 1,
            "Code": "65",
            "NameExtension": [
                "Bình Dương",
                "Tỉnh Bình Dương",
                "T.Bình Dương",
                "T Bình Dương",
                "binhduong"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891226 +0700 +07 m=+0.010290886",
            "UpdatedAt": "2019-12-05 15:41:26.891227 +0700 +07 m=+0.010291916",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 204,
            "ProvinceName": "Đồng Nai",
            "CountryID": 1,
            "Code": "61",
            "NameExtension": [
                "Đồng Nai",
                "Tỉnh Đồng Nai",
                "T.Đồng Nai",
                "T Đồng Nai",
                "dongnai"
            ],
            "IsEnable": 1,
            "RegionID": 4,
            "RegionCPN": 1,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891224 +0700 +07 m=+0.010288345",
            "UpdatedAt": "2019-12-05 15:41:26.891225 +0700 +07 m=+0.010289304",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 203,
            "ProvinceName": "Đà Nẵng",
            "CountryID": 1,
            "Code": "511",
            "NameExtension": [
                "Đà Nẵng",
                "TP.Đà Nẵng",
                "TP. Đà Nẵng",
                "TP Đà Nẵng",
                "Thành phố Đà Nẵng",
                "danang",
                "DN"
            ],
            "IsEnable": 1,
            "RegionID": 3,
            "RegionCPN": 7,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891221 +0700 +07 m=+0.010285232",
            "UpdatedAt": "2019-12-05 15:41:26.891222 +0700 +07 m=+0.010286279",
            "CanUpdateCOD": false,
            "Status": 1
        },
        {
            "ProvinceID": 202,
            "ProvinceName": "Hồ Chí Minh",
            "CountryID": 1,
            "Code": "8",
            "NameExtension": [
                "Hồ Chí Minh",
                "TP.Hồ Chí Minh",
                "TP. Hồ Chí Minh",
                "TP Hồ Chí Minh",
                "Thành phố Hồ Chí Minh",
                "HCM",
                "hochiminh",
                "saigon",
                "sg",
                "Ho Chi Minh",
                "ho chi minh"
            ],
            "IsEnable": 1,
            "RegionID": 1,
            "RegionCPN": 6,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891217 +0700 +07 m=+0.010281821",
            "UpdatedAt": "2019-12-05 15:41:26.891218 +0700 +07 m=+0.010283065",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "35.247.155.234",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2021-12-13T10:08:17.434Z"
        },
        {
            "ProvinceID": 201,
            "ProvinceName": "Hà Nội",
            "CountryID": 1,
            "Code": "4",
            "NameExtension": [
                "Hà Nội",
                "TP.Hà Nội",
                "TP. Hà Nội",
                "TP Hà Nội",
                "Thành phố Hà Nội",
                "hanoi",
                "HN",
                "ha noi"
            ],
            "IsEnable": 1,
            "RegionID": 2,
            "RegionCPN": 8,
            "UpdatedBy": 1718600,
            "CreatedAt": "2019-12-05 15:41:26.891201 +0700 +07 m=+0.010266021",
            "UpdatedAt": "2019-12-05 15:41:26.891214 +0700 +07 m=+0.010278804",
            "CanUpdateCOD": false,
            "Status": 1,
            "UpdatedIP": "35.247.155.234",
            "UpdatedEmployee": 242614,
            "UpdatedSource": "internal",
            "UpdatedDate": "2021-12-14T01:45:29.556Z"
        }
    ]
}
```

Nếu ai đang phát triển một trang web liên quan đến việc vận chuyển sản phẩm như mua bán hàng online, chắc hẳn sẽ phải tích hợp API của các dịch vụ giao hàng như Giao hàng Nhanh, Viettel Post,...

Trong bài này, mình xin hướng dẫn cách sử dụng API của Giao hàng Nhanh để tính phí vận chuyển hàng hóa.

## 1. Tạo tài khoản <a href="#id-1-tao-tai-khoan-0" id="id-1-tao-tai-khoan-0"></a>

Để có thể sử dụng được API, chúng ta cần có tài khoản của GHN để lấy user token.

* B1: Truy cập vào link sau để đăng ký tài khoản: [https://sso.ghn.vn/register](https://sso.ghn.vn/register)
* B2: Sau khi đăng nhập thành công, bấm vào tên mình ở góc trên bên trái màn hình để xem thông tin cá nhân.![](https://images.viblo.asia/dbbf23d8-104b-4c85-84c9-7a56566d5a6b.png)
* B3: Tại ô Token API, nhấn Xem để lấy Token.![](https://images.viblo.asia/150e44be-82fe-42df-9f9f-6d27c31b5f8e.png)

## 2. API lấy thông tin địa chỉ giao hàng <a href="#id-2-api-lay-thong-tin-dia-chi-giao-hang-1" id="id-2-api-lay-thong-tin-dia-chi-giao-hang-1"></a>

Để có thể tính toán được chi phí vận chuyển, chúng ta cần phải có input là Quận huyện, Phường xã nơi lấy hàng và nơi nhận hàng.

Để lấy được dữ liệu về tất cả Tỉnh thành phố, Quận huyện, Phường xã của Việt Nam, chúng ta làm như sau:

### 2.1. API lấy thông tin Tỉnh, Thành Phố <a href="#id-21-api-lay-thong-tin-tinh-thanh-pho-2" id="id-21-api-lay-thong-tin-tinh-thanh-pho-2"></a>

* Method: GET/POST
* API: [https://online-gateway.ghn.vn/shiip/public-api/master-data/province](https://online-gateway.ghn.vn/shiip/public-api/master-data/province)
* Header: token

Sau đây mình sẽ gọi thử API này bằng Postman.![](https://images.viblo.asia/f8a2e8c0-fb52-4441-848c-4b21e1348cff.png)Copy token vừa lấy được ở phần 1, cho vào Headers. Kết quả trả về thành công sẽ như trong hình.

### 2.2. API lấy thông tin Quận, Huyện <a href="#id-22-api-lay-thong-tin-quan-huyen-3" id="id-22-api-lay-thong-tin-quan-huyen-3"></a>

Để lấy thông tin Quận/Huyện của một Tỉnh/ Thành phố nào đó, ta dùng API sau:

* API: [https://online-gateway.ghn.vn/shiip/public-api/master-data/district](https://online-gateway.ghn.vn/shiip/public-api/master-data/district)
* Method: GET/POST
* Header: token
* Param: province\_id (int - ID của tỉnh/thành phố vừa lấy được bên trên.)

Ví dụ mình lấy danh sách các quận thuộc thành phố Hà Nội:

Vì thành phố Hà Nội có province\_id là 201 nên mình sẽ truyền param province\_id=201 dưới dạng json vào Body. Kết quả trả về thành công sẽ như sau:![](https://images.viblo.asia/c7a43ff3-9e49-4e98-9fc1-a77e3a5b5e00.png)

### 2.3. API lấy thông tin Phường, Xã <a href="#id-23-api-lay-thong-tin-phuong-xa-4" id="id-23-api-lay-thong-tin-phuong-xa-4"></a>

API này tương tự như API lấy thông tin Quận, Huyện.

* API: [https://online-gateway.ghn.vn/shiip/public-api/master-data/ward](https://online-gateway.ghn.vn/shiip/public-api/master-data/ward)
* Method: GET/POST
* Header: token
* Param: district\_id (int - ID của quận/huyện vừa lấy được bên trên.)

Ví dụ mình lấy danh sách các phường thuộc quận Hà Đông (district\_id = 1542)![](https://images.viblo.asia/b686653d-b55a-4a8c-9013-3d9588c328a9.png)

## 3. API lấy thông tin gói dịch vụ <a href="#id-3-api-lay-thong-tin-goi-dich-vu-5" id="id-3-api-lay-thong-tin-goi-dich-vu-5"></a>

Việc giao hàng từ vị trí A đến vị trí B sẽ có nhiều cách thức khác nhau như: giao hàng bằng đường bộ, đường hàng không, tàu thủy,... Mỗi phương thức giao hàng sẽ có giá cước khác nhau, nên đây cũng sẽ là input cho API tính cước phí giao hàng.

Để lấy các phương thức giao hàng khả dụng, ta dùng API sau:

* API: [https://online-gateway.ghn.vn/shiip/public-api/v2/shipping-order/available-services](https://online-gateway.ghn.vn/shiip/public-api/v2/shipping-order/available-services)
* Method: GET/POST
* Header: token
* Param:
  * shop\_id: int - ID của shop
  * from\_district: int - ID của quận/huyện người gửi
  * to\_district: int - ID của quận/huyện người nhận

Cách lấy shop\_id sẽ nằm trong màn Quản lý cửa hàng.![](https://images.viblo.asia/8e2eee94-abde-4a2e-a409-2867916f2a3f.png)Ví dụ mình lấy gói dịch vụ khả dụng khi chuyển hàng từ quận Hà Đông (id: 1542) đến quận 1 - TP Hồ Chí Minh (id: 1442):![](https://images.viblo.asia/c425f5a5-c2cf-4c80-9b4e-bb0992bc191c.png)Kết quả trả về cho thấy có 2 gói khả dụng, đó là vận chuyển theo đường hàng không và theo đường bộ.

## 4. API tính giá cước vận chuyển <a href="#id-4-api-tinh-gia-cuoc-van-chuyen-6" id="id-4-api-tinh-gia-cuoc-van-chuyen-6"></a>

Cuối cùng cũng đến API tính giá cước ![😄](https://twemoji.maxcdn.com/v/14.0.2/72x72/1f604.png)

* API: [https://online-gateway.ghn.vn/shiip/public-api/v2/shipping-order/fee](https://online-gateway.ghn.vn/shiip/public-api/v2/shipping-order/fee)
* Method: GET/POST
* Header: token, shop\_id
* Param:
  * service\_id hoặc service\_type\_id:
    * service\_id: int - ID của gói dịch vụ mà bạn chọn (lấy được ở phần 3)
    * service\_type\_id: Nếu không điền service\_id, có thể thay thế bằng 1 trong 3 lựa chọn sau: 1: Express, 2: Standard, 3: Saving
  * insurance\_value: int - giá trị của sản phẩn. GHN căn cứ vào giá trị này để tính tiền bảo hiểm cho hàng hóa.
  * coupon: String - Mã giảm giá của GHN. Nếu không có, để rỗng: "" hoặc null
  * to\_ward\_code: String - ID Phường/ Xã người nhận
  * to\_district\_id: int - ID Quận/Huyện người nhận
  * from\_district\_id: int - ID Quận/Huyện người gửi
  * weight: int - trọng lượng hàng hóa (gram)
  * length: int - Chiều dài (cm)
  * width: int - Chiều rộng (cm)
  * height: int - Chiều cao (cm)

Ví dụ, mình sẽ tính phí vận chuyển với thông tin vận chuyển như sau:

```json
{
    "service_id":53321,
    "insurance_value":500000,
    "coupon": null,
    "from_district_id":1542,
    "to_district_id":1444,
    "to_ward_code":"20314",
    "height":15,
    "length":15,
    "weight":1000,
    "width":15
}
```

Gọi API với params truyền vào như trên, ta được kết quả như sau:

```json
{
    "code": 200,
    "message": "Success",
    "data": {
        "total": 37000,
        "service_fee": 37000,
        "insurance_fee": 0,
        "pick_station_fee": 0,
        "coupon_value": 0,
        "r2s_fee": 0
    }
}
```

Vậy tổng giá cước khi vận chuyển một kiện hàng có kích thước 15x15x15cm, nặng 1kg từ Hà Đông (Hà Nội) đi Quận 1 (TP Hồ Chí Minh) là 37000đ.

## 5. Kết <a href="#id-5-ket-7" id="id-5-ket-7"></a>

Trên đây, mình đã hướng dẫn cách sử dụng API của GHN để tính giá cước vận chuyển. Ngoài ra còn những API khác cũng rất quan trọng như tính thời gian vận chuyển, tạo đơn hàng,.... thì mời các bạn xem thêm trong doc của GHN: [https://api.ghn.vn/home/docs/detail](https://api.ghn.vn/home/docs/detail), cách làm cũng tương tự như trên.

Cảm ơn các bạn đã theo dõi

## 6. Tài liệu tham khảo <a href="#id-6-tai-lieu-tham-khao-8" id="id-6-tai-lieu-tham-khao-8"></a>

* [https://api.ghn.vn/home/docs/detail](https://api.ghn.vn/home/docs/detail)
* [https://www.youtube.com/watch?v=ha-HzsYPWDU](https://www.youtube.com/watch?v=ha-HzsYPWDU)
