universal-parcel-scraper 0.637.1 → 0.638.0-main.3012

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 16,380 such statuses, each filed under one stage.
+The carrier folders record 16,387 such statuses, each filed under one stage.
 <!-- /GENERATED:stages -->
 
 Wording nobody recorded yet goes through a classifier that reads seven European languages.

package/dist/browser/scraper.js

@@ -29850,7 +29850,7 @@ function Hc(e) {
 	if (sc(t) || /\b(?:en|em) (?:proceso de |processo de )?devolu(?:cion|cao)\b|^devolu(?:cion|cao)$|\bdevolu(?:cion|cao) (?:en curso|em curso|iniciada|solicitada|en transito|em transito)\b|\bdevolu(?:cion|cao) (?:al|ao|a la|a) (?:remitente|remetente|origen|origem)\b(?! (?:completad|finalizad|concluid|entregad|entregue|realizad|efectuad|efetuad))|\ben camino (?:de vuelta |de regreso )?(?:al|hacia el) remitente\b|\b(?:a caminho (?:de volta )?(?:do|ao)|em transito para o) remetente\b|\b(?:siendo|sendo|a ser) (?:(?:devuelt|devolvid)[oa]s?|entregad[oa]s? al remitente|entregues? ao remetente)\b|\b(?:no|nao) (?:(?:ha|han|se|fue|foi|foram|sido|ser|sera|puede|pode|pudo|podido|todavia|aun|ainda|ya|ja) )*(?:(?:devuelt|devolvid)[oa]s?|entregad[oa]s? al remitente|entregues? ao remetente)\b|\b(?:sera|seran|serao|va a ser|vai ser|puede ser|pode ser|debe ser|deve ser|devera ser) (?:(?:pronto|proximamente|en breve|em breve|brevemente) )?(?:(?:devuelt|devolvid)[oa]s?|entregad[oa]s? al remitente|entregues? ao remetente)\b|\bse (?:le )?devolvera\b/.test(t)) return "exception";
 	if (/returned to (?:the )?sender|retour(?:ne)? a l'expediteur|zuruck an (?:den )?absender|an (?:den )?absender zuruck|retour a l'expediteur|reso al mittente|restituit[oa] al mittente|delivered (?:back )?to (?:the )?(?:sender|shipper)/.test(t) || /^(?:(?:envio|paquete|pedido|objeto|encomenda|pacote|remessa) )?(?:devuelt|devolvid)[oa]$|\b(?:devuelt|devolvid|retornad)[oa]s? (?:al|ao|a la|a) (?:remitente|remetente|origen|origem)\b|\bentregad[oa]s? al remitente\b|\bentregues? ao remetente\b|\bdevolu(?:cion|cao) (?:(?:al|ao|a la|a) (?:remitente|remetente|origen|origem) )?(?:completad|finalizad|concluid|entregad|entregue|realizad|efectuad|efetuad)/.test(t)) return "returned";
 	if (/^(?:a )?(?:new|next|another|further) (?:delivery )?attempt\b/.test(t) && !/\b(?:not|unable|fail(?:ed|ure)?|unsuccessful|missed|absent|closed|refused|nobody|no one)\b|n't\b/.test(t)) return "in_transit";
-	if (/not (?:yet )?delivered|\bun ?delivered\b|(?:could not|couldn't).*deliver|\bcan(?: ?not|'t) be delivered\b|unable to deliver|delivery (?:attempt|failed)|non livre|n'(?:a|avons) (?:pas )?pu.*(?:remis|remettre)|n'a pas pu etre (?:distribue|livre)|\bne (?:peut|pourra|pourrait|pouvait) (?:pas )?etre (?:distribue|livre)|livraison (?:impossible|echouee)|\bechec (?:de (?:la )?)?livraison|tentative de livraison|nicht zugestellt|nicht zugestellt werden|zustellung.*(?:fehlgeschlagen|nicht moglich)|zustellversuch|non consegnat[oa]|\bmancata consegna\b|non e stato possibile consegnare|consegna (?:fallita|non riuscita)|tentativo di consegna/.test(t) || /\bno (?:(?:ha|han|hemos|se|le|lo|la|fue|sido|ser|es|era|pudo|puede|podido|posible|todavia|aun) )*(?:entregad[oa]s?|entregar(?:lo|la|le|se)?|repartid[oa]s?|realizar la entrega|efectuar la entrega)\b|\bsin entregar\b|\b(?:entrega|reparto) (?:fallid[oa]|imposible|no (?:(?:ha|han|se|fue|sido|ser|pudo|puede|podido) )*(?:realizad[oa]|efectuad[oa]|completad[oa]|posible|conseguid[oa]))\b|\bimposible (?:entregar|realizar la entrega|efectuar la entrega)\b|\bfallo (?:en la|de) entrega\b|\bintento fallido\b|\bintento de (?:entrega|reparto)\b(?! (?:programad|previst|para (?:hoy|manana|el)|manana|hoy))|\bnao (?:(?:foi|foram|ser|sera|pode|podemos|conseguimos|conseguiu|se|possivel|e|ainda|tem sido|esta|estava) )*(?:entregues?|entregar|efetuar a entrega|efectuar a entrega|realizar a entrega)\b|\bentrega (?:falhada|sem sucesso|impossivel|nao (?:(?:foi|pode|ser|sera|tem sido) )*(?:efetuada|efectuada|realizada|conseguida|concretizada|possivel))\b|\bfalha (?:na|de) entrega\b|\btentativa (?:de entrega|sem sucesso)\b(?! (?:agendada|prevista|programada|para (?:hoje|amanha)|amanha|hoje))|\bcarteiro nao atendido\b/.test(t) || !/\bpick ?up (?:attempt|was attempted|unsuccessful|failed)|attempted (?:to )?pick ?up/.test(t) && /(?:attempted|tried) to deliver|\bcard(?:ed| left)\b|\bwe(?: have|'ve)? missed (?:you|each other)\b(?![^.;!?]*\bready for (?:pick ?up|collection)\b)|\battempted delivery\b(?! (?:is )?(?:scheduled|planned|expected|tomorrow|will)\b)|unsuccessful delivery|delivery (?:was )?unsuccessful|unable to complete (?:the |your |this )?delivery|(?<!\bif (?:the |your )?)\b(?:recipient|addressee|consignee|customer|receiver|user)(?: was| is)? (?:not (?:at home|home|available|present)|unavailable|absent)\b|absence of (?:the )?(?:recipient|addressee|consignee)|\bbusiness (?:was |is )?closed\b|\bpremises (?:(?:was|were) )?closed\b|destinataire absent|(?<!\ben cas d')\babsence du destinataire|(?:entreprise|societe) (?:etait |est )?fermee?\b|nicht angetroffen|(?:firma|betrieb|geschaft) (?:war |ist )?geschlossen|destinatario assente|(?:attivita|azienda|ditta) (?:era |e )?chiusa/.test(t) || !/\bintento de recogida\b|\brecogida (?:fallida|no realizada|no efectuada)\b|\btentativa de (?:recolha|coleta)\b|\b(?:recolha|coleta) (?:falhada|sem sucesso|nao (?:realizada|efetuada|efectuada))\b/.test(t) && !/\b(?:si|caso)\b[^.;:]*\b(?:ausen|nadie|ninguem|cerrad|fechad|no (?:esta|se encuentra)|nao (?:esta|se encontra))|\bse (?:o |a )?(?:destinatari[oa] |cliente )?(?:estiver|for|nao estiver)\b/.test(t) && /\bausen(?:te|tes|cia)\b|\b(?:destinatari[oa]|cliente|consignatari[oa]) (?:no (?:esta|estaba|se encuentra|se encontraba|disponible|presente)|nao (?:esta|estava|se encontra|se encontrava|disponivel|presente))\b|\bnadie en (?:casa|el domicilio)\b|\bninguem em casa\b|\b(?:establecimiento|negocio|empresa|comercio|tienda) (?:esta |estaba |se encontraba )?cerrad[oa]\b|\b(?:estabelecimento|empresa|loja|comercio|negocio) (?:esta |estava |se encontrava )?fechad[oa]\b/.test(t)) return "failed_attempt";
+	if (/not (?:yet )?delivered|\bun ?delivered\b|(?:could not|couldn't).*deliver|\bcan(?: ?not|'t) be delivered\b|unable to deliver|delivery (?:attempt|failed)|non livre|n'(?:a|avons) (?:pas )?pu.*(?:remis|remettre)|n'a pas pu etre (?:distribue|livre)|\bne (?:peut|pourra|pourrait|pouvait) (?:pas )?etre (?:distribue|livre)|livraison (?:impossible|echouee)|\bechec (?:de (?:la )?)?livraison|tentative de livraison|nicht zugestellt|nicht zugestellt werden|zustellung.*(?:fehlgeschlagen|nicht moglich)|zustellversuch|non consegnat[oa]|\bmancata consegna\b|non e stato possibile consegnare|consegna (?:fallita|non riuscita)|tentativo di consegna/.test(t) || /\bno (?:(?:ha|han|hemos|se|le|lo|la|fue|sido|ser|es|era|pudo|puede|podido|posible|todavia|aun) )*(?:entregad[oa]s?|entregar(?:lo|la|le|se)?|repartid[oa]s?|realizar la entrega|efectuar la entrega)\b|\bsin entregar\b|\b(?:entrega|reparto) (?:fallid[oa]|imposible|no (?:(?:ha|han|se|fue|sido|ser|pudo|puede|podido) )*(?:realizad[oa]|efectuad[oa]|completad[oa]|posible|conseguid[oa]))\b|\bimposible (?:entregar|realizar la entrega|efectuar la entrega)\b|\bfallo (?:en la|de) entrega\b|\bintento fallido\b|\bintento de (?:entrega|reparto)\b(?! (?:programad|previst|para (?:hoy|manana|el)|manana|hoy))|\bnao (?:(?:foi|foram|ser|sera|pode|podemos|conseguimos|conseguiu|se|possivel|e|ainda|tem sido|esta|estava) )*(?:entregues?|entregar|efetuar a entrega|efectuar a entrega|realizar a entrega)\b|\bentrega (?:falhada|sem sucesso|impossivel|nao (?:(?:foi|pode|ser|sera|tem sido) )*(?:efetuada|efectuada|realizada|conseguida|concretizada|possivel))\b|\bfalha (?:na|de) entrega\b|\btentativa (?:de entrega|sem sucesso)\b(?! (?:agendada|prevista|programada|para (?:hoje|amanha)|amanha|hoje))|\bcarteiro nao atendido\b/.test(t) || !/\bpick ?up (?:attempt|was attempted|unsuccessful|failed)|attempted (?:to )?pick ?up/.test(t) && /(?:attempted|tried) to deliver|\bcard(?:ed| left)\b|\bwe(?: have|'ve)? missed (?:you|each other)\b(?![^.;!?]*\bready for (?:pick ?up|collection)\b)|\battempted delivery\b(?! (?:is )?(?:scheduled|planned|expected|tomorrow|will)\b)|unsuccessful delivery|delivery (?:was )?(?:un|not )successful|unable to complete (?:the |your |this )?delivery|(?<!\bif (?:the |your )?)\b(?:recipient|addressee|consignee|customer|receiver|user)(?: was| is)? (?:not (?:at home|home|available|present)|unavailable|absent)\b|absence of (?:the )?(?:recipient|addressee|consignee)|\bbusiness (?:was |is )?closed\b|\bpremises (?:(?:was|were) )?closed\b|destinataire absent|(?<!\ben cas d')\babsence du destinataire|(?:entreprise|societe) (?:etait |est )?fermee?\b|nicht angetroffen|(?:firma|betrieb|geschaft) (?:war |ist )?geschlossen|destinatario assente|(?:attivita|azienda|ditta) (?:era |e )?chiusa/.test(t) || !/\bintento de recogida\b|\brecogida (?:fallida|no realizada|no efectuada)\b|\btentativa de (?:recolha|coleta)\b|\b(?:recolha|coleta) (?:falhada|sem sucesso|nao (?:realizada|efetuada|efectuada))\b/.test(t) && !/\b(?:si|caso)\b[^.;:]*\b(?:ausen|nadie|ninguem|cerrad|fechad|no (?:esta|se encuentra)|nao (?:esta|se encontra))|\bse (?:o |a )?(?:destinatari[oa] |cliente )?(?:estiver|for|nao estiver)\b/.test(t) && /\bausen(?:te|tes|cia)\b|\b(?:destinatari[oa]|cliente|consignatari[oa]) (?:no (?:esta|estaba|se encuentra|se encontraba|disponible|presente)|nao (?:esta|estava|se encontra|se encontrava|disponivel|presente))\b|\bnadie en (?:casa|el domicilio)\b|\bninguem em casa\b|\b(?:establecimiento|negocio|empresa|comercio|tienda) (?:esta |estaba |se encontraba )?cerrad[oa]\b|\b(?:estabelecimento|empresa|loja|comercio|negocio) (?:esta |estava |se encontrava )?fechad[oa]\b/.test(t)) return "failed_attempt";
 	if (jc.test(t)) return Mc.test(t) ? "ready_for_pickup" : "in_transit";
 	if (/\ba request was made to change (?:this|the|your) delivery date\b/.test(t) || /^(?:the )?delivery (?:details|information) (?:(?:has|have) been |were |was )?updated$/.test(t) || /^(?:package|parcel) shipment$/.test(t)) return "in_transit";
 	if (/\b(?:damaged|broken in transit)\b|endommag|avarie|deterior|beschadigt|danneggiat|danad[oa]|danificad|uszkodzon/.test(t) || /\blost (?:in transit|package|parcel|shipment)?\b|colis perdu|envoi perdu|egare|verloren|verlust der sendung|smarrit|(?:paquete|envio) perdid|extraviad|zagubion|zaginion/.test(t) || /refused by (?:the )?(?:recipient|consignee)|\brefused\b|rejected by (?:the )?recipient|refus(?:e|ee)? par le destinataire|refus du destinataire|(?:colis|envoi|pli) refuse|annahme verweigert|verweigert|rifiutat|rechazad|recusad|odmowa przyjecia|odmowiono przyjecia/.test(t) || /address (?:incomplete|incorrect|invalid|insufficient|unknown)|(?:incorrect|incomplete|insufficient|wrong|invalid) address|(?:updated|correct(?:ed)?|complete) (?:delivery )?address (?:is )?(?:required|needed)|address(?:ee)? (?:unknown|cannot be located)|recipient unknown|adresse (?:incorrecte|incomplete|erronee|invalide|inconnue)|destinataire inconnu|(?:adresse|anschrift) (?:unvollstandig|falsch|unbekannt)|empfanger unbekannt|indirizzo (?:errato|incompleto|insufficiente|sconosciuto)|destinatario sconosciuto|direccion (?:incorrecta|incompleta|erronea|desconocida)|destinatario desconocido|endereco (?:incorreto|incompleto|errado|desconhecido)|destinatario desconhecido|adres (?:niepelny|nieprawidlowy|bledny)|nieznany adresat/.test(t)) return "exception";

package/dist/carriers/evri/status.d.ts

@@ -1,2 +1,5 @@
 import type { ClassifiedStatus } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 export declare function evriStatus(wording: string): ClassifiedStatus | undefined;
+/** What the map says about one scan: Evri's labels carry no code. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/evri/status.js

@@ -10,6 +10,7 @@ const STATUSES = {
     'in transit': { status: 'in_transit', stage: 'in_transit' },
     'in customs': { status: 'in_transit', stage: 'customs' },
     'customs cleared': { status: 'in_transit', stage: 'in_transit' },
+    'departed origin country': { status: 'in_transit', stage: 'in_transit' },
     'arrived in country': { status: 'in_transit', stage: 'in_transit' },
     'handed to partner carrier': { status: 'in_transit', stage: 'in_transit' },
     'received by carrier': { status: 'in_transit', stage: 'in_transit' },
@@ -28,3 +29,5 @@ export function evriStatus(wording) {
     const key = wording.trim().toLowerCase();
     return Object.hasOwn(STATUSES, key) ? STATUSES[key] : undefined;
 }
+/** What the map says about one scan: Evri's labels carry no code. */
+export const statusMap = { stage: (_code, wording) => evriStatus(wording)?.stage, gaps: [] };

package/dist/carriers/evri/statuses.json

@@ -129,6 +129,14 @@
       "firstSeen": "2026-09-26",
       "note": "Synthetic semantic boundary; not observed in the live reference."
     },
+    {
+      "wording": "Departed Origin Country",
+      "language": "en",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-22",
+      "note": "After export customs and before the arrival in the destination country."
+    },
     {
       "wording": "Arrived In Country",
       "language": "en",

package/dist/carriers/seur/parser.js

@@ -2,7 +2,7 @@ import { IndeterminateError, InvalidInputError, SchemaError } from '../../core/e
 import { calendarDay, explicitOffsetTime } from '../../core/time/index.js';
 import { clean } from '../../core/transport/index.js';
 import { isRecord } from '../../core/types.js';
-import { classifySeurStatus } from './status.js';
+import { classifySeurStatus, isSeurDelay } from './status.js';
 export function normalizeSeurNumber(raw) {
     const number = raw.replace(/\s/g, '');
     // Twenty-two digits is a sender's reference, which the lookup also finds, as
@@ -84,14 +84,25 @@ export function parseSeur(value, raw) {
         return { description: mapped?.status === 'delivered' ? 'Delivered' : label, provider_status: label,
             provider_group: group, provider_code: code, ...(mapped ? { stage: mapped.stage } : {}), ...scanTime(row.fecha) };
     });
+    const delay = (event) => isSeurDelay(event.provider_code, String(event.provider_group), String(event.provider_status));
+    // Oldest first: a delay notice keeps the stage of the scan before it.
+    let previous;
+    for (const event of [...events].reverse()) {
+        if (!delay(event))
+            previous = event.stage ?? previous;
+        else if (previous)
+            Object.assign(event, { stage: previous, stage_source: 'none' });
+    }
     // The official widget consumes situaciones[0]; unresolved clocks retain that position.
+    // Its status is the newest scan's other than a delay notice.
     const latest = events[0];
-    const mapped = classifySeurStatus(latest.provider_code, String(latest.provider_group), String(latest.provider_status));
+    const current = events.find((event) => !delay(event));
+    const mapped = current && classifySeurStatus(current.provider_code, String(current.provider_group), String(current.provider_status));
     const weight = value.peso;
     return { status: mapped?.status ?? 'unknown', ...(mapped ? { current_stage: mapped.stage } : {}),
         last_status_text: latest.description, last_update: latest.time ?? null,
         ...(latest.local_time ? { last_update_local: latest.local_time } : {}),
-        ...(mapped?.status === 'delivered' && latest.time ? { delivered_at: latest.time } : {}),
+        ...(mapped?.status === 'delivered' && current?.time ? { delivered_at: current.time } : {}),
         ...(typeof weight === 'number' && Number.isFinite(weight) && weight > 0 && weight <= 100_000 ? { weight_kg: weight } : {}),
         events: events.slice(0, 100) };
 }

package/dist/carriers/seur/status.d.ts

@@ -1,4 +1,9 @@
 import type { ClassifiedStatus } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 export declare function classifySeurStatus(code: string, group: string, wording: string): ClassifiedStatus | undefined;
+/** Whether the scan is one of SEUR's delay notices, which keep the stage the parcel had. */
+export declare function isSeurDelay(code: string, group: string, wording: string): boolean;
 /** The status group SEUR sent with an observed code. */
 export declare function seurStatusGroup(code: string): string | undefined;
+/** What the map says about one scan, read with the group SEUR sends with its code. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/seur/status.js

@@ -1,18 +1,21 @@
 const delivered = { status: 'delivered', stage: 'delivered' };
 const inTransit = { status: 'in_transit', stage: 'in_transit' };
 const exception = { status: 'exception', stage: 'exception' };
+// A null reading is a delay notice, not a movement: the scan keeps the stage of the one before it.
 const observed = {
     LL003: { group: 'ENTREGADO', wording: 'EL ENVÍO ESTÁ ENTREGADO.', mapped: delivered },
     LL010: { group: 'ENTREGADO', wording: 'EL DESTINATARIO HA RETIRADO EL ENVÍO DE LA TIENDA SEUR PICKUP SELECCIONADA.', mapped: delivered },
     LL020: { group: 'ENTREGADO', wording: 'EL ENVÍO HA SIDO ENTREGADO A UN VECINO.', mapped: delivered },
     LC003: { group: 'EN REPARTO', wording: 'EL ENVÍO ESTÁ EN REPARTO.', mapped: { status: 'out_for_delivery', stage: 'out_for_delivery' } },
-    LI300: { group: 'EN DEMORA', wording: 'EL ENVÍO HA SUFRIDO UN RETRASO Y ES POSIBLE QUE SE DEMORE LA ENTREGA. DISCULPA LAS MOLESTIAS.', mapped: exception },
-    LI582: { group: 'EN DEMORA', wording: 'EL ENVÍO HA SUFRIDO UN RETRASO PROVOCANDO UNA POSIBLE DEMORA EN LA ENTREGA. DISCULPA LAS MOLESTIAS.', mapped: exception },
+    LI300: { group: 'EN DEMORA', wording: 'EL ENVÍO HA SUFRIDO UN RETRASO Y ES POSIBLE QUE SE DEMORE LA ENTREGA. DISCULPA LAS MOLESTIAS.', mapped: null },
+    LI582: { group: 'EN DEMORA', wording: 'EL ENVÍO HA SUFRIDO UN RETRASO PROVOCANDO UNA POSIBLE DEMORA EN LA ENTREGA. DISCULPA LAS MOLESTIAS.', mapped: null },
     // Recorded after the day's delivery round, which starts again the next day.
     LI521: { group: 'EN INCIDENCIA', wording: 'EL ENVÍO NO SE HA ENTREGADO PORQUE LA DIRECCIÓN DE ENTREGA ESTÁ INCOMPLETA O ERRÓNEA.', mapped: { status: 'exception', stage: 'failed_attempt' } },
     LI523: { group: 'EN INCIDENCIA', wording: 'EL ENVÍO NO SE HA ENTREGADO POR AUSENCIA O CIERRE. SE PUEDE REPROGRAMAR UNA NUEVA ENTREGA.', mapped: { status: 'exception', stage: 'failed_attempt' } },
     LI524: { group: 'EN INCIDENCIA', wording: 'EL ENVÍO NO SE HA ENTREGADO PORQUE NO ES LA DIRECCIÓN ACTUAL DEL DESTINATARIO.', mapped: exception },
     LI530: { group: 'ENTREGA EN TIENDA', wording: 'EL ENVÍO ESTÁ DISPONIBLE PARA RECOGER EN EL PUNTO SEUR PICKUP.', mapped: { status: 'in_transit', stage: 'ready_for_pickup' } },
+    // Pending arrival at the destination's facility: in the delay group, but it says where the parcel is.
+    LI511: { group: 'EN DEMORA', wording: 'EL ENVÍO ESTÁ PENDIENTE DE LLEGAR A DESTINO. EN CUANTO SE RECIBA, ACTUALIZAREMOS LA SITUACIÓN.', mapped: inTransit },
     LI567: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO ESTÁ EN TRÁNSITO. PRÓXIMAMENTE LLEGARÁ A LAS INSTALACIONES DE DESTINO.', mapped: inTransit },
     LO001: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO ESTÁ EN TRÁNSITO. PRÓXIMAMENTE LLEGARÁ A LAS INSTALACIONES DE DESTINO.', mapped: inTransit },
     SW189: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO ESTÁ EN TRÁNSITO. PRÓXIMAMENTE LLEGARÁ A LAS INSTALACIONES DE DESTINO.', mapped: inTransit },
@@ -25,13 +28,25 @@ const observed = {
     SX001: { group: 'EN TRÁNSITO', wording: 'EL ENVÍO HA SIDO RECEPCIONADO EN LAS INSTALACIONES DE ORIGEN DE SEUR. COMIENZA EL TRÁNSITO A DESTINO', mapped: { status: 'in_transit', stage: 'accepted' } },
     SX010: { group: 'NOTIFICADO', wording: 'EL ENVÍO HA SIDO REGISTRADO.', mapped: { status: 'pending', stage: 'registered' } },
 };
-export function classifySeurStatus(code, group, wording) {
+function entry(code, group, wording) {
     if (!Object.hasOwn(observed, code))
         return undefined;
-    const entry = observed[code];
-    return group.toUpperCase() === entry.group && wording.toUpperCase() === entry.wording ? entry.mapped : undefined;
+    const found = observed[code];
+    return group.toUpperCase() === found.group && wording.toUpperCase() === found.wording ? found : undefined;
+}
+export function classifySeurStatus(code, group, wording) {
+    return entry(code, group, wording)?.mapped ?? undefined;
+}
+/** Whether the scan is one of SEUR's delay notices, which keep the stage the parcel had. */
+export function isSeurDelay(code, group, wording) {
+    return entry(code, group, wording)?.mapped === null;
 }
 /** The status group SEUR sent with an observed code. */
 export function seurStatusGroup(code) {
     return Object.hasOwn(observed, code) ? observed[code].group : undefined;
 }
+/** What the map says about one scan, read with the group SEUR sends with its code. */
+export const statusMap = {
+    stage: (code, wording) => (code ? classifySeurStatus(code, seurStatusGroup(code) ?? '', wording)?.stage : undefined),
+    gaps: ['LI300', 'LI582'].map((code) => ({ code, note: 'A delay notice, not a movement: the parcel keeps the stage it had.' })),
+};

package/dist/carriers/seur/statuses.json

@@ -71,16 +71,26 @@
       "code": "LI300",
       "wording": "EL ENVÍO HA SUFRIDO UN RETRASO Y ES POSIBLE QUE SE DEMORE LA ENTREGA. DISCULPA LAS MOLESTIAS.",
       "language": "es",
-      "stage": "exception",
-      "confirmedBy": "live"
+      "confirmedBy": "live",
+      "unmapped": true,
+      "note": "A delay notice in the EN DEMORA group, not a movement: the row keeps the stage of the one before it."
     },
     {
       "code": "LI582",
       "wording": "EL ENVÍO HA SUFRIDO UN RETRASO PROVOCANDO UNA POSIBLE DEMORA EN LA ENTREGA. DISCULPA LAS MOLESTIAS.",
       "language": "es",
-      "stage": "exception",
       "confirmedBy": "live",
-      "note": "A delay notice in the EN DEMORA group, read like LI300."
+      "unmapped": true,
+      "note": "A delay notice in the EN DEMORA group, read like LI300. The parcel seen with it moved on to an agreed delivery day."
+    },
+    {
+      "code": "LI511",
+      "wording": "EL ENVÍO ESTÁ PENDIENTE DE LLEGAR A DESTINO. EN CUANTO SE RECIBA, ACTUALIZAREMOS LA SITUACIÓN.",
+      "language": "es",
+      "stage": "in_transit",
+      "confirmedBy": "live",
+      "firstSeen": "2026-10-22",
+      "note": "In the EN DEMORA group, but it says where the parcel is: between the origin's receipt and the transit to the destination's facility."
     },
     {
       "code": "LC003",

package/dist/carriers/usps/status.d.ts

@@ -13,6 +13,7 @@
  */
 import type { CarrierStatus } from '../../core/result/index.js';
 import type { Stage } from '../../core/status/index.js';
+import type { CarrierStatusMap } from '../../core/status/statusMap.js';
 /**
  * Classify USPS status prose. Returns null when nothing matches, so callers
  * leave an event unstaged rather than invent a stage. `hasEvents` reports an
@@ -23,3 +24,5 @@ export declare function uspsStage(text: string): Stage | null;
 export declare function statusForStage(stage: Stage): CarrierStatus;
 /** The result-level status for banner and history wording. */
 export declare function uspsStatus(text: string, hasEvents?: boolean): CarrierStatus;
+/** What the map says about one scan: USPS's scans carry no code, and their wording alone stages them. */
+export declare const statusMap: CarrierStatusMap;

package/dist/carriers/usps/status.js

@@ -74,3 +74,5 @@ export function uspsStatus(text, hasEvents = false) {
     // Unrecognized wording only means "moving" once the shipment has scans.
     return hasEvents ? 'in_transit' : 'unknown';
 }
+/** What the map says about one scan: USPS's scans carry no code, and their wording alone stages them. */
+export const statusMap = { stage: (_code, wording) => uspsStage(wording) ?? undefined, gaps: [] };

package/dist/carriers/zto-international/status.js

@@ -1,8 +1,9 @@
 import { classifyWording } from '../../core/status/index.js';
 /**
- * The stage of each scan code ZTO International's tracker sends. Codes below
- * 100 are ZTO's own network, at home and abroad; codes from 150 are ZTO
- * International's warehouses, line hauls and customs.
+ * The stage of each scan code ZTO International's tracker sends. Codes up to
+ * 16 are ZTO's own network, at home and abroad; codes from 150 are ZTO
+ * International's warehouses, line hauls and customs. On an export to Europe,
+ * codes 100, 375 and 415 copy the last-mile carrier's scans.
  */
 const CODES = new Map([
     ['1', 'accepted'],
@@ -15,6 +16,10 @@ const CODES = new Map([
     // Taken in by a parcel station or a neighbour for the recipient; the page
     // calls it delivered, but the collection follows as code 15.
     ['16', 'ready_for_pickup'],
+    // The order checked before the overseas warehouse receives the parcel.
+    ['30', 'registered'],
+    // Copied from the last-mile carrier abroad, as an arrival.
+    ['100', 'in_transit'],
     // The overseas warehouse received the parcel: the first scan of an import.
     ['150', 'accepted'],
     ['180', 'in_transit'],
@@ -33,6 +38,11 @@ const CODES = new Map([
     ['370', 'in_transit'],
     ['371', 'in_transit'],
     ['373', 'customs'],
+    // The destination's import clearance, finished.
+    ['375', 'in_transit'],
+    // A hand-over in the warehouse or to the last-mile carrier abroad.
+    ['415', 'in_transit'],
+    ['-581', 'exception'],
 ]);
 /** A scan's stage by its code, or by its wording when the code is new. */
 export function ztoInternationalStage(code, wording) {

package/dist/carriers/zto-international/statuses.json

@@ -13,6 +13,8 @@
     {"code": "5", "wording": "Dispatch Signed for", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "A delivery in ZTO's network in Cambodia, without the station the line names."},
     {"code": "15", "wording": "Delivered", "language": "en", "stage": "delivered", "confirmedBy": "live", "note": "Signed for with the pickup code a parcel station gave the recipient."},
     {"code": "16", "wording": "Received on the recipient's behalf", "language": "en", "stage": "ready_for_pickup", "confirmedBy": "live", "note": "The adapter's wording: the English line says Delivered, and the Chinese line names who took the parcel in, a parcel station in the histories seen. The collection follows as code 15."},
+    {"code": "30", "wording": "The order has been reviewed", "language": "en", "stage": "registered", "confirmedBy": "live", "firstSeen": "2026-10-22", "note": "The first row of an export to Europe, two days before the warehouse received the parcel."},
+    {"code": "100", "wording": "Arrival at inward office of exchange.", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-22", "note": "A row copied from the last-mile carrier abroad; the copy seen matched its out-for-delivery scan, read on ZTO's words alone."},
     {"code": "150", "wording": "Parcel entered the warehouse", "language": "en", "stage": "accepted", "confirmedBy": "live", "note": "The overseas warehouse, in the United States, Japan, Korea or Hong Kong, received the parcel."},
     {"code": "180", "wording": "Packed into shipping bag", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
     {"code": "190", "wording": "Parcel left the warehouse", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
@@ -28,6 +30,9 @@
     {"code": "360", "wording": "Import customs in progress.", "language": "en", "stage": "customs", "confirmedBy": "live"},
     {"code": "370", "wording": "clearance finish", "language": "en", "stage": "in_transit", "confirmedBy": "live"},
     {"code": "371", "wording": "clearance finish", "language": "en", "stage": "in_transit", "confirmedBy": "live", "note": "The Chinese line adds that the parcel enters domestic transport."},
-    {"code": "373", "wording": "Customs inspection", "language": "en", "stage": "customs", "confirmedBy": "live", "note": "Chinese customs picked the parcel for inspection."}
+    {"code": "373", "wording": "Customs inspection", "language": "en", "stage": "customs", "confirmedBy": "live", "note": "Chinese customs picked the parcel for inspection."},
+    {"code": "375", "wording": "clearance completed, customs", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-22", "note": "The destination's import clearance, finished, as the last-mile carrier abroad reports it."},
+    {"code": "415", "wording": "Express shipment / transshipment", "language": "en", "stage": "in_transit", "confirmedBy": "live", "firstSeen": "2026-10-22", "note": "After the warehouse's receipt and when the last-mile carrier abroad passes the parcel on."},
+    {"code": "-581", "wording": "Parcel with exceptions", "language": "en", "stage": "exception", "confirmedBy": "live", "firstSeen": "2026-10-22", "note": "A problem the row does not name, after the last mile's delivery round."}
   ]
 }

package/dist/core/catalog/statusMaps.js

@@ -169,6 +169,7 @@ import { statusMap as estesForwarding } from '../../carriers/estes-forwarding/st
 import { statusMap as eurodis } from '../../carriers/eurodis/status.js';
 import { statusMap as euroexpressBa } from '../../carriers/euroexpress-ba/status.js';
 import { statusMap as evdemoLojistik } from '../../carriers/evdemo-lojistik/status.js';
+import { statusMap as evri } from '../../carriers/evri/status.js';
 import { statusMap as evropat } from '../../carriers/evropat/status.js';
 import { statusMap as ewe } from '../../carriers/ewe/status.js';
 import { statusMap as exelot } from '../../carriers/exelot/status.js';
@@ -425,6 +426,7 @@ import { statusMap as sendex } from '../../carriers/sendex/status.js';
 import { statusMap as sending } from '../../carriers/sending/status.js';
 import { statusMap as serpost } from '../../carriers/serpost/status.js';
 import { statusMap as servientrega } from '../../carriers/servientrega/status.js';
+import { statusMap as seur } from '../../carriers/seur/status.js';
 import { statusMap as sfExpress } from '../../carriers/sf-express/status.js';
 import { statusMap as sfc } from '../../carriers/sfc/status.js';
 import { statusMap as shadowfax } from '../../carriers/shadowfax/status.js';
@@ -509,6 +511,7 @@ import { statusMap as upaya } from '../../carriers/upaya/status.js';
 import { statusMap as ups } from '../../carriers/ups/status.js';
 import { statusMap as urbano } from '../../carriers/urbano/status.js';
 import { statusMap as urvaam } from '../../carriers/urvaam/status.js';
+import { statusMap as usps } from '../../carriers/usps/status.js';
 import { statusMap as uzbekistanPost } from '../../carriers/uzbekistan-post/status.js';
 import { statusMap as valmo } from '../../carriers/valmo/status.js';
 import { statusMap as vaspExpresso } from '../../carriers/vasp-expresso/status.js';
@@ -567,7 +570,7 @@ export const STATUS_MAPS = {
     'early-bird': earlyBird, 'easy-mail': easyMail,
     econt, ecourier, 'egypt-post': egyptPost, elta, emile, 'ems-vietnam': emsVietnam, 'energia-tk': energiaTk, 'envia-colombia': enviaColombia,
     envialia, 'eparcel-kr': eparcelKr, 'epost-global': epostGlobal, equick, estes, 'estes-forwarding': estesForwarding, eurodis, 'euroexpress-ba': euroexpressBa,
-    'evdemo-lojistik': evdemoLojistik, evropat, ewe, exelot,
+    'evdemo-lojistik': evdemoLojistik, evri, evropat, ewe, exelot,
     'exline-kz': exlineKz, exmate, 'express-one': expressOne, 'fan-courier': fanCourier, 'fargo-courier': fargoCourier, 'fargo-uz': fargoUz, fastdrop,
     fastfrate, 'fedex-freight': fedexFreight, 'fedex-pl': fedexPl, fermopoint, 'fg-delivery': fgDelivery, 'first-line': firstLine,
     'flash-express': flashExpress,
@@ -608,7 +611,7 @@ export const STATUS_MAPS = {
     'quicksilver-sa': quicksilverSa, quiqup, qwintry, raben, 'ram-hand-to-hand': ramHandToHand, redpack, redur, redx, relaytech,
     rivigo, 'rl-carriers': rlCarriers, roadrunner, 'royal-express-mm': royalExpressMm, 'royal-mail': royalMail,
     'rpx-indonesia': rpxIndonesia, sagawa, 'sagawa-global': sagawaGlobal, saia, sailpost, sameday, 'sapx-express': sapxExpress,
-    'sat-ukraine': satUkraine, 'saudi-post': saudiPost, seino, seko, sendex, sending, serpost, servientrega, 'sf-express': sfExpress, sfc, shadowfax, shipa, shipblu, shipentegra, shiprocket,
+    'sat-ukraine': satUkraine, 'saudi-post': saudiPost, seino, seko, sendex, sending, serpost, servientrega, seur, 'sf-express': sfExpress, sfc, shadowfax, shipa, shipblu, shipentegra, shiprocket,
     'shree-anjani': shreeAnjani, 'shree-maruti': shreeMaruti, 'skroutz-last-mile': skroutzLastMile,
     skyking, 'skynet-sa': skynetSa, 'skynet-worldwide': skynetWorldwide, skypostal, slgtrax,
     'slovak-parcel-service': slovakParcelService,
@@ -620,7 +623,7 @@ export const STATUS_MAPS = {
     'thailand-post': thailandPost, thhy, tiki, tipsa, 'tirupati-courier': tirupatiCourier, 'tmm-express': tmmExpress, tnt, 'tnt-it': tntIt, 'today-kr': todayKr, toptrans, torrestir, 'total-express': totalExpress,
     trackon, 'tracx-logis': tracxLogis, transaher, transcorp, transmission, tsjy, 'tst-cf-express': tstCfExpress, tufesa, 'tws-express': twsExpress,
     'ubi-smart-parcel': ubiSmartParcel,
-    'united-delivery-service': unitedDeliveryService, upaya, ups, urbano, urvaam,
+    'united-delivery-service': unitedDeliveryService, upaya, ups, urbano, urvaam, usps,
     'uzbekistan-post': uzbekistanPost, valmo, 'vasp-expresso': vaspExpresso, veloces, venipak, 'via-cargo': viaCargo, 'viettel-post': viettelPost,
     vimenpaq, 'vinted-go': vintedGo, vozovoz, 'vrl-logistics': vrlLogistics, wanbexpress, whistl, winit, 'xde-logistics': xdeLogistics, xdp, xlcourier, 'xpo-ltl': xpoLtl,
     yanwen, 'ycs-logistics': ycsLogistics, 'yilong-logistics': yilongLogistics, yto, yunexpress, zto, 'zto-international': ztoInternational,

package/dist/core/status/language.js

@@ -230,7 +230,7 @@ export function trackingLanguageStage(description) {
     // absent recipient or a closed business. A scheduled attempt is not a missed
     // one, nor is a sender pickup.
     if (!/\bpick ?up (?:attempt|was attempted|unsuccessful|failed)|attempted (?:to )?pick ?up/.test(text)
-        && /(?:attempted|tried) to deliver|\bcard(?:ed| left)\b|\bwe(?: have|'ve)? missed (?:you|each other)\b(?![^.;!?]*\bready for (?:pick ?up|collection)\b)|\battempted delivery\b(?! (?:is )?(?:scheduled|planned|expected|tomorrow|will)\b)|unsuccessful delivery|delivery (?:was )?unsuccessful|unable to complete (?:the |your |this )?delivery|(?<!\bif (?:the |your )?)\b(?:recipient|addressee|consignee|customer|receiver|user)(?: was| is)? (?:not (?:at home|home|available|present)|unavailable|absent)\b|absence of (?:the )?(?:recipient|addressee|consignee)|\bbusiness (?:was |is )?closed\b|\bpremises (?:(?:was|were) )?closed\b|destinataire absent|(?<!\ben cas d')\babsence du destinataire|(?:entreprise|societe) (?:etait |est )?fermee?\b|nicht angetroffen|(?:firma|betrieb|geschaft) (?:war |ist )?geschlossen|destinatario assente|(?:attivita|azienda|ditta) (?:era |e )?chiusa/.test(text))
+        && /(?:attempted|tried) to deliver|\bcard(?:ed| left)\b|\bwe(?: have|'ve)? missed (?:you|each other)\b(?![^.;!?]*\bready for (?:pick ?up|collection)\b)|\battempted delivery\b(?! (?:is )?(?:scheduled|planned|expected|tomorrow|will)\b)|unsuccessful delivery|delivery (?:was )?(?:un|not )successful|unable to complete (?:the |your |this )?delivery|(?<!\bif (?:the |your )?)\b(?:recipient|addressee|consignee|customer|receiver|user)(?: was| is)? (?:not (?:at home|home|available|present)|unavailable|absent)\b|absence of (?:the )?(?:recipient|addressee|consignee)|\bbusiness (?:was |is )?closed\b|\bpremises (?:(?:was|were) )?closed\b|destinataire absent|(?<!\ben cas d')\babsence du destinataire|(?:entreprise|societe) (?:etait |est )?fermee?\b|nicht angetroffen|(?:firma|betrieb|geschaft) (?:war |ist )?geschlossen|destinatario assente|(?:attivita|azienda|ditta) (?:era |e )?chiusa/.test(text))
         return 'failed_attempt';
     // The same in Spanish and Portuguese ("Ausente"), where "recogida" and
     // "recolha" name the sender pickup and "si"/"caso" make absence a condition.

package/dist/server/openapi.json

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

package/package.json

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