# 客户接口 V1.72

> 本文档由 `carriercentral客户端通用接口V1.72docx(4).pdf`（共 15 页）全文转换。
>
> - **结构化正文**：接口 1–13 的协议、地址、参数表、示例、输出、限流均按 PDF 收录。
> - **附录 A**：`pypdf` 逐页原文抽取，保证文本层零遗漏，可对照查漏。
> - 字段名处 PDF 抽取产生的异常空格（如 `F_ TransMode`）在结构化表中还原为合法标识符；说明文字按原文语义收录（含原文笔误，如 `F_Email` 说明写作「邮编」）。

---

## 环境与账号

| 项 | 值 |
| --- | --- |
| 客户端 | https://demovip.saas.carriercentral.vip |
| 测试接口环境 | https://demovip.saas.carriercentral.vip |
| 测试客户账号 | fj |
| 测试客户密码 | fj123qwe! |

---

## 更改历史

| 版本 | 更改内容 |
| --- | --- |
| V1.3 | 1. 增加接口：获取船司列表<br>2. 接口 SaveContainer 增加字段：船司，是否带车架，备注<br>3. 接口 GetContainerList 的数据返回增加字段：船司，是否带车架，备注<br>4. 接口 GetContainerList 的数据返回增加字段：报关资料，packingList<br>5. 增加接口：修改集装箱字段值 SaveFieldValue<br>6. 增加接口：上传文件 upload<br>7. 接口 SaveContainer 返回集装箱 id 在 data<br>8. 接口 GetShipmentInfo 返回参数 status 增加状态说明<br>9. 接口 GetContainerList 返回参数 status 增加状态说明<br>10. 接口 SaveContainer 输入参数 sR_Shipments 添加字段：城市，州，邮编，联系人，手机号，邮箱<br>11. 接口 SaveTruckInfo 输入参数 sR_Shipments 添加字段：城市，州，邮编，联系人，手机号，邮箱 |
| V1.4 | 1. 增加接口：下载 POD 和 ClosePage |
| V1.5 | 1. 接口 SaveContainer 输入参数 sR_Shipments 添加字段：品名，英文名称，PCS<br>2. 接口 GetShipmentList 返回参数 F_ChineseName 变更为 F_Description<br>3. 增加接口：下载拆柜图片 DownDevanFile |
| V1.6 | 1. GetShipmentInfo 增加 PlanETA 作为预计送达日期，ISATime 更改定义为 ISA 时间。 |
| V1.7 | 1. 集装箱列表接口访问次数限制：1 分钟 1 次<br>2. 集装箱货件列表接口访问次数限制：1 分钟 1 次<br>3. 集装箱状态变更日志接口访问次数限制：5 分钟 1 次<br>4. 集装箱货件信息接口访问次数限制：30 秒 1 次<br>5. 集装箱拆箱报告：1 分钟 1 次 |
| V1.71 | 1. 集装箱数据导入接口添加字段：柜号id（F_ContainerId） |
| V1.72 | 1. 集装箱列表接口添加字段：提柜供应商(F_SupplierId) |

---

## 目录

1. [登录](#1-登录)
2. [获取船司列表](#2-获取船司列表)
3. [集装箱数据导入](#3-集装箱数据导入)
4. [卡派数据导入](#4-卡派数据导入)
5. [集装箱列表](#5-集装箱列表)
6. [集装箱货件列表](#6-集装箱货件列表)
7. [集装箱状态变更日志](#7-集装箱状态变更日志)
8. [集装箱货件信息](#8-集装箱货件信息)
9. [集装箱拆箱报告](#9-集装箱拆箱报告)
10. [修改集装箱字段值](#10-修改集装箱字段值)
11. [上传文件](#11-上传文件)
12. [下载 POD 和 ClosePage](#12-下载-pod-和-closepage)
13. [下载拆柜图片](#13-下载拆柜图片)

---

## 1. 登录

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/learun/adms/user/customerLogin |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变 |
| Data (json 字符串) / username | string | 是 | 登录账号（客户账号） |
| Data (json 字符串) / password | string | 是 | 登录密码，32 位 MD5 加密后的字符串 |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "Data": "{\"username\":\"登录账号\",\"password\":\"登录密码，32 位 MD5 加密后的字符串\"}"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data.token | string | 是 | 通讯票据 |

---

## 2. 获取船司列表

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/ConfigModule/GetShippingLineList |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | List data | — | 见下表 |

#### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_ID | String(50) | 是 | 船司 ID |
| F_ShippingLineCode | String(20) | 是 | 船司代码 |
| F_ShippingLineName | String(100) | 是 | 船司名 |
| F_Prefix | String(100) | 否 | 前缀 |
| F_DayLow | Int | 是 | 船司 ETA 后提柜时间（示例：1-2 天，1） |
| F_DayHigh | int | 是 | 船司 ETA 后提柜时间（示例：1-2 天，2） |
| F_Remark | String(1000) | 否 | 备注 |
| F_ShippingLine | String(120) | 是 | 船司 |

---

## 3. 集装箱数据导入

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/SaveContainer |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | JSON 字符串 |

### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| keyValue | string | 否 | SR_ContainerTaskEntity 对象主键，修改时必填 |
| entity | SR_ContainerTaskEntity 对象 | — | 见 entity 表 |
| sR_Shipments | List SR_ShipmentEntity 对象 | — | 见 sR_Shipments 表 |

#### entity（SR_ContainerTaskEntity）

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_TransMode | int | 是 | 运输方式：0-海运 1-空运 3-自送 |
| F_OperationType | int | 是 | 业务类型：0-拆柜 2-直送 4-仅清关 |
| F_ContainerNo | string(50) | 是 | 柜号 |
| F_ContainerId | string(50) | 否 | 柜号id |
| F_CabinetType | string(20) | 否 | 柜型：20GP, 40GP,40HQ,40HR,40HC,45HQ,53HQ |
| F_BLCopyCode | string(15) | 否 | 提单号 |
| F_ETD | datetime? | 否 | ETD(格式:2025/04/24 或 2025-04-24) |
| F_ETA | datetime? | 否 | ETA(格式:2025/04/24 或 2025-04-24) |
| F_LoadPort | string(50) | 否 | 起始港 |
| F_Dock | string(50) | 否 | 目的港 |
| F_ShippingLineId | string(50) | 否 | 船司 ID（由船司列表接口返回的值） |
| F_Classis | int | 否 | 是否自带车架 1-是 0-否 |
| F_MemoRemark | string(1000) | 否 | 备注 |
| F_Instruction | string(1000) | 否 | 拆柜指引 |

#### sR_Shipments（List SR_ShipmentEntity）

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_FBACode | string(30) | 是 | 目的代码 |
| F_Transporter | string(30) | 是 | 派送方式：留仓，自提，扣货，TRUCK, UPS,FEDEX,DHL,USPS |
| F_ShipmentID | string(500) | 否 | 客户参考号 Customer Ref No |
| F_Remark | string(1000) | 否 | 行备注 |
| F_FBAID | string(100) | 否 | FBA id |
| F_PO | string(100) | 否 | PO |
| F_ReferenceId | string(500) | 否 | 参考号 |
| F_Address | string(500) | 否 | 详细地址，商业地址需要填写 |
| F_CTNS | int | 是 | 件数 |
| F_CBM | decimal? | 否 | 体积 |
| F_Weight | decimal? | 否 | 重量 |
| F_SKU | string(50) | 否 | SKU |
| F_Description | string(500) | 否 | 品名 |
| F_EnglishName | string(500) | 否 | 英文名称 |
| F_PCS | int | 否 | PCS |
| F_Expected_DeliveryDateB | datetime? | 否 | 最早送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_Expected_DeliveryDateE | datetime? | 否 | 最晚送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_City | string(50) | 否 | 城市 |
| F_State | string(50) | 否 | 州 |
| F_ZipCode | string(50) | 否 | 邮编 |
| F_Contact | string(50) | 否 | 联系人 |
| F_Mobile | string(50) | 否 | 手机号 |
| F_Email | string(300) | 否 | 邮编（原文参数说明） |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"keyValue\":null,\"entity\":{\"F_TransMode\":0,\"F_OperationType\":0,\"F_ContainerNo\":\"GH25042416\",\"F_CabinetType\":null,\"F_BLCopyCode\":\"\",\"F_ETD\":\"2025-04-01\",\"F_ETA\":\"2025-04-24\",\"F_LoadPort\":\"SHENZHEN\",\"F_Dock\":\"LAX\",\"F_ShippingLineId\":\"c3f80d26-3174-4eba-9460-735ce33771da\",\"F_Classis\":1,\"F_MemoRemark\":\"remarkk\",\"F_Instruction\":\"这是接口创建集装箱\"},\"sR_Shipments\":[{\"F_FBACode\":\"SMF3\",\"F_Transporter\":\"truck\",\"F_ShipmentID\":\"FBA424POST17\",\"F_Remark\":\"备注1\",\"F_FBAID\":\"FBA424PMAN17\",\"F_PO\":null,\"F_ReferenceId\":null,\"F_Address\":null,\"F_CTNS\":50,\"F_CBM\":2.36,\"F_Weight\":135.6,\"F_SKU\":null,\"F_Description\":\"CHina\",\"F_EnglishName\":\"Eng\",\"F_PCS\":10},{\"F_FBACode\":\"ABE2\",\"F_Transporter\":\"扣货\",\"F_ShipmentID\":\"FBA424POST17\",\"F_Remark\":\"备注2\",\"F_FBAID\":\"FBA424PMAN17\",\"F_PO\":\"\",\"F_ReferenceId\":\"\",\"F_Address\":\"\",\"F_CTNS\":30,\"F_CBM\":1.23,\"F_Weight\":108.3,\"F_SKU\":null,\"F_City\":null,\"F_State\":null,\"F_ZipCode\":null,\"F_Contact\":null,\"F_Mobile\":null,\"F_Email\":null,\"F_Expected_DeliveryDateB\":\"2025-04-01\",\"F_Expected_DeliveryDateE\":\"2025-04-01\"}]}"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | 集装箱 id |

---

## 4. 卡派数据导入

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/truck/SaveTruckInfo |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | JSON 字符串 |

### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| keyValue | string | 否 | SR_ContainerTaskEntity 对象主键，修改时必填 |
| entity | SR_ContainerTaskEntity 对象 | — | 见 entity 表 |
| sR_Shipments | List SR_ShipmentEntity 对象 | — | 见 sR_Shipments 表 |

#### entity

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_IsPickUp | int | 是 | 是否取货：0-自送 1-提货 2-提货派送 |
| F_PickUpDate | datetime? | 否 | 提货日期(格式:2025/04/24 或 2025-04-24)；自送不需要填写 |
| F_PickUpBegin | int? | 否 | 提货起始时间(0-23 点)，自送不需要填写 |
| F_PickUpEnd | int? | 否 | 提货截止时间(0-23 点)，自送不需要填写 |
| F_PickUpAddress | string | 否 | 提货地址，自送不需要填写。 |

#### sR_Shipments

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_CustomterBolCode | string(50) | 否 | 客户单号 |
| F_MoveType | string(10) | 否 | 移动类型：LTL，FTL，FCL，不传默认 LTL |
| F_FBACode | string(30) | 是 | 目的代码 |
| F_HouseNo | string(30) | 否 | 商业地址的 FBACode，商业地址需要填写 |
| F_Address | string(500) | 否 | 详细地址，商业地址需要填写 |
| F_FBAID | string(100) | 否 | FBA id |
| F_PO | string(100) | 否 | PO |
| F_CTNS | int? | 否 | 件数 |
| F_CBM | decimal? | 否 | 体积 |
| F_Weight | decimal? | 否 | 重量 |
| F_BOLActual Pallet | decimal? | 否 | 板数（PDF 字段名含空格：`F_BOLActual Pallet`） |
| F_Expected_DeliveryDateB | datetime? | 否 | 最早送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_Expected_DeliveryDateE | datetime? | 否 | 最晚送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_City | string(50) | 否 | 城市 |
| F_State | string(50) | 否 | 州 |
| F_ZipCode | string(50) | 否 | 邮编 |
| F_Contact | string(50) | 否 | 联系人 |
| F_Mobile | string(50) | 否 | 手机号 |
| F_Email | string(300) | 否 | 邮编（原文参数说明） |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"keyValue\":\"\",\"entity\":{\"F_IsPickUp\":5,\"F_PickUpDate\":\"4/24\",\"F_PickUpBegin\":null,\"F_PickUpEnd\":null,\"F_PickUpAddress\":\"pick up address\"},\"sR_Shipments\":[{\"F_CustomterBolCode\":\"JK2504412\",\"F_MoveType\":\"\",\"F_FBACode\":\"ONT8\",\"F_HouseNo\":\"\",\"F_Address\":\"\",\"F_FBAID\":\"\",\"F_PO\":\"\",\"F_CTNS\":null,\"F_CBM\":null,\"F_Weight\":null,\"F_BOLActual Pallet\":0.02},{\"F_CustomterBolCode\":\"JK25042413\",\"F_MoveType\":\"\",\"F_FBACode\":\"PORK\",\"F_HouseNo\":\"\",\"F_Address\":\"\",\"F_FBAID\":\"\",\"F_PO\":\"\",\"F_CTNS\":null,\"F_CBM\":null,\"F_Weight\":null,\"F_BOLActual Pallet\":0.3,\"F_City\":null,\"F_State\":null,\"F_ZipCode\":null,\"F_Contact\":null,\"F_Mobile\":null,\"F_Email\":null,\"F_Expected_DeliveryDateB\":\"2025-04-01\",\"F_Expected_DeliveryDateE\":\"2025-04-01\"}]}"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | 无 |

---

## 5. 集装箱列表

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/GetContainerList |
| 访问次数限制（V1.7） | 1 分钟 1 次 |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | JSON 字符串 |

### data 内容

#### pagination 分页

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| rows | int | 是 | 一页行数 |
| page | int | 是 | 页码 |
| sidx | string | 是 | 按什么排序，例如 F_CreateDate |
| sord | String | 是 | 排序：desc 或 asc |

#### queryJson 查询参数

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_ContainerNo | string(50) | 否 | 柜号 |
| F_CabinetType | string(10) | 否 | 柜型:20GP,40GP,40HQ,40HR,45HC,45HQ,53HQ 不传默认查所有 |
| F_TransMode | string(30) | 否 | 运输方式：海运，空运，卡派，自送。不传默认查所有 |
| F_Status | string(30) | 否 | 状态：0-新单,20-清关结束,30-提柜直达,40-待提柜,60-已到仓,65-直送运输中,70-已拆柜,80-已还柜 |
| F_FBACode | string(30) | 否 | FBACode |
| F_FBAID | string(100) | 否 | FBA id |
| F_ShipmentId | string(100) | 否 | Ref No. |
| StartTime | datetime? | 否 | 开始日期(格式:2025/04/24 或 2025-04-24) |
| EndTime | datetime? | 否 | 结束日期(格式:2025/04/24 或 2025-04-24) |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"pagination\":{\"rows\":10,\"page\":1,\"sidx\":\"F_CreateDate\",\"sord\":\"desc\"},\"queryJson\":\"{\\\"F_ContainerNo\\\":\\\"\\\",\\\"F_CabinetType\\\":\\\"\\\",\\\"F_TransMode\\\":\\\"\\\",\\\"F_Status\\\":\\\"\\\",\\\"F_FBAID\\\":\\\"\\\",\\\"F_ShipmentId\\\":\\\"\\\",\\\"StartTime\\\":\\\"\\\",\\\"EndTime\\\":\\\"\\\",\\\"F_FBACode\\\":\\\"ABE2\\\"}\"}"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | JSON 字符串 |

### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| total | int | 是 | 总数 |
| page | int | 是 | 页码 |
| records | int | 是 | 记录数 |
| rows | List rows 对象 | — | 见 rows 表 |

#### rows 字段

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_ContainerTaskId | String | 是 | 集装箱唯一主键 id |
| F_ContainerNo | String | 是 | 柜号 |
| F_CustomerId | String | 否 | 柜号 id |
| F_TransMode | Int | 是 | 运输方式 0-海运 1-空运 2-卡派 3-自送柜 |
| F_IsISF | Int | 是 | 是否填写 ISF, 0-不填写 1-填写 |
| F_CabinetType | String | 是 | 柜型 |
| F_ETD | datetime | 否 | ETD |
| F_ETA | datetime | 否 | ETA |
| F_EstimateExtractionTime | datetime | 否 | 预计提柜时间 |
| F_ExtractionTime | datetime | 否 | 实际提柜时间 |
| F_ATA | datetime | 否 | 到港时间 |
| F_UnstowTime | datetime | 否 | 拆柜日期 |
| F_GiveBackTime | datetime | 否 | 还柜日期 |
| F_NotifyGiveBackTime | datetime | 否 | 通知还柜日期 |
| F_Status | Int | 是 | 0-新单 1-已导入 Transload 2-已通知 3-已提柜 4-已到仓 5-已还柜（已结束） 9-异常 |
| F_CreateDate | datetime | 是 | 创建时间 |
| F_LoadPort | string | 否 | 起运港 |
| F_Dock | String | 否 | 目的港 |
| F_ToWhDate | datetime | 否 | 到仓日期 |
| F_InvoiceFile | String | 否 | Commericial Invoice 文件 ID |
| F_BLFile | String | 否 | BL Copy 提单文件 ID |
| F_ANFile | String | 否 | AN 到货通知文件 ID |
| F_DOFile | String | 否 | DO 文件 id |
| F_EntrySummaryFile | String | 否 | Entry Summary 文件 ID |
| F_ISFFile | String | 否 | 客户 ISF 文件 ID |
| F_OperationType | String | 否 | 业务类型：0，1 是拆柜，2 是直送，4 是只清关 |
| F_PackingList | string | 否 | Packing liist 文件 id |
| F_OfficialISF | string | 否 | 正式 ISF 文件 ID |
| F_CustomsFile | String | 否 | 报关资料 |
| F_ATD | datetime | 否 | ATD，实际开船日期 |
| F_BLCopyCode | String | 否 | 提单号 |
| F_AreaCode | String | 否 | 库区 |
| F_MemoRemark | String | 否 | 备注 |
| F_Classis | Int | 否 | 是否自带车架 1-是 0-否 |
| F_ShippingLineId | String | 否 | 船司 ID |
| F_PackingList | String | 否 | Packing list 文件 id（文档表重复列出） |
| F_CustomsFile | String | 否 | 报关资料文件 id（文档表重复列出） |
| F_SupplierId | String | 否 | 提柜供应商id（V1.72） |

### 输出示例 JSON

原文输出示例字段完整保留如下（已将 PDF 换行拼接；`info` 原文含空格「响 应 成 功」处规整为「响应成功」，键值全集未删）：

```json
{
  "code": 200,
  "info": "响应成功",
  "data": {
    "rows": [
      {
        "F_ContainerTaskId": "e4643726-6930-4a92-b9a8-937d59dbcce0",
        "F_ContainerNo": "BC25090910",
        "F_CustomerId": "d1d2fc3d-a4de-4281-a728-fc2d6a145d3f",
        "F_TransMode": 0,
        "F_IsISF": 0,
        "F_CabinetType": "20GP",
        "F_ETD": null,
        "F_ETA": null,
        "F_EstimateExtractionTime": "2025-09-19 13:00:00",
        "F_ExtractionTime": null,
        "F_ATA": null,
        "F_UnstowTime": null,
        "F_GiveBackTime": null,
        "F_NotifyGiveBackTime": null,
        "F_Status": 0,
        "F_CreateUserId": "System",
        "F_CreateDate": "2025-09-09 03:11:11",
        "F_CreateUserName": "超级管理员",
        "F_ModifyUserId": "System",
        "F_ModifyDate": "2025-09-16 20:16:13",
        "F_ModifyUserName": "超级管理员",
        "F_WhCode": null,
        "F_FileName": null,
        "F_FullFileName": null,
        "F_LoadPort": "",
        "F_Dock": "",
        "F_ANTime": null,
        "F_CustomsBroker": null,
        "F_SupplierId": "",
        "F_SupplierTrailer": null,
        "F_AbNormalTime": null,
        "F_AbNormalInfo": "",
        "F_ToWhDate": null,
        "F_BracketFreeDay": null,
        "F_InvoiceFile": null,
        "F_BLFile": null,
        "F_ANFile": null,
        "F_DOFile": null,
        "F_EntrySummaryFile": null,
        "F_ISFFile": null,
        "F_CustomsClearanceTime": null,
        "F_OperationType": 0,
        "F_SourceType": null,
        "F_PackingList": null,
        "F_OfficialISF": null,
        "F_CustomsFile": null,
        "F_OpenPhoto": null,
        "F_ATD": null,
        "F_FlowId": null,
        "F_IsPickUp": null,
        "F_PickUpCode": null,
        "F_PickUpDate": null,
        "F_PickUpBegin": null,
        "F_PickUpEnd": null,
        "F_PickUpAddress": null,
        "F_TotalPalltes": null,
        "F_CustomerBolFile": null,
        "F_PickAmount": null,
        "F_LogAcceptUrl": null,
        "F_PrintContent": null,
        "F_Instruction": "",
        "F_ShipStatus": null,
        "F_Report": null,
        "F_IsCustoms": null,
        "F_CustomsDate": null,
        "F_CustomsUserName": null,
        "F_AddressName": null,
        "F_FullAddress": null,
        "F_PODFile": null,
        "F_PODTime": null,
        "F_IsSecurityFiling": null,
        "F_ISFDraft": null,
        "F_IsVWH": null,
        "F_GW": null,
        "F_ToContact": null,
        "F_UnstowData": null,
        "F_TaskId": null,
        "F_BLCopyCode": "",
        "F_PickUpCost": null,
        "F_Convert": null,
        "F_Loader": "",
        "F_LoadingCost": null,
        "F_IsInner": null,
        "F_UnstowImage": null,
        "F_ConfirmTime": null,
        "F_IsCharge": null,
        "F_OverWeight": 0,
        "F_LFD": null,
        "F_ISA": null,
        "F_ISATime": null,
        "F_StorageType": null,
        "F_TrainTrend": "",
        "F_AreaCode": "",
        "F_Inspection": 0,
        "F_InspectionDesc": "",
        "F_ContainerId": "",
        "F_MemoRemark": "",
        "F_DismantleStatus": null,
        "F_New": null,
        "F_Classis": 0,
        "F_ShippingLineId": "c3f80d26-3174-4eba-9460-735ce33771da",
        "F_CustomerCode": null,
        "F_CustomerName": null,
        "F_ShortName": "Third Party_Usbic",
        "F_SupplierName": null,
        "CustomsBrokerName": null,
        "OpObject": null,
        "markCheckList": null,
        "shipmentList": null,
        "ErrorSortBy": null,
        "F_Profit": null,
        "F_AreaAddress": null,
        "F_UnstowFileList": null,
        "F_ShippingLineName": null,
        "F_PODFileName": null,
        "F_PODFileType": null,
        "F_PODFileUrl": "/Common/DownAnnexesFile?file Id=",
        "F_PODFileIcon": "/Content/images/filetype/.png",
        "F_ChargeFinished": 0,
        "F_MinReportTime": null
      }
    ],
    "total": 44,
    "page": 1,
    "records": 44
  }
}
```

---

## 6. 集装箱货件列表

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Shipment/GetShipmentList |
| 访问次数限制（V1.7） | 1 分钟 1 次 |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，集装箱唯一主键 id |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "集装箱唯一主键 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | JSON 字符串 |

#### data 内容 List data

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| F_Transporter | String(30) | 是 | MoveType：TRUCK，留仓，扣货，UPS，FEDEX，DHL，USPS，自提 |
| F_ID | String(50) | 是 | 货件 ID |
| F_FBACode | String(30) | 是 | 仓库代码 FBACode |
| F_ShipmentID | String(1000) | 否 | Customer Ref no. |
| F_CTNS | Int | 是 | 箱数 |
| F_CBM | decimal? | 是 | 体积 |
| F_Weight | decimal? | 是 | 重量 |
| F_Address | String(500) | 否 | 地址 |
| F_FBAID | String(2000) | 否 | FBA Id |
| F_ReferenceId | String(1000) | 否 | Reference Id |
| F_SKU | String(50) | 否 | SKU |
| F_EnglishName | String(500) | 否 | 英文品名 |
| F_Description | String(500) | 否 | 中文品名 |
| F_Expected_DeliveryDateB | datetime? | 否 | 最早送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_Expected_DeliveryDateE | datetime? | 否 | 最晚送仓日期(格式:2025/04/24 或 2025-04-24) |
| F_City | String(50) | 否 | 城市 |
| F_State | String(50) | 否 | 州省 |
| F_ZipCode | String(50) | 否 | 邮编 |
| F_Contact | String(50) | 否 | 收件人 |
| F_Mobile | String(50) | 否 | 联系电话 |
| F_Email | String(100) | 否 | 邮箱 |
| F_Remark | String(2000) | 否 | 行备注 |

---

## 7. 集装箱状态变更日志

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/GetStateTrack |
| 访问次数限制（V1.7） | 5 分钟 1 次 |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，集装箱唯一主键 id |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "集装箱唯一主键 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | JSON 字符串 |

#### data 内容 List data

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| TypeCode | Int | 是 | 状态：0-已到港，10-已提柜，20-已到仓，30-已拆柜，40-已还空 |
| TypeName | String(50) | 是 | 状态名：0-已到港，10-已提柜，20-已到仓，30-已拆柜，40-已还空 |
| F_CreateDate | datetime? | 否 | 创建时间 |
| F_CreateUserName | String | 否 | 创建人 |
| DataJson | String | 否 | JSON 字符串 |

#### DataJson 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| date | datetime? | 是 | 时间 |
| image | string | 否 | 图片 |
| remark | String | 否 | 备注 |

---

## 8. 集装箱货件信息

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/GetShipmentInfo |
| 访问次数限制（V1.7） | 30 秒 1 次 |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，集装箱唯一主键 id |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "集装箱唯一主键 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | JSON 字符串 |

#### data 内容 List data

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| Transporter | String(30) | 是 | MoveType：TRUCK，留仓，扣货，UPS，FEDEX，DHL，USPS，自提 |
| Mark | String(30) | 是 | 仓库代码 FBACode |
| ShipmentID | String(1000) | 否 | Customer Ref no. |
| Ctns | Int | 是 | 箱数 |
| Pallets | decimal? | 是 | 板数 |
| Status | decimal? | 是 | 状态：0-预到达 10-在库 15-在库 16-已排货 20-已出仓 26-运输中 30-已送达 90-已取消 |
| PlanDate | datetime? | 否 | 计划发车时间 |
| PlanETA | datetime? | 否 | 预计送达日期 |
| ISATime | datetime? | 否 | ISA 时间 |
| ETA | datetime? | 否 | ETA |
| ISA | String(50) | 否 | ISA |
| PODTime | datetime? | 否 | 签收时间 |
| Closed Page | String(50) | 否 | ClosePage 文件 id（PDF 字段名写作 Closed Page） |
| PODFile | String(50) | 否 | POD 文件 id |
| ISAChangeReason | String | 否 | ISA 变更原因 |
| ProofChange | String | 否 | ISA 变更凭证 |
| Remark | String | 否 | 备注 |

---

## 9. 集装箱拆箱报告

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/GetBillReport |
| 访问次数限制（V1.7） | 1 分钟 1 次 |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，集装箱唯一主键 id |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "集装箱唯一主键 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | binary / Blob | 否 | 拆柜报告 PDF 文件 |

---

## 10. 修改集装箱字段值

（注意：上传集装箱文件前，若对应字段为空，可使用该接口将此字段设置成文件 Id 或文件夹 Id）

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/SaveFieldValue |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | JSON 字符串 |

### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| keyValue | string | 是 | 集装箱主键唯一 id |
| field | String | 是 | 字段名（见映射） |
| fieldValue | String | 是 | 字段值，唯一 Id |

#### field 字段名映射

| 业务含义 | field 取值 |
| --- | --- |
| DO | F_DOFile |
| B/L Copy | F_BLFile |
| Commericial Invoice | F_InvoiceFile |
| Packing list | F_PackingList |
| 报关资料 | F_CustomsFile |
| AN | F_ANFile |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"keyValue\":\"729dbc73-e5fc-4207-9e7f-a58f9e2c9773\",\"field\":\"F_DOFile\",\"fieldValue\":\"80e0a295-f8f6-47e2-be2b-e8faece90694\"}"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | 无 |

---

## 11. 上传文件

(注意:上传文件使用 GetContainerList 接口先获取集装箱的文件字段对应 id，如果为空的情况使用 SaveFieldValue 接口为对应文件字段赋值)

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | POST |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/learun/adms/annexes/upload |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 集装箱对应文件字段的文件夹 id（举例：集装箱 F_DOFile 对应的 id） |
| file | binary / Blob | 是 | 上传的文件 |

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | string | 是 | 文件 id |

---

## 12. 下载 POD 和 ClosePage

注：相同文件 id 下载成功次数上限 5 次（不区分账户）；

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/learun/adms/annexes/down |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，POD 文件 id 或 ClosePage 文件 id（提示：POD 文件 id 和 ClosePage 文件 id 在 GetShipmentInfo 接口返回值中） |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "POD 文件 id 或 ClosePage 文件 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | binary / Blob | 是 | POD 文件 或 ClosePage 文件 |

---

## 13. 下载拆柜图片

注：相同集装箱下载成功次数上限 5 次（不区分账户）；

| 项 | 值 |
| --- | --- |
| 接口协议 | HTTP/WebApi |
| 请求方式 | GET |
| 请求地址 | https://demovip.saas.carriercentral.vip/api/Container/DownDevanFile |

### 输入参数

| 输入参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| loginMark | string | 是 | GUID 登录设备标识, 由请求端生成, 同一设备要求值不变，同登录接口保持一致。 |
| token | string | 是 | 通讯票据（由登录接口返回的值） |
| data | string | 是 | 字符串，集装箱唯一主键 id |

### 输入示例 JSON

```json
{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "集装箱唯一主键 id"
}
```

### 输出参数

| 输出参数名 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| code | int | 是 | 200:成功 400:失败 500:异常 410:没有登录信息 |
| info | string | 是 | 成功或者错误消息 |
| data | String | 否 | JSON |

#### data 内容

| 字段 | 类型 | 必须 | 参数说明 |
| --- | --- | --- | --- |
| bytes | String | 是 | 拆柜图片文件压缩包(Base64 编码的字符串) |
| fileName | string | 是 | 文件名 |

---

## 附录 B：接口清单与限流速查

| # | 名称 | 方法 | 路径 |
| --- | --- | --- | --- |
| 1 | 登录 | POST | /api/learun/adms/user/customerLogin |
| 2 | 获取船司列表 | GET | /api/ConfigModule/GetShippingLineList |
| 3 | 集装箱数据导入 | POST | /api/Container/SaveContainer |
| 4 | 卡派数据导入 | POST | /api/truck/SaveTruckInfo |
| 5 | 集装箱列表 | POST | /api/Container/GetContainerList |
| 6 | 集装箱货件列表 | GET | /api/Shipment/GetShipmentList |
| 7 | 集装箱状态变更日志 | GET | /api/Container/GetStateTrack |
| 8 | 集装箱货件信息 | GET | /api/Container/GetShipmentInfo |
| 9 | 集装箱拆箱报告 | GET | /api/Container/GetBillReport |
| 10 | 修改集装箱字段值 | POST | /api/Container/SaveFieldValue |
| 11 | 上传文件 | POST | /api/learun/adms/annexes/upload |
| 12 | 下载 POD 和 ClosePage | GET | /api/learun/adms/annexes/down |
| 13 | 下载拆柜图片 | GET | /api/Container/DownDevanFile |

| 接口 | 限制 |
| --- | --- |
| GetContainerList | 1 分钟 1 次 |
| GetShipmentList | 1 分钟 1 次 |
| GetStateTrack | 5 分钟 1 次 |
| GetShipmentInfo | 30 秒 1 次 |
| GetBillReport | 1 分钟 1 次 |
| 下载 POD/ClosePage | 相同文件 id 下载成功上限 5 次（不区分账户） |
| DownDevanFile | 相同集装箱下载成功上限 5 次（不区分账户） |

---

## 附录 A：PDF 原文抽取（逐页，未删减）

> 以下为 `pypdf` 对源 PDF 全部 15 页的完整文本抽取，用于对照查漏；行内异常空格为 PDF 文本层排版产物，非编辑删改。

### 第 1 页

```
客户接口 V1.72
客户端 ：https://demovip.saas.carriercentral.vip
测试接 口环境 ：https://demovip.saas.carriercentral.vip
测试客户账号： fj
fj123qwe!
更改历史
版本 更改内容
V1.3 1. 增加接口 ：获取船司列表
2. 接口 SaveContainer 增加字段 ：船司，是否带车架，备注
3. 接口 GetContainerList 的数据返回增加字段：船司，是否带车架，备注
4. 接口 GetContainerList 的数据返回增加字段：报关资料， packingList
5. 增加接口 ：修改集装箱字段值 SaveFieldValue
6. 增加接口：上传文件 upload
7. 接口 SaveContainer 返回集装箱 id 在 data
8. 接口 GetShipmentInfo 返回参数 status 增加状态说明
9. 接口 GetContainerList 返回参数 status 增加状态说明
10. 接口 SaveContainer 输入参数 sR_Shipments 添加字段：城市，州 ，邮编，联系
人 ，手机号， 邮箱
11. 接口 SaveTruckInfo 输入参数 sR_Shipments 添加字段 ：城市，州 ，邮编，联系
人 ，手机号， 邮箱
V1.4 1. 增加接口：下载 POD 和 ClosePage
V1.5 1.接口 SaveContainer 输入参数 sR_Shipments 添加字段： 品名，英文名称， PCS
2.接口 GetShipmentList 返回参数 F_ChineseName 变更为 F_Description
3.增加接口：下载拆柜图片 DownDevanFile
V1.6 1.GetShipmentInfo 增加 PlanETA 作为预计送达日期，ISATime 更改定义为 ISA 时间。
V1.7 1.集装箱列表接口访问次数限制： 1 分钟 1 次
2.集装箱货件列表接口访问次数限制： 1 分钟 1 次
3.集装箱状态变更日志接口访问次数限制 ：5 分钟 1 次
4.集装箱货件信息接口访问次数限制 ：30 秒 1 次
5.集装箱拆箱报告： 1 分钟 1 次
V1.71 1.集装箱数据导入接口添加字段：柜号id（F_ContainerId）
V1.72 1.集装箱列表接口添加字段：提柜供应商(F_SupplierId)
1. 登录
接口协议 HTTP/WebApi
```

### 第 2 页

```
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/learun/adms/user/customerLogin
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识 , 由请求端生成, 同一设备要求值
不变
Data
(json 字符
串)
username string 是 登录账号（客户账号）
password string 是 登录密码， 32 位 MD5 加密后的字符串
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"Data": "{\"username\":\"登录账号\",\"password\":\"登录密码，32 位 MD5 加密后的字符串\"}"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400:失败 500:异常 410:没有登录信息
info string 是 成功或者错误消息
data token string 是 通讯票据
2. 获取船司列表
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/ConfigModule/GetShippingLineList
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） "
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data 内容 List<data>
F_ID String(50) 是 船司 ID
F_ShippingLineCode String(20) 是 船司代码
F_ShippingLineName String(100) 是 船司名
F_Prefix String(100) 否 前缀
F_DayLow Int 是 船司 ETA 后提柜时间（示例： 1-2 天 ， 1）
```

### 第 3 页

```
F_DayHigh int 是 船司 ETA 后提柜时间（示例： 1-2 天 ，2）
F_Remark String(1000) 否 备注
F_ ShippingLine String(120) 是 船司
3. 集装箱数据导入
接口协议 HTTP/WebApi
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/Container/SaveContainer
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变
token string 是 通讯票据（由登录接口返回的值）
data string 是 JSON 字符串
data 内容
keyValue string 否 SR_ContainerTaskEntity 对象主键，修改 时必填
entity SR_ContainerTaskEntity 对象
F _ TransMode int 是 运输方式 ：0-海运 1-空运 3-自送
F_OperationType int 是 业务类型 ：0-拆柜 2-直送 4-仅清关
F_ContainerNo string(50) 是 柜号
F_ContainerId string(50) 否 柜号id
F_CabinetType string(20) 否 柜型：
20GP, 40GP,40HQ,40HR,40HC,45HQ,53HQ
F_BLCopyCode string(15) 否 提单号
F_ETD datetime? 否 ETD(格式:2025/04/24 或 2025-04-24)
F_ETA datetime? 否 ETA(格式:2025/04/24 或 2025-04-24)
F _ LoadPort string(50) 否 起始港
F_Dock string(50) 否 目的港
F_ShippingLineId string(50) 否 船司 ID（由船司列表接口返回的值）
F Classis int 否 是否自带车架 1-是 0-否
F MemoRemark string(1000) 否 备注
F_Instruction string(1000) 否 拆柜指引
sR_Shipments List<SR_ShipmentEntity>对象
F_ FBACode string(30) 是 目的代码
F_Transporter string(30) 是 派 送 方 式 ： 留 仓 ， 自 提 ， 扣 货 ， TRUCK,
UPS,FEDEX,DHL,USPS
F_ShipmentID string(500) 否 客户参考号 Customer Ref No
F_ Remark string(1000) 否 行备注
F_ FBAID string(100) 否 FBA id
F_PO string(100) 否 PO
F_ReferenceId string(500) 否 参考号
F_ Address string(500) 否 详细地址， 商业地址需要填写
F_CTNS int 是 件数
```

### 第 4 页

```
F_CBM decimal? 否 体积
F_ Weight decimal? 否 重量
F_SKU string(50) 否 SKU
F_ Description string(500) 否 品名
F_ EnglishName string(500) 否 英文名称
F_PCS int 否 PCS
F_Expected_DeliveryDateB datetime? 否 最 早 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_Expected_DeliveryDateE datetime? 否 最 晚 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_City string(50) 否 城市
F_ State string(50) 否 州
F_ ZipCode string(50) 否 邮编
F_ Contact string(50) 否 联系人
F_ Mobile string(50) 否 手机号
F_ Email string(300) 否 邮编
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"{\"keyValue\":null,\"entity\":{\"F_TransMode\":0,\"F_OperationType\":0,\"F_ContainerNo\":\"GH25042
416\",\"F_CabinetType\":null,\"F_BLCopyCode\":\"\",\"F_ETD\":\"2025-04-01\",\"F_ETA\":\"2025-04-24\",\"F_L
oadPort\":\"SHENZHEN\",\"F_Dock\":\"LAX\",\"F_ShippingLineId\":\"c3f80d26-3174-4eba-9460-735ce33771d
a\",\"F_Classis\":1,\"F_MemoRemark\":\"remarkk\",\"F_Instruction\":\"这是接口创建集装箱
\"},\"sR_Shipments\":[{\"F_FBACode\":\"SMF3\",\"F_Transporter\":\"truck\",\"F_ShipmentID\":\"FBA424POST17\
",\"F_Remark\":\"备注
1\",\"F_FBAID\":\"FBA424PMAN17\",\"F_PO\":null,\"F_ReferenceId\":null,\"F_Address\":null,\"F_CTNS\":50,\"F_C
BM\":2.36,\"F_Weight\":135.6,\"F_SKU\":null,\"F_Description\":\"CHina\",\"F_EnglishName\":\"Eng\",\"F_PCS\":1
0},{\"F_FBACode\":\"ABE2\",\"F_Transporter\":\"扣货\",\"F_ShipmentID\":\"FBA424POST17\",\"F_Remark\":\"备
注
2\",\"F_FBAID\":\"FBA424PMAN17\",\"F_PO\":\"\",\"F_ReferenceId\":\"\",\"F_Address\":\"\",\"F_CTNS\":30,\"F_C
BM\":1.23,\"F_Weight\":108.3,\"F_SKU\":null,\"F_City\":null,\"F_State\":null,\"F_ZipCode\":null,\"F_Contact\":null,
\"F_Mobile\":null,\"F_Email\":null, \"F_Expected_DeliveryDateB \":\"2025-04-01\",\"F_Expected_DeliveryDateE
\":\"2025-04-01\"}]}"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 集装箱 id
```

### 第 5 页

```
4. 卡派数据导入
接口协议 HTTP/WebApi
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/truck/SaveTruckInfo
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 JSON 字符串
data 内容
keyValue string 否 SR_ContainerTaskEntity 对象主键，修改 时必填
entity SR_ContainerTaskEntity 对象
F_IsPickUp int 是 是否取货 ：0-自送 1-提货 2-提货派送
F_PickUpDate datetime? 否 提货日期(格式:2025/04/24 或 2025-04-24)
自送不需要填写
F_ PickUpBegin int? 否 提货起始时间(0-23 点)， 自送不需要填写
F_ PickUpEnd int? 否 提货截止时间(0-23 点)， 自送不需要填写
F _ PickUpAddress string 否 提货地址， 自送不需要填写。
sR_Shipments List<SR_ShipmentEntity>对象
F_CustomterBolCode string(50) 否 客户单号
F_ MoveType string(10) 否 移动类型： LTL， FTL， FCL，不传默认 LTL
F_ FBACode string(30) 是 目的代码
F_HouseNo string(30) 否 商业地址的 FBACode， 商业地址需要填写
F_Address string(500) 否 详细地址， 商业地址需要填写
F_FBAID string(100) 否 FBA id
F_PO string(100) 否 PO
F_CTNS int? 否 件数
F_CBM decimal? 否 体积
F_ Weight decimal? 否 重量
F_ BOLActual Pallet decimal? 否 板数
F_Expected_DeliveryDateB datetime? 否 最 早 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_Expected_DeliveryDateE datetime? 否 最 晚 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_City string(50) 否 城市
F_ State string(50) 否 州
F_ ZipCode string(50) 否 邮编
F_ Contact string(50) 否 联系人
F_ Mobile string(50) 否 手机号
F_ Email string(300) 否 邮编
输入示例 JSON
{
```

### 第 6 页

```
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"{\"keyValue\":\"\",\"entity\":{\"F_IsPickUp\":5,\"F_Pick UpDate\":\"4/24\",\"F_PickUpBegin\":null,\"F_Pic
k UpEnd\":null,\"F_PickUpAddress\":\"pick up
address\"},\"sR_Shipments\":[{\"F_CustomterBolCode\":\"JK2504412\",\"F_MoveType\":\"\",\"F_FBACode\":\"O
NT8\",\"F_HouseNo\":\"\",\"F_Address\":\"\",\"F_FBAID\":\"\",\"F_PO\":\"\",\"F_CTNS\":null,\"F_CBM\":null,\"F_W
eight\":null,\"F_BOLActual Pallet\":0.02},{\"F_CustomterBolCode\":\"JK25042413\",\"F_MoveType\":\"\",\"F_FBA
Code\":\"PORK\",\"F_HouseNo\":\"\",\"F_Address\":\"\",\"F_FBAID\":\"\",\"F_PO\":\"\",\"F_CTNS\":null,\"F_CBM\
":null,\"F_Weight\":null,\"F_BOLActual Pallet\":0.3,\"F_City\":null,\"F_State\":null,\"F_ZipCode\":null,\"F_Contact\"
:null,\"F_Mobile\":null,\"F_Email\":null,\"F_Expected_DeliveryDateB\":\"2025-04-01\",\"F_Expected_DeliveryDate
E \":\"2025-04-01\"}]}"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 无
5. 集装箱列表
接口协议 HTTP/WebApi
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/Container/GetContainerList
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 JSON 字符串
data 内容
pagination 分 页
rows int 是 一页行数
page int 是 页码
sidx string 是 按什么排序，例如 F_CreateDate
sord String 是 排序 ：desc 或 asc
queryJson 查询参数
F_ ContainerNo string(50) 否 柜号
F_ CabinetType string(10) 否 柜型:20GP,40GP,40HQ,40HR,45HC,
45HQ,53HQ 不传默认查所有
F _ TransMode string(30) 否 运输方式 ：海运， 空运， 卡派， 自送 。不传默
认查所有
F_Status string(30) 否 状态：0-新单,20-清关结束,30-提柜直达,40-待
提柜,60-已到仓,65-直送运输中,70-已拆柜,80-
```

### 第 7 页

```
已还柜
F_FBACode string(30) 否 FBACode
F_FBAID string(100) 否 FBA id
F_ ShipmentId string(100) 否 Ref No.
StartTime datetime? 否 开始日期(格式:2025/04/24 或 2025-04-24)
EndTime datetime? 否 结束日期(格式:2025/04/24 或 2025-04-24)
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":”{\"pagination\":{\"rows\":10,\"page\":1,\"sidx\":\"F_CreateDate\",\"sord\":\"desc\"},\"queryJson\":"{\"F
_ContainerNo\":\"\",\"F_CabinetType\":\"\",\"F_TransMode\":\"\",\"F_Status\":\"\",\"F_FBAID\":\"\",\"F_Shipment
Id\":\"\",\"StartTime\":\"\",\"EndTime\":\"\",\"F_FBACode\":\"ABE2\"}"} ”
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 JSON 字符串
data 内容
total int 是 总数
page int 是 页码
records int 是 记录数
rows List<rows>对象
F_ContainerTaskId String 是 集装箱唯一主键 id
F_ ContainerNo String 是 柜号
F_ CustomerId String 否 柜号 id
F_ TransMode Int 是 运输方式 0-海运 1-空运 2-卡派 3-自送柜
F_IsISF Int 是 是否填写 ISF, 0-不填写 1-填写
F_ CabinetType String 是 柜型
F_ETD datetime 否 ETD
F_ETA datetime 否 ETA
F_EstimateExtractionTime datetime 否 预计提柜时间
F _ ExtractionTime datetime 否 实际提柜时间
F_ATA datetime 否 到港时间
F_ UnstowTime datetime 否 拆柜日期
F _ GiveBackTime datetime 否 还柜日期
F_NotifyGiveBackTime datetime 否 通知还柜日期
F_Status Int 是 0-新单 1-已导入 Transload 2-已通知 3-已提
柜 4-已到仓 5-已还柜（已结束） 9 - 异常
F_ CreateDate datetime 是 创建时间
F_LoadPort string 否 起运港
F_Dock String 否 目的港
```

### 第 8 页

```
F_ToWh Date datetime 否 到仓日期
F_ InvoiceFile String 否 Commericial Invoice 文件 ID
F_BLFile String 否 BL Copy 提单文件 ID
F_ANFile String 否 AN 到货通知文件 ID
F_DOFile String 否 DO 文件 id
F_EntrySummaryFile String 否 Entry Summary 文件 ID
F_ISFFile String 否 客户 ISF 文件 ID
F _ OperationType String 否 业务类型：0 ， 1 是拆柜， 2 是直送，4 是只清
关
F_ PackingList string 否 Packing liist 文件 id
F_ OfficialISF string 否 正式 ISF 文件 ID
F_ CustomsFile String 否 报关资料
F_ATD datetime 否 ATD， 实际开船日期
F_ BLCopyCode String 否 提单号
F_ AreaCode String 否 库区
F _ MemoRemark String 否 备注
F_Classis Int 否 是否自带车架 1-是 0-否
F _ ShippingLineId String 否 船司 ID
F_ PackingList String 否 Packing list 文件 id
F_ CustomsFile String 否 报关资料文件 id
F_ Su p p li er Id String 否 提柜供应商id
输出示例 JSON
{"code":200,"info":" 响 应 成 功
","data":{"rows":[{"F_ContainerTaskId":"e4643726-6930-4a92-b9a8-937d59dbcce0","F_ContainerNo":"BC2509
0910","F_CustomerId":"d1d2fc3d-a4de-4281-a728-fc2d6a145d3f","F_TransMode":0,"F_IsISF":0,"F_CabinetTyp
e":"20GP","F_ETD":null,"F_ETA":null,"F_EstimateExtractionTime":"2025-09-19
13:00:00","F_ExtractionTime":null,"F_ATA":null,"F_UnstowTime":null,"F_GiveBackTime":null,"F_NotifyGiveBackTi
me":null,"F_Status":0,"F_CreateUserId":"System","F_CreateDate":"2025-09-09 03:11:11","F_CreateUserName":"
超级管理员","F_ModifyUserId":"System","F_ModifyDate":"2025-09-16 20:16:13","F_ModifyUserName":"超级管
理 员
","F_WhCode":null,"F_FileName":null,"F_FullFileName":null,"F_Load Port":"","F_Dock":"","F_ANTime":null,"F_Cust
omsBroker":null,"F_SupplierId":"","F_SupplierTrailer":null,"F_AbNormalTime":null,"F_AbNormalInfo":"","F_ToWh
Date":null,"F_BracketFreeDay":null,"F_InvoiceFile":null,"F_BLFile":null,"F_ANFile":null,"F_DOFile":null,"F_EntrySu
mmaryFile":null,"F_ ISFFile":null,"F_CustomsClearanceTime":null,"F_OperationType":0,"F_SourceType":null,"F_Pa
c kingList":null,"F_OfficialISF":null,"F_CustomsFile":null,"F_OpenPhoto":null,"F_ATD":null,"F_FlowId":null,"F_IsPick
Up":null,"F_PickUpCode":null,"F_Pick UpDate":null,"F_PickUpBegin":null,"F_PickUpEnd":null,"F_PickUpAddress":n
ull,"F_ TotalPalltes":null,"F_CustomerBolFile":null,"F_PickAmount":null,"F_ LogAcceptUrl":null,"F_ PrintContent":nu
ll,"F_Instruction":"","F_ShipStatus":null,"F_Report":null,"F_IsCustoms":null,"F_CustomsDate":null,"F_CustomsUser
Name":null,"F_AddressName":null,"F_FullAddress":null,"F_PODFile":null,"F_PODTime":null,"F_IsSecurityFiling":n
ull,"F_ISFDraft":null,"F_IsVWH":null,"F_GW":null,"F_ToContact":null,"F_UnstowData":null,"F_TaskId":null,"F_BLCo
pyCode":"","F_PickUpCost":null,"F_Convert":null,"F_Loader":"","F_LoadingCost":null,"F_IsInner":null,"F_UnstowI
mage":null,"F_ConfirmTime":null,"F_IsCharge":null,"F_OverWeight":0,"F_LFD":null,"F_ISA":null,"F_ISATime":null,"
F_StorageType":null,"F_TrainTrend":"","F_AreaCode":"","F_Inspection":0,"F_InspectionDesc":"","F_ContainerId":""
,"F_MemoRemark":"","F_DismantleStatus":null,"F_New":null,"F_Classis":0,"F_ShippingLineId":
"c3f80d26-3174-4eba-9460-735ce33771da","F_CustomerCode":null,"F_CustomerName":null,"F_ShortName":"
```

### 第 9 页

```
Third Party_Usbic","F_SupplierName":null,"CustomsBrokerName":null,"OpObject":null,"markCheckList":null,"shi
pmentList": null," ErrorSortBy":null,"F_ Profit":null,"F_ AreaAddress":null,"F_ UnstowFileList": null,"F_ShippingLineNa
me":
null,"F_ PODFileName":null,"F_PODFileType":null,"F_PODFileUrl":"/Common/DownAnnexesFile?file Id=","F_POD
File Icon":"/Content/images/filetype/.png","F_ChargeFinished":0,"F_MinReportTime":null}],"total":44,"page":1,"r
ecords":44}}
6. 集装箱货件列表
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/Shipment/GetShipmentList
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，集装箱唯一主键 id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"集装箱唯一主键 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 JSON 字符串
data 内容 List<data>
F_ Transporter String(30) 是 MoveType：TRUCK，留仓，扣货，UPS，FEDEX，
DHL， USPS， 自提
F_ID String(50) 是 货件 ID
F_FBACode String(30) 是 仓库代码 FBACode
F_ ShipmentID String(1000) 否 Customer Ref no.
F_CTNS Int 是 箱数
F_CBM decimal? 是 体积
F_Weight decimal? 是 重量
F_Address String(500) 否 地址
F_FBAID String(2000) 否 FBA Id
F_ ReferenceId String(1000) 否 Reference Id
F_SKU String(50) 否 SKU
```

### 第 10 页

```
F_ EnglishName String(500) 否 英文品名
F_ Description String(500) 否 中文品名
F_Expected_DeliveryDate
B
datetime? 否 最 早 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_Expected_DeliveryDate
E
datetime? 否 最 晚 送 仓 日 期 ( 格 式 :2025/04/24 或
2025-04-24)
F_City String(50) 否 城市
F_State String(50) 否 州省
F_ZipCode String(50) 否 邮编
F_Contact String(50) 否 收件人
F_Mobile String(50) 否 联系电话
F_Email String(100) 否 邮箱
F_Remark String(2000) 否 行备注
7. 集装箱状态变更日志
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/Container/GetStateTrack
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，集装箱唯一主键 id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"集装箱唯一主键 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 JSON 字符串
data 内容 List<data>
TypeCode Int 是 状态：0-已到港，10-已提柜，20-已到仓，30-
已拆柜，40-已还空
TypeName String(50) 是 状态名：0-已到港， 10-已提柜， 20-已到仓，
30-已拆柜，40-已还空
F_ CreateDate datetime? 否 创建时间
```

### 第 11 页

```
F_CreateUserName String 否 创建人
DataJson String 否 JSON 字符串
DataJson 内容
date datetime? 是 时间
image string 否 图片
remark String 否 备注
8. 集装箱货件信息
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/Container/GetShipmentInfo
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，集装箱唯一主键 id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"集装箱唯一主键 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 JSON 字符串
data 内容 List<data>
Transporter String(30) 是 MoveType：TRUCK，留仓，扣货，UPS，FEDEX，
DHL， USPS， 自提
Mark String(30) 是 仓库代码 FBACode
ShipmentID String(1000) 否 Customer Ref no.
Ctns Int 是 箱数
Pallets decimal? 是 板数
Status decimal? 是 状态：0-预到达 10-在库 15-在库 16-已排货
20-已出仓 26-运输中 30-已送达 90-已取消
PlanDate datetime? 否 计划发车时间
PlanETA datetime? 否 预计送达日期
ISATime datetime? 否 ISA 时间
ETA datetime? 否 ETA
```

### 第 12 页

```
ISA String(50) 否 ISA
PODTime datetime? 否 签收时间
Closed Page String(50) 否 ClosePage 文件 id
PODFile String(50) 否 POD 文件 id
ISAChangeReason String 否 ISA 变更原因
ProofChange String 否 ISA 变更凭证
Remark String 否 备注
9. 集装箱拆箱报告
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/Container/GetBillReport
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，集装箱唯一主键 id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"集装箱唯一主键 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data binary / Blob 否 拆柜报告 PDF 文件
10. 修改集装箱字段值
（注意 ：上传集装箱文件前 ，若对应字段为空， 可使用该接口将此字段设置成文件 Id 或文
件夹 Id）
接口协议 HTTP/WebApi
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/Container/SaveFieldValue
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
```

### 第 13 页

```
求值不变
token string 是 通讯票据（由登录接口返回的值）
data string 是 JSON 字符串
data 内容
keyValue string 是 集装箱主键唯一 id
field String 是 字段名 (
DO： F_DOFile
B/L Copy： F_BLFile
Commericial Invoice： F _ InvoiceFile
Packing list： F_PackingList
报关资料： F_CustomsFile
AN： F_ANFile
)
fieldValue String 是 字段值， 唯一 Id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"{\"keyValue\":\"729dbc73-e5fc-4207-9e7f-a58f9e2c9773\",\"field\":\"F_DOFile\",\"fieldValue\":\"80e
0a295-f8f6-47e2-be2b-e8faece90694\"}"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 无
11. 上传文件
(注意:上传文件使用 GetContainerList 接口先获取集装箱的文件字段对应 id，如果为空的情
况使用 SaveFieldValue 接口为对应文件字段赋值)
接口协议 HTTP/WebApi
请求方式： POST
请求地址： https://demovip.saas.carriercentral.vip/api/learun/adms/annexes/upload
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 集装箱对应文件字段的文件夹 id（举例：集装
箱 F_DOFile 对应的 id）
file binary / Blob 是 上传的文件
```

### 第 14 页

```
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data string 是 文件 id
12. 下载 POD 和 ClosePage
注 ：相同文件 id 下载成功次数上限 5 次（不区分账户）；
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/learun/adms/annexes/down
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，POD 文件 id 或 ClosePage 文件 id（提
示 ： POD 文 件 id 和 ClosePage 文 件 id 在
GetShipmentInfo 接口返回值中）
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"POD 文件 id 或 ClosePage 文件 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data binary / Blob 是 POD 文件 或 ClosePage 文件
13. 下载拆柜图片
注 ：相同集装箱下载成功次数上限 5 次（不区分账户）；
```

### 第 15 页

```
接口协议 HTTP/WebApi
请求方式： GET
请求地址： https://demovip.saas.carriercentral.vip/api/Container/DownDevanFile
输入参数名 类型 必须 参数说明
loginMark string 是 GUID 登录设备标识, 由请求端生成, 同一设备要
求值不变， 同登录接口保持一致。
token string 是 通讯票据（由登录接口返回的值）
data string 是 字符串，集装箱唯一主键 id
输入示例 JSON
{
"loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
"token": "通讯票据（由登录接口返回的值） ",
"data":"集装箱唯一主键 id"
}
输出参数名 类型 必须 参数说明
code int 是 200:成功 400: 失败 500: 异常 410:没有登
录信息
info string 是 成功或者错误消息
data String 否 JSON
data 内容
bytes String 是 拆柜图片文件压缩包(Base64 编码的字符串)
fileName string 是 文件名
```

---

*来源 PDF：`carriercentral客户端通用接口V1.72docx(4).pdf`（15 页）*