Specifiche XML ordini

Creato il: 14.04.2020
Le funzionalita' descritte in questa pagina fanno riferimento ad una versione minima di Ready Pro v2020.3
L'importazione ordini avviene tramite una pagina web installata sul sito ecommerce, che deve restituire un elenco degli ordini ricevuti sul sito in formato XML (encoding dei caratteri Windows-1252).
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>
     </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>.<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>.<ShippingNotes>


Note di consegna per il corriere

String (65535)

Consegnare al pomeriggio

<WebOrder>.<Notes>


Note per l'ordine

String (65535)


Login