Funzione: Paychecks -> List
Questa funzione permette la ricerca dentro al database Buste paga.
Parametri
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| query | facoltativo |
Parametri di ricerca
Oggetto JSON tramite il quale è possibile specificare le chiavi di ricerca: (chiave = valore).
Vedere sezione oggetto query più sotto per maggiori spiegazioni |
Oggetto JSON |
| results | facoltativo | Numero dei risultati da visualizzare per pagina. |
Numero. Predefinito: 10 risultati |
| page | facoltativo |
Pagina da visualizzare
Il sistema crea un numero di pagine sfogliabili in base al numero di risultati della ricerca
e a quanti risultati si desidera vedere per pagina
results
|
Numero. Predefinito: pagina 1 |
| orderBy | facoltativo |
Ordine di visualizzazione dei risultati
Vedere sezione chiavi OrderBy supportate più sotto per maggiori spiegazioni
|
Stringa di testo contenente una chiave OrderBy supportata |
Oggetto Query
| Campo | Obbligatorio | Tipologia di ricerca | Descrizione | Valori Ammessi |
| contact_name | facoltativo | estesa | Nome del dipendente a cui è associata la busta paga. | Stringa di testo |
| date_paycheck | facoltativo | estesa | Data della busta paga. | Numero |
| month_competence | facoltativo | flag | Mese di competenza della busta paga. | Codice numerico:
1 → Gennaio 2 → Febbraio 3 → Marzo 4 → Aprile 5 → Maggio 6 → Giugno 7 → Luglio 8 → Agosto 9 → Settembre 10 → Ottobre 11 → Novembre 12 → Dicembre |
| year_competence | facoltativo | flag | Anno di competenza della busta paga. | Numero |
Chiavi OrderBy Supportate
| OrderBy | Descrizione |
| paycheck_id|ASC | Ordinato per codice identificativo della busta paga ascendente |
| paycheck_id|DES | Ordinato per codice identificativo della busta paga discendente |
| contact_name|ASC | Ordinato per nome dell'intestatario in ordine ascendente |
| contact_name|DES | Ordinato per nome dell'intestatario in ordine discendente |
Risultato
| Campo | Obbligatorio | Descrizione | Valori Ammessi |
| nav | obbligatorio | Oggetto contenente i dati di navigazione. | Oggetto JSON |
| nav.page | obbligatorio | Numero di pagina visualizzato | Numero |
| nav.tot_pages | obbligatorio | Numero di pagine totali | Numero |
| nav.results | obbligatorio | Numero di risultati per pagina visualizzati | Numero |
| nav.tot_results | obbligatorio | Numero di risultato totali della ricerca | Numero |
| nav.orderBy | obbligatorio | Ordine di ricerca realmente applicato | Stringa di testo. |
| dataset | obbligatorio | Oggetto contenente i risultati | Oggetto JSON |
| dataset[n] | facoltativo | Oggetto contenente il risultato n | Oggetto JSON |
Esempi
Esempio di ricerca di una busta paga inserita su Sirio.
require("SirioService.php");
//Creo l'oggetto per eseguire il servizio
$sirio = new SirioService();
//Parametri
$dataset = [
"q" => [ // "q" sta per "query"
"contact_name" => "Mario"
],
"r" => 20, // "r" sta per "results" , numero risultati per pagina
"p" => 1, // "p" sta per "page", numero della pagina da visualizzare
"s" => "paycheck_id|DES" // "s" sta per "sort"
];
//Eseguo il comando
$result = $sirio->sendCommand("paychecks", "list", $dataset);
/*
{
nav: {
page: 1,
tot_pages: 1,
results: 20,
tot_results: 10,
orderBy: "paycheck_id|DES"
},
dataset:
{
paycheck_id: 21,
employee_id: 2,
contact_name: Rossi Mario,
date_paycheck: 2018-09-24,
competence_month: 9,
competence_year: 2018,
time: 100.00,
days_vacation: 5.0,
days_absence: 2.0,
dataset: {
paycheck_id: 21,
date_paycheck: 2018-09-24,
employee_id: 2,
competence_month: 9,
competence_year: 2018,
amount_monthly: 3000,
time: 100,
days_vacation: 5,
days_absence: 2,
amount_autonomous: 0,
amount_compensation: 0,
amount_allowance: 0,
amount_bonus: 0,
inps_rate_employee: 9.19,
inps_rate_employer: 28.98,
inail_amount: 0,
tfr_status: 1,
quir_status: 0,
irpef_detraction0: 0,
irpef_detraction1: 0,
irpef_regional_amount: 0,
irpef_local_amount: 0,
irpef_local_deposit: 0,
tfr_refund: 0,
tfr_revaluation0: 0,
tfr_revaluation1: 0,
tfr_revaluation2: 0,
tfr_tax_capital: 0,
tfr_tax_revaluation: 0,
tax_bonus: 80,
tax_adjustment: 0,
expenses_adjustment: 0
},
results: {
paycheck_id: 21,
date_paycheck: 2018-09-24,
employee_id: 2,
competence_month: 9,
competence_year: 2018,
amount_monthly: 3000,
time: 100,
days_vacation: 5,
days_absence: 2,
amount_autonomous: 0,
amount_compensation: 0,
amount_allowance: 0,
amount_bonus: 0,
inps_rate_employee: 9.19,
inps_rate_employer: 28.98,
inail_amount: 0,
tfr_status: 1,
quir_status: 0,
irpef_detraction0: 0,
irpef_detraction1: 0,
irpef_regional_amount: 0,
irpef_local_amount: 0,
irpef_local_deposit: 0,
tfr_refund: 0,
tfr_revaluation0: 0,
tfr_revaluation1: 0,
tfr_revaluation2: 0,
tfr_tax_capital: 0,
tfr_tax_revaluation: 0,
tax_bonus: 80,
tax_adjustment: 0,
expenses_adjustment: 0,
days_max: 26,
days_working: 19,
amount_time: 3000,
amount_daily: 115.38461538461539,
amount_working: 2192.3076923076924,
amount_vacation: 576.9230769230769,
amount_expected: 2769.2307692307695,
amount_standard: 2769.2307692307695,
amount_gross: 2769.2307692307695,
inps_base: 2769,
inps_rate_total: 38.17,
inps_amount_employee: 254.47109999999998,
inps_amount_employer: 802.4562,
inps_net: 1056.9272999999998,
inps_amount_standard: 254.47109999999998,
inps_amount_autonomous: 0,
inps_amount_allowance: 0,
tfr_base: 2769.2307692307695,
tfr_amount: 191.28320512820514,
quir_amount: 0,
quir_relief: 0,
amount_tfr: 191.28320512820514,
irpef_standard_base: 2514.7596692307698,
irpef_standard: {
base_break1: 15000,
base_break2: 13000,
base_break3: 2177.116030769237,
base_break4: 0,
base_break5: 0,
rate_break1: 23,
amount_break1: 3450,
rate_break2: 27,
amount_break2: 3510,
rate_break3: 38,
amount_break3: 827.3040916923102,
rate_break4: 41,
amount_break4: 0,
rate_break5: 43,
amount_break5: 0,
rate: 25.80532905713126,
amount: 7787.30409169231
},
irpef_standard_rate: 25.80532905713126,
irpef_standard_gross: 648.9420076410258,
irpef_standard_net: 648.9420076410258,
irpef_autonomous_base: 0,
irpef_autonomous: {
base_break1: 0,
base_break2: 0,
base_break3: 0,
base_break4: 0,
base_break5: 0,
rate_break1: 23,
amount_break1: 0,
rate_break2: 27,
amount_break2: 0,
rate_break3: 38,
amount_break3: 0,
rate_break4: 41,
amount_break4: 0,
rate_break5: 43,
amount_break5: 0,
rate: 0,
amount: 0
},
irpef_autonomous_rate: 0,
irpef_autonomous_gross: 0,
irpef_autonomous_net: 0,
irpef_allowance_base: 0,
irpef_allowance: {
base_break1: 0,
base_break2: 0,
base_break3: 0,
base_break4: 0,
base_break5: 0,
rate_break1: 23,
amount_break1: 0,
rate_break2: 27,
amount_break2: 0,
rate_break3: 38,
amount_break3: 0,
rate_break4: 41,
amount_break4: 0,
rate_break5: 43,
amount_break5: 0,
rate: 0,
amount: 0
},
irpef_allowance_rate: 0,
irpef_allowance_gross: 0,
irpef_allowance_net: 0,
tfr_refund_gross: 0,
tfr_refund_withholding: 0,
tfr_refund_net: 0,
irpef_total: 648.9420076410258,
amount_withholding: 903.4131076410258,
amount_net: 1945.8176615897437,
amount_employer: 802.4562,
amount_total: 3651.6869692307696
},
amount_net: 1945.82,
amount_withholding: 903.41,
amount_employer: 802.46,
amount_tfr: 191.28,
tfr_refund: 0.00,
amount_total: 3651.69,
date_created: 2018-09-24 12:13:39,
file_id: null,
filename: null
},
{
...
},
{
...
}
}
}
*/
Sirio - Il Gestionale è anche social!