Funzione: Customers -> Update
Questa funzione permette l'aggiornamento dei dati dell'anagrafica di un cliente sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| customer_id | obbligatorio | Il codice cliente dell'anagrafica che si desidera aggiornare. | Numero |
| entity_type | obbligatorio |
La tipologia di anagrafica, deve essere popolata con il numero identificativo
In caso l'anagrafica sia una persona fisica, l'entity type non può più essere modificato.
|
100 → Persona fisica 200 → Libero Professionista 300 → Ditta individuale 400 → Società 500 → Ente no profit 800 → Ente pubblico |
| org_name | solo se non è un privato | Denominazione Sociale dell'ente/azienda | Lasciare vuoto in caso di privato cittadino |
| name | obbligatorio | Nome del Cliente o dell'amministratore | Stringa |
| surname | obbligatorio | Cognome del Cliente o dell'amministratore | Stringa |
| tax_code | obbligatorio solo se è un privato | Codice Fiscale del Cliente o dell'amministratore | Stringa |
| address_street | obbligatorio | Indirizzo della sede legale | Stringa |
| address_street_number | obbligatorio | Numero civico della sede legale | Stringa |
| address_city | obbligatorio | Comune dell'indirizzo della sede legale | Stringa |
| address_province | obbligatorio | Provincia | In caso di sede legale italiana è necessario usare la sigla a due cifre. Es.: "MI". |
| address_postalcode | obbligatorio | CAP: Codice di Avviamento Postale dell'indirizzo della sede legale | In caso di sede legale italiana è necessario specificarlo di 5 cifre. Es.: "20090". |
| address_countrycode | obbligatorio | Paese della sede legale | Sigla del paese in due cifre. Es: "IT" |
| contact_tel | facoltativo | Numero di telefono del contatto | Stringa |
| contact_fax | facoltativo | Numero di fax del contatto | Stringa |
| contact_email | facoltativo | Indirizzo email del contatto | xxx@yyyy.tld |
| contact_mobile | facoltativo | Numero di cellulare del contatto | Stringa |
| date_created | facoltativo | La data in cui il negozio è stato schedato. | 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 "Anagrafica Cliente", guarda il risultato della funzione customers->get
Esempi
Esempio di modifica di un'anagrafica cliente per un cittadino italiano.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"customer_id" => 3,
"name" => "Mario",
"surname" => "Rossi",
"address_countrycode" => "IT",
"address_street" => "Corso Italia",
"address_street_number" => 83,
"address_province" => "RO", //Massimo 2 caratteri
"address_postalcode" => "00100",
"address_city" => "RM",
"contact_email" => "info@mario.rossi.tld",
"contact_tel" => "06.000000000",
"contact_fax" => "02.000000000",
"contact_mobile" => "333.3333333"
];
//Eseguo il comando
$customer_id = $sirio->sendCommand("customers", "update", $dataset);
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"customer_id" => 45,
"entity_type" => 200,
"org_name" => "Mario Rossi Srl",
"name" => "Mario", //facoltativo
"surname" => "Rossi", //facoltativo
"tax_code" => "CODICEFISCALE", //facoltativo
"address_countrycode" => "IT",
"address_street" => "Corso Italia",
"address_street_number" => 83,
"address_province" => "RO", //Massimo 2 caratteri
"address_postalcode" => 00100,
"address_city" => "RM",
"contact_email" => "info@mario.rossi.tld",
"contact_tel" => "06.000000000",
"contact_fax" => "02.000000000",
"contact_mobile" => "333.3333333"
];
//Eseguo il comando
$customer_id = $sirio->sendCommand("customers", "update", $dataset);
Sirio - Il Gestionale è anche social!