Zusammenfassung
Ukrposhta (Укрпошта) API für Geschäftskunden in der Ukraine: Sendungsverfolgung, Sendungen und PDF-Etiketten, Schätzungen der Inlandspreise, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Postämtern und Öffnungszeiten. Erstellen und Löschen von Sendungen ist deaktiviert. Vertragsträger und Gegenpartei-Token.
Geführte Einrichtung
Ukrposhta in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Ukrposhta in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Ukrposhta
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Ukrposhta, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Ukrposhta
Ukrposhta (Укрпошта) API für Geschäftskunden in der Ukraine: Sendungsverfolgung, Sendungen und PDF-Etiketten, Schätzungen der Inlandspreise, Routenprüfungen, Kunden und Adressen sowie der Adressklassifizierer mit Postämtern und Öffnungszeiten. Erstellen und Löschen von Sendungen ist deaktiviert. Vertragsträger und Gegenpartei-Token.
Einrichtung
- Unterzeichne einen Vertrag für die API mit Ukrposhta (Geschäftskundenservice, [email protected]). Mit dem Vertrag erhältst du einen Anhang mit deinen Produktionsschlüsseln.
- Kopiere PRODUCTION BEARER eCom in
UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking inUKRPOSHTA_TRACKING_BEARERund PROD_COUNTERPARTY TOKEN inUKRPOSHTA_COUNTERPARTY_TOKEN.
Die Sandbox-Schlüssel (SANDBOX ...) funktionieren hier nicht: Dieser Connector ruft den Produktionshost auf. Der eCom-Träger öffnet auch den Adressklassifizierer und den Etikettendienst; die Sendungsverfolgung hat ihren eigenen Träger; das Gegenpartei-Token identifiziert dein Konto bei Anfragen zu deinen Kunden und Sendungen.
Wo du anfangen kannst: ukrposhta_track_shipment oder ukrposhta_get_last_status mit einem Barcode. Für die Sendungen deines Kontos, ukrposhta_get_shipment_by_barcode oder ukrposhta_list_sender_shipments mit der UUID des Absenders.
Sendungsverfolgung: ukrposhta_track_shipment (alle Ereignisse), ukrposhta_get_last_status, ukrposhta_get_last_statuses (bis zu 50 Barcodes) und ukrposhta_get_shipment_route. Übergebe lang en für englische Ereignisnamen.
Sendungen: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments und ukrposhta_get_label (PDF). Vor dem Versand, ukrposhta_check_route und ukrposhta_calculate_domestic_price (UAH, ohne deine Vertragsrabatte).
Eine Sendung erstellen folgt der Reihenfolge von Ukrposhta: ukrposhta_create_address für Absender und Empfänger, ukrposhta_create_client für jeden (oder wiederverwenden: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), dann ukrposhta_create_shipment, dann das Etikett. ukrposhta_create_shipment und ukrposhta_delete_shipment sind deaktiviert: Eine erstellte Sendung wird einmal berechnet, wenn sie abgegeben wird, und eine gelöschte kann nicht wiederhergestellt werden. Adressen und Kunden kosten nichts.
Adressklassifizierer: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, und für Postämter ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near und ukrposhta_get_post_office_hours. Antworten kommen als Entries.Entry Listen mit Großbuchstaben-Feldnamen; ids sind Strings.
Einheiten und Fallstricke: Gewicht in Gramm, Größen in cm, Geld in UAH. Lieferarten: W2W Postamt zu Postamt, W2D bis zur Tür, D2W und D2D von der Tür. Eine Postleitzahl, die mit RESTRICTED_ACCESS gekennzeichnet ist, kann nur eine Absender- oder Rücksendeadresse sein. Status: CREATED (noch nicht abgegeben), REGISTERED, DELIVERING, IN_DEPARTMENT (wartet im Büro), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Zeiten sind Ortszeit in Kiew.
Voraussetzungen: UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN
Installiere den Connector lokal
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Öffne http://localhost:3000/connectors/store, wähle Ukrposhta und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
ukrposhta_track_shipment | Vollständige Statushistorie einer Sendung nach Barcode: pro Ereignis Schritt, Datum, Index und Name des Postamts, Ereigniscode und eventName (z.B.… |
ukrposhta_get_last_status | Der letzte Status einer Sendung nach Barcode: Datum, Postamtsindex und Name, Ereigniscode, eventName und eventReason. Nur lesbar |
ukrposhta_get_last_statuses | Der letzte Status von bis zu 50 Sendungen auf einmal, plus die Barcodes, die Ukrposhta nicht kennt: pro Barcode Datum, Postamt, Ereigniscode und… |
ukrposhta_get_shipment_route | Wo eine Sendung von und nach (Land und Ort) reist, nach Barcode. Nur lesbar |
ukrposhta_get_shipment | Lese eine Sendung deines Kontos nach UUID: Barcode, Typ, Absender- und Empfänger-Kunden mit Adressen, Lieferart, Pakete (Gewicht… |
ukrposhta_get_shipment_by_barcode | Lese eine Sendung deines Kontos nach ihrem Barcode (gleiche Felder wie ukrposhta_get_shipment). Nur lesbar |
ukrposhta_list_sender_shipments | Liste die für einen Absender-Kunden erstellten Sendungen: UUID, Barcode, Empfänger, Lieferart, Pakete, Preise und Lebenszyklusstatus. Nur lesbar |
ukrposhta_get_shipment_lifecycle | Aktueller Status einer Sendung von der eCom-Seite: shipmentUuid, shipmentBarcode, Status (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | Liste die Sendungsgruppen (Register für Formular 103a) eines Kunden: UUID, Name, Typ, Erstellungsdatum, geschlossenes Flag und Anzahl der Sendungen.… |
ukrposhta_list_group_shipments | Liste die Sendungen in einer Sendungsgruppe: UUID, Barcode, Empfänger, Pakete, Preise und Lebenszyklusstatus. Nur lesbar |
ukrposhta_get_label | Lade das Adressetikett (Aufkleber) einer von dir erstellten Sendung als PDF-Datei herunter: standardmäßig 100 x 100 mm oder auf einem A4- oder A5-Blatt. Das Drucken eines… |
ukrposhta_calculate_domestic_price | Schätze den Preis einer Sendung innerhalb der Ukraine, bevor du sie erstellst: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice… |
ukrposhta_check_route | Überprüfe, ob Ukrposhta zwischen zwei Postleitzahlen liefert: Code (SUCCESS, wenn verfügbar), Beschreibung und mrtps (wo das mobile Postamt von… |
ukrposhta_get_client | Lese einen Kunden (Absender oder Empfänger) deines Kontos: UUID, Typ (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), Name, Vorname, Nachname… |
ukrposhta_find_clients_by_phone | Finde die Kunden deines Kontos mit einer Telefonnummer: UUID, Name, Typ, Adressen. Nur lesbar |
ukrposhta_get_address | Lese eine Adresse, die mit ukrposhta_create_address erstellt wurde: ID, Postleitzahl, Region, Bezirk, Stadt, Straße, Hausnummer, Wohnungsnummer, Land… |
ukrposhta_create_address | Erstelle eine Adresse, die für einen Kunden oder eine Sendung verwendet werden soll. Nur die Postleitzahl ist erforderlich; füge Straße und Haus für die Lieferung an die Tür hinzu. Kostenlos; Antworten… |
ukrposhta_create_client | Erstelle einen Kunden (Absender oder Empfänger) an einer Adresse von ukrposhta_create_address. Einzelpersonen und private Unternehmer benötigen Vorname… |
ukrposhta_create_shipment | Erstelle eine Inlandssendung von einem Absender-Kunden zu einem Empfänger-Kunden. Sie erhält einen Barcode und einen Preis und wird einmal berechnet, wenn sie im… |
ukrposhta_delete_shipment | Lösche eine Sendung, die sich noch im Status CREATED (noch nicht abgegeben) befindet. Kann nicht rückgängig gemacht werden. Deaktiviert |
ukrposhta_find_post_offices_by_postcode | Postämter, die eine Postleitzahl bedienen: ID, PO_SHORT und PO_LONG (Name), ADRESSE, TELEFON, TYPE_LONG, BREITENGRAD, LÄNGENGRAD, POSTTERMINAL… |
ukrposhta_find_post_offices_near | Postämter in der Nähe eines Punktes, am nächsten zuerst: ID, Name, Adresse, Postleitzahl, Entfernung, Koordinaten und Typ. Nur lesbar |
ukrposhta_get_post_office_hours | Öffnungszeiten eines Postamts nach Postleitzahl: pro Wochentag die Öffnungs- und Schließzeiten sowie Pausen. Nur lesbar |
ukrposhta_get_city_by_postcode | Die Lokalität, den Bezirk und die Region einer Postleitzahl, mit ihren IDs. Nur lesbar |
ukrposhta_search_regions | Finde Regionen (Oblasten) nach einem Teil des Namens, auf Ukrainisch oder Englisch: REGION_ID, REGION_UA, REGION_EN, KOATUU und KATOTTG-Codes. Lass beide… |
ukrposhta_search_districts | Finde Bezirke einer Region nach Namen: DISTRICT_ID, Namen in UA und EN, Region. Nur lesbar |
ukrposhta_search_cities | Finde Lokalitäten nach Namen, optional innerhalb einer Region und eines Bezirks: CITY_ID, Namen in UA und EN, Typ (Stadt, Dorf), Bezirk, Region und… |
ukrposhta_search_streets | Finde Straßen einer Lokalität nach Namen: STREET_ID, Namen in UA und EN, Straßentyp. Nur lesbar |
ukrposhta_get_house_postcode | Die Postleitzahl eines Hauses in einer Straße: Hausnummer und POSTLEITZAHL. Nur lesbar |
Beispielaufforderungen
- "Wo ist das Ukrposhta-Paket 0503112345678?"
- "Zeige den letzten Status dieser 10 Barcodes vom Versand gestern."
- "Wie viel kostet ein 2 kg Paket von Kiew 01001 nach Lwiw 79000?"
- "Welche Postämter sind in der Nähe der Postleitzahl 65000, und wann haben sie am Samstag geöffnet?"
- "Lade das Etikett der Sendung 0503112345678 herunter."
Nächste Schritte
War dieser Guide hilfreich?