Employee¶

Employee API – anagrafica dipendenti Zoho People.

Endpoint coperti:: GET /api/forms/P_EmployeeView/records – lista / ricerca dipendenti GET /api/forms/json/P_Employee/getDataByID – singolo dipendente per ID POST /api/forms/json/P_Employee/insertRecord – crea dipendente POST /api/forms/json/P_Employee/updateRecord – aggiorna dipendente

Scope richiesto: ZOHOPEOPLE.forms.ALL (o READ per sola lettura)

class zoho_people.api.employee.EmployeeAPI(client)[source]¶

Bases: object

Accesso all’anagrafica dipendenti di Zoho People.

Example

>>> # Lista tutti i dipendenti attivi (paginata)
>>> employees = client.employee.list(view_name="P_EmployeeView")

>>> # Ricerca per email
>>> emp = client.employee.get_by_email("mario.rossi@azienda.it")

>>> # Crea nuovo dipendente
>>> result = client.employee.create({
...     "First Name": "Mario",
...     "Last Name":  "Rossi",
...     "Email":      "mario.rossi@azienda.it",
...     "Employee ID": "EMP001",
... })

Parameters:: client (ZohoPeopleClient)

list(view_name='P_EmployeeView', s_index=1, rec_limit=200, search_column=None, search_value=None, modified_time=None)[source]¶

Recupera i dipendenti da una vista.

Parameters:

view_name (str) – Nome della vista (default P_EmployeeView).
s_index (int) – Indice di partenza per la paginazione (default 1).
rec_limit (int) – Numero di record per pagina (max 200, default 200).
search_column (str, optional) – EMPLOYEEID o EMPLOYEEMAILALIAS.
search_value (str, optional) – Valore da cercare nel campo search_column.
modified_time (int, optional) – Timestamp in ms: restituisce solo i record modificati dopo.

Returns:

Lista di record dipendente.

Return type:

list[dict]

get_all(view_name='P_EmployeeView', **kwargs)[source]¶

Auto-paginazione: recupera TUTTI i dipendenti dalla vista.

Attenzione: può generare molte chiamate API per organizzazioni grandi.

Parameters:: view_name (str)
Return type:: list[dict]

get_by_email(email)[source]¶

Recupera un dipendente tramite indirizzo email.

Return type:: dict or None
Parameters:: email (str)

get_by_id(employee_id)[source]¶

Recupera un dipendente tramite Employee ID (non erecno).

Return type:: dict or None
Parameters:: employee_id (str)

get_by_record_id(record_id)[source]¶

Recupera un dipendente tramite il suo record ID (erecno / Zoho.ID).

Parameters:: record_id (str) – Il valore di recordId / erecno restituito nelle liste.
Return type:: dict

create(data, input_type='json', form_link_name='P_Employee')[source]¶

Crea un nuovo dipendente.

Parameters:

data (dict) – Campi del dipendente nel formato {"First Name": "Mario", ...}.
input_type (str) – json (default) oppure xml.
form_link_name (str) – Nome del form (default P_Employee).

Returns:

Risposta con pkId (ID del record creato) e message.

Return type:

dict

update(record_id, data, input_type='json', form_link_name='P_Employee')[source]¶

Aggiorna un dipendente esistente.

Parameters:

record_id (str) – recordId / erecno del dipendente.
data (dict) – Campi da aggiornare.
input_type (str)
form_link_name (str)

Returns:

Risposta con pkId e message.

Return type:

dict