Annullamento di un ordine API se il cliente ha inviato un link errato

Per prima cosa verificate se l'ordine è stato trasmesso al fornitore

Un link errato non significa sempre che la promozione sia già stata avviata. Nel database interno l'ordine può essere creato ma non ancora inviato tramite API. In questo caso l'annullamento dipende solo dalla vostra logica di elaborazione: è sufficiente contrassegnare l'ordine come annullato, interrompere il pagamento automatico e non avviare la trasmissione.

Verificate l'identificativo dell'ordine, l'ora di creazione, il link, il tipo di servizio e il registro delle richieste API. Se la richiesta al fornitore non è partita, non create un nuovo ordine sopra quello vecchio. Prima registrate l'annullamento della richiesta originale, altrimenti il cliente potrebbe ottenere due avvii su link diversi.

Determinate lo stato dell'ordine presso il fornitore

Se la richiesta API è già stata inviata, richiedete lo stato aggiornato al fornitore. I nomi degli stati variano, ma di solito si possono dividere in alcuni gruppi: in attesa, in elaborazione, esecuzione parziale, completamento e annullamento. Per la decisione non conta lo stato nel vostro pannello, ma la risposta della parte che avvia il servizio.

• In attesa: l'ordine può ancora essere annullabile.
• In elaborazione: l'interruzione a volte è possibile, ma una parte del volume potrebbe essere già stata avviata.
• Esecuzione parziale: si può annullare solo il residuo, se il fornitore supporta questa operazione.
• Completamento: correggere il link tramite annullamento non è più possibile.

Il limite di verificare solo lo stato interno è che può aggiornarsi con ritardo. Basatevi sull'ultima risposta API e sull'ora in cui l'avete ricevuta.

Annullate l'ordine prima dell'avvio del servizio

Per un ordine in coda utilizzate il metodo di annullamento, se previsto dalla documentazione del fornitore. Trasmettete l'identificativo ricevuto alla creazione dell'ordine, non il vostro numero interno, se sono valori diversi. Salvate la risposta completa: codice dell'operazione, stato, testo dell'errore e ora della richiesta.

Non considerate l'ordine annullato finché l'API non ha confermato l'annullamento. La risposta di accettazione della richiesta e l'effettiva interruzione del servizio possono essere eventi diversi. In alcune integrazioni arriva prima la conferma di accettazione, mentre lo stato finale cambia più tardi.

Il limite di questa opzione è che il fornitore potrebbe non fare in tempo a rimuovere l'ordine dall'elaborazione. In tal caso l'annullamento restituirà un rifiuto o agirà solo sulla parte non eseguita.

Non modificate il link in un ordine già creato senza conferma

In molte API il link viene fissato al momento della creazione dell'ordine. Il tentativo di trasmettere un nuovo link con lo stesso identificativo può essere ignorato, elaborato come errore o creare uno stato imprevedibile. Non contate sul fatto che un nuovo invio della richiesta sostituisca automaticamente l'indirizzo.

Se la documentazione supporta esplicitamente la modifica del link, verificate prima che il servizio non sia già iniziato. Poi salvate il vecchio valore, il nuovo valore e la risposta API. Sarà utile in caso di contestazione con il cliente o con il fornitore.

Il limite della modifica è che, anche con un metodo disponibile, alcune azioni potrebbero essere già state indirizzate alla pagina sbagliata prima dell'aggiornamento. Il link corretto non trasferisce il risultato già ottenuto.

Cosa fare in caso di esecuzione parziale

Quando la promozione sul link errato è già iniziata, richiedete l'annullamento del residuo. Nella richiesta al fornitore indicate l'identificativo dell'ordine, il link errato, il link corretto, lo stato attuale e l'ora in cui è stato rilevato l'errore. Non modificate più volte i dettagli della richiesta: questo complica la verifica della cronologia.

Se l'annullamento del residuo è confermato, registrate il volume già eseguito. Il rimborso, se previsto dalle regole del fornitore, di solito riguarda solo la parte non eseguita. Il volume eseguito non può essere trasferito tecnicamente da un canale, un video o un profilo a un altro.

Il limite dell'annullamento parziale è evidente: il cliente potrebbe già aver ottenuto il risultato sulla pagina sbagliata, e il budget per questa parte dell'ordine non sempre viene restituito.

Se l'ordine è completato, presentate la correzione con una richiesta separata

Un ordine completato di solito non può essere annullato tramite API. In questa situazione non eliminate il record e non modificate il link nella cronologia: i dati originali servono per la verifica. Controllate se il servizio è stato effettivamente erogato all'indirizzo errato e non semplicemente visualizzato con ritardo.

Poi ci sono due strade: discutere un compenso con il fornitore secondo le sue regole oppure creare un nuovo ordine sul link corretto dopo aver concordato con il cliente. Il nuovo ordine deve avere un identificativo separato, un importo e un'annotazione chiara sul motivo della creazione.

Il limite del nuovo avvio è che richiede un budget aggiuntivo, e il compenso per un servizio completato potrebbe non essere disponibile.

Informate il cliente della situazione prima di un nuovo avvio

Non avviate una sostituzione di vostra iniziativa se il link appartiene al cliente e l'errore è arrivato da parte sua. Inviategli il link originale, lo stato dell'ordine, la possibilità di annullamento e le conseguenze di ogni opzione. Questo è particolarmente importante se una parte del servizio è già stata eseguita.

• Se l'ordine non è stato trasmesso, richiedete il link corretto e confermate l'annullamento della vecchia richiesta.
• Se l'ordine è in coda, comunicate che l'annullamento è stato inviato ma si attende la risposta del fornitore.
• Se c'è un'esecuzione parziale, indicate che si può fermare solo il residuo.
• Se l'ordine è completato, concordate un nuovo avvio o un'altra soluzione.

Il limite di una lunga trattativa è che nel frattempo l'ordine in coda può passare in elaborazione. Per questo inviate prima la richiesta tecnica di annullamento, se esiste questa possibilità, e poi chiarite le azioni successive.

Salvate i log e le prove dell'operazione

Per ogni ordine contestato salvate il link originale del cliente, la data di ricezione, il numero interno, l'identificativo presso il fornitore, le richieste API e le risposte. Se il cliente ha inviato il link in una conversazione, non sostituite il messaggio con una versione modificata nella scheda dell'ordine senza conservare l'originale.

Registrate separatamente chi e quando ha notato l'errore. Questo aiuta a distinguere i dati trasmessi in modo errato da un errore del manager, del modulo d'ordine o della compilazione automatica. In caso di richieste ripetute al fornitore utilizzate un'unica catena di dati, per evitare contraddizioni.

Il limite della tenuta manuale dei log è che richiede tempo. Ma senza cronologia è più difficile confermare lo stato dell'annullamento e spiegare al cliente perché i fondi non possono essere restituiti integralmente.

Verificate la gestione degli errori nell'integrazione

Dopo un caso del genere verificate come il sistema trasmette i link all'API. L'errore può verificarsi non solo per colpa del cliente: a volte il modulo tronca i parametri, inserisce un vecchio valore dalla cache, accetta un link al profilo invece di un link alla pubblicazione o lascia passare un link con caratteri superflui.

Aggiungete un controllo del formato prima di creare l'ordine: corrispondenza con la piattaforma, il tipo di servizio e l'oggetto previsto. Per i servizi sui video il sistema deve distinguere il link al video dal link al canale, e per i social network il profilo dalla singola pubblicazione. Il controllo non garantisce la correttezza del link, ma filtra una parte degli errori evidenti.

È meglio separare la trasmissione dell'ordine dalla sua creazione con un breve controllo dei dati. Il limite del passaggio aggiuntivo è che l'ordine non andrà in lavorazione all'istante, ma avrete il tempo di notare l'indirizzo errato.

Impostate una procedura di annullamento chiara per il team

Descrivete un ordine di azioni unico: interrompere l'invio automatico, verificare lo stato presso il fornitore, inviare l'annullamento, salvare la risposta, informare il cliente e solo dopo concordare un nuovo avvio. Questa procedura non serve per formalità, ma per evitare che dipendenti diversi compiano azioni reciprocamente incompatibili.

Non concedete l'accesso all'annullamento senza limitazione dei diritti e registro delle azioni. Se più manager lavorano contemporaneamente sullo stesso ordine, uno può richiedere l'annullamento e un altro creare una sostituzione prima di ricevere la risposta. Questo porta a costi superflui e confusione nei conteggi.

Il limite di una procedura rigorosa è una minore flessibilità nei casi urgenti. Ma per gli ordini API è più importante non la velocità di una singola azione, bensì il controllo su quale link sia effettivamente andato in lavorazione.