Automation: Utenti da piattaforma e via API (it)

Le automazioni in ShippyPro ti permettono di automatizzare azioni in base a specifici eventi del tuo flusso di spedizione. Tuttavia, non tutti gli utenti possono utilizzare le automazioni nello stesso modo: dipende da come utilizzi ShippyPro.

Questa guida descrive i 3 tipi di utenti e i trigger di automazione disponibili per ciascuno, così da poter applicare l’approccio corretto e impostare le giuste aspettative.

Sommario

Utenti Piattaforma

Come utilizzi ShippyPro: gli ordini vengono importati in piattaforma tramite integrazioni con marketplace/store o upload CSV e la spedizione viene poi gestita direttamente dalla piattaforma.

Trigger disponibili:

• Ordine importato: si attiva quando un nuovo ordine viene importato in piattaforma. Ideale per avviare automazioni pre-spedizione come:
  
  • Formatta i dati per prevenire errori durante la generazione delle etichette

• • Aggiungi colli o note ordine

• • Genera automaticamente le etichette di spedizione per gli ordini importati

• • Altri casi d'uso qui
    
    
• Order in error: si attiva quando la creazione dell’etichetta non va a buon fine per diversi motivi. Questo trigger è ideale per workflow che mirano a risolvere automaticamente l’errore non appena viene rilevato.

Consiglio:
Leva entrambi i trigger per automatizzare completamente i tuoi processi di pre-spedizione e gestione errori.

Hybrid Users (API + Platform)

Come utilizzi ShippyPro: Gli ordini vengono importati tramite PUTORDER API e poi la piattaforma viene utilizzata per la spedizione.

Trigger disponibili:

Stessi casi d’uso degli utenti piattaforma: una volta che l’ordine è importato via API, i tuoi flussi sono gli stessi.

Consiglio:
Usa l’automazione come un Utente Piattaforma. Le automazioni sono completamente disponibili — cambia solo il metodo di importazione.

Utenti API (SHIP API)

Come utilizzi ShippyPro: Gli ordini non vengono importati. Generi l’etichetta direttamente tramite SHIP API.

Non Disponibile:
Order is imported: Non viene attivato, poiché nessun ordine viene “importato” nel sistema.

Trigger Disponibile:
Order in error: Attivato quando la generazione dell’etichetta fallisce tramite SHIP API.

Caso d’Uso del Workflow:
Al momento, puoi utilizzare l’automazione solo per automatizzare la risoluzione degli errori (es. auto-retry, auto-fix), non per prevenire gli errori tramite azioni di formattazione.

• Piattaforma: L’etichetta è disponibile nella scheda “Spediti”, pronta da stampare.

• GetLabelUrl API: Usa GetLabelUrl per recuperare l’etichetta.
  ⚠️ Importante: I workflow sono asincroni e possono impiegare da <1s a oltre 30s. Inserisci un ritardo prima di chiamare questo endpoint.

• Order Shipped Webhook: Usa questo webhook per essere notificato e recuperare l’etichetta in modo programmatico.

Consiglio:
Le automazioni proattive (es. auto-format dell’indirizzo) non sono al momento possibili per il tuo flusso.

Concentrati sui workflow di recupero degli errori e assicurati di implementare la logica di recupero etichette usando un ritardo (buffer time) oppure l’Order Shipped Webhook.