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

package/data/catalog.json

@@ -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

@@ -248,10 +248,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -375,10 +375,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -451,10 +451,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -469,6 +469,7 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "chronopost"
     ]
   },
@@ -490,10 +491,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -514,10 +515,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -538,10 +539,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -562,10 +563,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -586,10 +587,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -619,10 +620,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -644,10 +645,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -669,10 +670,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -694,10 +695,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -899,10 +900,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1008,10 +1009,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1035,10 +1036,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1067,10 +1068,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1175,10 +1176,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1211,10 +1212,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1516,10 +1517,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -1792,10 +1793,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1974,10 +1975,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -1999,10 +2000,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -2024,10 +2025,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3115,10 +3116,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3140,10 +3141,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3165,10 +3166,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3221,10 +3222,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3562,10 +3563,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -3651,10 +3652,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3674,10 +3675,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -3737,10 +3738,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4154,10 +4155,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4177,10 +4178,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4326,10 +4327,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -4349,10 +4350,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -4564,10 +4565,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -5002,10 +5003,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "hermes-de",
-      "relais-colis"
+      "hermes-de"
     ]
   },
   {
@@ -5266,10 +5267,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5289,10 +5290,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5346,10 +5347,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5429,10 +5430,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5453,10 +5454,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5507,10 +5508,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5530,10 +5531,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5553,10 +5554,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5697,10 +5698,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -5844,10 +5845,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -6959,10 +6960,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {
@@ -7356,10 +7357,10 @@
     ],
     "asked": [
       "dpd",
+      "dpd-de",
       "seur",
       "brt",
-      "relais-colis",
-      "ciblex"
+      "relais-colis"
     ]
   },
   {

package/dist/browser/scraper.js

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

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

package/dist/data/catalog.json

@@ -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

@@ -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

@@ -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

@@ -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

@@ -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

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