Si gestionas precios mayoristas fuera de WordPress, puedes hacer la mayor parte a través de HTTP en lugar de en el administrador. La API de Wholesale Suite extiende la API REST de WooCommerce para que puedas leer y escribir productos mayoristas, variaciones, roles, descuentos y análisis desde tu propio código. Este artículo enumera lo que cubre cada grupo de puntos finales, qué plugin lo proporciona y dónde encontrar la referencia completa.
Requisitos
- WooCommerce Wholesale Prices 1.12 o posterior. Los puntos finales de lotes necesitan 1.16 o posterior.
- Los puntos finales de productos, variaciones y roles mayoristas se incluyen con WooCommerce Wholesale Prices, el plugin gratuito. No necesitas WooCommerce Wholesale Prices Premium para ellos.
- WooCommerce Wholesale Prices Premium 1.27 o posterior, para los puntos finales de descuentos mayoristas. La API Premium llegó en la versión 1.25, y los puntos finales de descuentos generales y de categoría llegaron en la 1.27. Los puntos finales de análisis también necesitan Premium.
- WooCommerce Wholesale Lead Capture 2.0 o posterior, para los puntos de conexión de clientes potenciales.
Wholesale Suite introduce un punto de conexión dedicado: wholesale/v1/ y wwlc/v1. Estos puntos de conexión te dan la flexibilidad de interactuar y gestionar aspectos clave de tu tienda mayorista de forma programática.
Características clave de la API de Wholesale Suite
- Productos mayoristas: lista, crea, actualiza o elimina productos mayoristas. Actualiza muchos a la vez con el punto final de lotes, wholesale/v1/products/batch, que necesita WooCommerce Wholesale Prices 1.16 o posterior.
- Variaciones mayoristas: lista, crea, actualiza o elimina las variaciones de un producto. El punto final de lotes es wholesale/v1/products/{product_id}/variations/batch.
- Roles mayoristas: lista y actualiza los roles que controlan quién obtiene qué precios. El plugin gratuito incluye un rol mayorista, y Premium añade la creación y eliminación.
- Leads mayoristas: lista, crea, actualiza o elimina leads mayoristas. Estos puntos finales vienen con WooCommerce Wholesale Lead Capture y usan el espacio de nombres wwlc/v1.
- Descuentos mayoristas: lee y establece descuentos a nivel de categoría y generales a través de los puntos finales category-discount y general-discount. Estos necesitan WooCommerce Wholesale Prices Premium 1.27 o posterior.
- Análisis mayoristas: recupera métricas de ventas mayoristas para productos, clientes o compras mayoristas generales. Estos se encuentran en su propio espacio de nombres, wholesale/v1/analytics, y necesitan Premium.
¿Por qué usar la API de Wholesale Suite?
Esta integración de API hace que la gestión de su tienda mayorista sea más flexible y fluida, especialmente si necesita automatizar o sincronizar sus datos mayoristas con otros sistemas o plataformas. Ya sea que esté administrando catálogos grandes, ajustando precios en bloque o personalizando roles de usuario, esta API le permite hacerlo todo sin tener que ajustar manualmente cada configuración en su panel de administración.
Primeros pasos con la API de Wholesale Suite
Para interactuar con la API de Wholesale Suite, utiliza Autenticación de la API REST de WordPress y los verbos HTTP estándar (GET, POST, PUT, DELETE). Puedes integrar esta funcionalidad con cualquier plataforma o sistema que admita solicitudes de API basadas en HTTP.
Para obtener detalles completos sobre el uso de la API de Wholesale Suite, incluidos los métodos, parámetros y solicitudes de ejemplo disponibles, consulte la documentación completa de la API.
Lista de permitidos de acciones de activación de la API REST
Wholesale Suite tiene un segundo punto final para ejecutar acciones de mantenimiento, como borrar cachés de productos. Se encuentra en el espacio de nombres wwp/v1, no en wholesale/v1, por lo que es fácil pasarlo por alto.
Envía una solicitud POST a /wp-json/wwp/v1/admin/action con un valor action en el cuerpo. La solicitud necesita acceso de administrador.
Cada nombre de acción debe estar en una lista de permitidos. Si no lo está, la respuesta vuelve con un estado de error y el mensaje Acción no válida. Una acción permitida ejecuta su manejador y devuelve un estado y un mensaje.
Estos nombres de acción están disponibles cuando el plugin correspondiente está activo:
- WooCommerce Wholesale Prices Premium: clear_var_prod_price_range_caching, clear_product_caching, clear_unused_product_meta, initialize_product_visibility_meta, force_fetch_update_data
- WooCommerce Wholesale Lead Capture: force_fetch_update_data, create_lead_pages
- WooCommerce Wholesale Order Form: schedule_database_optimization
Para agregar tu propia acción, regístrala con el filtro wwp_allowed_trigger_actions en PHP. Wholesale Suite también detecta cualquier hook cuyo nombre comience con wwp_trigger_ y trata el resto del nombre como una acción permitida. No puedes agregar un nombre de acción a través de la propia API REST.
add_filter( 'wwp_allowed_trigger_actions', function ( $actions ) {
$actions[] = 'my_custom_action';
return $actions;
} );
add_filter( 'wwp_trigger_my_custom_action', function ( $params ) {
// Run your task here.
return array(
'status' => 'success',
'message' => 'Custom action finished.',
);
} );Hay una segunda lista separada para las acciones de configuración de grupos. Utiliza el filtro wwp_allowed_group_actions y se ejecuta en el endpoint de guardado de configuraciones, /wp-json/wwp/v1/admin/save. Si tu acción guarda configuraciones, pertenece a esa lista en su lugar.
Ayuda y soporte
Contamos con un equipo de soporte dedicado para Wholesale Suite que conoce muy bien nuestros productos, WooCommerce y la industria. Le invitamos a aprovechar su experiencia en cualquier momento y en cualquier lugar del mundo.
Si es un cliente existente, vaya al formulario de solicitud de tickets de soporte y envíenos un mensaje.
Si es un usuario de plugin gratuito, envíenos una solicitud de soporte en el foro. Supervisamos activamente los foros de soporte de WordPress.org para el plugin gratuito y ayudamos a nuestros usuarios allí lo mejor que podemos.
