Digital Distribution Web Services (DDWS) Manuale del servizio GetOrderDetails

Transcript

1 Digital Distribution Web Services (DDWS) Manuale del servizio GetOrderDetails

2 INDICE Cronologia delle revisioni Introduzione Panoramica Documentazione di supporto Operazioni preliminari Panoramica del servizio GetOrderDetails GetOrderList GetOrderDetails Vantaggi del servizio GetOrderDetails Informazioni di riferimento del servizio GetOrderDetails Schema di richiesta Schema di risposta GetOrderList GetOrderDetails Schema di errore Messaggi di richiesta Messaggio di richiesta - GetOrderDetails Messaggio di risposta Messaggio di risposta - GetOrderList Messaggio di risposta - GetOrderDetails Messaggi di errore Esempio di risposta di errore Manuale di riferimento dei servizi Web

3 Cronologia delle revisioni Versione Data Autore Commenti /10/2015 AR Aggiunta della sezione Cronologia delle revisioni /12/2015 AR Sezione aggiornata per riflettere le modifiche allo schema di risposta /12/2015 AR Aggiunta del campo serial_number nella sezione 3.2 Messaggio di risposta modificato nella sezione Messaggio di risposta modificato nella sezione /02/2016 RL Aggiunta dei campi item_po_number, billing_start_date, billing_end_date, billing_status, item_cancellation_transaction_date e cancellation_reason in order_items_array /02/2016 RL Aggiunta del campo recurring_po in order_header_array /02/2016 ER Aggiunta del campo sales_licence_type nella descrizione di order_items /03/2016 PL Aggiunta dei campi Street_2 e Street_3 nella sezione /05/2016 PL Aggiunta dei campi activity, type, transactiondate, previousqty e newqty nella sezione e aggiornamento della risposta di esempio nella sezione giugno 2016 FX Aggiunta del campo type e della lunghezza/formato di output nelle sezioni e Manuale di riferimento dei servizi Web

4 1 Introduzione 1.1 Panoramica La piattaforma Digital Distribution Web Service (DDWS) è una soluzione che consente ai partner di effettuare automaticamente gli ordini dei prodotti Autodesk e che prevede un'interazione minima ("low touch") da parte dei partner e nessun intervento ("zero touch") da parte di Autodesk. Questa nuova funzionalità aziendale aprirà la strada a vere e proprie transazioni basate sui servizi Web B2B tra i partner e Autodesk. Perché i partner possano implementare in modo efficace la piattaforma di servizi digitali di Autodesk, le società affiliate dovranno acquisire familiarità con i servizi Web REST, oauth e JSON. In una guida alla programmazione è disponibile un'applicazione client di esempio scritta nel linguaggio Ruby, per consentire agli sviluppatori delle società affiliate di usufruire dell'api dei servizi digitali. 1.2 Documentazione di supporto Autodesk Partner Developer Guide: questa guida fornisce ai partner informazioni utili per il processo di formazione e l'accesso ai servizi DDWS. Ha inoltre lo scopo di presentare ai partner la piattaforma di servizi digitali di Autodesk mediante istruzioni passo-passo che li guidino durante l'esecuzione delle attività iniziali necessarie per l'integrazione. Authentication API Documentation: questo documento illustra ai partner il processo di generazione delle credenziali, delle firme e dei token di accesso necessari per utilizzare le API dei servizi. Contiene inoltre informazioni per lo sviluppo di un'applicazione di integrazione di un partner, fornisce informazioni di base sull'integrazione dei servizi Web e illustra lo sviluppo di un'applicazione tipica. 2 Operazioni preliminari Durante il processo di formazione, i partner vengono associati a un Customer Specific Number (CSN) univoco e le loro applicazioni vengono registrate presso Autodesk. Per ulteriori informazioni sul processo di formazione, fare riferimento all'autodesk Partner Developer Guide. 4 Manuale di riferimento dei servizi Web

5 3 Panoramica del servizio GetOrderDetails Il servizio GetOrderDetails fornisce ai partner informazioni dettagliate sugli ordini, inclusi numeri di contratto, numeri di serie e informazioni sui prodotti, oltre ad altri campi. Questi dati sono presentati in un formato non elaborato e possono essere utilizzati nel sistema scelto da un partner. In questo documento sono descritti tutti gli scenari del servizio GetOrderDetails idonei per il recupero delle informazioni di un ordine all'interno dell'ambiente Autodesk. Il servizio include due operazioni per il recupero degli ordini, attivate in base all'input immesso nel servizio GetOrderDetails: GetOrderList GetOrderDetails 5 Manuale di riferimento dei servizi Web

6 3.1 GetOrderList Lo scopo di questa operazione è ottenere l'elenco degli ordini da un sistema backend qualora l'input includa solo un intervallo di date. La risposta includerà dati che consentiranno a un partner di rieseguire il servizio allo scopo di ottenere i dettagli dell'ordine. Quando il richiedente riceve la risposta e recupera le informazioni necessarie, chiama il servizio GetOrderDetails utilizzando numero cliente/numero ordine di acquisto/numero ordine di vendita come input. Per richiamare l'operazione, è necessario specificare i seguenti input: 1. customer_number 2. order_date_from 3. order_date_to 3.2 GetOrderDetails Lo scopo di questa operazione è ottenere i dettagli dell'ordine per un determinato input. Questa operazione può essere chiamata utilizzando i seguenti gruppi di input: 1. customer_number 2. Solo uno dei seguenti elementi: a. serial_number b. contract_number c. partner_po d. customer_po e. order_number Nota: la risposta dell'api GetOrderDetails conterrà solo un ordine valido. 3.3 Vantaggi del servizio GetOrderDetails 1. Un servizio Web REST leggero, facilmente eseguibile da qualsiasi applicazione tramite una connessione HTTP(s). 2. Informazioni in tempo reale sullo stato dell'ordine e relativo riferimento. 3. Accesso immediato alle informazioni sull'ordine disponibili. 6 Manuale di riferimento dei servizi Web

7 Elementi GetOrderDetails() Elementi GetOrderList() 4 Informazioni di riferimento del servizio GetOrderDetails 4.1 Schema di richiesta La tabella seguente include i dettagli dei parametri del messaggio di richiesta per GetOrderDetails. Elemento Tipo di campo Lunghezza/formato input Utilizzo customer_number Stringa Lunghezza: max 10 Obbligatorio order_date_from Data Formato: ISO 8601 Obbligatorio order_date_to Data Formato: ISO 8601 (intervallo di date non superiore ai 90 giorni) Obbligatorio customer_number Stringa Lunghezza: max 10 Obbligatorio contract_number Stringa Lunghezza: max 12 partner_po customer_po Stringa Stringa Lunghezza: max 35 Lunghezza: max 35 order_number Stringa Lunghezza: 10 È possibile trasmettere un solo elemento con customer_number serial_number Stringa Lunghezza: max Schema di risposta GetOrderList Per l'invio dell'intervallo di date, verranno visualizzate le colonne indicate di seguito. Campo Tipo di campo Lunghezza/formato di output sales_order_number Stringa Lunghezza: max 10 purchase_order_number Stringa Lunghezza: max 35 Descrizione Numero ordine SAP Generato dai sistemi Autodesk. Numero ordine di acquisto Generato dal partner e inviato nella richiesta PlaceOrder. 7 Manuale di riferimento dei servizi Web

8 order_date Data Formato: ISO 8601 Thh:mm:ss+00:00 (ad es T17:51: ) customer_po_number Stringa Lunghezza: max 35 document_type Stringa Lunghezza: max 10 customer_number Stringa Lunghezza: max 10 customer_name Stringa Lunghezza: max 35 status Stringa Risposta di conferma: "Completed", "Open" tracking_number Stringa Lunghezza: max 35 Data di elaborazione ordine Numero ordine di acquisto del cliente Appartiene al rivenditore che effettua l'ordine tramite un altro rivenditore/distributore. Tipo di documento Numero cliente Nome del cliente Stato dell'ordine Numero di riferimento GetOrderDetails Campo Tipo di Lunghezza/formato Descrizione campo di output status Stringa Risposta di conferma: "OK", "FAILED", "ERROR" Stato della richiesta order_header_array [serie di oggetti JSON] Campo order_date Stringa Formato: ISO 8601 Thh:mm:ss+00:00 (ad es T17:51: ) sales_order_number Stringa Lunghezza: max 10 purchase_order_number Stringa Lunghezza: max 35 customer_po_number Stringa Lunghezza: max 35 document_type Stringa Lunghezza: max 10 Descrizione Data di elaborazione ordine Numero ordine SAP Generato dai sistemi Autodesk. Numero ordine di acquisto Generato dal partner e inviato nella richiesta PlaceOrder. Numero ordine di acquisto del cliente Appartiene al rivenditore che effettua l'ordine tramite un altro rivenditore/distributore. Tipo di documento 8 Manuale di riferimento dei servizi Web

9 customer_number Stringa Lunghezza: max 10 customer_name Stringa Lunghezza: max 35 order_status Stringa Lunghezza: max 20 tracking_number Stringa Lunghezza: max 35 order_amount Stringa Lunghezza: max 15 tax_amount Stringa Lunghezza: max 13 contract_number Stringa Lunghezza: max 12 shipment_method Stringa Lunghezza: max 20 freight_charge Stringa Lunghezza: max 15 purchase_order_date Stringa Formato: ISO 8601 Thh:mm:ss+00:00 (ad es T17:51: ) contract_start_date Stringa Formato: ISO 8601 Thh:mm:ss+00:00 (ad es T17:51: ) contract_end_date Stringa Formato: ISO 8601 Thh:mm:ss+00:00 (ad es T17:51: ) contract_usage_type Stringa Lunghezza: max 3 recurring_po Stringa Lunghezza: max 40 Numero cliente Nome del cliente Stato dell'ordine Numero di riferimento Importo dell'ordine È il prezzo totale dell'ordine, che equivale al prezzo dei prodotti dell'ordine iniziale più il prezzo dei prodotti per la scadenza successiva, che verranno fatturati nel periodo di fatturazione successivo. Importo imposte Numero contratto È un numero univoco associato all'ordine principale. Metodo di spedizione Spese di trasporto Data ordine di acquisto Data di inizio del contratto È la data in cui inizierà la fatturazione. Corrisponde alla data dell'ordine, a meno che l'ordine non venga effettuato con una data di inizio futura. Data di fine del contratto È la data di scadenza dell'abbonamento. Per gli ordini ricorrenti, questo campo sarà uguale a XXXXX. Tipo di uso del contratto Numero PO ricorrente order_items_array [serie di oggetti JSON] sales_order_number Stringa Lunghezza: max 10 Numero ordine di vendita line_number Stringa Lunghezza: max 6 Numero riga 9 Manuale di riferimento dei servizi Web

10 Item_po_number Stringa Lunghezza: max 40 sku Stringa Lunghezza: max 18 sku_description Stringa Lunghezza: max 60 quantity Numero intero Lunghezza: max 15 unit_price Stringa Lunghezza: max 11 order_currency Stringa Lunghezza: max 5 net_value Stringa Lunghezza: max 15 product_key Stringa Lunghezza: max 30 group_name Stringa Lunghezza: max 35 serial_number Stringa Lunghezza: max 1300 current_serial_number Stringa Lunghezza: max 130 seats Stringa Lunghezza: max 10 deployment Stringa Lunghezza: max 1 carattere license_type Stringa Lunghezza: max 30 Numero ordine di acquisto voce È il numero di ordine generato dal partner e inviato con la richiesta PlaceOrder. Se la voce viene generata durante l'ordine iniziale, il valore sarà uguale a quello dell'elemento purchase_order_number a livello di intestazione. In caso contrario, se un prodotto viene aggiunto allo stesso contratto in un secondo momento, conterrà il numero dell'ordine di acquisto della richiesta. Numero materiale È il numero che consente di identificare il prodotto ordinato. Il formato di questo campo è identico a quello riportato sotto "001H T275" Descrizione materiale È la descrizione del prodotto ordinato. Quantità Prezzo unitario Rappresenta il prezzo di una postazione. Valuta È la valuta del valore monetario dell'ordine e viene definita in base alle impostazioni internazionali del partner che effettua l'ordine. Valore netto Codice prodotto Nome gruppo Vuoto se l'ordine è un rinnovo o si aggiungono postazioni Generato da Autodesk per identificare in modo univoco il prodotto. Vuoto se si tratta di un ordine iniziale o si aggiungono prodotti Numero di postazioni Per gli ordini di abbonamenti, questo campo è sempre uguale a 1. Per le licenze permanenti, rappresenta il numero di postazioni con licenza. Installazione client Tipo di licenza 10 Manuale di riferimento dei servizi Web

11 usage_type Stringa Lunghezza: max 3 Tipo di utilizzo license_description Stringa Lunghezza: max 155 Descrizione della licenza subs_id Stringa Lunghezza: max 48 ID abbonamento, solo ricorrente billing_start_date Stringa Formato: ISO 8601 Data di inizio fatturazione Thh:mm:ss+00:00 billing_end_date Stringa Formato: ISO 8601 Data di fine fatturazione Thh:mm:ss+00:00 (ad es T17:51: ) billing_status Stringa Stato fatturazione item_cancellation_transact ion_date Stringa Formato: ISO 8601 Data della transazione di annullamento elemento Thh:mm:ss+00:00 (ad es T17:51: ) cancellation_reason Stringa Lunghezza: max 40 Motivo annullamento sales_licence_type Stringa Lunghezza: max 30 "New" o "Renewal" order_partners_array [serie di oggetti JSON] sales_order_number Stringa Lunghezza: max 10 Numero ordine di vendita line_number Stringa Lunghezza: max 6 Numero riga partner_type Stringa Lunghezza: max 15 partner_number Stringa Lunghezza: max 10 contact_number Stringa Lunghezza: max 10 partner_name Stringa Lunghezza: max 80 street Stringa Lunghezza: max 30 street_2 Stringa Lunghezza: max 40 street_3 Stringa Lunghezza: max 40 po_box Stringa Lunghezza: max 10 city Stringa Lunghezza: max 25 Per ogni tipo di partner, verranno visualizzate tutte le informazioni corrispondenti. Tipi di partner: persona di contatto, rivenditore, utente finale, destinatario fatturazione, destinatario spedizione e Contract Manager. Numero partner Numero di contatto Nome partner Via Riga indirizzo 2 Riga indirizzo 3: Casella postale Città 11 Manuale di riferimento dei servizi Web

12 postal_code Stringa Lunghezza: max 10 Codice postale pobox_postal_code Stringa Lunghezza: max 10 Codice postale corrispondente alla casella postale country Stringa Lunghezza: max 15 Paese district Stringa Lunghezza: max 25 Quartiere region Stringa Lunghezza: max 3 Regione end_user_ Stringa Lunghezza: max 241 assetdetailslist [serie di oggetti JSON] serialnumber Stringa Lunghezza: max 18 Tutti i numeri di serie associati all'ordine registereddate Stringa Formato: ISO 8601 Data di registrazione per ogni numero di serie Thh:mm:ss+00:00 activity [serie di oggetti Elemento di assetdetailslist, elenco di JSON] type Stringa Lunghezza: max 15 transactiondate Stringa Formato: ISO 8601 Thh:mm:ss+00:00 previousqty Numero Lunghezza: max 15 newqty intero Numero intero Lunghezza: max 15 tracce di controllo Remove seat. In questa sezione vengono inseriti dati relativi agli scenari di rimozione delle postazioni. Data e ora di rimozione della postazione Numero di postazioni precedenti Numero di nuove postazioni welcomekitstatus Stringa Lunghezza: max 100 "Sent", "Not Sent" Nota: poiché ora esiste il servizio GetOrderDetails, il campo relativo allo stato del kit di benvenuto (welcomekitstatus) restituisce la risposta di default "Not Sent". Questo flag verrà aggiornato in futuro quando il servizio GetOrderDetails sarà stato completamente sviluppato. 4.3 Schema di errore Nome campo status message transactionid Descrizione Risposta di conferma: "OK", "FAILED", "ERROR" Messaggio di errore ID di transazione univoco (combinazione di numero di ordine e data/ora). Viene restituito solo in caso di esito positivo dell'operazione. 12 Manuale di riferimento dei servizi Web

13 4.4 Messaggi di richiesta Di seguito sono riportati alcuni esempi di richieste di GetOrderDetails Messaggio di richiesta - GetOrderDetails [Getting GetOrderList using Customer Number and Date Range] 01&order_date_to= Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> [Getting GetOrderDetails using Customer Number and Serial Number] stg.autodesk.com/v1/orders?customer_number= &order_date_from= stg.autodesk.com/v1/orders?customer_number= &serial_number=d Message Headers Content-Type: application/json Authorization: Bearer <<Access Token>> CSN: <<CSN>> signature: <<Signed Access Token>> timestamp: <<Timestamp for the signed Access Token>> 4.5 Messaggio di risposta Nota: Autodesk invia una risposta con la struttura seguente. In base alle proprie esigenze, i partner possono utilizzare strutture di risposta con formati diversi Messaggio di risposta - GetOrderList "status": "OK", "message": "elements": [ "order_list_array": [ 13 Manuale di riferimento dei servizi Web

14 "sales_order_number": " ", "purchase_order_number": "PONFRtes", "customer_po_number": "", "customer_number": " ", "customer_name": "newstgsasp endcomp", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "RCG-annual-renew No order date", "customer_po_number": "Cust po renew no orderdate", "customer_number": " ", "customer_name": "Sample Name", "status": "Being processed", "sales_order_number": " ", "purchase_order_number": "InitialOrderQTR1130", "customer_po_number": "", "customer_number": " ", "customer_name": "Initialorderqtr 1130", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "InitialOrderQTR1130A", "customer_po_number": "", "customer_number": " ", "customer_name": "Initialorderqtr 1130", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "AddSeat1130PT", "customer_po_number": " ", "customer_number": " ", "customer_name": "SAMPLE NAME", "status": "Completed", 14 Manuale di riferimento dei servizi Web

15 "sales_order_number": " ", "purchase_order_number": "testpo ", "customer_po_number": "", "customer_number": " ", "customer_name": "Sample Name", "status": "Being processed", "sales_order_number": " ", "purchase_order_number": "testpo ", "customer_po_number": "", "customer_number": " ", "customer_name": "Sample Name", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "testpo ", "customer_po_number": "", "customer_number": " ", "customer_name": "Sample Name", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "testpo ", "customer_po_number": "", "customer_number": " ", "customer_name": "Sample Name", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "RCG Initial Dec 01", "customer_po_number": " ", "customer_number": " ", "customer_name": "Sample Name", 15 Manuale di riferimento dei servizi Web

16 "status": "Being processed", "sales_order_number": " ", "purchase_order_number": "NewOrder1201PT", "customer_po_number": "", "customer_number": " ", "customer_name": "Neworder 1201Pt", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "RenewalOrder1201PT", "customer_po_number": "", "customer_number": " ", "customer_name": "Renewalorder 1201Pt", "status": "Completed", "sales_order_number": " ", "purchase_order_number": "ddwsmultiseattest2", "customer_po_number": "", "document_type": "Online Transaction", "customer_number": " ", "customer_name": "SEnterprises", "status": "Being processed", "sales_order_number": " ", "purchase_order_number": "functest_ ", "customer_po_number": "", "document_type": "Online Transaction", "customer_number": " ", "customer_name": "SEnterprises", "status": "Being processed", ] ] 16 Manuale di riferimento dei servizi Web

17 4.5.2 Messaggio di risposta - GetOrderDetails "status": "OK", "message": "elements": [ "order_header_array": [ "sales_order_number": " ", "purchase_order_number": "AddSeat1130PT", "customer_po_number": " ", "customer_number": " ", "customer_name": "Sample & Co", "order_status": "Completed",, "order_amount": "601.33", "tax_amount": "0.00", "contract_number": " ", "shipment_method": "IBLFMJDPIEDCAJFHIDGN", "freight_charge": "0.00", "purchase_order_date": " T00:00: ", "contract_start_date": " T00:00: ", "contract_end_date": " T00:00: ", "contract_usage_type": "COM", recurring_po : AddSeat1130PT-recurring-po ], "order_items_array": [ "sales_order_number": " ", "line_number": "000010", "item_po_number": " ", "sku": "765G T820", "sku_description": "BDSP 2015 TBP:QT SUB +1", "quantity": 1, "unit_price": "601.33", "order_currency": "USD", "net_value": "601.33", "product_key": "765G1", "group_name": "", "serial_number": "", "current_serial_number": " ", "seats": "1", "deployment": "S", "license_type": "New", "usage_type": "COM", "license_description": "Autodesk Building Design Suite Premium 2015", "subs_id": "", "billing_start_date": T00:00: , "billing_end_date": T00:00: , 17 Manuale di riferimento dei servizi Web

18 "billing_status": "N/A", "item_cancellation_transaction_date": null, "cancellation_reason": "", "sales_licence_type": "New" ], "order_partners_array": [ "sales_order_number": " ", "line_number": "000000", "partner_type": "Contact Person", "partner_number": "", "contact_number": " ", "partner_name": "InitialOrderQTR1130", "street": "Sample Ave", street_2 : Engineering Dept, street_3 : Office 5432, "po_box": "", "city": "San Jose", "postal_code": "98516", "pobox_postal_code": "", "country": "US", "district": "MARIN", "region": "CA", "end_user_ ": "initialorderqtr1130@ssttest.net" "sales_order_number": " ", "line_number": "000000", "partner_type": "Dealer", "partner_number": " ", "contact_number": " ", "partner_name": "Sample & Co", "street": "Buenavista St", "po_box": "PO BOX", "city": "Clearwater", "postal_code": " ", "pobox_postal_code": " ", "country": "US", "district": "PINELLAS", "region": "FL", "end_user_ ": "" "sales_order_number": " ", "line_number": "000000", "partner_type": "End User", "partner_number": " ", "contact_number": " ", "partner_name": "Sample & Co", "street": "Buenavista St", "po_box": "PO Box", "city": "Clearwater", 18 Manuale di riferimento dei servizi Web

19 "postal_code": " ", "pobox_postal_code": " ", "country": "US", "district": "PINELLAS", "region": "FL", "end_user_ ": "" "sales_order_number": " ", "line_number": "000000", "partner_type": "Bill to", "partner_number": " ", "contact_number": " ", "partner_name": "Sample & Co", "street": "Buenavista St", "po_box": "PO BOX", "city": "Clearwater", "postal_code": " ", "pobox_postal_code": " ", "country": "US", "district": "PINELLAS", "region": "FL", "end_user_ ": "" "sales_order_number": " ", "line_number": "000000", "partner_type": "Ship to", "partner_number": " ", "contact_number": " ", "partner_name": "Sample & Co", "street": "Buenavista St", "po_box": "PO BOX", "city": "Clearwater", "postal_code": " ", "pobox_postal_code": " ", "country": "US", "district": "PINELLAS", "region": "FL", "end_user_ ": "" "sales_order_number": " ", "line_number": "000000", "partner_type": "Contract Mgr", "partner_number": " ", "contact_number": " ", "partner_name": "Initialorderqtr 1130", "street": "Sample Ave", "po_box": "", "city": "San Jose", "postal_code": "98516", "pobox_postal_code": "", 19 Manuale di riferimento dei servizi Web

20 "country": "US", "district": "MARIN", "region": "CA", "end_user_ ": "" "sales_order_number": " ", "line_number": "000010", "partner_type": "Contact Person", "partner_number": "", "contact_number": " ", "partner_name": "InitialOrderQTR1130", "street": "Sample Ave", "po_box": "", "city": "San Jose", "postal_code": "98516", "pobox_postal_code": "", "country": "US", "district": "MARIN", "region": "CA", "end_user_ ": "sales_order_number": " ", "line_number": "000010", "partner_type": "Contract Mgr", "partner_number": " ", "contact_number": " ", "partner_name": "Initialorderqtr 1130", "street": "Sample Ave", "po_box": "", "city": "San Jose", "postal_code": "98516", "pobox_postal_code": "", "country": "US", "district": "MARIN", "region": "CA", "end_user_ ": "" ], "assetdetailslist": [ "serialnumber": " ", "registereddate": null "activity": [ "type": "Remove Seat", "transactiondate": " T23:03:52.000Z", "previousqty": "3", "newqty": 2 "type": "Remove Seat", 20 Manuale di riferimento dei servizi Web

21 "transactiondate": " T22:17:51.000Z", "previousqty": "2", "newqty": 1 ] ], "welcomekitstatus": "Not Sent" ] 4.6 Messaggi di errore La tabella seguente include i codici di errore con i rispettivi messaggi di errore presenti nei messaggi di risposta quando viene rilevato un errore: Numero Messaggio di errore messaggio 003 & non trovato. 013 Il parametro di input non è completo. 015 Numero di ordine non trovato. 016 Numero di ordine non trovato. 017 Il numero di serie specificato non è valido. 018 La durata deve essere inferiore ai novanta (90) giorni. UAN-GEN Il formato del numero di serie specificato non è corretto. UAN-GEN Specificare il numero cliente. UAN-GEN Immettere la data di inizio nel formato. UAN-GEN Immettere la data di inizio nel formato. UAN-GEN Immettere la data di fine nel formato. UAN-GEN Immettere la data di fine nel formato. UAN-INV La data di inizio deve essere precedente alla data di fine. UAN-GEN L'intervallo di date non deve essere superiore ai 90 giorni. Controllare i dati immessi e provare di nuovo. UAN-GEN Numero cliente non valido. Controllare i dati immessi e provare di nuovo. UAN-GEN Il numero cliente non può superare i 10. Controllare i dati immessi e provare di nuovo. UAN-GEN Specificare una combinazione di parametri valida. UAN-GEN Specificare i nomi dei parametri corretti. UAN-GEN Specificare un numero di ordine o un altro numero di documento valido. UAN-GEN Il numero di ordine deve contenere esattamente 10. Controllare i dati immessi e provare di nuovo. UAN-GEN Il numero dell'ordine di acquisto non può superare i 35. Controllare i dati immessi e provare di nuovo. Specificare almeno uno dei seguenti parametri: SerialNumber, ContractNumber, OrderNumber o PONumber. Il numero di serie specificato non è valido. APG-DWS-INV-002 Il numero cliente specificato non è valido. UAN-GEN Il PO del partner non può superare i 35. Controllare i dati immessi e provare di nuovo. 21 Manuale di riferimento dei servizi Web

22 UAN-GEN Il numero di contratto non può superare i 12. Controllare i dati immessi e provare di nuovo Esempio di risposta di errore "status": "Error", "transactionid": "INV ", "message": [ "error_code": " APG-DWS-INV-002", "error_message": "Provided customer number is invalid." ] Nota: questo manuale di riferimento del servizio è destinato all'utilizzo esclusivo dei legittimi destinatari e può contenere informazioni proprietarie e/o riservate di natura privilegiata o comunque protette dalla divulgazione. La revisione, l'uso, la divulgazione o la distribuzione non autorizzati sono vietati. 22 Manuale di riferimento dei servizi Web