Panoramica
Ympact è una piattaforma di tracciabilità della supply chain per il settore moda e lusso. I brand la usano per emettere ordini d'acquisto, monitorare l'esecuzione presso i fornitori e costruire un registro verificabile di ogni movimentazione di materiale.
Quando un brand emette un ordine, il fornitore deve tenere Ympact aggiornato: spedizioni, piani di consegna, documenti allegati e processi produttivi. Questa guida è per i System Integrator (SI) che collegano l'ERP del fornitore a Ympact per automatizzare quel flusso di dati.
Il tuo ruolo come System Integrator
Mappa i campi dell'ERP del fornitore sulle entità che Ympact si aspetta, poi invia i dati tramite il canale di integrazione concordato durante l'onboarding.
Ympact gestisce autenticazione, componenti UI e portale web. La tua integrazione ha un'unica responsabilità: inviare i dati corretti, nel formato corretto, al momento giusto.
Dati richiesti dal fornitore
Per ogni ordine, il fornitore comunica:
| Entità | Dominio | Descrizione |
|---|---|---|
| Spedizione | Tracking | Ogni spedizione fisica a fronte dell'ordine |
| Piano di Consegna | Tracking | Pianificazione delle consegne per ogni riga d'ordine |
| Documento | Tracking | File allegati — packing list, fatture, AWB, DDT |
| Processo | Mapping | Lavorazioni o processi produttivi sul materiale |
Il brand configura quali entità sono attese per ogni fornitore. In caso di dubbio, vedi la documentazione di onboarding o contatta il Supporto.
Ordine di invio
L'ordine delle entità è importante:
- Spedizioni e Piani di Consegna — inviali per primi. Possono arrivare insieme, ma devono precedere documenti e processi.
- Documenti e Processi — inviali dopo che le spedizioni corrispondenti sono presenti in Ympact.
Inviare un documento o un processo prima che esista la spedizione correlata può causare errori di elaborazione.
Canali di integrazione
Ympact supporta due canali. Il canale viene scelto durante l'onboarding e si applica a tutte le entità:
- Message Queue — invia payload JSON su una coda dedicata fornita da Ympact. Canale consigliato per integrazioni in tempo reale e orientate agli eventi.
- SFTP — deposita file CSV separati da punto e virgola su un server dedicato. Adatto a integrazioni batch o sistemi ERP legacy.
Entrambi i canali trasportano le stesse entità e lo stesso modello di dati. La scelta non influisce su cosa si invia — solo su come.
Accesso e credenziali
Ympact fornisce tutte le credenziali. Non è prevista registrazione self-service. Durante l'onboarding riceverai:
- Credenziali di accesso per il canale scelto (coda o SFTP)
- Credenziali per ogni ambiente (dev, test, stage, demo, produzione)
Vedi Credenziali e accesso per i dettagli.
Struttura della guida
| Sezione | Contenuto |
|---|---|
| Quickstart | Invia il tuo primo payload nell'ambiente di sviluppo |
| Ambienti | URL e configurazione per ogni ambiente |
| Credenziali | Credenziali ricevute e come configurarle |
| Come funziona | Flusso dati end-to-end |
| Ciclo di vita dell'ordine | Cosa inviare e quando, con esempio concreto |
| Mappatura campi | Come mappare i campi ERP sulle entità Ympact |
| Guide | Riferimenti payload per entità e specifiche CSV |