Tutte le informazioni riguardanti la gestione del progetto nell'implementazione attuale e come possiamo aiutarti si trovano qui e qui. Ricorda che tutto ciò che riguarda l’API si trova nella relativa pagina di documentazione.
Queste 2 diapositive riassumono la maggior parte delle informazioni di cui hai bisogno:
Alcuni punti chiave da ricordare
-
Autenticazione: è necessario un Bearer token per ogni ambiente (Sandbox e Produzione) per accedere ai dati dei vostri prodotti. Per ottenerlo, accedete alla piattaforma, andate su My Account, poi nella scheda Token API, oppure rivolgetevi al vostro referente IT.
- Proprietà della Sandbox: per impostazione predefinita, la Sandbox è vuota e si riempie man mano che esegui i tuoi test. Sarà pulita su tua richiesta prima di eseguire i prossimi test.
- Ordine di creazione: rispetta sempre l'ordine di creazione degli oggetti: SUPPLIER → (eventualmente PACKAGINGS) → PRODUCTS → COMPONENTS..
- Unicità degli attributi:
- Uno studio Fairly Made è identificato in modo univoco da tre attributi: productRef, productCollectionRef e productColorCode.
- Attualmente, un componente è considerato unico solo sulla base del suo ComponentRef. Se lo stesso componente viene utilizzato in diverse categorie o esiste presso più fornitori, ti consigliamo di concatenare altri campi all'interno del ComponentRef per garantire la sua unicità, se necessario
- Limitazioni:
- Non inviare più di 500 richieste al secondo, la nostra infrastruttura le bloccherà e alcune informazioni potrebbero non essere inviate correttamente.
- Aspetta 2-5 secondi tra la creazione di oggetti diversi affinché le relazioni appropriate tra di essi si stabiliscano (non inviare un supplier, component, product nello stesso batch. Invia prima tutti i suppliers, attendi 4 secondi, poi invia tutti i products, attendi 4 secondi, e infine invia tutti i components).
-
BatchImport: rispetta il nome batchImport per facilitare l'archiviazione e la risoluzione dei problemi. Esempio: NomeMarchio-Collezione-NumeroOnda-DataInvio
- Cronologia degli errori: conserva le risposte di errore.
Requisti
Per ogni oggetto, ecco i requisiti (puoi trovarli nella documentazione):
Suppliers
4 attributi di dati richiesti e 8 campi opzionali:
- category
- supplierRef
- contact_email
- address_country
Packaging
L'invio dei dati di imballaggio è facoltativo, ma se desideri trasmetterli, sono necessari 9 attributi di dati:
- packagingRef
- type
- channel (STORE / E-COMMERCE)
- percentageRecycled
- compostability
- ecoModulation
- possibilityReUse
- hazardousSubstances
Products
7 attributi di dati richiesti e 10 campi opzionali:
- productRef
- productCollectionRef
- category
- supplierRef
- warehouseRef
- reachCompliance (risposta predefinita: “1”)
- ecoModulation
- productColorCode: opzionale, ma sarà riempito con “DEFAULT” se vuoto, poiché è uno dei 3 attributi di unicità di uno studio.
- weight: opzionale, ma fortemente raccomandato, contribuirà al punteggio.
Components
4 attributi di dati richiesti e 13 campi opzionali:
- componentRef
- type
- category
- composition
- component_weight: opzionale, ma fortemente raccomandato, contribuirà al punteggio.
Se hai altre domande, suggerimenti o necessità di chiarimenti, invia un'e-mail a guillaume.babule@fairlymade.com o clotilde.bazin@fairlymade.com. Potete anche fissare un appuntamento con noi direttamente tramite questo link.