Consigliamo di inserire nel feed sempre gli ordini degli ultimi 15-30 giorni, o comunque un periodo sufficiente a coprire l'intervallo di tempo che puo' essere intercorso dall'ultima sincronizzazione. Ready Pro importera' sempre sul gestionale solo gli ordini che non risultano gia' importati, in base al riferimento d'ordine presente nel file (campo OrderRef).
N.B. L'URL da cui il plugin effettua il download ordini sara' da specificare nella sezione "configurazione server" del plugin.
L'XML che la pagina deve generare dovra' avere una struttura simile alla seguente :
<?xml version="1.0" encoding="windows-1252"?>
<ReadyFeed feedtype="WebOrder" version="1.0">
<WebOrders>
<WebOrder>
<DocDate>2012-07-10</DocDate>
<SourceSite>http://www.miosito.com</SourceSite>
<OrderRef>AB12322</OrderRef>
<Anag>
<Name>Rossi Mario</Name>
<Address>Via Garibaldi, 10</Address>
<ZipCode>00100</ZipCode>
<City>Roma</City>
<Province>RM</Province>
<CountryCode>IT</CountryCode>
<EmailAddress>mario@miosito.com</EmailAddress>
<PhoneNumber>123-12345678</PhoneNumber>
<CellularNumber>123-12345678</CellularNumber>
<FaxNumber>123-12345678</FaxNumber>
<VatNumber>12345678901</VatNumber>
<PersonalID>AAABBB84A11L333R</PersonalID>
<LanguageRFC>en-gb</LanguageRFC>
<EInvoiceAddress>ABC1234</EInvoiceAddress>
</Anag>
<DestinationAddress>
<Name1>c/o LA MIA AZIENDA srl</Name1>
<Address1>Via Rossini,10</Address1>
<ZipCode>00100</ZipCode>
<City>Roma</City>
<Province>RM</Province>
<CountryCode>IT</CountryCode>
<PhoneNumber>06-1234567</PhoneNumber>
</DestinationAddress>
<Payment>
<Code>PAY0001</Code>
<Name>Contrassegno</Name>
</Payment>
<DocRows>
<WebOrderRow>
<RowType>Product</RowType>
<Product>
<Code>ABCD1234</Code>
</Product>
<Quantity>2</Quantity>
<Price>122.95</Price>
<PriceIncludingVAT>150.00</PriceIncludingVAT>
<DiscountPercent>0</DiscountPercent>
<CurrencyType>
<Code>EUR</Code>
</CurrencyType>
<Tax>
<Code>IVA0001</Code>
<PercentAmount>22.0</PercentAmount>
</Tax>
<Notes>AAAAAAAAAAA</Notes>
<OrderDetailRef>ABC-12331-00</OrderDetailRef>
</WebOrderRow>
<WebOrderRow>
<RowType>Discount</RowType>
<Quantity>1</Quantity>
<Price>10.0</Price>
<CurrencyType>
<Code>EUR</Code>
</CurrencyType>
<Tax>
<Code>IVA0001</Code>
<PercentAmount>22.0</PercentAmount>
</Tax>
</WebOrderRow>
<WebOrderRow>
<RowType>FreeLine</RowType>
<Description>Testo della linea libera</Description>
<Quantity>0</Quantity>
</WebOrderRow>
<WebOrderRow>
<RowType>ShippingExpenses</RowType>
<Quantity>1</Quantity>
<Price>10.0</Price>
<CurrencyType>
<Code>EUR</Code>
</CurrencyType>
<Tax>
<Code>IVA0001</Code>
<PercentAmount>22.0</PercentAmount>
</Tax>
<Notes>Spese di trasporto</Notes>
</WebOrderRow>
<WebOrderRow>
<RowType>PaymentExpenses</RowType>
<Quantity>1</Quantity>
<PriceIncludingVAT>5.00</PriceIncludingVAT>
<CurrencyType>
<Code>EUR</Code>
</CurrencyType>
<Tax>
<Code>IVA0001</Code>
<PercentAmount>22.0</PercentAmount>
</Tax>
<Notes>Spese di incasso</Notes>
</WebOrderRow>
</DocRows>
<CurrencyType>
<Code>EUR</Code>
</CurrencyType>
<InvoiceRequested>true</InvoiceRequested>
<SourceSiteTotal>305.00</SourceSiteTotal>
<InsuranceAmount>305.00</InsuranceAmount>
<Courier>
<Name>DHL</Name>
</Courier>
<CourierService>
<Name>Servizio express</Name>
<HoldForPickup>false</HoldForPickup>
</CourierService>
<ShippingNotes>XXXXXXXXX</ShippingNotes>
<Notes>AAAAAAAAAA</Notes>
</WebOrder>
<WebOrder>
...
</WebOrder>
<WebOrder>
...
</WebOrder>
</WebOrders>
</ReadyFeed>
|
TAG |
|
Descrizione |
Tipo |
Valore di esempio |
|
<WebOrders> |
Obbligatorio |
Contiene un elenco di elementi <WebOrder> |
|
|
|
<WebOrder> |
Obbligatorio |
Oggetto che rappresenta un singolo ordine web |
|
|
|
<WebOrder>.<DocDate> |
Obbligatorio |
Data dell'ordine |
Date |
2011-08-30 |
|
<WebOrder>.<SourceSite> |
Obbligatorio |
Sito di origine da cui proviene l'ordine |
String (100) |
Amazon.com |
|
<WebOrder>.<OrderRef> |
Obbligatorio |
Identificativo univoco dell'ordine per la piattaforma (un ordine con una specifica combinazione OrderRef + SourceSite puo' essere importato una sola volta) |
String(50) |
1234-23222331 |
|
|
|
|
|
|
|
<WebOrder>.<Anag> |
Obbligatorio |
Oggetto che contiene l'anagrafica dell'intestatario dell'ordine |
|
|
|
<WebOrder>.<Anag>.<Name> |
Obbligatorio |
Intestatario dell'ordine : Ragione sociale |
String (100) |
Luigi Rossi |
|
<WebOrder>.<Anag>.<Address> |
Obbligatorio |
Intestatario dell'ordine : Indirizzo |
String (100) |
Via Garibaldi, 10 |
|
<WebOrder>.<Anag>.<ZipCode> |
|
Intestatario dell'ordine : CAP |
String (5) |
00100 |
|
<WebOrder>.<Anag>.<City> |
|
Intestatario dell'ordine : Citta' |
String(100) |
ROMA |
|
<WebOrder>.<Anag>.<Province> |
Obbligatorio |
Intestatario dell'ordine : Provincia (sigla) |
String(3) |
RM |
|
<WebOrder>.<Anag>.<CountryCode> |
|
Intestatario dell'ordine : Nazione (sigla) |
String(3) |
IT |
|
<WebOrder>.<Anag>.<EmailAddress> |
Consigliato |
Intestatario dell'ordine : Indirizzo email |
String (255) |
cliente@gmail.com |
|
<WebOrder>.<Anag>.<PhoneNumber> |
Consigliato |
Intestatario dell'ordine : Numero di telefono |
String (50) |
06-1234567 |
|
<WebOrder>.<Anag>.<CellularNumber> |
|
Intestatario dell'ordine : Numero di telefono cellulare |
String (30) |
333-2222222 |
|
<WebOrder>.<Anag>.<FaxNumber> |
|
Intestatario dell'ordine : Numero di fax |
String (50) |
06-1234567 |
|
<WebOrder>.<Anag>.<VatNumber> |
Consigliato |
Intestatario dell'ordine : Partita IVA |
String (50) |
12345678903 |
|
<WebOrder>.<Anag>.<PersonalID> |
|
Intestatario dell'ordine : Codice fiscale |
String (50) |
|
|
<WebOrder>.<Anag>.<LanguageRFC> |
|
Codice RFC della lingua da associare all'anagrafica del cliente (es. it-IT per italia, fr-FR per Francia, en-GB per inglese, ecc.). Lasciare il campo vuoto per non impostare una lingua specifica in anagrafica |
String (5) |
it-IT |
|
<WebOrder>.<Anag>.<EInvoiceAddress> |
|
Indirizzo di destinazione per le fatture elettroniche (puo' essere indicato un codice SDI di 7 caratteri, un indirizzo PEC oppure un codice IPA di 6 caratteri. Il sistema identifica automaticamente la tipologia di destinazione in base al formato ed alla dimensione del valore passato |
String (100) |
azienda@pec.it |
|
|
|
|
|
|
|
<WebOrder>.<DestinationAddress> |
|
Oggetto che indica la destinazione (se diversa dall'intestatario) |
|
|
|
<WebOrder>.<DestinationAddress>.<Name1> |
|
Destinazione : Nome o ragione sociale |
String(255) |
c/o Rossi Maria |
|
<WebOrder>.<DestinationAddress>.<Address1> |
|
Destinazione : Indirizzo |
String(255) |
|
|
<WebOrder>.<DestinationAddress>.<ZipCode> |
|
CAP |
String(5) |
|
|
<WebOrder>.<DestinationAddress>.<City> |
|
Destinazione : Citta' |
String(255) |
|
|
<WebOrder>.<DestinationAddress>.<Province> |
|
Destinazione : Provincia (sigla) |
String(3) |
|
|
<WebOrder>.<DestinationAddress>.<CountryCode> |
|
Destinazione : Nazione (sigla) |
String(3) |
|
|
<WebOrder>.<DestinationAddress>.<PhoneNumber> |
|
Destinazione : Numero di telefono (se diverso da quello dell'intestatario) |
String(50) |
06-12345678
|
|
|
|
|
|
|
|
<WebOrder>.<Payment>.<Code> |
. |
Pagamento : Codice (se specificato deve corrispondere al codice alternativo della tabella pagamenti codificata su Ready Pro) |
String(20) |
CC |
|
<WebOrder>.<Payment>.<Name> |
|
Pagamento : Descrizione |
String(100) |
Carta di credito |
|
|
|
|
|
|
|
<WebOrder>.<DocRows> |
Obbligatorio |
Oggetto che contiene le righe del corpo dell'ordine (indicate con uno o piu' elementi <WebOrderRow>) |
|
|
|
<WebOrder>.<DocRows>.<WebOrderRow> |
Obbligatorio |
Oggetto che contiene le specifiche di una singola riga del documento |
|
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<RowType> |
Obbligatorio |
Indica il tipo di riga. Puo' assumere due valori Product : per le linee di tipo articolo Discount : per le linee di sconto FreeLine : per le linee libere ShippingExpenses : per le linee relative alle spese di trasporto PaymentExpenses : per le linee relative alle spese di incasso (a partire da versione 2020.3.7) |
String(50) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Product> |
Obbligatorio per RowType=Product |
Oggetto che contiene le specifiche dell'articolo oggetto dell'ordine |
|
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Product>.<Code> |
Obbligatorio per RowType=Product |
Codice dell'articolo (deve corrispondere ad un codice articolo valido su Ready Pro) |
String(50) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Description> |
|
Descrizione per la linea dell'ordine. Per le linee di tipo "Product" questo valore, se specificato, ha priorita' sull'eventuale descrizione passata in WebOrderRow.Product.Name
Per le linee di tipo "ShippingExpenses" questo valore, se specificato, ha priorita' rispetto alla descrizione standard "SPESE DI TRASPORTO" |
String(255) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Quantity> |
Obbligatorio |
Quantita' dell'articolo |
Float |
2 |
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Price> |
Obbligatorio : solo se non specificato PriceIncludingVAT |
Prezzo IVA esclusa |
Float |
100 |
|
<WebOrder>.<DocRows>.<WebOrderRow>.<PriceIncludingVAT> |
Obbligatorio : solo se non specificato Price |
Prezzo IVA compresa |
Float |
121 |
|
<WebOrder>.<DocRows>.<WebOrderRow>.<DiscountPercent> |
|
Sconto (e' anche possibile specificare piu' sconti cumulati nella forma '20+5') |
String |
7.5 |
|
<WebOrder>.<DocRows>.<WebOrderRow>.<CurrencyType>.<Code> |
Se non specificato viene utilizzata la valuta di default dell'azienda |
Codice della valuta (deve corrispondere ad un codice valuta indicato sulla tabella valute di Ready Pro) |
String(10) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Tax>.<Code> |
Se non specificato viene utilizzata l'aliquota di default del cliente/azienda |
Codice dell'aliquota IVA (deve corrispondere ad un codice indicato sulla tabella aliquote di Ready Pro) |
String(10) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Tax>.<PercentAmount> |
|
Percentuale dell'aliquota IVA. Se non viene identificato il codice aliquota specificato nel nodo <Code> viene utilizzato per tentare di identificare il codice IVA da utilizzare |
Float |
21.0 |
|
<WebOrder>.<DocRows>.<WebOrderRow>.<Notes> |
|
Note di riga |
String(255) |
|
|
<WebOrder>.<DocRows>.<WebOrderRow>.<OrderDetailRef> |
|
Codice identificativo della riga sulla piattaforma di origine |
String(50) |
|
|
|
|
|
|
|
|
<WebOrder>.<CurrencyType>.<Code> |
Se non specificato viene utilizzata la valuta di default dell'azienda |
Codice della valuta (deve corrispondere ad un codice valuta indicato sulla tabella valute di Ready Pro) |
String(10) |
|
|
<WebOrder>.<InvoiceRequested> |
|
Indica se il cliente sulla piattaforma di origine ha richiesto espressamente che venga emessa fattura Passare il valore "1" oppure "TRUE" per indicare se il cliente sulla piattaforma di origine ha richiesto espressamente che venga emessa fattura |
String |
TRUE
|
|
<WebOrder>.<SourceSiteTotal> |
Consigliato |
Totale dell'ordine calcolato dalla piattaforma di origine. E' consigliato passare questo valore per fare in modo che Ready Pro possa avvisare l'operatore nel caso il totale dell'ordine importato differisca dal totale calcolato sulla piattaforma di origine (ad esempio per errori di importazione o differenze dovuto ad arrotondamenti) |
Float |
|
|
<WebOrder>.<InsuranceAmount> |
|
Valore merce da assicurare |
Float |
|
|
<WebOrder>.<Courier>.<Name> |
|
Vettore : Ragione sociale |
String(255) |
SDA |
|
<WebOrder>.<CourierService>.<Name> |
|
Servizio vettore : Descrizione |
String(255) |
Consegna standard 24/48h |
|
<WebOrder>.<CourierService>.<HoldForPickup> |
|
Servizio vettore : Fermo deposito |
Boolean (True / False) |
TRUE |
|
<WebOrder>.<ShippingNotes> |
|
Note di consegna per il corriere |
String (65535) |
Consegnare al pomeriggio |
|
<WebOrder>.<Notes> |
|
Note per l'ordine |
String (65535) |
|
