tracking_number 2.5.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75fcefe87240b40ddf1bd16c155f13f93f46b9cbe96b343fb9b480875dd82ef6
-  data.tar.gz: f7ff78fe0acdc1a65ae6ddc63fe6e975ee4481c05e8d934b5fc8f09b1d2990ae
+  metadata.gz: 71f01e80c118f12c210f3c9a5195edf0c9d257c37ff4ce36529962f4131a57ed
+  data.tar.gz: 79519ddef14f7728eb6de46437360a9040368e261ce3dba4cdadf9a9b382891e
 SHA512:
-  metadata.gz: e4d70982f20080077fff3be398bc0f99baabd1d67c8a579e2253735a532dbfe0d1bc38edb91df9e28f873ce1683ba26177a447c26d0503fa1c5fc2047f156a0e
-  data.tar.gz: 1b22b16347f3ed186f7f539dc4bfc1a32ff07719faaf1cebc5a0983ced2139db4436303ab3405d4ad9b62081bdd0b632e769dc3822a1f7a5d47709e2832ca8f1
+  metadata.gz: 86ef4bdd51d50a76f26b0bc53f17db5518c48973ecc715b90058dc446c1a7ac2558db35a75f9a572837e4aacbf9e6fa33b2c5870dfc21076a50a8c538e156313
+  data.tar.gz: f78a9a8b106ce172f87f231c9d59aa6c52a1f76b8a6b471aaa5a17ac92ee605d71cab5d216b3032d3eba8fd0244a406f6358f6be465e1332c1edce32d07c9ad8

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 tracking_number changelog
 
+# [3.0.0](https://github.com/jkeen/tracking_number/compare/v2.5.0...v3.0.0) (2026-08-15)
+
+
+* feat!: Update to tracking_number_data 2.0, which rebuilds the IMpb USPS definitions from Publication 199 and absorbs the DHL and Fedex definitions that described the same tracking number. ([448e953](https://github.com/jkeen/tracking_number/commit/448e9534b0be8d2f205de5712e3215281922de99))
+
+
+### BREAKING CHANGES
+
+* `fedex_smartpost`, `dhl_ecommerce_30` and `usps_32V2` are absorbed into `usps_impb_c`, which is the definition they were always describing. `usps_91` and `usps_22` become `usps_impb_c` and `usps_impb_n`, and Application Identifier 91 splits off to `usps_legacy`. Every number these matched still decodes, now as USPS.
+
+No active definitions declare `partners` anymore, but it remains valid in our data spec for potential future use.
+
 # [2.5.0](https://github.com/jkeen/tracking_number/compare/v2.4.0...v2.5.0) (2026-08-13)
 
 

data/README.md

@@ -128,32 +128,6 @@ Most tracking numbers have a format where each part of the number has meaning. `
   # }   
 ```
 
-#### Multiple shippers / Partnerships
-Some tracking numbers match multiple carriers, because they belong to multiple carriers. Some shipments like Fedex Smartpost contract the "last mile" out to USPS. 
-
-```ruby
-  # Search defaults to only showing numbers that fulfill the carrier side of the relationship 
-  # (if a partnership exists at all), as this is the end a consumer would most likely be interested in.
-
-  results = TrackingNumber.search('420112139261290983497923666238') 
-  => [#<TrackingNumber::USPS91:0x26ac0 420112139261290983497923666238>]
-
-  all_results = TrackingNumber.search('420112139261290983497923666238', match: :all) 
-  => [#<TrackingNumber::FedExSmartPost:0x30624 420112139261290983497923666238>, #<TrackingNumber::USPS91:0x26ac0 420112139261290983497923666238>]
-
-  tn = results.first
-  tn.shipper? #=> false
-  tn.carrier? #=> true
-  tn.partnership? #=> true
-  tn.partners
-  #=> <struct TrackingNumber::Base::PartnerStruct
-  #       shipper=#<TrackingNumber::FedExSmartPost:0x30624 420112139261290983497923666238>,
-  #       carrier=#<TrackingNumber::USPS91:0x2f1fc 420112139261290983497923666238>>
-
-  tn.partners.shipper #=> #<TrackingNumber::FedExSmartPost:0x30624 420112139261290983497923666238>
-  tn.partners.carrier == tn #=> true
-```
-
 ## ActiveModel validation
 
 For Rails 3 (or any ActiveModel client), validate your fields as a tracking number:

data/lib/data/couriers/dhl.json

@@ -90,81 +90,8 @@
           "GR295117494011169045"
         ]
       }
-    },
-    {
-      "name": "DHL E-Commerce (30)",
-      "id": "dhl_ecommerce_30",
-      "regex": [
-        "\\s*(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})",
-        "(?!\\s*9\\s*[1-5]\\b)",
-        "(?<SerialNumber>",
-        "(?<ServiceType>(9[2-5]\\s*))",
-        "(?<ShipperId>([0-9]\\s*){9})",
-        "(?<PackageId>([0-9]\\s*){10})",
-        ")",
-        "(?<CheckDigit>[0-9]\\s*)"
-      ],
-      "validation": {
-        "checksum": {
-          "name": "mod10",
-          "modulo": 10,
-          "evens_multiplier": 3,
-          "odds_multiplier": 1,
-          "reverse": true
-        }
-      },
-      "tracking_url": "https://ecommerceportal.dhl.com/track?trackingnumber=%s",
-      "partners": [{
-        "description": "DHL eCommerce hands off to USPS for the last mile",
-        "partner_type": "carrier",
-        "partner_id": "usps_22",
-        "validation": {
-          "matches_all": [
-            { "regex_group_name": "RoutingApplicationId", "matches": "420" },
-            { "regex_group_name": "ServiceType", "matches_regex": "9[2345]" }
-          ]
-        }
-      },
-      {
-        "description": "DHL eCommerce hands off to USPS for the last mile",
-        "partner_type": "carrier",
-        "partner_id": "usps_91",
-        "validation": {
-          "matches_all": [
-            { "regex_group_name": "RoutingApplicationId", "matches": "420" },
-            { "regex_group_name": "ServiceType", "matches_regex": "9[2345]" }
-          ]
-        }
-      }],
-      "additional": [
-        {
-          "name": "Service Type",
-          "regex_group_name": "ServiceType",
-          "lookup": [
-            { "matches": "92", "name": "USPS Tracking (Commercial)" },
-            { "matches": "93", "name": "Collect on Delivery (COD)" },
-            { "matches": "94", "name": "USPS Tracking" },
-            { "matches": "95", "name": "Certified Mail" }
-          ]
-        }
-      ],
-      "test_numbers": {
-        "valid": [
-          "420902459261290336128704042634",
-          "420941179261290336128704062441",
-          "420926029261290336128704067248",
-          "420902729261290336128704124163",
-          "420950549261290336128704133837",
-          "420193809261290336128704280838",
-          "420900469261290336128704216936"
-        ],
-        "invalid": [
-          "420941179261290336128704062442",
-          "420941179261290336128704062400",
-          "420941179261290336128704062422"
-        ]
-      }
     }
 
+
   ]
 }

data/lib/data/couriers/fedex.json

@@ -92,71 +92,37 @@
       }
     },
     {
-      "name": "FedEx SmartPost",
-      "id": "fedex_smartpost",
-      "description": "Shipped by FedEx, Delivered by USPS",
-      "glossary": {
-        "ApplicationIdentifier": { "description": "Always 92 here, the code for a parcel handed to USPS for delivery." }
-      },
+      "name": "FedEx ASTRA (32)",
+      "id": "fedex_astra_32",
+      "description": "The legacy ASTRA barcode. Positions 17 through 28 hold a FedEx Express tracking number, and its check digit is the only one the barcode carries. What the other fields mean is not yet known.",
       "regex": [
-        "\\s*(?:",
-        "(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
-        "(?<ApplicationIdentifier>9\\s*2\\s*)",
-        ")?",
-        "(?<SerialNumber>",
-        "(?<SCNC>6\\s*1\\s*)",
-        "(?<ServiceType>2\\s*9\\s*)",
-        "(?<ShipperId>([0-9]\\s*){8})",
-        "(?<PackageId>([0-9]\\s*){11}|([0-9]\\s*){7})",
-        ")",
-        "(?<CheckDigit>([0-9]\\s*))"
-      ],
-      "additional": [
-        {
-          "name": "Service Type",
-          "regex_group_name": "ServiceType",
-          "lookup": [
-            {
-              "matches_regex": ".",
-              "name": "Delivered by USPS"
-            }
-          ]
-        }
+        "\\s*3\\s*",
+        "(?:[0-9]\\s*){5}",
+        "(?:[0-9]\\s*){3}",
+        "(?:[0-9]\\s*){7}",
+        "(?<SerialNumber>(?:[0-9]\\s*){11})",
+        "(?<CheckDigit>[0-9]\\s*)",
+        "(?:[0-9]\\s*){4}"
       ],
-      "partners": [{
-        "partner_id": "usps_91",
-        "partner_type": "carrier",
-        "description": "FedEx SmartPost is a shipping service that utilizes FedEx for the initial transport and the United States Postal Service for final delivery."
-      }],
       "validation": {
         "checksum": {
-          "name": "mod10",
-          "modulo": 10,
-          "evens_multiplier": 3,
-          "odds_multiplier": 1,
-          "reverse": false
-        },
-        "serial_number_format": {
-          "prepend_if": {
-            "matches_regex": "^(?!92).+",
-            "content": "92"
-          }
+          "name": "sum_product_with_weightings_and_modulo",
+          "weightings": [3, 1, 7, 3, 1, 7, 3, 1, 7, 3, 1],
+          "modulo1": 11,
+          "modulo2": 10
         }
       },
-      "tracking_url": "https://www.fedex.com/apps/fedextrack/?tracknumbers=%s",
       "test_numbers": {
         "valid": [
-          "9261292700768711948021",
-          "420 11213 92 6129098349792366623 8",
-          "92 6129098349792366623 8"
+          "32971514560102447849175802862014",
+          "32971510360102447848540980802018",
+          "32971508360102447847941133172013",
+          "33810799560000004380417923803212",
+          "3 29715 145 6010244 784917580286 2014"
         ],
         "invalid": [
-          "9261292700768711948020",
-          "92001903060085300042901077",
-          "420 11213 61290983497923666231",
-          "92 6129098349792366623 5",
-          "9400 1112 0108 0805 4830 16",
-          "9361 2898 7870 0317 6337 95"
+          "32971514560102447849175802852014",
+          "3297151456010244784917580286201"
         ]
       }
     },
@@ -238,8 +204,7 @@
       "name": "FedEx Ground 96 (22)",
       "id": "fedex_ground_96",
       "glossary": {
-        "ApplicationIdentifier": { "description": "Always 96, marking a ground shipping label." },
-        "SCNC": { "description": "FedEx Ground uses 11, 12 and 13." }
+        "ApplicationIdentifier": { "description": "Always 96, marking a ground shipping label." }
       },
       "regex": [
         "\\s*(?<ApplicationIdentifier>9\\s*6\\s*)",
@@ -271,9 +236,10 @@
     {
       "name": "FedEx Ground GSN",
       "id": "fedex_ground_gsn",
+      "description": "Ground's 34 digit barcode, carrying the Ground shipper number and the tracking number in the last twelve digits",
       "glossary": {
         "ApplicationIdentifier": { "description": "Always 96, marking a ground shipping label." },
-        "SCNC": { "description": "FedEx Ground uses 11, 12 and 13." }
+        "SCNC": { "description": "22, or 32 where the shipper number is nine digits." }
       },
       "regex": [
         "\\s*(?<ApplicationIdentifier>9\\s*6\\s*)",

data/lib/data/couriers/s10.json

@@ -4,6 +4,7 @@
   "tracking_numbers": [
     {
       "id": "s10",
+      "description": "The UPU format every postal service uses for international items",
       "name": "S10",
       "validation": {
         "checksum": {

data/lib/data/couriers/usps.json

@@ -5,7 +5,7 @@
     {
       "name": "USPS 20",
       "id": "usps_20",
-      "description": "20 digit USPS numbers",
+      "description": "Delivery and Signature Confirmation numbers, printed without the application identifier",
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "regex": [
         "\\s*(?<SerialNumber>",
@@ -39,37 +39,47 @@
           "name": "Service Type",
           "regex_group_name": "ServiceType",
           "lookup": [
-            {
-              "matches": "71",
-              "name": "Certified Mail"
-            },
-            {
-              "matches": "73",
-              "name": "Insured Mail"
-            },
-            {
-              "matches": "77",
-              "name": "Registered Mail"
-            },
-            {
-              "matches": "81",
-              "name": "Return Receipt For Merchanise"
-            }
+            { "matches": "01", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "02", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "0[34]", "name": "Delivery Confirmation", "description": "Retail" },
+            { "matches": "05", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured over $50" },
+            { "matches": "06", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured over $50" },
+            { "matches": "07", "name": "Delivery Confirmation", "description": "Priority Mail, insured $50 or under" },
+            { "matches": "08", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured $50 or under" },
+            { "matches": "14", "name": "Delivery Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "21", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "22", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "2[34]", "name": "Signature Confirmation", "description": "Retail" },
+            { "matches": "25", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured, all values" },
+            { "matches": "26", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured, all values" },
+            { "matches": "34", "name": "Signature Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "50", "name": "Electronic File Header", "description": "Used in the file header record only, never on a package" },
+            { "matches": "56", "name": "Passive Enroute Scan", "description": "A free scan as the parcel passes through a sorting plant, with no confirmation service attached" },
+            { "matches": "73", "name": "Insured Mail", "description": "Insured only, value over $50" },
+            { "matches": "82", "name": "Merchandise Return", "description": "With Delivery Confirmation" },
+            { "matches": "83", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value $50 or under" },
+            { "matches": "85", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value over $50" }
           ]
         }
       ]
     },
     {
-      "name": "USPS 22",
-      "id": "usps_22",
-      "description": "22 digit USPS numbers",
+      "name": "USPS IMpb N",
+      "id": "usps_impb_n",
+      "description": "IMpb constructs N01 through N10, issued online or by a vendor or meter",
+      "glossary": {
+        "ShipperId": { "description": "The company that holds the postal permit the package was mailed under, which Publication 199 calls the Mailer ID. Nine digits when it starts with 9, six otherwise." }
+      },
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "regex": [
-        "\\s*((?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
+        "\\s*((?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}(?=([0-9]\\s*){22}(?![0-9])|([0-9]\\s*){26}(?![0-9])))(?<DestinationZipPlus4>([0-9]\\s*){4}(?=([0-9]\\s*){22}(?![0-9])))?)?",
         "(?<SerialNumber>",
-        "(?<ServiceType>(9\\s*[4-8]\\s*))",
-        "(?<ShipperId>([0-9]\\s*){9})",
-        "(?<PackageId>([0-9]\\s*){10})",
+        "(?<ApplicationIdentifier>9\\s*4\\s*)",
+        "(?<ServiceType>([0-9]\\s*){3})",
+        "(?=9\\s*([0-9]\\s*){8}(([0-9]\\s*){15}|([0-9]\\s*){11}|([0-9]\\s*){7})[0-9]\\s*(?![0-9])",
+        "|[0-8]\\s*([0-9]\\s*){5}(([0-9]\\s*){14}|([0-9]\\s*){10})[0-9]\\s*(?![0-9]))",
+        "(?<ShipperId>9\\s*([0-9]\\s*){8}|[0-8]\\s*([0-9]\\s*){5})",
+        "(?<PackageId>([0-9]\\s*){15}|([0-9]\\s*){14}|([0-9]\\s*){11}|([0-9]\\s*){10}|([0-9]\\s*){7})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
@@ -86,6 +96,8 @@
         "valid": [
           "420787459400111206206406260787",
           "9400111206206406260787",
+          "9400 1112 0108 0805 4830 16",
+          "9405803699300124287899",
           "9434611206206406227577",
           "9434611206206407667136",
           "9400111206206407628746",
@@ -97,53 +109,30 @@
           "2334611306206407667222"
         ]
       },
-      "partners": [{
-        "description": "DHL ECommerce uses USPS for last mile delivery",
-        "partner_type": "shipper",
-        "partner_id": "dhl_ecommerce_30",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "RoutingApplicationId",
-              "matches": "420"
-            },
-            {
-              "matches_regex": "9[24]",
-              "regex_group_name": "ServiceType"
-            }
-          ]
-        }
-      }],
       "additional": [
         {
-          "name": "Service Type",
-          "regex_group_name": "ServiceType",
+          "name": "Application Identifier",
+          "regex_group_name": "ApplicationIdentifier",
           "lookup": [
-            { "matches": "92", "name": "Signature Confirmation" },
-            { "matches": "93", "name": "Collect on Delivery (COD)" },
-            { "matches": "94", "name": "USPS Tracking" },
-            { "matches": "95", "name": "Certified Mail" },
-            { "matches": "96", "name": "Insured Mail" },
-            { "matches": "97", "name": "Registered Mail" },
-            { "matches": "98", "name": "Return Receipt for Merchandise" }
+            { "matches": "94", "name": "Online or vendor label", "description": "Issued through USPS WebTools, or an authorized PC Postage provider" }
           ]
         }
       ]
     },
     {
-      "name": "USPS 34v2",
-      "id": "usps_32V2",
-      "description": "variation on 34 digit USPS IMpd numbers",
+      "name": "USPS Legacy",
+      "id": "usps_legacy",
+      "description": "Delivery and Signature Confirmation numbers, carrying the 91 application identifier",
       "glossary": {
-        "ApplicationIdentifier": { "description": "92 through 95, saying which USPS service and mailer ID scheme the rest belongs to." }
+        "ApplicationIdentifier": { "description": "Present only when the barcode is UCC/EAN Code 128." }
       },
       "regex": [
-        "\\s*(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})",
-        "(?<RoutingNumber>([0-9]\\s*){4})",
+        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})(?<DestinationZipPlus4>([0-9]\\s*){4})?)?",
         "(?<SerialNumber>",
-        "(?<ApplicationIdentifier>9\\s*[2345]\\s*)?",
-        "(?<ShipperId>([0-9]\\s*){8})",
-        "(?<PackageId>([0-9]\\s*){11})",
+        "(?<ApplicationIdentifier>9\\s*1\\s*)?",
+        "(?<ServiceType>([0-9]\\s*){2})",
+        "(?<ShipperId>([0-9]\\s*){9})",
+        "(?<PackageId>([0-9]\\s*){8})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
@@ -154,35 +143,71 @@
           "evens_multiplier": 3,
           "odds_multiplier": 1,
           "reverse": false
+        },
+        "serial_number_format": {
+          "prepend_if": {
+            "matches_regex": "^(?!9\\s*1).+",
+            "content": "91"
+          }
         }
       },
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "test_numbers": {
         "valid": [
-          "4201002334249200190132607600833457",
-          "4201028200009261290113185417468510",
-          " 4 2 0 1 0 2 8 2 0 0 0 0 9 2 6 1 2 9 0 1 1 3 1 8 5 4 1 7 4 6 8 5 1 0 "
+          "420 22153 9101026837331000039521",
+          "9101 1234 5678 9000 0000 13",
+          "7196 9010 7560 0307 7385"
         ],
         "invalid": [
-          "4201028200009261290113185417468511"
+          "9101 1234 5678 9000 0000 14",
+          "7196 9010 7560 0307 7386"
         ]
-      }
+      },
+      "additional": [
+        {
+          "name": "Service Type",
+          "regex_group_name": "ServiceType",
+          "lookup": [
+            { "matches": "01", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "02", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "0[34]", "name": "Delivery Confirmation", "description": "Retail" },
+            { "matches": "05", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured over $50" },
+            { "matches": "06", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured over $50" },
+            { "matches": "07", "name": "Delivery Confirmation", "description": "Priority Mail, insured $50 or under" },
+            { "matches": "08", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured $50 or under" },
+            { "matches": "14", "name": "Delivery Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "21", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "22", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "2[34]", "name": "Signature Confirmation", "description": "Retail" },
+            { "matches": "25", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured, all values" },
+            { "matches": "26", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured, all values" },
+            { "matches": "34", "name": "Signature Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "50", "name": "Electronic File Header", "description": "Used in the file header record only, never on a package" },
+            { "matches": "56", "name": "Passive Enroute Scan", "description": "A free scan as the parcel passes through a sorting plant, with no confirmation service attached" },
+            { "matches": "73", "name": "Insured Mail", "description": "Insured only, value over $50" },
+            { "matches": "82", "name": "Merchandise Return", "description": "With Delivery Confirmation" },
+            { "matches": "83", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value $50 or under" },
+            { "matches": "85", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value over $50" }
+          ]
+        }
+      ]
     },
     {
-      "name": "USPS 91",
-      "id": "usps_91",
-      "description": "USPS now calls this the IMpd barcode format",
+      "name": "USPS IMpb C",
+      "id": "usps_impb_c",
+      "description": "IMpb constructs C01 through C10, plus USPS retail",
       "glossary": {
-        "ApplicationIdentifier": { "description": "91 through 95, saying which USPS service and mailer ID scheme the rest belongs to." }
+        "ShipperId": { "description": "The company that holds the postal permit the package was mailed under, which Publication 199 calls the Mailer ID. Nine digits when it starts with 9, six otherwise." }
       },
       "regex": [
-        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
+        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})(?<DestinationZipPlus4>([0-9]\\s*){4}(?=([0-9]\\s*){22}(?![0-9])))?)?",
         "(?<SerialNumber>",
-        "(?<ApplicationIdentifier>9\\s*[12345]\\s*)?",
-        "(?<SCNC>([0-9]\\s*){2})",
-        "(?<ServiceType>([0-9]\\s*){2})",
-        "(?<ShipperId>([0-9]\\s*){8})",
-        "(?<PackageId>([0-9]\\s*){11}|([0-9]\\s*){7})",
+        "(?<ApplicationIdentifier>9\\s*2\\s*(?=([0-9]\\s*){3}9)|9\\s*3\\s*(?=([0-9]\\s*){3}[0-8])|9\\s*5\\s*)",
+        "(?<ServiceType>([0-9]\\s*){3})",
+        "(?=9\\s*([0-9]\\s*){8}(([0-9]\\s*){11}|([0-9]\\s*){7})[0-9]\\s*(?![0-9])",
+        "|[0-8]\\s*([0-9]\\s*){5}(([0-9]\\s*){14}|([0-9]\\s*){10})[0-9]\\s*(?![0-9]))",
+        "(?<ShipperId>9\\s*([0-9]\\s*){8}|[0-8]\\s*([0-9]\\s*){5})",
+        "(?<PackageId>([0-9]\\s*){14}|([0-9]\\s*){11}|([0-9]\\s*){10}|([0-9]\\s*){7})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
@@ -193,74 +218,35 @@
           "evens_multiplier": 3,
           "odds_multiplier": 1,
           "reverse": false
-        },
-        "serial_number_format": {
-          "prepend_if": {
-            "matches_regex": "^(?!9[1-5]).+",
-            "content": "91"
-          }
-        }
-      },
-      "partners": [{
-        "description": "FedEx SmartPost uses USPS for last mile delivery, but not all USPS91 numbers are SmartPosts",
-        "partner_type": "shipper",
-        "partner_id": "fedex_smartpost",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "ServiceType",
-              "matches": "29"
-            },
-            {
-              "matches": "61",
-              "regex_group_name": "SCNC"
-            },
-            {
-              "regex_group_name": "ApplicationIdentifier",
-              "matches": "92" 
-            }
-          ]
         }
       },
-      {
-        "description": "DHL uses USPS for last mile delivery, but not all USPS91 numbers are DHL Ecommerce",
-        "partner_type": "shipper",
-        "partner_id": "dhl_ecommerce_30",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "ServiceType",
-              "matches": "29"
-            },
-            {
-              "matches": "61",
-              "regex_group_name": "SCNC"
-            },
-            {
-              "matches": "420",
-              "regex_group_name": "RoutingApplicationId"
-            }
-          ]
-        }
-      }],
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "test_numbers": {
         "valid": [
-          "420 22153 9101026837331000039521",
-          "7196 9010 7560 0307 7385",
+          "4201002334249200190132607600833457",
+          "4201028200009261290113185417468510",
+          " 4 2 0 1 0 2 8 2 0 0 0 0 9 2 6 1 2 9 0 1 1 3 1 8 5 4 1 7 4 6 8 5 1 0 ",
           "9505 5110 6960 5048 6006 24",
-          "9101 1234 5678 9000 0000 13",
           "92748931507708513018050063",
           "92001903060085300042901077",
-          "9400 1112 0108 0805 4830 16",
           "9361 2898 7870 0317 6337 95",
-          "9405803699300124287899"
+          "9261292700768711948021",
+          "420 11213 92 6129098349792366623 8",
+          "92 6129098349792366623 8",
+          "420902459261290336128704042634",
+          "420941179261290336128704062441",
+          "420926029261290336128704067248",
+          "420902729261290336128704124163",
+          "420950549261290336128704133837",
+          "420193809261290336128704280838",
+          "420900469261290336128704216936"
         ],
         "invalid": [
           "61299998820821171811",
           "9200000000000000000000",
           "420000000000000000000000000000",
-          "420000009200000000000000000000"
+          "420000009200000000000000000000",
+          "4201028200009261290113185417468511"
         ]
       },
       "additional": [
@@ -268,14 +254,16 @@
           "name": "Service Type",
           "regex_group_name": "ServiceType",
           "lookup": [
-            {
-              "matches": "11",
-              "name": "First Class (R)"
-            },
-            {
-              "matches": "29",
-              "name": "Fedex Smart Post"
-            }
+            { "matches": "612", "name": "Parcel Select" }
+          ]
+        },
+        {
+          "name": "Application Identifier",
+          "regex_group_name": "ApplicationIdentifier",
+          "lookup": [
+            { "matches": "92", "name": "Commercial mailer", "description": "Nine digit mailer ID, and may have been carried by another company before USPS" },
+            { "matches": "93", "name": "Commercial mailer", "description": "Six digit mailer ID, and may have been carried by another company before USPS" },
+            { "matches": "95", "name": "USPS Retail", "description": "Issued at a post office counter, an automated postal center, or a self-service kiosk" }
           ]
         }
       ]

data/lib/data/couriers/yodel.json

@@ -0,0 +1,29 @@
+{
+  "name": "Yodel",
+  "courier_code": "yodel",
+  "tracking_numbers": [
+    {
+      "name": "Yodel",
+      "id": "yodel",
+      "description": "Yodel's UK domestic numbers, carried on a JD or JJD prefix. Numbers entering the Yodel network from other carriers can take other formats.",
+      "regex": [
+        "\\s*J\\s*(J\\s*)?D\\s*(?<SerialNumber>([0-9]\\s*){16})\\s*"
+      ],
+      "validation": {},
+      "tracking_url": "https://www.yodel.co.uk/tracking/%s",
+      "test_numbers": {
+        "valid": [
+          "JJD0002257639032011",
+          "JJD0002255380054291",
+          "JD0002242617644732",
+          "JD0002254405060992",
+          "J J D 0 0 0 2 2 5 7 6 3 9 0 3 2 0 2 0"
+        ],
+        "invalid": [
+          "JD000225440506099",
+          "JC0002254405060992"
+        ]
+      }
+    }
+  ]
+}

data/lib/tracking_number/version.rb

@@ -1,3 +1,3 @@
 module TrackingNumber
-  VERSION = "2.5.0"
+  VERSION = "3.0.0"
 end

data/lib/tracking_number.rb

@@ -60,4 +60,29 @@ module TrackingNumber
   def self.new(tracking_number)
     detect(tracking_number)
   end
+
+  # Renamed in tracking_number_data 2.0. The old constant still describes the same barcode.
+  RENAMED_TYPES = { USPS91: :USPSIMpbC, USPS22: :USPSIMpbN, USPS34v2: :USPSIMpbC }.freeze
+
+  # Removed in tracking_number_data 2.0. An alias would answer is_a? for every IMpb number,
+  # which is the claim the data stopped making, so these raise instead.
+  WITHDRAWN_TYPES = {
+    FedExSmartPost: 'USPSIMpbC',
+    DHLECommerce30: 'USPSIMpbC'
+  }.freeze
+
+  def self.const_missing(name)
+    if (renamed = RENAMED_TYPES[name])
+      warn "TrackingNumber::#{name} is now TrackingNumber::#{renamed}"
+      return const_get(renamed)
+    end
+
+    if (replacement = WITHDRAWN_TYPES[name])
+      raise NameError, "TrackingNumber::#{name} no longer exists. These are USPS IMpb barcodes " \
+                       "carrying nothing that identifies the shipper, so they now decode as " \
+                       "TrackingNumber::#{replacement}."
+    end
+
+    super
+  end
 end

data/test/partnership_test.rb

@@ -0,0 +1,71 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+# No shipped definition declares partners currently at the tracking number data 2.0 release, 
+# but the concept is still supported in the data spec, and should be tested, so we're faking it here
+
+class PartnershipTest < Minitest::Test
+  NUMBER = 'ZZ1234567890'.freeze
+
+  def setup
+    @shipper = build_class('test_shipper', partner_id: 'test_carrier', partner_type: 'carrier')
+    @carrier = build_class('test_carrier', partner_id: 'test_shipper', partner_type: 'shipper')
+
+    TrackingNumber::TYPES.push(@shipper, @carrier)
+  end
+
+  def teardown
+    TrackingNumber::TYPES.delete(@shipper)
+    TrackingNumber::TYPES.delete(@carrier)
+  end
+
+  should "report a partnership from both sides" do
+    assert @shipper.new(NUMBER).partnership?
+    assert @carrier.new(NUMBER).partnership?
+  end
+
+  should "pair each side with the other" do
+    partners = @carrier.new(NUMBER).partners
+
+    assert_instance_of @shipper, partners.shipper
+    assert_instance_of @carrier, partners.carrier
+  end
+
+  should "report which side of the partnership each is" do
+    assert @shipper.new(NUMBER).shipper?
+    assert !@shipper.new(NUMBER).carrier?
+
+    assert @carrier.new(NUMBER).carrier?
+    assert !@carrier.new(NUMBER).shipper?
+  end
+
+  should "only match the carrier side when searching by default" do
+    matches = TrackingNumber.search("shipped as #{NUMBER} today")
+
+    assert_equal [@carrier], matches.collect(&:class)
+  end
+
+  should "match both sides when searching for all" do
+    matches = TrackingNumber.search("shipped as #{NUMBER} today", match: :all)
+
+    assert_equal [@shipper, @carrier], matches.collect(&:class)
+  end
+
+  private
+
+  def build_class(id, partner_id:, partner_type:)
+    pattern = 'Z\s*Z\s*(?<SerialNumber>([0-9]\s*){10})'
+
+    klass = Class.new(TrackingNumber::Base)
+    klass.const_set('ID', id)
+    klass.const_set('COURIER_CODE', id.to_sym)
+    klass.const_set('COURIER_INFO', name: id, courier_code: id.to_sym)
+    klass.const_set('SEARCH_PATTERN', Regexp.new("\\b#{pattern}\\b"))
+    klass.const_set('VERIFY_PATTERN', Regexp.new("^#{pattern}$"))
+    klass.const_set('VALIDATION', {})
+    klass.const_set('ADDITIONAL', nil)
+    klass.const_set('TRACKING_URL', nil)
+    klass.const_set('PARTNERS', [{ partner_id: partner_id, partner_type: partner_type }])
+
+    klass
+  end
+end

data/test/renamed_types_test.rb

@@ -0,0 +1,44 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+class RenamedTypesTest < Minitest::Test
+  NUMBER = '420112139261290983497923666238'.freeze
+
+  should "resolve a renamed constant to the definition that replaced it" do
+    assert_equal TrackingNumber::USPSIMpbC, silenced { TrackingNumber::USPS91 }
+    assert_equal TrackingNumber::USPSIMpbN, silenced { TrackingNumber::USPS22 }
+    assert_equal TrackingNumber::USPSIMpbC, silenced { TrackingNumber::USPS34v2 }
+  end
+
+  should "keep is_a? answering for a renamed constant" do
+    assert TrackingNumber.new(NUMBER).is_a?(silenced { TrackingNumber::USPS91 })
+  end
+
+  should "warn once a renamed constant is reached for" do
+    _, err = capture_io { TrackingNumber::USPS91 }
+
+    assert_match(/USPS91 is now TrackingNumber::USPSIMpbC/, err)
+  end
+
+  # An alias would answer is_a? for every IMpb number, including labels these carriers never touched
+  should "refuse a withdrawn constant and name its replacement" do
+    error = assert_raises(NameError) { TrackingNumber::FedExSmartPost }
+    assert_match(/no longer exists/, error.message)
+    assert_match(/USPSIMpbC/, error.message)
+
+    assert_raises(NameError) { TrackingNumber::DHLECommerce30 }
+  end
+
+  should "leave an unrelated missing constant alone" do
+    error = assert_raises(NameError) { TrackingNumber::NotADefinition }
+
+    assert_match(/uninitialized constant/, error.message)
+  end
+
+  private
+
+  def silenced
+    resolved = nil
+    capture_io { resolved = yield }
+    resolved
+  end
+end

data/test/test_helper.rb

@@ -50,10 +50,11 @@ class Minitest::Test
     assert !t.valid?
   end
 
-  def should_fail_on_check_digit_changes(valid_number)
+  def should_fail_on_check_digit_changes(valid_number, klass)
     digits = valid_number.gsub(/\s/, "").chars.compact.to_a
-    last = digits.pop.to_i
-    digits << (last <= 2 ? last + 3 : last - 3).to_s
+    position = digits.join.match(klass::VERIFY_PATTERN).begin("CheckDigit")
+    current = digits[position].to_i
+    digits[position] = (current <= 2 ? current + 3 : current - 3).to_s
     invalid_number = digits.join
     t = TrackingNumber.new(invalid_number)
     assert !t.valid?, "#{invalid_number} reported as a valid #{t.class}, and it shouldn't be"

data/test/tracking_number_meta_test.rb

@@ -30,7 +30,7 @@ class TrackingNumberMetaTest < Minitest::Test
           if tracking_info[:validation][:checksum]
             # only run this test if number format has checksum
             should "fail on check digit changes with #{valid_number}" do
-              should_fail_on_check_digit_changes(valid_number)
+              should_fail_on_check_digit_changes(valid_number, klass)
             end
           end
 

data/test/tracking_number_test.rb

@@ -109,7 +109,7 @@ class TrackingNumberTest < Minitest::Test
     end
 
     should "report correct service" do
-      assert_nil tracking_number.service_type
+      assert_equal "Delivery Confirmation", tracking_number.service_type
     end
 
     should "report correct shipper_id" do
@@ -142,7 +142,7 @@ class TrackingNumberTest < Minitest::Test
     end
 
     should "report correct shipper_id" do
-      assert_equal "00190132", tracking_number.shipper_id
+      assert_equal "901326076", tracking_number.shipper_id
     end
 
     should "report correct no destination" do
@@ -158,7 +158,7 @@ class TrackingNumberTest < Minitest::Test
     end
 
     should "report no partners" do
-      assert_equal nil, tracking_number.partners
+      assert_nil tracking_number.partners
     end
 
     should "report as shipper and carrier" do
@@ -172,7 +172,7 @@ class TrackingNumberTest < Minitest::Test
     end
   end
 
-  context "tracking number partnership data for FedExSmartPost/USPS91" do
+  context "tracking number additional data for USPS Parcel Select" do
     tracking_number = TrackingNumber.new("420 11213 92 6129098349792366623 8")
 
     should "report correct courier name" do
@@ -184,31 +184,28 @@ class TrackingNumberTest < Minitest::Test
     end
 
     should "report correct service type" do
-      assert_equal "Fedex Smart Post", tracking_number.service_type
-    end
-
-    should "report partnership" do
-      assert_equal true, tracking_number.partnership?
+      assert_equal "Parcel Select", tracking_number.service_type
     end
 
-    should "report not shipper side of the partnership" do
-      assert_equal false, tracking_number.shipper?
+    should "report no partnership" do
+      assert_equal false, tracking_number.partnership?
     end
 
-    should "report carrier side of the partnership" do
+    should "report as shipper and carrier" do
+      assert_equal true, tracking_number.shipper?
       assert_equal true, tracking_number.carrier?
     end
 
-    should "report partner pairing" do
-      assert_equal :fedex, tracking_number.partners.shipper.courier_code
+    should "report no partners" do
+      assert_nil tracking_number.partners
     end
   end
 
-  context "searching numbers that have partners" do
-    partnership_number = "420 11213 92 6129098349792366623 8"
+  context "searching for numbers" do
+    parcel_select_number = "420 11213 92 6129098349792366623 8"
     single_number = "92001903060085300042901077"
 
-    search_string = ["number that matches two services", partnership_number, " number that matches only one: ", single_number, "let's see if that does it"].join(' ')
+    search_string = ["number that matches two services", parcel_select_number, " number that matches only one: ", single_number, "let's see if that does it"].join(' ')
 
     should "match only carriers by default" do
       matches = TrackingNumber.search(search_string)
@@ -218,7 +215,7 @@ class TrackingNumberTest < Minitest::Test
 
     should "match all if specified" do
       matches = TrackingNumber.search(search_string, match: :all)
-      assert_equal 3, matches.size
+      assert_equal 2, matches.size
     end
 
     should "match only shippers if specified" do

data/tracking_number.gemspec

@@ -53,6 +53,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency('activesupport', '>= 4.2.5')
   s.add_runtime_dependency('json', '>= 1.8.3')
   s.add_development_dependency('activemodel', '> 4.2.5.1')
+  s.add_development_dependency('irb')
   s.add_development_dependency('minitest', '~> 5.5')
   s.add_development_dependency('minitest-reporters', '~> 1.1')
   s.add_development_dependency('rake', '~> 13.0')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracking_number
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Jeff Keen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 2026-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -52,6 +52,20 @@ dependencies:
     - - ">"
       - !ruby/object:Gem::Version
         version: 4.2.5.1
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -175,6 +189,7 @@ files:
 - lib/data/couriers/speedee.json
 - lib/data/couriers/ups.json
 - lib/data/couriers/usps.json
+- lib/data/couriers/yodel.json
 - lib/data/couriers/yunexpress.json
 - lib/tracking_number.rb
 - lib/tracking_number/active_model_validator.rb
@@ -187,6 +202,8 @@ files:
 - lib/tracking_number/version.rb
 - package.json
 - test/active_model_validator_test.rb
+- test/partnership_test.rb
+- test/renamed_types_test.rb
 - test/test_helper.rb
 - test/tracking_number_meta_test.rb
 - test/tracking_number_test.rb