@gruncellka/porto-data
v0.3.1
Published
Deutsche Post pricing and rules data with schema validation
Maintainers
Readme
Porto Data
Structured JSON data for Deutsche Post shipping services
A comprehensive, schema-validated dataset containing Deutsche Post pricing, restrictions, zones, features, services, and compliance frameworks for international postal services. All data is validated against JSON schemas and published as a self-contained package on npm and PyPI.
Install
TypeScript / JavaScript (npm, scope: @gruncellka)
pnpm add @gruncellka/porto-data
yarn add @gruncellka/porto-data
npm install @gruncellka/porto-dataUse this npm package in both TypeScript and JavaScript projects.
Python (PyPI)
pip install gruncellka-porto-data
uv add gruncellka-porto-data
poetry add gruncellka-porto-dataThe package includes data/, schemas/, mappings.json, and metadata.json so you can validate and use the data offline. Data files reference canonical schema URLs (GitHub); schemas are shipped in the package for local validation.
- Python (PyPI): import
porto_dataand access packaged files underporto_data/(data/,schemas/,mappings.json,metadata.json). - TypeScript / JavaScript (npm): data lives under
porto_data/(for exampleporto_data/data/products.json,porto_data/schemas/,porto_data/mappings.json,porto_data/metadata.json).
Use cases
E-commerce and logistics (shipping costs, restrictions), compliance (sanctions, frameworks), research and education.
Data statistics
9 JSON files, 9 schemas; 190+ countries in zones; 5 product types; 5 service types (e.g. registered mail); 31 restrictions across 18 compliance frameworks.
Data overview and structure
| File | Description |
| ------------------- | ------------------------------------------------------- |
| products.json | Shipping products (letters, parcels, packages) |
| services.json | Additional services (registered mail, etc.) |
| prices.json | Pricing by product, zone, and weight (effective dates) |
| zones.json | Geographic zones and country mappings |
| weight_tiers.json | Weight brackets for pricing |
| dimensions.json | Size limits and specifications |
| features.json | Service features and capabilities |
| restrictions.json | Shipping restrictions, sanctions, compliance frameworks |
| data_links.json | Cross-references between data files |
All data is validated against JSON schemas in schemas/; mappings.json maps schemas to files; metadata.json has checksums and canonical URLs. Structure: Products → Prices → Zones (dimensions, weight tiers, effective dates); Services → Features; Restrictions → Frameworks (e.g. EU sanctions, UN resolutions). One-directional; no circular dependencies. data_links.json describes dependencies and lookup rules.
Standards
- Country codes: ISO 3166-1 alpha-2 (
DE,US,FR,YE) - Region codes: ISO 3166-2 (
DE-BY,US-CA,FR-75) - Dates: ISO 8601 (
2024-01-15,2023-06-01) - Jurisdiction:
EU(European Union),UN(United Nations),DE(Germany),DP(Deutsche Post operational)
Restrictions: Tracks occupied/disputed territories, links to legal frameworks (EU sanctions, UN resolutions), supports partial territory restrictions (effective_partial) and historical dates (effective_from, effective_to).
Disclaimer
This is reference data for Deutsche Post services. Always verify current restrictions, pricing, and service availability with Deutsche Post before shipping. Data accuracy is best-effort. Official information: Deutsche Post.
Related resources
🔳 gruncellka
