@gruncellka/porto-data 0.3.0 → 0.4.1

package/porto_data/providers/swisspost/products.json

@@ -0,0 +1,193 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/products.schema.json",
+  "file_type": "products",
+  "provider": "swisspost",
+  "unit": {
+    "weight": "g"
+  },
+  "products": [
+    {
+      "id": "a_post_standardbrief",
+      "porto_id": "small",
+      "name": "A-Post Standardbrief",
+      "envelope_ids": [
+        "DL",
+        "C6"
+      ],
+      "zones": [
+        "domestic"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "optional",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "next",
+          "days_max": 1
+        }
+      ]
+    },
+    {
+      "id": "a_post_grossbrief",
+      "porto_id": "large",
+      "name": "A-Post Grossbrief",
+      "envelope_ids": [
+        "C4",
+        "B4"
+      ],
+      "zones": [
+        "domestic"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "optional",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "next",
+          "days_max": 1
+        }
+      ]
+    },
+    {
+      "id": "b_post_standardbrief",
+      "porto_id": "small",
+      "name": "B-Post Standardbrief",
+      "envelope_ids": [
+        "DL",
+        "C6"
+      ],
+      "zones": [
+        "domestic"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "optional",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "within",
+          "days_max": 3,
+          "weekdays": "mon_fri"
+        }
+      ]
+    },
+    {
+      "id": "b_post_grossbrief",
+      "porto_id": "large",
+      "name": "B-Post Grossbrief",
+      "envelope_ids": [
+        "C4",
+        "B4"
+      ],
+      "zones": [
+        "domestic"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "optional",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "within",
+          "days_max": 3,
+          "weekdays": "mon_fri"
+        }
+      ]
+    },
+    {
+      "id": "international_standardbrief",
+      "porto_id": "small",
+      "name": "International Standardbrief (documents)",
+      "envelope_ids": [
+        "DL",
+        "C6",
+        "C5"
+      ],
+      "zones": [
+        "zone_1_eu",
+        "world"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "none",
+      "delivery": [
+        {
+          "zones": [
+            "zone_1_eu",
+            "world"
+          ],
+          "span": "within",
+          "days_max": 8
+        }
+      ]
+    },
+    {
+      "id": "international_grossbrief",
+      "porto_id": "large",
+      "name": "International Grossbrief (documents)",
+      "envelope_ids": [
+        "C4",
+        "B4"
+      ],
+      "zones": [
+        "zone_1_eu",
+        "world"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "none",
+      "delivery": [
+        {
+          "zones": [
+            "zone_1_eu",
+            "world"
+          ],
+          "span": "within",
+          "days_max": 8
+        }
+      ]
+    },
+    {
+      "id": "international_maxibrief",
+      "porto_id": "extra_large",
+      "name": "International Maxibrief (documents)",
+      "envelope_ids": [
+        "B4"
+      ],
+      "zones": [
+        "zone_1_eu",
+        "world"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "stamp",
+      "tracking_mode": "none",
+      "delivery": [
+        {
+          "zones": [
+            "zone_1_eu",
+            "world"
+          ],
+          "span": "within",
+          "days_max": 8
+        }
+      ]
+    }
+  ]
+}

package/porto_data/providers/swisspost/rules.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/rules.schema.json",
+  "file_type": "provider_rules",
+  "provider": "swisspost",
+  "unit": {
+    "thickness": "mm"
+  },
+  "rules": [
+    {
+      "id": "domestic_letter_thickness",
+      "kind": "band_attach",
+      "metric": "thickness",
+      "description": "Swiss Post A/B Mail domestic letters: thickness > 2 cm and <= 5 cm incurs surcharge per post.ch footnotes (verify live tariff). Amount in prices/services.json. Zone scope follows graph.edges for each product_id.",
+      "product_ids": [
+        "a_post_standardbrief",
+        "a_post_grossbrief",
+        "b_post_standardbrief",
+        "b_post_grossbrief"
+      ],
+      "min_exclusive": 20,
+      "max_inclusive": 50,
+      "service_id": "brief_dicke_zuschlag"
+    }
+  ]
+}

package/porto_data/providers/swisspost/services.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/services.schema.json",
+  "file_type": "services",
+  "provider": "swisspost",
+  "services": [
+    {
+      "id": "a_mail_plus",
+      "porto_id": "tracking",
+      "name": "A-Mail Plus",
+      "label": "Tracked letter with next-day domestic delivery (A-Mail Plus)",
+      "description": "Premium domestic letter with electronic tracking; orderable online where Swiss Post offers it (e.g. WebStamp). International letters in this catalog use untracked products unless the operator adds a supported service.",
+      "features": [
+        "sendungsnummer"
+      ],
+      "enables_tracking": true,
+      "online_supported": true,
+      "integrations": {
+        "webstamp": true
+      },
+      "supported_zones": [
+        "domestic"
+      ]
+    },
+    {
+      "id": "brief_dicke_zuschlag",
+      "porto_id": "thickness",
+      "name": "Zuschlag Dicke",
+      "label": "Letter thickness surcharge (>2 cm up to 5 cm)",
+      "description": "Rule-attached surcharge when thickness > 20 mm and <= 50 mm for domestic A/B letters; not user-selectable. Amount in prices/services.json.",
+      "features": [
+        "brief_dicke_band"
+      ],
+      "enables_tracking": false,
+      "online_supported": false,
+      "supported_zones": [
+        "domestic"
+      ]
+    }
+  ]
+}

package/porto_data/providers/swisspost/weights.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/weights.schema.json",
+  "file_type": "weights",
+  "provider": "swisspost",
+  "unit": {
+    "weight": "g"
+  },
+  "weights": {
+    "W0020": {
+      "min": 0,
+      "max": 20
+    },
+    "W0050": {
+      "min": 21,
+      "max": 50
+    },
+    "W0100": {
+      "min": 51,
+      "max": 100
+    },
+    "W0250": {
+      "min": 101,
+      "max": 250
+    },
+    "W0500": {
+      "min": 251,
+      "max": 500
+    },
+    "W1000": {
+      "min": 501,
+      "max": 1000
+    },
+    "W2000": {
+      "min": 1001,
+      "max": 2000
+    }
+  }
+}

package/porto_data/providers/swisspost/zones.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/zones.schema.json",
+  "file_type": "zones",
+  "provider": "swisspost",
+  "unit": {
+    "country_code": "ISO 3166-1 alpha-2"
+  },
+  "zones": [
+    {
+      "id": "domestic",
+      "name": "Schweiz",
+      "description": "Switzerland (domestic)",
+      "country_codes": [
+        "CH"
+      ]
+    },
+    {
+      "id": "zone_1_eu",
+      "name": "Zone 1 - Europe (letter tariff)",
+      "description": "Swiss Post international letter tariff group for Europe (EU, EEA, UK, and other listed European states). Switzerland (CH) is not in the EU and is not part of this zone when posting from Switzerland — domestic applies for CH destinations.",
+      "country_codes": [
+        "AD",
+        "AL",
+        "AT",
+        "BA",
+        "BE",
+        "BG",
+        "BY",
+        "CY",
+        "CZ",
+        "DE",
+        "DK",
+        "EE",
+        "ES",
+        "FI",
+        "FO",
+        "FR",
+        "GB",
+        "GI",
+        "GR",
+        "HR",
+        "HU",
+        "IE",
+        "IS",
+        "IT",
+        "LI",
+        "LT",
+        "LU",
+        "LV",
+        "MC",
+        "MD",
+        "ME",
+        "MK",
+        "MT",
+        "NL",
+        "NO",
+        "PL",
+        "PT",
+        "RO",
+        "RS",
+        "RU",
+        "SE",
+        "SI",
+        "SK",
+        "SM",
+        "TR",
+        "UA",
+        "VA",
+        "XK"
+      ]
+    },
+    {
+      "id": "world",
+      "name": "Welt",
+      "description": "All countries outside Europe (international mail)",
+      "country_codes": [
+        "AF",
+        "DZ",
+        "AO",
+        "AR",
+        "AM",
+        "AU",
+        "AZ",
+        "BH",
+        "BD",
+        "BB",
+        "BZ",
+        "BJ",
+        "BT",
+        "BO",
+        "BW",
+        "BR",
+        "BN",
+        "BF",
+        "BI",
+        "KH",
+        "CM",
+        "CA",
+        "CV",
+        "CF",
+        "TD",
+        "CL",
+        "CN",
+        "CO",
+        "KM",
+        "CG",
+        "CD",
+        "CR",
+        "CI",
+        "CU",
+        "DJ",
+        "DM",
+        "DO",
+        "EC",
+        "EG",
+        "SV",
+        "GQ",
+        "ER",
+        "ET",
+        "FJ",
+        "GA",
+        "GM",
+        "GE",
+        "GH",
+        "GD",
+        "GT",
+        "GN",
+        "GW",
+        "GY",
+        "HT",
+        "HN",
+        "IN",
+        "ID",
+        "IR",
+        "IQ",
+        "IL",
+        "JM",
+        "JP",
+        "JO",
+        "KZ",
+        "KE",
+        "KI",
+        "KP",
+        "KR",
+        "KW",
+        "KG",
+        "LA",
+        "LB",
+        "LS",
+        "LR",
+        "LY",
+        "MG",
+        "MW",
+        "MY",
+        "MV",
+        "ML",
+        "MH",
+        "MR",
+        "MU",
+        "MX",
+        "FM",
+        "MN",
+        "MA",
+        "MZ",
+        "MM",
+        "NA",
+        "NR",
+        "NP",
+        "NZ",
+        "NI",
+        "NE",
+        "NG",
+        "OM",
+        "PK",
+        "PW",
+        "PA",
+        "PG",
+        "PY",
+        "PE",
+        "PH",
+        "QA",
+        "RW",
+        "WS",
+        "ST",
+        "SA",
+        "SN",
+        "SC",
+        "SL",
+        "SG",
+        "SB",
+        "SO",
+        "ZA",
+        "LK",
+        "SD",
+        "SR",
+        "SZ",
+        "SY",
+        "TW",
+        "TJ",
+        "TZ",
+        "TH",
+        "TL",
+        "TG",
+        "TO",
+        "TT",
+        "TN",
+        "TM",
+        "TV",
+        "UG",
+        "AE",
+        "US",
+        "UY",
+        "UZ",
+        "VU",
+        "VE",
+        "VN",
+        "YE",
+        "ZM",
+        "ZW"
+      ]
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/features.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/features.schema.json",
+  "file_type": "features",
+  "provider": "ukrposhta",
+  "features": [
+    {
+      "id": "recipient_signature",
+      "porto_id": "recipient_signature",
+      "name": "Особисте вручення",
+      "label": "Recipient signature",
+      "description": "Delivery with recipient signature required."
+    },
+    {
+      "id": "return_receipt_paper",
+      "porto_id": "return_receipt",
+      "name": "Повідомлення про вручення (паперове)",
+      "label": "Return receipt (paper)",
+      "description": "Paper delivery notice returned to the sender."
+    },
+    {
+      "id": "return_receipt_electronic",
+      "porto_id": "return_receipt",
+      "name": "Повідомлення про вручення (електронне)",
+      "label": "Return receipt (electronic)",
+      "description": "Electronic delivery notice returned to the sender."
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/graph.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/graph.schema.json",
+  "file_type": "graph",
+  "provider": "ukrposhta",
+  "unit": {
+    "weight": "g",
+    "dimension": "mm",
+    "price": "cents",
+    "currency": "UAH"
+  },
+  "dependencies": {
+    "products": {
+      "file": "products.json",
+      "depends_on": [
+        "zones.json",
+        "weights.json",
+        "formats/envelopes.json",
+        "services.json",
+        "features.json",
+        "marks.json"
+      ],
+      "description": "Products require zones, weight tiers, envelope formats, services, features, and mark profiles"
+    },
+    "services": {
+      "file": "services.json",
+      "depends_on": [
+        "features.json"
+      ],
+      "description": "Services reference feature ids"
+    },
+    "product_prices": {
+      "file": "prices/products.json",
+      "depends_on": [
+        "products.json",
+        "zones.json",
+        "weights.json"
+      ],
+      "description": "Base postage grid for Ukrposhta letter products"
+    },
+    "service_prices": {
+      "file": "prices/services.json",
+      "depends_on": [
+        "products.json",
+        "services.json",
+        "zones.json",
+        "weights.json"
+      ],
+      "description": "Service surcharge amounts"
+    },
+    "zones": {
+      "file": "zones.json",
+      "depends_on": [
+        "policy/restrictions.json"
+      ],
+      "description": "Domestic/international zone definitions"
+    },
+    "weights": {
+      "file": "weights.json",
+      "depends_on": [],
+      "description": "Weight brackets"
+    },
+    "envelopes": {
+      "file": "formats/envelopes.json",
+      "depends_on": [],
+      "description": "Envelope catalog"
+    },
+    "envelope_layouts": {
+      "file": "formats/layouts.json",
+      "depends_on": [
+        "formats/envelopes.json"
+      ],
+      "description": "Jurisdiction-keyed print/window layout (DE/CH/FR); file formats/layouts.json"
+    },
+    "jurisdictions": {
+      "file": "policy/jurisdictions.json",
+      "depends_on": [],
+      "description": "UN/EU membership sets for restriction framework jurisdiction resolution"
+    },
+    "markets": {
+      "file": "policy/markets.json",
+      "depends_on": [],
+      "description": "Country-level currency, VAT, and international quote currencies for providers.json country"
+    },
+    "restrictions": {
+      "file": "policy/restrictions.json",
+      "depends_on": [
+        "policy/jurisdictions.json",
+        "zones.json",
+        "products.json"
+      ],
+      "description": "Global destination restrictions (bundled as policy/restrictions.json); optional cross-reference to zones and products"
+    },
+    "marks": {
+      "file": "marks.json",
+      "depends_on": [],
+      "description": "Franking profile catalog: profiles[] (sizes); resolution in graph.edges.marks"
+    },
+    "features": {
+      "file": "features.json",
+      "depends_on": [],
+      "description": "Feature catalog"
+    },
+    "limits": {
+      "file": "limits.json",
+      "depends_on": [
+        "policy/restrictions.json"
+      ],
+      "description": "Operational limits overlay"
+    }
+  },
+  "services": [
+    "return_receipt_paper",
+    "return_receipt_electronic",
+    "recommended_international"
+  ],
+  "edges": {
+    "products": {
+      "lyst_standartnyi": {
+        "zones": [
+          "domestic",
+          "world"
+        ],
+        "weight_tiers": [
+          "W0050",
+          "W0250",
+          "W1000",
+          "W2000"
+        ]
+      },
+      "dokument": {
+        "zones": [
+          "domestic"
+        ],
+        "weight_tiers": [
+          "W1000"
+        ]
+      }
+    },
+    "marks": {
+      "domestic": {
+        "profile": "domestic"
+      },
+      "world": {
+        "profile": "domestic"
+      }
+    }
+  }
+}