Solo Platinum
L'accesso alla Public API richiede il piano Platinum su un negozio attivo, oppure Enterprise su un piano legacy. Una chiave per negozio.
BSS B2B Solution: Public API
Integrazione ERP con la Public API di BSS B2B Solution: chiavi, endpoint e limiti
La Public API di BSS B2B Solution permette al suo ERP, PIM o strumento personalizzato di creare, aggiornare ed eliminare regole Custom Pricing, Volume Pricing, Price List e Discount Code, gestire i moduli di registrazione e cercare clienti, prodotti e collezioni. Serve il piano Platinum su un negozio attivo e una chiave API per negozio. Non esiste un endpoint per gli ordini.
Installi BSS B2B Solution Torna a BSS B2B Solution Richiede il piano piano Platinum. BSS B2B Solution offre una prova gratuita di 14 giorni (piani a pagamento). 4,9 su 5 da 1.190 recensioni nello Shopify App Store (aggiornato al 19 ottobre 2026).
Come si ottiene una chiave API e si esegue la prima chiamata?
La chiave si configura nell'app. Le chiamate vengono fatte dal suo sviluppatore o dal partner di integrazione, seguendo le pagine degli endpoint nella guida utente.
-
Verifichi il piano
La Public API richiede il piano Platinum, oppure il piano Enterprise su un piano legacy. La chiave non può essere creata sugli altri piani.
-
Apra la scheda Public API
Nel menu dell'app clicchi Integrations e trovi la scheda Public API. Clicchi Get API key.
-
Generi la chiave e la conservi
Generi la chiave, poi clicchi subito Copy o Download. L'app la mostra una sola volta. La tratti come una password: chiunque la possieda può leggere i suoi dati B2B e chiamare gli endpoint di scrittura.
-
Attivi la funzione Public API
La pagina che contiene la chiave ha un controllo Public API function con un pulsante Enable. Le richieste, versione 1 e versione 2, vengono accettate solo mentre la funzione è attiva.
-
Invii la chiave con ogni richiesta
Per la versione 1 passi `accessKey` nel corpo della richiesta oppure l'header `x-bss-b2b-api-key`, insieme al `domain` del suo negozio. La versione 2 usa l'header `x-api-key`. Alcuni endpoint della versione 1 leggono la chiave solo dal corpo: gli endpoint di upload di Custom Pricing, Volume Pricing e Price List, `PUT /rule/delete-items`, `PUT /pl/delete-items` e `PUT /pl/update-items`. L'endpoint di upload di Discount Code legge la chiave solo dall'header `x-bss-b2b-api-key`.
-
Scriva le regole, poi le carichi
Crei o aggiorni le regole con gli endpoint di Custom Pricing, Volume Pricing o Price List. Poi chiami l'endpoint di upload del modulo, così le regole attive arrivano al tema live.
-
Controlli Logs and usage
Nella scheda Public API clicchi Logs and usage. Elenca le richieste recenti con stato, metodo e percorso, e può aprire una riga per vedere la richiesta e la risposta complete.
Generi una chiave API e faccia la prima chiamata con il piano Platinum. La scheda dell'app mostra una prova gratuita di 14 giorni (piani a pagamento).
Che cosa copre la Public API
Questo è ciò che la guida utente e il codice dell'app documentano, raggruppato per modulo. La guida utente ha una pagina con i payload per i gruppi Custom Pricing, Volume Pricing, Price List, Registration Form e upload.
| Modulo | Che cosa si può fare | Note |
|---|---|---|
| Custom Pricing | Leggere regole per dominio o ID, salvare, salvare in blocco, eliminare, eliminare in blocco, caricare e cercare regole per prodotti o per clienti. | Versione 1, percorso /rule/*. |
| Volume Pricing | Lo stesso insieme di Custom Pricing, senza le ricerche per prodotti e per clienti e senza delete-items. La versione 2 aggiunge GET /vp/rules. | Versione 1, percorso /qb/*. |
| Price List | L'insieme di Custom Pricing più update status, update, delete items e update items. | Versione 1, percorso /pl/*. |
| Discount Code | Leggere, creare ed eliminare regole, più un endpoint di upload. | Versione 1, percorso /dc/*. |
| Registration Form | Recuperare lo schema di un modulo, inviare una registrazione all'ingrosso, filtrare le richieste e cambiare lo stato delle richieste in attesa. | I cambi di stato funzionano solo per gli account in attesa. I moduli a più passaggi richiedono sempre un'email. |
| Order Limit | Leggere le regole e aggiornarne una. | Versione 1, percorso /ol/*. |
| Customers, products, collections | Cercare tag cliente, cercare clienti, ottenere clienti per ID o tag, elencare prodotti e collezioni. | Sola lettura. Non può creare o modificare clienti o prodotti tramite l'API. |
| Orders | Non disponibile. | Non esiste un endpoint per gli ordini. |
Fonte: il codice della Public API di BSS B2B Solution e la guida utente BSS per le Public API, verificati il 9 ottobre 2026.
Chiavi, header e versioni dell'API
Ogni negozio ha una chiave API. Se una chiave esiste già, l'app non ne crea una seconda. Per ruotarla, elimini la chiave nella scheda Public API, il che blocca subito ogni client che la usa, poi ne generi una nuova.
Le due versioni dell'API usano nomi di header diversi. La versione 1 (`/api/v1/...`) legge `x-bss-b2b-api-key`, oppure `accessKey` nel corpo. La versione 2 (`/api/v2/...`) legge `x-api-key`. Se integra più gruppi, controlli l'header per ogni endpoint. Non invii la chiave come `Authorization: Bearer`: la versione 2 risponde con `401 ACCESS_KEY_MISSING`. La versione 1 risponde con HTTP 200 e `success: false`, quindi legga il campo `success` e non solo lo stato HTTP.
- Versione 1: Custom Pricing, Volume Pricing, Price List, Discount Code, Registration Form, Order Limit, ricerche.
- Versione 2: GET /vp/rules per Volume Pricing (l'endpoint documentato).
- Anche i risultati parziali di un upload tornano con HTTP 200: controlli `status` o `success`.
Quali sono i limiti della Public API?
Limite di frequenza della versione 2
60 richieste ogni 60 secondi per negozio, con header X-RateLimit. Superarlo restituisce 429.
Upload: una volta ogni 5 minuti
Ogni endpoint di upload permette una richiesta per modulo ogni 5 minuti. Raggruppi le modifiche, poi carichi una volta sola.
Le scritture massive vengono eseguite una alla volta
Mentre una chiamata di salvataggio massivo, eliminazione massiva, delete-items o update-items è in corso per un negozio, le altre scritture massive in Custom Pricing, Price List e Volume Pricing restituiscono 429 con il messaggio che il dominio sta eseguendo un altro processo. Dopo un errore del server, attenda fino a 3 minuti.
Limite di storage nel tema
Le regole caricate vivono nei metafield di Shopify: 10 chiavi, 2.000.000 di caratteri per chiave, circa 20.000.000 in totale. Le regole oltre il limite vengono saltate ed elencate in un report partial_success. Vengono caricate solo le regole attive.
Nessun endpoint per gli ordini
L'API gestisce regole, registrazioni e ricerche. Non può creare, leggere o modificare ordini.
Clienti e prodotti in sola lettura
Può cercarli e leggerli. Per cambiare un tag cliente in base a un evento, usi Auto Tag nell'app.
Controlli il corpo della risposta
La versione 1 restituisce HTTP 200 per alcuni errori, e anche gli upload parziali restituiscono 200. Verifichi il campo success nel suo job.
Come si integra con il resto dell'app
L'API scrive gli stessi tipi di regole che crea nell'admin, quindi le regole Custom Pricing, Volume Pricing e Price List seguono l'ordine abituale nel carrello. Le regole Price List vengono verificate per prime, poi Custom Pricing, con Volume Pricing sopra. Le regole create tramite API compaiono negli elenchi dell'app accanto a quelle create a mano.
Inviare regole per acquirenti taggati si abbina bene con Auto Tag, che aggiunge i tag cliente a cui quelle regole si rivolgono. Se il suo listino cambia solo qualche volta all'anno, un import CSV è più semplice di un'integrazione.
Chi dovrebbe usarla
Distributori e produttori i cui prezzi, classi di prezzo o gruppi di clienti sono già in un ERP, un PIM o una pipeline di dati, e che hanno uno sviluppatore o un partner di integrazione per scrivere un job programmato. L'API si adatta ai cataloghi grandi, dove cambiare le regole a mano richiede troppo tempo.
Se nessuno nel suo team scrive codice, usi invece le schermate dell'admin o l'import CSV. La guida utente descrive l'API come un insieme di strumenti per sviluppatori e partner di integrazione, non come un connettore per un ERP specifico.
Quale piano include la Public API?
La Public API è nel piano Platinum. Nella scheda dell'App Store Shopify, al 9 ottobre 2026, Platinum costa 99 USD al mese, oppure 1.069,20 USD all'anno con uno sconto del 10% sulla fatturazione annuale. La scheda mostra una prova gratuita di 14 giorni sui piani a pagamento.
Casi d'uso per la Public API
Ogni caso d'uso mostra una configurazione con screenshot. Sfoglia tutti i casi d'uso.
Sincronizzare regole e clienti B2B con l’ERP tramite API
Usi la Public API di BSS B2B Solution per creare e aggiornare regole Custom Pricing, Price List, Volume Pricing e dati di registrazione dal Suo ERP o PIM con una chiave API, invece di modificare le regole a mano.
Esplora il caso d'uso: Sincronizzare regole e clienti B2B con l’ERP tramite API
Importare prezzi all’ingrosso da CSV
Esporti le regole sui prezzi, modifichi i prezzi in un foglio di calcolo e reimporti il file. Lo stesso flusso CSV funziona per Custom Pricing, Price Lists e Volume Pricing, quindi cataloghi grandi e molti gruppi di clienti restano gestibili.
Esplora il caso d'uso: Importare prezzi all’ingrosso da CSVGuide e glossario
Legga questi approfondimenti per tutti i dettagli.
Auto Tag
Tagghi gli acquirenti in base agli eventi, così si applicano le regole basate sui tag.
Manual Orders
Gli ordini si inseriscono nell'admin, non tramite l'API.
Prezzi wholesale
Mostri ai buyer business i propri prezzi con listini, prezzi personalizzati e scaglioni di quantità.
Onboarding dei clienti
Trasformi le richieste in buyer wholesale approvati con moduli di registrazione, approvazione e tag cliente.
Glossario
Integrazione ERPListino prezziTag cliente
Guide utente su docs.bss-b2b.solutions
Altre funzionalità di BSS B2B Solution
Ogni funzionalità ha una sua pagina. Veda anche tutte le funzionalità di BSS B2B Solution.
Auto Tag
Aggiungere o rimuovere tag su clienti e ordini quando un evento Shopify corrisponde alle regole, così prezzi e accessi basati sui tag seguono l'acquirente.
Discount codes
Dia agli acquirenti all'ingrosso un codice privato da inserire nel carrello, con regole su chi può usarlo, cosa copre e con quale frequenza.
Commissioni di gestione e tariffe di spedizione
Aggiungere una commissione di gestione per quantità o importo, e impostare tariffe di spedizione all'ingrosso per cliente, prodotto, mercato e peso.
Manual Orders
Creare un ordine bozza Shopify per un cliente dall'admin, con i suoi prezzi all'ingrosso già applicati.
Visualizzazione multi-valuta
Mostra i prezzi all'ingrosso nella valuta dell'acquirente con un selettore. Il checkout resta nella valuta del negozio o di Markets.
Prezzi POS di Shopify
Il riquadro B2B Price in Shopify POS mostra lo sconto all'ingrosso per il carrello. Il personale lo applica o lo rimuove dal riquadro.
Colleghi il suo ERP ai prezzi all'ingrosso
Installi BSS B2B Solution dallo Shopify App Store, con una prova gratuita di 14 giorni (piani a pagamento).
Anche: BSS B2B Lock per prezzi nascosti per gli ospiti e BSS B2B Quote per preventivi e quick order.
Domande frequenti
Quale piano include la Public API di BSS B2B Solution?
Il piano Platinum, oppure Enterprise su un piano legacy. Al 9 ottobre 2026 la scheda dell'App Store mostra Platinum a 99 USD al mese. Un negozio riceve una chiave API, che l'app mostra una sola volta.
Che cosa posso inviare alla Public API?
Regole Custom Pricing, Volume Pricing, Price List e Discount Code, invii di moduli di registrazione e cambi di stato, e aggiornamenti di Order Limit. Clienti, prodotti e collezioni possono essere letti e cercati ma non modificati.
La Public API può creare o leggere ordini?
No. Non esiste un endpoint per gli ordini. L'API gestisce regole di prezzo, registrazioni e ricerche. Per fare un ordine per un acquirente, usi Manual Orders nell'admin dell'app, che crea una bozza dell'ordine Shopify con i prezzi dell'acquirente.
Quali sono i limiti di frequenza?
La versione 2 permette 60 richieste ogni 60 secondi per negozio. Ogni endpoint di upload permette una richiesta per modulo ogni 5 minuti. Le scritture massive per un negozio vengono eseguite una alla volta, e le chiamate in più ricevono una risposta 429.
Come mi autentico, e posso usare un token Bearer?
Invii la chiave come `accessKey` nel corpo o in un header: x-bss-b2b-api-key per la versione 1, x-api-key per la versione 2. I token Bearer non sono supportati, quindi Authorization: Bearer fallisce con un 401 sulla versione 2.
Che cosa succede se perdo o divulgo la chiave API?
Elimini la chiave nella scheda Public API. I client che la usano smettono subito di funzionare. Poi generi una nuova chiave e la copi subito, perché viene mostrata una sola volta.
Fonti, metodo e registro degli aggiornamenti
Il comportamento delle funzioni si basa sulla nostra verifica del codice dell'app BSS B2B Solution del 3 ottobre 2026 e sulle guide utente BSS. Prezzi e valutazioni provengono dalla scheda dell'App Store alla data indicata. Realizziamo BSS B2B Solution, BSS B2B Lock e BSS B2B Quote.
Fonti
- Guida utente BSS: Public API, letto il . Piano, passaggi per la chiave, header, limiti di frequenza, log, limiti dei metafield.
- Guida utente BSS: Public API per l'upload, letto il . Endpoint di upload, capacità e report parziale.
- Guida utente BSS: Public API per Registration form, letto il . Endpoint di moduli e grossisti, cambi di stato solo per le richieste in attesa.
- Scheda Shopify App Store: BSS B2B Wholesale Pricing, letto il . Prezzi dei piani e prova gratuita.
Registro degli aggiornamenti
- : Prima versione.
- : Aggiunto un pulsante di installazione a metà pagina.
Installi BSS B2B Solution prova gratuita di 14 giorni (piani a pagamento)