h2. 接口名称
下载模板文件 (Download Template)

h2. 接口地址
{code}
/api/shipper/v1/template/file
{code}

h2. 请求方式
{code}
GET
{code}


h2. 接口描述
该接口用于下载订单上传模板 Excel 文件。用户在上传订单前需要先下载模板,按照模板格式填写订单信息后再上传。

h2. 请求头

|| 参数 || 类型 || 必填 || 说明 ||
| sessionId | String | 是 | 登录会话ID(通过URL参数传递) |
| language | String | 是 | 语言(通过URL参数传递) |

*语言取值:*

|| 值 || 说明 ||
| zh_CN | 中文 |
| en_US | 英文 |

h2. 请求参数

**参数通过 URL 查询参数传递:**

|| 参数 || 类型 || 必填 || 说明 ||
| templateName | String | 是 | 模板名称 |

**templateName 模板名称:**

|| 值 | 说明 |
| parcel_upload_template | 订单上传模板(运单) |

h2. 请求示例

**方式一:直接拼接URL(推荐)**
{code}
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/template/file?language=zh_CN&sessionId=vP1l43F_OqvoTUWBcaAtyg&templateName=parcel_upload_template' \
  -O
{code}



h2. 返回说明

*响应类型:* application/vnd.openxmlformats-officedocument.spreadsheetml.sheet(Excel文件)

*响应头:*

|| 参数 || 说明 ||
| Content-Disposition | 文件名,如:attachment; filename=parcel_upload_template.xlsx |
| Content-Type | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Content-Length | 文件大小 |

*返回说明:*

- 返回的是 Excel 文件流(.xlsx 格式)