|
|
# 客户接口 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 页）*
|
