Ambiente di test di Envia.com

L’ambiente di test di Envia.com è uno spazio sicuro in cui puoi provare tutte le funzioni della piattaforma senza influire sulle tue operazioni reali. È ideale per familiarizzare con il sistema prima di iniziare a spedire pacchi con denaro reale.

A cosa serve?

• Prova preventivi, generazione e annullamento di etichette senza costi extra.
• Collega e verifica i tuoi negozi ecommerce prima di attivarli in produzione.
• Consenti al tuo personale di esercitarsi e imparare la piattaforma.
• Assicurati che tutto funzioni correttamente prima di avviare le operazioni.

Differenze tra ambiente di test e produzione

Ambiente di test	Ambiente di produzione
Dati fittizi	Dati reali
Nessun costo reale	Addebiti sul tuo saldo
Per sperimentare	Per operazioni reali

Nota

L’ambiente di test non influisce sul tuo saldo reale né genera addebiti sui tuoi account.

Accedi all’ambiente di test

1. Accedi al tuo account Envia.com

2. Nel menu laterale, fai clic su Sviluppatori > Ambiente di test.

3. Si aprirà una nuova scheda su accounts-sandbox.envia.com con la schermata di accesso dell’ambiente di test.

4. Crea il tuo account di test con un nuovo utente e password, oppure accedi se ne hai già uno.

5. Una volta dentro, sarai su shipping-test.envia.com, la dashboard dell’ambiente di test.

   Nota

   Le credenziali del tuo account di produzione non funzionano nell’ambiente di test. Anche se accedi dal tuo account reale, devi registrarti separatamente.

Ottieni il token API per i test

Se vuoi testare l’integrazione con l’API di Envia, devi generare un token specifico all’interno dell’ambiente di test.

1. Accedi a **shipping-test.envia.com** (il tuo account di test).

2. Vai su Sviluppatori > Accesso API.

3. Fai clic su Aggiungi per generare un nuovo token.

4. Copia il token e usalo nelle chiamate agli endpoint del sandbox.

   Nota

   Usa questo token solo con gli URL del sandbox. Se lo usi con gli URL di produzione, riceverai un errore di autenticazione, e viceversa.

Limitazioni dell’ambiente di test

Il sandbox replica l’esperienza di produzione, ma con alcune differenze importanti:

• Le etichette generate non sono reali e non hanno tracciamento con i corrieri.
• I pagamenti e le ricariche di saldo non vengono elaborati; il saldo nel sandbox è fittizio.
• Alcune integrazioni con i corrieri possono comportarsi in modo diverso o non essere disponibili nei test.
• I dati del sandbox (indirizzi, pacchi, cronologia) sono indipendenti e non vengono sincronizzati con il tuo account di produzione.

Passa alla produzione

Quando hai convalidato i flussi nel sandbox, il passo successivo è operare in produzione.

1. Accedi al tuo account di produzione su shipping.envia.com.

2. Se ti serve un token API, generalo in Sviluppatori > Accesso API dal tuo account di produzione.

3. Se hai un’integrazione API, sostituisci gli URL.

4. Sostituisci il token sandbox con il token di produzione.

   Nota

   Assicurati che il tuo account di produzione sia verificato prima di generare etichette reali. Consulta l’articolo Verifica il tuo account se hai passaggi in sospeso.

Domande frequenti

Posso usare il mio account di produzione per fare test? Non è consigliato. Le etichette generate in produzione sono reali e generano addebiti. Usa sempre il sandbox per test e sviluppo.

Il saldo che ho in produzione è disponibile nel sandbox? No. Saldo, indirizzi, pacchi e cronologia sono completamente indipendenti tra i due ambienti.

Devo verificare il mio account nel sandbox? No. Nell’ambiente di test puoi operare senza passare dal processo di verifica dell’identità che si applica in produzione.

I corrieri disponibili nel sandbox sono gli stessi della produzione? Per la maggior parte sì, anche se alcuni corrieri possono avere disponibilità limitata o un comportamento diverso nell’ambiente di test.

Posso avere accesso al sandbox e alla produzione allo stesso tempo? Sì. Sono account indipendenti e puoi avere una sessione attiva in entrambi da browser o schede diverse.

L’uso dell’ambiente di test è obbligatorio? No, ma lo consigliamo per ridurre gli errori prima di operare in produzione, soprattutto se collegherai un negozio ecommerce o integrerai l’API.