universal-parcel-scraper 0.69.0 → 0.69.2-main.888

package/README.md

@@ -33,9 +33,9 @@ its own as a command, a Node library or an HTTP server.
 ## Benchmark
 
 <!-- GENERATED:coverage -->
-In a benchmark of 100 carriers picked for shoppers in Europe, run on public tracking numbers anyone can recheck, dedicated adapters return history for **79**, rising to **89** with all fallbacks enabled. The best single aggregator returns 72. Histories whose scans cannot be placed in time, which the library does not use, would add 28 for Postal Ninja and 3 for Ship24.
+In a benchmark of 100 carriers picked for shoppers in Europe, run on public tracking numbers anyone can recheck, dedicated adapters return history for **79**, rising to **89** with all fallbacks enabled. The best single aggregator returns 73. Histories whose scans cannot be placed in time, which the library does not use, would add 28 for Postal Ninja and 3 for Ship24.
 
-<img src="docs/assets/coverage.svg" alt="Carriers with tracking history: This project, all fallbacks enabled 89, This project, dedicated adapters alone 79, 17TRACK 72, ParcelsApp 71, Ship24 57, Postal Ninja 32, UPU 11." width="760">
+<img src="docs/assets/coverage.svg" alt="Carriers with tracking history: This project, all fallbacks enabled 89, This project, dedicated adapters alone 79, 17TRACK 73, ParcelsApp 71, Ship24 57, Postal Ninja 32, UPU 11." width="760">
 <!-- /GENERATED:coverage -->
 
 [Method, carriers and every number's results](benchmark/README.md)

package/data/catalog.json

@@ -4703,7 +4703,7 @@
   },
   "allegro-one": {
     "displayName": "Allegro One",
-    "color": "#ff5a00",
+    "color": "#006d57",
     "aliases": [
       "Allegro Delivery",
       "Allegro One Box",

package/data/coverage-summary.json

@@ -9,7 +9,7 @@
     "providers": {
       "ParcelsApp": 71,
       "Postal Ninja": 32,
-      "17TRACK": 72,
+      "17TRACK": 73,
       "Ship24": 57,
       "UPU": 11
     }

package/dist/browser/scraper.js

@@ -3854,7 +3854,7 @@ var ye = {
 	},
 	"allegro-one": {
 		displayName: "Allegro One",
-		color: "#ff5a00",
+		color: "#006d57",
 		aliases: [
 			"Allegro Delivery",
 			"Allegro One Box",
@@ -12394,25 +12394,38 @@ var $c = { carriers: [
 		carrier: "dhl-ecommerce",
 		direct: "Yes",
 		sample: "✓ 16",
-		references: [{ results: {
-			Ship24: {
-				rows: 11,
-				partial: "no destination leg"
-			},
-			ParcelsApp: 36,
-			"17TRACK": "no_history",
-			"Postal Ninja": 34,
-			UPU: "n/a"
-		} }, {
-			note: "Benchmark number 9261290316844317469885",
-			results: {
-				Ship24: "no_history",
-				ParcelsApp: 1,
+		references: [
+			{ results: {
+				Ship24: {
+					rows: 11,
+					partial: "no destination leg"
+				},
+				ParcelsApp: 36,
 				"17TRACK": "no_history",
-				"Postal Ninja": "blocked",
+				"Postal Ninja": 34,
 				UPU: "n/a"
+			} },
+			{
+				note: "Benchmark number 9261290316844317469885",
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: 1,
+					"17TRACK": "no_history",
+					"Postal Ninja": "blocked",
+					UPU: "n/a"
+				}
+			},
+			{
+				note: "Benchmark number 9261290357482657956985",
+				results: {
+					Ship24: "no_history",
+					ParcelsApp: 9,
+					"17TRACK": 7,
+					"Postal Ninja": "blocked",
+					UPU: "n/a"
+				}
 			}
-		}]
+		]
 	},
 	{
 		carrier: "aliexpress",
@@ -13379,7 +13392,7 @@ var $c = { carriers: [
 				note: "Benchmark number 4PX3002555003946CN",
 				results: {
 					Ship24: "no_history",
-					ParcelsApp: "error",
+					ParcelsApp: 30,
 					"17TRACK": 44,
 					"Postal Ninja": "no_history",
 					UPU: "n/a"

package/dist/carriers/allegro-one/carrier.json

@@ -13,7 +13,7 @@
     ]
   },
   "brand": {
-    "color": "#ff5a00"
+    "color": "#006d57"
   },
   "selectable": true,
   "timezone": "Europe/Warsaw",

package/dist/carriers/gofo/clock.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The clocks GOFO US dates its scans on, for a relay that keeps only a scan's
+ * station and wall clock: Ship24's feed names the station GOFO gives
+ * (`processLocation`), without its state, and writes the wall clock of the
+ * zone GOFO gives it (`processTimeZone`). GOFO's own API names that zone on
+ * every scan, which the adapter reads.
+ */
+/** The zone of a GOFO US scan at `station`, worded `status`. Null for a name not listed, a delivery round's included. */
+export declare function gofoScanZone(station: string, status: string): string | null;

package/dist/carriers/gofo/clock.js

@@ -0,0 +1,31 @@
+/**
+ * The clocks GOFO US dates its scans on, for a relay that keeps only a scan's
+ * station and wall clock: Ship24's feed names the station GOFO gives
+ * (`processLocation`), without its state, and writes the wall clock of the
+ * zone GOFO gives it (`processTimeZone`). GOFO's own API names that zone on
+ * every scan, which the adapter reads.
+ */
+/**
+ * The stations GOFO named on the corpus's and benchmark's parcels, by the zone
+ * it gave them (15 parcels, checked 2026-10-11). A delivery round is named
+ * after the recipient's town and is left out: on all 15 it kept its delivery
+ * station's zone.
+ */
+const STATION_ZONES = {
+    'America/New_York': ['Atlanta', 'Brooklyn', 'Carteret', 'Charleston', 'Cincinnati', 'Detroit', 'Doral', 'IND.H', 'Jamaica',
+        'Miami', 'Milford', 'New York', 'Ocala', 'Orlando', 'Suwanee', 'VPC01'],
+    'America/Chicago': ['Melrose Park'],
+    // Newark is the Bay Area hub. ORD02.V picks up in Chicago, on Pacific time.
+    'America/Los_Angeles': ['Chino', 'LAX.H', 'Los Angeles', 'Newark', 'ORD02.V', 'Portland', 'San Fernando Valley', 'San Francisco',
+        'Seattle', 'Vernon'],
+};
+const STATIONS = new Map(Object.entries(STATION_ZONES).flatMap(([zone, names]) => names.map((name) => [name.toLowerCase(), zone])));
+/** GOFO dates a label's creation on Pacific time wherever the parcel is (`processTimeZone` "US/Pacific" on all 15). */
+const LABEL = /^shipping label created\b/i;
+/** The zone of a GOFO US scan at `station`, worded `status`. Null for a name not listed, a delivery round's included. */
+export function gofoScanZone(station, status) {
+    const name = station.trim().toLowerCase();
+    if (name)
+        return STATIONS.get(name) ?? null;
+    return LABEL.test(status.trim()) ? 'America/Los_Angeles' : null;
+}

package/dist/carriers/swiss-post/adapter.js

@@ -8,6 +8,7 @@ import { withNetworkRetry } from '../../core/runner/networkRetry.js';
 import { fetchBounded, parseJsonBytes } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
 import { FALLBACK_EVENT_LABELS, GLOBAL_STATUS_STAGE, STAGE_STATUS, STATUS_MAP, swissPostEventStage, } from './status.js';
+import { DESTINATION_EVENTS } from './clock.js';
 // The public tracker signs an anonymous visitor in before it will search: it
 // creates a throwaway user, echoes a CSRF token, and keys the search result on
 // a hash. Every call in that sequence shares one cookie jar.
@@ -187,30 +188,19 @@ function timestamp(value) {
     const parsed = Date.parse(explicitZone ? value : `${value}Z`);
     return Number.isFinite(parsed) ? parsed : Number.NEGATIVE_INFINITY;
 }
+const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?)(?:Z|[+-]\d{2}:?\d{2})?$/i;
 /**
- * Events Swiss Post relays from the destination post of a parcel it sends
- * abroad: arrival in the destination country, its customs, sorting and
- * delivery rounds. With no city, postcode or country they carry the
- * destination office's wall clock under Swiss Post's offset: an El Salvador
- * delivery round at 12:26 local came as 12:26 +02:00, and Correos de El
- * Salvador dates it 18:26 UTC (checked 2026-10-10). Swiss Post's own
- * unlocated events (813, 915) keep its clock.
+ * A destination post's event, on its country's clock when that keeps one. In a
+ * country with several, it keeps Swiss Post's offset, the last guess: hours
+ * off, but the reply keeps its instants.
  */
-const DESTINATION_EVENTS = new Set(['909', '918', '919', '920', '921', '923', '924', '926', '934', '938']);
-const WALL_CLOCK = /^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2}(?:\.\d{1,3})?)?)(?:Z|[+-]\d{2}:?\d{2})?$/i;
-/** A destination post's event, on its country's clock when that keeps one, else a wall time. */
 function destinationClock(event, time, destination) {
     const located = text(event.city, 100) || text(event.zip, 30) || text(event.country, 10);
     const wall = WALL_CLOCK.exec(time)?.[1];
     if (!destination || located || !wall || !DESTINATION_EVENTS.has(text(event.eventCode, 100).split('.').at(-1) ?? ''))
-        return { time };
+        return time;
     const zone = countryTimeZone(destination);
-    const placed = zone ? isoTime(wall, zone) : null;
-    return placed ? { time: placed.iso } : { local_time: wall };
-}
-/** An event's instant, else its wall time. */
-function clockOf(event) {
-    return event.time ?? (typeof event.local_time === 'string' ? event.local_time : '');
+    return (zone ? isoTime(wall, zone)?.iso : null) ?? time;
 }
 export function parseSwissPostShipment(item, rawEvents, translations = {}) {
     const globalStatus = text(item.globalStatus, 100);
@@ -232,7 +222,7 @@ export function parseSwissPostShipment(item, rawEvents, translations = {}) {
         if (!time || !eventCode)
             continue;
         const event = {
-            ...destinationClock(rawEvent, time, abroad),
+            time: destinationClock(rawEvent, time, abroad),
             location: eventLocation(rawEvent),
             description: eventDescription(rawEvent, translations, internationalType),
             provider_code: eventCode,
@@ -242,7 +232,7 @@ export function parseSwissPostShipment(item, rawEvents, translations = {}) {
             event.stage = stage;
         events.push(event);
     }
-    events.sort((left, right) => timestamp(clockOf(right)) - timestamp(clockOf(left)));
+    events.sort((left, right) => timestamp(right.time ?? '') - timestamp(left.time ?? ''));
     // The newest scan's own stage leads; the shipment summary fills in when that
     // scan has none (an enquiry note, an unmapped code, or no scans at all).
     let stage = events[0]?.stage ?? GLOBAL_STATUS_STAGE[globalStatus];
@@ -255,12 +245,9 @@ export function parseSwissPostShipment(item, rawEvents, translations = {}) {
         status = STAGE_STATUS[stage];
     let lastStatusText;
     let lastUpdate;
-    let lastUpdateLocal;
     if (events[0]) {
         lastStatusText = events[0].description ?? 'Tracking update';
         lastUpdate = events[0].time ?? null;
-        if (!events[0].time)
-            lastUpdateLocal = clockOf(events[0]) || undefined;
     }
     else {
         lastStatusText = globalStatus;
@@ -277,7 +264,6 @@ export function parseSwissPostShipment(item, rawEvents, translations = {}) {
         ...(stage ? { current_stage: stage } : {}),
         last_status_text: lastStatusText,
         last_update: lastUpdate,
-        ...(lastUpdateLocal ? { last_update_local: lastUpdateLocal } : {}),
         expected_delivery: finished ? null : swissPostExpectedDelivery(item),
         ...(deliveredAt ? { delivered_at: deliveredAt } : {}),
         ...(weight !== null ? { weight_kg: weight } : {}),

package/dist/carriers/swiss-post/clock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Events Swiss Post relays from the destination post of a parcel it sends
+ * abroad: arrival in the destination country, its customs, sorting and
+ * delivery rounds. With no city, postcode or country they carry the
+ * destination office's wall clock under Swiss Post's offset: an El Salvador
+ * delivery round at 12:26 local came as 12:26 +02:00. UPU's record has the
+ * same 12:26 at El Salvador's office, and Correos de El Salvador's own tracker
+ * dates it 18:26:18 UTC (checked 2026-10-11). On an item to China, customs
+ * (901, 902) came at the 11:05 and 14:30 UPU gives Beijing's and Hangzhou's
+ * offices. Swiss Post's own unlocated events (813, 915) keep its clock.
+ */
+export declare const DESTINATION_EVENTS: ReadonlySet<string>;
+/**
+ * The clock of a Swiss Post scan as a relay gives it, when it is the
+ * destination post's: worded as one of those events, with no location, on an
+ * item bound for `destination`, another country, which keeps one clock. Null
+ * otherwise, when the relay's reading stays.
+ */
+export declare function swissPostDestinationZone(wording: string, location: string, destination: string | null): string | null;

package/dist/carriers/swiss-post/clock.js

@@ -0,0 +1,29 @@
+import { countryTimeZone } from '../../core/time/index.js';
+/**
+ * Events Swiss Post relays from the destination post of a parcel it sends
+ * abroad: arrival in the destination country, its customs, sorting and
+ * delivery rounds. With no city, postcode or country they carry the
+ * destination office's wall clock under Swiss Post's offset: an El Salvador
+ * delivery round at 12:26 local came as 12:26 +02:00. UPU's record has the
+ * same 12:26 at El Salvador's office, and Correos de El Salvador's own tracker
+ * dates it 18:26:18 UTC (checked 2026-10-11). On an item to China, customs
+ * (901, 902) came at the 11:05 and 14:30 UPU gives Beijing's and Hangzhou's
+ * offices. Swiss Post's own unlocated events (813, 915) keep its clock.
+ */
+export const DESTINATION_EVENTS = new Set(['901', '902', '909', '918', '919', '920', '921', '923', '924', '926',
+    '934', '938']);
+/** The English wording of those events, for relays that give no code (Ship24, 17TRACK, Postal Ninja). */
+const DESTINATION_WORDING = new RegExp('^(?:arrival in destination country|customs clearance process underway|sorting - forwarding'
+    + '|arrival at the processing/collection point|delivery failed: (?:recipient unknown|recipient absent|shipment undeliverable)'
+    + '|retention period was extended by recipient|delivered)$', 'i');
+/**
+ * The clock of a Swiss Post scan as a relay gives it, when it is the
+ * destination post's: worded as one of those events, with no location, on an
+ * item bound for `destination`, another country, which keeps one clock. Null
+ * otherwise, when the relay's reading stays.
+ */
+export function swissPostDestinationZone(wording, location, destination) {
+    if (location.trim() || !destination || destination === 'CH' || !DESTINATION_WORDING.test(wording.trim()))
+        return null;
+    return countryTimeZone(destination);
+}

package/dist/data/catalog.json

@@ -4703,7 +4703,7 @@
     },
     "allegro-one": {
         "displayName": "Allegro One",
-        "color": "#ff5a00",
+        "color": "#006d57",
         "aliases": [
             "Allegro Delivery",
             "Allegro One Box",

package/dist/generated/catalog.d.ts

@@ -3227,7 +3227,7 @@ export declare const CARRIER_CATALOG: {
     };
     readonly "allegro-one": {
         readonly displayName: "Allegro One";
-        readonly color: "#ff5a00";
+        readonly color: "#006d57";
         readonly aliases: readonly ["Allegro Delivery", "Allegro One Box", "Allegro One Kurier", "Allegro One Punkt"];
         readonly countries: readonly ["PL"];
         readonly selectable: true;

package/dist/generated/catalog.js

@@ -4704,7 +4704,7 @@ export const CARRIER_CATALOG = {
     },
     "allegro-one": {
         "displayName": "Allegro One",
-        "color": "#ff5a00",
+        "color": "#006d57",
         "aliases": [
             "Allegro Delivery",
             "Allegro One Box",

package/dist/providers/coverage.json

@@ -450,6 +450,16 @@
             "Postal Ninja": "blocked",
             "UPU": "n/a"
           }
+        },
+        {
+          "note": "Benchmark number 9261290357482657956985",
+          "results": {
+            "Ship24": "no_history",
+            "ParcelsApp": 9,
+            "17TRACK": 7,
+            "Postal Ninja": "blocked",
+            "UPU": "n/a"
+          }
         }
       ]
     },
@@ -1458,7 +1468,7 @@
           "note": "Benchmark number 4PX3002555003946CN",
           "results": {
             "Ship24": "no_history",
-            "ParcelsApp": "error",
+            "ParcelsApp": 30,
             "17TRACK": 44,
             "Postal Ninja": "no_history",
             "UPU": "n/a"

package/dist/providers/parcelsapp/adapter.js

@@ -69,10 +69,12 @@ const nameKey = (name) => typeof name === 'string' ? name.toLowerCase().replace(
 // Carriers whose ParcelsApp dates are a North American scan's local clock:
 // UPS's own instants, FedEx's own page, UniUni's own feed and Ship24's offsets
 // agree once they are read that way (checked 2026-09-30 on US scans; UPS's
-// also in Germany, the Netherlands and Spain). OnTrac's are UTC and
-// Landmark's keep one clock everywhere, so no other carrier gets this step
-// beyond the ones below.
-const LOCAL_CLOCK_CARRIERS = new Set(['ups', 'fedex', 'uniuni', 'uniexpress', 'easyship']);
+// also in Germany, the Netherlands and Spain). So does DHL eCommerce's
+// Webtrack, which names each scan's clock, on all 25 scans of three parcels
+// in seven states and the UK (2026-10-11). OnTrac's are UTC and Landmark's
+// keep one clock everywhere, so no other carrier gets this step beyond the
+// ones below.
+const LOCAL_CLOCK_CARRIERS = new Set(['ups', 'fedex', 'uniuni', 'uniexpress', 'easyship', 'dhlecommerce']);
 /**
  * Carriers whose dates are each scan's local clock under a label that is
  * never its instant, checked scan for scan on 2026-10-10: USPS's own page,
@@ -84,29 +86,81 @@ const LOCAL_CLOCK_CARRIERS = new Set(['ups', 'fedex', 'uniuni', 'uniexpress', 'e
  * names; `wallClockZones` reads the others.
  */
 const WALL_CLOCKS = new Set(['usps', 'canadapost', 'gofoexpress', 'speedpak', 'ems', 'cainiao', 'ecoscooting', '4pxexpress']);
+// A known clock that is the destination country's (`knownClock`).
+const DESTINATION = 'destination';
+const wordings = (list) => new RegExp(`^(?:${list.join('|')})$`, 'i');
+// Cainiao's last-mile scans, in its words or the local carrier's.
+const CAINIAO_LAST_MILE = [
+    'received by local\\s+delivery company', '(?:at|left) destination country/region(?: sorting center)?', 'arrived at local delivery center',
+    'out for delivery', 'delivery failed(?:\\. not at home\\.)?', 'delivery attempt failure,.*', '(?:item )?delivered',
+    'parcel is handled', 'your shipment has been delivered to the postal operator of the country.*',
+];
 /**
- * The clocks of some wall-clock scans whatever their neighbours', checked on
- * 2026-10-10. GOFO's feed dates its labels on Pacific time wherever the
- * parcel is injected (a Florida parcel's at -07:00). Cainiao's own feed dates
- * its origin leg on China time, from the warehouse to the linehaul office, in
- * two parcels bound for the UK whose later legs it dates on GMT+2, +1 and +0;
- * in a US parcel, "Package finished" and "Last-mile delivery forecast" fall
- * minutes from scans of that leg. Such a scan borrows no neighbour's clock:
- * borrowed from a GOFO parcel's Florida scans, the label came 3 hours early
- * and Cainiao's "Order received" 12 hours after it, 19 seconds on China time.
+ * The clocks of some wall-clock scans whatever their neighbours', from each
+ * carrier's own offsets. GOFO's feed dates its labels on Pacific time
+ * wherever the parcel is injected (a Florida parcel's at -07:00; 2026-10-10).
+ *
+ * Cainiao's own feed (checked 2026-10-11 on parcels to the UK, Belgium,
+ * Spain, Italy, Japan, Brazil and the US) dates its origin leg on China time,
+ * from the warehouse to the departing linehaul, and the return warehouse
+ * too. It dates import customs on the destination's clock, and the last mile
+ * as well, except the UK's, on GMT in July. Its transit hub, on GMT+2 for a
+ * UK parcel, and "Arrived at linehaul office", on either side's clock, are
+ * not listed; that office stays on China time, as it was checked first.
+ *
+ * 4PX's page (2026-10-11, two parcels to the US) dates its scans up to the
+ * departing flight on China time and the rest in the US. EcoScooting's own
+ * instants (two parcels) put its China leg on China time, its order and its
+ * Spanish sorting center on Madrid's, and its last mile on the destination's:
+ * Lisbon's for a "CNPRT" reference, otherwise Spain's.
+ *
+ * A scan on a fixed clock borrows no neighbour's: borrowed from a GOFO
+ * parcel's Florida scans, the label came 3 hours early and Cainiao's "Order
+ * received" 12 hours after it, 19 seconds on China time. One in the
+ * destination borrows only from a scan placed there, and otherwise takes its
+ * single clock (`wallClockZones`).
  */
 const KNOWN_CLOCKS = new Map([
-    ['gofoexpress', { wording: /^shipping label created$/i, zone: 'America/Los_Angeles' }],
-    ['cainiao', { wording: new RegExp(`^(?:${[
-                'order received successfully', 'package finished', 'leave the warehouse', 'accepted by carrier',
-                '(?:inbound|outbound) in sorting center', 'last-mile delivery forecast', 'arrived at departure transport hub',
-                'export customs clearance started', 'export clearance success', '(?:leaving|left) from departure country/region',
-                'arrived at linehaul office',
-            ].join('|')})$`, 'i'), zone: 'Asia/Shanghai' }],
+    ['gofoexpress', [{ wording: /^shipping label created$/i, zone: 'America/Los_Angeles' }]],
+    ['cainiao', [
+            { wording: wordings([
+                    'order received successfully', 'package finished', 'leave the warehouse', 'departed from warehouse', 'accepted by carrier',
+                    '(?:inbound|outbound) in sorting center', 'package (?:received by|left) sorting center of transit', 'last-mile delivery forecast',
+                    'arrived at departure transport hub', 'export customs clearance started', 'export clearance success',
+                    '(?:leaving|left) from departure country/region', 'arrived at linehaul office', 'cross-solution reroute', '质检真假鉴定',
+                    'return warehouse inbound success\\.?', 'parcel has been destroyed in return warehouse\\.?',
+                ]), zone: 'Asia/Shanghai' },
+            { wording: wordings(['import clearance start', 'import customs clearance complete', 'arrived at customs', 'leaving customs',
+                    'we\'re inspecting your order']), zone: DESTINATION },
+            { wording: wordings(CAINIAO_LAST_MILE), zone: DESTINATION, except: 'GB' },
+        ]],
+    ['4pxexpress', [
+            { wording: wordings(['parcel information received', 'pickup scanned, in transit to warehouse', 'shipment picked up\\.?',
+                    'shipment arrived at facility and measured\\.?', 'depart from facility to service provider\\.?', 'hand over to airline\\.?',
+                    'departure from the original airport']), zone: 'Asia/Shanghai' },
+            { wording: wordings(['arrival to the destination airport', 'arrived at warehouse', 'released from customs: customs cleared\\.?',
+                    'customs clearance agent received the shipment in destnation country\\.?', 'in transit, it\'s progressing through post network',
+                    'handed over to last mile']), zone: DESTINATION },
+        ]],
+    ['ecoscooting', [
+            { wording: /^(?:shipment data information received|shipment has left cainiao express's partner facility|shipment is in transit to cainiao express)$/i,
+                zone: 'Asia/Shanghai' },
+            { wording: /^(?:create|sorting center (?:inbound|outbound))\./i, zone: 'Europe/Madrid' },
+            { wording: /^(?:accepted by last mile|out for delivery|delivery attempt failure|delivery success|pudo inbound success|delivered to pudo)\./i,
+                zone: DESTINATION, otherwise: 'Europe/Madrid' },
+        ]],
 ]);
-function knownClock(name, status) {
-    const known = KNOWN_CLOCKS.get(nameKey(name));
-    return known?.wording.test(status.trim()) ? known.zone : null;
+/**
+ * A scan's known clock: its zone, null when the destination has several, and
+ * for a scan in the destination, that country.
+ */
+function knownClock(name, status, destination) {
+    const known = KNOWN_CLOCKS.get(nameKey(name))?.find(({ wording }) => wording.test(status.trim()));
+    if (!known || known.zone !== DESTINATION)
+        return known ? { zone: known.zone } : null;
+    if (!destination)
+        return known.otherwise ? { zone: known.otherwise } : null;
+    return destination === known.except ? null : { zone: countryTimeZone(destination), country: destination };
 }
 /**
  * Networks whose dates are their home clock wherever the scan was: their own
@@ -122,11 +176,13 @@ const HOME_CLOCKS = {
 /**
  * Networks whose dates are their scans' local clocks, checked at home only
  * (2026-10-10): Korea Post's page, Bring's offsets (in Denmark too) and
- * Parcelforce's for Royal Mail. Their home clock is a guess, which a location
+ * Parcelforce's for Royal Mail; Japan Post's, which its portal gives as local
+ * times, at 10:27 for a delivery in Japan that Cainiao dates 10:27 GMT+9 and
+ * Ship24 01:27Z (2026-10-11). Their home clock is a guess, which a location
  * in another country rules out.
  */
 const HOME_COUNTRIES = {
-    southkoreapost: 'Asia/Seoul', postennorgenorwaypost: 'Europe/Oslo', royalmail: 'Europe/London',
+    southkoreapost: 'Asia/Seoul', postennorgenorwaypost: 'Europe/Oslo', royalmail: 'Europe/London', japanpost: 'Asia/Tokyo',
 };
 const UNITED_STATES = /^(?:us|usa|united states(?: of america)?)$/i;
 const POSTAL_CODE = /\s*\b(?:\d{5}(?:-\d{4})?|[A-Z]\d[A-Z] ?\d[A-Z]\d)$/i;
@@ -145,18 +201,18 @@ const US_STATE_NAMES = new Map(Object.entries({
 }));
 /**
  * The zone of the US state or Canadian province a location names ("Riverside,
- * CA, US", "Charlotte, NC", "Linden, NJ 07036", "Scranton PA", "Mississauga,
- * ON, CA"). It is `certain` when the location names the country, the code is
- * no country's, or the town lies in that state or province ("Chicago, IL" is
- * not in Israel); "Atlanta, GA" could still be in Gabon. A state written out
- * counts only after the country ("Example City Minnesota, United States"):
- * Georgia is a country too.
+ * CA, US", "Charlotte, NC", "Linden, NJ 12345", "Scranton PA", "Mississauga,
+ * ON, CA", "Example City, IN, US 12345"). It is `certain` when the location
+ * names the country, the code is no country's, or the town lies in that state
+ * or province ("Chicago, IL" is not in Israel); "Atlanta, GA" could still be
+ * in Gabon. A state written out counts only after the country ("Example City
+ * Minnesota, United States"): Georgia is a country too.
  */
 function regionClock(location) {
     const parts = location.split(',').map((part) => part.trim()).filter(Boolean);
     const last = parts.at(-1) ?? '';
     // "CA" after a province is Canada; after a town it is California.
-    const country = parts.length > 1 && UNITED_STATES.test(last) ? 'US'
+    const country = parts.length > 1 && UNITED_STATES.test(last.replace(POSTAL_CODE, '')) ? 'US'
         : (parts.length > 1 && /^canada$/i.test(last)) || (parts.length > 2 && /^ca$/i.test(last)) ? 'CA' : null;
     if (country)
         parts.pop();
@@ -179,11 +235,15 @@ function regionClock(location) {
 /**
  * The last part of a location that is not a bare postcode: "Example Town,
  * Denmark, 4600" is in Denmark. Orange Connex names China and the United
- * States in full for SpeedPAK, and Canada Post writes "USA".
+ * States in full for SpeedPAK, Canada Post writes "USA", 4PX "US 12345", and
+ * Hong Kong is not the name Intl gives it.
  */
 function lastPlace(location) {
     const place = location.split(',').map((part) => part.trim()).filter((part) => part && !/^\d[\d\s-]*$/.test(part)).at(-1);
-    return place && /^people['’]?s republic of china$/i.test(place) ? 'CN' : place && UNITED_STATES.test(place) ? 'US' : place;
+    if (!place)
+        return place;
+    return /^people['’]?s republic of china$/i.test(place) ? 'CN' : UNITED_STATES.test(place.replace(POSTAL_CODE, '')) ? 'US'
+        : /^hong\s*kong$/i.test(place) ? 'HK' : place;
 }
 /**
  * A scan's location as the zone steps read it. 4PX writes the country, state
@@ -320,14 +380,29 @@ function guessedZone(payload, state, fallback, number) {
     return (wall ? sharedClockZone(brand, wall) : null) ?? guess(fallback);
 }
 /**
- * 4PX's dates are the instants of its own feed, which reads every scan's wall
- * clock on China time, its US ones too: the wall clock is that instant's
- * digits in Shanghai (checked 2026-10-10 against 4PX's page, which shows each
- * with the offset of its place). An instant is right only for a scan on China
- * time, which is how a scan nothing places reads when it keeps its label.
+ * ParcelsApp relays 4PX's feed two ways (checked 2026-10-11 against 4PX's
+ * page, which shows each scan's wall clock with the offset of its place).
+ * Where it keeps 4PX's fixed fields ("US  NY  EXAMPLE CITY 12345", "CN"), its
+ * dates are the feed's instants, which read every wall clock on China time,
+ * the US ones too: the wall clock is the instant's digits in Shanghai. Where
+ * it rewrites them ("United States" for "US", "Hong Kong" for "HONG KONG -
+ * HONG KONG"), they are the wall clocks themselves, labeled UTC, as other
+ * carriers' are.
+ */
+const FOUR_PX_FIELDS = /^[A-Z]{2}(?:\s{2}|$)/;
+/** Whether a reply's 4PX dates are instants: unless its 4PX scans have places, none in 4PX's fields. */
+function fourPxInstants(payload, states) {
+    const places = states.flatMap((raw) => isRecord(raw) && nameKey(stateCarrierName(payload, raw)) === '4pxexpress'
+        && typeof raw.location === 'string' && raw.location.trim() ? [raw.location.trim()] : []);
+    return !places.length || places.some((place) => FOUR_PX_FIELDS.test(place));
+}
+/**
+ * A state's date as its wall clock: 4PX's instants as their Shanghai digits.
+ * An instant is right only for a scan on China time, which is how a scan
+ * nothing places reads when it keeps its label.
  */
-function stateDate(name, date) {
-    if (nameKey(name) !== '4pxexpress' || typeof date !== 'string')
+function stateDate(name, date, instants = true) {
+    if (nameKey(name) !== '4pxexpress' || typeof date !== 'string' || !instants)
         return date;
     const instant = DateTime.fromISO(date.trim(), { setZone: true });
     return instant.isValid && /(?:Z|[+-]\d{2}:\d{2})$/i.test(date.trim())
@@ -340,17 +415,18 @@ function stateDate(name, date) {
  * gave it, and for a wall-clock scan, routing's zone and any known clock,
  * which `wallClockZones` falls back on.
  */
-function readState(payload, raw, status, fallback, number, inNorthAmerica = false) {
+function readState(payload, raw, status, fallback, number, inNorthAmerica = false, destination = null, instants = true) {
     const name = stateCarrierName(payload, raw);
-    const state = { ...raw, date: stateDate(name, raw.date) };
+    const state = { ...raw, date: stateDate(name, raw.date, instants) };
     const location = scanLocation(name, raw.location);
     const offset = ownOffset(name, state.date);
     const wallClock = WALL_CLOCKS.has(nameKey(name)) && !offset;
     const placed = placedZone(payload, state, number, inNorthAmerica);
     const zone = placed !== undefined ? placed : wallClock ? null : guessedZone(payload, state, fallback, number);
+    const known = wallClock ? knownClock(name, status, destination) : null;
     return { name, date: state.date, labeled: raw.date, zone, placed: placed ?? null, offset, location, wallClock,
         local: zone !== null && zone === regionScanZone(name, location, inNorthAmerica)?.zone,
-        fallback: wallClock ? fitsPlace(fallback, location) : null, known: wallClock ? knownClock(name, status) : null };
+        fallback: wallClock ? fitsPlace(fallback, location) : null, known: known?.zone ?? null, arrival: known?.country ?? null };
 }
 /**
  * The zone of each scan. One from a network that is not a wall clock keeps
@@ -359,9 +435,11 @@ function readState(payload, raw, status, fallback, number, inNorthAmerica = fals
  * 2. that of another carrier's placed scan with the same digits and wording,
  *    which it copies (`copy`);
  * 3. as a guess, that of the scan of its network just before it by wall
- *    clock that steps 1 and 2 place, else of the one just after it;
+ *    clock that steps 1 and 2 place, else of the one just after it; for a
+ *    scan in the destination, only of one placed there;
  * 4. the zone routing passes for the parcel;
- * 5. its known clock (`KNOWN_CLOCKS`), for a scan that skips step 3;
+ * 5. its known clock (`KNOWN_CLOCKS`): a fixed one, for a scan that skips
+ *    step 3, or the destination's single clock;
  * 6. none: it keeps ParcelsApp's label, as it did before these steps, the
  *    last guess.
  * A zone the scan's location rules out is skipped ("USA" takes no Canadian
@@ -370,10 +448,11 @@ function readState(payload, raw, status, fallback, number, inNorthAmerica = fals
  * own clocks: Canada Post's first scan and one in Chicago took the right
  * zone, and its last two, in Montana, the Chicago hub's, an hour off USPS's.
  * SpeedPAK's four took the right one, and a Chinese system event the US one,
- * 14 hours off. 4PX's nine did; its four between the departing flight and the
- * first US scan took China's, and its first scan the US label's, 12 hours
- * off. USPS's "In Transit to Next Facility" was not checked: no source gives
- * its clock.
+ * 14 hours off. USPS's "In Transit to Next Facility" was not checked: no
+ * source gives its clock. 4PX's scans between the departing flight and the
+ * first US scan took China's until they were known to be in the destination
+ * (2026-10-11); its US scans with no state take the right zone, or one an
+ * hour off when the parcel changed zones around them.
  */
 function wallClockZones(entries) {
     const found = entries.map((entry) => !entry.wallClock ? { zone: entry.zone, step: 'carrier' }
@@ -387,12 +466,14 @@ function wallClockZones(entries) {
         const wall = walls[index];
         let before;
         let after;
-        if (!entry.known) {
+        if (!entry.known || entry.arrival) {
             entries.forEach((other, at) => {
                 const zone = found[at]?.zone;
                 const near = { wall: walls[at], zone: zone ?? '' };
                 if (!zone || !other.wallClock || nameKey(other.name) !== key || !fitsPlace(zone, entry.location, true))
                     return;
+                if (entry.arrival && (timeZoneCountry(zone) ?? NORTH_AMERICAN_ZONES.get(zone)) !== entry.arrival)
+                    return;
                 if (near.wall <= wall) {
                     if (!before || near.wall > before.wall)
                         before = near;
@@ -407,6 +488,16 @@ function wallClockZones(entries) {
             : known ? { zone: known, step: 'known' } : { zone: null, step: 'labeled' };
     });
 }
+/**
+ * The country the parcel is bound for, as the reply names it, or for a reply
+ * that does not, as an EcoScooting reference does ("CNPRT" for Portugal,
+ * "CNESP" for Spain).
+ */
+function replyDestination(payload, number) {
+    const reference = /^CN(PRT|ESP)\d{20}$/.exec(number)?.[1];
+    return countryCode(payload.destinationCode) ?? countryCode(payload.destination)
+        ?? (reference === 'PRT' ? 'PT' : reference === 'ESP' ? 'ES' : null);
+}
 /**
  * ParcelsApp relays some carriers' labels twice over, TIPSA's as
  * "ENTREGADOENTREGADO". Only a label made of two identical halves is collapsed.
@@ -437,6 +528,8 @@ function parseHistory(payload, trackingNumber, timezone = null) {
         return location ? [placeKind(location)] : [];
     });
     const inNorthAmerica = kinds.includes('certain') || (kinds.includes('region') && !kinds.includes('abroad'));
+    const destination = replyDestination(payload, number);
+    const instants = fourPxInstants(payload, payload.states);
     const entries = [];
     for (const raw of payload.states) {
         if (!isRecord(raw))
@@ -450,7 +543,7 @@ function parseHistory(payload, trackingNumber, timezone = null) {
             continue;
         }
         const status = relayedLabel(raw.status);
-        const state = readState(payload, raw, status, timezone, number, inNorthAmerica);
+        const state = readState(payload, raw, status, timezone, number, inNorthAmerica, destination, instants);
         const scan = carrierScan(typeof state.name === 'string' ? carrierIdFromName(state.name) : undefined, status);
         entries.push({ ...state, raw, scan, wording: scan?.wording ?? status });
     }
@@ -594,7 +687,7 @@ export function parseParcelsAppHtml(html, trackingNumber, timezone = null) {
         const labeled = DateTime.fromFormat(`${date} ${time}`, 'dd LLL yyyy HH:mm', { locale: 'en', zone: 'UTC' });
         if (!labeled.isValid)
             throw new SchemaError(SOURCE, 'ParcelsApp returned an invalid event date');
-        const state = readState({ carriers }, { date: labeled.toISO(), ...(name ? { carrier: carriers.indexOf(name) } : {}) }, description, timezone, numberOf(trackingNumber));
+        const state = readState({ carriers }, { date: labeled.toISO(), ...(name ? { carrier: carriers.indexOf(name) } : {}) }, description, timezone, numberOf(trackingNumber), false, replyDestination({}, numberOf(trackingNumber)));
         // The page prints no location, so no DHL Express scan has a facility to
         // read its clock in, and no other wall clock a place, a copy to take or a
         // placed scan of its network to borrow from: routing's zone, its known

package/dist/providers/postal-ninja/adapter.js

@@ -17,7 +17,7 @@ import { isRecord } from '../../core/types.js';
 import { capturedBodies, captureFailure, loadCapture } from '../shared/capture.js';
 import { classifyEvent, event, hasPrivateDeliveryDetails, isNotice, numberOf, result, text } from '../shared/result.js';
 import { courierZone } from '../shared/hints.js';
-import { carrierHomeZone, serviceZone } from './clocks.js';
+import { carrierHomeZone, originCopy, serviceZone } from './clocks.js';
 const SOURCE = 'Postal Ninja';
 const GET_API = 'https://postal.ninja/track/get';
 const CHECK_API = 'https://postal.ninja/track/check';
@@ -89,7 +89,7 @@ export function parsePostalNinjaResponse(payload, trackingNumber, timezone = nul
         if (/(?:Z|[+-]\d{2}:\d{2})$/.test(raw.dt)) {
             const parsed = event(raw.dt, description);
             if (parsed)
-                scans.push({ wall: null, service: text(raw.ds), zone: null, event: parsed });
+                scans.push({ wall: null, service: text(raw.ds), origin: false, zone: null, event: parsed });
         }
         else {
             const classified = classifyEvent(description);
@@ -97,8 +97,8 @@ export function parsePostalNinjaResponse(payload, trackingNumber, timezone = nul
             if (stage !== 'delivered' && hasPrivateDeliveryDetails(description))
                 continue;
             // A scan's location (loc) is read only for its clock.
-            const scan = { service: text(raw.ds), wall: raw.dt, location: text(raw.loc), delivered: stage === 'delivered' };
-            scans.push({ wall: raw.dt, service: scan.service, zone: serviceZone(scan, journey),
+            const scan = { service: text(raw.ds), description, wall: raw.dt, location: text(raw.loc), delivered: stage === 'delivered' };
+            scans.push({ wall: raw.dt, service: scan.service, origin: originCopy(scan), zone: serviceZone(scan, journey),
                 event: { description: stage === 'delivered' ? 'Delivered' : description, ...classified } });
         }
     }
@@ -109,10 +109,12 @@ export function parsePostalNinjaResponse(payload, trackingNumber, timezone = nul
     // dated when its newest scan names no place. A scan whose hour is unknown
     // (false) keeps its wall time.
     const zoneAt = (index, wall) => {
-        const { zone, service } = scans[index];
+        const { zone, service, origin } = scans[index];
         if (zone !== null)
             return zone || null;
-        const established = (other) => other.service === service && typeof other.zone === 'string' ? other.zone : null;
+        // A post's copies of the origin post's scans are on another clock than its own, and borrow among themselves.
+        const established = (other) => other.service === service && other.origin === origin
+            && typeof other.zone === 'string' ? other.zone : null;
         for (let earlier = index - 1; earlier >= 0; earlier -= 1) {
             const borrowed = established(scans[earlier]);
             if (borrowed)

package/dist/providers/postal-ninja/clocks.d.ts

@@ -21,14 +21,19 @@ export declare function carrierHomeZone(carrier: string | null): string | null;
 export interface Scan {
     /** Postal Ninja's name for the service that reported it (`ds`). */
     service: string;
+    description: string;
     /** Its `dt`, without a zone. */
     wall: string;
     location: string;
     delivered: boolean;
 }
+/** Whether a scan is a UTC post's copy of the origin post's, on the origin office's clock. */
+export declare function originCopy({ service, description }: Pick<Scan, 'service' | 'description'>): boolean;
 /**
  * The established zone of a scan's wall time, from the service that reported
- * it: its fixed or network clock in any history, else in a history it reports
+ * it: the destination post's clock for a scan Swiss Post relays from it, a UTC
+ * post's or the origin's that an S10 suffix names for its copies, its fixed
+ * or network clock in any history, else in a history it reports
  * alone its location's clock, or a local clock's country: the destination's,
  * else the service's (`courierZone`) or the carrier's. A destination on another
  * clock than the service's may be a parcel that crossed a border, so it
@@ -36,4 +41,4 @@ export interface Scan {
  * (a date written as midnight, UPS's 12:xx), so that no zone can place the
  * scan.
  */
-export declare function serviceZone({ service, wall, location, delivered }: Scan, journey: Journey): string | null | false;
+export declare function serviceZone(scan: Scan, journey: Journey): string | null | false;

package/dist/providers/postal-ninja/clocks.js

@@ -8,7 +8,9 @@
  * missing here has no known clock: its scans borrow a zone in the adapter, as
  * a guess, or keep their wall time.
  */
+import { swissPostDestinationZone } from '../../carriers/swiss-post/clock.js';
 import { CARRIER_DEFINITIONS } from '../../core/catalog/definitions.js';
+import { isValidS10TrackingNumber } from '../../core/detection/s10.js';
 import { canadaProvinceTimeZone, countryCode, countryTimeZone, sharedClockZone, usStateTimeZone } from '../../core/time/index.js';
 import { courierZone } from '../shared/hints.js';
 /** Services whose every scan is at one clock, wherever it happened and whatever other services the history names. */
@@ -17,10 +19,21 @@ const FIXED_CLOCKS = new Map([
     ['Intelcom', 'UTC'],
     ['OnTrac', 'UTC'],
     ['Poste Italiane', 'UTC'],
-    // Also for their scans abroad: Swiss Post's in El Salvador and China, Singapore Post's in China.
+    // Also for their scans abroad: Singapore Post's in China. Swiss Post's own are in
+    // Switzerland; the destination post's it relays keep their office's clock (serviceZone).
     ['Singapore Post', 'Asia/Singapore'],
     ['Swiss Post', 'Europe/Zurich'],
 ]);
+/**
+ * Posts that date their own scans in UTC and keep the origin post's, which
+ * they receive by EDI and mark outbound, at that office's wall clock, as
+ * their own trackers do: Correos de El Salvador's arrival in San Salvador at
+ * 21:30:17 is UPU's 15:30 local, and its copy of Swiss Post's departure from
+ * Geneva keeps Geneva's 12:20 (checked 2026-10-11).
+ */
+const UTC_POSTS = new Set(['Correos de El Salvador']);
+/** The origin post's scans, as Postal Ninja translates "(salida)" and "(recibido por EDI)". */
+const OUTBOUND = /\((?:outbound|output|departure|received by EDI)\)$/i;
 /** Services with one clock per network, by the parcel's destination: GOFO's US network keeps Los Angeles time in New York. */
 const NETWORK_CLOCKS = new Map([
     ['GOFO Express', new Map([['US', 'America/Los_Angeles'], ['FR', 'Europe/Paris']])],
@@ -68,7 +81,7 @@ export function carrierHomeZone(carrier) {
 /**
  * The clock of a scan location that ends with its country: a US state or
  * Canadian province before it ("Atlanta, GA, United States", "TACOMA, WA,
- * 98424, United States"), or a country with one clock. A two-letter country
+ * 12345, United States"), or a country with one clock. A two-letter country
  * other than the US's could be a state ("Chicago, IL"), so it names none.
  */
 function locationZone(location) {
@@ -81,9 +94,15 @@ function locationZone(location) {
         return parts.length === 3 ? canadaProvinceTimeZone(parts[1]) : null;
     return countryTimeZone(country);
 }
+/** Whether a scan is a UTC post's copy of the origin post's, on the origin office's clock. */
+export function originCopy({ service, description }) {
+    return UTC_POSTS.has(service) && OUTBOUND.test(description);
+}
 /**
  * The established zone of a scan's wall time, from the service that reported
- * it: its fixed or network clock in any history, else in a history it reports
+ * it: the destination post's clock for a scan Swiss Post relays from it, a UTC
+ * post's or the origin's that an S10 suffix names for its copies, its fixed
+ * or network clock in any history, else in a history it reports
  * alone its location's clock, or a local clock's country: the destination's,
  * else the service's (`courierZone`) or the carrier's. A destination on another
  * clock than the service's may be a parcel that crossed a border, so it
@@ -91,7 +110,16 @@ function locationZone(location) {
  * (a date written as midnight, UPS's 12:xx), so that no zone can place the
  * scan.
  */
-export function serviceZone({ service, wall, location, delivered }, journey) {
+export function serviceZone(scan, journey) {
+    const { service, description, wall, location, delivered } = scan;
+    const relayed = service === 'Swiss Post' ? swissPostDestinationZone(description, location, journey.destination) : null;
+    if (relayed)
+        return relayed;
+    if (UTC_POSTS.has(service)) {
+        if (!originCopy(scan))
+            return 'UTC';
+        return isValidS10TrackingNumber(journey.number) ? countryTimeZone(journey.number.slice(-2)) : null;
+    }
     const fixed = FIXED_CLOCKS.get(service) ?? (journey.destination ? NETWORK_CLOCKS.get(service)?.get(journey.destination) : undefined);
     if (fixed)
         return fixed;

package/dist/providers/seventeentrack/adapter.js

@@ -16,6 +16,7 @@ import { runSteps } from '../../core/runner/index.js';
 import { countryTimeZone } from '../../core/time/index.js';
 import { isRecord } from '../../core/types.js';
 import { trackingPlace } from '../../places/trackingLocation.js';
+import { swissPostDestinationZone } from '../../carriers/swiss-post/clock.js';
 import { universalCarrierHints } from '../shared/hints.js';
 import { capturedBodies, captureFailure, loadCapture } from '../shared/capture.js';
 import { facilityZone, LatestScan, relaysFacilityClock } from '../shared/facilityClock.js';
@@ -88,12 +89,16 @@ function lookupError(code, providerMessage) {
         ? new SeventeenTrackVerificationError(code, providerMessage)
         : new SeventeenTrackLookupError('lookup_unavailable', code, providerMessage);
 }
-/** The offset-less clock of a scan whose offset 17TRACK added itself. */
-function facilityWall(raw) {
-    const clock = isRecord(raw.time_raw) && raw.time_raw.timezone === null ? raw.time_raw : null;
+/** A scan's clock as the carrier wrote it, without any offset. */
+function rawClock(raw) {
+    const clock = isRecord(raw.time_raw) ? raw.time_raw : null;
     return clock && typeof clock.date === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(clock.date)
         && typeof clock.time === 'string' && /^\d{2}:\d{2}:\d{2}$/.test(clock.time) ? `${clock.date}T${clock.time}` : null;
 }
+/** The offset-less clock of a scan whose offset 17TRACK added itself. */
+function facilityWall(raw) {
+    return isRecord(raw.time_raw) && raw.time_raw.timezone === null ? rawClock(raw) : null;
+}
 /**
  * 17TRACK's carrier 100016, Asendia USA, relays A1's tracking: A1 dates every
  * scan in UTC, its partners' too. A Swiss Post scan at 18:20 +02:00 is A1's
@@ -103,6 +108,30 @@ function facilityWall(raw) {
 function relaysUtcClock(key) {
     return key === 100016;
 }
+/**
+ * 17TRACK's carrier 19031, Correo El Salvador, relays Correos de El Salvador's
+ * tracker, which dates its own scans in UTC and keeps the origin post's, which
+ * it receives by EDI and marks outbound, at that office's wall clock: its
+ * arrival in San Salvador at 21:30:17 is UPU's 15:30 local, and its copy of
+ * Swiss Post's departure from Geneva keeps Geneva's 12:20. 17TRACK labels them
+ * all with -05:00 (checked 2026-10-11). The copies are read on the clock of
+ * the origin an S10 suffix names; from a country on several clocks they keep
+ * 17TRACK's reading, the last guess.
+ */
+const CORREO_EL_SALVADOR = 19031;
+/** The origin post's scans, in Correos de El Salvador's words: "(salida)", "(recibido por EDI)". */
+const OUTBOUND = /\((?:salida|recibido por EDI)\)$/i;
+/**
+ * 17TRACK's carrier 19251, Swiss Post, whose leg relays the destination post's
+ * scans as Swiss Post does (carriers/swiss-post/clock.ts).
+ */
+const SWISS_POST = 19251;
+/** The recipient's country, the only field of the address read. */
+function recipientCountry(shipment) {
+    const country = isRecord(shipment.shipping_info) && isRecord(shipment.shipping_info.recipient_address)
+        ? shipment.shipping_info.recipient_address.country : null;
+    return typeof country === 'string' && /^[A-Z]{2}$/.test(country) ? country : null;
+}
 /** 17TRACK's carrier 14061, NZ Post. */
 const NZ_POST = 14061;
 const NZ_DEPARTURE = /^international departure\b/i;
@@ -161,9 +190,8 @@ function nzPostAbroad(events, number, destination) {
  * Post's CN.
  */
 function nzPostDestination(shipment, providers) {
-    const recipient = isRecord(shipment.shipping_info) && isRecord(shipment.shipping_info.recipient_address)
-        ? shipment.shipping_info.recipient_address.country : null;
-    if (typeof recipient === 'string' && /^[A-Z]{2}$/.test(recipient) && recipient !== 'NZ')
+    const recipient = recipientCountry(shipment);
+    if (recipient && recipient !== 'NZ')
         return recipient;
     const others = new Set(providers.map((leg) => isRecord(leg) && isRecord(leg.provider) && leg.provider.key !== NZ_POST
         ? leg.provider.country : null).filter((country) => typeof country === 'string' && /^[A-Z]{2}$/.test(country) && country !== 'NZ'));
@@ -277,16 +305,22 @@ export function parse17TrackResponse(payload, trackingNumber, postcode = null) {
         const abroad = nz && provider.events.length <= MAX_EVENTS
             ? nzPostAbroad(provider.events, number, nzPostDestination(shipment, tracking.providers)) : new Map();
         const origin = reported.key === CHINA_POST ? originZone(number) : null;
+        const salvador = reported.key === CORREO_EL_SALVADOR;
+        const sender = salvador && isValidS10TrackingNumber(number) ? countryTimeZone(number.slice(-2)) : null;
+        const bound = reported.key === SWISS_POST ? recipientCountry(shipment) : null;
         for (const [index, raw] of provider.events.entries()) {
             if (++count > MAX_EVENTS || !isRecord(raw))
                 throw new SchemaError(SOURCE, '17TRACK returned invalid events');
             if (undatedScan(raw))
                 undated++;
             const exchange = origin !== null && ORIGIN_EXCHANGE.test(text(raw.description));
-            // A facility's clock, A1's UTC or NZ Post's, on which 17TRACK puts one offset for the whole parcel.
-            const wall = relaysFacilityClock(name) || utc || nz || exchange ? facilityWall(raw) : null;
-            const zone = !wall ? null : abroad.has(index) ? abroad.get(index) ?? null : exchange ? origin : utc ? 'UTC'
-                : nz ? 'Pacific/Auckland' : facilityZone(text(raw.location));
+            const own = !salvador ? null : OUTBOUND.test(text(raw.description)) ? sender : 'UTC';
+            // The destination post's scan Swiss Post relays, its wall clock under Swiss Post's offset.
+            const relayed = bound ? swissPostDestinationZone(text(raw.description), text(raw.location), bound) : null;
+            // A facility's clock, A1's UTC, NZ Post's or Correos de El Salvador's, on which 17TRACK puts one offset for the whole parcel.
+            const wall = relayed ? rawClock(raw) : relaysFacilityClock(name) || utc || nz || exchange || own ? facilityWall(raw) : null;
+            const zone = !wall ? null : relayed ?? own ?? (abroad.has(index) ? abroad.get(index) ?? null : exchange ? origin : utc ? 'UTC'
+                : nz ? 'Pacific/Auckland' : facilityZone(text(raw.location)));
             const placed = wall && zone ? DateTime.fromISO(wall, { zone }) : null;
             let parsed;
             try {

package/dist/providers/ship24/adapter.js

@@ -20,6 +20,8 @@ import { scrapeUniversalPage } from '../../core/transport/browser.js';
 import { canadaProvinceTimeZone, countryCode, countryTimeZone, EXPLICIT_OFFSET_PATTERN, regionHasTown, sharedClockZone, timeZoneCountry, usStateTimeZone, } from '../../core/time/index.js';
 import { isRecord } from '../../core/types.js';
 import { cttSiteZone, portugalZone } from '../../carriers/ctt/clock.js';
+import { gofoScanZone } from '../../carriers/gofo/clock.js';
+import { swissPostDestinationZone } from '../../carriers/swiss-post/clock.js';
 import { trackingPlace } from '../../places/trackingLocation.js';
 import { courierZone, universalCarrierHints } from '../shared/hints.js';
 import { localEvent, numberOf, place, result } from '../shared/result.js';
@@ -38,7 +40,7 @@ const REFRESH_MS = 15_000;
 const POSTAL_CODE = /\s*\b(?:\d{5}(?:-\d{4})?|[A-Z]\d[A-Z] ?\d[A-Z]\d)$/i;
 /**
  * The clock of the US state or Canadian province a location names ("NORTH
- * YORK, ON", "Des Plaines, IL 60018", "Chicago, IL, US"). A code that is also
+ * YORK, ON", "Des Plaines, IL 12345", "Chicago, IL, US"). A code that is also
  * a country's ("IL" is Israel) needs the town to lie in the state, or the
  * country named after it. Any other code needs a scan in North America: an
  * Italian province ("MILANO MI") is no state.
@@ -63,15 +65,19 @@ function regionZone(location, northAmerican) {
 }
 /** 4PX's way of writing a scan abroad: country, state and town ("US  NY  EXAMPLE TOWN 12345"). */
 const COUNTRY_STATE_TOWN = /^([A-Z]{2})\s{2,}([A-Z]{2})\s{2,}(\S.*)$/;
-/** A scan location's clock: the single clock of the country it names, else of its US state or Canadian province. */
-function locationZone(location, northAmerican) {
+/**
+ * A scan location's clock: the single clock of the country it names, else of
+ * its US state or Canadian province. A feed's one `country` stands for any
+ * country the words name.
+ */
+function locationZone(location, northAmerican, country = null) {
     if (typeof location !== 'string' || !location.trim())
         return null;
     const parts = COUNTRY_STATE_TOWN.exec(location.trim());
     if (parts)
         return countryTimeZone(parts[1]) ?? regionZone(`${parts[3]}, ${parts[2]}, ${parts[1]}`, northAmerican);
-    const country = trackingPlace(location).country;
-    return (country ? countryTimeZone(country) : null) ?? regionZone(location, northAmerican);
+    const named = country ?? trackingPlace(location).country;
+    return (named ? countryTimeZone(named) : null) ?? regionZone(location, northAmerican);
 }
 /** Whether a scan's courier works in the US or Canada only, so its state and province codes are theirs. */
 function northAmericanCourier(scan) {
@@ -105,7 +111,7 @@ const RETURNED = /\breturn(?:ed)? to sender\b/i;
 const RELABELLED_FEEDS = {
     'canada-post-tracking': {},
     'uniuni-tracking': {},
-    'gofo-express-tracking': { own: 'America/Los_Angeles' },
+    'gofo-express-tracking': { country: 'US', place: (location, _journey, status) => gofoScanZone(location, status), own: 'America/Los_Angeles' },
     'postnl-tracking': {},
     'amazon-uk-tracking': { home: () => 'Europe/London' },
     'portugal-ctt-tracking': { place: (location, journey) => cttSiteZone(location, [journey.origin, journey.destination]), home: portugalZone },
@@ -124,6 +130,16 @@ function feedClock(timestamp, feed) {
     const shifted = DateTime.fromISO(timestamp, { setZone: true }).setZone(feed.shift);
     return shifted.isValid ? shifted.toISO({ includeOffset: false, suppressMilliseconds: true }) : timestamp;
 }
+/**
+ * The zone of a scan Swiss Post's feed relays from the destination post: the
+ * feed keeps Swiss Post's offset, on digits that are that office's wall clock
+ * (carriers/swiss-post/clock.ts). Null for any other scan.
+ */
+function swissPostRelayZone(scan, journey) {
+    if (!isRecord(scan.courier) || scan.courier.crawler_code !== 'swiss-post-tracking')
+        return null;
+    return swissPostDestinationZone(typeof scan.status === 'string' ? scan.status : '', typeof scan.location === 'string' ? scan.location : '', journey.destination);
+}
 function journeyOf(data, events, number, couriers, fallback) {
     // An S10 item's suffix is its origin post's country.
     const suffix = /^[A-Z]{2}\d{9}[A-Z]{2}$/.test(number) ? replyCountry(number.slice(-2)) : null;
@@ -149,7 +165,7 @@ function upuZone(journey, scan, wall) {
 /**
  * The zone of a scan whose timestamp names no offset, or a relabelling
  * feed's: it is the scanning carrier's wall clock. Its location's clock comes
- * first (as the feed reads its own sites, then by the names it holds), then
+ * first (as the feed reads its own sites and stations, then by the names it holds), then
  * the country of a parcel that never leaves it, then the side of the border a
  * UPU event's words name. A courier name is the feed that relayed the scan,
  * not where it happened: a national post relays the destination's scans under
@@ -158,8 +174,8 @@ function upuZone(journey, scan, wall) {
  */
 function placedZone(journey, scan, wall, feed) {
     const location = typeof scan.location === 'string' ? scan.location.trim() : '';
-    const located = feed?.place?.(location, journey)
-        ?? locationZone(location, journey.northAmerican || northAmericanCourier(scan))
+    const located = feed?.place?.(location, journey, typeof scan.status === 'string' ? scan.status : '')
+        ?? locationZone(location, journey.northAmerican || northAmericanCourier(scan), feed?.country ?? null)
         ?? (journey.domestic ? countryTimeZone(journey.domestic) : null) ?? upuZone(journey, scan, wall);
     return located || journey.international ? located : feed?.home?.(location) ?? null;
 }
@@ -246,10 +262,12 @@ export function parseShip24Response(payload, trackingNumber, timezone = null) {
             continue;
         // datetime can end in Z while still containing the carrier's local time.
         // timestamp carries the real offset (verified against the public web app),
-        // except for some carrier legs (Chronopost) that omit it entirely, and the
-        // feeds that relabel the carrier's wall clock.
+        // except for some carrier legs (Chronopost) that omit it entirely, the
+        // feeds that relabel the carrier's wall clock, and Swiss Post's relays.
         const feed = feedOf(raw);
-        const parsed = localEvent(feedClock(raw.timestamp, feed), raw.status, raw.dispatch_code_id === 7 ? 'Delivered' : undefined);
+        const relayed = swissPostRelayZone(raw, journey);
+        const clock = relayed && typeof raw.timestamp === 'string' ? raw.timestamp.replace(EXPLICIT_OFFSET_PATTERN, '') : feedClock(raw.timestamp, feed);
+        const parsed = localEvent(clock, raw.status, raw.dispatch_code_id === 7 ? 'Delivered' : undefined);
         if (!parsed)
             continue;
         const location = place(raw.location);
@@ -258,8 +276,8 @@ export function parseShip24Response(payload, trackingNumber, timezone = null) {
         const wall = typeof parsed.local_time === 'string' ? parsed.local_time : null;
         // Another feed's offset-less scan takes the parcel's named clock at once;
         // a relabelling feed's first borrows from its neighbours (below).
-        readings.push({ event: parsed, wall, feed, country: locationCountry(raw.location),
-            zone: wall ? placedZone(journey, raw, wall, feed) ?? (feed ? null : namedZone(journey, wall)) : null });
+        readings.push({ event: parsed, wall, feed, country: feed?.country ?? locationCountry(raw.location),
+            zone: wall ? relayed ?? placedZone(journey, raw, wall, feed) ?? (feed ? null : namedZone(journey, wall)) : null });
     }
     const events = readings.map((reading) => {
         const { event, wall, feed } = reading;

package/dist/server/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Universal Parcel Scraper",
-    "version": "0.69.0"
+    "version": "0.69.2"
   },
   "paths": {
     "/health": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-parcel-scraper",
-  "version": "0.69.0",
+  "version": "0.69.2-main.888",
   "description": "Self-hosted parcel tracking: carrier detection, dedicated scrapers and optional universal providers.",
   "type": "module",
   "license": "Apache-2.0",