universal-parcel-scraper 0.69.6-main.895 → 0.69.7-main.899

package/README.md

@@ -155,7 +155,7 @@ createTracker({ providers: ['ParcelsApp', 'Ship24', '17TRACK', 'Postal Ninja', '
 <!-- GENERATED:stages -->
 <img src="docs/assets/stages.svg" alt="DHL: Die Sendung wurde in das Zustellfahrzeug geladen.; Mondial Relay: En cours de livraison; Correios Brazil: Objeto saiu para entrega ao destinatário; Correos Express: EN REPARTO; Yamato Transport: 配達中; La Poste / Colissimo: DISTOU. All are filed under out_for_delivery." width="760">
 
-The carrier folders record 3,347 such statuses, each filed under one stage.
+The carrier folders record 3,350 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/data/catalog.json

@@ -943,7 +943,7 @@
     ],
     "detectionRules": [
       {
-        "pattern": "^06(?:0[6-9]|1\\d)\\d{10}$",
+        "pattern": "^06[01]\\d{11}$",
         "confidence": "low",
         "preferred": true
       },

package/dist/browser/scraper.js

@@ -879,7 +879,7 @@ var ye = {
 		}],
 		detectionRules: [
 			{
-				pattern: "^06(?:0[6-9]|1\\d)\\d{10}$",
+				pattern: "^06[01]\\d{11}$",
 				confidence: "low",
 				preferred: !0
 			},

package/dist/carriers/dpd/carrier.json

@@ -97,7 +97,7 @@
   "detection": [
     {
       "id": "dpd-2",
-      "pattern": "^06(?:0[6-9]|1\\d)\\d{10}$",
+      "pattern": "^06[01]\\d{11}$",
       "confidence": "low",
       "preferred": true
     },

package/dist/carriers/evri-uk/browser.js

@@ -113,7 +113,7 @@ export async function requestEvriUkInPage({ number, budgetMs }) {
             }
             const stageCode = event.trackingStage.trackingStageCode.trim();
             const description = event.trackingPoint.description;
-            const safeDescription = stageCode === '5_COURIER' ? 'Delivered'
+            const safeDescription = stageCode === '5_COURIER' || stageCode === '5_SHOP' ? 'Delivered'
                 : /\b(?:delivered (?:to|by)|signed (?:for )?by)\b/i.test(description) ? 'Delivery update' : description;
             const eta = record(event.eta) && scalar(event.eta.start, 64) && scalar(event.eta.end, 64)
                 ? { start: event.eta.start, end: event.eta.end } : undefined;

package/dist/carriers/evri-uk/parser.js

@@ -5,14 +5,18 @@ import { explicitOffsetTime } from '../../core/time/index.js';
 import { clean, cleanScalar } from '../../core/transport/text.js';
 import { isRecord } from '../../core/types.js';
 // Evri's rail codes. A parcel's `trackingListV2` lists the rail it is on;
-// a customer return runs 0, 2, 4.
+// a customer return runs 0, 2, 4. A parcel sent to a ParcelShop or locker
+// waits on 4_SHOP or 4_LOCKER, which Evri's page calls awaiting collection,
+// and 5_SHOP is its collection.
 const STAGES = new Map([
     ['0', 'registered'], ['1', 'registered'], ['2', 'in_transit'], ['3', 'in_transit'], ['4', 'returned'],
     ['4_COURIER', 'out_for_delivery'], ['5_COURIER', 'delivered'],
+    ['4_SHOP', 'ready_for_pickup'], ['4_LOCKER', 'ready_for_pickup'], ['5_SHOP', 'delivered'],
 ]);
 // Tracking points that their rail code files too broadly: a drop-off or
 // collection is the acceptance, and a courier's failed visit stays on the
-// out-for-delivery rail.
+// out-for-delivery rail. The collection rails are never refined: a
+// ParcelShop arrival there is the parcel waiting for its recipient.
 const POINTS = new Map([
     ['ACCEPTED_BY_HERMES', 'accepted'], ['ARRIVED_PARCELSHOP', 'accepted'], ['COLLECTED_BY_EVRI', 'accepted'],
     ['QUADIENT_LOCKER_DROPOFF', 'accepted'], ['PROCESSING_RETURN', 'returned'],
@@ -22,6 +26,8 @@ function stageOf(stageCode, pointCode) {
     const rail = STAGES.get(stageCode);
     if (!rail)
         return undefined;
+    if (rail === 'ready_for_pickup' || stageCode === '5_SHOP')
+        return rail;
     if (rail === 'out_for_delivery' && pointCode.startsWith('NOT_DELIVERED_'))
         return 'failed_attempt';
     return POINTS.get(pointCode) ?? rail;

package/dist/carriers/evri-uk/statuses.json

@@ -27,6 +27,9 @@
     { "code": "COURIER_REATTEMPT_CUSTOMER_NOT_AVAILABLE", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "firstSeen": "2026-10-08", "note": "On the courier rail: \"unable to deliver your parcel today\"." },
     { "code": "REDELIVER_WORKDAY_COURIER", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "firstSeen": "2026-10-08", "note": "Same wording as the missed visit." },
     { "code": "NOT_DELIVERED_BUSINESS_CLOSED", "language": "en", "stage": "failed_attempt", "confirmedBy": "live", "firstSeen": "2026-10-08", "note": "Every NOT_DELIVERED_ point on the courier rail is a failed attempt." },
+    { "code": "4_SHOP", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "bundle", "firstSeen": "2026-10-11", "note": "Rail code: evri.com's tracking page reads 4_SHOP as awaiting collection at a ParcelShop. Every point on this rail is ready for pickup." },
+    { "code": "4_LOCKER", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "bundle", "firstSeen": "2026-10-11", "note": "Rail code: awaiting collection from an Evri locker, opened with the recipient's code." },
+    { "code": "5_SHOP", "language": "en", "stage": "delivered", "confirmedBy": "bundle", "firstSeen": "2026-10-11", "note": "Rail code: evri.com's page reads it as collected from the ParcelShop or locker; the wording becomes \"Delivered\"." },
     { "code": "DELIVERED", "language": "en", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-10-08" },
     { "code": "DELIVERED_LETTERBOX", "language": "en", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-10-08" },
     { "code": "DELIVERED_OUTBUILDING", "language": "en", "stage": "delivered", "confirmedBy": "live", "firstSeen": "2026-10-08" },

package/dist/carriers/hermes-de/adapter.js

@@ -3,7 +3,7 @@ import { lookupBudget, recognizeFromLookup } from '../../core/adapter/index.js';
 import { InvalidInputError, NotFoundError, SchemaError, UpstreamHttpError } from '../../core/errors/index.js';
 import { clean, fetchBounded, parseJsonBytes, userAgentOf } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
-import { COLLECTED_AT_PARCELSHOP, hermesGermanyMilestone, IGNORED_BOOKING_STATUS } from './status.js';
+import { COLLECTED_AT_PARCELSHOP, hermesGermanyMilestone, IGNORED_BOOKING_STATUS, IN_PARCELBOX } from './status.js';
 // Public recipient protocol inspected 2026-09-08:
 // https://gcp-prd.my-deliveries.de/tnt/bundle/tnt-bundle-v2.js
 // Separate from Hermes Einrichtungs-Service (myhes.de). The postcode-protected
@@ -113,9 +113,24 @@ export function parseHermesGermanyResponse(payload, trackingNumber) {
     const atg = isRecord(parcel.atg) ? parcel.atg : {};
     const sender = clean(atg.companyName) || null;
     const eta = etaDate(parcel.eta ?? parcel.deliveryForecast ?? attributes.deliveredTimestamp);
-    const deliveredByCode = latest.metadata?.status === 'delivered';
+    // The tracking page offers the Hermes Box pickup code while
+    // `readyForParcelBoxCollection` is true: the parcel waits in the locker,
+    // even when the newest row or the delivered flag reads as a delivery.
+    // Once Hermes clears it, a box delivery that is still the newest row has
+    // been taken out.
+    const view = isRecord(parcel.viewParameters) ? parcel.viewParameters : {};
+    const boxReady = view.readyForParcelBoxCollection;
+    const latestCode = latest.event.provider_code;
+    const readsDelivered = !latest.metadata || latest.metadata.stage === 'delivered';
+    const inBox = latestCode === IN_PARCELBOX ? boxReady !== false : boxReady === true && readsDelivered;
+    const takenOut = latestCode === IN_PARCELBOX && boxReady === false;
+    if (inBox) {
+        latest.metadata = hermesGermanyMilestone(IN_PARCELBOX);
+        latest.event.stage = 'ready_for_pickup';
+    }
+    const deliveredByCode = latest.metadata?.status === 'delivered' || takenOut;
     const deliveredByFlag = attributes.delivered === true;
-    const delivered = deliveredByCode || deliveredByFlag;
+    const delivered = !inBox && (deliveredByCode || deliveredByFlag);
     if (!latest.metadata && !delivered) {
         return {
             status: 'unknown',
@@ -128,7 +143,7 @@ export function parseHermesGermanyResponse(payload, trackingNumber) {
         };
     }
     const status = delivered ? 'delivered' : latest.metadata.status;
-    const stage = latest.metadata?.stage ?? (delivered ? 'delivered' : 'in_transit');
+    const stage = takenOut ? 'delivered' : latest.metadata?.stage ?? (delivered ? 'delivered' : 'in_transit');
     const deliveredAt = delivered ? latest.event.time : null;
     const pickupPoint = parcelShop(parcel, latest);
     return {

package/dist/carriers/hermes-de/status.d.ts

@@ -21,6 +21,8 @@ export interface Milestone {
 /** `parcelStatus` → milestone, read from the public recipient bundle on 2026-09-08. */
 export declare const STATUSES: Record<string, Milestone>;
 export declare const IGNORED_BOOKING_STATUS: Set<string>;
+/** The code for a parcel put into a Hermes Box, which waits there for its recipient. */
+export declare const IN_PARCELBOX = "DELIVERED_PARCELBOX";
 /** Codes for a parcel the recipient collected at a ParcelShop. */
 export declare const COLLECTED_AT_PARCELSHOP: Set<string>;
 /** The milestone for a `parcelStatus`, or undefined when the code is not mapped. */

package/dist/carriers/hermes-de/status.js

@@ -30,11 +30,13 @@ export const STATUSES = {
     DELIVERED_DROPOFF: milestone('delivered', 'delivered', 'Delivered to the agreed safe place'),
     DELIVERED_MAILBOX: milestone('delivered', 'delivered', 'Delivered to the mailbox'),
     DELIVERED_PARCELSHOP: milestone('delivered', 'delivered', 'Collected at the ParcelShop'),
-    DELIVERED_PARCELBOX: milestone('delivered', 'delivered', 'Delivered to the parcel box'),
     PICKED_UP_BY_RECIPIENT: milestone('delivered', 'delivered', 'Collected by the recipient'),
     COLLECTED: milestone('delivered', 'delivered', 'Collected by the recipient'),
     PARCELSHOP_COLLECTED_BY_CUSTOMER: milestone('delivered', 'delivered', 'Collected at the ParcelShop'),
     INTERNATIONAL_DELIVERED: milestone('delivered', 'delivered', 'Delivered'),
+    // A Hermes Box is a pickup locker: the recipient takes the parcel out with
+    // a pickup code within 72 hours, or it goes back to the sender.
+    DELIVERED_PARCELBOX: milestone('ready_for_pickup', 'out_for_delivery', 'Ready for collection from the Hermes Box'),
     READY_FOR_PICKUP: milestone('ready_for_pickup', 'out_for_delivery', 'Ready for collection'),
     PARCELSHOP_ITEMS_FOR_COLLECTION: milestone('ready_for_pickup', 'out_for_delivery', 'Ready for collection at the ParcelShop'),
     READY_FOR_COLLECTION: milestone('ready_for_pickup', 'out_for_delivery', 'Ready for collection'),
@@ -51,6 +53,8 @@ export const STATUSES = {
 // Delivery preference bookings (a safe place, a ParcelShop) record the
 // recipient's wish, not a movement, and must never move the parcel backwards.
 export const IGNORED_BOOKING_STATUS = new Set(['EDL_BOOKED_DROPOFF', 'EDL_BOOKED_PARCELSHOP']);
+/** The code for a parcel put into a Hermes Box, which waits there for its recipient. */
+export const IN_PARCELBOX = 'DELIVERED_PARCELBOX';
 /** Codes for a parcel the recipient collected at a ParcelShop. */
 export const COLLECTED_AT_PARCELSHOP = new Set(['PARCELSHOP_COLLECTED_BY_CUSTOMER', 'DELIVERED_PARCELSHOP']);
 /** The milestone for a `parcelStatus`, or undefined when the code is not mapped. */

package/dist/carriers/hermes-de/statuses.json

@@ -184,10 +184,10 @@
     },
     {
       "code": "DELIVERED_PARCELBOX",
-      "stage": "delivered",
+      "stage": "ready_for_pickup",
       "confirmedBy": "official-doc",
       "firstSeen": "2026-09-08",
-      "note": "Delivered to the parcel box"
+      "note": "Put into a Hermes Box, a pickup locker. Hermes's Hermes Box terms (myhermes.de/content/pdf/hermesbox_nutzungsbedingungen.pdf) have the recipient generate a pickup code on the tracking page and take the parcel out within 72 hours, or it goes back to the sender."
     },
     {
       "code": "PICKED_UP_BY_RECIPIENT",

package/dist/data/catalog.json

@@ -943,7 +943,7 @@
         ],
         "detectionRules": [
             {
-                "pattern": "^06(?:0[6-9]|1\\d)\\d{10}$",
+                "pattern": "^06[01]\\d{11}$",
                 "confidence": "low",
                 "preferred": true
             },

package/dist/generated/catalog.d.ts

@@ -591,7 +591,7 @@ export declare const CARRIER_CATALOG: {
             readonly params: readonly ["parcelNumber", "parcelnumber"];
         }];
         readonly detectionRules: readonly [{
-            readonly pattern: "^06(?:0[6-9]|1\\d)\\d{10}$";
+            readonly pattern: "^06[01]\\d{11}$";
             readonly confidence: "low";
             readonly preferred: true;
         }, {

package/dist/generated/catalog.js

@@ -944,7 +944,7 @@ export const CARRIER_CATALOG = {
         ],
         "detectionRules": [
             {
-                "pattern": "^06(?:0[6-9]|1\\d)\\d{10}$",
+                "pattern": "^06[01]\\d{11}$",
                 "confidence": "low",
                 "preferred": true
             },

package/dist/server/openapi.json

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

package/package.json

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