---
title: Connetti Shippo per la spedizione
description: Aggiungi una chiave API Shippo, conferma la connessione e disconnetti Shippo in modo sicuro.
---

Connetti Shippo quando desideri che Runner utilizzi il tuo account Shippo per la spedizione e l'adempimento. La connessione utilizza una chiave API fornita da Shippo.

## Prima di iniziare

**Percorso di accesso:** **Progetto → App → Store Apps → Shippo**

Hai bisogno di:

- un account Shippo e una chiave API Shippo corrente;
- autorità per connettere quell'account all'area di lavoro Runner; e
- consapevolezza che disconnettere Shippo rimuove la sua chiave e la disabilita per tutti i progetti nell'area di lavoro.

Non incollare la chiave API in chat o documentazione.

## Controlli e risultati Shippo

| Controllo | Perché è utile | Cosa succede dopo |
| --- | --- | --- |
| **Connetti** | Apre la configurazione Shippo. | Runner chiede la **chiave API Shippo**. |
| **Chiave API Shippo** | Identifica il tuo account Shippo. | Runner controlla il formato della chiave e mostra un errore mentre il valore non è valido. |
| Icona occhio | Ti consente di ispezionare il valore per errori di digitazione. | Attiva/disattiva il campo tra testo nascosto e visibile. Nascondilo di nuovo prima di condividere lo schermo. |
| Finestra di dialogo **Connetti** | Invia la chiave. | In caso di successo, Runner chiude la finestra di dialogo, cancella il campo e cambia la scheda in connessa. |
| **Annulla** o chiudi | Esce dalla configurazione senza inviare. | Runner cancella la chiave inserita dalla finestra di dialogo. |
| Elimina o **Disconnetti** | Avvia la rimozione. | Runner apre **Disconnettere Shippo?** con l'impatto a livello di area di lavoro. |
| Conferma **Disconnetti** | Rimuove la connessione salvata. | Runner rimuove la chiave API e disabilita Shippo per tutti i progetti dell'area di lavoro. |

## Connetti Shippo

1. Apri **Progetto → App**.
2. Trova **Shippo** e seleziona **Connetti**.
3. Copia la chiave API dall'account Shippo che intendi utilizzare.
4. Incollala in **Chiave API Shippo**.
5. Se Runner segnala una chiave non valida, torna a Shippo e copia di nuovo invece di modificare il segreto per supposizione.
6. Seleziona **Connetti** nella finestra di dialogo.
7. Attendi il messaggio di successo e conferma che la scheda mostra il suo controllo di disconnessione connesso.
8. Utilizza dati di test sicuri per verificare il flusso di spedizione prima di affidarti a esso per gli ordini dei clienti.

## Disconnetti o sostituisci la chiave

Seleziona il controllo di disconnessione della scheda e leggi **Disconnettere Shippo?**. Conferma solo quando è accettabile rimuovere la chiave e disabilitare Shippo per ogni progetto nell'area di lavoro.

Per utilizzare una chiave diversa, disconnetti l'integrazione corrente, conferma che la scheda non è più connessa, quindi completa il flusso di connessione con la chiave di sostituzione.

## Se Shippo non si connette

- **Chiave API non valida** significa che il valore non corrisponde al formato della chiave Shippo accettato.
- **Impossibile connettere Shippo** significa che Runner non ha terminato la connessione del provider. Mantieni la chiave privata, conferma che è corrente in Shippo e riprova dalla scheda.
- Se la finestra di dialogo si chiude ma la scheda non si connette, aggiorna le app prima di inviare di nuovo.
- Se la disconnessione non riesce, presumi che la chiave esistente sia ancora attiva.
- Una scheda connessa non prova che tariffe, etichette, vettori o una spedizione specifica funzionano. Verifica quelle operazioni separatamente con dati di test sicuri.

## Guide correlate

- [Connetti, gestisci e ricollega un'app](./connect-manage-reconnect)
- [Connetti l'adempimento 4PX](./4px-fulfillment)
- [Risolvi i problemi di connessione di un'app](./troubleshooting)