Funzione: CustomersOrders -> Update
Questa funzione permette di modificare i dati di un ordine cliente sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| customer_order_id | obbligatorio | Il codice identificativo dell'ordine. | Codice Numerico |
| customer_id | obbligatorio | Il codice cliente a cui verrà assegnato l'ordine. | Codice Numerico |
| product_id | obbligatorio | Il codice prodotto oggetto dell'ordine. | Codice Numerico |
| shop_id | facoltativo | Il codice negozio che emette l'ordine. | Lasciare vuoto per assegnarlo al negozio predefinito |
| manager_id | facoltativo | Il codice utente di Sirio che gestisce l'ordine. | Lasciare vuoto per non assegnarlo ad alcun utente |
| description | obbligatorio | Descrizione dell'ordine (verrà suggerita al momento della fatturazione). | Stringa di testo |
| unit | obbligatorio | Codice identificativo dell'unità di misura da usare per l'ordine. | Codice numerico: 1 = Kg 2 = mt 3 = Lt 4 = nr 5 = ore 6 = pz 7 = anni 8 = minuti 9 = giorni 10 = settimane 11 = mesi 12 = m² 13 = m³ |
| quantity | obbligatorio | Quantità. | Numero |
| price | obbligatorio | Prezzo unitario. | Numero |
| discount | obbligatorio | Sconto unitario. | Numero |
| vat_rate | obbligatorio | Aliquota dell'imposta IVA applicata all'ordine. | Numero intero. Es.: 22 (significa 22%) |
| vat_type | obbligatorio | Tipologia di imposta IVA applicata all'ordine. | Codice numerico: 0 = Imponibile 1 = Escluse ex art. 15 2 = Non soggetta 3 = Non imponibile 4 = Esente ex art. 10 5 = Regime del margine |
| socialsurcharge_rate Rivalsa INPS |
facoltativo | In caso l'ordine sia soggetto alla Rivalsa INPS è necessario inserire l'aliquota. | Numero intero. Es.: 4 (significa 4%) |
| socialfund_rate Cassa Previdenziale |
facoltativo | In caso l'ordine sia soggetto alla Cassa Previdenziale di un ordine è necessario inserire l'aliquota. | Numero intero. Es.: 4 (significa 4%) |
| withholding_base Ritenuta Fiscale - base |
facoltativo | Base imponibile della ritenuta fiscale applicata all'ordine. | Numero intero. Es.: 50 (significa 50%) Es.: 100 (significa 100%) |
| withholding_rate Ritenuta Fiscale - aliquota |
facoltativo | Aliquota della ritenuta fiscale applicata all'ordine. | Numero intero. Es.: 20 (significa 20%) Es.: 23 (significa 23%) |
| note | facoltativo | Campo libero per appuntare alcune note relative all'ordine. | Stringa di testo |
| date_start | facoltativo | In caso di servizi soggetti a ratei e risconti, identifica la data di inizio del servizio. | Data espressa nel formato: YYYY-MM-GG |
| date_end | obbligatorio se presente il campo date_start | In caso di servizi soggetti a ratei e risconti, identifica la data di fine del servizio. | Data espressa nel formato: YYYY-MM-GG |
| date_created | facoltativo | La data in cui l'ordine è stato caricato. | Se vuoto viene inserita la data dell'importazione |
Risultato
La funzione di update restituirà un oggetto con i dati aggiornati.
Per visualizzare la struttura di un oggetto "Ordine Cliente", guarda il risultato della funzione customersOrders->get
Esempi
Esempio di modifica di un ordine cliente esistente.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
// Parametri obbligatori
"customer_order_id" => 45,
"customer_id" => 4,
"product_id" => 3,
"shop_id" => 20,
"description" => "20 telefoni per cliente ABC",
"unit" => 6,
"quantity" => 20,
"price" => 4.000,
"discount" => 0,
"vat_rate" =>22,
"vat_type" => 0
// Parametri facoltativi
"status" => "5",
"socialsurcharge_rate" => "0",
"socialfund_rate" => "0",
"withholding_rate" => "0",
"withholding_base" => "100"
];
//Eseguo il comando
$customer_order_id = $sirio->sendCommand("customersOrders", "update", $dataset);
Sirio - Il Gestionale è anche social!