Packeta 数据 API

Zásilkovna s.r.o. · 出行

Packeta 是 Zásilkovna s.r.o.（Packeta Group）推出的官方 Android 客户端，面向家庭用户和小型寄件人，通过 Packeta 自提点和 Z-BOX 智能柜在捷克、斯洛伐克、匈牙利、罗马尼亚和波兰寄送 C2C 包裹。登录后，寄件人可以查询邮资报价、创建运单、用 PayU、ČSOB 银行卡或 Google Pay 支付货到付款、追踪包裹、凭取件 PIN 通过蓝牙打开 Z-BOX，并在地图上查找附近的自提点；同一会话还保存已取件包裹的归档，以及包含常见问题和最近网点的首页信息流。界面文案为捷克语、斯洛伐克语、匈牙利语和罗马尼亚语；该客户端是 Packeta 自家的 C2C 应用，而非多承运商的追踪工具，与 UPS、Nova Poshta 和 Почта России 一样，属于全国性智能柜网络的客户端。

活跃包裹记录带有公开的 packet_id，以及放在 zbox_password 中的智能柜凭证，last_pickup_date 与 delivery_password 共同决定取件卡片的显示。收件人信息包含 name、phone、street、city、zip 和 country；流转状态由 type 加 note 表示。货到付款报价提供 sum_value、sum_currency 和 vat_value，PayU 发起支付则返回 order_id 与 finished_payment_link。自提点记录还有 externalId、boxType、maxWeight 和 openingHours。电商卖家、智能柜网络叠加层和末端配送 ERP 会把这些字段对账到运单台账中，openData Studio 则将它们转化为可调用的开放数据。

Z-BOX 寄存对象以 zbox_dropoff 和 zbox_flow_version 的形式挂在同一个包裹上；货到付款的收款渠道组合由 provider、webpayu、webcsob 和 cod_data.total_price 构成。跨境报价会针对一对国家读取 exchange_rate。首页的附近网点卡片包含 distanceFromOrigin 和 openHours。追踪分段针对同一个 packetId 返回 timestamp、message 和 messageFormatted。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

活跃包裹列表

GET /v1/packeta/packages/active opendata

列出已登录首页中在途的收件与寄件包裹，包括 Z-BOX PIN、货到付款标记和最后取件日期。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

id
packet_id
direction
store
delivery_type
recipient
cod
can_pay_cod
cod_paid
branch
carrier
status
last_pickup_date
is_extendable
picked_up_on
delivery_password
consign_password
return_password
delivery_token
zbox
zbox_dropoff
zbox_password
is_zbox_password_visible
zbox_flow_version
weight
is_redirection_enabled
is_shareable
url
name
company
phone
email
street
city
zip
country
note
type

GET /v1/packeta/packages/active HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json
Accept-Language: cs

{
  "data": [
    {
      "id": 88421,
      "packet_id": 512334455,
      "direction": "incoming",
      "store": "Alza",
      "delivery_type": "zbox",
      "recipient": {
        "name": "Jan Novák",
        "company": "",
        "phone": "+420777123456",
        "email": "[email protected]",
        "street": "Na Příkopě 14",
        "city": "Praha",
        "zip": "11000",
        "country": "CZ"
      },
      "cod": "1290.00",
      "can_pay_cod": true,
      "cod_paid": false,
      "branch": {
        "id": "Z-BOX-PR-12",
        "name": "Z-BOX Praha Na Příkopě"
      },
      "carrier": "packeta",
      "status": {
        "type": "ready_for_pickup",
        "note": "Waiting in Z-BOX"
      },
      "last_pickup_date": "2026-10-12",
      "is_extendable": true,
      "picked_up_on": null,
      "delivery_password": "4821",
      "consign_password": null,
      "return_password": null,
      "delivery_token": "dt-7c11",
      "zbox_password": "4821",
      "is_zbox_password_visible": true,
      "zbox_flow_version": 2,
      "zbox": {
        "box_id": "ZBOX-PR-12-A04"
      },
      "zbox_dropoff": null,
      "weight": 1.4,
      "is_redirection_enabled": true,
      "is_shareable": true,
      "url": "https://tracking.packeta.com/512334455"
    }
  ]
}

包裹详情

GET /v1/packeta/packages/{id} opendata

加载单个包裹卡片：收件人、承运商、智能柜 PIN、货到付款状态和改派标记，供详情页使用。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

id
packet_id
direction
store
delivery_type
recipient
cod
can_pay_cod
cod_paid
branch
carrier
status
last_pickup_date
is_extendable
picked_up_on
delivery_password
consign_password
return_password
delivery_token
zbox
zbox_dropoff
zbox_password
is_zbox_password_visible
zbox_flow_version
weight
is_redirection_enabled
is_shareable
url
name
company
phone
email
street
city
zip
country
note
type

GET /v1/packeta/packages/88421 HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json
Accept-Language: cs

{
  "data": {
    "id": 88421,
    "packet_id": 512334455,
    "direction": "incoming",
    "store": "Alza",
    "delivery_type": "zbox",
    "recipient": {
      "name": "Jan Novák",
      "company": "",
      "phone": "+420777123456",
      "email": "[email protected]",
      "street": "Na Příkopě 14",
      "city": "Praha",
      "zip": "11000",
      "country": "CZ"
    },
    "cod": "1290.00",
    "can_pay_cod": true,
    "cod_paid": false,
    "branch": {
      "id": "Z-BOX-PR-12",
      "name": "Z-BOX Praha Na Příkopě"
    },
    "carrier": "packeta",
    "status": {
      "type": "ready_for_pickup",
      "note": "Waiting in Z-BOX"
    },
    "last_pickup_date": "2026-10-12",
    "is_extendable": true,
    "picked_up_on": null,
    "delivery_password": "4821",
    "consign_password": null,
    "return_password": null,
    "delivery_token": "dt-7c11",
    "zbox_password": "4821",
    "is_zbox_password_visible": true,
    "zbox_flow_version": 2,
    "zbox": {
      "box_id": "ZBOX-PR-12-A04"
    },
    "zbox_dropoff": null,
    "weight": 1.4,
    "is_redirection_enabled": true,
    "is_shareable": true,
    "url": "https://tracking.packeta.com/512334455"
  }
}

已归档包裹

GET /v1/packeta/packages/archive opendata

按收件/寄件方向分页返回已取件或已取消的包裹，供归档标签页使用。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

direction
page
id
packet_id
is_archived
picked_up_on
status
recipient
weight

GET /v1/packeta/packages/archive?direction=incoming&page=1 HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json

{
  "data": [
    {
      "id": 88421,
      "packet_id": 512334455,
      "direction": "incoming",
      "store": "Alza",
      "delivery_type": "zbox",
      "recipient": {
        "name": "Jan Novák",
        "company": "",
        "phone": "+420777123456",
        "email": "[email protected]",
        "street": "Na Příkopě 14",
        "city": "Praha",
        "zip": "11000",
        "country": "CZ"
      },
      "cod": "1290.00",
      "can_pay_cod": true,
      "cod_paid": false,
      "branch": {
        "id": "Z-BOX-PR-12",
        "name": "Z-BOX Praha Na Příkopě"
      },
      "carrier": "packeta",
      "status": {
        "type": "ready_for_pickup",
        "note": "Waiting in Z-BOX"
      },
      "last_pickup_date": "2026-10-12",
      "is_extendable": true,
      "picked_up_on": "2026-10-08T16:22:00Z",
      "delivery_password": "4821",
      "consign_password": null,
      "return_password": null,
      "delivery_token": "dt-7c11",
      "zbox_password": "4821",
      "is_zbox_password_visible": true,
      "zbox_flow_version": 2,
      "zbox": {
        "box_id": "ZBOX-PR-12-A04"
      },
      "zbox_dropoff": null,
      "weight": 1.4,
      "is_redirection_enabled": true,
      "is_shareable": true,
      "url": "https://tracking.packeta.com/512334455",
      "is_archived": true
    }
  ]
}

创建 C2C 运单

POST /v1/packeta/packages opendata

在寄件流程中创建 C2C 运单，返回 package_id 和 PayU 的 payment_link。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

adult_content
branch_id
branch_name
cod
consign_country
currency
delivery_type
email
name
payment_method
payment_provider
phone
recipient_address
sender_address
size_class
target_country
totalPrice
weight
package_id
total_price
payment_link
deep_link

POST /v1/packeta/packages HTTP/1.1
X-Access-Token: <session-token>
Content-Type: application/json
Accept-Language: cs

{
  "adult_content": false,
  "bank_account": null,
  "branch_id": "ZBOX-PR-12",
  "branch_name": "Z-BOX Praha Na Příkopě",
  "cod": 1290.0,
  "consign_country": "CZ",
  "consing_country_id": 1,
  "currency": "CZK",
  "delivery_country_id": 1,
  "delivery_type": "zbox",
  "email": "[email protected]",
  "insurance": null,
  "name": "Jan Novák",
  "payment_method": "card",
  "payment_provider": "payu",
  "phone": "+420777123456",
  "promo_code": null,
  "recipient_address": {
    "street": "Na Příkopě 14",
    "city": "Praha",
    "zip": "11000",
    "country": "CZ"
  },
  "sender_address": {
    "street": "Národní 8",
    "city": "Praha",
    "zip": "11000",
    "country": "CZ"
  },
  "size_class": 1,
  "target_country": "CZ",
  "totalPrice": 89.0,
  "weight": 1400
}

{
  "data": {
    "deep_link": "packeta://package/88422",
    "package_id": 88422,
    "total_price": "89.00",
    "currency": "CZK",
    "payment_link": "https://pay.packeta.com/o/88422",
    "google_pay_info": null
  }
}

运费报价

POST /v1/packeta/packages/quote openfinance

按所选尺寸等级、自提点和货到付款金额，返回 C2C 资费（含税价、不含税价和增值税）。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

adult_content
branch_id
city
cod
consign_country
delivery_type
size_class
target_country
zip
sum
sum_value
sum_currency
sum_without_vat_value
vat_value
vat_percentage_value
breakdown
payments

POST /v1/packeta/packages/quote HTTP/1.1
X-Access-Token: <session-token>
Content-Type: application/json

{
  "adult_content": 0,
  "branch_id": "ZBOX-PR-12",
  "city": "Praha",
  "cod": 1290.0,
  "consign_country": "CZ",
  "delivery_type": "zbox",
  "email": "[email protected]",
  "insurance": null,
  "name": "Jan Novák",
  "phone": "+420777123456",
  "promo_code": null,
  "size_class": 1,
  "street": "Na Příkopě 14",
  "target_country": "SK",
  "zip": "11000"
}

{
  "data": {
    "sum": "89 CZK",
    "sum_value": 89.0,
    "sum_currency": "CZK",
    "sum_without_vat": "73.55 CZK",
    "sum_without_vat_value": 73.55,
    "sum_without_vat_currency": "CZK",
    "sum_presentable": "89 CZK",
    "sum_presentable_value": 89.0,
    "sum_presentable_currency": "CZK",
    "vat": "15.45 CZK",
    "vat_value": 15.45,
    "vat_currency": "CZK",
    "vat_percentage_value": 21.0,
    "vat_summary": true,
    "breakdown": [
      {
        "name": "delivery",
        "value": 89.0
      }
    ],
    "payments": {
      "payu": true,
      "csob": true,
      "google_pay": true
    }
  }
}

跨境汇率
GET /v1/packeta/fx openfinance
查询在两个目的国之间为 C2C 运单报价时所用的 Packeta 汇率。
认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。
- country_from
- country_to
- exchange_rate
```
GET /v1/packeta/fx?country_from=CZ&country_to=SK HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json
```
```
{
  "data": {
    "exchange_rate": 0.0405
  }
}
```
发起 PayU 银行卡支付
POST /v1/packeta/payments/card openfinance
为包裹（邮资或货到付款）发起一笔 PayU 银行卡扣款，并返回托管收银台链接。
认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。
- package_id
- card_token
- status
- order_id
- ext_order_id
- finished_payment_link
- verification_link
```
POST /v1/packeta/payments/card HTTP/1.1
X-Access-Token: <session-token>
Content-Type: application/json

{
  "package_id": 88421,
  "card_token": "tok_payu_4419"
}
```
```
{
  "data": {
    "status": "PENDING",
    "order_id": "88421-payu",
    "ext_order_id": "PAYU-9f21a",
    "finished_payment_link": "https://secure.payu.com/pay/9f21a",
    "verification_link": null
  }
}
```
货到付款支付方式
GET /v1/packeta/payments/providers openfinance
返回货到付款的收款渠道组合（PayU 与 ČSOB），以及待付货到付款包裹的应付金额。
认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。
- packageId
- success
- cod_data
- recipient_country
- currency
- total_price
- provider
- webpayu
- webcsob
```
GET /v1/packeta/payments/providers?packageId=88421 HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json
```
```
{
  "success": true,
  "cod_data": {
    "recipient_country": "CZ",
    "currency": "CZK",
    "total_price": 1290.0
  },
  "provider": "payu",
  "webpayu": {
    "enabled": true
  },
  "webcsob": {
    "enabled": true
  }
}
```

自提点详情

GET /v1/packeta/pickup-points/{externalId} opendata

加载单个自提点或 Z-BOX：地址、营业时间、重量上限，以及能否被选为寄件投递点。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

externalId
externalBranchId
exchangePointId
name
boxType
address
coordinates
maxWeight
openingHours
openSince
closes
flags
photos
canBeSelected
directions

GET /v1/packeta/pickup-points/ZBOX-PR-12 HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json

{
  "address": {
    "street": "Na Příkopě 14",
    "city": "Praha",
    "zip": "11000",
    "country": "CZ"
  },
  "boxType": "zbox",
  "closes": "22:00",
  "coordinates": {
    "latitude": 50.085,
    "longitude": 14.427
  },
  "directions": {
    "walking": "50 m from Můstek"
  },
  "externalBranchId": "BR-PR-12",
  "externalId": "ZBOX-PR-12",
  "flags": {
    "cardPayment": true,
    "wheelchair": false
  },
  "maxWeight": 15,
  "name": "Z-BOX Praha Na Příkopě",
  "openSince": "06:00",
  "openingHours": {
    "monday": "00:00-24:00"
  },
  "photos": [],
  "recommendedPostTime": null,
  "exchangePointId": "EX-PR-12",
  "canBeSelected": true
}

按 geohash 查询附近自提点
GET /v1/packeta/pickup-points opendata
返回地图图块内的自提点和 Z-BOX 智能柜，供附近网点图层使用。
认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。
- geohash
- externalId
- name
- boxType
- coordinates
- maxWeight
```
GET /v1/packeta/pickup-points?geohash=u2fkb&country=CZ HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json
```
```
[
  {
    "externalId": "ZBOX-PR-12",
    "name": "Z-BOX Praha Na Příkopě",
    "boxType": "zbox",
    "coordinates": {
      "latitude": 50.085,
      "longitude": 14.427
    },
    "maxWeight": 15
  }
]
```

首页信息流

GET /v1/packeta/homefeed opendata

加载首页看板：常见问题磁贴、促销页、可选的警示信息和最近的自提点。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

platform
language
latitude
longitude
faq_pages
nearby_branch
promotion_pages
warning_message
externalId
distanceFromOrigin
openHours

GET /v1/packeta/homefeed?platform=android&language=cs&latitude=50.085&longitude=14.427 HTTP/1.1
X-Access-Token: <session-token>
Accept: application/json

{
  "homefeed": {
    "faq_pages": [
      {
        "id": "faq-cod",
        "title": "Cash on delivery"
      }
    ],
    "nearby_branch": {
      "address": {
        "street": "Na Příkopě 14",
        "city": "Praha"
      },
      "coordinates": {
        "latitude": 50.085,
        "longitude": 14.427
      },
      "distanceFromOrigin": 180.4,
      "externalId": "ZBOX-PR-12",
      "flags": {
        "cardPayment": true
      },
      "name": "Z-BOX Praha Na Příkopě",
      "openHours": "00:00-24:00",
      "exchangePointId": "EX-PR-12"
    },
    "promotion_pages": [],
    "warning_message": null
  }
}

包裹追踪时间线

POST /v1/packeta/tracking opendata

在追踪页返回某个 packet_id 的流转时间线（分段与记录）。

认证方式：会话中的 X-Access-Token。Content-Type 与 Accept 均为 application/json；Accept-Language 为界面语言。

packetId
trackingSections
title
perex
order
trackingRecords
timestamp
message
messageFormatted
formattingArguments

POST /v1/packeta/tracking HTTP/1.1
X-Access-Token: <session-token>
Content-Type: application/json

{
  "packetId": "512334455"
}

{
  "data": {
    "packetsTracking": {
      "__typename": "PacketsTrackingV1Payload",
      "trackingSections": [
        {
          "title": "Ready for pickup",
          "perex": "Waiting in Z-BOX Praha Na Příkopě",
          "order": 3,
          "trackingRecords": [
            {
              "timestamp": "2026-10-09T08:14:00Z",
              "order": 1,
              "message": "Parcel inserted into Z-BOX",
              "messageFormatted": "Parcel inserted into Z-BOX Praha Na Příkopě",
              "formattingArguments": [
                {
                  "order": 1,
                  "name": "branch",
                  "url": null
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

数据类别

包裹
物流追踪
自提点
智能柜
货到付款
汇率

数据使用场景与案例

末端配送的 Z-BOX PIN 同步
智能柜叠加层读取 packet_id、zbox_password、last_pickup_date 和 is_zbox_password_visible，让收件人的首页无需等短信就能显示实时 PIN，并在 picked_up_on 写入后将其隐藏。
货到付款与 PayU 对账
店铺账本拉取 can_pay_cod、cod 和 PayU 发起支付结果（order_id、ext_order_id、finished_payment_link），再配合货到付款收款渠道组合（provider、webpayu、webcsob、total_price），把货到付款与对应包裹结清。
自提点地图叠加层
门店定位器提交 geohash，并关联 externalId、boxType、maxWeight 和 openingHours，让调度员把寄存件分派到仍接受该尺寸等级的 Z-BOX。
跨境报价监控
中东欧发货台读取 country_from/country_to 对应的 exchange_rate 以及资费卡（sum_value、vat_value、size_class），再确认 CZ→SK 的 C2C 面单。

常见问题

Packeta 如何为包裹和支付请求做身份验证？

已登录的请求会携带来自会话存储的 X-Access-Token，外加 application/json 的 Content-Type 与 Accept，以及对应界面语言的 Accept-Language。当用户仍处于登录状态却收到 401 时，会话会被登出。

活跃包裹上会出现哪些 Z-BOX 字段？

包裹卡片返回 zbox_password、is_zbox_password_visible、zbox_flow_version、zbox 和 zbox_dropoff，以及用于打开智能柜的 last_pickup_date、delivery_password 和 delivery_token。

货到付款是如何收款的？

支付渠道接口返回 provider、webpayu、webcsob 和 cod_data（recipient_country、currency、total_price）。PayU 银行卡发起接口提交 package_id 和 card_token，返回 order_id 与 finished_payment_link；ČSOB 银行卡、Google Pay 和 PayU QR 是并列的结账入口。

可以列出附近的自提点吗？

可以。一个 geohash 图块会返回 externalId、boxType、coordinates 和 maxWeight；详情接口再补充 openingHours、flags、exchangePointId 和 canBeSelected。首页信息流还会以 nearby_branch 的形式带上最近网点及其 distanceFromOrigin。

与 Packeta 相似的应用

UPS — UPS 是联合包裹服务公司的官方 Android 客户端，用于追踪货件、预约取件和管理派送。
Почта России — Почта России 是俄罗斯邮政的官方 Android 客户端，用于追踪包裹、支付邮资和查找邮局。
Nova poshta (old) — Nova poshta (old) 是 Nova Poshta 面向乌克兰运单、网点查询和货到付款的长期 Android 客户端。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Packeta 数据 API

应用截图

API 端点一览

活跃包裹列表

包裹详情

已归档包裹

创建 C2C 运单

运费报价

跨境汇率

发起 PayU 银行卡支付

货到付款支付方式

自提点详情

按 geohash 查询附近自提点

首页信息流

最近网点

包裹追踪时间线

数据类别

数据使用场景与案例

末端配送的 Z-BOX PIN 同步

货到付款与 PayU 对账

自提点地图叠加层

跨境报价监控

常见问题

与 Packeta 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？

Packeta 数据 API

应用截图

API 端点一览

活跃包裹列表

包裹详情

已归档包裹

创建 C2C 运单

运费报价

跨境汇率

发起 PayU 银行卡支付

货到付款支付方式

自提点详情

按 geohash 查询附近自提点

首页信息流

最近网点

包裹追踪时间线

数据类别

数据使用场景与案例

末端配送的 Z-BOX PIN 同步

货到付款与 PayU 对账

自提点地图叠加层

跨境报价监控

常见问题

相关应用

与 Packeta 相似的应用

更多出行类应用

99 Motorista e Entregador

Amazon Flex

Australia Post

Borzo: Courier Delivery App

相关主题

需要集成这个 App 的数据 API？