将 海管家 接入 Open Flow
查看船舶进度,或找出舱单退回后需要更正的内容。
每月 20,000 次免费应用调用(付费服务另计)
可以做什么
可访问已订阅船舶轨迹、获授权车辆数据、港口信息,以及支持的舱单提交与回执流程。
船舶、车辆与船公司跟踪
读取船舶位置与轨迹、查询获授权车辆,并读取船公司跟踪订阅。
港口集装箱与船期
查询港口集装箱或船期数据,创建所需订阅或船期绑定。
舱单提交与回执
提交完整上海或青岛舱单、读取上海回执,或请求指定舱单变更。
所有工具
Subscribe Ship
在海管家订阅船舶,以便后续查询该船舶的轨迹信息。
hgj.subscribe_shipGet Ship Position
获取船舶在海管家的最新位置和身份信息。
hgj.get_ship_positionList Ship Track Points
列出已订阅船舶在指定时间范围内的海管家轨迹点。
hgj.list_ship_track_pointsBatch Get Truck Positions
批量获取货车当前位置。仅查询调用者有权跟踪的车辆;海管家可能对本次请求收费。
hgj.batch_get_truck_positionsList Truck Track Points
列出货车历史轨迹和停车事件。仅查询调用者有权跟踪的车辆;海管家将每次查询标记为收费。
hgj.list_truck_track_pointsSubscribe Full Journey Tracking
订阅提单号、订舱/SO 号或箱号的船公司全程跟踪。提交订阅免费,但回调数据按返回箱数计费,因此 Connector 不会自动重试该请求。
hgj.subscribe_full_journey_trackingGet Full Journey Tracking
查询当前海管家账号此前订阅的船公司全程数据,可在未收到回调时作为补充查询。
hgj.get_full_journey_trackingSend Shanghai Manifest
通过海管家发送完整的上海港舱单。海管家按关单号计费,因此 Connector 不会自动重试该请求。
hgj.send_shanghai_manifestGet Shanghai Manifest Status
查询当前海管家账号所发送关单号的舱单发送回执。
hgj.get_shanghai_manifest_statusResend Shanghai Manifest
重发被海管家退单的上海港原始舱单。该接口仅接受被退回的原始单,Connector 不会自动重试。
hgj.resend_shanghai_manifestWithdraw Shanghai Manifest
撤销被退单的上海港舱单发送;撤单成功后退还官方记录的余额或次数。
hgj.withdraw_shanghai_manifestList Shanghai Shipping Agents
按主提单、船公司、船名和航次查询候选上海港船代名称;海管家说明结果仅供参考。
hgj.list_shanghai_shipping_agentsValidate Shanghai Voyage
检验上海港船名和航次,并返回挂靠港及当前计划时间。
hgj.validate_shanghai_voyageUpdate Shanghai Manifest
覆盖上海港现有舱单中的指定关单。海管家按实际修改的关单号计费,因此 Connector 不会自动重试。
hgj.update_shanghai_manifestGet Shanghai Manifest Update Status
查询当前海管家账号提交的上海港舱单改单回执状态。
hgj.get_shanghai_manifest_update_statusDelete Shanghai Manifest
从上海港现有舱单中删除指定关单。海管家按关单号计费,因此 Connector 不会自动重试。
hgj.delete_shanghai_manifestGet Shanghai Manifest Deletion Status
查询当前海管家账号提交的上海港舱单删单回执状态。
hgj.get_shanghai_manifest_deletion_statusSubscribe Port Container
订阅宁波、上海、深圳或青岛港箱货数据。提交订阅免费,但回调按返回提单或订舱号计费,因此 Connector 不会自动重试。
hgj.subscribe_port_containerGet Port Container
查询宁波、上海、深圳或青岛港当前箱货数据。海管家会自动订阅缺失数据,因此本操作可能创建收费回调工作流,Connector 不会自动重试。
hgj.get_port_containerGet Ningbo Master House Bills
解析宁波港主分单关系,调用方无需预先判断输入的是主单还是分单。
hgj.get_ningbo_master_house_billsBind Ningbo Schedule
将宁波港提单绑定到明确的船期。
hgj.bind_ningbo_scheduleBind Shanghai Schedule
将上海港提单绑定到明确的海管家船期。
hgj.bind_shanghai_scheduleSubscribe Port Schedule
订阅宁波、上海、深圳或青岛港船期数据。提交免费但回调按返回船名和航次计费,订阅 45 天后过期,Connector 不会自动重试。
hgj.subscribe_port_scheduleGet Port Schedule
查询宁波、上海、深圳或青岛港当前船期数据。海管家会自动订阅缺失或过期船期,因此 Connector 不会自动重试。
hgj.get_port_scheduleSend Qingdao Manifest
使用海管家海币发送青岛港舱单。该请求收费,Connector 不会自动重试。
hgj.send_qingdao_manifestResend Qingdao Manifest
重发被退单的青岛港原始舱单。Connector 只发送一次且不会自动重试。
hgj.resend_qingdao_manifestWithdraw Qingdao Manifest
撤销被退单的青岛港舱单并请求官方记录的退款。
hgj.withdraw_qingdao_manifestValidate Qingdao Voyage
使用产品 API ID 检验青岛港船名航次,不采用页面中冲突的示例 ID。
hgj.validate_qingdao_voyageGet Qingdao Shipping Agent
按提单、船公司、船名和航次查询青岛港船代。
hgj.get_qingdao_shipping_agentUpdate Qingdao Manifest
覆盖青岛港舱单。海管家按受影响的主分单计费,因此 Connector 不会自动重试。
hgj.update_qingdao_manifestReallocate Qingdao Manifest
将青岛港舱单改配到另一船名航次。官方页面收费标记冲突,因此 Connector 按可能收费处理且不会自动重试。
hgj.reallocate_qingdao_manifestDelete Qingdao Manifest
批量删除青岛港舱单关单组,并返回海管家未能删除的关单号。
hgj.delete_qingdao_manifestSend Tianjin Manifest
发送包含 VGM 和附件的完整天津港舱单。该工作流收费,因此 Connector 不会自动重试。
hgj.send_tianjin_manifestSend Tianjin Pickup Order
发送天津港提箱单。海管家将此子接口标为免费,但附件 URL 和全部业务数据仍从 execution log 脱敏。
hgj.send_tianjin_pickup_orderSend Shenzhen Manifest
发送完整的深圳港舱单。海管家将该请求标为收费,因此 Connector 不会自动重试。
hgj.send_shenzhen_manifestSend Nansha Manifest
发送完整的南沙舱单。海管家将该请求标为收费,因此 Connector 不会自动重试。
hgj.send_nansha_manifestGet Shenzhen Nansha Schedule
通过所选产品 API ID 和共享官方 endpoint 查询深圳或南沙船期。
hgj.get_shenzhen_nansha_scheduleSend Vgm
发送或重发多口岸 VGM。海管家对每次调用中的每个箱子收费,包括重发,因此 Connector 不会自动重试。
hgj.send_vgmSubscribe Us Customs Data
按提单和船公司订阅美国目的港海关数据。海管家将该请求标为收费,因此 Connector 不会自动重试。
hgj.subscribe_us_customs_dataSubscribe Us Terminal Data
按箱号和港口订阅美国码头数据。海管家将该请求标为收费,因此 Connector 不会自动重试。
hgj.subscribe_us_terminal_dataSubscribe New Us Customs
提交新美国海关数据订阅。海管家在业务侧对该工作流计费,因此 Connector 不会自动重试。
hgj.subscribe_new_us_customsGet New Us Customs
查询海管家此前请求的完整新美国海关结果,包括存在时的 BOL、空运、进口商担保和 in-bond 数据。
hgj.get_new_us_customsSend Afr Manifest
发送 AFR 舱单。海管家按货代分单计费,因此 Connector 不会自动重试。
hgj.send_afr_manifestUpdate Afr Manifest
覆盖现有 AFR 货代分单及其完整箱货数据。
hgj.update_afr_manifestDelete Afr Manifest
使用必填撤销原因删除 AFR 货代分单。
hgj.delete_afr_manifestSend Ams Manifest
通过海管家代发或客户自有 SCAC 通道发送 AMS 舱单。每个货代分单收费,Connector 不会自动重试。
hgj.send_ams_manifestUpdate Ams Manifest
通过所选代发或客户 SCAC 通道覆盖 AMS 舱单。
hgj.update_ams_manifestDelete Ams Manifest
通过所选代发或客户 SCAC 通道删除 AMS 货代分单。
hgj.delete_ams_manifestSend Isf5 Manifest
通过海管家代发或客户自有 FILER CODE 通道发送 ISF-5。每个 AMS 提单收费,Connector 不会自动重试。
hgj.send_isf5_manifestUpdate Isf5 Manifest
通过所选代发或客户 FILER CODE 通道覆盖 ISF-5。
hgj.update_isf5_manifestDelete Isf5 Manifest
通过所选代发或客户 FILER CODE 通道删除 ISF-5 AMS 提单。
hgj.delete_isf5_manifestSend Isf10 Manifest
通过海管家代发或客户自有 FILER CODE 通道发送 ISF-10。每个 AMS 提单收费,Connector 不会自动重试。
hgj.send_isf10_manifestUpdate Isf10 Manifest
通过所选代发或客户 FILER CODE 通道覆盖 ISF-10。
hgj.update_isf10_manifestDelete Isf10 Manifest
通过所选代发或客户 FILER CODE 通道删除 ISF-10 AMS 提单。
hgj.delete_isf10_manifestSend Em Manifest
通过代发或客户自有 8000 code 通道发送 EM。每个货代分单收费,Connector 不会自动重试。
hgj.send_em_manifestUpdate Em Manifest
通过所选代发或客户通道覆盖 EM 舱单。
hgj.update_em_manifestDelete Em Manifest
通过所选代发或客户通道删除 EM 货代分单。
hgj.delete_em_manifestCheck Em Bill Availability
检查 EM 8000 code 与货代分单号组合是否可用。
hgj.check_em_bill_availabilityClose Em Manifest
对完整 8000 code 分单提交 EM Close。官方页面免费/消费表述冲突,因此按可能收费处理且不自动重试。
hgj.close_em_manifestCancel Em Manifest Close
取消完整 8000 code 分单的 EM Close。
hgj.cancel_em_manifest_closeSend Aci Manifest
通过代发或客户自有 8000 code 通道发送 ACI。每个货代分单收费,Connector 不会自动重试。
hgj.send_aci_manifestUpdate Aci Manifest
通过所选代发或客户通道覆盖 ACI 舱单。
hgj.update_aci_manifestDelete Aci Manifest
通过所选代发或客户通道删除 ACI 货代分单。
hgj.delete_aci_manifestCheck Aci Bill Availability
检查 ACI 8000 code 与货代分单号组合是否可用。
hgj.check_aci_bill_availabilitySend Ics2 Manifest
发送 ICS2 F14、F15、F16 或 F17 舱单。海管家在业务侧计费,因此 Connector 不会自动重试。
hgj.send_ics2_manifestUpdate Ics2 Manifest
按 billId 覆盖 ICS2 F14、F15、F16 或 F17 舱单。
hgj.update_ics2_manifestDelete Ics2 Manifest
通过共享 endpoint 删除 ICS2 舱单,同时保留所选 F14、F15、F16 或 F17 产品 API ID。
hgj.delete_ics2_manifestSubmit Export Customs Recognition
提交收费的出口报关识别任务。海管家抓取每个 fileUrl,Connector 不会自动重试。
hgj.submit_export_customs_recognitionGet Export Customs Recognition Result
查询出口报关识别任务当前状态及结构化或海关 XML 结果。
hgj.get_export_customs_recognition_resultSubmit Import Customs Recognition
提交收费的进口报关识别任务。海管家抓取每个 fileUrl,Connector 不会自动重试。
hgj.submit_import_customs_recognitionGet Import Customs Recognition Result
查询进口报关识别任务当前状态及结构化或海关 XML 结果。
hgj.get_import_customs_recognition_resultRecognize Document
使用固定海管家产品模板识别一个或多个单证。这是业务侧收费请求,需要连接中独立配置 secondaryApiKey,Connector 不会自动重试。
hgj.recognize_documentRecognize Custom Document
使用在海管家外部童话镇后台维护的 promptCode 识别一个或多个单证。这是业务侧收费请求,需要连接中独立配置 secondaryApiKey,Connector 不会自动重试。
hgj.recognize_custom_documentSubmit Ai Customs Intake
提交新的 AI 报关接单。Connector 固定 isModify=false,附件 URL 由海管家抓取。
hgj.submit_ai_customs_intakeUpdate Ai Customs Intake
覆盖现有 AI 报关接单。Connector 固定 isModify=true,附件 URL 由海管家抓取。
hgj.update_ai_customs_intakeGet Ai Customs Intake Status
查询海管家 AI 报关接单原始状态。官方未记录状态枚举,因此不能自动推断 wait 语义。
hgj.get_ai_customs_intake_status没有符合搜索条件的工具。
将 海管家 接入 Open Flow
每月 20,000 次免费应用调用(付费服务另计)