npm - universal-parcel-scraper - Versions diffs - 0.36.0 → 0.37.0-main.390 - Mend

universal-parcel-scraper 0.36.0 → 0.37.0-main.390

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/data/catalog.json +2 -1
package/data/detection-golden.json +209 -98
package/dist/browser/scraper.js +3 -1
package/dist/carriers/dpd/adapter.d.ts +6 -4
package/dist/carriers/dpd/adapter.js +14 -8
package/dist/carriers/dpd-de/adapter.js +4 -2
package/dist/carriers/dpd-de/app.d.ts +6 -1
package/dist/carriers/dpd-de/app.js +51 -10
package/dist/carriers/dpd-de/carrier.json +3 -0
package/dist/carriers/tipsa/numbers.json +128 -0
package/dist/data/catalog.json +2 -1
package/dist/generated/catalog.d.ts +1 -0
package/dist/generated/catalog.js +2 -1
package/dist/generated/recognition.js +1 -0
package/dist/server/openapi.json +1 -1
package/package.json +1 -1

package/data/catalog.json CHANGED Viewed

@@ -4431,7 +4431,8 @@
           "help": "Optional. DPD uses it to unlock verified scans and the delivery window.",
           "validator": "germanyPostcode"
         }
-      ]
+      ],
+      "recognitionRank": 65
     },
     "canaryUrl": "https://tracking.dpd.de/status/en_US/parcel/",
     "trackingUrlTemplate": "https://tracking.dpd.de/status/en_US/parcel/{trackingNumber}",

package/data/detection-golden.json CHANGED Viewed

@@ -47,6 +47,26 @@
       "ctt-express"
     ]
   },
+  {
+    "input": "0000100000104002537106",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "ctt-express",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post",
+      "ctt-express"
+    ]
+  },
   {
     "input": "000123450000000027",
     "carrier": "unknown",
@@ -248,10 +268,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -375,10 +395,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -451,10 +471,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -469,6 +489,7 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "chronopost"
     ]
   },
@@ -490,10 +511,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -514,10 +535,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -538,10 +559,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -562,10 +583,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -586,10 +607,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -619,10 +640,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -644,10 +665,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -669,10 +690,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -694,10 +715,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -788,6 +809,24 @@
       "austrian-post"
     ]
   },
+  {
+    "input": "0280400280406520139001",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post"
+    ]
+  },
   {
     "input": "0301006785462006320995",
     "carrier": "unknown",
@@ -855,6 +894,24 @@
       "purolator"
     ]
   },
+  {
+    "input": "0410230410230001262324",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post"
+    ]
+  },
   {
     "input": "041441760228964",
     "carrier": "unknown",
@@ -899,10 +956,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -923,6 +980,60 @@
       "austrian-post"
     ]
   },
+  {
+    "input": "0460040460048104747942",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post"
+    ]
+  },
+  {
+    "input": "0460040460048104754422",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post"
+    ]
+  },
+  {
+    "input": "0460040460048104791791",
+    "carrier": "unknown",
+    "confidence": "low",
+    "candidates": [
+      "tipsa",
+      "austrian-post",
+      "usps",
+      "estafeta"
+    ],
+    "preferred": [
+      "tipsa"
+    ],
+    "asked": [
+      "tipsa",
+      "austrian-post"
+    ]
+  },
   {
     "input": "0460040460048105123537",
     "carrier": "unknown",
@@ -1008,10 +1119,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1035,10 +1146,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1067,10 +1178,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1175,10 +1286,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1211,10 +1322,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1516,10 +1627,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -1792,10 +1903,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1974,10 +2085,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1999,10 +2110,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -2024,10 +2135,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3115,10 +3226,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3140,10 +3251,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3165,10 +3276,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3221,10 +3332,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3562,10 +3673,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3651,10 +3762,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3674,10 +3785,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3737,10 +3848,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4154,10 +4265,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4177,10 +4288,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4326,10 +4437,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -4349,10 +4460,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4564,10 +4675,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -5002,10 +5113,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -5266,10 +5377,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5289,10 +5400,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5346,10 +5457,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5429,10 +5540,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5453,10 +5564,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5507,10 +5618,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5530,10 +5641,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5553,10 +5664,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5697,10 +5808,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5844,10 +5955,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -6959,10 +7070,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -7356,10 +7467,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {

package/dist/browser/scraper.js CHANGED Viewed

@@ -3441,7 +3441,8 @@ var ce = {
 				autoComplete: "postal-code",
 				help: "Optional. DPD uses it to unlock verified scans and the delivery window.",
 				validator: "germanyPostcode"
-			}]
+			}],
+			recognitionRank: 65
 		},
 		canaryUrl: "https://tracking.dpd.de/status/en_US/parcel/",
 		trackingUrlTemplate: "https://tracking.dpd.de/status/en_US/parcel/{trackingNumber}",
@@ -8224,6 +8225,7 @@ var ts = {
 	"dhl-ecommerce-uk": 17,
 	"dhl-express": 75,
 	dpd: 70,
+	"dpd-de": 65,
 	"four-px": 13,
 	"gls-ch": 60,
 	"gls-de": 50,

package/dist/carriers/dpd/adapter.d.ts CHANGED Viewed

@@ -39,11 +39,12 @@ export interface DPDTrackerOptions {
     app?: DPDAppTier;
 }
 export interface DPDAppTier {
-    /** `leads` when the guest tier is still to come and needs time left. */
+    /** `leads` when the guest tier is still to come and needs time left. `postcode` is empty when none was given. */
     run(number: string, context: {
         signal: AbortSignal;
         timeoutMs: number;
         leads: boolean;
+        postcode: string;
     }): Promise<CarrierResult>;
     /** The failures of either tier the other may answer after. */
     recovers(error: unknown): boolean;
@@ -65,9 +66,10 @@ export declare class DPDTracker {
     private browserService;
     fetch(raw: string, postcode?: string, context?: TrackingContext): Promise<CarrierResult>;
     /**
-     * Whether the guest reply establishes Swiss activity for a 14-digit number.
-     * The group-wide identity match alone must not promote another country's
-     * parcel to the Swiss carrier id. Missing country evidence is inconclusive.
+     * Whether the guest reply establishes activity in this tracker's country for
+     * a 14-digit number. The group-wide identity match alone must not promote
+     * another country's parcel to this carrier id. Missing country evidence is
+     * inconclusive.
      * Guest API only, never the page tier. A positive not-found (404) and a
      * details lookup DPD refuses without the postcode (400, seen for old
      * parcels) are false; any other failure, a 400 from a token step included,

package/dist/carriers/dpd/adapter.js CHANGED Viewed

@@ -558,7 +558,9 @@ export class DPDTracker {
         const appStep = (leads) => ({
             id: 'app',
             ...(leads ? {} : { recovers: appRecovers }),
-            run: ({ signal, remainingMs }) => app.run(trackingNumber, { signal, timeoutMs: remainingMs, leads }),
+            run: ({ signal, remainingMs }) => app.run(trackingNumber, {
+                signal, timeoutMs: remainingMs, leads, postcode: resolvedPostcode,
+            }),
         });
         const result = await runSteps({
             carrier, budgetMs: lookup.budgetMs, signal: lookup.signal, recorder: this.recorder,
@@ -589,9 +591,10 @@ export class DPDTracker {
         return result;
     }
     /**
-     * Whether the guest reply establishes Swiss activity for a 14-digit number.
-     * The group-wide identity match alone must not promote another country's
-     * parcel to the Swiss carrier id. Missing country evidence is inconclusive.
+     * Whether the guest reply establishes activity in this tracker's country for
+     * a 14-digit number. The group-wide identity match alone must not promote
+     * another country's parcel to this carrier id. Missing country evidence is
+     * inconclusive.
      * Guest API only, never the page tier. A positive not-found (404) and a
      * details lookup DPD refuses without the postcode (400, seen for old
      * parcels) are false; any other failure, a 400 from a token step included,
@@ -601,17 +604,20 @@ export class DPDTracker {
         const trackingNumber = dpdParcelNumber(raw);
         if (!trackingNumber)
             return false;
-        const lookup = lookupBudget(context, this.budgetMs, 'dpd');
+        const lookup = lookupBudget(context, this.budgetMs, this.country === 'DE' ? 'dpd-de' : 'dpd');
         try {
             const payload = await this.detailsWithFreshToken(trackingNumber, undefined, lookup);
             if (clean(payload.parcelNumber ?? payload.shipmentId) !== trackingNumber)
                 return false;
             const current = isRecord(payload.status) ? payload.status : {};
             const country = known(current.countryCode).toUpperCase();
-            if (/^[A-Z]{2}$/.test(country) && country !== 'CH')
+            if (/^[A-Z]{2}$/.test(country) && country !== this.country)
                 return false;
-            if (country !== 'CH')
-                throw new IndeterminateError('DPD Switzerland', 'DPD returned no Swiss country evidence');
+            if (country !== this.country) {
+                throw this.country === 'DE'
+                    ? new IndeterminateError('DPD Germany', 'DPD returned no German country evidence')
+                    : new IndeterminateError('DPD Switzerland', 'DPD returned no Swiss country evidence');
+            }
             requireGuestActivity(payload, parseDPDTrackingApi(payload, trackingNumber));
             return true;
         }

package/dist/carriers/dpd-de/adapter.js CHANGED Viewed

@@ -13,8 +13,8 @@ export const adapter = (environment) => {
         recorder: environment.recorder,
         userAgent: environment.userAgent,
         app: {
-            run: (number, { signal, timeoutMs, leads }) => app.track(number, {
-                signal, timeoutMs, sessionWaitMs: leads ? Math.max(0, timeoutMs - GUEST_RESERVE_MS) : timeoutMs,
+            run: (number, { signal, timeoutMs, leads, postcode }) => app.track(number, {
+                signal, timeoutMs, postcode, sessionWaitMs: leads ? Math.max(0, timeoutMs - GUEST_RESERVE_MS) : timeoutMs,
             }),
             // Each service has its own host, limits and outages, so either answers when
             // the other fails. Both read the same parcel: neither can place another
@@ -26,5 +26,7 @@ export const adapter = (environment) => {
     return {
         id: 'dpd-de', recordsSteps: true, steps: ['app', 'direct'],
         track: (input, context) => tracker.fetch(input.number, input.postcode ?? '', context),
+        // The guest API's current country, as for Switzerland: the app's session takes too long to open.
+        recognize: async (number, context) => ({ known: await tracker.recognizes(number, context) }),
     };
 };

package/dist/carriers/dpd-de/app.d.ts CHANGED Viewed

@@ -30,11 +30,16 @@ export declare class DpdDeAppClient {
         userAgent?: string;
         now?: () => number;
     });
-    /** `sessionWaitMs` bounds the wait for a session still opening; the whole `timeoutMs` by default. */
+    /**
+     * `sessionWaitMs` bounds the wait for a session still opening; the whole `timeoutMs` by default.
+     * DPD checks a `postcode` against the recipient's: a rejected one gets one lookup without it, and
+     * the result says which, as on the guest API.
+     */
     track(number: string, options: {
         signal: AbortSignal;
         timeoutMs: number;
         sessionWaitMs?: number;
+        postcode?: string;
     }): Promise<CarrierResult>;
     /**
      * One session for every lookup. The opening runs while a lookup that asked for it is still

package/dist/carriers/dpd-de/app.js CHANGED Viewed

@@ -56,6 +56,13 @@ const elements = (fields) => Object.entries(fields)
     .map(([name, value]) => `<${name}>${typeof value === 'string' ? escaped(value) : elements(value)}</${name}>`).join('');
 class SessionExpired extends Error {
 }
+class PostcodeRejected extends Error {
+}
+/** A two-letter country, where the service puts a placeholder three-letter one for an unknown depot. */
+function countryOf(node) {
+    const country = node ? scalar(node, 'Country', 8) : '';
+    return /^[A-Z]{2}$/.test(country) ? country : '';
+}
 function statusOf(stage) {
     if (stage === 'delivered' || stage === 'out_for_delivery' || stage === 'exception')
         return stage;
@@ -68,16 +75,12 @@ export function parseDpdDeApp(data, scans, number) {
     const tracking = one(data, 'TrackingData');
     if (scalar(tracking, 'ParcelNo', 40) !== number)
         throw new SchemaError('DPD Germany', 'DPD Germany returned a different parcel');
-    // The service also answers for parcels delivered elsewhere in the group.
-    const destination = scalar(one(tracking, 'ShipAddress'), 'Country', 8);
-    if (/^[A-Z]{2}$/.test(destination) && destination !== 'DE') {
-        throw new IndeterminateError('DPD Germany', 'DPD returned activity in another country', { reason: DPD_DE_OTHER_COUNTRY });
-    }
     const rows = children(one(scans, 'TrackingScanList'), 'TrackingScan');
     if (rows.length > 500)
         invalid();
     const events = [];
     const seen = new Set();
+    let placed = '';
     for (const row of rows) {
         const wording = scalar(row, 'StatusText', 500);
         const day = scalar(row, 'ScanDate', 16);
@@ -88,6 +91,8 @@ export function parseDpdDeApp(data, scans, number) {
         if (/^Your parcel is estimated to be delivered\b/i.test(wording))
             continue;
         const place = /^(.{1,120}) \(([A-Z]{2})\)$/.exec(scalar(row, 'Location'));
+        if (place)
+            placed = place[2];
         // German facilities keep German civil time; a clock elsewhere has no established zone.
         const clock = zonedTime(`${day} ${time}`, 'dd.MM.yyyy HH:mm', place?.[2] === 'DE' ? 'Europe/Berlin' : 'UTC');
         if (!clock)
@@ -108,6 +113,14 @@ export function parseDpdDeApp(data, scans, number) {
     }
     if (!events.length)
         throw new IndeterminateError('DPD Germany', 'DPD Germany returned no parcel scans');
+    // The service also answers for parcels elsewhere in the group, and its recipient address reads
+    // Germany for them too. Where the parcel is now, as the guest API's current country: the newest
+    // placed scan, else the depot of the last status.
+    const depot = children(tracking, 'LastStatusInfo').flatMap(info => children(info, 'DepotData')).flatMap(data => children(data, 'Address'))[0];
+    const country = placed || countryOf(depot);
+    if (country && country !== 'DE') {
+        throw new IndeterminateError('DPD Germany', 'DPD returned activity in another country', { reason: DPD_DE_OTHER_COUNTRY });
+    }
     events.reverse();
     const current = events[0];
     const rail = DPD_DE_APP_RAIL[scalar(one(tracking, 'LastStatusInfo'), 'StatusID', 64)];
@@ -140,20 +153,46 @@ export class DpdDeAppClient {
         this.#userAgent = userAgentOf(options.userAgent);
         this.#now = options.now ?? Date.now;
     }
-    /** `sessionWaitMs` bounds the wait for a session still opening; the whole `timeoutMs` by default. */
+    /**
+     * `sessionWaitMs` bounds the wait for a session still opening; the whole `timeoutMs` by default.
+     * DPD checks a `postcode` against the recipient's: a rejected one gets one lookup without it, and
+     * the result says which, as on the guest API.
+     */
     async track(number, options) {
         if (!/^\d{14}$/.test(number))
             throw new TypeError('DPD Germany app tracking takes 14 digits');
+        const postcode = options.postcode ?? '';
+        if (postcode && !/^\d{5}$/.test(postcode))
+            throw new TypeError('DPD Germany app tracking takes a 5-digit postcode');
         const deadline = performance.now() + options.timeoutMs;
         const left = () => Math.max(1, Math.floor(deadline - performance.now()));
         try {
             for (let attempt = 0;; attempt += 1) {
                 const session = await this.session(options.signal, Math.min(left(), options.sessionWaitMs ?? Infinity));
+                // Read-only: the parcel is neither added to the session nor redirected.
+                const tracking = (zip) => this.call('getTrackingData', { SessionToken: session, ParcelNo: number, DeliveryZipCode: zip,
+                    UpdateNewDeliveryData: 'false', addParcelIfNoTrackingdataAvailable: 'false', ParcelFlowTypeID: 'receiving' }, options.signal, left());
                 try {
-                    const data = await this.call('getTrackingData', { SessionToken: session, ParcelNo: number, DeliveryZipCode: '',
-                        UpdateNewDeliveryData: 'false', addParcelIfNoTrackingdataAvailable: 'false', ParcelFlowTypeID: 'receiving' }, options.signal, left());
-                    const scans = await this.call('getTrackingScanList', { SessionToken: session, ParcelNo: number, DeliveryZipCode: '' }, options.signal, left());
-                    return parseDpdDeApp(data, scans, number);
+                    let data;
+                    let verified;
+                    try {
+                        data = await tracking(postcode);
+                        if (postcode)
+                            verified = ['DeliveryZipCode_isValid', 'Owner'].includes(scalar(one(data, 'TrackingData'), 'DataViewStatus', 40));
+                    }
+                    catch (error) {
+                        // Also the answer for an unknown parcel, which the lookup without it then reports.
+                        if (!(error instanceof PostcodeRejected))
+                            throw error;
+                        data = await tracking('');
+                        verified = false;
+                    }
+                    const scans = await this.call('getTrackingScanList', { SessionToken: session, ParcelNo: number,
+                        DeliveryZipCode: verified ? postcode : '' }, options.signal, left());
+                    const result = parseDpdDeApp(data, scans, number);
+                    if (verified !== undefined)
+                        result.dpd_postcode_verified = verified;
+                    return result;
                 }
                 catch (error) {
                     if (!(error instanceof SessionExpired) || attempt)
@@ -255,6 +294,8 @@ export class DpdDeAppClient {
         }
         if (codes.includes('ERROR_SESSION_NOT_VALID'))
             throw new SessionExpired();
+        if (codes.includes('ERROR_TRACKING_DELIVERYZIPCODE_NOT_VALID'))
+            throw new PostcodeRejected();
         // "No tracking data" also answers for parcels the scan list still knows: it proves no absence.
         if (scalar(result, 'Ack', 8) !== 'true')
             throw new IndeterminateError('DPD Germany', 'DPD Germany returned no confirmed parcel');

package/dist/carriers/dpd-de/carrier.json CHANGED Viewed

@@ -21,6 +21,9 @@
       "app",
       "direct"
     ],
+    "recognition": {
+      "rank": 65
+    },
     "requirements": [
       {
         "field": "postcode",

package/dist/carriers/tipsa/numbers.json CHANGED Viewed

@@ -22,6 +22,32 @@
       },
       "note": "Publicly reported shipment number; the attribution was not independently verified. The source attributes it to TIPSA. CTT Express numbers can share the 000010 prefix, so it stays ambiguous and recognition asks TIPSA first."
     },
+    {
+      "number": "0000100000104002537106",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://web.archive.org/web/20260420103951/https://aplicaciones.tip-sa.com/cliente/datos_env.php?id=0000100000104002537106",
+        "date": "2026-04-20",
+        "dateKind": "capture",
+        "access": "full_page"
+      },
+      "context": {
+        "assessment": "confirmed"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "ctt-express",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "A TIPSA tracking link archived by the Wayback Machine. TIPSA's tracker returns its history. CTT Express numbers can share the 000010 prefix, so it stays ambiguous and recognition asks TIPSA first."
+    },
     {
       "number": "0280010280017024953690",
       "role": "shipment",
@@ -42,6 +68,48 @@
       },
       "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment."
     },
+    {
+      "number": "0280400280406520139001",
+      "role": "shipment",
+      "evidence": "open_source_example",
+      "source": {
+        "url": "https://github.com/CarlosAdrianM/NestoAPI/blob/88934ca46092ad77d1b1dd66b6b60c9811659b21/NestoAPI.Tests/Models/UltimoEnvioClienteDTOTests.cs",
+        "date": "2026-06-22",
+        "dateKind": "publication",
+        "access": "full_page"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Expected tracking link in an open-source TIPSA integration's test, built from the sender's fixed agency codes and a waybill. TIPSA's tracker does not find it, so the waybill may be invented."
+    },
+    {
+      "number": "0410230410230001262324",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://portaldaqueixa.com/brands/tipsa/complaints/tipsa-nao-entrega-1-146881425",
+        "date": "2025-12-24"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment; TIPSA's tracker no longer finds it."
+    },
     {
       "number": "0460040240008103140542",
       "role": "shipment",
@@ -62,6 +130,66 @@
       },
       "note": "Publicly reported shipment number; the attribution was not independently verified. Its two agency codes differ."
     },
+    {
+      "number": "0460040460048104747942",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://portaldaqueixa.com/brands/tipsa/complaints/tipsa-produto-nao-foi-entregue-142779725",
+        "date": "2025-10-23"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment; TIPSA's tracker no longer finds it."
+    },
+    {
+      "number": "0460040460048104754422",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://portaldaqueixa.com/brands/tipsa/complaints/tipsa-entrega-nao-efetuada-e-falsas-tentativas-registadas-pela-tipsa-142905725",
+        "date": "2025-10-26"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment; TIPSA's tracker no longer finds it."
+    },
+    {
+      "number": "0460040460048104791791",
+      "role": "shipment",
+      "evidence": "public_shipment_report",
+      "source": {
+        "url": "https://portaldaqueixa.com/brands/tipsa/complaints/tipsa-encomenda-por-entregar-desde-3010-tipsa-144629825",
+        "date": "2025-11-27"
+      },
+      "expect": {
+        "carrier": "unknown",
+        "confidence": "low",
+        "candidates": [
+          "tipsa",
+          "austrian-post",
+          "usps",
+          "estafeta"
+        ]
+      },
+      "note": "Publicly reported shipment number; the attribution was not independently verified. Portuguese shipment; TIPSA's tracker no longer finds it."
+    },
     {
       "number": "0460040460048105123537",
       "role": "shipment",

package/dist/data/catalog.json CHANGED Viewed

@@ -4431,7 +4431,8 @@
                     "help": "Optional. DPD uses it to unlock verified scans and the delivery window.",
                     "validator": "germanyPostcode"
                 }
-            ]
+            ],
+            "recognitionRank": 65
         },
         "canaryUrl": "https://tracking.dpd.de/status/en_US/parcel/",
         "trackingUrlTemplate": "https://tracking.dpd.de/status/en_US/parcel/{trackingNumber}",

package/dist/generated/catalog.d.ts CHANGED Viewed

@@ -2980,6 +2980,7 @@ export declare const CARRIER_CATALOG: {
                 readonly help: "Optional. DPD uses it to unlock verified scans and the delivery window.";
                 readonly validator: "germanyPostcode";
             }];
+            readonly recognitionRank: 65;
         };
         readonly canaryUrl: "https://tracking.dpd.de/status/en_US/parcel/";
         readonly trackingUrlTemplate: "https://tracking.dpd.de/status/en_US/parcel/{trackingNumber}";

package/dist/generated/catalog.js CHANGED Viewed

@@ -4432,7 +4432,8 @@ export const CARRIER_CATALOG = {
                     "help": "Optional. DPD uses it to unlock verified scans and the delivery window.",
                     "validator": "germanyPostcode"
                 }
-            ]
+            ],
+            "recognitionRank": 65
         },
         "canaryUrl": "https://tracking.dpd.de/status/en_US/parcel/",
         "trackingUrlTemplate": "https://tracking.dpd.de/status/en_US/parcel/{trackingNumber}",

package/dist/generated/recognition.js CHANGED Viewed

@@ -20,6 +20,7 @@ export const CARRIER_RECOGNITION_RANKS = {
     "dhl-ecommerce-uk": 17,
     "dhl-express": 75,
     "dpd": 70,
+    "dpd-de": 65,
     "four-px": 13,
     "gls-ch": 60,
     "gls-de": 50,

package/dist/server/openapi.json CHANGED Viewed

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

package/package.json CHANGED Viewed

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