Pochta Rossii(俄罗斯邮政)数据 API
Почта России(Pochta Rossii)是俄罗斯联邦国家邮政运营商俄罗斯邮政的官方手机应用,其邮局网络覆盖全国各个地区。用户可按条形码跟踪信件和包裹,查看每件邮件的流转记录、寄件人与收件人、到付金额以及在网点的保管期限,还能在应用内接收电子挂号信(EZP)。附近邮局与自提点地图会显示营业时间、周六周日是否营业、临时停业情况、当前排队负载以及是否支持收件时付款,并可提前预约到访时段或加入网点的电子排队。寄件页面按重量和包裹尺寸报出两个邮编之间的国内邮资,随后可在线下单,并用已绑定的银行卡、一键支付或积分完成付款。除邮件业务外,它还是一个缴费中心:用户可查询并缴纳国家 GIS GMP 系统中的政务账单,例如凭驾驶证或车辆登记证查到的交通罚款、凭纳税人识别号(INN)查到的欠税,也可按收款人全名和手机号发起个人转账。账户可绑定俄罗斯国家政务服务统一登录 Gosuslugi(ESIA),开通简易电子签名、二维码身份和凭手机号取件,无需纸质通知单即可领取邮件;另有积分会员计划,记录积分的获得、使用与即将过期情况。它服务于俄罗斯家庭、领取电商平台订单的网购用户以及通过邮政发货的小卖家,与 CDEK、Boxberry、5Post、DPD 等私营承运商以及 GdePosylka 等多承运商跟踪工具竞争。
邮件跟踪记录以 barcode(查询时作为 rpoId)为键,携带 itemType、mailTypeName、weight、sender、recipient 与 destinationAddress,附有记录各项邮政作业的 historyItems 时间线、到付金额 forPayment、跨境邮件的 customsPaymentStatus、网点保管期限 storageTime 以及 showOfficeBookingButton 标志;登录后的邮件列表还会叠加电子挂号信的 ezpInfo。
围绕这些邮件的是全国网点目录——postalCode、typeCode、latitude/longitude、workingHours、worksOnSaturdays、worksOnSundays、isTemporaryClosed、实时负载 currentLoad、bookingAvailable 与 electronicQueue——以及返回 bookingId、reservationCode 和服务窗口 window 的时段预约。资费行按 mass、length、width、height 为 indexFrom 至 indexTo 之间的每种邮政产品定价,提交的邮资订单则返回新的 barcode、paymentURL 与 oneClickStatus。
按 vu(驾驶证)、sts(车辆登记证)、uin 或 inn 检索的政务账单返回 supplierBillID、收款方银行信息、kbk 与 oktmo 预算编码、offenseDate、优惠截止日 discountExpiry 以及 amountToPay;缴费结果落到 paymentReference 与 transferNumber,个人转账则返回 transferId。已绑定银行卡提供 visibleDigits、cardExpirationDate 与 paymentSystem,个人资料把 hid、marketPlaceId、linkedEsia、pepStatus 与积分账本关联起来,账本含 bonusBalance、burn 以及当月和累计的 received 与 spent。
第三方物流的末端异常处理台可盯住 storageTime 与 showOfficeBookingButton,在保管期届满前预约网点时段;电商结算页可按寄达邮编与重量报价邮资、下单并保存返回的条形码;财务任务可检索罚款与税款、支付 amountToPay,再把 paymentReference 与 transferNumber 对回 ERP;积分 CRM 可将 hid、marketPlaceId 与 bonusBalance 及每月获得/使用情况关联,触达积分即将清零的会员。openData Studio 将俄罗斯邮政的跟踪、网点、资费、账单与积分记录变为可调用的开放数据,正好支撑这些集成。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
按 RPO 跟踪包裹
GET
/v1/tracking/itemopendata按 rpoId 返回单个跟踪件:barcode、收发双方、destinationAddress、historyItems、海关/支付标记与 storageTime。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- rpoId
- currentDateTime
- triggeredByUser
- barcode
- itemName
- title
- itemType
- sender
- recipient
- destinationAddress
- weight
- forPayment
- mailTypeName
- complexCode
- customsPaymentStatus
- historyItems
- storageTime
- showOfficeBookingButton
GET /v1/tracking/item?rpoId=RA123456789RU¤tDateTime=2026-09-27T12:00:00&triggeredByUser=true HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "barcode": "RA123456789RU", "itemName": "Documents", "title": "Letter", "itemType": "LETTER", "sender": "Ivan Petrov", "recipient": "Anna Smirnova", "destinationAddress": "Moscow, Tverskaya 1", "weight": 120, "forPayment": 0, "mailTypeName": "Registered letter", "complexCode": "GRP-1", "customsPaymentStatus": "NONE", "historyItems": [{ "operationType": "ARRIVED", "operationPlace": "125167" }], "storageTime": 15, "showOfficeBookingButton": true }列出跟踪件
GET
/v1/tracking/itemsopendata返回登录用户的跟踪件(含 EZP 叠加),按 currentDateTime 与 filters[] 过滤。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- currentDateTime
- filters[]
- barcode
- itemName
- title
- sender
- recipient
- forPayment
- ezpInfo
GET /v1/tracking/items?currentDateTime=2026-09-27T12:00:00&filters[]=ACTIVE HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "items": [{ "barcode": "RA123456789RU", "itemName": "Documents", "title": "Letter", "sender": "Ivan Petrov", "recipient": "Anna Smirnova", "forPayment": 0, "ezpInfo": null }] }查找附近邮政网点
POST
/v1/offices/nearbyopendata提交地理搜索(latitude、longitude、searchRadius、top、type、hidePrivate),返回附近网点及其营业时间、负载与预约标记。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- searchRadius
- top
- type
- address
- geoObject
- hidePrivate
- latitude
- longitude
- filters[]
- postalCode
- distance
- addressSource
- typeId
- typeCode
- isClosed
- isTemporaryClosed
- worksOnSaturdays
- worksOnSundays
- regionSettlement
- bookingAvailable
- bookingHasEmptySlots
- workingHours
- currentLoad
POST /v1/offices/nearby HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9 Content-Type: application/x-www-form-urlencoded searchRadius=2000&top=20&type=ALL&latitude=55.7558&longitude=37.6173&hidePrivate=true¤tDateTime=2026-09-27T12:00:00{ "offices": [{ "postalCode": "125167", "latitude": 55.7881, "longitude": 37.5417, "distance": 410.2, "addressSource": "Leningradsky pr-t, 37", "typeId": 1, "typeCode": "OPS", "isClosed": false, "isTemporaryClosed": false, "worksOnSaturdays": true, "worksOnSundays": false, "regionSettlement": "Moscow", "bookingAvailable": true, "bookingHasEmptySlots": true, "workingHours": [{"weekDayId": 1}], "currentLoad": {"hour": 12, "load": 0.4} }] }附近自取点
GET
/v1/offices/pickupopendata列出 ukdIndex/经纬度附近的自取点,可按 paymentUponReceipt 过滤,含 electronicQueue。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- ukdIndex
- latitude
- longitude
- top
- currentDateTime
- paymentUponReceipt
- postalCode
- addressSource
- typeCode
- bookingAvailable
- electronicQueue
GET /v1/offices/pickup?ukdIndex=125167&latitude=55.7558&longitude=37.6173&top=10¤tDateTime=2026-09-27T12:00:00&paymentUponReceipt=false HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "offices": [{ "postalCode": "125167", "latitude": 55.7881, "longitude": 37.5417, "addressSource": "Leningradsky pr-t, 37", "typeCode": "PVZ", "bookingAvailable": true, "electronicQueue": {"available": true} }] }列出运输产品与服务
GET
/v1/tariffs/servicesopendata按给定重量与包裹尺寸,报价 indexFrom 与 indexTo 之间可用的国内产品/服务。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- indexFrom
- indexTo
- addressFrom
- addressTo
- mass
- length
- width
- height
- product
- way
- weight
- comment
- maxWeight
- needService
- services
- productOptions
GET /v1/tariffs/services?indexFrom=101000&indexTo=190000&addressFrom=Moscow&addressTo=Saint%20Petersburg&mass=500&length=20&width=15&height=10 HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "products": [{ "product": { "product": "PARCEL", "way": "GROUND", "weight": "UP_TO_2KG", "comment": "Parcel 1st class", "maxWeight": 2000.0, "needService": false, "services": ["SMS"], "productOptions": [] }, "services": {} }] }提交邮资订单
POST
/v1/tariffs/orderopendata创建邮资订单(sender/recipient、mass、product、way),返回 barcode 及 paymentURL / oneClickStatus。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- localDate
- indexFrom
- indexTo
- mass
- product
- way
- weight
- options
- service
- sender
- senderAddress
- senderPhone
- recipient
- recipientAddress
- recipientPhone
- value
- cashSumm
- cardUid
- bonus
- withDiscount
- barcode
- paymentURL
- successURL
- failedURL
- cancelURL
- sharedUrl
- paymentKind
- oneClickStatus
POST /v1/tariffs/order?localDate=2026-09-27T12:00:00 HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9 Content-Type: application/x-www-form-urlencoded indexFrom=101000&indexTo=190000&mass=500&product=PARCEL&way=GROUND&weight=UP_TO_2KG&options=&service=NONE&sender=Ivan%20Petrov&senderAddress=Moscow&recipient=Anna%20Smirnova&recipientAddress=Saint%20Petersburg&recipientAddressType=DEFAULT&withDiscount=false{ "barcode": "RA123456789RU", "paymentURL": "https://pay.example/checkout", "successURL": "https://pay.example/ok", "failedURL": "https://pay.example/fail", "cancelURL": "https://pay.example/cancel", "sharedUrl": "https://tracking.example/RA123456789RU", "paymentKind": "CARD", "oneClickStatus": "AVAILABLE" }获取账号资料
GET
/v1/account/profileosint读取登录资料:姓名、phone、email、hid、ESIA/PEP 标记、已校验地址与嵌套的 bonusProgram。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- firstName
- middleName
- lastName
- phone
- hid
- marketPlaceId
- isRegistered
- linkedEsia
- pepStatus
- qrIdentityEnabled
- isPassportValid
- parcelByPhoneStatus
- addressGuid
- index
- displayAddress
- addressHid
- normalizedAddressNoIndex
- validationStatus
- bonusProgram
- bonusBalance
GET /v1/account/profile HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "firstName": "Ivan", "middleName": "Sergeevich", "lastName": "Petrov", "phone": "+79001234567", "email": "[email protected]", "hid": "hid-9f3a", "marketPlaceId": "cust-441", "isRegistered": true, "linkedEsia": true, "pepStatus": "CONFIRMED", "qrIdentityEnabled": true, "isPassportValid": true, "parcelByPhoneStatus": "ENABLED", "address": { "addressGuid": "guid-1", "index": "101000", "displayAddress": "Moscow, Tverskaya 1", "addressHid": "addr-hid", "normalizedAddressNoIndex": "Tverskaya 1", "validationStatus": "VALID" }, "bonusProgram": { "state": "ACTIVE", "bonusBalance": 240.5 } }积分忠诚度资料
GET
/v1/loyalty/profileopenfinance返回完整忠诚度快照:bonusBalance、burn、currentMonthSummary/totalSummary 的收支,以及 c2cProfTariffs。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- bonusProgram
- state
- bonusBalance
- loyalty
- burn
- promotion
- currentMonthSummary
- totalSummary
- received
- spent
- c2cProfTariffs
GET /v1/loyalty/profile HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "bonusProgram": { "state": "ACTIVE", "bonusBalance": 240.5, "loyalty": {"level": "GOLD"}, "burn": {"amount": 12.0} }, "promotion": {"code": "SPRING"}, "currentMonthSummary": {"received": 40.0, "spent": 15.0}, "totalSummary": {"received": 800.0, "spent": 560.0}, "c2cProfTariffs": [] }列出已存支付卡
GET
/v1/wallet/cardsopenbanking列出已绑定卡片(id、visibleDigits、cardExpirationDate、paymentSystem),用于邮资与政务缴费支付。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- cards
- id
- visibleDigits
- cardExpirationDate
- paymentSystem
GET /v1/wallet/cards HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "cards": [{ "id": "card-uid-1", "visibleDigits": "1234", "cardExpirationDate": "12/28", "paymentSystem": "MIR" }] }搜索政务/税务账单
GET
/v1/charges/searchopenfinance按驾驶证(vu)、行驶证(sts)、uin 或 inn 搜索政务/税务账单,返回缴款人/收款方、kbk、oktmo 与 amountToPay。
认证方式: 会话令牌以 bearer 风格认证请求头发送;账单位于独立的支付命名空间。
- vu
- sts
- uin
- inn
- withEns
- payerIdentifier
- supplierBillID
- billDate
- payerName
- payeeInn
- payeeKpp
- payeeName
- payeeBankBik
- payeeCorrespondentBankAccount
- payeeBankName
- kbk
- oktmo
- totalAmount
- discount
- discountExpiry
- amountToPay
- offensePlace
- offenseDate
- legalAct
- purpose
GET /v1/charges/search?vu=99AA123456&sts=77AB123456&uin=18840327140123456789&inn=7700000000&withEns=true HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "charges": [{ "payerIdentifier": "18840327140123456789", "supplierBillID": "18840327140123456789", "billDate": "2026-03-01", "payerName": "PETROV IVAN", "payeeInn": "7700000000", "payeeKpp": "770001001", "payeeName": "GIBDD", "payeeBankBik": "044525000", "payeeCorrespondentBankAccount": "30101810400000000225", "payeeBankName": "Bank", "kbk": "18811630020016000140", "oktmo": "45348000", "totalAmount": 1500.0, "discount": 750.0, "discountExpiry": "2026-03-20", "amountToPay": 750.0, "offensePlace": "Moscow", "offenseDate": "2026-02-10", "legalAct": "12.9", "purpose": "Traffic fine" }] }创建政务缴费支付
POST
/v1/charges/paymentopenbanking为政务 uin 创建 CPS 支付(可选 cardUid),返回 paymentReference。
认证方式: 会话令牌以 bearer 风格认证请求头发送;账单位于独立的支付命名空间。
- uin
- cardUid
- transferNumber
- description
- redirectApprove
- redirectDecline
- redirectCancel
- paymentReference
POST /v1/charges/payment HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9 Content-Type: application/json { "uin": "18840327140123456789", "cardUid": "card-uid-1", "transferNumber": "TR-1001", "description": "GIS charge", "redirectApprove": "pochta://pay/ok", "redirectDecline": "pochta://pay/fail", "redirectCancel": "pochta://pay/cancel" }{ "paymentReference": "pay-9f3a1c" }创建政务转账
POST
/v1/charges/transferopenbanking按 TransferParams 创建政务转账,返回 transferNumber 及缴款人身份信息(passport、addressRegStr、mobilephone)。
认证方式: 会话令牌以 bearer 风格认证请求头发送,转账调用另附客户端与渠道请求头。
- idToken
- accessToken
- uin
- purpose
- transferSum
- payerIdentifier
- transferNumber
- firstName
- lastName
- middleName
- mobilephone
- mobileVrfStu
- birthDate
- passportSeries
- passportNumber
- passportIssueDate
- passportIssueId
- passportIssuedBy
- addressRegStr
- addressRegZipCode
POST /v1/charges/transfer HTTP/1.1 Authorization: Bearer <session-token> X-Client: ANDROID X-Channel-Flag: true Content-Type: application/json { "idToken": "<id-token>", "accessToken": "<access-token>", "uin": "18840327140123456789", "email": "[email protected]", "purpose": "Transfer", "transferSum": 1500.0, "payerIdentifier": "18840327140123456789" }{ "transferNumber": "TR-1001", "firstName": "Ivan", "lastName": "Petrov", "middleName": "Sergeevich", "mobilephone": "+79001234567", "mobileVrfStu": "VERIFIED", "birthDate": "1990-01-15", "passportSeries": "4500", "passportNumber": "123456", "passportIssueDate": "2015-06-01", "passportIssueId": "770-001", "passportIssuedBy": "OUFMS", "addressRegStr": "Moscow, Tverskaya 1", "addressRegZipCode": "101000" }创建 C2C 个人转账
POST
/v1/transfers/c2copenbanking创建个人对个人转账(senderId、amount、recipient 姓名/电话),返回 transferId;后续支付步骤得到 paymentLink。
认证方式: 在转账命名空间内,account-id 请求头携带汇款人资料的 hid。
- senderId
- amount
- password
- message
- senderEmail
- senderMobilePhone
- countryCode
- phoneNumber
- recipient
- fullName
- firstName
- lastName
- middleName
- mobilePhone
- transferId
POST /v1/transfers/c2c HTTP/1.1 X-Account-Id: hid-9f3a Content-Type: application/json { "senderId": 441001, "amount": 5000, "password": "secret", "message": "For postage", "senderEmail": "[email protected]", "senderMobilePhone": {"countryCode": "+7", "phoneNumber": "9001234567"}, "recipient": { "fullName": "Anna Smirnova", "firstName": "Anna", "lastName": "Smirnova", "middleName": "Igorevna", "mobilePhone": {"countryCode": "+7", "phoneNumber": "9007654321"} } }{ "transferId": 9001001 }预约网点到访
POST
/v1/offices/bookingopendata按 postalCode 为某个 serviceId 预约 OPS 网点时段,返回 bookingId、reservationCode 与 window。
认证方式: 会话令牌以 bearer 风格认证请求头发送,并附 API 版本请求头。
- postalCode
- slotId
- serviceId
- itemsCount
- bookingId
- reservationCode
- createdTime
- window
- viaElectronicQueue
- slot
- serviceParameters
POST /v1/offices/booking?postalCode=125167&slotId=slot-42&serviceId=3&itemsCount=1 HTTP/1.1 Authorization: Bearer <session-token> X-Api-Version: 9{ "bookingId": "bkg-7781", "postalCode": "125167", "reservationCode": "A104", "createdTime": "2026-09-27T12:05:00", "window": 4, "viaElectronicQueue": false, "slot": {"slotId": "slot-42"}, "serviceParameters": [{"serviceId": 3, "itemsCount": 1}] }
数据类别
- 包裹跟踪
- 邮政网点
- 运费资费
- 支付
- 转账
- 忠诚度计划
- 身份信息
数据使用场景与案例
末端异常处理台
第三方物流运营机器人可监控在途包裹的 storageTime 与 showOfficeBookingButton,随后预约 OPS 网点时段,让收件人在保管期届满前取件。
邮资报价引擎
电商结算页可按收发邮编与重量拉取国内产品/服务资费行,随后下单邮资订单并保存返回的 barcode。
政务账单缴费对账
财务任务可按 vu/sts/uin 搜索政务账单,支付 amountToPay,并把 paymentReference 与 transferNumber 对回 ERP。
忠诚度 CRM 叠加
CRM 可把资料中的 hid 与 marketPlaceId 同 bonusBalance 及月度收支汇总关联,定位有积分清零风险的会员。
常见问题
Pochta Rossii 数据 API 的结构是怎样的?
它是带版本、令牌认证的 JSON API。查询是带查询参数的普通 GET;搜索与下单/支付创建是 POST,有的表单编码、有的 JSON。跟踪、网点、资费、账号、银行卡、政务账单与转账各自处于独立的路径命名空间。
会话如何认证?
调用在 bearer 风格认证请求头中发送会话令牌,并附 API 版本请求头。敏感支付调用追加客户端与渠道请求头;个人对个人转账调用用取自资料的 account-id 请求头标识汇款人。
能否按条形码查询包裹?
可以。跟踪调用接收 rpoId(跟踪条形码)及 currentDateTime、triggeredByUser,返回 sender、recipient、destinationAddress、historyItems、forPayment 与 storageTime,足以渲染完整的投递时间线与任何待付金额。
API 是否包含支付与转账?
包含。政务账单可按驾驶证(vu)、行驶证(sts)、账单号(uin)或税号(inn)搜索后缴费;支付调用返回 paymentReference。个人对个人转账创建返回 transferId,后续支付调用返回 paymentLink。
与 Почта России 相似的应用
- СДЭК (CDEK) — СДЭК(CDEK)是俄罗斯的一家物流公司,可按运单号跟踪包裹,并通过遍布全国的自提点网络完成配送,是最常用的快递替代渠道。
- Boxberry — Boxberry 是俄罗斯一家以电商订单为主的配送服务商,拥有自己的自提点网络,现已并入 Yandex。
- ГдеПосылка (GdePosylka) — ГдеПосылка(GdePosylka)是一款包裹跟踪应用,可按运单号在一个列表中集中跟踪俄罗斯邮政及多家承运商的邮件。
- 5Post — 5Post 是俄罗斯的一项配送服务,包裹可在商店收银台领取,并可按运单号在线跟踪。
- DPD в России — DPD 是一家运输公司,在俄罗斯提供快递包裹与货物运输服务,可按订单号在线查询物流状态。
- UPS — UPS 是一家国际承运商,其移动应用可跟踪包裹与货运、创建运单并查找附近服务网点,适合跨境寄递需求。
相关主题
- pochta rossii api
- 俄罗斯邮政跟踪 API
- почта россии
- 包裹跟踪 API
- 邮政网点查询 API
- 运费资费 API
- 政务账单缴费
- C2C 转账 API
- 移动 JSON API
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业