Connect HaiGuanJia to Your AI Agent

Identify a vessel, tracking subscription, or submitted declaration to organize its available status information.

Try a HaiGuanJia Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill HaiGuanJia

Review a Subscribed Vessel’s Track

Read the latest position and historical points for a subscribed vessel.

/oo HaiGuanJia: For the already subscribed HaiGuanJia vessel [MMSI], read its latest position and track points from [start date and time] to [end date and time]. Summarize the available locations and observation times.

Check a Shanghai Manifest Receipt

Read receipts for a declaration submitted by the connected account.

/oo HaiGuanJia: Read HaiGuanJia Shanghai manifest receipts for customs declaration [declaration number] submitted through this account. Summarize acceptance or rejection details without resending or changing it.

Start Working with HaiGuanJia

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect HaiGuanJia

Connect your HaiGuanJia AppKey and 16-byte AppSecret.
Connect HaiGuanJia →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

HaiGuanJia credentials with the relevant product access; certain document workflows also need a separate business-body API Key.
Queries and filings may consume usage or balance. Port queries can automatically create billed subscription workflows; vessel history needs an existing subscription.

HaiGuanJia Tools

HaiGuanJia connects vessel and authorized vehicle tracking, port schedules and container data, domestic and international manifest workflows, and logistics document services.

Vessels, Vehicles, and Carrier Tracking

Read vessel positions and tracks, query authorized trucks, and read a carrier tracking subscription.

Port Containers and Schedules

Query port container or schedule data and create the required subscriptions or schedule bindings.

Manifest Submission and Receipts

Submit complete Shanghai or Qingdao manifests, read Shanghai receipts, or request selected manifest changes.

76 tools

Subscribe Ship

Subscribe a vessel in HaiGuanJia so its track information can be queried.

hgj.subscribe_ship

Get Ship Position

Get the latest HaiGuanJia position and identity data for a vessel.

hgj.get_ship_position

List Ship Track Points

List HaiGuanJia track points for a previously subscribed vessel within a time range.

hgj.list_ship_track_points

Batch Get Truck Positions

Get current positions for multiple trucks. Only query vehicles that the caller is authorized to track. HaiGuanJia may charge for this request.

hgj.batch_get_truck_positions

List Truck Track Points

List a truck's historical track and parking events. Only query vehicles that the caller is authorized to track. HaiGuanJia documents this query as chargeable on every request.

hgj.list_truck_track_points

Subscribe Full Journey Tracking

Subscribe a bill, booking/SO number, or container for HaiGuanJia carrier full-journey tracking. Subscription submission is free, but delivered callback data is billed per returned container, so Connector never retries this request automatically.

hgj.subscribe_full_journey_tracking

Get Full Journey Tracking

Get carrier full-journey data for a subscription previously created by the connected HaiGuanJia account. Use this as a fallback when a callback was not received.

hgj.get_full_journey_tracking

Send Shanghai Manifest

Send a complete Shanghai port manifest through HaiGuanJia. HaiGuanJia charges once per customs declaration number, so Connector never retries this request automatically.

hgj.send_shanghai_manifest

Get Shanghai Manifest Status

Get send receipts for a customs declaration submitted through the connected HaiGuanJia account.

hgj.get_shanghai_manifest_status

Resend Shanghai Manifest

Resend an original Shanghai manifest that HaiGuanJia has rejected. This endpoint only accepts the rejected original manifest and Connector never retries it automatically.

hgj.resend_shanghai_manifest

Withdraw Shanghai Manifest

Withdraw a rejected Shanghai manifest submission. A successful withdrawal refunds the documented balance or usage count.

hgj.withdraw_shanghai_manifest

List Shanghai Shipping Agents

List candidate Shanghai shipping agent names for a bill, carrier, vessel, and voyage. HaiGuanJia documents the result as reference data only.

hgj.list_shanghai_shipping_agents

Validate Shanghai Voyage

Validate a Shanghai vessel and voyage and return its port calls and current planned timing.

hgj.validate_shanghai_voyage

Update Shanghai Manifest

Overwrite selected customs declarations in an existing Shanghai manifest. HaiGuanJia charges for each modified customs declaration, so Connector never retries this request automatically.

hgj.update_shanghai_manifest

Get Shanghai Manifest Update Status

Get the receipt status for a Shanghai manifest update submitted through the connected HaiGuanJia account.

hgj.get_shanghai_manifest_update_status

Delete Shanghai Manifest

Delete selected customs declarations from an existing Shanghai manifest. HaiGuanJia charges once per declaration, so Connector never retries this request automatically.

hgj.delete_shanghai_manifest

Get Shanghai Manifest Deletion Status

Get the receipt status for a Shanghai manifest deletion submitted through the connected HaiGuanJia account.

hgj.get_shanghai_manifest_deletion_status

Subscribe Port Container

Subscribe Ningbo, Shanghai, Shenzhen, or Qingdao container/cargo data. Submission is free but callbacks are billed per returned bill or booking number, so Connector never retries automatically.

hgj.subscribe_port_container

Get Port Container

Get current Ningbo, Shanghai, Shenzhen, or Qingdao container/cargo data. HaiGuanJia automatically subscribes missing data, so this operation may create a billed callback workflow and Connector never retries it automatically.

hgj.get_port_container

Get Ningbo Master House Bills

Resolve Ningbo master and house bill relationships without requiring the caller to identify whether the supplied bill is a master or house bill.

hgj.get_ningbo_master_house_bills

Bind Ningbo Schedule

Bind a Ningbo bill to an explicit vessel schedule.

hgj.bind_ningbo_schedule

Bind Shanghai Schedule

Bind a Shanghai bill to an explicit HaiGuanJia vessel schedule.

hgj.bind_shanghai_schedule

Subscribe Port Schedule

Subscribe Ningbo, Shanghai, Shenzhen, or Qingdao vessel schedule data. Submission is free but callbacks are billed per returned vessel and voyage, subscriptions expire after 45 days, and Connector never retries automatically.

hgj.subscribe_port_schedule

Get Port Schedule

Get current Ningbo, Shanghai, Shenzhen, or Qingdao vessel schedule data. HaiGuanJia automatically subscribes missing or expired schedules, so Connector never retries this request automatically.

hgj.get_port_schedule

Send Qingdao Manifest

Send a Qingdao manifest using HaiGuanJia coins. The request is chargeable and Connector never retries it automatically.

hgj.send_qingdao_manifest

Resend Qingdao Manifest

Resend the rejected original Qingdao manifest. Connector sends the operation once and never retries automatically.

hgj.resend_qingdao_manifest

Withdraw Qingdao Manifest

Withdraw a rejected Qingdao manifest and request the documented refund.

hgj.withdraw_qingdao_manifest

Validate Qingdao Voyage

Validate a Qingdao vessel and voyage using the product API ID rather than the conflicting example ID.

hgj.validate_qingdao_voyage

Get Qingdao Shipping Agent

Get the Qingdao shipping agent for a bill, carrier, vessel, and voyage.

hgj.get_qingdao_shipping_agent

Update Qingdao Manifest

Overwrite a Qingdao manifest. HaiGuanJia charges for affected master and house bills, so Connector never retries automatically.

hgj.update_qingdao_manifest

Reallocate Qingdao Manifest

Reallocate a Qingdao manifest to another vessel and voyage. The official page has conflicting billing labels, so Connector treats it as potentially chargeable and never retries automatically.

hgj.reallocate_qingdao_manifest

Delete Qingdao Manifest

Delete one or more Qingdao manifest declaration groups and return the declarations that HaiGuanJia could not delete.

hgj.delete_qingdao_manifest

Send Tianjin Manifest

Send a complete Tianjin manifest including VGM and attachments. The workflow is chargeable, so Connector never retries automatically.

hgj.send_tianjin_manifest

Send Tianjin Pickup Order

Send a Tianjin pickup order. HaiGuanJia documents this sub-interface as free, but the required attachment URLs and all business data remain redacted from execution logs.

hgj.send_tianjin_pickup_order

Send Shenzhen Manifest

Send a complete Shenzhen manifest. HaiGuanJia documents the request as chargeable, so Connector never retries automatically.

hgj.send_shenzhen_manifest

Send Nansha Manifest

Send a complete Nansha manifest. HaiGuanJia documents the request as chargeable, so Connector never retries automatically.

hgj.send_nansha_manifest

Get Shenzhen Nansha Schedule

Query Shenzhen or Nansha vessel schedules using the selected product API ID and the shared official endpoint.

hgj.get_shenzhen_nansha_schedule

Send Vgm

Send or resend multi-port VGM data. HaiGuanJia charges for every container on every call, including resends, so Connector never retries automatically.

hgj.send_vgm

Subscribe Us Customs Data

Subscribe US destination customs data for a bill and carrier. HaiGuanJia documents this request as chargeable, so Connector never retries automatically.

hgj.subscribe_us_customs_data

Subscribe Us Terminal Data

Subscribe US terminal data for a container and port. HaiGuanJia documents this request as chargeable, so Connector never retries automatically.

hgj.subscribe_us_terminal_data

Subscribe New Us Customs

Submit a new US customs-data subscription. HaiGuanJia bills this workflow on the business side, so Connector never retries automatically.

hgj.subscribe_new_us_customs

Get New Us Customs

Get the complete new US customs result for a prior HaiGuanJia query, including BOL, air, importer-bond, and in-bond data when present.

hgj.get_new_us_customs

Send Afr Manifest

Send an AFR manifest. HaiGuanJia charges once per house bill, so Connector never retries automatically.

hgj.send_afr_manifest

Update Afr Manifest

Overwrite an existing AFR house bill and its complete container data.

hgj.update_afr_manifest

Delete Afr Manifest

Delete an AFR house bill with the required cancellation reason.

hgj.delete_afr_manifest

Send Ams Manifest

Send an AMS manifest through HaiGuanJia agency service or the customer's own SCAC channel. Each house bill is chargeable and Connector never retries automatically.

hgj.send_ams_manifest

Update Ams Manifest

Overwrite an AMS manifest through the selected agency or customer SCAC channel.

hgj.update_ams_manifest

Delete Ams Manifest

Delete an AMS house bill through the selected agency or customer SCAC channel.

hgj.delete_ams_manifest

Send Isf5 Manifest

Send an ISF-5 manifest through HaiGuanJia agency filing or the customer's own FILER CODE channel. Each AMS bill is chargeable and Connector never retries automatically.

hgj.send_isf5_manifest

Update Isf5 Manifest

Overwrite an ISF-5 manifest through the selected agency or customer FILER CODE channel.

hgj.update_isf5_manifest

Delete Isf5 Manifest

Delete an ISF-5 AMS bill through the selected agency or customer FILER CODE channel.

hgj.delete_isf5_manifest

Send Isf10 Manifest

Send an ISF-10 manifest through HaiGuanJia agency filing or the customer's own FILER CODE channel. Each AMS bill is chargeable and Connector never retries automatically.

hgj.send_isf10_manifest

Update Isf10 Manifest

Overwrite an ISF-10 manifest through the selected agency or customer FILER CODE channel.

hgj.update_isf10_manifest

Delete Isf10 Manifest

Delete an ISF-10 AMS bill through the selected agency or customer FILER CODE channel.

hgj.delete_isf10_manifest

Send Em Manifest

Send an EM manifest through agency filing or the customer's own 8000-code channel. Each house bill is chargeable and Connector never retries automatically.

hgj.send_em_manifest

Update Em Manifest

Overwrite an EM manifest through the selected agency or customer channel.

hgj.update_em_manifest

Delete Em Manifest

Delete an EM house bill through the selected agency or customer channel.

hgj.delete_em_manifest

Check Em Bill Availability

Check whether an EM 8000-code and house-bill combination is available.

hgj.check_em_bill_availability

Close Em Manifest

Submit EM Close for a full 8000-code house bill. The official page has conflicting free/consumption wording, so Connector treats it as potentially chargeable and never retries automatically.

hgj.close_em_manifest

Cancel Em Manifest Close

Cancel EM Close for a full 8000-code house bill.

hgj.cancel_em_manifest_close

Send Aci Manifest

Send an ACI manifest through agency filing or the customer's own 8000-code channel. Each house bill is chargeable and Connector never retries automatically.

hgj.send_aci_manifest

Update Aci Manifest

Overwrite an ACI manifest through the selected agency or customer channel.

hgj.update_aci_manifest

Delete Aci Manifest

Delete an ACI house bill through the selected agency or customer channel.

hgj.delete_aci_manifest

Check Aci Bill Availability

Check whether an ACI 8000-code and house-bill combination is available.

hgj.check_aci_bill_availability

Send Ics2 Manifest

Send an ICS2 F14, F15, F16, or F17 manifest. HaiGuanJia bills the submission on the business side, so Connector never retries automatically.

hgj.send_ics2_manifest

Update Ics2 Manifest

Overwrite an ICS2 F14, F15, F16, or F17 manifest identified by billId.

hgj.update_ics2_manifest

Delete Ics2 Manifest

Delete an ICS2 manifest through the shared endpoint while preserving the selected F14, F15, F16, or F17 product API ID.

hgj.delete_ics2_manifest

Submit Export Customs Recognition

Submit a chargeable export customs-recognition task. HaiGuanJia fetches each fileUrl and Connector never retries automatically.

hgj.submit_export_customs_recognition

Get Export Customs Recognition Result

Get the current export customs-recognition task state and structured or customs-XML result.

hgj.get_export_customs_recognition_result

Submit Import Customs Recognition

Submit a chargeable import customs-recognition task. HaiGuanJia fetches each fileUrl and Connector never retries automatically.

hgj.submit_import_customs_recognition

Get Import Customs Recognition Result

Get the current import customs-recognition task state and structured or customs-XML result.

hgj.get_import_customs_recognition_result

Recognize Document

Recognize one or more documents with a fixed HaiGuanJia product template. This business-side billed request requires the connection's separate secondaryApiKey and is never retried automatically.

hgj.recognize_document

Recognize Custom Document

Recognize one or more documents with a promptCode maintained in HaiGuanJia's external Storybrooke console. This business-side billed request requires the connection's separate secondaryApiKey and is never retried automatically.

hgj.recognize_custom_document

Submit Ai Customs Intake

Submit a new AI customs-intake request. Connector fixes isModify to false and HaiGuanJia fetches each attachment URL.

hgj.submit_ai_customs_intake

Update Ai Customs Intake

Overwrite an existing AI customs-intake request. Connector fixes isModify to true and HaiGuanJia fetches each attachment URL.

hgj.update_ai_customs_intake

Get Ai Customs Intake Status

Get the raw HaiGuanJia AI customs-intake status. Automatic wait semantics are unavailable because the official status enum is not documented.

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

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 Triggers

Frequently Asked Questions

What does vessel history require?

Provide the vessel MMSI and start and end times. The vessel must already be subscribed before its historical track can be queried.

Does sending a manifest mean it was accepted?

A send result and a later receipt are separate. Use the declaration or modification identifier to read the relevant receipt and inspect its status.

Can a port lookup create a subscription?

Yes. Missing container data or missing or expired schedules may cause an automatic subscription. Callback data can be billed, so review the product access and usage conditions before querying.