Funzione: Customers -> Create
Questa funzione permette di creare una nuova anagrafica cliente sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| contact_type | obbligatorio | La tipologia di anagrafica. |
1 → Anagrafica Cliente 2 → Anagrafica Fornitore 3 → Anagrafica Dipendente |
| 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 |
| entity_nationalitycode | obbligatorio | La nazionalità dell'anagrafica | Sigla del paese in due cifre. Es: "IT" |
| org_name | solo se non è un privato | Denominazione Sociale dell'ente/azienda | Lasciare vuoto in caso di privato cittadino |
| org_vat_code | solo se non è un privato | Partita IVA o VAT Code | Stringa |
| org_tax_code | solo se non è un privato | Codice Fiscale Azienda | Stringa |
| 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_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_city | obbligatorio | Comune dell'indirizzo della sede legale | Stringa |
| contact_email | facoltativo | Indirizzo email del contatto | xxx@yyyy.tld |
| contact_tel | facoltativo | Numero di telefono del contatto | Stringa |
| contact_fax | facoltativo | Numero di fax del contatto | Stringa |
| hdmyu | facoltativo | Campo per impostare "Come ci hai conosciuto?" Questo campo è attualmente inutilizzato | lasciare vuoto |
| date_created | facoltativo | La data in cui il cliente è stato schedato. | Se vuoto viene inserita la data dell'importazione |
Risultato
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| customer_id | obbligatorio | Il codice cliente dell'anagrafica. | Il codice è un numero progressivo |
Esempi
Esempio di creazione di un'anagrafica cliente per un cittadino italiano.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"contact_type" => "1",
"entity_type" => 100,
"entity_nationalitycode" => "IT",
"name" => "Mario",
"surname" => "Rossi",
"tax_code" => "CODICEFISCALE",
"address_countrycode" => "IT",
"address_street" => "Corso Italia",
"address_street_number" => 83,
"address_city" => "roma",
"address_province" => "RO", //Massimo 2 caratteri
"address_postalcode" => "00100",
"contact_email" => "info@mario.rossi.tld",
"contact_tel" => "06.000000000",
"contact_mobile":"3330101010",
"contact_fax" => "02.000000000"
];
//Eseguo il comando
$customer_id = $sirio->sendCommand("customers", "create", $dataset);
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"contact_type" => "1",
"entity_type" => 200,
"entity_nationalitycode" => "IT",
"org_name" => "Mario Rossi Srl",
"org_vat_code" => "00000000000",
"org_tax_code" => "00000000000",
"name" => "Mario", //facoltativo
"surname" => "Rossi", //facoltativo
"address_countrycode" => "IT",
"address_street" => "Corso Italia",
"address_street_number" => 83,
"address_city" => "RM",
"address_province" => "Roma",
"address_postalcode" => 00100,
"contact_email":"mario.rossi@mail.com",
"contact_tel":"+39 02020202",
"contact_mobile":"+39 3403232323",
"contact_fax":"+39 02010101"
];
//Eseguo il comando
$customer_id = $sirio->sendCommand("customers", "create", $dataset);
Sirio - Il Gestionale è anche social!