In breve
API di Ukrposhta (Укрпошта) per clienti aziendali in Ucraina: tracciamento delle spedizioni, spedizioni ed etichette PDF, stime dei prezzi nazionali, controlli delle rotte, clienti e indirizzi, e il classificatore degli indirizzi con uffici postali e orari di apertura. Creazione e cancellazione delle spedizioni installate disattivate. Portatori di contratto e token controparte.
Configurazione guidata
Collega Ukrposhta a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Ukrposhta con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Ukrposhta
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Ukrposhta, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Ukrposhta
API di Ukrposhta (Укрпошта) per clienti aziendali in Ucraina: tracciamento delle spedizioni, spedizioni ed etichette PDF, stime dei prezzi nazionali, controlli delle rotte, clienti e indirizzi, e il classificatore degli indirizzi con uffici postali e orari di apertura. Creazione e cancellazione delle spedizioni installate disattivate. Portatori di contratto e token controparte.
Configurazione
- Firma un contratto per l'API con Ukrposhta (servizio clienti aziendali, [email protected]). Con il contratto ricevi un allegato con le tue chiavi di produzione.
- Copia PRODUCTION BEARER eCom in
UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking inUKRPOSHTA_TRACKING_BEARERe PROD_COUNTERPARTY TOKEN inUKRPOSHTA_COUNTERPARTY_TOKEN.
Le chiavi sandbox (SANDBOX ...) non funzionano qui: questo connettore chiama l'host di produzione. Il portatore eCom apre anche il classificatore degli indirizzi e il servizio etichette; il tracciamento ha il suo portatore; il token controparte identifica il tuo account nelle chiamate riguardanti i tuoi clienti e le spedizioni.
Da dove iniziare: ukrposhta_track_shipment o ukrposhta_get_last_status con un codice a barre. Per le spedizioni del tuo account, ukrposhta_get_shipment_by_barcode o ukrposhta_list_sender_shipments con l'uuid del cliente mittente.
Tracciamento: ukrposhta_track_shipment (tutti gli eventi), ukrposhta_get_last_status, ukrposhta_get_last_statuses (fino a 50 codici a barre) e ukrposhta_get_shipment_route. Passa lang en per i nomi degli eventi in inglese.
Spedizioni: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments, e ukrposhta_get_label (PDF). Prima della spedizione, ukrposhta_check_route e ukrposhta_calculate_domestic_price (UAH, senza gli sconti del tuo contratto).
Creazione di una spedizione segue l'ordine di Ukrposhta: ukrposhta_create_address per mittente e destinatario, ukrposhta_create_client per ciascuno (o riutilizzali: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), poi ukrposhta_create_shipment, poi l'etichetta. ukrposhta_create_shipment e ukrposhta_delete_shipment sono installati disattivati: una spedizione creata viene addebitata una volta consegnata, e una cancellata non può essere ripristinata. Indirizzi e clienti non costano nulla.
Classificatore degli indirizzi: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, e per gli uffici postali ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near e ukrposhta_get_post_office_hours. Le risposte arrivano come liste Entries.Entry con nomi di campo in maiuscolo; gli id sono stringhe.
Unità e insidie: peso in grammi, dimensioni in cm, denaro in UAH. Tipi di consegna: W2W da ufficio postale a ufficio postale, W2D a domicilio, D2W e D2D dalla porta. Un codice postale contrassegnato come RESTRICTED_ACCESS può essere solo un indirizzo mittente o di ritorno. Stati: CREATED (non ancora consegnato), REGISTERED, DELIVERING, IN_DEPARTMENT (in attesa all'ufficio), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Gli orari sono ora locale di Kyiv.
Requisiti: UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli Ukrposhta e incolla le variabili d'ambiente elencate sotto Requisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
ukrposhta_track_shipment | Storia completa dello stato di una spedizione tramite codice a barre: per ogni evento, data, indice e nome dell'ufficio postale, codice evento e eventName (es.… |
ukrposhta_get_last_status | L'ultimo stato di una spedizione tramite codice a barre: data, indice e nome dell'ufficio postale, codice evento, eventName e eventReason. Solo lettura |
ukrposhta_get_last_statuses | L'ultimo stato di fino a 50 spedizioni contemporaneamente, più i codici a barre che Ukrposhta non conosce: per codice a barre data, ufficio postale, codice evento e… |
ukrposhta_get_shipment_route | Dove viaggia una spedizione da e verso (paese e località) tramite codice a barre. Solo lettura |
ukrposhta_get_shipment | Leggi una spedizione del tuo account tramite uuid: codice a barre, tipo, clienti mittente e destinatario con indirizzi, deliveryType, pacchi (peso… |
ukrposhta_get_shipment_by_barcode | Leggi una spedizione del tuo account tramite il suo codice a barre (stessi campi di ukrposhta_get_shipment). Solo lettura |
ukrposhta_list_sender_shipments | Elenca le spedizioni create per un cliente mittente: uuid, codice a barre, destinatario, deliveryType, pacchi, prezzi e stato del ciclo di vita. Solo lettura |
ukrposhta_get_shipment_lifecycle | Stato attuale di una spedizione dal lato eCom: shipmentUuid, shipmentBarcode, stato (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | Elenca i gruppi di spedizione (registri per il modulo 103a) di un cliente: uuid, nome, tipo, data di creazione, flag chiuso e numero di spedizioni.… |
ukrposhta_list_group_shipments | Elenca le spedizioni in un gruppo di spedizione: uuid, codice a barre, destinatario, pacchi, prezzi e stato del ciclo di vita. Solo lettura |
ukrposhta_get_label | Scarica l'etichetta dell'indirizzo (adesivo) di una spedizione che hai creato, come file PDF: 100 x 100 mm per impostazione predefinita, o su un foglio A4 o A5. La stampa di un… |
ukrposhta_calculate_domestic_price | Stima il prezzo di una spedizione all'interno dell'Ucraina prima di crearla: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice… |
ukrposhta_check_route | Controlla che Ukrposhta consegni tra due codici postali: codice (SUCCESS quando disponibile), descrizione e mrtps (dove si trova l'ufficio postale mobile di… |
ukrposhta_get_client | Leggi un cliente (mittente o destinatario) del tuo account: uuid, tipo (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), nome, firstName, lastName… |
ukrposhta_find_clients_by_phone | Trova i clienti del tuo account con un numero di telefono: uuid, nome, tipo, indirizzi. Solo lettura |
ukrposhta_get_address | Leggi un indirizzo creato con ukrposhta_create_address: id, codice postale, regione, distretto, città, strada, numero civico, numero appartamento, paese… |
ukrposhta_create_address | Crea un indirizzo da utilizzare per un cliente o una spedizione. Solo il codice postale è richiesto; aggiungi strada e numero civico per la consegna a domicilio. Gratuito; le risposte… |
ukrposhta_create_client | Crea un cliente (mittente o destinatario) su un indirizzo da ukrposhta_create_address. Le persone fisiche e gli imprenditori privati hanno bisogno di first_name… |
ukrposhta_create_shipment | Crea una spedizione nazionale da un cliente mittente a un cliente destinatario. Ottiene un codice a barre e un prezzo, e viene addebitata una volta consegnata all'… |
ukrposhta_delete_shipment | Elimina una spedizione che è ancora in stato CREATED (non ancora consegnata). Non può essere annullata. Installato disattivato |
ukrposhta_find_post_offices_by_postcode | Uffici postali che servono un codice postale: ID, PO_SHORT e PO_LONG (nome), INDIRIZZO, TELEFONO, TYPE_LONG, LATITUDINE, LONGITUDINE, POSTTERMINAL… |
ukrposhta_find_post_offices_near | Uffici postali vicino a un punto, i più vicini per primi: ID, nome, indirizzo, codice postale, distanza, coordinate e tipo. Solo lettura |
ukrposhta_get_post_office_hours | Orari di apertura di un ufficio postale per codice postale: per giorno della settimana l'orario di apertura e chiusura e le pause. Solo lettura |
ukrposhta_get_city_by_postcode | La località, il distretto e la regione di un codice postale, con i loro id. Solo lettura |
ukrposhta_search_regions | Trova regioni (oblast) per parte del nome, in ucraino o inglese: REGION_ID, REGION_UA, REGION_EN, codici KOATUU e KATOTTG. Lascia entrambi… |
ukrposhta_search_districts | Trova distretti di una regione per nome: DISTRICT_ID, nomi in UA e EN, regione. Solo lettura |
ukrposhta_search_cities | Trova località per nome, eventualmente all'interno di una regione e distretto: CITY_ID, nomi in UA e EN, tipo (città, villaggio), distretto, regione e… |
ukrposhta_search_streets | Trova strade di una località per nome: STREET_ID, nomi in UA e EN, tipo di strada. Solo lettura |
ukrposhta_get_house_postcode | Il codice postale di una casa su una strada: numero civico e CODICE POSTALE. Solo lettura |
Esempi di richieste
- "Dove si trova il pacco Ukrposhta 0503112345678?"
- "Mostra l'ultimo stato di questi 10 codici a barre della spedizione di ieri."
- "Quanto costa un pacco di 2 kg da Kyiv 01001 a Lviv 79000?"
- "Quali uffici postali sono vicino al codice postale 65000, e quando sono aperti sabato?"
- "Scarica l'etichetta della spedizione 0503112345678."
Prossimi passi
Questa guida ti è stata utile?