Borzo 发件数据 API：报价、银行卡、统计

INCRIN LIMITED · 出行

Borzo: Courier Delivery App 是 INCRIN LIMITED 的同城即时配送发件端，也就是全球 Borzo/Dostavista 给家庭和中小商家用的下单应用：填写取件点与一个或多个送达点、选车型、确认报价，用已绑银行卡或钱包充值付款，再在地图上跟踪骑手并在完成后评分。地址簿会记下门禁与最后一百米备注，优惠码可减免运费，统计页汇总月度花费。上架市场包括巴西、印度、印度尼西亚、墨西哥、韩国和越南（印度、韩国、巴西另有地区客户端），和 Porter、Lalamove、Dunzo 以及各地末端运力台一样服务发件人，而不是骑手结算端。

多点同城件上的 payment_amount 与在途 status_category、骑手 masked_phone 写在同一张运单上，地址簿还留下 entrance_number 与 invisible_mile_navigation_instructions 供最后一百米使用；车型行带 max_weight_kg 与 is_create_order_allowed。

已绑卡给出 bank_card_number_mask 与 is_last_used，钱包充值按 bill_provider 返回 payment_url；月度花费汇总为 total_orders_price 与 average_address_price，件数折扣档给出 completed_deliveries 对 total_discount。车队看板、商家发件台和钱包对账把这些对象接进 ETA、预付余额提醒和城市件量。openData Studio 将其变成可调用的开放数据。

应用截图

API 端点一览

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

发送验证短信

POST /v1/borzo/otp/dispatch osint

向 phone 发送一次性短信（VerificationCodeRequest），供个人登录提交 code；force_sms 可绕过推送。

认证方式：无需登录。设备 ID 请求头标识手机；此时还没有会话令牌。

phone
source
device_id
push_token
force_sms
push_service
is_successful
errors
parameter_errors
session
server_time

POST /v1/borzo/otp/dispatch HTTP/1.1
Content-Type: application/json
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "phone": "+5511987654321",
  "source": "login",
  "device_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "push_token": "fcm:dK3_…",
  "force_sms": true,
  "push_service": "fcm"
}

{
  "is_successful": true,
  "errors": [],
  "parameter_errors": null,
  "session": null,
  "server_time": "2026-10-05T12:00:08Z"
}

个人登录

POST /v1/borzo/session/person osint

用 phone、password 与短信 code 登录发件人，返回 session 以及用户卡片（user_id、balance）。

认证方式：无需登录。设备 ID 请求头标识手机；此时还没有会话令牌。

phone
password
code
is_successful
session
server_time
user
user_id
name
surname
middlename
email
balance
unread_notifications_category_ids

POST /v1/borzo/session/person HTTP/1.1
Content-Type: application/json
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "phone": "+5511987654321",
  "password": "••••••••",
  "code": "482911"
}

{
  "is_successful": true,
  "errors": [],
  "parameter_errors": null,
  "session": "dv-sess-7f21c0a4",
  "server_time": "2026-10-05T12:01:22Z",
  "user": {
    "user_id": 4410281,
    "name": "Ana",
    "surname": "Costa",
    "middlename": null,
    "phone": "+5511987654321",
    "email": "[email protected]",
    "balance": "128.50",
    "unread_notifications_category_ids": []
  }
}

客户资料

GET /v1/borzo/account/card openbanking

重载已登录发件人卡片，钱包 balance 为 Money 字符串。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

is_successful
session
server_time
user
user_id
name
surname
middlename
phone
email
balance
unread_notifications_category_ids

GET /v1/borzo/account/card HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "session": "dv-sess-7f21c0a4",
  "server_time": "2026-10-05T12:02:01Z",
  "user": {
    "user_id": 4410281,
    "name": "Ana",
    "surname": "Costa",
    "middlename": null,
    "phone": "+5511987654321",
    "email": "[email protected]",
    "balance": "128.50",
    "unread_notifications_category_ids": ["orders"]
  }
}

计算运单报价

POST /v1/borzo/quotes/preview opendata

按 filling_id、form_type 与 addresses 给多点同城件报价，在下单前返回 payment_amount。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

filling_id
order_id
form_type
matter
promo_code
back_payment_method
addresses
address_id
address
latitude
longitude
contact_phone
delivery_interval_start
payment_amount
undiscounted_payment_amount
backpayment_amount
payment_method
warnings
parameter_errors
create_orders_count
is_user_created
payment_data

POST /v1/borzo/quotes/preview HTTP/1.1
Content-Type: application/json
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "filling_id": "fill-9f3a1c",
  "order_id": null,
  "form_type": "same_day",
  "matter": "Documents",
  "promo_code": null,
  "back_payment_method": null,
  "addresses": [
    {
      "address_id": null,
      "address": "Av. Paulista 1578, Sao Paulo",
      "latitude": -23.5614,
      "longitude": -46.6565,
      "contact_phone": "+5511987654321",
      "delivery_interval_start": "2026-10-05T14:00:00"
    },
    {
      "address": "Rua Augusta 2690, Sao Paulo",
      "latitude": -23.5533,
      "longitude": -46.6589,
      "contact_phone": "+5511912345678",
      "delivery_interval_start": "2026-10-05T15:30:00"
    }
  ]
}

{
  "is_successful": true,
  "order": {
    "id": null,
    "name": null,
    "form_type": "same_day",
    "status": null,
    "status_category": null,
    "payment_amount": "42.90",
    "undiscounted_payment_amount": "42.90",
    "backpayment_amount": "0.00",
    "payment_method": "balance"
  },
  "warnings": [],
  "parameter_warnings": null,
  "errors": [],
  "parameter_errors": null,
  "create_orders_count": 1,
  "is_user_created": false,
  "payment_data": null,
  "promo_code_warnings": []
}

创建运单

POST /v1/borzo/jobs/book opendata

提交已报价运单，返回 order id、status_category 以及可选的 payment_data 跳转地址。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

filling_id
form_type
matter
payment_method
addresses
id
name
status
status_category
created_at
payment_amount
undiscounted_payment_amount
backpayment_amount
is_user_created
create_orders_count
payment_data
payment_url
redirect_success_url
redirect_fail_url

POST /v1/borzo/jobs/book HTTP/1.1
Content-Type: application/json
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "filling_id": "fill-9f3a1c",
  "form_type": "same_day",
  "matter": "Documents",
  "payment_method": "balance",
  "addresses": [
    {
      "address": "Av. Paulista 1578, Sao Paulo",
      "latitude": -23.5614,
      "longitude": -46.6565,
      "contact_phone": "+5511987654321",
      "delivery_interval_start": "2026-10-05T14:00:00"
    },
    {
      "address": "Rua Augusta 2690, Sao Paulo",
      "latitude": -23.5533,
      "longitude": -46.6589,
      "contact_phone": "+5511912345678",
      "delivery_interval_start": "2026-10-05T15:30:00"
    }
  ]
}

{
  "is_successful": true,
  "order": {
    "id": 91827364,
    "name": "DV-91827364",
    "form_type": "same_day",
    "status": "new",
    "status_category": "undelivered",
    "created_at": "2026-10-05T12:05:11Z",
    "payment_amount": "42.90",
    "undiscounted_payment_amount": "42.90",
    "backpayment_amount": "0.00",
    "payment_method": "balance"
  },
  "warnings": [],
  "errors": [],
  "create_orders_count": 1,
  "is_user_created": false,
  "payment_data": {
    "payment_url": null,
    "redirect_success_url": null,
    "redirect_fail_url": null
  }
}

进行中运单与骑手

GET /v1/borzo/jobs/live opendata

分页拉取进行中运单（getActiveOrders，status_category=undelivered）以及地图用的 couriers 列表。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

status_category
offset
limit
orders
id
name
form_type
status
created_at
payment_amount
couriers
masked_phone
photo_url
is_deaf_mute
vehicle_number
vehicle_region
latitude
longitude

GET /v1/borzo/jobs/live?status_category=undelivered&offset=0&limit=20 HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "orders": [
    {
      "id": 91827364,
      "name": "DV-91827364",
      "form_type": "same_day",
      "status": "courier_assigned",
      "status_category": "undelivered",
      "created_at": "2026-10-05T12:05:11Z",
      "payment_amount": "42.90"
    }
  ],
  "couriers": [
    {
      "id": 55201,
      "name": "Joao",
      "phone": "+5511999887766",
      "masked_phone": "+55 11 9****7766",
      "photo_url": "https://cdn.example/img",
      "is_deaf_mute": false,
      "vehicle_number": "BRA2E19",
      "vehicle_region": "SP",
      "latitude": -23.5571,
      "longitude": -46.6610
    }
  ]
}

取消运单

POST /v1/borzo/jobs/void opendata

按 order_id 与 cancel_reason 取消已下运单（先做取消资格校验）。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

order_id
cancel_reason
is_successful
errors
parameter_errors
session
server_time

POST /v1/borzo/jobs/void HTTP/1.1
Content-Type: application/json
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "order_id": 91827364,
  "cancel_reason": "sender_cancelled"
}

{
  "is_successful": true,
  "errors": [],
  "parameter_errors": null,
  "session": "dv-sess-7f21c0a4",
  "server_time": "2026-10-05T12:18:44Z"
}

银行卡列表

GET /v1/borzo/wallet/instruments openfinance

列出已存卡（BankCardDto），含 bank_card_number_mask 与 is_last_used，供结账选用。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

bank_cards
bank_card_id
bank_card_number_mask
type
is_last_used
expiration_date
provider

GET /v1/borzo/wallet/instruments HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "bank_cards": [
    {
      "bank_card_id": 8812,
      "bank_card_number_mask": "**** 4444",
      "type": "visa",
      "is_last_used": true,
      "expiration_date": "2028-09",
      "provider": "cardpay"
    }
  ]
}

请求绑定银行卡

POST /v1/borzo/wallet/instruments/enroll openfinance

发起托管绑卡，BankCardBindingResponse 返回 binding_url、success_url 与 fail_url。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

binding_url
success_url
fail_url
is_successful

POST /v1/borzo/wallet/instruments/enroll HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "binding_url": "https://pay.example/bind/8812",
  "success_url": "https://cdn.example/img",
  "fail_url": "https://cdn.example/img"
}

请求钱包充值

POST /v1/borzo/wallet/credit openfinance

按 bill_provider 与 amount 发起钱包充值，返回托管 payment_url 以及 success/failure/callback 地址。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

bill_provider
amount
method
payment_url
success_url
failure_url
callback_url

POST /v1/borzo/wallet/credit HTTP/1.1
Content-Type: application/json
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "bill_provider": "pix",
  "amount": "100.00"
}

{
  "is_successful": true,
  "method": {
    "bill_provider": "pix",
    "payment_url": "https://pay.example/topup/8812",
    "success_url": "https://cdn.example/img",
    "failure_url": "https://cdn.example/img",
    "callback_url": "https://pay.example/callback"
  }
}

运单统计

GET /v1/borzo/spend/monthly opendata

返回按月与累计发件花费：orders_count、total_orders_price、average_order_price、average_address_price。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

monthly_statistics
year
month
orders_count
total_orders_price
average_order_price
average_address_price
total

GET /v1/borzo/spend/monthly HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "monthly_statistics": [
    {
      "year": 2026,
      "month": 9,
      "orders_count": 18,
      "total_orders_price": "612.40",
      "average_order_price": "34.02",
      "average_address_price": "17.01"
    }
  ],
  "total": {
    "orders_count": 86,
    "total_orders_price": "3012.10",
    "average_order_price": "35.02",
    "average_address_price": "16.80"
  }
}

客户地址簿

GET /v1/borzo/address-book opendata

加载发件人地址簿，含最后一百米字段 entrance_number、floor_number、apartment_number 与 invisible_mile_navigation_instructions。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

client_addresses
title
phone
note
address
latitude
longitude
entrance_number
floor_number
apartment_number
invisible_mile_navigation_instructions

GET /v1/borzo/address-book HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "client_addresses": [
    {
      "title": "Office",
      "phone": "+5511987654321",
      "note": "Ask reception",
      "address": "Av. Paulista 1578, Sao Paulo",
      "latitude": -23.5614,
      "longitude": -46.6565,
      "entrance_number": "B",
      "floor_number": "12",
      "apartment_number": "1204",
      "invisible_mile_navigation_instructions": "Use the loading bay on Rua Augusta"
    }
  ]
}

地址联想

GET /v1/borzo/places/autocomplete opendata

取送地址输入联想：formatted_address、place_id、is_final_address 以及 geo_suggestion_provider。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

query
address_suggestions
formatted_address
street_level_address
city_level_address
is_final_address
latitude
longitude
place_id
is_final_address_detection_available
geo_suggestion_provider

GET /v1/borzo/places/autocomplete?query=Av.%20Paulista%201578 HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "address_suggestions": [
    {
      "formatted_address": "Av. Paulista 1578, Bela Vista, Sao Paulo - SP",
      "street_level_address": "Av. Paulista 1578",
      "city_level_address": "Sao Paulo - SP",
      "is_final_address": true,
      "latitude": -23.5614,
      "longitude": -46.6565,
      "place_id": "ChIJpaulista1578"
    }
  ],
  "is_final_address_detection_available": true,
  "geo_suggestion_provider": "google"
}

车型目录

GET /v1/borzo/fleet/classes opendata

列出可下单车型（VehicleTypeDto），含 max_weight_kg 与 is_create_order_allowed，供下单表使用。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

vehicle_types
vehicle_type_id
name
client_mobile_app_local_name
description
tags
max_weight_kg
default_weight_kg
sort_order
is_create_order_allowed
is_default
is_require_loading_enabled
is_motobox_required_enabled
is_cargo_dimension_enabled
is_insurance_visible
is_total_weight_editable

GET /v1/borzo/fleet/classes HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "vehicle_types": [
    {
      "vehicle_type_id": 12,
      "name": "Bike",
      "client_mobile_app_local_name": "Moto",
      "description": "Up to 20 kg",
      "tags": ["same_day"],
      "max_weight_kg": 20,
      "default_weight_kg": 5,
      "sort_order": 1,
      "is_create_order_allowed": true,
      "is_default": true,
      "is_require_loading_enabled": false,
      "is_motobox_required_enabled": true,
      "is_cargo_dimension_enabled": false,
      "is_insurance_visible": true,
      "is_total_weight_editable": true
    }
  ]
}

优惠码
GET /v1/borzo/offers/lookup opendata
查询优惠码（PromoCodeDto），返回 discount_absolute_amount 与 min_total_order_amount。
认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。
- promo_code
- discount_absolute_amount
- min_total_order_amount
- is_successful
```
GET /v1/borzo/offers/lookup?code=BORZO20 HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
```
```
{
  "is_successful": true,
  "promo_code": {
    "promo_code": "BORZO20",
    "discount_absolute_amount": 20.0,
    "min_total_order_amount": 50.0
  }
}
```

件数折扣档

GET /v1/borzo/loyalty/tiers opendata

返回发件人件数折扣阶梯：period 的 start/end，以及 steps 中的 completed_deliveries、total_deliveries 与 total_discount。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

state
period
start
end
steps
completed_deliveries
total_deliveries
total_discount

GET /v1/borzo/loyalty/tiers HTTP/1.1
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "is_successful": true,
  "state": {
    "period": {
      "start": "2026-09-01",
      "end": "2026-09-30"
    },
    "steps": [
      {
        "completed_deliveries": 18,
        "total_deliveries": 25,
        "total_discount": "40.00"
      }
    ]
  }
}

评价运单

POST /v1/borzo/jobs/feedback opendata

在送达评价提示之后提交送达评价（oid、rating、comment、rating_ground_ids）。

认证方式：个人登录返回的会话令牌，外加设备 ID 请求头。

oid
rating
comment
rating_ground_ids
is_successful
errors
session
server_time

POST /v1/borzo/jobs/feedback HTTP/1.1
Content-Type: application/json
X-Session: dv-sess-7f21c0a4
X-Device-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890

{
  "oid": 91827364,
  "rating": 5,
  "comment": "On time",
  "rating_ground_ids": ["punctual"]
}

{
  "is_successful": true,
  "errors": [],
  "parameter_errors": null,
  "session": "dv-sess-7f21c0a4",
  "server_time": "2026-10-05T16:40:02Z"
}

数据类别

身份
运单
报价
骑手跟踪
银行卡
钱包充值
地址簿
地理编码
运单统计
车型
优惠码
件数折扣

数据使用场景与案例

报价与成交运费对账
发件台把同一组地址交给报价预览，记下 payment_amount 与 undiscounted_payment_amount，再和成交运单比对，在派骑手前暴露优惠码与到付差额。
在途骑手看板
调度屏按 status_category=undelivered 拉取进行中运单，关联 couriers 列表，持续标绘 masked_phone、vehicle_number、latitude 与 longitude，直到状态翻转。
钱包与绑卡运维
财务机器人列出 bank_card_number_mask，同步 is_last_used，用绑卡返回的 binding_url 加卡，并在余额不够下一单报价时打开钱包充值返回的 payment_url。
城市花费与件数档
月度花费（orders_count、total_orders_price、average_address_price）配上件数折扣档的 completed_deliveries 与 total_discount，对照地址簿看件量，不必去翻统计页。

常见问题

Borzo 发件端暴露哪些对象？

带会话的资料（user_id、phone、balance），含 payment_amount 与 status_category 的报价/成交运单，带 masked_phone 与实时坐标的 couriers 列表，已存 client_addresses、地理建议、vehicle_types、promo_code、bank_cards、件数折扣档以及月度花费汇总。

发件会话如何鉴权？

个人登录返回的 session 之后作为会话请求头发送，并始终带上设备 ID。短信登录提交 phone、force_sms、push_token，此时还没有 session。

报价能否和成交运单对上？

可以。报价预览与下单共用 filling_id、form_type 和 addresses；成交运单保留 payment_amount、undiscounted_payment_amount 与 is_user_created，方便对比报价和实收。

绑卡和钱包字段在哪？

已存卡列出 bank_card_id、bank_card_number_mask、expiration_date 与 is_last_used。绑卡返回 binding_url、success_url 与 fail_url。钱包充值接受 bill_provider 与 amount，返回 payment_url、success_url、failure_url 与 callback_url。

与 Borzo: Courier Delivery App 相似的应用

Porter - Logistics Service App — 印度同城货运发件端，按车型报价并带客户钱包，是目录里最接近 Borzo 的发件应用。
Dostavista — работа курьером — INCRIN/Dostavista 的俄罗斯骑手端，同一产品家族，侧重批次与结算而非发件报价。
Lalamove — 多个亚洲城市的即时面包车/摩托车叫车，发件流程与 Borzo 重叠。
Dunzo — 印度超本地发件应用，跑腿与包裹和 Borzo 常出现在同一张发件台上。
Shadowfax — 印度末端运力市场，D2C 品牌在同城即时件上也会用到。

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

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

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

获取报价

Borzo 发件数据 API：报价、银行卡、统计

应用截图

API 端点一览

发送验证短信

个人登录

客户资料

计算运单报价

创建运单

进行中运单与骑手

取消运单

银行卡列表

请求绑定银行卡

请求钱包充值

运单统计

客户地址簿

地址联想

车型目录

优惠码

件数折扣档

评价运单

数据类别

数据使用场景与案例

报价与成交运费对账

在途骑手看板

钱包与绑卡运维

城市花费与件数档

常见问题

与 Borzo: Courier Delivery App 相似的应用

更多出行类应用

Amazon Flex

Careem Captain

Dostavista — работа курьером

Lyft Driver

相关主题

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