Regole e limiti

Tutto ciò che è in questa pagina è stato verificato da capo a fondo su canali reali. Quando una regola viene violata l'API risponde 422 validation_failed (o il codice indicato) con un messaggio che nomina il campo. Non cambia nulla in silenzio.

Prodotti e varianti

• Uno SKU per variante. Stock, ordini e POST /inventory/batch abbinano le varianti per SKU, quindi due varianti di un prodotto non possono condividerne uno (422, Two variants share the SKU …).
• Ogni combinazione di opzioni. Un prodotto con Taglia S/M e Colore Rosso/Blu ha esattamente 4 varianti. Per aggiungere un colore, aggiungilo in ogni taglia; per togliere una taglia, toglila per ogni colore. I canali costruiscono la griglia completa, quindi una combinazione mancante comparirebbe lì come variante fantasma.
• Al massimo 3 opzioni e 100 varianti per prodotto.
• I prezzi hanno al massimo 2 decimali; le quantità sono numeri interi ≥ 0.
• Immagini: un prodotto deve avere almeno un'immagine per essere pubblicato (photo_required_for_channel). Fino a 20 per prodotto.
• L'eliminazione di un prodotto ancora presente su un canale viene rifiutata (422 product_still_listed), anche quando la sua inserzione è in error ma è ancora attiva lì. Prima rimuovilo dal canale (DELETE /listings/{id}).

Testi per canale

• PATCH /listings/{id} con overrides.title / overrides.description imposta il testo solo per quel canale; null torna a quello del prodotto.
• I titoli più lunghi di quanto consente il canale vengono rifiutati subito: Shopify 255, Etsy 140, eBay 80 caratteri.
• Un prodotto su un solo canale: modificare il titolo o la descrizione del prodotto cambia anche quelli del canale, ma solo il campo che hai modificato (una modifica della descrizione mantiene un titolo impostato per il canale).
• Un canale impostato come canale capo (le sue modifiche arrivano in Nembol) sovrascrive i testi del prodotto e quelli di ogni canale.
• Le descrizioni sono in HTML e arrivano ai canali come HTML.

Ordini

• Un ordine per ogni ordine del canale: un ordine con più righe torna come un solo ordine con tutte le righe in lines e il total completo; order.created scatta una volta per ordine.
• I nuovi ordini arrivano in pochi secondi via webhook dove il canale li invia, altrimenti al controllo successivo. I cambi di stato fatti sul canale (annullato, rimborsato, spedito altrove) arrivano entro 10 minuti.
• source_status è la stringa di stato propria del canale, come letta l'ultima volta.

Spedizione (POST /orders/{id}/fulfillment)

• mark_shipped senza tracking aggiorna solo Nembol: il marketplace non viene avvisato.
• Con un numero di tracking il marketplace viene avvisato una volta per ordine. Un tracking inviato più tardi (dopo mark_shipped) viene notificato in quel momento. Quando il marketplace ha già un tracking, un numero diverso viene salvato solo in Nembol e la risposta riporta channel_notification.error: channel_already_notified. Correggilo direttamente sul marketplace.
• tracking.number ≤ 64, carrier ≤ 64, url ≤ 512 caratteri: i valori più lunghi vengono rifiutati, mai troncati.
• Un ordine annullato o rimborsato non può essere segnato come spedito (order_not_fulfillable).

Connessioni ai canali

• Un link di collegamento funziona una sola volta e per un'ora.

• Amazon: params.country sceglie la regione; params.marketplace deve essere un marketplace di quella regione.

• I canali OAuth (eBay, Etsy, Shopify, WooCommerce, TikTok Shop, Temu, Amazon, Google Merchant Center, Facebook Catalog, Square, Squarespace, Faire, Wix, Facebook, Pinterest, Tumblr) si collegano tramite un link.

• Kaufland, OnBuy, PrestaShop e Subito si collegano con credenziali in params (senza link).

• La pubblicazione su eBay richiede le Business Policies: se l'account non ha aderito, POST /channel_accounts/{id}/enable_business_policies (con conferma).

• Un nuovo account del canale riceve le impostazioni predefinite del canale quando si collega, allo stesso modo tramite l'API e nella dashboard.

Tempi e limiti

• I rate limit e le Idempotency-Key sono per store (per azienda per i partner). Vedi Rate limit.
• Un'inserzione di solito diventa listed in pochi secondi; i marketplace che verificano i prodotti (Amazon, TikTok Shop) possono richiedere più tempo.

Ultimo aggiornamento il 20 ottobre 2026