让你的 AI Agent 连接 海管家

查看船舶进度,或找出舱单退回后需要更正的内容。

76 个工具 33 触发器 Custom credential

试试这些 海管家 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo Skill 海管家

查看已订阅船舶轨迹

读取已订阅船舶的最新位置与历史轨迹点。

/oo 海管家: 查看已订阅船舶 [MMSI] 在 [开始时间] 至 [结束时间] 的航迹及最新位置,保留观测时间。

查询上海舱单回执

读取连接账号提交的报关单回执。

/oo 海管家: 查询当前账号提交的申报单 [编号] 的上海舱单回执,解释退回原因,暂不修改或重发。

开始使用 海管家

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 海管家

    连接海管家 AppKey 和 16 字节 AppSecret。

    连接 海管家 →
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →

选择你的 Agent

  • 已开通相应产品权限的海管家凭据;部分单证流程还需独立业务 API Key。
  • 查询与申报可能消耗次数或余额。港口查询可能自动创建计费订阅流程;船舶历史轨迹需已有订阅。

海管家 工具

可访问已订阅船舶轨迹、获授权车辆数据、港口信息,以及支持的舱单提交与回执流程。

船舶、车辆与船公司跟踪

读取船舶位置与轨迹、查询获授权车辆,并读取船公司跟踪订阅。

港口集装箱与船期

查询港口集装箱或船期数据,创建所需订阅或船期绑定。

舱单提交与回执

提交完整上海或青岛舱单、读取上海回执,或请求指定舱单变更。

76 个工具

Subscribe Ship

在海管家订阅船舶,以便后续查询该船舶的轨迹信息。

hgj.subscribe_ship

Get Ship Position

获取船舶在海管家的最新位置和身份信息。

hgj.get_ship_position

List Ship Track Points

列出已订阅船舶在指定时间范围内的海管家轨迹点。

hgj.list_ship_track_points

Batch Get Truck Positions

批量获取货车当前位置。仅查询调用者有权跟踪的车辆;海管家可能对本次请求收费。

hgj.batch_get_truck_positions

List Truck Track Points

列出货车历史轨迹和停车事件。仅查询调用者有权跟踪的车辆;海管家将每次查询标记为收费。

hgj.list_truck_track_points

Subscribe Full Journey Tracking

订阅提单号、订舱/SO 号或箱号的船公司全程跟踪。提交订阅免费,但回调数据按返回箱数计费,因此 Connector 不会自动重试该请求。

hgj.subscribe_full_journey_tracking

Get Full Journey Tracking

查询当前海管家账号此前订阅的船公司全程数据,可在未收到回调时作为补充查询。

hgj.get_full_journey_tracking

Send Shanghai Manifest

通过海管家发送完整的上海港舱单。海管家按关单号计费,因此 Connector 不会自动重试该请求。

hgj.send_shanghai_manifest

Get Shanghai Manifest Status

查询当前海管家账号所发送关单号的舱单发送回执。

hgj.get_shanghai_manifest_status

Resend Shanghai Manifest

重发被海管家退单的上海港原始舱单。该接口仅接受被退回的原始单,Connector 不会自动重试。

hgj.resend_shanghai_manifest

Withdraw Shanghai Manifest

撤销被退单的上海港舱单发送;撤单成功后退还官方记录的余额或次数。

hgj.withdraw_shanghai_manifest

List Shanghai Shipping Agents

按主提单、船公司、船名和航次查询候选上海港船代名称;海管家说明结果仅供参考。

hgj.list_shanghai_shipping_agents

Validate Shanghai Voyage

检验上海港船名和航次,并返回挂靠港及当前计划时间。

hgj.validate_shanghai_voyage

Update Shanghai Manifest

覆盖上海港现有舱单中的指定关单。海管家按实际修改的关单号计费,因此 Connector 不会自动重试。

hgj.update_shanghai_manifest

Get Shanghai Manifest Update Status

查询当前海管家账号提交的上海港舱单改单回执状态。

hgj.get_shanghai_manifest_update_status

Delete Shanghai Manifest

从上海港现有舱单中删除指定关单。海管家按关单号计费,因此 Connector 不会自动重试。

hgj.delete_shanghai_manifest

Get Shanghai Manifest Deletion Status

查询当前海管家账号提交的上海港舱单删单回执状态。

hgj.get_shanghai_manifest_deletion_status

Subscribe Port Container

订阅宁波、上海、深圳或青岛港箱货数据。提交订阅免费,但回调按返回提单或订舱号计费,因此 Connector 不会自动重试。

hgj.subscribe_port_container

Get Port Container

查询宁波、上海、深圳或青岛港当前箱货数据。海管家会自动订阅缺失数据,因此本操作可能创建收费回调工作流,Connector 不会自动重试。

hgj.get_port_container

Get Ningbo Master House Bills

解析宁波港主分单关系,调用方无需预先判断输入的是主单还是分单。

hgj.get_ningbo_master_house_bills

Bind Ningbo Schedule

将宁波港提单绑定到明确的船期。

hgj.bind_ningbo_schedule

Bind Shanghai Schedule

将上海港提单绑定到明确的海管家船期。

hgj.bind_shanghai_schedule

Subscribe Port Schedule

订阅宁波、上海、深圳或青岛港船期数据。提交免费但回调按返回船名和航次计费,订阅 45 天后过期,Connector 不会自动重试。

hgj.subscribe_port_schedule

Get Port Schedule

查询宁波、上海、深圳或青岛港当前船期数据。海管家会自动订阅缺失或过期船期,因此 Connector 不会自动重试。

hgj.get_port_schedule

Send Qingdao Manifest

使用海管家海币发送青岛港舱单。该请求收费,Connector 不会自动重试。

hgj.send_qingdao_manifest

Resend Qingdao Manifest

重发被退单的青岛港原始舱单。Connector 只发送一次且不会自动重试。

hgj.resend_qingdao_manifest

Withdraw Qingdao Manifest

撤销被退单的青岛港舱单并请求官方记录的退款。

hgj.withdraw_qingdao_manifest

Validate Qingdao Voyage

使用产品 API ID 检验青岛港船名航次,不采用页面中冲突的示例 ID。

hgj.validate_qingdao_voyage

Get Qingdao Shipping Agent

按提单、船公司、船名和航次查询青岛港船代。

hgj.get_qingdao_shipping_agent

Update Qingdao Manifest

覆盖青岛港舱单。海管家按受影响的主分单计费,因此 Connector 不会自动重试。

hgj.update_qingdao_manifest

Reallocate Qingdao Manifest

将青岛港舱单改配到另一船名航次。官方页面收费标记冲突,因此 Connector 按可能收费处理且不会自动重试。

hgj.reallocate_qingdao_manifest

Delete Qingdao Manifest

批量删除青岛港舱单关单组,并返回海管家未能删除的关单号。

hgj.delete_qingdao_manifest

Send Tianjin Manifest

发送包含 VGM 和附件的完整天津港舱单。该工作流收费,因此 Connector 不会自动重试。

hgj.send_tianjin_manifest

Send Tianjin Pickup Order

发送天津港提箱单。海管家将此子接口标为免费,但附件 URL 和全部业务数据仍从 execution log 脱敏。

hgj.send_tianjin_pickup_order

Send Shenzhen Manifest

发送完整的深圳港舱单。海管家将该请求标为收费,因此 Connector 不会自动重试。

hgj.send_shenzhen_manifest

Send Nansha Manifest

发送完整的南沙舱单。海管家将该请求标为收费,因此 Connector 不会自动重试。

hgj.send_nansha_manifest

Get Shenzhen Nansha Schedule

通过所选产品 API ID 和共享官方 endpoint 查询深圳或南沙船期。

hgj.get_shenzhen_nansha_schedule

Send Vgm

发送或重发多口岸 VGM。海管家对每次调用中的每个箱子收费,包括重发,因此 Connector 不会自动重试。

hgj.send_vgm

Subscribe Us Customs Data

按提单和船公司订阅美国目的港海关数据。海管家将该请求标为收费,因此 Connector 不会自动重试。

hgj.subscribe_us_customs_data

Subscribe Us Terminal Data

按箱号和港口订阅美国码头数据。海管家将该请求标为收费,因此 Connector 不会自动重试。

hgj.subscribe_us_terminal_data

Subscribe New Us Customs

提交新美国海关数据订阅。海管家在业务侧对该工作流计费,因此 Connector 不会自动重试。

hgj.subscribe_new_us_customs

Get New Us Customs

查询海管家此前请求的完整新美国海关结果,包括存在时的 BOL、空运、进口商担保和 in-bond 数据。

hgj.get_new_us_customs

Send Afr Manifest

发送 AFR 舱单。海管家按货代分单计费,因此 Connector 不会自动重试。

hgj.send_afr_manifest

Update Afr Manifest

覆盖现有 AFR 货代分单及其完整箱货数据。

hgj.update_afr_manifest

Delete Afr Manifest

使用必填撤销原因删除 AFR 货代分单。

hgj.delete_afr_manifest

Send Ams Manifest

通过海管家代发或客户自有 SCAC 通道发送 AMS 舱单。每个货代分单收费,Connector 不会自动重试。

hgj.send_ams_manifest

Update Ams Manifest

通过所选代发或客户 SCAC 通道覆盖 AMS 舱单。

hgj.update_ams_manifest

Delete Ams Manifest

通过所选代发或客户 SCAC 通道删除 AMS 货代分单。

hgj.delete_ams_manifest

Send Isf5 Manifest

通过海管家代发或客户自有 FILER CODE 通道发送 ISF-5。每个 AMS 提单收费,Connector 不会自动重试。

hgj.send_isf5_manifest

Update Isf5 Manifest

通过所选代发或客户 FILER CODE 通道覆盖 ISF-5。

hgj.update_isf5_manifest

Delete Isf5 Manifest

通过所选代发或客户 FILER CODE 通道删除 ISF-5 AMS 提单。

hgj.delete_isf5_manifest

Send Isf10 Manifest

通过海管家代发或客户自有 FILER CODE 通道发送 ISF-10。每个 AMS 提单收费,Connector 不会自动重试。

hgj.send_isf10_manifest

Update Isf10 Manifest

通过所选代发或客户 FILER CODE 通道覆盖 ISF-10。

hgj.update_isf10_manifest

Delete Isf10 Manifest

通过所选代发或客户 FILER CODE 通道删除 ISF-10 AMS 提单。

hgj.delete_isf10_manifest

Send Em Manifest

通过代发或客户自有 8000 code 通道发送 EM。每个货代分单收费,Connector 不会自动重试。

hgj.send_em_manifest

Update Em Manifest

通过所选代发或客户通道覆盖 EM 舱单。

hgj.update_em_manifest

Delete Em Manifest

通过所选代发或客户通道删除 EM 货代分单。

hgj.delete_em_manifest

Check Em Bill Availability

检查 EM 8000 code 与货代分单号组合是否可用。

hgj.check_em_bill_availability

Close Em Manifest

对完整 8000 code 分单提交 EM Close。官方页面免费/消费表述冲突,因此按可能收费处理且不自动重试。

hgj.close_em_manifest

Cancel Em Manifest Close

取消完整 8000 code 分单的 EM Close。

hgj.cancel_em_manifest_close

Send Aci Manifest

通过代发或客户自有 8000 code 通道发送 ACI。每个货代分单收费,Connector 不会自动重试。

hgj.send_aci_manifest

Update Aci Manifest

通过所选代发或客户通道覆盖 ACI 舱单。

hgj.update_aci_manifest

Delete Aci Manifest

通过所选代发或客户通道删除 ACI 货代分单。

hgj.delete_aci_manifest

Check Aci Bill Availability

检查 ACI 8000 code 与货代分单号组合是否可用。

hgj.check_aci_bill_availability

Send Ics2 Manifest

发送 ICS2 F14、F15、F16 或 F17 舱单。海管家在业务侧计费,因此 Connector 不会自动重试。

hgj.send_ics2_manifest

Update Ics2 Manifest

按 billId 覆盖 ICS2 F14、F15、F16 或 F17 舱单。

hgj.update_ics2_manifest

Delete Ics2 Manifest

通过共享 endpoint 删除 ICS2 舱单,同时保留所选 F14、F15、F16 或 F17 产品 API ID。

hgj.delete_ics2_manifest

Submit Export Customs Recognition

提交收费的出口报关识别任务。海管家抓取每个 fileUrl,Connector 不会自动重试。

hgj.submit_export_customs_recognition

Get Export Customs Recognition Result

查询出口报关识别任务当前状态及结构化或海关 XML 结果。

hgj.get_export_customs_recognition_result

Submit Import Customs Recognition

提交收费的进口报关识别任务。海管家抓取每个 fileUrl,Connector 不会自动重试。

hgj.submit_import_customs_recognition

Get Import Customs Recognition Result

查询进口报关识别任务当前状态及结构化或海关 XML 结果。

hgj.get_import_customs_recognition_result

Recognize Document

使用固定海管家产品模板识别一个或多个单证。这是业务侧收费请求,需要连接中独立配置 secondaryApiKey,Connector 不会自动重试。

hgj.recognize_document

Recognize Custom Document

使用在海管家外部童话镇后台维护的 promptCode 识别一个或多个单证。这是业务侧收费请求,需要连接中独立配置 secondaryApiKey,Connector 不会自动重试。

hgj.recognize_custom_document

Submit Ai Customs Intake

提交新的 AI 报关接单。Connector 固定 isModify=false,附件 URL 由海管家抓取。

hgj.submit_ai_customs_intake

Update Ai Customs Intake

覆盖现有 AI 报关接单。Connector 固定 isModify=true,附件 URL 由海管家抓取。

hgj.update_ai_customs_intake

Get Ai Customs Intake Status

查询海管家 AI 报关接单原始状态。官方未记录状态枚举,因此不能自动推断 wait 语义。

hgj.get_ai_customs_intake_status

shanghai_manifest_send_receipt

Receive Shanghai manifest send receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shanghai_manifest_send_receipt 触发器

shanghai_manifest_update_receipt

Receive Shanghai manifest update receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shanghai_manifest_update_receipt 触发器

shanghai_manifest_delete_receipt

Receive Shanghai manifest deletion receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shanghai_manifest_delete_receipt 触发器

qingdao_manifest_receipt

Receive Qingdao manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.qingdao_manifest_receipt 触发器

tianjin_manifest_receipt

Receive Tianjin manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.tianjin_manifest_receipt 触发器

tianjin_pickup_order_receipt

Receive Tianjin pickup-order receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.tianjin_pickup_order_receipt 触发器

shenzhen_manifest_receipt

Receive Shenzhen manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shenzhen_manifest_receipt 触发器

nansha_manifest_receipt

Receive Nansha manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.nansha_manifest_receipt 触发器

afr_manifest_receipt

Receive AFR manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.afr_manifest_receipt 触发器

ams_manifest_receipt

Receive AMS manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.ams_manifest_receipt 触发器

em_manifest_receipt

Receive EM manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.em_manifest_receipt 触发器

em_close_receipt

Receive EM Close receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.em_close_receipt 触发器

aci_manifest_receipt

Receive ACI manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.aci_manifest_receipt 触发器

isf5_manifest_receipt

Receive ISF-5 manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.isf5_manifest_receipt 触发器

isf10_manifest_receipt

Receive ISF-10 manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.isf10_manifest_receipt 触发器

ics2_manifest_receipt

Receive ICS2 manifest receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.ics2_manifest_receipt 触发器

ningbo_container_updated

Receive Ningbo container and cargo updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.ningbo_container_updated 触发器

ningbo_schedule_updated

Receive Ningbo vessel schedule updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.ningbo_schedule_updated 触发器

ningbo_master_house_updated

Receive Ningbo master and house bill updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.ningbo_master_house_updated 触发器

shanghai_container_updated

Receive Shanghai container and cargo updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shanghai_container_updated 触发器

shanghai_schedule_updated

Receive Shanghai vessel schedule updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shanghai_schedule_updated 触发器

shenzhen_container_updated

Receive Shenzhen container and cargo updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shenzhen_container_updated 触发器

shenzhen_schedule_updated

Receive Shenzhen vessel schedule updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.shenzhen_schedule_updated 触发器

qingdao_container_updated

Receive Qingdao container and cargo updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.qingdao_container_updated 触发器

qingdao_schedule_updated

Receive Qingdao vessel schedule updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.qingdao_schedule_updated 触发器

port_alert_received

Receive Port-area push and warning events from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.port_alert_received 触发器

domestic_customs_data_updated

Receive Domestic customs-data updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.domestic_customs_data_updated 触发器

us_customs_data_updated

Receive US destination customs-data updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.us_customs_data_updated 触发器

us_terminal_data_updated

Receive US destination terminal-data updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.us_terminal_data_updated 触发器

new_us_customs_updated

Receive New US customs-data updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.new_us_customs_updated 触发器

vgm_receipt

Receive VGM send receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.vgm_receipt 触发器

full_journey_tracking_updated

Receive Carrier full-journey tracking updates from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.full_journey_tracking_updated 触发器

unified_receipt

Receive Unified-channel receipts from HaiGuanJia. Delivery uses a conservative HTTP 200 acknowledgement and best-effort content deduplication because the official ACK and event-ID contract is not documented.

hgj.unified_receipt 触发器

常见问题

可以查询任意船舶的历史轨迹吗?

历史轨迹需要先订阅船舶,并提供 MMSI 和时间范围。

发出舱单就代表受理了吗?

不代表。需要查看后续回执,确认受理情况或待更正内容。

港口信息查询可能产生费用吗?

部分缺失或过期的港口数据会触发订阅,回调数据可能计费,请核对账号的服务约定。

连接 海管家

关于 海管家 ↗