# 将 海管家 接入 Open Flow

Source: https://openflow.run/zh-cn/integrations/hgj/

[全部集成](https://openflow.run/zh-cn/integrations/)

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

*   [76 个工具](https://openflow.run/zh-cn/integrations/hgj/#integration-actions)
*   自定义凭据
*   地图与位置
*   数据与分析
*   跨境电商

[连接 海管家](https://console.openflow.run/connections/hgj)

每月 20,000 次免费应用调用（付费服务另计）

## 可以做什么

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

### 船舶、车辆与船公司跟踪

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

### 港口集装箱与船期

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

### 舱单提交与回执

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

## 所有工具

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`

没有符合搜索条件的工具。

## 将 海管家 接入 Open Flow

[连接 海管家](https://console.openflow.run/connections/hgj)

每月 20,000 次免费应用调用（付费服务另计）
