Note preliminari per il formato XML

Benvenuti alla nostra documentazione REST API per gli ordini su STORE360

Note preliminari per il formato XML
• Alcuni campi sono obbligatori altri sono opzionali:
in importazione un tag con contenuto nullo (stringa vuota, oppure numero uguale a
zero) imposterà tale valore nel relativo campo; se, invece, il tag viene omesso del
tutto, STORE360 in caso di un “update” non aggiornerà il relativo campo mentre
imposterà il valore di default in caso di un “insert”.
• I campi di tipo [Prezzo] utilizzano il “.” come separatore decimale. Non è utilizzato il
separatore delle migliaia.
• I campi di tipo [Data] sono in formato ISO “aaaa-mm-gg hh:mm:ss” (es: “2020-02-28
15:21:15”).
• In esportazione da STORE360, se un campo ha un valore nullo (stringa vuota,
oppure numero uguale a zero), il relativo tag viene comunque compreso nel tracciato.

Il file XML deve essere codificato in UNICODE UTF-8 che prevede importanti regole nella
codifica delle stringhe racchiuse tra tag:
• Caratteri riservati
I caratteri "&", "<", ">" sono riservati: se un testo contiene questi caratteri, bisogna
sostituirli rispettivamente con "&", "<", ">".

In PHP è sufficiente utilizzare il comando seguente:

$string= htmlspecialchars("prova con caratteri riservati & \< >", ENT_NOQUOTES,  
'Windows-1252');

• Simboli e lettere accentate
La maggioranza dei file di testo creati su sistemi Windows segue la codifica
"Windows-1252"; questa codifica differisce dalla codifica UTF-8 per i caratteri con
codice ASCII > 127, ad esempio il simbolo di € e le lettere accentate òàùéèìù.
In PHP per convertire una stringa da "Windows-1252" a "UTF-8" è sufficiente
utilizzare il comando seguente:

$string= mb_convert_encoding("prova con  
caratteri €òàùéè", 'UTF-8', 'Windows-1252');

Quindi nella preparazione di un file da far importare a STORE360, ogni campo inserito tra
TAG deve essere prima codificato con:

$string= mb_convert_encoding(htmlspecialchars($string, ENT_NOQUOTES,  
'Windows-1252'), 'UTF-8', 'Windows-1252');

mentre per l'interpretazione di un file ricevuto da STORE360, è necessario eseguire l'operazione opposta:

$string=html_entity_decode(mb_convert_encoding($string,'Windows-1252','UTF-8'),  
ENT_NOQUOTES, 'Windows-1252');