Funzione: CustomersOrders -> Create
Questa funzione permette la creazione di un nuovo ordine cliente sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| 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 | obbligatorio | Il codice negozio che emette l'ordine. | Lasciare vuoto per assegnarlo al negozio predefinito |
| 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 |
| manager_id | facoltativo | Il codice utente di Sirio che gestisce l'ordine. | Lasciare vuoto per non assegnarlo ad alcun utente |
| manager_name | facoltativo | Il nome utente di Sirio che gestisce l'ordine. | Lasciare vuoto per non assegnarlo ad alcun utente |
| 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
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| customer_order_id | obbligatorio | Il codice d'ordine unico. | Il codice è un numero progressivo |
Esempi
Esempio di creazione di un nuovo ordine per un cliente.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
// Parametri obbligatori
"customer_id" => 3,
"product_id" => 2,
"shop_id" => 20,
"description" => "10 telefoni per cliente ABC",
"unit" => 6,
"quantity" => 10,
"price" => 2.000,
"discount" => 20,
"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", "create", $dataset);
/*
dataset:{
"customer_order_id":98
"shop_id":"18",
"customer_id":"142",
"product_id":"956",
"description":"descrizione",
"quantity":0,
"unit":"4",
"price":0,
"price_tot":0,
"discount":0,
"discount_tot":0,
"vat_type":"0",
"vat_rate":22,
"status":"5",
"socialsurcharge_rate":"0",
"socialfund_rate":"0",
"withholding_rate":"0",
"withholding_base":"100",
"date_start":null,
"date_end":null,
"date_created":null
}
*/
Sirio - Il Gestionale è anche social!