Se gestisci i prezzi all'ingrosso al di fuori di WordPress, puoi fare la maggior parte delle operazioni tramite HTTP invece che nell'admin. L'API di Wholesale Suite estende la WooCommerce REST API in modo da poter leggere e scrivere prodotti all'ingrosso, varianti, ruoli, sconti e analisi dal tuo codice. Questo articolo elenca cosa copre ogni gruppo di endpoint, quale plugin lo fornisce e dove trovare il riferimento completo.
Requisiti
- WooCommerce Wholesale Prices 1.12 o versioni successive. Gli endpoint batch richiedono la versione 1.16 o successive.
- Gli endpoint per prodotti, varianti e ruoli all'ingrosso sono inclusi nel plugin gratuito WooCommerce Wholesale Prices. Non è necessario WooCommerce Wholesale Prices Premium per utilizzarli.
- WooCommerce Wholesale Prices Premium 1.27 o versioni successive, per gli endpoint degli sconti all'ingrosso. L'API Premium è arrivata con la versione 1.25, e gli endpoint per sconti per categoria e generali sono arrivati con la versione 1.27. Anche gli endpoint di analisi richiedono la versione Premium.
- WooCommerce Wholesale Lead Capture 2.0 o versioni successive, per gli endpoint dei lead.
Wholesale Suite introduce un endpoint dedicato: wholesale/v1/ e wwlc/v1. Questi endpoint ti offrono la flessibilità di interagire e gestire programmaticamente gli aspetti chiave del tuo negozio all'ingrosso.
Funzionalità principali dell'API di Wholesale Suite
- Prodotti all'ingrosso: elenca, crea, aggiorna o elimina prodotti all'ingrosso. Aggiorna molti prodotti contemporaneamente con l'endpoint batch, wholesale/v1/products/batch, che richiede WooCommerce Wholesale Prices 1.16 o versioni successive.
- Varianti all'ingrosso: elenca, crea, aggiorna o elimina le varianti di un prodotto. L'endpoint batch è wholesale/v1/products/{product_id}/variations/batch.
- Ruoli all'ingrosso: elenca e aggiorna i ruoli che controllano chi ottiene quali prezzi. Il plugin gratuito fornisce un ruolo all'ingrosso, mentre la versione Premium aggiunge la creazione e l'eliminazione.
- Lead all'ingrosso: elenca, crea, aggiorna o elimina lead all'ingrosso. Questi endpoint sono inclusi in WooCommerce Wholesale Lead Capture e utilizzano lo spazio dei nomi wwlc/v1.
- Sconti all'ingrosso: leggi e imposta sconti a livello di categoria e sconti generali tramite gli endpoint category-discount e general-discount. Questi richiedono WooCommerce Wholesale Prices Premium 1.27 o versioni successive.
- Analisi all'ingrosso: recupera metriche di vendita all'ingrosso per prodotti, clienti o acquisti all'ingrosso generali. Questi si trovano nel loro spazio dei nomi, wholesale/v1/analytics, e richiedono la versione Premium.
Perché utilizzare l'API di Wholesale Suite
Questa integrazione API rende la gestione del tuo negozio all'ingrosso più flessibile e fluida, specialmente se hai bisogno di automatizzare o sincronizzare i tuoi dati all'ingrosso con altri sistemi o piattaforme. Sia che tu stia gestendo grandi cataloghi, modificando prezzi in blocco o personalizzando ruoli utente, questa API ti consente di fare tutto senza dover modificare manualmente ogni impostazione nella tua dashboard di amministrazione.
Iniziare con l'API di Wholesale Suite
Per interagire con l'API di Wholesale Suite, utilizza l'autenticazione REST API di WordPress e i verbi HTTP standard (GET, POST, PUT, DELETE). Puoi integrare questa funzionalità con qualsiasi piattaforma o sistema che supporti richieste API basate su HTTP.
Per dettagli completi sull'utilizzo dell'API Wholesale Suite, inclusi metodi, parametri e richieste di esempio disponibili, consulta la documentazione API completa.
Elenco consentito di azioni trigger REST API
Wholesale Suite ha un secondo endpoint per l'esecuzione di azioni di manutenzione, come la pulizia delle cache dei prodotti. Si trova nello spazio dei nomi wwp/v1, non in wholesale/v1, quindi è facile perderlo.
Invia una richiesta POST a /wp-json/wwp/v1/admin/action con un valore action nel corpo. La richiesta richiede l'accesso da amministratore.
Ogni nome di azione deve essere in una whitelist. Se non lo è, la risposta torna con uno stato di errore e il messaggio Azione non valida. Un'azione consentita esegue il suo gestore e restituisce uno stato e un messaggio.
Questi nomi di azione sono disponibili quando il plugin corrispondente è attivo:
- 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
Per aggiungere la tua azione, registrala con il filtro wwp_allowed_trigger_actions in PHP. Wholesale Suite rileva anche qualsiasi hook il cui nome inizia con wwp_trigger_ e tratta il resto del nome come un'azione consentita. Non puoi aggiungere un nome di azione tramite la REST API stessa.
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.',
);
} );Esiste una seconda lista separata per le azioni delle impostazioni di gruppo. Utilizza il filtro wwp_allowed_group_actions e viene eseguita sull'endpoint di salvataggio delle impostazioni, /wp-json/wwp/v1/admin/save. Se la tua azione salva le impostazioni, appartiene a quella lista.
Aiuto e supporto
Abbiamo un team di supporto dedicato per Wholesale Suite che conosce molto bene i nostri prodotti, WooCommerce e il settore. Sei il benvenuto a sfruttare la loro esperienza in qualsiasi momento, in tutto il mondo.
Se sei un cliente esistente, vai al modulo di richiesta ticket di supporto e inviaci un messaggio.
Se sei un utente di plugin gratuiti, inviaci una richiesta di supporto sul forum. Monitoriamo attivamente i forum di supporto di WordPress.org per il plugin gratuito e aiutiamo i nostri utenti lì al meglio delle nostre capacità.
