17Track Integration
This integration connects 17TRACK global shipment tracking with ERPNext via the Shipstation Integration app.
It enables automatic tracking, status sync, and comment logging for shipments handled via 17TRACK.
Features
- Automatic tracking updates via webhook from 17TRACK
- Carrier management for fast lookup and autosuggest
- Configurable comment logging on shipment status updates
Setup
Get a Seventeen Track API Key
- Go to https://admin.17track.net/api/settings and login or register

Seventeen Track Doctype
- Go to Seventeen Track DocType.
- Fields:
Company: The ERPNext company this configuration applies to. (Required)API Key: Your 17TRACK API key. (Required)Webhook Callback URL: The URL you must register in the 17TRACK dashboard under API Settings → WebHook. This field is read-only and is generated automatically from your site URL.Add Updates as Comments: Enable to log each tracking status update as a comment on the Tracking Number record.Enable Geocoding: When checked, events that do not include coordinates from the carrier are resolved via the configured geocoding service (default: Nominatim/OpenStreetMap). Disable this if you do not want external geocoding calls or have not configured a provider. See the Tracking Map documentation for details.

Webhook Integration
Endpoint
/api/method/shipstation_integration.shipstation_integration.doctype.seventeen_track.seventeen_track.seventeentrack_webhook
How it works:
- Register your URL on https://admin.17track.net/api/settings
You can send a test webhook from the 17TRACK panel

- Receives POST requests from 17TRACK on shipment status updates.
- Updates corresponding Shipment record:
- Sets latest status, sub-status, description, event time, and carrier.
- Optionally adds a comment if enabled in Seventeen Track settings.
Example: Comment Logged on Shipment
If Add Updates as Comments is enabled, the following is added to Shipment as a comment on status update:
**17TRACK Update**
- **Status:** Delivered
- **Sub-status:** Delivered_Other
- **Sub-status description:**
- **Event Time:** 2025-09-04 08:49:55.826975
- **Description:** Package delivered to recipient.