Guía de conector7 minutos de lectura29 herramientas MCP7 idiomas

Servidor Ukrposhta MCP: envíos y oficinas

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

HCPor el equipo de HelpCodeActualizado 7 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Ukrposhta

Ukrposhta

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

herramientas

29

Región

INTL

Categoría

Logística

Autenticación

API credentials

Env vars requeridas

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Configuración guiada

Conecta Ukrposhta a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Ukrposhta con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para Ukrposhta

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Ukrposhta · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Ukrposhta, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Ukrposhta

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Configuración

  1. Firma un contrato para la API con Ukrposhta (servicio al cliente empresarial, [email protected]). Con el contrato recibirás un anexo con tus claves de producción.
  2. Copia PRODUCTION BEARER eCom en UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking en UKRPOSHTA_TRACKING_BEARER y PROD_COUNTERPARTY TOKEN en UKRPOSHTA_COUNTERPARTY_TOKEN.

Las claves de sandbox (SANDBOX ...) no funcionan aquí: este conector llama al host de producción. El portador de eCom también abre el clasificador de direcciones y el servicio de etiquetas; el seguimiento tiene su propio portador; el token de contraparte identifica tu cuenta en las llamadas sobre tus clientes y envíos.

Por dónde empezar: ukrposhta_track_shipment o ukrposhta_get_last_status con un código de barras. Para los envíos de tu cuenta, ukrposhta_get_shipment_by_barcode o ukrposhta_list_sender_shipments con el uuid del cliente remitente.

Seguimiento: ukrposhta_track_shipment (todos los eventos), ukrposhta_get_last_status, ukrposhta_get_last_statuses (hasta 50 códigos de barras) y ukrposhta_get_shipment_route. Pasa lang en para nombres de eventos en inglés.

Envíos: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments, y ukrposhta_get_label (PDF). Antes de enviar, ukrposhta_check_route y ukrposhta_calculate_domestic_price (UAH, sin los descuentos de tu contrato).

Crear un envío sigue el orden de Ukrposhta: ukrposhta_create_address para el remitente y el destinatario, ukrposhta_create_client para cada uno (o reutilízalos: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), luego ukrposhta_create_shipment, luego la etiqueta. ukrposhta_create_shipment y ukrposhta_delete_shipment están instalados desactivados: un envío creado se cobra una vez entregado, y uno eliminado no puede ser restaurado. Las direcciones y los clientes no tienen costo.

Clasificador de direcciones: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, y para oficinas de correos ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near y ukrposhta_get_post_office_hours. Las respuestas vienen como listas de Entries.Entry con nombres de campo en mayúsculas; los ids son cadenas.

Unidades y trampas: peso en gramos, tamaños en cm, dinero en UAH. Tipos de entrega: W2W oficina a oficina, W2D a la puerta, D2W y D2D desde la puerta. Un código postal marcado como RESTRICTED_ACCESS puede ser solo una dirección de remitente o de retorno. Estados: CREADO (no entregado aún), REGISTRADO, EN_ENTREGA, EN_DEPARTAMENTO (esperando en la oficina), ENTREGADO, RETORNANDO, RETORNADO, CANCELADO, ELIMINADO. Los horarios son la hora local de Kyiv.

Requisitos previos: UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN

Instalar el conector 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

Abre http://localhost:3000/connectors/store, elige Ukrposhta y pega las variables de entorno listadas bajo Requisitos previos.

Herramientas disponibles

HerramientaQué hace
ukrposhta_track_shipmentHistorial completo de estado de un envío por código de barras: por paso de evento, fecha, índice y nombre de la oficina de correos, código de evento y eventName (por ejemplo…
ukrposhta_get_last_statusEl último estado de un envío por código de barras: fecha, índice y nombre de la oficina de correos, código de evento, eventName y eventReason. Solo lectura
ukrposhta_get_last_statusesEl último estado de hasta 50 envíos a la vez, más los códigos de barras que Ukrposhta no conoce: por código de barras fecha, oficina de correos, código de evento y…
ukrposhta_get_shipment_routeDe dónde y hacia dónde viaja un envío (país y localidad) por código de barras. Solo lectura
ukrposhta_get_shipmentLeer un envío de tu cuenta por uuid: código de barras, tipo, clientes remitente y destinatario con direcciones, deliveryType, paquetes (peso…
ukrposhta_get_shipment_by_barcodeLeer un envío de tu cuenta por su código de barras (mismos campos que ukrposhta_get_shipment). Solo lectura
ukrposhta_list_sender_shipmentsListar los envíos creados para un cliente remitente: uuid, código de barras, destinatario, deliveryType, paquetes, precios y estado del ciclo de vida. Solo lectura
ukrposhta_get_shipment_lifecycleEstado actual de un envío desde el lado de eCom: shipmentUuid, shipmentBarcode, estado (CREADO, REGISTRADO, EN_ENTREGA, EN_DEPARTAMENTO…
ukrposhta_list_shipment_groupsListar los grupos de envíos (registros para el formulario 103a) de un cliente: uuid, nombre, tipo, fecha de creación, bandera de cerrado y número de envíos.…
ukrposhta_list_group_shipmentsListar los envíos en un grupo de envíos: uuid, código de barras, destinatario, paquetes, precios y estado del ciclo de vida. Solo lectura
ukrposhta_get_labelDescargar la etiqueta de dirección (sticker) de un envío que creaste, como un archivo PDF: 100 x 100 mm por defecto, o en una hoja A4 o A5. Imprimir un…
ukrposhta_calculate_domestic_priceEstimar el precio de un envío dentro de Ucrania antes de crearlo: deliveryPrice en UAH, rawDeliveryPrice, postPayDeliveryPrice…
ukrposhta_check_routeComprobar que Ukrposhta entrega entre dos códigos postales: código (SUCCESS cuando está disponible), descripción y mrtps (donde la oficina de correos móvil de…
ukrposhta_get_clientLeer un cliente (remitente o destinatario) de tu cuenta: uuid, tipo (INDIVIDUAL, EMPRENDEDOR_PRIVADO, EMPRESA), nombre, primerNombre, apellido…
ukrposhta_find_clients_by_phoneEncontrar los clientes de tu cuenta con un número de teléfono: uuid, nombre, tipo, direcciones. Solo lectura
ukrposhta_get_addressLeer una dirección creada con ukrposhta_create_address: id, código postal, región, distrito, ciudad, calle, número de casa, número de apartamento, país…
ukrposhta_create_addressCrear una dirección para usar para un cliente o un envío. Solo se requiere el código postal; añade calle y casa para entrega a domicilio. Gratis; las respuestas…
ukrposhta_create_clientCrear un cliente (remitente o destinatario) en una dirección de ukrposhta_create_address. Los individuos y emprendedores privados necesitan first_name…
ukrposhta_create_shipmentCrear un envío nacional de un cliente remitente a un cliente destinatario. Obtiene un código de barras y un precio, y se cobra una vez entregado en la…
ukrposhta_delete_shipmentEliminar un envío que aún está en estado CREADO (no entregado aún). No se puede deshacer. Instalado desactivado
ukrposhta_find_post_offices_by_postcodeOficinas de correos que sirven a un código postal: ID, PO_SHORT y PO_LONG (nombre), DIRECCIÓN, TELÉFONO, TYPE_LONG, LATITUD, LONGITUD, POSTTERMINAL…
ukrposhta_find_post_offices_nearOficinas de correos cerca de un punto, las más cercanas primero: ID, nombre, dirección, código postal, distancia, coordenadas y tipo. Solo lectura
ukrposhta_get_post_office_hoursHorarios de apertura de una oficina de correos por código postal: por día de la semana el horario de apertura y cierre y descansos. Solo lectura
ukrposhta_get_city_by_postcodeLa localidad, distrito y región de un código postal, con sus ids. Solo lectura
ukrposhta_search_regionsEncontrar regiones (óblasts) por parte del nombre, en ucraniano o inglés: REGION_ID, REGION_UA, REGION_EN, códigos KOATUU y KATOTTG. Deja ambos…
ukrposhta_search_districtsEncontrar distritos de una región por nombre: DISTRICT_ID, nombres en UA y EN, región. Solo lectura
ukrposhta_search_citiesEncontrar localidades por nombre, opcionalmente dentro de una región y distrito: CITY_ID, nombres en UA y EN, tipo (ciudad, pueblo), distrito, región y…
ukrposhta_search_streetsEncontrar calles de una localidad por nombre: STREET_ID, nombres en UA y EN, tipo de calle. Solo lectura
ukrposhta_get_house_postcodeEl código postal de una casa en una calle: número de casa y POSTCODE. Solo lectura

Ejemplos de consultas

  • "¿Dónde está el paquete de Ukrposhta 0503112345678?"
  • "Muestra el último estado de estos 10 códigos de barras del despacho de ayer."
  • "¿Cuánto cuesta un paquete de 2 kg de Kyiv 01001 a Lviv 79000?"
  • "¿Qué oficinas de correos están cerca del código postal 65000, y cuándo están abiertas el sábado?"
  • "Descarga la etiqueta del envío 0503112345678."

Próximos pasos

¿Te ha sido útil esta guía?

Conecta Ukrposhta a Claude, ChatGPT o Copilot en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Ukrposhta con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar Ukrposhta MCP con ChatGPT

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Conectores

Conectar Ukrposhta MCP con Claude

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Conectores

Conectar Ukrposhta MCP con Microsoft Copilot

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Conectores

Conectar Ukrposhta MCP con Cursor

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Conectores

Conectar Ukrposhta MCP con Gemini CLI

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.

Conectores

Conectar Ukrposhta MCP con Meta Muse

API de Ukrposhta (Укрпошта) para clientes empresariales en Ucrania: seguimiento de envíos, envíos y etiquetas PDF, estimaciones de precios nacionales, comprobaciones de rutas, clientes y direcciones, y el clasificador de direcciones con oficinas de correos y horarios de apertura. Creación y eliminación de envíos instalados desactivados. Portadores de contrato y token de contraparte.