Dal gestionale è possibile esportare uno stato di evasione degli ordini ricevuti e visualizzarlo nell’app nella lista documenti. Se presente un numero di tracking, questo può essere visualizzato e se esiste una corrispondenza URL l’app può direttamente aprire la pagina di tracking del corriere.
Stato documenti
In fase di importazione dell’ordine app nel gestionale, è necessario conservare il riferimento al numero ordine app, espresso in formato NUMERO/UTENTE (es. 202200010/AG1) oppure nel formato esteso (tipo doc/anno/numero/ruolo/codice utente, ad esempio OR/2022/10/A/AG1).
Inoltre è necessaria una query, oppure un file Excel/testo intermedio, in cui siano riportati i seguenti dati obbligatori:
- Riferimento app del documento (202200010/AG1 oppure OR/2022/10/A/AG1)
- Codice agente, se il documento è legato a un agente (tag COLONNA_AGENTE nei tracciati)
- Codice cliente (tag COLONNA_CODICE)
- Numero documento gestionale (se è diverso dal riferimento app, tag COLONNA_NUMERO_ORDINE)
- Serie del documento gestionale (tag COLONNA_SERIE)
- Data documento gestionale (tag COLONNA_DATA)
- Stato documento* (tag COLONNA_STATO)
- Numero tracking o URL tracking (tag COLONNA_TRACKING)
- Descrizione testuale dello stato documento (tag COLONNA_STATO_TESTO)
* Lo stato del documento può essere espresso nel modo più comodo (es. codici numerici, lettere o una stringa) e tradotto con una tabella intermedia in uno degli stati supportati dall’app:
- W = in attesa di approvazione
- A = approvato
- P = parzialmente evaso
- E = totalmente evaso
- X = eliminato o annullato
- Z = forzatura eliminazione in app (**)
** L’azienda può forzare che dei documenti vengano eliminati dall’app, ma è anche necessario che fra i parametri ci sia ORDINI_ELIMINAZIONE_REMOTA con valore 1 altrimenti l’app non procederà ad eliminare il documento anche se riceve questa istruzione.
Numero di tracking e Regex per ottenerne l’URL
Se si fornisce all’app un numero di tracking corrispondente ai documenti, nella lista DOCUMENTI/ORDINI si può visualizzare usando i tre puntini a destra di ogni documento:
Per associare un formato di numero tracking ad un URL corrispondente è necessario usare delle espressioni regolari valorizzando ad esempio il parametro
ORDINE_TRACKING_REGEXS_1
con valore
^(\d{14})$
(espressione regolare per una stringa composta da 14 numeri), e il parametro
ORDINE_TRACKING_REGEXR_1
con valore
https://www.mybrt.it/it/mybrt/my-parcels/incoming?parcelNumber=$1
che associa quindi un URL di Bartolini dove al posto di $1 saranno inseriti i 14 caratteri del numero tracking.
Se si usano più corrieri è possibile aggiungere inoltre
ORDINE_TRACKING_REGEXS_2
con il valore
^(\w{2}) (\d{9})$
(espressione regolare che verifica la presenza di due lettere, uno spazio, nove numeri)
e il parametro
ORDINE_TRACKING_REGEXR_2
con valore
https://www.gls-italy.com/tracktraceuser/$1/$2
Se esiste una regex corrispondente al numero tracking, l’app provvederà ad aprire direttamente l’URL di consultazione dopo aver comunque mostrato all’utente il numero (nel caso il link non funzioni più).