Aggiorna gli ordini

Definizione dei campi

I campi obbligatori sono contrassegnati da una matita. Le definizioni dei campi si basano sulla sintassi MySQL.

Tutti i campi vengono analizzati in base al loro tipo prima dell'importazione. Se in orders_id si inserisce una stringa vuota, questa viene convertita in uno 0 tramite cast a INT.

Durante l’importazione viene automaticamente richiamata la rispettiva funzione `backend_update_order` relativa al metodo di pagamento associato all’ordine, ad esempio per restituire uno stato di spedizione tramite API.

orders_id
int(11)
L'ID univoco dell'ordine.
L'aggiornamento dell'ordine avviene sempre in base all'ID.
orders_status_name
varchar(50)
Nome dello stato dell'ordine nella lingua predefinita del negozio. Se lo stato non esiste, viene creato automaticamente.
rg
varchar(32)
File di fattura personalizzato. Il file con lo stesso nome deve essere salvato nella cartella 'files/rg/'.
ls
varchar(32)
File individuale della bolla di consegna. Il file con lo stesso nome deve essere salvato nella cartella 'files/ls/'.
orders_comment
mediumtext
Commento relativo all'aggiornamento. La visibilità per i clienti dipende dalle impostazioni dello shop e dal nodo 'customer-notified'.
po_number
varchar(50)
Riferimento dell'ordine/della ricevuta (ad es. ID ricevuta AB dal sistema di gestione delle merci). Viene scritto in orders.po_number e appare sulle ricevute in formato PDF come ZUGFeRD BuyerReference, nonché nella cronologia degli ordini del cliente. I valori vuoti o mancanti non sovrascrivono il dato esistente.
links
link
Ogni nodo «links» contiene [1..n] nodi «link». Se il nodo «links» viene fornito con almeno un elemento, le vecchie voci di tracciamento dell’ordine vengono sempre cancellate e sostituite dal nuovo elenco.
link
text o nodo
Sono accettate tre varianti di immissione:

(A) Legacy: nodo di solo testo, ad es. https://nolp.dhl.de/nextt-online-public/de/search?piececode=00340434123456. Il codice di tracciamento e il corriere vengono riconosciuti automaticamente dall’URL (DHL, DHL Express, GLS, DPD, UPS, Hermes, FedEx, TNT, Posta Svizzera, Posta Austriaca, Planzer, Deutsche Post).

(B) Completamente annidato: ……… — massimo controllo, non è necessaria alcuna euristica.

(C) Solo corriere + codice: senza , ad es. DHL00340434123456. Il negozio online genera automaticamente l’URL di tracciamento visibile al cliente a partire dal modello del corriere (shipping_provider.provider_tracking_link) + codice memorizzato nel negozio.
link/url
testo
URL di tracciamento completo per il cliente, ad es. https://nolp.dhl.de/nextt-online-public/de/search?piececode=00340434123456. Opzionale: se il campo rimane vuoto e sono impostati service_provider + code, l’URL viene generato automaticamente dal modello del corriere + codice.
link/service_provider
varchar(16)
Codice del corriere: DHL, DHLEXPRESS, GLS, DPD, UPS, HLG (Hermes), FEDEX, TNT, POSTCH, POSTAT, PLANZER, DP (Deutsche Post) oppure OTHER. Se il campo rimane vuoto, il fornitore viene riconosciuto automaticamente dall’URL e/o dal codice di tracciamento.

I marketplace (eBay, Amazon, Otto, Kaufland, Idealo) ricevono questo codice come ShippingCarrierUsed / carrier / carrier_code.
link/code
testo
Numero di tracciamento puro senza URL. Se il campo rimane vuoto, il codice viene estratto automaticamente dall’URL (ultimo parametro di query o segmento del percorso).
customer_notified
tinyint(1)
Informare i clienti via e-mail sull'aggiornamento dello stato e inviare un commento
  • 1: informare i clienti
  • 0: Non informare i clienti (l'aggiornamento è comunque visibile nella panoramica degli ordini, a seconda delle impostazioni di Shop)
customer_notified_template_id
int(11)
ID del blocco di testo relativo allo stato dell’ordine. Qui è possibile specificare semplicemente l’ID del blocco di testo, il cui contenuto verrà automaticamente adattato alla lingua del cliente. Inoltre, viene eseguita automaticamente la sostituzione dei segnaposto.

Esempio di file XML

Il file XML deve rispettare la seguente convenzione di denominazione:
Orders(.)*.xml

Esempio inline con tutte e tre le varianti di tracciamento combinabili in un unico file:



  
    441535
    Spedito
    Il Suo ordine è stato spedito.
    AB-2026-0042
    RG-2026-0042.pdf
    LS-2026-0042.pdf
    
      
      https://gls-group.eu/DE/de/paketverfolgung?match=987654321012
      
      
        https://nolp.dhl.de/nextt-online-public/de/search?piececode=00340434123456
        DHL
        00340434123456
      
      
      
        DHL
        00340434123457
      
    
    1
    0

Scarica i file di esempio:

Esempio completo (tutte le varianti) (A) Legacy (B) Annidato (C) Vettore + Codice

Note sull'elaborazione

  • Protezione dall’idempotenza: le modifiche di stato identiche (stesso orders_id + orders_status_name + comment) non vengono elaborate due volte in caso di reimportazione. Le e-mail ai clienti, le chiamate API del marketplace e le proroghe dei download vengono saltate in caso di reimportazione, mentre l’aggiornamento dello stato dell’ordine e i dati di tracciamento vengono aggiornati. In questo modo è possibile reimportare in tutta sicurezza i file XML di archivio, ad esempio per integrare i codici dei corrieri mancanti.
  • Tracciamento della sincronizzazione con i marketplace: Per gli ordini dei marketplace (Amazon, eBay, Otto, Kaufland, Idealo, Mirakl, Galaxus, Shöpping.at), ogni importazione di spedizione o annullamento genera inoltre una voce interna nella cronologia degli ordini (customer_notified=0) con il risultato della sincronizzazione: [xoPort] Sincronizzazione marketplace (amazon, ship): trasferimento riuscito o ERRORE — . In questo modo, nel backend è possibile verificare direttamente per ogni ordine se il trasferimento al marketplace è andato a buon fine.

Last updated: 9 ottobre 2026