Tài chính fulfillment
Khả dụng: Sandbox / Gateway MOCK is live.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/fulfillment/balance | Get Fulfillment Balance |
| GET | /v1/fulfillment/transactions | List Transactions |
| GET | /v1/fulfillment/transactions/{id} | Get Transaction |
| POST | /v1/fulfillment/invoices | Create overseas invoice |
| GET | /v1/fulfillment/invoices | List overseas invoices |
| GET | /v1/fulfillment/invoices/{id} | Get Invoice |
| GET | /v1/fulfillment/invoices/{id}/download | Download Invoice |
Amounts use monetary_unit: CNY_minor. Create invoices from AVAILABLE transaction_ids only.
Danh sách giao dịch — bộ lọc
All query params are optional. Enum filters are single-value only (no comma multi-select). Invalid enum → 422.
| Param | Match | Allowed values / notes |
|---|---|---|
type | Exact | CREDIT · DEBIT · REFUND · ADJUSTMENT |
category | Exact | TOP_UP · PROCUREMENT · SHIPPING · VALUE_ADDED_SERVICE · RETURN · STORAGE · TRANSFER · REFUND · MANUAL_ADJUSTMENT · OTHER |
invoice_status | Exact | NOT_INVOICED · AVAILABLE · INVOICE_PENDING · INVOICED |
related_resource_type | Exact | PACKAGE · SHIPMENT · RETURN · SERVICE_REQUEST · INBOUND |
related_resource_id | Exact | Related object id |
created_from / created_to | Range on created_at | ISO-8601 |
page / page_size | Pagination | Default 1 / 20, max page_size 100 |
GET /v1/fulfillment/transactions?category=SHIPPING&invoice_status=AVAILABLE&page=1&page_size=20Danh sách hóa đơn — bộ lọc
All query params optional. status is single-value only. Invalid enum → 422.
| Param | Match | Allowed values / notes |
|---|---|---|
status | Exact | PENDING · ISSUED · REJECTED · CANCELLED |
created_from | created_at >= | ISO-8601 (request time) |
created_to | created_at <= | ISO-8601 |
issued_from | issued_at >= | ISO-8601; rows without issued_at are excluded |
issued_to | issued_at <= | Same exclusion rule |
page / page_size | Pagination | Default 1 / 20, max page_size 100 |
created_* and issued_* can be combined (AND). For downloadable invoices use status=ISSUED.
GET /v1/fulfillment/invoices?status=ISSUED&issued_from=2026-08-01T00:00:00Z&page=1&page_size=20Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days