71 KiB

Raw Blame History Unescape Escape

客户接口 V1.74

本文档由 carriercentral客户端通用接口V1.72docx(4).pdf（共 15 页）全文转换，并按 V1.73 / V1.74 变更修订结构化参数说明。

结构化正文：接口 1–13 的协议、地址、参数表、示例、输出、限流均按 PDF 收录；接口 14 按服务端 CustomerMessageApi 实现收录。V1.74 起以本表为准。

附录 A：pypdf 逐页原文抽取（源 PDF 为 V1.72）；与结构化表冲突时以结构化表（含 V1.73 / V1.74 更正）为准。

字段名处 PDF 抽取产生的异常空格（如 F_ TransMode）在结构化表中还原为合法标识符；说明文字按原文语义收录（含原文笔误，如 F_Email 说明写作「邮编」）。

环境与账号

项	值
客户端	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)
V1.73	1. 集装箱列表接口输出参数状态说明纠正：0-新单,20-清关结束,30-提柜直达,40-待提柜,60-已到仓,65-直送运输中,70-已拆柜,80-已还柜 2. 集装箱货件信息接口输出参数状态增加：22-已装车
V1.74	1. 增加接口：创建工单（客户指令）SaveForm

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

{
  "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	—	见下表

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

{
  "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

{
  "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

{
  "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-新单,20-清关结束,30-提柜直达,40-待提柜,60-已到仓,65-直送运输中,70-已拆柜,80-已还柜
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 原文含空格「响应成功」处规整为「响应成功」，键值全集未删）：

{
  "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

{
  "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

{
  "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

{
  "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-已出仓 22-已装车 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

{
  "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

{
  "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

{
  "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

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

输出参数

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

data 内容

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

14. 创建工单（客户指令）

对应客户端「我的工单 / 客户留言」页面的新增弹窗。创建后状态为未处理（F_Status=0），工单号由服务端按编码规则生成（示例：WO20260827005）。

本接口不在 V1.72/V1.73 源 PDF 中，V1.74 按服务端实现收录。

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

输入参数

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

data 内容

字段	类型	必须	参数说明
keyValue	string	否	工单主键。新建不传或传空；修改时必填
entity	SR_CustomerMessageEntity 对象	是	见 entity 表

entity（SR_CustomerMessageEntity）

对应新增弹窗字段：

字段	类型	必须	对应弹窗	参数说明
F_ReferCode	string	否	参考号	柜号、客户参考号等
F_MessageType	string	是	留言类型	数据字典 `CustomerMessageType` 的名称文本（不是数字）。多选时用英文逗号拼接。示例：`客户新增集装箱`。实际可用值以客户端「留言类型」下拉为准
F_UrgencyLevel	int	否	紧急程度	`0`-普通，`1`-紧急，`2`-特急
F_RefNo	string(100)	否	Ref No	唛头 / 第二参考号
F_MessageContent	string(800)	是	留言内容	工单正文
F_Remark	string(800)	否	备注	备注
F_AttachFile	string	否	附件上传	附件文件夹 Id。有附件时先调用 11. 上传文件，再把同一文件夹 Id 填入本字段
F_CustomerId	string	否	（客户账号页面不展示）	客户 Id。客户账号登录时服务端强制覆盖为当前客户，不必传；非客户账号调用时需传入

以下字段由服务端自动生成，新建时不要传（传了也会被覆盖或忽略）：

字段	说明
F_MessageId	工单主键 GUID
F_MessageCode	工单号，按编码规则生成
F_Status	固定写入 `0`（未处理 / 待处理）
F_CreateDate / F_CreateUserId / F_CreateUserName	当前登录用户

状态 F_Status（查询时使用，创建接口不必传）

值	说明
0	未处理 / 待处理
10	处理中
15	已挂起
20	已处理
90	已删除

输入示例 JSON

{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"keyValue\":\"\",\"entity\":{\"F_ReferCode\":\"test1111\",\"F_MessageType\":\"客户新增集装箱\",\"F_UrgencyLevel\":0,\"F_RefNo\":\"\",\"F_MessageContent\":\"新增集装箱【test1111】，通知操作人员处理。\",\"F_Remark\":\"\",\"F_AttachFile\":\"\"}}"
}

data 展开后（便于对照，实际请求中 data 仍须是 JSON 字符串）：

{
  "keyValue": "",
  "entity": {
    "F_ReferCode": "test1111",
    "F_MessageType": "客户新增集装箱",
    "F_UrgencyLevel": 0,
    "F_RefNo": "",
    "F_MessageContent": "新增集装箱【test1111】，通知操作人员处理。",
    "F_Remark": "",
    "F_AttachFile": ""
  }
}

带附件调用顺序

调用端自行生成一个文件夹 GUID，作为 F_AttachFile。
调用 11. 上传文件：data = 该文件夹 GUID，file = 文件二进制。可多次上传到同一文件夹。
调用本接口，entity.F_AttachFile 填同一文件夹 GUID。

输出参数

输出参数名	类型	必须	参数说明
code	int	是	200:成功 400:失败 500:异常 410:没有登录信息
info	string	是	成功时为「保存成功！」；失败为错误消息
data	object	是	成功时为空对象，不返回工单号

输出示例 JSON

{
  "code": 200,
  "info": "保存成功！",
  "data": {}
}

创建后如何核对工单号

本接口成功响应不返回 F_MessageCode。如需拿到刚创建的工单号，可再调工单列表：

项	值
请求方式	POST 或 GET
请求地址	https://demovip.saas.carriercentral.vip/api/CustomerMessage/GetMessageList

data 结构与集装箱列表类似，含 pagination 与 queryJson。可用 F_ReferCode、F_MessageType、F_MessageContent 过滤，按 F_CreateDate desc 取最新一条。

{
  "loginMark": "GUID 登录设备标识, 由请求端生成, 同一设备要求值不变",
  "token": "通讯票据（由登录接口返回的值）",
  "data": "{\"pagination\":{\"rows\":10,\"page\":1,\"sidx\":\"F_CreateDate\",\"sord\":\"desc\"},\"queryJson\":\"{\\\"F_ReferCode\\\":\\\"test1111\\\",\\\"F_MessageType\\\":\\\"客户新增集装箱\\\"}\"}"
}

调用说明

必须先调用 1. 登录获取 token，loginMark 全程保持不变。
F_MessageType 必须使用数据字典中的中文名称。名称不在字典中也能入库，但客户端「工单来源=人为工单」筛选可能查不到。
用测试客户账号（如 fj）调用时，不要传其他客户的 F_CustomerId，服务端会覆盖为当前客户。
keyValue 有值时为修改：仅当原工单状态为 0/10/15 时可改，否则返回失败「工单状态已变更，不能修改」。
页面「确认」走的是 Web MVC（/SR_Transfer/SRCustomerMessage/SaveForm），需要浏览器登录态，外部系统请使用本 WebApi。

附录 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
14	创建工单（客户指令）	POST	/api/CustomerMessage/SaveForm

接口	限制
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)
V1.73 1.集装箱列表接口输出参数状态说明纠正：0-新单,20-清关结束,30-提柜直达,40-待提柜,60-已到仓,65-直送运输中,70-已拆柜,80-已还柜
2.集装箱货件信息接口输出参数状态增加：22-已装车
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-新单,20-清关结束,30-提柜直达,40-待提柜,60-已到仓,65-直送运输中,70-已拆柜,80-已还柜
（V1.73 纠正；原 V1.72 PDF 误写为 0/1/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-已出仓 22-已装车 26-运输中 30-已送达 90-已取消
（V1.73 增加 22-已装车）
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 页）；结构化说明已更新至 V1.74。

71 KiB Raw Blame History Unescape Escape

客户接口 V1.74

环境与账号

更改历史

目录

1. 登录

输入参数

输入示例 JSON

输出参数

2. 获取船司列表

输入参数

输入示例 JSON

输出参数

data 内容

3. 集装箱数据导入

输入参数

data 内容

entity（SR_ContainerTaskEntity）

sR_Shipments（List SR_ShipmentEntity）

输入示例 JSON

输出参数

4. 卡派数据导入

输入参数

data 内容

entity

sR_Shipments

输入示例 JSON

输出参数

5. 集装箱列表

输入参数

data 内容

pagination 分页

queryJson 查询参数

输入示例 JSON

输出参数

data 内容

rows 字段

输出示例 JSON

6. 集装箱货件列表

输入参数

输入示例 JSON

输出参数

data 内容 List data

7. 集装箱状态变更日志

输入参数

输入示例 JSON

输出参数

data 内容 List data

DataJson 内容

8. 集装箱货件信息

输入参数

输入示例 JSON

输出参数

data 内容 List data

9. 集装箱拆箱报告

输入参数

输入示例 JSON

输出参数

10. 修改集装箱字段值

输入参数

data 内容

field 字段名映射

输入示例 JSON

输出参数

11. 上传文件

输入参数

输出参数

12. 下载 POD 和 ClosePage

输入参数

输入示例 JSON

输出参数

13. 下载拆柜图片

输入参数

输入示例 JSON

输出参数

data 内容

14. 创建工单（客户指令）

输入参数

data 内容

entity（SR_CustomerMessageEntity）

71 KiB

Raw Blame History Unescape Escape