@gruncellka/porto-data 0.3.0 → 0.4.1

package/porto_data/providers/deutschepost/features.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/features.schema.json",
+  "file_type": "features",
+  "provider": "deutschepost",
+  "features": [
+    {
+      "id": "sendungsnummer",
+      "porto_id": "tracking_number",
+      "name": "Sendungsnummer",
+      "label": "Tracking number",
+      "description": "Unique tracking number (registered mail only)"
+    },
+    {
+      "id": "einliefernachweis",
+      "porto_id": "proof_of_mailing",
+      "name": "Einliefernachweis",
+      "label": "Proof of mailing",
+      "description": "Documentation that item was mailed"
+    },
+    {
+      "id": "unterschrift_empfanger",
+      "porto_id": "recipient_signature",
+      "name": "Empfängerunterschrift",
+      "label": "Recipient signature required",
+      "description": "Recipient must sign upon delivery"
+    },
+    {
+      "id": "rueckschein",
+      "porto_id": "return_receipt",
+      "name": "Rückschein",
+      "label": "Return receipt to sender",
+      "description": "Receipt returned to sender as proof of delivery"
+    },
+    {
+      "id": "zustellnachweis",
+      "porto_id": "proof_of_delivery",
+      "name": "Zustellnachweis",
+      "label": "Proof of delivery",
+      "description": "Derived from tracking status; not a separate API capability"
+    }
+  ]
+}

package/porto_data/providers/deutschepost/graph.json

@@ -0,0 +1,203 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/graph.schema.json",
+  "file_type": "graph",
+  "provider": "deutschepost",
+  "unit": {
+    "weight": "g",
+    "dimension": "mm",
+    "price": "cents",
+    "currency": "EUR"
+  },
+  "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, canonical envelope format ids, services, features, and mark profiles"
+    },
+    "services": {
+      "file": "services.json",
+      "depends_on": [
+        "features.json"
+      ],
+      "description": "Services require features and price information"
+    },
+    "product_prices": {
+      "file": "prices/products.json",
+      "depends_on": [
+        "products.json",
+        "zones.json",
+        "weights.json"
+      ],
+      "description": "Base postage grid (product_id × zone × weight_tier); file providers/<id>/prices/products.json (file_type product_prices)"
+    },
+    "service_prices": {
+      "file": "prices/services.json",
+      "depends_on": [
+        "products.json",
+        "services.json",
+        "zones.json",
+        "weights.json"
+      ],
+      "description": "Service surcharge amounts; file providers/<id>/prices/services.json (file_type service_prices)"
+    },
+    "zones": {
+      "file": "zones.json",
+      "depends_on": [
+        "policy/restrictions.json"
+      ],
+      "description": "Zones may have restricted destinations"
+    },
+    "weights": {
+      "file": "weights.json",
+      "depends_on": [],
+      "description": "Weight brackets (tier ids) are standalone definitions"
+    },
+    "envelopes": {
+      "file": "formats/envelopes.json",
+      "depends_on": [],
+      "description": "Global envelope id catalog: physical front size (mm); international baseline (e.g. ISO 269); file formats/envelopes.json"
+    },
+    "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"
+    },
+    "limits": {
+      "file": "limits.json",
+      "depends_on": [
+        "policy/restrictions.json"
+      ],
+      "description": "Provider operational limits extend global restrictions after load"
+    },
+    "features": {
+      "file": "features.json",
+      "depends_on": [],
+      "description": "Features are standalone definitions referenced by services"
+    },
+    "marks": {
+      "file": "marks.json",
+      "depends_on": [],
+      "description": "Franking profile catalog: profiles[] (sizes); resolution in graph.edges.marks"
+    }
+  },
+  "services": [
+    "einschreiben",
+    "einschreiben_einwurf",
+    "einschreiben_rueckschein",
+    "zusatzversicherung"
+  ],
+  "edges": {
+    "products": {
+      "standardbrief": {
+        "zones": [
+          "domestic",
+          "zone_1_eu",
+          "zone_2_europe",
+          "world"
+        ],
+        "weight_tiers": [
+          "W0020"
+        ]
+      },
+      "kompaktbrief": {
+        "zones": [
+          "domestic",
+          "zone_1_eu",
+          "zone_2_europe",
+          "world"
+        ],
+        "weight_tiers": [
+          "W0050"
+        ]
+      },
+      "grossbrief": {
+        "zones": [
+          "domestic",
+          "zone_1_eu",
+          "zone_2_europe",
+          "world"
+        ],
+        "weight_tiers": [
+          "W0500"
+        ]
+      },
+      "maxibrief": {
+        "zones": [
+          "domestic",
+          "zone_1_eu",
+          "zone_2_europe",
+          "world"
+        ],
+        "weight_tiers": [
+          "W1000"
+        ]
+      },
+      "maxibrief_international_heavy": {
+        "zones": [
+          "zone_1_eu",
+          "zone_2_europe",
+          "world"
+        ],
+        "weight_tiers": [
+          "W2000"
+        ]
+      }
+    },
+    "marks": {
+      "domestic": {
+        "profile": "domestic",
+        "services": {
+          "einschreiben": "registered",
+          "einschreiben_einwurf": "registered",
+          "einschreiben_rueckschein": "registered"
+        }
+      },
+      "zone_1_eu": {
+        "profile": "international",
+        "services": {
+          "einschreiben": "registered_international"
+        }
+      },
+      "zone_2_europe": {
+        "profile": "international",
+        "services": {
+          "einschreiben": "registered_international"
+        }
+      },
+      "world": {
+        "profile": "international",
+        "services": {
+          "einschreiben": "registered_international"
+        }
+      }
+    }
+  }
+}

package/porto_data/providers/deutschepost/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": "deutschepost",
+  "unit": {
+    "country_code": "ISO 3166-1 alpha-2",
+    "date": "ISO 8601"
+  },
+  "context": {
+    "national": {
+      "description": "Volatile operator rules (strikes, temporary suspensions) and SDK overlays use the same row shape as policy/restrictions.json limits[] items when present. Sanctions and destination facts (EU/UN/CH rows) live only in policy/restrictions.json under destinations[].restrictions. This file is usually empty.",
+      "notes": "Merge order: global restrictions, then limits[] here, then any SDK operational overlay."
+    }
+  },
+  "limits": [],
+  "frameworks": {}
+}

package/porto_data/providers/deutschepost/marks.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/marks.schema.json",
+  "file_type": "marks",
+  "provider": "deutschepost",
+  "unit": {
+    "dimension": "mm"
+  },
+  "default_profile": "domestic",
+  "profiles": [
+    {
+      "id": "domestic",
+      "mark_type": "stamp",
+      "label": "Internetmarke domestic",
+      "description": "Standard domestic letter franking graphic",
+      "scope_notes": "Not from Deutsche Post official spec; measured from Internetmarke PDF samples (calibration samples/, not in git). Frankierzone placement max 74×40 mm",
+      "size": {
+        "width": 36,
+        "height": 16
+      },
+      "mime_type": [
+        "image/png",
+        "application/pdf"
+      ]
+    },
+    {
+      "id": "international",
+      "mark_type": "stamp",
+      "label": "Internetmarke international",
+      "description": "International letter franking graphic (wider footprint)",
+      "scope_notes": "Not from Deutsche Post official spec; measured from Internetmarke PDF samples. Includes Priority P.P. line when applicable",
+      "size": {
+        "width": 60,
+        "height": 16
+      },
+      "mime_type": [
+        "image/png",
+        "application/pdf"
+      ]
+    },
+    {
+      "id": "registered",
+      "mark_type": "stamp",
+      "label": "Internetmarke registered domestic",
+      "description": "Domestic registered (Einschreiben) franking graphic",
+      "scope_notes": "Not from Deutsche Post official spec; measured from Internetmarke PDF samples. Einschreiben Einwurf / Rückschein and domestic Einschreiben",
+      "size": {
+        "width": 57,
+        "height": 21
+      },
+      "mime_type": [
+        "image/png",
+        "application/pdf"
+      ]
+    },
+    {
+      "id": "registered_international",
+      "mark_type": "stamp",
+      "label": "Internetmarke registered international",
+      "description": "International registered franking graphic",
+      "scope_notes": "Not from Deutsche Post official spec; measured from Internetmarke PDF samples. International Einschreiben; taller footprint with barcode and service lines",
+      "size": {
+        "width": 57,
+        "height": 30
+      },
+      "mime_type": [
+        "image/png",
+        "application/pdf"
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,239 @@
+{
+  "provider": "deutschepost",
+  "unit": {
+    "price": "cents",
+    "currency": "EUR"
+  },
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/product_prices.schema.json",
+  "file_type": "product_prices",
+  "product_prices": [
+    {
+      "product_id": "standardbrief",
+      "zone": "domestic",
+      "weight_tier": "W0020",
+      "price": [
+        {
+          "amount": 95,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "standardbrief",
+      "zone": "zone_1_eu",
+      "weight_tier": "W0020",
+      "price": [
+        {
+          "amount": 125,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "standardbrief",
+      "zone": "zone_2_europe",
+      "weight_tier": "W0020",
+      "price": [
+        {
+          "amount": 125,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "standardbrief",
+      "zone": "world",
+      "weight_tier": "W0020",
+      "price": [
+        {
+          "amount": 125,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "kompaktbrief",
+      "zone": "domestic",
+      "weight_tier": "W0050",
+      "price": [
+        {
+          "amount": 110,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "kompaktbrief",
+      "zone": "zone_1_eu",
+      "weight_tier": "W0050",
+      "price": [
+        {
+          "amount": 180,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "kompaktbrief",
+      "zone": "zone_2_europe",
+      "weight_tier": "W0050",
+      "price": [
+        {
+          "amount": 180,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "kompaktbrief",
+      "zone": "world",
+      "weight_tier": "W0050",
+      "price": [
+        {
+          "amount": 180,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "grossbrief",
+      "zone": "domestic",
+      "weight_tier": "W0500",
+      "price": [
+        {
+          "amount": 180,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "grossbrief",
+      "zone": "zone_1_eu",
+      "weight_tier": "W0500",
+      "price": [
+        {
+          "amount": 330,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "grossbrief",
+      "zone": "zone_2_europe",
+      "weight_tier": "W0500",
+      "price": [
+        {
+          "amount": 330,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "grossbrief",
+      "zone": "world",
+      "weight_tier": "W0500",
+      "price": [
+        {
+          "amount": 330,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief",
+      "zone": "domestic",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 290,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief",
+      "zone": "zone_1_eu",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 650,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief",
+      "zone": "zone_2_europe",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 650,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief",
+      "zone": "world",
+      "weight_tier": "W1000",
+      "price": [
+        {
+          "amount": 650,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief_international_heavy",
+      "zone": "zone_1_eu",
+      "weight_tier": "W2000",
+      "price": [
+        {
+          "amount": 1700,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief_international_heavy",
+      "zone": "zone_2_europe",
+      "weight_tier": "W2000",
+      "price": [
+        {
+          "amount": 1700,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "product_id": "maxibrief_international_heavy",
+      "zone": "world",
+      "weight_tier": "W2000",
+      "price": [
+        {
+          "amount": 1700,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,51 @@
+{
+  "provider": "deutschepost",
+  "unit": {
+    "price": "cents",
+    "currency": "EUR"
+  },
+  "$schema": "https://raw.githubusercontent.com/gruncellka/porto-data/refs/heads/main/porto_data/schemas/service_prices.schema.json",
+  "file_type": "service_prices",
+  "service_prices": [
+    {
+      "service_id": "einschreiben",
+      "price": [
+        {
+          "amount": 265,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "service_id": "einschreiben_einwurf",
+      "price": [
+        {
+          "amount": 235,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "service_id": "einschreiben_rueckschein",
+      "price": [
+        {
+          "amount": 485,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    },
+    {
+      "service_id": "zusatzversicherung",
+      "price": [
+        {
+          "amount": 250,
+          "effective_from": "2026-01-01",
+          "effective_to": null
+        }
+      ]
+    }
+  ]
+}