Nowlun Track Actor

Description

The Nowlun Track actor enables clients to track shipments on the Nowlun platform (https://nowlun.com). It retrieves detailed shipment information, including booking number, shipping line, cargo, ports, and tracking updates, using a booking number or bill of lading (B/L). Authentication is optional, and the actor returns an "Unauthorized" message if credentials are not provided.

Features

• Tracks shipments by booking number or B/L.
• Automatically detects the shipping line if not specified.
• Provides comprehensive shipment details, including port information and tracking updates.
• Supports optional authentication for enhanced access.

Input Schema

find selectors here: "https://apify.com/maged120/nowlun-selectors" with search query functionality

Field	Type	Required	Description
booking_number	String	Yes	The shipment booking number or B/L (e.g., "HLCUALY240509398").
selector	String	Yes	Either "booking" or "bl" to specify the tracking type.
shipping_line	String	No	The shipping line (e.g., "Hapag-Lloyd"). Auto-detected if not provided. Use Nowlun Selectors actor to get valid shipping lines.
email	String	Yes	Nowlun account email for authentication.
password	String	Yes	Nowlun account password. If omitted, returns "Unauthorized" message.

Example Input:

{
  "booking_number": "HLCUALY240509398",
  "selector": "booking",
  "shipping_line": "Hapag-Lloyd",
  "email": "user@example.com",
  "password": "yourpassword"
}

Shipping Lines can also be found in the nowlun selectors actor with search functionality

[
    "ADMIRAL",
    "ARKAS",
    "Aladin Express",
    "BMC",
    "CMA",
    "COSCO",
    "CULINES",
    "Cordelia",
    "ECON",
    "ESL",
    "EVERGREEN",
    "FESCO",
    "HMM",
    "Hapag-Lloyd",
    "KMTC",
    "MAERSK",
    "MARFRET",
    "MARINA",
    "MEDKON",
    "MSC",
    "Messina",
    "ONE",
    "OOCL",
    "OVP Shipping",
    "PIL",
    "RCL",
    "SEA LEGEND LINE",
    "Safe trans",
    "SeaLead",
    "Sidraline",
    "TARROS",
    "TRANSMAR",
    "TS LINES",
    "TURKON",
    "Unifeeder",
    "Volta",
    "WAN HAI",
    "WEC",
    "YANG MING",
    "ZIM"
]

Output Schema

Field	Type	Description
booking_number	String	The shipment booking number.
shipping_line	String	The shipping line handling the shipment.
state	String	Current state of the shipment (e.g., "pending").
bl	String	Bill of lading number, if applicable.
company	String	Company associated with the shipment, if available.
cargo	String	Description of the cargo (e.g., "20"ST x 1").
vessel	String	Vessel name, if available.
pol	Object	Port of Loading details (port name and date).
pod	Object	Port of Discharge details (port name and date).
pickup	Object	Pickup port details (port name and date).
dropoff	Object	Dropoff port details (port name and date).
transits	Array	List of transit points, if any.
updates	Array	List of tracking updates with timestamps and statuses.

Example Output:

[
  {
    "booking_number": "HLCUALY240509398",
    "shipping_line": "Hapag-Lloyd",
    "state": "pending",
    "bl": "",
    "company": "",
    "cargo": "20\"ST x 1",
    "vessel": "",
    "pol": {
      "port": "Port Said East-Port, Egypt",
      "date": ""
    },
    "pod": {
      "port": "",
      "date": ""
    },
    "pickup": {
      "port": "",
      "date": ""
    },
    "dropoff": {
      "port": "",
      "date": ""
    },
    "transits": [],
    "updates": []
  }
]