Inicio rápido de la API de proveedores de Accplanet: productos, pedidos y actualizaciones de entrega

By Olivia Chen

septiembre 13, 2026 Buyer Tips 👁 138 vistas

Accplanet Supplier API API key api design principles supplier product API create update delete product API supplier order API update delivery API upload product image API

Accplanet Supplier API quick start

Authenticate with X-API-Key, manage products, list orders, and update delivery through the Supplier REST API.

Create an API key
Generate a supplier API key in Profile → API key and send it as the X-API-Key header.
Create or update products
Use /products/api/supplier/create/ and /products/api/supplier/products/{id}/update/ with JSON bodies from the live docs.
Fulfill orders
List /orders/api/supplier/orders/ and POST delivered updates for each order id. Cache GETs and back off on 429.

Si vendes en Accplanet y quieres automatización, la Accplanet Supplier API es una superficie REST para productos, pedidos y actualizaciones de entrega. Esta guía rápida lleva a un vendedor desde la configuración de la clave API hasta crear / actualizar / eliminar productos, listar pedidos y marcar la entrega — sin reemplazar la documentación completa de la Supplier API.

Accplanet es el marketplace; tu cuenta de proveedor posee los listados y el cumplimiento. Los scripts se autentican con una clave API en el encabezado X-API-Key.

En resumen

Genera una clave API en tu perfil de Accplanet; envíala como X-API-Key en cada llamada a la Supplier.
Bucle de productos: crear → listar/actualizar campos de stock → eliminar al retirar un SKU.
Bucle de pedidos: listar pedidos de proveedor → actualizar la información de entrega → cambiar el estado cuando tu proceso lo requiera.
Prefiere rutas sin prefijo como /products/api/supplier/… para POST (evita que la redirección de idioma convierta POST en GET).
Cachea las lecturas; respeta HTTP 429 y Retry-After.

Obtén tu clave API

Inicia sesión con una cuenta habilitada como proveedor, abre Perfil → Clave API y genera una clave API. Para la integración de vendedor de Accplanet, cada solicitud debe verse así:

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Guarda la clave en un almacén de secretos. Rótala si alguna vez se imprimió en un portátil o en un registro de CI.

Principios de diseño de API para la sincronización del vendedor

Los endpoints de proveedor siguen principios comunes de diseño de API que mantienen predecible la sincronización con ERP o almacén:

URLs de recursos: los productos y los pedidos son recursos REST separados en lugar de un único endpoint mega-acción.
Autenticación por encabezado: X-API-Key mantiene las credenciales fuera de las cadenas de consulta en los registros de acceso.
JSON de entrada / JSON de salida: los cuerpos de creación y actualización están estructurados; las cargas usan multipart/form-data.
Hábitos idempotentes: actualiza por id de producto; usa las marcas de fusión de entrega con cuidado para no borrar líneas de entrega previas.

Productos: crear, actualizar, eliminar

1 · Crear

Crear producto API

Haz POST a la API de creación de producto del proveedor. Los nombres de los campos y los ids de categoría requeridos están documentados en vivo — comienza desde el probador de la documentación después de poder autenticarte.

curl -X POST https://accplanet.com/products/api/supplier/create/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Example listing\",\"price\":\"9.99\",\"category_id\":\"CATEGORY_ID\"}"

Reemplaza el JSON con el payload completo de la documentación de la Supplier API. Trata el ejemplo anterior como un recordatorio de la forma, no como un esquema completo.

2 · Listar / actualizar

Listar productos y actualizar por id

curl -X GET https://accplanet.com/products/api/supplier/products/ \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST https://accplanet.com/products/api/supplier/products/PRODUCT_ID/update/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"price\":\"8.50\"}"

Usa la actualización para el precio, los campos relacionados con el stock y los cambios de descripción que tu tienda ya admita. Prefiere actualizar un id de producto existente antes que crear duplicados.

3 · Eliminar

Retirar un listado

curl -X POST https://accplanet.com/products/api/supplier/products/PRODUCT_ID/delete/ \
  -H "X-API-Key: YOUR_API_KEY"

Confirma en el panel de administración o con una llamada de listado posterior que el producto se eliminó o quedó inactivo según lo definan las reglas de tu cuenta.

Pedidos y actualizaciones de entrega

Listar pedidos

GET /orders/api/supplier/orders/ para la API de pedidos de proveedor. Filtra por estado en tu trabajo de sincronización; no sondees más rápido que una vez por minuto por clave.

Actualizar entrega

POST /orders/api/supplier/orders/{order_id}/delivered/ para enviar las líneas de cuenta entregadas. Al fusionar, sigue la documentación de append_delivered_info para no reemplazar filas previas por error.

Estado / reembolsos

Existen endpoints dedicados de estado y reembolsos bajo el mismo árbol de pedidos de proveedor. Conéctalos solo después de que las actualizaciones de entrega sean estables.

curl -X GET "https://accplanet.com/orders/api/supplier/orders/" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST https://accplanet.com/orders/api/supplier/orders/ORDER_ID/delivered/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"delivered_info\":\"[\\\"line1\\\",\\\"line2\\\"]\",\"append_delivered_info\":true}"

Valida el payload exacto de entrega contra la documentación en vivo — los formatos de entrega varían según el tipo de producto.

Subir imágenes de productos

Usa la API de carga de imágenes de producto con datos de formulario multipart:

curl -X POST https://accplanet.com/products/api/supplier/upload-image/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "image=@./cover.webp"

Reutiliza la URL devuelta en los payloads de creación/actualización cuando tu esquema espere una ruta de imagen.

Límites de velocidad

Las lecturas, escrituras y cargas REST del proveedor se rigen por presupuestos separados por minuto (las lecturas suelen ser los más ajustados para sondeadores ingenuos). Para la integración de vendedor de Accplanet:

Cachea las listas GET de productos y pedidos.
Agrupa las actualizaciones de la interfaz en lugar de hacer llamadas de listado por clic.
Ante un 429, respeta Retry-After antes de reintentar cargas o escrituras.

Lista de verificación del proveedor

Clave API en X-API-Key; secretos no comprometidos.
Ruta de producto crear → actualizar → eliminar probada en un SKU de sandbox.
Lista de pedidos + actualización de entrega verificadas con un id de pedido real o de staging.
La carga de imágenes funciona antes de los trabajos de importación masiva.
Backoff para 429 implementado.