Inicio rápido de la API para proveedores: crear, actualizar y eliminar productos y cumplir pedidos
Los equipos de proveedores que sincronizan catálogos en Accplanet necesitan un ciclo claro: crear o actualizar productos, mantener el stock honesto, cumplir con los pedidos y gestionar reembolsos o tickets cuando algo sale mal. Esta guía de inicio rápido recorre ese ciclo usando la documentación de la API de proveedor en vivo.
Accplanet es un mercado de agregación de proveedores. Tú cumples con el inventario; la plataforma gestiona el descubrimiento de compradores, el pago, el seguimiento y las herramientas de soporte. Usa estos endpoints únicamente para operaciones legítimas de catálogo y pedidos — no para evadir políticas ni automatización insegura.
En resumen
- Autentícate con
X-API-Key,Authorization: Bearer, el cuerpokey/apikeyo una sesión activa del panel de proveedor. - Productos: sube imagen → crea → lista/actualiza → añade cuentas de entrega automática → elimina solo cuando las reglas lo permitan.
- Pedidos: lista → obtén → actualiza información de entrega / adjunto → cambia estado → reembolsa cuando corresponda.
- Los listados nuevos pueden requerir aprobación del administrador antes de aparecer públicamente.
- Mantén la documentación oficial abierta para rutas exactas y tablas de parámetros mientras programas.
Autenticación
Usa tu clave de API de proveedor desde tu perfil. Las llamadas JSON de productos/pedidos normalmente envían:
X-API-Key: TU_CLAVE_API
Content-Type: application/jsonLa autenticación por sesión del navegador también funciona cuando has iniciado sesión en el panel de proveedor — útil con el panel de prueba de API de la documentación.
Ciclo de vida del producto
1 · Primero
Subir imagen
POST /products/api/supplier/upload-image/ con archivo de imagen multipart. Guarda el image_path devuelto para el array images al crear/actualizar.
2 · Crear
Crear producto (o actualizar por URL de origen)
POST /products/api/supplier/create/ requiere category_id, title, description, price. Opcional: stock, min_quantity, images, source_product_id, source_product_url, warranty_period_days, status y grupos de entrega automática mediante accounts o accounts_text.
Si source_product_url coincide con un artículo anterior de tu cuenta, la API puede actualizar ese artículo en lugar de crear un duplicado (marcadores created/updated en la respuesta). Observa approval_status.
3 · Mantener
Listar, consultar, actualizar
GET /products/api/supplier/products/— lista paginada con filtros de búsqueda, categoría, estado y precio.GET /products/api/supplier/products/by-source-id/<source_product_id>/— ruta rápida para sincronización en caliente por ID ascendente.POST /products/api/supplier/products/<product_id>/update/— actualiza título, precio, stock, imágenes, campos de origen, estado o campos del grupo de entrega.
Identifica productos por ID de catálogo numérico o product_id de las respuestas de lista. Los compradores luego ven los IDs de catálogo como valores service de la API de cliente cuando se asignan.
4 · Grupo de entrega
Añadir cuentas de entrega automática
POST .../products/<product_id>/accounts/ agrega credenciales al grupo de entrega automática sin reescribir el stock listado. Usa objetos accounts estructurados o líneas accounts_text (user:pass / user|pass). Maneja el accounts_imported devuelto con cuidado — son secretos.
5 · Eliminar
Eliminar cuando esté permitido
POST .../products/<product_id>/delete/ elimina permanentemente un producto sin ventas completadas. Prefiere cambios de estado cuando solo necesites dejar de vender.
| Enfoque del endpoint | Ruta del método (host accplanet.com) | Uso típico |
|---|---|---|
| Subir imagen | POST /products/api/supplier/upload-image/ |
Obtener image_path |
| Crear | POST /products/api/supplier/create/ |
Nuevo listado / actualización por URL de origen |
| Listar | GET /products/api/supplier/products/ |
Estado de sincronización |
| Por ID de origen | GET .../by-source-id/<id>/ |
Sincronización en caliente |
| Actualizar | POST .../products/<id>/update/ |
Precio, stock, texto |
| Añadir cuentas | POST .../products/<id>/accounts/ |
Grupo de entrega automática |
| Eliminar | POST .../products/<id>/delete/ |
Eliminar SKU no utilizado |
Ciclo de vida del pedido
Después de que los compradores compren, cumple con los pedidos a través de las APIs de pedidos:
- Listar —
GET /orders/api/supplier/orders/constatus,searchy paginación opcionales. - Obtener —
GET /orders/api/<order_id>/cuando necesites una instantánea de un pedido. - Entregar —
POST .../orders/<order_id>/delivered/condelivered_info(texto plano o cadena de array JSON). Estableceappend_delivered_info=truepara añadir filas. O sube un archivo mediante.../delivery-attachment/(multipartfile, ≤10MB). - Estado —
POST .../orders/<order_id>/status/con valores permitidos comopending_order,running_order,completed_order,refunded_order.receipt_confirmed_orderno se puede establecer mediante API. - Reembolso —
POST .../orders/<order_id>/refund/para un reembolso completo cuando tu proceso lo requiera.
Rastrea delivered_units, remaining_to_deliver y los campos de pago de las respuestas de lista/obtención para que tu lógica de almacén coincida con el panel.
Grupo de entrega automática
Precarga cuentas en el producto; Accplanet puede poner en cola tareas de entrega.
delivered_info manual
Envía credenciales o claves por pedido cuando el cumplimiento se gestiona manualmente.
Adjunto
Sube un único archivo de cumplimiento cuando los campos de texto no sean suficientes.
Tickets, pagos, saldo
- Tickets — lista, obtén, crea (
order_id+ título + descripción), actualiza estado/respuesta en/orders/api/supplier/tickets/. - Pagos —
GET /orders/api/supplier/payments/para registros de pago de tus pedidos suministrados. - Saldo —
GET /users/api/balance/devuelve los saldos de billetera de cliente y proveedor para la cuenta autenticada.
El estado de aprobación, el stock y los estados de pedido siguen las reglas en vivo de la plataforma. Confirma el comportamiento contra la documentación actual de la API de proveedor cuando implementes sincronización en producción.
Lista de verificación del proveedor
- [ ] Clave de API de proveedor almacenada en el servidor
- [ ]
category_idmapeado desde las categorías de Accplanet (subcategoría hoja cuando sea requerida) - [ ] Ruta de crear/actualizar probada primero con un título no productivo
- [ ] Actualizaciones de stock y precio idempotentes en tu trabajo de sincronización
- [ ] Grupo de entrega o ruta manual de
delivered_infoverificada en un pedido de prueba - [ ] Transiciones de estado de pedido coinciden con los valores permitidos en el panel
- [ ] Rutas de tickets y reembolsos documentadas para tu equipo de soporte
Siguiente paso: abre la documentación de la API de proveedor, autentícate con la API de prueba, crea un producto borrador y luego practica listar → entregar → estado en un pedido tipo sandbox. Los compradores que integren compras deben usar la guía de inicio rápido de la API de cliente en el blog de Accplanet.
Preguntas frecuentes
¿Por qué mi producto nuevo no es visible para los compradores?
Los listados pueden requerir aprobación del administrador (approval_status). Mantén el artículo active solo cuando estés listo para vender y confirma la aprobación en la respuesta o el panel.
¿Cuál es la diferencia entre product_id y business_id?
product_id es el identificador del sistema usado en las rutas de proveedor. business_id es el ID de catálogo numérico cuando se asigna — los compradores a menudo lo ven como service en la API de cliente.
¿Añadir cuentas cambia el stock listado?
No. Añadir cuentas actualiza el grupo de entrega automática. Gestiona el stock listado mediante campos de crear/actualizar por
