Passa al contenuto principale

Gestione Rimborsi

I rimborsi sono gestiti tramite il dataobject Refund, che consente di tracciare e amministrare i rimborsi associati agli ordini di vendita. L'invio al canale è automatico se attivato apposito flag sul canale di vendita ed invia:

  • Rimborso parziale: se l'ordine è pagato invia il rimborso parziale altrimenti invia la modifica dell'ordine
  • Rimborso totale: se l'ordine è pagato invia il rimborso totale altrimenti invia l'annullamento dell'ordine

Restock​

Il restock non dipende dal singolo Refund, ma dal totale refundedQuantity sulla riga SalesOrderItem.

  • Send to shop (bottone workflow o cron) e upsert ordine da Shopify (orderItems[].qtyRefunded) scrivono lo stesso totale sulla riga.
  • Il listener della riga, se il totale aumenta, rilascia solo le quantità non ancora spedite (confronto con CarrierInfo, non solo lo status ordine).
  • Se sul SalesChannel è attivo useLogicalStock, viene cancellata la prenotazione (availableQty); altrimenti viene incrementata la quantità on hand.
  • Un secondo arrivo con lo stesso totale (1 → 1) non muove lo stock.
  • Ordini fulfilled / delivered: nessuno stock viene riallineato (la merce spedita non torna a magazzino da questo flusso).
  • Rimborso solo spedizione o solo importo (qty 0): refundedQuantity non cambia, nessuno stock.

Creazione Rimborsi​

Metodo di creazione all'interno di SOH:

  • Importazione tramite tracciato ordine
  • Creazione tramite endpoint API dedicato
  • Creazione manuale tramite il pulsante sull'ordine nella tab Refunds

Importazione da Ordine​

Il reso è importato durante il flusso di inserimento o aggiornamento ordine con status sent. Lo status è quello finale poiché il rimborso è già stato processato e non richiede ulteriori azioni.

Creazione tramite API​

È possibile creare un rimborso associato a un ordine esistente tramite l'endpoint API come da documentazione: API Rimborsi

Creazione Manuale​

È possibile creare manualmente un rimborso tramite il pulsante Create Refund from Order nella tab Refunds dell'ordine. Il rimborso creato contiene tutti i prodotti dell'ordine con quantità acquistata e spese di spedizione da rimborsare.

Campi​

Codice​

Campo: Code

Nome univoco del reso, in caso siano creati più rimborsi per lo stesso ordine, il codice avrà un numero progressivo esempio RFND-#1021-1, RFND-#1021-2.

Status​

Campo: status

Stato del rimborso, gestito dal workflow. Valori possibili:

  • pending (In attesa di conferma)
  • error (Errore)
  • sent (Inviato)
  • to_send (Da inviare) Obbligatorio, non modificabile manualmente.

Tipologia Rimborso​

Campo: refundTypology

Tipologia del rimborso. Valori possibili:

  • customer (Richiesta cliente)
  • damage (Articoli danneggiati)
  • other (Altro) Obbligatorio.

Motivo Rimborso​

Campo: reason

Motivo del rimborso. Valori possibili:

  • shipment_canceled (Spedizione annullata)
  • damage (Danneggiamento)
  • non_compliance (Non conformità)
  • lost (Smarrimento)
  • returned (Reso)
  • other (Altro) Obbligatorio.

Motivo Extra​

Campo: extraReason

Motivazione aggiuntiva del rimborso. Testo libero, opzionale.

Data Rimborso​

Campo: refundDate

Data di creazione del rimborso. Generata automaticamente, non modificabile.

Importo Totale​

Campo: totalAmount

Importo totale del rimborso, calcolato automaticamente.

Numero Ordine​

Campo: orderNumber

Numero dell'ordine associato al rimborso. Calcolato automaticamente.

Ordine​

Campo: order

Riferimento all'oggetto ordine associato.

Rimborso Spese di Spedizione​

Campo: refundShippingAmount

Flag che indica se tutte le spese di spedizione sono rimborsate.

Importo Parziale Spese di Spedizione​

Campo: refundedShippingAmount

Importo parziale delle spese di spedizione rimborsate.

Spese di Spedizione Pagate​

Campo: shippingAmount

Importo delle spese di spedizione pagate sull'ordine. Calcolato automaticamente.

ID Rimborso Shop​

Campo: shopRefundId

Identificativo del rimborso nel sistema shop. Unico, generato automaticamente.

Stato Rimborso Shop​

Campo: shopStatus

Stato del rimborso nel sistema shop. Valori possibili:

  • pending (In attesa di conferma)
  • error (Errore)
  • sent (Inviato)
  • to_send (Da inviare)

Articoli Rimborsati​

Campo: items

Lista degli articoli rimborsati, con quantità e prezzo rimborsato per ciascun articolo.

Rettifiche Ordine​

Campo: orderAdjustments

Eventuali rettifiche applicate all'ordine, collegate al rimborso.