# 物流

{% openapi src="<https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2Fmb4kbdEp0o8kz7esQkmQ%2FopenApi_sign_book.json?alt=media&token=3d1b62b9-c3c0-41ab-b34d-d679df782126>" path="/openApi/V2022-03/logistics" method="post" %}
[openApi\_sign\_book.json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2Fmb4kbdEp0o8kz7esQkmQ%2FopenApi_sign_book.json?alt=media\&token=3d1b62b9-c3c0-41ab-b34d-d679df782126)
{% endopenapi %}

### 物流上传接口请求报文示例

{% code title="uploadLogistics.sh" %}

```
curl --request POST \
  --url https://{openApiUrl}/openApi/V2022-03/logistics \
  --header 'Content-Type: application/json' \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
  --data '{
    "lcCode": "aCommerce",
    "orderNo": "NEW_API1213244582639",
    "trackingNo": "7735609666",
    "trackingWeb": "www.hinlc.com",
    "tradeNo": "2022051810582957553787"
}'
```

{% endcode %}

#### 结果对象属性描述

| property name | type   | description |
| ------------- | ------ | ----------- |
| code          | String | 响应码         |
| message       | String | 响应信息        |
| data          | Object | 数据体         |
| tradeNo       | String | 交易流水号       |
| status        | String | 上传结果状态码     |
| description   | String | 上传结果信息描述    |

### 物流信息查询请求报文示例

{% code title="logistics.sh" %}

```
curl --request GET\
  --url https://{openApiUrl}/openApi/V2022-03/logistics/2022051618185700208077 \
  --header 'request-id: 58675' \
  --header 'request-time: 1651888520935' \
  --header 'gateway-no: 12345001' \
  --header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
```

{% endcode %}

{% openapi src="<https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2Fmb4kbdEp0o8kz7esQkmQ%2FopenApi_sign_book.json?alt=media&token=3d1b62b9-c3c0-41ab-b34d-d679df782126>" path="/openApi/V2022-03/logistics/{tradeNos}" method="get" %}
[openApi\_sign\_book.json](https://1129616527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMb9UzyxGUyxHylm4UJSJ%2Fuploads%2Fmb4kbdEp0o8kz7esQkmQ%2FopenApi_sign_book.json?alt=media\&token=3d1b62b9-c3c0-41ab-b34d-d679df782126)
{% endopenapi %}

#### 结果对象属性描述

| property name   | type   | description                                                                                                                                                            |
| --------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code            | String | 响应码                                                                                                                                                                    |
| message         | String | 响应信息                                                                                                                                                                   |
| data            | Object | 数据体                                                                                                                                                                    |
| logisticsStatus | String | 物流状态，Pending待查询、NotFound 查询不到 、InfoReceived 预报发货 、InTransit 运输途中 、ArrivedDelivery 到达待取 、Delivering 派送途中、Delivered 成功派送、Exception 包裹异常、DeliveryFailure 投递失败、Return 包裹退回 |
| tbLcCode        | String | 物流运输商编号                                                                                                                                                                |
| trackingNo      | String | 物流单号                                                                                                                                                                   |
| trackingWeb     | String | 物流网址                                                                                                                                                                   |
| tradeNo         | String | 交易流水号                                                                                                                                                                  |