Funzione: SuppliersOrders -> Update
Questa funzione permette di modificare un ordine fornitore sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| supplier_order_id | obbligatorio | Il codice d'ordine unico. | Codice ordine fornitore valido |
| supplier_id | obbligatorio | Il codice identificativo del fornitore a cui è assegnato l'ordine. | Codice identificativo fornitore valido |
| cost_type_id | facoltativo | Il codice del centro di costo a cui l'ordine è associato. | Lasciare vuoto per assegnarlo non assegnare un centro di costo |
| operation_id | obbligatorio | La tipologia di operazione associata all'ordine. | Codice numerico: 0 = Acquisto standard 1 = Acconto/deposito 2 = Acquisto patrimoniale 3 = Rimborso |
| description | obbligatorio | Descrizione dell'ordine. | Stringa di testo |
| currency | obbligatorio | Codice di 3 lettere identificativo della divisa/valuta in cui avviene l'acquisto. | Sigla di 3 caratteri Es: EUR (per euro) Es: USD (per dollari) |
| price_currency | obbligatorio | Prezzo nella divisa scelta. | Numero |
| exchange_rate_effective | facoltativo | Tasso di cambio effettivamente applicato all'ordine. | Lasciare vuoto per farlo stimare automaticamente da Sirio |
| exchange_rate_forecast | obbligatorio se si è impostata una valuta diversa da EUR | Tasso di cambio previsto. | Viene stimato automaticamente da Sirio |
| change_fee | facoltativo | Importo della commissione sul cambio (espressa in euro). | Numero |
| vat | obbligatorio | Aliquota dell'imposta IVA applicata all'ordine. | Numero intero. Es.: 22 (significa 22%) |
| withholding_base | facoltativo | Base imponibile della ritenuta fiscale applicata all'ordine. | Numero intero. Es.: 50 (significa 50%) Es.: 100 (significa 100%) |
| withholding_tax | facoltativo | Ritenuta fiscale applicata all'ordine (espressa in euro). | Numero |
| date_order | facoltativo | La data in cui è stato effettuato l'ordine. | Data espressa nel formato: YYYY-MM-GG. 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 Fornitore", guarda il risultato della funzione suppliersOrders->get
Esempi
Esempio di modifica di un ordine esistente per uno specifico fornitore.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"supplier_order_id" => 15,
"supplier_id" => 4,
"cost_type_id" => "Produzione",
"operation_id" => 3,
"description" => "Cartucce stampante",
"currency" => "EUR",
"exchange_rate_forecast" => "1.0000",
"exchange_rate_effective":0,
"price_currency" => 15,
"change_fee" => 0,
"vat" => 22,
"withholding_tax" => 10
"date_order" => "2017-01-07"
];
//Eseguo il comando DA VERIFICARE
$supplier_order_id = $sirio->sendCommand("suppliersOrders", "update", $dataset);
Sirio - Il Gestionale è anche social!