FAQ
Generale​
Come ottengo l'accesso alla piattaforma di integrazione? Contatta il Supporto per richiedere le credenziali di onboarding per il tuo canale di integrazione.
Esiste una sandbox? Sì — l'ambiente Dev è disponibile per i test di integrazione. Le credenziali per Dev e Test vengono provisionate automaticamente all'inizio dell'onboarding.
Quali canali di integrazione sono disponibili? Ympact supporta due canali: message queue (JSON, real-time) e SFTP (CSV, batch). Il canale viene scelto durante l'onboarding e si applica a tutte le entità .
Autenticazione​
Come mi autentico per inviare i dati?
- Message queue: usa l'AWS Access Key ID e la Secret Access Key fornite da Ympact. Vedi Credenziali e accesso.
- SFTP: usa la chiave SSH privata e l'username forniti da Ympact.
Non esiste un flusso di autenticazione basato su token per l'invio dei dati.
I miei messaggi non vengono accettati. Cosa devo verificare?
- Verificare che le credenziali AWS o la chiave SFTP siano corrette per l'ambiente target
- Confermare che l'URL della coda o l'host SFTP corrispondano all'ambiente
- Verificare che il payload rispetti lo schema corretto — vedi la guida dell'entità per le regole di validazione
Invio Dati​
Qual è il formato standard degli errori? Vedi Gestione degli Errori.
Posso reinviare un record se la validazione fallisce? Sì. Ympact usa la chiave primaria per identificare i record. Reinviare con la stessa chiave primaria aggiornerà il record esistente (upsert). Vedi Idempotenza per i dettagli.
Cosa succede se invio un Documento o un Processo prima che esista la relativa Spedizione? Il record potrebbe essere rifiutato perché fa riferimento a una Spedizione mancante. Invia sempre Spedizioni e Piani di Consegna prima, poi Documenti e Processi. Vedi Ciclo di vita dell'ordine.