Agent 能在 海管家 里做什么
按任务分组，每组列出要调用的操作。
船舶、车辆与船公司跟踪
读取船舶位置与轨迹、查询获授权车辆，并读取船公司跟踪订阅。
- Get Ship Position
- List Ship Track Points
- Batch Get Truck Positions
- List Truck Track Points
- Get Full Journey Tracking
港口集装箱与船期
查询港口集装箱或船期数据，创建所需订阅或船期绑定。
- Get Port Container
- Get Port Schedule
- Subscribe Port Container
- Subscribe Port Schedule
- Bind Ningbo Schedule
- Bind Shanghai Schedule
舱单提交与回执
提交完整上海或青岛舱单、读取上海回执，或请求指定舱单变更。
- Send Shanghai Manifest
- Get Shanghai Manifest Status
- Update Shanghai Manifest
- Get Shanghai Manifest Update Status
- Delete Shanghai Manifest
- Get Shanghai Manifest Deletion Status
- Send Qingdao Manifest
- Update Qingdao Manifest
可以交给 Agent 的任务
方括号里填你的内容，任务标出的其他应用也要连接。
查看已订阅船舶轨迹
读取已订阅船舶的最新位置与历史轨迹点。
查看已订阅船舶 [MMSI] 在 [开始时间] 至 [结束时间] 的航迹及最新位置，保留观测时间。
查询上海舱单回执
读取连接账号提交的报关单回执。
查询当前账号提交的申报单 [编号] 的上海舱单回执，解释退回原因，暂不修改或重发。
操作76
海管家 连接器提供的全部操作，附名称和 id。
- Subscribe Ship
subscribe_ship在海管家订阅船舶，以便后续查询该船舶的轨迹信息。 - Get Ship Position
get_ship_position获取船舶在海管家的最新位置和身份信息。 - List Ship Track Points
list_ship_track_points列出已订阅船舶在指定时间范围内的海管家轨迹点。 - Batch Get Truck Positions
batch_get_truck_positions批量获取货车当前位置。仅查询调用者有权跟踪的车辆；海管家可能对本次请求收费。 - List Truck Track Points
list_truck_track_points列出货车历史轨迹和停车事件。仅查询调用者有权跟踪的车辆；海管家将每次查询标记为收费。 - Subscribe Full Journey Tracking
subscribe_full_journey_tracking订阅提单号、订舱/SO 号或箱号的船公司全程跟踪。提交订阅免费，但回调数据按返回箱数计费，因此 Connector 不会自动重试该请求。 - Get Full Journey Tracking
get_full_journey_tracking查询当前海管家账号此前订阅的船公司全程数据，可在未收到回调时作为补充查询。 - Send Shanghai Manifest
send_shanghai_manifest通过海管家发送完整的上海港舱单。海管家按关单号计费，因此 Connector 不会自动重试该请求。 - Get Shanghai Manifest Status
get_shanghai_manifest_status查询当前海管家账号所发送关单号的舱单发送回执。 - Resend Shanghai Manifest
resend_shanghai_manifest重发被海管家退单的上海港原始舱单。该接口仅接受被退回的原始单，Connector 不会自动重试。 - Withdraw Shanghai Manifest
withdraw_shanghai_manifest撤销被退单的上海港舱单发送；撤单成功后退还官方记录的余额或次数。 - List Shanghai Shipping Agents
list_shanghai_shipping_agents按主提单、船公司、船名和航次查询候选上海港船代名称；海管家说明结果仅供参考。 - Validate Shanghai Voyage
validate_shanghai_voyage检验上海港船名和航次，并返回挂靠港及当前计划时间。 - Update Shanghai Manifest
update_shanghai_manifest覆盖上海港现有舱单中的指定关单。海管家按实际修改的关单号计费，因此 Connector 不会自动重试。 - Get Shanghai Manifest Update Status
get_shanghai_manifest_update_status查询当前海管家账号提交的上海港舱单改单回执状态。 - Delete Shanghai Manifest
delete_shanghai_manifest从上海港现有舱单中删除指定关单。海管家按关单号计费，因此 Connector 不会自动重试。 - Get Shanghai Manifest Deletion Status
get_shanghai_manifest_deletion_status查询当前海管家账号提交的上海港舱单删单回执状态。 - Subscribe Port Container
subscribe_port_container订阅宁波、上海、深圳或青岛港箱货数据。提交订阅免费，但回调按返回提单或订舱号计费，因此 Connector 不会自动重试。 - Get Port Container
get_port_container查询宁波、上海、深圳或青岛港当前箱货数据。海管家会自动订阅缺失数据，因此本操作可能创建收费回调工作流，Connector 不会自动重试。 - Get Ningbo Master House Bills
get_ningbo_master_house_bills解析宁波港主分单关系，调用方无需预先判断输入的是主单还是分单。
海管家 怎么登录
- 登录方式
- 自定义凭证连接海管家 AppKey 和 16 字节 AppSecret。
- 需要准备
- 已开通相应产品权限的海管家凭据；部分单证流程还需独立业务 API Key。
- 说明
- 查询与申报可能消耗次数或余额。港口查询可能自动创建计费订阅流程；船舶历史轨迹需已有订阅。