@gruncellka/porto-data 0.3.0 → 0.4.1

package/porto_data/providers/ukrposhta/limits.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/limits.schema.json",
+  "file_type": "limits",
+  "provider": "ukrposhta",
+  "unit": {
+    "country_code": "ISO 3166-1 alpha-2",
+    "date": "ISO 8601"
+  },
+  "context": {
+    "national": {
+      "description": "Letter-format services; domestic acceptance in UA. International acceptance follows Ukrposhta operational status.",
+      "notes": "Add rows when Ukrposhta publishes destination suspensions or operational limits for letters."
+    }
+  },
+  "limits": [],
+  "frameworks": {}
+}

package/porto_data/providers/ukrposhta/marks.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/marks.schema.json",
+  "file_type": "marks",
+  "provider": "ukrposhta",
+  "unit": {
+    "dimension": "mm"
+  },
+  "default_profile": "domestic",
+  "profiles": [
+    {
+      "id": "domestic",
+      "mark_type": "label",
+      "label": "Shipment label PDF",
+      "description": "Standard Ukrposhta eCom sticker PDF for letters and documents",
+      "scope_notes": "Domestic and international letters share one label model (A5-class PDF from API)",
+      "size": {
+        "width": 148,
+        "height": 210
+      },
+      "mime_type": [
+        "application/pdf"
+      ]
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/prices/products.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/product_prices.schema.json",
+  "file_type": "product_prices",
+  "provider": "ukrposhta",
+  "unit": {
+    "price": "cents",
+    "currency": "UAH"
+  },
+  "product_prices": [
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "domestic",
+      "weight_tier": "W0050",
+      "price": [
+        {
+          "amount": 2400,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "domestic",
+      "weight_tier": "W0250",
+      "price": [
+        {
+          "amount": 7200,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "domestic",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 7200,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "domestic",
+      "weight_tier": "W2000",
+      "price": [
+        {
+          "amount": 7200,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "dokument",
+      "zone": "domestic",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 5500,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "world",
+      "weight_tier": "W0050",
+      "currency": "USD",
+      "price": [
+        {
+          "amount": 250,
+          "effective_from": "2026-04-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "world",
+      "weight_tier": "W0250",
+      "currency": "USD",
+      "price": [
+        {
+          "amount": 400,
+          "effective_from": "2026-04-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "world",
+      "weight_tier": "W1000",
+      "currency": "USD",
+      "price": [
+        {
+          "amount": 1450,
+          "effective_from": "2026-04-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "lyst_standartnyi",
+      "zone": "world",
+      "weight_tier": "W2000",
+      "currency": "USD",
+      "price": [
+        {
+          "amount": 2850,
+          "effective_from": "2026-04-01",
+          "effective_to": null
+        }
+      ]
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/prices/services.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/service_prices.schema.json",
+  "file_type": "service_prices",
+  "provider": "ukrposhta",
+  "unit": {
+    "price": "cents",
+    "currency": "UAH"
+  },
+  "service_prices": [
+    {
+      "service_id": "return_receipt_paper",
+      "price": [
+        {
+          "amount": 4800,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "service_id": "return_receipt_electronic",
+      "price": [
+        {
+          "amount": 2400,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "service_id": "recommended_international",
+      "currency": "USD",
+      "price": [
+        {
+          "amount": 350,
+          "effective_from": "2026-04-01",
+          "effective_to": null
+        }
+      ]
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/products.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/products.schema.json",
+  "file_type": "products",
+  "provider": "ukrposhta",
+  "unit": {
+    "weight": "g"
+  },
+  "products": [
+    {
+      "id": "lyst_standartnyi",
+      "porto_id": "small",
+      "native_id": "letter",
+      "name": "Лист стандартний",
+      "envelope_ids": [
+        "DL",
+        "C6",
+        "C5",
+        "C4"
+      ],
+      "zones": [
+        "domestic",
+        "world"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "label",
+      "tracking_mode": "optional",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "between",
+          "days_min": 2,
+          "days_max": 3
+        },
+        {
+          "zones": [
+            "world"
+          ],
+          "span": "within",
+          "days_max": 10
+        }
+      ]
+    },
+    {
+      "id": "dokument",
+      "porto_id": "large",
+      "native_id": "document",
+      "name": "Укрпошта Документ",
+      "envelope_ids": [
+        "C4",
+        "B4"
+      ],
+      "zones": [
+        "domestic"
+      ],
+      "effective_from": "2026-01-01",
+      "effective_to": null,
+      "mark_type": "label",
+      "tracking_mode": "included",
+      "delivery": [
+        {
+          "zones": [
+            "domestic"
+          ],
+          "span": "between",
+          "days_min": 2,
+          "days_max": 3
+        }
+      ]
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/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": "ukrposhta",
+  "services": [
+    {
+      "id": "return_receipt_paper",
+      "porto_id": "return_receipt",
+      "name": "Паперове повідомлення про вручення",
+      "label": "Return receipt (paper)",
+      "description": "Paper delivery notice returned to sender",
+      "features": [
+        "return_receipt_paper"
+      ],
+      "enables_tracking": true
+    },
+    {
+      "id": "return_receipt_electronic",
+      "porto_id": "return_receipt",
+      "name": "Електронне повідомлення про вручення",
+      "label": "Return receipt (electronic)",
+      "description": "Electronic delivery notice returned to sender",
+      "features": [
+        "return_receipt_electronic"
+      ],
+      "enables_tracking": true
+    },
+    {
+      "id": "recommended_international",
+      "porto_id": "registered",
+      "name": "Міжнародне реєстрування",
+      "label": "International registered",
+      "description": "Registered surcharge for international letters (LETTER; no declared value)",
+      "features": [
+        "recipient_signature"
+      ],
+      "enables_tracking": true
+    }
+  ]
+}

package/porto_data/providers/ukrposhta/weights.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/weights.schema.json",
+  "file_type": "weights",
+  "provider": "ukrposhta",
+  "unit": {
+    "weight": "g"
+  },
+  "weights": {
+    "W0050": {
+      "min": 0,
+      "max": 50
+    },
+    "W0250": {
+      "min": 51,
+      "max": 250
+    },
+    "W1000": {
+      "min": 251,
+      "max": 1000
+    },
+    "W2000": {
+      "min": 1001,
+      "max": 2000
+    }
+  }
+}

package/porto_data/providers/ukrposhta/zones.json

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

package/porto_data/providers.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/providers.schema.json",
+  "providers": {
+    "deutschepost": {
+      "label": "Deutsche Post",
+      "name": "Deutsche Post AG",
+      "country": "DE",
+      "mark_types": [
+        "stamp"
+      ]
+    },
+    "ukrposhta": {
+      "label": "Ukrposhta",
+      "name": "Ukrposhta JSC",
+      "country": "UA",
+      "mark_types": [
+        "label"
+      ]
+    },
+    "laposte": {
+      "label": "La Poste",
+      "name": "La Poste S.A.",
+      "country": "FR",
+      "mark_types": [
+        "label"
+      ]
+    },
+    "swisspost": {
+      "label": "Swiss Post",
+      "name": "Die Schweizerische Post AG",
+      "country": "CH",
+      "mark_types": [
+        "stamp"
+      ]
+    }
+  }
+}