Integrazione dropshipping

Documentazione di esempio — senza credenziali. · StockFashion24 / Brands Illusion

Questa copia serve a studiare l'integrazione prima di procedere: YOUR-API-KEY sta per il token personale che riceverai, insieme ai tuoi link personali, una volta concordata l'integrazione. Niente qui dà accesso a prodotti o ordini.

1. Feed dei prodotti

Tutto il catalogo che puoi vendere, aggiornato in tempo reale dalla nostra giacenza. Scaricalo quando vuoi (qualche volta al giorno è la norma). Tre formati, stessi dati:

https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/products.csv
https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/products.xml
https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/products.json

Un esempio senza chiave (poche righe vere, formato identico, prezzi illustrativi): csv · xml · json

Le lingue si configurano sul tuo account e viaggiano affiancate nello stesso file: chiedicele e trovi name[en] accanto a name[it], name[de]… per nomi, reparti, colori, categorie e attributi. Di serie c'è solo l'inglese.

Colonne (CSV separato da ;, stessi nomi in XML/JSON):

ColonnaSignificato
code / skuCodice prodotto e la variante esatta (taglia) da ordinare.
department[en]Percorso completo, es. Women>Bags>Handbag.
name[en]Nome del prodotto.
shortDescription[en], longDescription[en]Descrizioni — solo se attivate per te. Possono contenere HTML semplice (grassetto, elenchi): serve un lettore CSV che rispetti i campi tra virgolette.
image1…image10La galleria fotografica, formato grande.
barredPricePrezzo al pubblico consigliato (RRP).
dropshippingPriceIl tuo prezzo per questo articolo (l'eventuale sconto extra concordato è già applicato).
gender[en], category1..3[en]Classificazione.
ean, size, sizeCountry, color[en], brandDati della variante.
stockPezzi disponibili adesso. Vendi solo ciò che c'è qui.
composition[en], madeIn[en], season[en], variationTypeAltri dati del prodotto.

2. File delle sole giacenze

Leggero e veloce: scaricalo anche ogni pochi minuti per tenere fresche le quantità senza rileggere tutto il catalogo. Elenca tutti gli articoli attivi, anche quelli a zero, così puoi spegnere ciò che si è esaurito:

https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/stock.csv
https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/stock.xml
https://brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-API-KEY/stock.json

Esempio senza chiave: csv · xml · json

Colonne: sku;ean;stock;dropshippingPrice.

3. Inviare un ordine

POST https://brands-core-734536366699.europe-west1.run.app/dropship/api/orders
X-Api-Key: YOUR-API-KEY
Content-Type: application/json

{
  "reference": "PO-2026-001",
  "notes": "warehouse opening hours 9-17",
  "shipping_address": {
    "companyName": "Retailer Srl",
    "firstName": "Mario", "lastName": "Rossi",
    "street1": "Via Roma 1", "city": "Milano",
    "postalCode": "20100", "stateProv": "MI", "country": "IT",
    "phoneNumber": "+39 ..."
  },
  "lines": [
    {"sku": "397330-08-8", "qty": 1},
    {"ean": "4067979171632", "qty": 2}
  ]
}

Regole:

Risposta in caso di successo:

{"success": true, "number": "16281", "id": 13112,
 "orders": [{"number": "16281", "id": 13112, "ships_from": "IT"}]}

4. Stato dell'ordine

GET https://brands-core-734536366699.europe-west1.run.app/dropship/api/orders/16281
X-Api-Key: YOUR-API-KEY
{"success": true, "number": "16281", "status": "Shipped",
 "reference": "PO-2026-001", "date": "2026-08-12",
 "total": 33.0, "pieces": 3.0, "tracking": "1Z999AA10123456784"}

Stati: Open → In preparation → Ready → Shipped → Delivered → Completed (oppure Cancelled); non ogni ordine passa da tutti. tracking è il numero di spedizione quando c'è, altrimenti null.

5. Errori

CodiceSignificato
401Token mancante, sbagliato o disattivato.
400Nessuna riga nell'ordine.
422SKU/EAN sconosciuto: la risposta li elenca.

6. Ambiente di prova (sandbox)

Per collaudare l'integrazione senza toccare merce e ordini veri c'è un ambiente di prova: stesse chiamate, stessi formati, dati finti (un catalogo di circa cento prodotti con prezzi di fantasia). Chiedici la chiave sandbox: vale SOLO sull'indirizzo qui sotto, e la chiave di produzione non vale lì.

Base URL sandbox: https://sandbox---brands-core-734536366699.europe-west1.run.app

https://sandbox---brands-core-734536366699.europe-west1.run.app/dropship/feed/YOUR-SANDBOX-KEY/products.csv
POST https://sandbox---brands-core-734536366699.europe-west1.run.app/dropship/api/orders
GET  https://sandbox---brands-core-734536366699.europe-west1.run.app/dropship/api/orders/16281
X-Api-Key: YOUR-SANDBOX-KEY

Domande: marco@brandsillusion.eu