Funzione: CustomersInvoices -> Create
Questa funzione permette la creazione di una fattura per un ordine cliente sul database.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| shop_id | obbligatorio | Il codice identificativo del negozio che vende il prodotto. | Numero |
| customer_id | obbligatorio | Il codice identificativo dell'anagrafica cliente. | Numero |
| product_id | obbligatorio | Il codice identificativo del prodotto. | Numero |
| description | obbligatorio | Descrizione dell'ordine (viene suggerita al momento della fatturazione). | Stringa di testo |
| entity_type | obbligatorio | La tipologia di anagrafica, deve essere popolata con il numero identificativo |
100 → Persona fisica 200 → Libero Professionista 300 → Ditta individuale 400 → Società 500 → Ente no profit 800 → Ente pubblico |
| customer_name | obbligatorio | Il nome dell'anagrafica cliente a cui è associato l'ordine. | Lasciare vuoto in caso di privato cittadino |
| code | facoltativo | Codice per uso interno. In caso se ne faccia uso per riconciliare il prodotto con altri software. |
Numero |
| code_ean | facoltativo | Codice EAN, in caso il prodotto ne sia dotato. | Codice EAN valido |
| code_taric | facoltativo | Codice TARIC, in caso il prodotto ne sia dotato. | Codice TARIC valido |
| code_cpv | facoltativo | Codice CPV, in caso il prodotto ne sia dotato. | Codice CPV valido |
| code_ssc | facoltativo | Codice SSC, in caso il prodotto ne sia dotato. | Codice SSC valido |
| 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%) |
| manager_id | obbligatorio | Il codice identificativo dell'utente creato su Sirio. | Il codice identificativo valido |
| manager_name | obbligatorio | Il nome assegnato all'utente creato su Sirio. | Stringa di testo |
| shop_id | obbligatorio | Il codice identificativo del negozio. | Il codice deve essere valido |
| shop_name | obbligatorio | Il nome del negozio. | Stringa di testo |
| num_invoices | obbligatorio | Il numero della fattura. | Numero progressivo (Lasciare vuoto per assegnarlo automaticamente) |
| invoiced_percentage | obbligatorio | Percentuale dell'importo fatturato. | Numero (es. 100 = 100%) |
| 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. | Data espressa nel formato: YYYY-MM-GG |
| amounts.order_unit.price | obbligatorio | Prezzo Unitario assegnato all'ordine | Importo |
| amounts.order_unit.discount | obbligatorio | Sconto Unitario assegnato all'ordine | Importo |
| amounts.order_unit.net | obbligatorio | importo Netto Unitario assegnato all'ordine | Importo |
| amounts.order_unit.vat | obbligatorio | Importo IVA Unitario assegnato all'ordine | Importo |
| amounts.order_unit.gross | obbligatorio | Importo Lordo Unitario assegnato all'ordine | Importo |
| amounts.order_total.price | obbligatorio | Prezzo Totale assegnato all'ordine | Importo |
| amounts.order_total.discount | obbligatorio | Sconto Totale assegnato all'ordine | Importo |
| amounts.order_total.net | obbligatorio | Importo Netto Totale assegnato all'ordine | Importo |
| amounts.order_total.vat | obbligatorio | Importo IVA Totale assegnato all'ordine | Importo |
| amounts.order_total.gross | obbligatorio | Importo Lordo Totale assegnato all'ordine | Importo |
| amounts.invoiced.price | obbligatorio | Importo fatturato | Importo |
| amounts.invoiced.discount | obbligatorio | Sconto fatturato | Importo |
| amounts.invoiced.net | obbligatorio | Importo netto fatturato | Importo |
| amounts.invoiced.vat | obbligatorio | Importo IVA fatturato | Importo |
| amounts.invoiced.gross | obbligatorio | Importo Lordo fatturato | Importo |
Risultato
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| customer_id | obbligatorio | Il codice cliente dell'anagrafica creata. | Il codice è un numero progressivo |
Esempi
Esempio di generazione di una fattura per un ordine di un cliente.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"shop_id" => 35,
"customer_id" => 83,
"invoice_num" => "1",
"invoice_date" => "2018-06-21",
"invoice_format" => "0",
"header_id" => "1",
"vat_collettability" => "1",
"customer_name" => "Bianchi Mario",
"vat_code":"09764231008",
"tax_code" => "BNCMRA54H25L808G",
"address_street" => "Via A",
"address_street_number" => "10",
"address_city" => "Milano",
"address_postalcode" => "20100",
"address_province" => "MI",
"address_countrycode" => "IT",
"supplementary" => [
"ImportoBollo" => 0
],
"payment_method" => "Pagato",
"orders" => [
[
"customer_order_id" => 33,
"description" => "3 confezioni",
"percentage" => 100,
"discount" => 0
]
],
"payments" => [
[
"number" => 1,
"percentage" => 100,
"delay" => 0
]
]
];
//Eseguo il comando
$customer_id = $sirio->sendCommand("customersInvoices", "create", $dataset);
Sirio - Il Gestionale è anche social!