64 KiB

Raw Blame History Unescape Escape

客户接口 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. 增加接口：获取船司列表 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
请求方式	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-新单 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 原文含空格「响应成功」处规整为「响应成功」，键值全集未删）：

{
  "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-已出仓 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	是	文件名

附录 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 页）

64 KiB Raw Blame History Unescape Escape

客户接口 V1.72

环境与账号

更改历史

目录

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 内容

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

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

第 1 页

第 2 页

64 KiB

Raw Blame History Unescape Escape