Pochta Rossii(俄罗斯邮政)数据 API
Pochta Rossii(Почта России)登录后接入带版本、令牌认证的 JSON API。包裹历史走 GET /v1/tracking/item;附近网点提交到 POST /v1/offices/nearby;资费在 GET /v1/tariffs/services 报价、在 POST /v1/tariffs/order 下单。政务账单位于 /v1/charges/ 下,个人对个人转账位于 /v1/transfers/ 下。
这个邮政客户端里藏着出乎意料多的银行能力。/v1/account/profile 返回寄件人姓名、电话,以及同时充当 C2C 转账键的 hid,外加 linkedEsia 与 pepStatus 身份标记。/v1/loyalty/profile 携带 bonusBalance 与月度收支汇总,/v1/wallet/cards 则按 visibleDigits 与有效期列出已存 MIR 卡。连网点到访也走 API:/v1/offices/booking 接收 postalCode、slotId 与 serviceId,返回 bookingId、reservationCode 与窗口号。
Pochta Rossii 是俄罗斯邮政的客户应用,覆盖邮件跟踪、网点查询、邮资报价、政务缴费与个人转账。登录流量走带版本、令牌认证的 JSON API:包裹记录以 rpoId 为键(barcode、historyItems、forPayment),地理网点目录含 postalCode、workingHours、bookingAvailable,另有国内外资费、用户资料(hid、linkedEsia、bonusProgram)、已存银行卡、按 vu/sts/uin/inn 搜索的政务账单与 C2C 创建/支付。
应用截图
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 }依据应用界面推导;端点细节为示意说明,并非实际抓包。
依据应用的个人对个人转账填写流程重建响应 id 对应创建后展示的转账回执
预约网点到访
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 与 approveId。
相关主题
- pochta rossii api
- 俄罗斯邮政跟踪 API
- почта россии
- 包裹跟踪 API
- 邮政网点查询 API
- 运费资费 API
- 政务账单缴费
- C2C 转账 API
- 移动 JSON API
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业