Passa al contenuto
Italiano
  • Non sono presenti suggerimenti perché il campo di ricerca è vuoto.

Guida pratica: la tabella di marcia per implementare l’API Fairly Made®

Sviluppo dell'integrazione API: fasi e spiegazioni

La nostra roadmap tipo

Ecco la roadmap tipo per implementare l'API in 4 mesi, suddivisi equamente tra Preparazione e Test. Questa durata può variare a seconda delle risorse disponibili nella tua azienda. Puoi completare qui la diagnostica di dati Fairly Made per identificare le tue esigenze.

planning-1

Di solito pianifichiamo 2 mesi di preparazione, che consistono in:

  • Presentazione del processo e revisione della documentazione API
  • Data Mapping & Gap Analysis
  • Transcodifica

Seguono uno o due mesi di sviluppo della connessione API, e infine almeno un mese di test:

  • Definizione dell’approccio ai test
  • Preparazione dei sistemi e delle applicazioni
  • Test unitari
  • Test di sistema

E infine andiamo live!

Una matrice RACI, che chiarisce ruoli e responsabilità, insieme a una roadmap più dettagliata, può essere fornita per maggiori dettagli.

Revisione della documentazione API

 Il prossimo passo consiste nel rivedere insieme la documentazione API, per consentirti di familiarizzare con essa e di agire in autonomia nei test e nell’utilizzo.

Questa documentazione è stata concepita con l’obiettivo di permetterti di gestire in piena autonomia gli import e il recupero dei dati.

Data mapping e transcodifica

La transcodifica è il processo di conversione o adattamento di un sistema (giuridico, linguistico o tecnico) in un'altra forma, mantenendone il significato.

La fase di Data Mapping consiste nel verificare che si disponga delle informazioni necessarie per realizzare uno studio Fairly Made: dati sui fornitori, sui componenti, sui prodotti e, eventualmente, sugli imballaggi (generalmente nel sistema PLM e/o ERP).

Successivamente, identifichiamo le informazioni mancanti, dove trovarle, come trasformare le tue informazioni affinché rispettino le regole del nostro modello di dati, ecc.

La fase di transcodifica fa coincidere le tassonomie, le nomenclature con quelle previste dal nostro Modello di dati.

Se hai già raccolto i vostri dati con il metodo tradizionale (con il nostro foglio di calcolo Brand Data Collection BDC .csv) con uno dei nostri Analisti, gran parte di questo lavoro è già stato fatto.

Le regole per il formato dei dati sono rigorosamente le stesse per il nostro folglio di calcolo e API.

Ambienti di test e tipi di richieste

Abbiamo 2 ambienti separati per utilizzare l’API, con Bearer Tokens separati:

  • Sandbox è usato per i test e non costituisce una replica della produzione. Solo i test che avete creato lo popoleranno.
  • Production è dove invierai e otterrai i tuoi dati reali.

Per ogni ambiente, puoi accedere ai tuoi dati tramite app.sandbox e/o app.fairlymade.

Abbiamo solo 2 tipi di richiesta: POST e GET :

  • Le richieste POST sono utilizzate per inserire dati che possono provenire dal tuo ERP/PLM/PIM/Data Hub.
  • Le richieste GET sono utilizzate per estrarre dati, i risultati dei nostri studi al tuo ERP/PLM/PIM/Data Hub.
API flow
 
 L'invio di dati è quindi definitivo, e gli aggiornamenti sono possibili solo in casi eccezionali.

Qualsiasi modifica del prodotto richiede aggiustamenti della catena di approvvigionamento, il che modifica fondamentalmente l'analisi. Questo influirebbe sulla tracciabilità, sulle valutazioni ambientali e sulla distribuzione degli impatti, aumentando il carico di lavoro degli analisti e potenzialmente ritardando le tempistiche.
 

Dalla fase di test alla produzione 

Di solito selezioniamo alcuni prodotti di test da utilizzare nel nostro ambiente sandbox, perché crediamo nell’apprendimento pratico; se necessario, possiamo fornire un set esaustivo di prodotti di test in modo che non dobbiate affrontare la difficoltà di anticipare ogni singolo caso.

È ora il momento per il tuo team (o quello del tuo integratore) di sviluppare effettivamente questa connessione, impostare le routine, memorizzare i risultati, ecc.

I dettagli sui dati che devono essere inviati e come sono disponibili qui. Per quanto riguarda la documentazione API, troverai maggiori dettagli qui.

Dopo i test unitari e la validazione, saremo pronti per il tuo primo import di raccolta tramite API!

Siamo ovviamente disponibili durante quel periodo per aiutare i tuoi sviluppatori se necessario.

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.