Autorización del portal
Después de que tu app sea aprobada, autoriza canales en el portal de desarrolladores antes de llamar a las API de compras o fulfillment.
Hay dos capas de elección:
- Modo de fulfillment — si HioBuy almacena y envía internacionalmente
- Modo de procurement (solo cuando el fulfillment de almacén está activado) — quién compra en Taobao / 1688 / Weidian
Modo de fulfillment (por app)
| Modo | Quién conserva la vinculación de almacén | Envío internacional (/v1/fulfillment/*) |
|---|---|---|
| Self fulfillment (predeterminado) | Ninguna — tú gestionas la logística | No disponible (403) |
| Almacén HioBuy | Un código de desarrollador de almacén | Disponible — Resumen de fulfillment |
Las rutas de API públicas se mantienen iguales (/v1/products/*, /v1/orders/*, …). El Gateway enruta según los modos de tu app.
Procurement bajo fulfillment de almacén
Cuando eliges Almacén HioBuy, el procurement admite dos opciones. El almacenamiento y el envío internacionales funcionan en ambas; solo cambia quién realiza los pedidos de compra en el marketplace.
| Modo de procurement | Quién compra en el marketplace | Tokens de canal | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy procurement (predeterminado) | HioBuy compra por ti | Emitidos por la autorización del almacén; el Gateway los almacena | Enrutado vía procurement del almacén HioBuy | El Gateway usa tokens almacenados → marketplace |
| Self procurement | Tú compras con tus propias cuentas | Tú gestionas OAuth / credenciales en el portal | Gateway → marketplace con tus tokens (igual que el flujo self clásico) | Igual — tus tokens |
| Capacidad | HioBuy procurement | Self procurement |
|---|---|---|
| Vincular el código de almacén una vez | Sí | Sí |
| Entrada al almacén / paquetes / VAS / devoluciones | Sí | Sí |
| Envíos internacionales y monedero | Sí | Sí |
| OAuth del marketplace gestionado por ti | No | Sí (por canal) |
Cambiar entre estas dos opciones de procurement puede borrar o volver a emitir tokens de canal; el portal te pedirá confirmación.
Self fulfillment (sin almacén HioBuy)
Para cada canal habilitado (Taobao, 1688, Weidian, …):
- Abre Authorizations → selecciona app → Authorize
- Pega credenciales OAuth o completa OAuth cuando esté disponible
- El portal muestra estado, nombre de cuenta y caducidad; nunca tokens completos
/v1/fulfillment/* no está disponible en este modo.
Fulfillment con almacén HioBuy (configuración)
- Obtén un warehouse developer code de operaciones de HioBuy
- Portal → Authorizations → elige Use HioBuy fulfillment
- Elige el modo de procurement: HioBuy procurement o self procurement
- Introduce el código de almacén una vez — la vinculación es a nivel de app (no por canal)
- Si HioBuy procurement: el portal lista el estado de cada canal y
expires_at(los tokens no son visibles ni editables) - Si self procurement: completa tú mismo el OAuth / la entrada de credenciales por canal; la vinculación de almacén solo desbloquea las API de fulfillment
Volver a self fulfillment elimina la vinculación de almacén; se te pedirá confirmación.
Lo que nunca envías en llamadas API
- Tokens de acceso del marketplace
- Warehouse developer code (el Gateway lo adjunta del lado del servidor)
Solo Authorization: Bearer hio_live_… (o hio_test_…) en https://api.hiobuy.com.
Siguiente: Resumen de fulfillment · Pedidos
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days