Note preliminari per il formato XML

This page will help you get started with Awesome New API.

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');