ATTENZIONE: Il progetto attualmente è ancora in fase di sviluppo e potrebbe venire arricchito con altre funzioni.
L'endpoint di riferimento si trova all'indirizzo https://api.bipro.it/pm2/ws
, pertanto le richieste sono nel formato https://api.bipro.it/pm2/ws/operazione/
.
I parametri ID
e UID
, che vanno inseriti in tutte le richieste come parametri GET nella URL, identificano l'utente di BiPro che esegue la chiamata.
Tale utente deve essere un utente attivo in BiPro e deve avere profilo "Admin".
Tutte le richieste restituiscono in risposta un tracciato in formato JSON.
Nel caso in cui la richiesta non vada a buon fine viene restituito un tracciato analogo al seguente:
{ "valid": false, "message": "dettaglio errore" }
La richiesta generica contiene una lista di errori comuni a tutte le richieste, mentre eventuali altri errori specifici ad una funzione sono elencati nella sezione della funzione stessa.
Formato dei parametri
Tipo | Descrizione | Esempio |
---|---|---|
string | Stringa | "stringa" |
integer | Numero intero | "123" |
double | Numero decimale | "123,45" |
boolean | Variabile booleana | "true" o "false" |
date | Data nel formato GG/MM/AAAA | "01/01/2022" |
time | Orario nel formato HH:MM | "12:34" |
https://api.bipro.it/pm2/ws/info/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
ID | GET | integer | Identificativo dell'utente che esegue la chiamata |
UID | GET | string | Codice di 36 caratteri relativo all'utente |
{ valid (boolean), idAzienda (integer): ID assegnato da BiPro all'azienda, RagioneSociale (string): Nome azienda, DataScadenzaLicenza (date): Data scadenza licenza, username (string): Username dell'utente che esegue la richiesta, API_DisponibiliMinuto (integer): numero di chiamate ai web service ancora disponibili nell'arco di 60 secondi, API_DisponibiliOra (integer): numero di chiamate ai web service ancora disponibili nell'arco di 60 minuti }
{ "valid": true, "idAzienda": "1", "RagioneSociale": "Bianchi s.r.l.", "DataScadenzaLicenza": "31/12/2022", "username": "rossi.mario", "API_DisponibiliMinuto": "28", "API_DisponibiliOra": "497" }
https://api.bipro.it/pm2/ws/get_sedi/
[ { idSede (integer): ID della sede, Sede (string): Nome della sede }, { ... } ]
[ { "idSede": "100", "Sede": "Milano" }, { "idSede": "101", "Sede": "Roma" }, ... ]
https://api.bipro.it/pm2/ws/get_profili_utenti/
[ { idProfiloUtente (integer): ID del profilo, ProfiloUtente (string): Nome del profilo utente }, { ... } ]
[ { "idProfiloUtente": "1", "ProfiloUtente": "Admin" }, { "idProfiloUtente": "2", "ProfiloUtente": "Operatore" }, { "idProfiloUtente": "3", "ProfiloUtente": "Project Manager" }, { "idProfiloUtente": "4", "ProfiloUtente": "Operatore con accesso completo ai report" } ]
https://api.bipro.it/pm2/ws/get_utente/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idUtente | GET | integer | ID assegnato da BiPro all'utente |
Username | GET | string |
{ valid (boolean), idUtente (integer): ID assegnato da BiPro all'utente, Attivo (boolean): true se è un utente attivo (se false non può accedere e compilare il timesheet), idProfiloUtente (integer): ID del profilo utente, ProfiloUtente (string): Profilo utente, CodiceUtenteExt (string): Codice del utente esterno (es. assegnato dal gestionale), idSede (integer): ID della sede di riferimento per l'utente, Sede (string): Sede di riferimento per l'utente, Cognome (string): Cognome, Nome (string): Nome, Username (string): Username, idResponsabile (integer): ID dell'utente responsabile, Responsabile (string): Nome e cognome del reponsabile, NotaSpese (boolean): true se abilitato alla compilazione delle note spese, CodiceBadge (string): Codice del badge utente, NumeroRapporto (string): Numero rapporto del contratto dell'utente, CodiceDipendente (string): Codice dipendente, TipoCosto (string): può assumere i valori "mensile" o "orario" a seconda della modalità scelta per la determinazione del costo aziendale, CostoKmUtente (double): Costo chilometrico dell'utente (per rimborso Km percorsi); se non valorizzato viene applicato il costo definito a livello aziendale, CF (string): Codice fiscale, Sesso (string): Sesso, DataNascita (date): Data di nascita, LuogoNascita (string): Luogo di nascita, Nazionalita (string): Nazionalità, Residenza (string): Residenza, Telefono (string): Telefono, Cellulare (string): Cellulare, Email (string): Email, IBAN (string): IBAN, Banca (string): Banca, CostiOrari (array): Lista dei costi orari definiti per l'utente con relativo periodo di validità (solo se utente ha impostato come tipologia di costo 'Orario') } CostiOrari { DataDa (date): data di inizio validità del costo orario, DataA (date): data di fine validità del costo orario, CostoOrario (double): Costo orario }
{ "valid": true, "idUtente": "66", "Attivo": true, "idProfiloUtente": "1", "ProfiloUtente": "Admin", "CodiceUtenteExt": "ABC123", "idSede": "1", "Sede": "Milano", "Cognome": "Neri", "Nome": "Matteo", "Username": "matteo", "idResponsabile": "69", "Responsabile": "Bianchi Luigi", "NotaSpese": true, "CodiceBadge": "999", "NumeroRapporto": "X111", "CodiceDipendente": "Y222", "TipoCosto": "mensile", "CostoKmUtente": "0,500", "CF": "NERLUI79B11F205V", "Sesso": "M", "DataNascita": "11/02/1979", "LuogoNascita": "Milano", "Nazionalita": "Italiana", "Residenza": "Via Roma 1, Milano", "Telefono": "02.1234567", "Cellulare": "329.00000000", "Email": "matteo.neri@bipro.it", "IBAN": "IT000000000000000000000000000", "Banca": "Banca Intesa Sanpaolo", "CostiOrari": [ { "DataDa": "01/01/2020", "DataA": "31/12/2020", "CostoOrario": "30,000" }, { "DataDa": "01/01/2021", "DataA": "31/12/2030", "CostoOrario": "35,000" }] }
https://api.bipro.it/pm2/ws/get_utenti/
[ { idUtente (integer): ID assegnato da BiPro all'utente, UtenteUID (unique identifier): Codice identificatore univoco assegnato da BiPro all'utente, Attivo (boolean): true se è un utente attivo (se false non può accedere e compilare il timesheet), idProfiloUtente (integer): ID del profilo utente, ProfiloUtente (string): Profilo utente, idSede (integer): ID della sede di riferimento per l'utente, Sede (string): Sede di riferimento per l'utente, Cognome (string): Cognome, Nome (string): Nome, Username (string): Username, CostoOrarioAttuale (double): Costo orario valido alla data odierna (solo se utente ha impostato come tipologia di costo 'Orario') }, { ... } ]
[ { "idUtente": "752", "UtenteUID": "16365A20-9497-45AC-A2B5-06FA325D0F61", "Attivo": true, "idProfiloUtente": "3", "ProfiloUtente": "Operatore", "idSede": "1", "Sede": "Milano", "Cognome": "Rossi", "Nome": "Luigi", "Username": "rossi.mario", "CostoOrarioAttuale": "30,00" }, { "idUtente": "954", "UtenteUID": "47622448-YT85-4FED-AB46-13079B1739C5", "Attivo": true, "idProfiloUtente": "2", "ProfiloUtente": "Operatore", "idSede": "1", "Sede": "Milano", "Cognome": "Verdi", "Nome": "Antonio", "Username": "verdi.antonio", "CostoOrarioAttuale": "" } ]
https://api.bipro.it/pm2/ws/set_utente/
Parametro | Modalità | Tipo | Vincoli / Lunghezza min-max | Note |
---|---|---|---|---|
idUtente | POST | integer | ID assegnato da BiPro all'utente; identifica l'utente di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo utente | |
Attivo | POST | boolean | true=attivo; false=non attivo; obbligatorio | |
idProfiloUtente | POST | integer | ID del profilo utente (cfr web-service get_profili_utenti ) |
|
CodiceUtenteExt | POST | string | max 100 | Codice del utente esterno (es. assegnato dal gestionale) |
idSede | POST | integer | ID della sede di riferimento per l'utente (cfr web-service get_sedi ); opzionale da utilizzare nel caso sia attiva l'opzione multi-sede, altrimenti BiPro assegnerà in automatico la prima o unica sede censita nel programma |
|
Cognome | POST | string | min 1, max 50 | |
Nome | POST | string | min 1, max 50 | |
Username | POST | string | min 6, max 20, solo caratteri alfanumerici, il punto e underscore | |
Password | POST | string | min 6, max 20, solo caratteri alfanumerici, il punto e underscore | Da valorizzare solo per nuovi utenti |
idResponsabile | POST | integer | ID dell'utente responsabile (campo idUtente del web-service get_utente ) |
|
NotaSpese | POST | boolean | true se abilitato alla compilazione delle note spese; default=false | |
CodiceBadge | POST | string | max 32 | Codice del badge utente |
NumeroRapporto | POST | string | max 20 | Numero rapporto del contratto dell'utente |
CodiceDipendente | POST | string | max 20 | Codice dipendente |
TipoCosto | POST | string | può assumere i valori "mensile" (default) o "orario" a seconda della modalità scelta per la determinazione del costo aziendale | |
CostoKmUtente | POST | double | Costo chilometrico dell'utente (per rimborso Km percorsi); se non valorizzato viene applicato il costo definito a livello aziendale | |
CF | POST | string | max 16 | Codice fiscale |
Sesso | POST | string | max 16 | può assumere i valori "M" (maschio) o "F" (femmina) |
DataNascita | POST | date | Data di nascita | |
LuogoNascita | POST | string | max 50 | Luogo di nascita |
Nazionalita | POST | string | max 50 | Nazionalità |
Residenza | POST | string | max 100 | |
Telefono | POST | string | max 50 | |
Cellulare | POST | string | max 50 | |
POST | string | max 100 | ||
IBAN | POST | string | max 27 | |
Banca | POST | string | max 50 |
{ valid (boolean), message (string): Cliente creato/aggiornato, idUtente (integer): ID assegnato da BiPro all'utente }
{ "valid": true, "message": "Utente creato", "idUtente": "1" }
https://api.bipro.it/pm2/ws/set_password/
Parametro | Modalità | Tipo | Vincoli / Lunghezza min-max | Note |
---|---|---|---|---|
idUtente | POST | integer | ID assegnato da BiPro all'utente; identifica l'utente di cui eseguire l'aggiornamento della passoword; obbligatorio | |
Password | POST | string | min 6, max 20, solo caratteri alfanumerici, il punto e underscore | Da valorizzare solo per nuovi utenti |
{ valid (boolean), message (string): Password aggiornata }
{ "valid": true, "message": "Password aggiornata" }
https://api.bipro.it/pm2/ws/del_utente/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idUtente | POST | integer | ID assegnato da BiPro all'utente; identifica l'utente da eliminare (cfr web-service get_utenti o get_utente ) |
{ valid (boolean), message (string): Utente eliminato }
{ "valid": true, "message": "Utente eliminato" }
https://api.bipro.it/pm2/ws/get_cliente/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idCliente | GET | integer | ID assegnato da BiPro al cliente |
CodiceCliente | GET | string | Codice del cliente (alfanumerico) |
PI | GET | string | Partita iva del cliente |
{ valid (boolean), idCliente (integer): ID assegnato da BiPro al cliente, CodiceCliente (string): Codice cliente, CodiceClienteExt" (integer): Codice del cliente esterno (es. assegnato dal gestionale), RagioneSociale (string): Nome o ragione sociale del cliente, Referente (string): Nome referente, PI (string): Partita IVA, CF (string): Codice fiscale, idCanale (string): ID assegnato da BiPro as canale di provenienza, Canale (string): Canale di provenienza, Telefono (string): Telefono, Fax (string): Fax, Email (string): Email, SitoWeb (string): Sito internet, Indirizzo (string): Indirizzo, CAP (string): CAP, Citta (string): Città, Provincia (string): Sigla della provincia, TariffaOrariaCliente (double): Tariffa oraria predefinita per il cliente, Antiriciclaggio: (boolean): true se ricevuta documentazione relativa all'antiriciclaggio, Privacy: (boolean): true se ricevuta autorizzazione privacy }
{ "valid": true, "idCliente": "1", "CodiceCliente": "BIA", "CodiceClienteExt": "123", "RagioneSociale": "Bianchi srl", "Referente": "Rossi Mario", "PI": "01234567891", "CF": "01234567891", "idCanale": "1", "Canale": "Sito internet", "Telefono": "021234567", "Fax": "021234567", "Email": "emai@cliente.it", "SitoWeb": "www.cliente.it", "Indirizzo": "Via Italia 18", "CAP": "20100", "Citta": "MILANO", "Provincia": "MI", "Antiriciclaggio": "false", "Privacy": "true" }
https://api.bipro.it/pm2/ws/get_clienti/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
[ { idCliente (integer): ID assegnato da BiPro al cliente, CodiceCliente (string): Codice cliente, CodiceClienteExt (integer): codice del cliente dell'azienda, RagioneSociale (string): Nome o ragione sociale del cliente }, { ... } ]
[ { "idCliente": "1", "CodiceCliente": "ROS", "CodiceClienteExt": "456", "RagioneSociale": "Rossi s.r.l." }, { "idCliente": "2", "CodiceCliente": "BIA", "CodiceClienteExt": "789", "RagioneSociale": "Bianchi S.p.A." } ]
https://api.bipro.it/pm2/ws/set_cliente/
Parametro | Modalità | Tipo | Vincoli / Lunghezza min-max | Note |
---|---|---|---|---|
idCliente | POST | integer | ID assegnato da BiPro al cliente; identifica il cliente di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo cliente | |
RagioneSociale | POST | string | min 1, max 250 | Nome del cliente |
CodiceCliente | POST | string | min 2, max 10. Solo caratteri alfanumerici, il meno e il trattino basso | Codice del cliente |
CodiceClienteExt | POST | integer | Codice del cliente esterno (es. assegnato dal gestionale) | |
idCanale | POST | integer | ID assegnato da BiPro al canale di provenienza (cfr web-service get_canali ) |
|
Referente | POST | string | max 250 | |
PI | POST | string | max 11 | Partita iva |
CF | POST | string | max 16 | Codice fiscale |
Indirizzo | POST | string | max 250 | |
Citta | POST | string | max 100 | |
CAP | POST | string | max 10 | |
PV | POST | string | max 2 | Sigla della provincia |
Telefono | POST | string | max 50 | |
FAX | POST | string | max 50 | |
POST | string | max 100 | ||
SitoWeb | POST | string | max 100 | |
TariffaOrariaCliente | POST | double | Tariffa oraria predefinita da applicare al cliente | |
NoteCliente | POST | string | max 500 | |
Antiriciclaggio | POST | boolean | impostare a true se ricevuta documentazione relativa all'antiriciclaggio | |
Privacy | POST | boolean | impostare a true se ricevuta autorizzazione privacy |
{ valid (boolean), message (string): Cliente creato/aggiornato, idCliente (integer): ID assegnato da BiPro al cliente }
{ "valid": true, "message": "Cliente creato", "idCliente": "1" }
https://api.bipro.it/pm2/ws/del_cliente/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idCliente | POST | integer | ID assegnato da BiPro al cliente; identifica il cliente da eliminare (cfr web-service get_clienti o get_cliente ) |
{ valid (boolean), message (string): Cliente eliminato }
{ "valid": true, "message": "Cliente eliminato" }
https://api.bipro.it/pm2/ws/get_fornitore/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idFornitore | GET | integer | ID assegnato da BiPro al fornitore |
PI | GET | string | Partita iva del fornitore |
{ valid (boolean), idFornitore (integer): ID assegnato da BiPro al fornitore, RagioneSociale (string): Nome o ragione sociale del fornitore, Referente (string): Nome referente, PI (string): Partita IVA, CF (string): Codice fiscale, Telefono (string): Telefono, Fax (string): Fax, Email (string): Email, PEC (string): PEC, CodiceDestinatario (string): Codice SDI, SitoWeb (string): Sito internet, Indirizzo (string): Indirizzo, CAP (string): CAP, Citta (string): Città, Provincia (string): Sigla della provincia, NoteFornitore (string): Note, StatoFornitore (string): Stato di qualifica del fornitore, DataQualifica (date): Data di qualifica del fornitore, IBAN (string): IBAN, ClasseMerceologica (string): Classe merceologica }
{ "valid": true, "idFornitore": "2", "RagioneSociale": "Verdi s.r.l.", "Referente": "Rossi Mario", "PI": "00000000000", "CF": "00000000000", "Telefono": "02.01234567", "Fax": "02.01234567", "Email": "verdi@bipro.it", "PEC": "verdi@pec.it", "CodiceDestinatario": "AB12345", "SitoWeb": "www.verdi.it", "Indirizzo": "Via Roma 1", "CAP": "20100", "Citta": "Milano", "Provincia": "MI", "NoteFornitore": "Descrizione fornitore", "StatoFornitore": "Qualificato", "DataQualifica": "01/01/2022", "IBAN": "", "ClasseMerceologica": "Imballaggi" }
https://api.bipro.it/pm2/ws/get_fornitori/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
[ { idFornitore (integer): ID assegnato da BiPro al fornitore, RagioneSociale (string): Nome o ragione sociale del fornitore, PI (string): PI del fornitore }, { ... } ]
[ { "idFornitore": "1", "RagioneSociale": "Rossi s.r.l.", "PI": "01234567890" }, { "idFornitore": "2", "RagioneSociale": "Bianchi S.p.A.", "PI": "01234567891" } ]
https://api.bipro.it/pm2/ws/set_fornitore/
Parametro | Modalità | Tipo | Vincoli / Lunghezza min-max | Note |
---|---|---|---|---|
idFornitore | POST | integer | ID assegnato da BiPro al fornitore; identifica il fornitore di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo fornitore | |
RagioneSociale | POST | string | min 1, max 250 | Nome del fornitore |
Referente | POST | string | max 250 | |
PI | POST | string | max 11 | Partita iva |
CF | POST | string | max 16 | Codice fiscale |
Indirizzo | POST | string | max 250 | |
Citta | POST | string | max 100 | |
CAP | POST | string | max 10 | |
PV | POST | string | max 2 | Sigla della provincia |
Telefono | POST | string | max 50 | |
FAX | POST | string | max 50 | |
POST | string | max 100 | ||
PEC | POST | string | max 100 | |
CodiceDestinatario | POST | string | max 20 | Codice SDI |
SitoWeb | POST | string | max 100 | |
NoteFornitore | POST | string | max 500 | Note libere |
idStatoFornitore | POST | integer | Stato di qualifica del fornitore: 1=In fase di qualifica; 2=Qualificato; 3=Sospeso | |
DataQualifica | POST | date | Data di qualificazione del fornitore | |
IBAN | POST | string | max 27 | |
ClasseMerceologica | POST | string | max 100 | Classe merceologica |
{ valid (boolean), message (string): Fornitore creato/aggiornato, idFornitore (integer): ID assegnato da BiPro al fornitore }
{ "valid": true, "message": "Fornitore creato", "idFornitore": "1" }
https://api.bipro.it/pm2/ws/del_fornitore/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idFornitore | POST | integer | ID assegnato da BiPro al fornitore; identifica il fornitore da eliminare (cfr web-service get_fornitori o get_fornitore ) |
{ valid (boolean), message (string): Fornitore eliminato }
{ "valid": true, "message": "Fornitore eliminato" }
https://api.bipro.it/pm2/ws/get_progetto/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idProgetto | GET | integer | ID assegnato da BiPro al progetto |
CodiceProgetto | GET | string | Codice del progetto (alfanumerico) |
{ valid (boolean), idProgetto (integer): ID assegnato da BiPro al progetto, idCliente (integer): ID assegnato da BiPro al cliente, idStatoProgetto (integer): ID stato del progetto, StatoProgetto (string): Stato del progetto, CodiceProgetto (string): Codice del progetto, CodiceProgettoExt (integer): Codice del progetto esterno (es. assegnato dal gestionale aziendale), FeriePermessi (boolean): true se il progetto è riferito alle assenze (Ferie/Permessi/Malattie), RagioneSociale (string): Nome o ragione sociale del cliente, Progetto (string): Titolo del progetto, DescrizioneProgetto (string): Descrizione del progetto, DataInizioPrevista (date): Data prevista di inizio progetto, DataFinePrevista (date): Data prevista di fine progetto, GiorniProgettoPrevisti (double): Giorni previsti di progetto (da 8 ore), TotOreProgetto (double): Ore dichiarate sul progetto, TotGiorniProgetto (double): Giorni dichiarati sul progetto (da 8 ore), TotOreProgettoOggi (double): Ore dichiarate sul progetto fino alla data odierna (esclude eventuali attività future pianificate), TotGiorniProgettoOggi (double): Giorni dichiarati sul progetto fino alla data odierna (esclude eventuali attività future pianificate), AvanzamentoPercentualeProgetto (double): Percentuale giorni dichiarati rispetto ai giorni previsti, TariffaOrariaProgetto (double): Tariffa oraria predefinita per il progetto, RiferimentoContratto (string): Riferimento al contratto, RiferimentoOfferta (string): Riferimento all'offerta, Sede (string): Sede di riferimento per il progetto, Canale (string): Canale di provenienza del cliente, CodiceCliente (string): Codice cliente, idSettore (integer): ID assegnato da BiPro al Settore, Settore (string): Settore, idAreaBusiness (integer): ID assegnato da BiPro all'area di business, AreaBusiness (string): Area di business, idTipoProgetto (integer): ID assegnato da BiPro alla tipologia di progetto, TipoProgetto (string): Tipologia di progetto, idContratto (integer): ID assegnato da BiPro al contratto, CodiceContratto (string): Codice del contratto, DataContratto (date): Data del contratto, Utenti (array): Lista degli utenti assegnati al progetto con relative informazioni, Attivita (array): Lista delle attività di progetto, Ricavi (array): Lista dei ricavi abbinati al progetto, FattureAttive (array): Lista delle fatture attive abbinate al progetto, Costi (array): Lista dei costi abbinati al progetto, FatturePassive (array): Lista delle fatture passive abbinate al progetto } Utenti { idUtente (integer): ID assegnato da BiPro all'utente, Cognome (string): Cognome, Nome (string): Nome, Username (string): Username dell'utente, PM (boolean): true se l'utente è un PM del progetto, TariffaOraria (double): Tariffa dell'utente per il progetto (se non valorizzata viene considerata la tariffa generica del progetto o dell'utente), OreAssegnate (double): Ore assegnate all'utente sul progetto, OreLavorate (double): Ore dichiarate sul progetto da parte dell'utente } Attivita { idAttivita (integer): ID assegnato da BiPro all'attività del progetto, idStatoAttivita (integer): ID stato dell'attività, StatoAttivita (string): Stato dell'attività, CodiceAttivita (string): Codice dell'attività, Attivita (string): Denominazione dell'attività, TipoAssenza (string): Tipologia assenza (Ferie/Ex Fest/ROL) se progetto di tipo Ferie/Permessi/Malattie, DataInizioPrevista (date): Data prevista di inizio dell'attività, DataFinePrevista (date): Data prevista di fine dell'attività, GiorniAttivitaPrevisti (double): Giorni previsti di lavoro per l'attività (da 8 ore), TotOreAttivita (double): Ore dichiarate sull'attività, AvanzamentoPercentualeAttivita (double): Percentuale giorni dichiarati rispetto ai giorni previsti, CostoBudgetAttivita (double): Costo a budget per l'attività, RicavoBudgetAttivita (double): Ricavi a budget per l'attività } Ricavi { idRicavo (integer): ID assegnato da BiPro al ricavo, DataRicavo (date): Data prevista del ricavo, ImponibileRicavo (double): Imponibile del ricavo, Descrizione (string): Descrizione del ricavo, Note (string): Ulteriori annotazioni del ricavo } FattureAttive { idFatturaAttiva (integer): ID assegnato da BiPro alla fattura attiva, idRicavo (integer): ID del ricavo a cui la fattura si riferisce, DataFattura (date): Data della fattura, NrFattura (string): Numero della fattura, Imponibile (double): Totale imponibile della fattura, Pagato (double): Totale pagato, StatoFattura (string): Stato della fattura, DataScadenza (date): Data di scadenza della fattura, Descrizione (string): Descrizione della fattura } Costi { idCosto (integer): ID assegnato da BiPro al costo, DataCosto (date): Data prevista del costo, Imponibile (double): Imponibile del costo, Descrizione (string): Descrizione del costo, Fornitore (string): Ragione sociale del fornitore, Tipologia (string): Tipo di costo } FatturePassive { idFatturaPassiva (integer): ID assegnato da BiPro alla fattura passiva, idCosto (integer): ID del costo a cui la fattura si riferisce, Fornitore (string): Ragione sociale del fornitore, DataFattura (date): Data della fattura, NrFattura (string): Numero della fattura, Imponibile (double): Totale imponibile della fattura, Pagato (double): Totale pagato, DataScadenza (date): Data di scadenza della fattura, DataPagamento (date): Data di pagamento della fattura, Descrizione (string): Descrizione della fattura }
{ "valid": true, "idProgetto": "123", "idCliente": "456", "StatoProgetto": "Aperto", "CodiceProgetto": "BIA0004", "CodiceProgettoExt": "999", "FeriePermessi": false, "RagioneSociale": "Bianchi srl", "Progetto": "Assistenza", "DescrizioneProgetto": "Testo descrittivo del progetto", "DataInizioPrevista": "01/06/2022", "DataFinePrevista": "31/12/2022", "GiorniProgettoPrevisti": "10", "TotOreProgetto": "44,000", "TotGiorniProgetto": "5,500", "TotOreProgettoOggi": "40,000", "TotGiorniProgettoOggi": "5,000", "AvanzamentoPercentualeProgetto": "55,000", "TariffaOrariaProgetto": "30,50", "RiferimentoContratto": "12345", "RiferimentoOfferta": "98765", "Sede": "Milano", "Canale": "SMAU", "CodiceCliente": "BIA", "idSettore": "10", "Settore": "Edilizia", "idAreaBusiness": "20", "AreaBusiness": "Sviluppo software", "idTipoProgetto": "30", "TipoProgetto": "Chiavi in mano", "idContratto": "222", "CodiceContratto": "BIA001", "DataContratto": "15/05/2022", "Utenti": [ { "idUtente": "66", "Cognome": "Neri", "Nome": "Matteo", "Username": "neri.matteo", "PM": true, "TariffaOraria": "40,00", "OreAssegnate": "20,000", "OreLavorate": "18,000" }, { "idUtente": "160", "Cognome": "Rossi", "Nome": "Mario", "Username": "rossi.mario", "PM": false, "TariffaOraria": "20,00", "OreAssegnate": "40,000", "OreLavorate": "10,000" }, { "idUtente": "175", "Cognome": "Verdi", "Nome": "Luigi", "Username": "verdi.luigi", "PM": false, "TariffaOraria": "30,00", "OreAssegnate": "30,000", "OreLavorate": "35,000" }], "Attivita": [ { "idAttivita": "134", "idStatoAttivita": "5", "StatoAttivita": "Chiusa", "CodiceAttivita": "AAA", "Attivita": "Assistenza fino al 2021", "TipoAssenza": "", "DataInizioPrevista": "01/01/2021", "DataFinePrevista": "31/12/2021", "GiorniAttivitaPrevisti": "2,000", "TotOreAttivita": "12,000", "AvanzamentoPercentualeAttivita": "75,000", "CostoBudgetAttivita": "1.000,00", "RicavoBudgetAttivita": "2.000,00" }, { "idAttivita": "135", "idStatoAttivita": "3", "StatoAttivita": "Aperta", "CodiceAttivita": "BBB", "Attivita": "Assistenza 2022", "TipoAssenza": "", "DataInizioPrevista": "01/01/2022", "DataFinePrevista": "31/12/2022", "GiorniAttivitaPrevisti": "3,500", "TotOreAttivita": "14,000", "AvanzamentoPercentualeAttivita": "50,000", "CostoBudgetAttivita": "2.000", "RicavoBudgetAttivita": "3.500,00" }], "Ricavi": [ { "idRicavo": "133", "DataRicavo": "14/09/2022", "ImponibileRicavo": "3.000,00", "Descrizione": "Acconto progetto", "Note": "Dettaglio del ricavo" }, { "idRicavo": "158", "DataRicavo": "11/09/2012", "ImponibileRicavo": "3.000,00", "Descrizione": "30 giorni fine mese data fattura", "Note": "" }], "FattureAttive": [ { "idFatturaAttiva": "155", "idRicavo": "133", "DataFattura": "15/09/2022", "NrFattura": "44", "Imponibile": "3.000,00", "Pagato": "3.000,00", "StatoFattura": "Pagata", "DataScadenza": "14/04/2022", "Descrizione": "Acconto progetto" }], "Costi": [ { "idCosto": "3518", "DataCosto": "02/09/2022", "Imponibile": "2.000,00", "Descrizione": "Consulenza esterna", "Fornitore": "Rossi srl", "Tipologia": "Consulenze" }], "FatturePassive": [ { "idFatturaPassiva": "1628", "idCosto": "3518", "Fornitore": "Rossi srl", "DataFattura": "17/01/2022", "NrFattura": "19", "Imponibile": "2.000,00", "Pagato": "2.000,00", "DataScadenza": "31/01/2022", "DataPagamento": "31/01/2022", "Descrizione": "Descrizione fattura passiva" }] }
https://api.bipro.it/pm2/ws/get_progetti/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
idStatoProgetto | GET | integer | ID stato del progetto |
idCliente | GET | integer | ID assegnato da BiPro al cliente |
DataDa | GET | date | La data di inizio dovrà essere uguale o successiva |
DataA | GET | date | La data di inizio dovrà essere uguale o precedente |
[ { idProgetto (integer): ID assegnato da BiPro al progetto, idCliente (integer): ID assegnato da BiPro al cliente, CodiceProgetto (string): Codice del progetto, FeriePermessi (boolean): true se il progetto è riferito alle assenze (Ferie/Permessi/Malattie), RagioneSociale (string): Nome o ragione sociale del cliente, Progetto (string): Titolo del progetto, idStatoProgetto (integer): ID stato del progetto, StatoProgetto (string): Stato del progetto, DataInizioPrevista (date): Data prevista di inizio progetto, RiferimentoContratto (string): Riferimento al contratto, RiferimentoOfferta (string): Riferimento all'offerta }, { ... } ]
[ { "idProgetto": "7", "idCliente": "2", "CodiceProgetto": "VER0006", "FeriePermessi": false, "RagioneSociale": "Verdi S.p.A.", "Progetto": "Sviluppo programma", "idStatoProgetto": "5", "StatoProgetto": "Chiuso", "DataInizioPrevista": "15/01/2022", "RiferimentoContratto": "Rif X", "RiferimentoOfferta": "Rif Y" }, { "idProgetto": "16", "idCliente": "6", "CodiceProgetto": "ROS0015", "CodiceProgettoExt": "123", "FeriePermessi": false, "RagioneSociale": "Rossi s.r.l.", "Progetto": "Assistenza 2022", "idStatoProgetto": "3", "StatoProgetto": "Aperto", "DataInizioPrevista": "03/04/2022", "RiferimentoContratto": "Rif Z", "RiferimentoOfferta": "Rif K" } ]
https://api.bipro.it/pm2/ws/set_progetto/
Parametro | Modalità | Tipo | Vincoli / Lunghezza min-max | Note |
---|---|---|---|---|
idProgetto | POST | integer | ID assegnato da BiPro al progetto; identifica il progetto di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo progetto | |
idSede | POST | integer | ID assegnato da BiPro ala sede (cfr web-service get_sedi ); opzionale da utilizzare nel caso di sia attiva l'opzione multi-sede, altrimenti BiPro assegnerà in automatico la prima o unica sede censita nel programma |
|
idCliente | POST | integer | ID assegnato da BiPro al cliente (cfr web-service get_clienti ); identifica il cliente di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo cliente |
|
idStatoProgetto | POST | integer | ID stato del progetto (cfr web-service get_stati_progetti ); default=3 (aperto) |
|
FeriePermessi | POST | boolean | impostare a true se il progetto è riferito alle assenze (Ferie/Permessi/Malattie); default=false | |
MonoAttivita | POST | boolean | impostare a true se il progetto è costituito da una sola attività e nelle impostazioni è attiva l'opzione "Abilita progetti multi-attività"; default=true | |
NrProgetto | POST | integer | E' il valore numerico assegnato al progetto. Il codice progetto è infatti costituito dal codice cliente + il numero del progetto. Se non valorizzato verrà generato automaticamente come progressivo in base alle impostazioni definite nel programma (progressivo globale o per cliente) | |
CodiceProgettoExt | POST | integer | Codice del progetto esterno (es. assegnato dal gestionale aziendale) | |
Progetto | POST | string | min 1, max 250 | Titolo del progetto |
DescrizioneProgetto | POST | double | max 500 | Titolo del progetto |
DataInizioPrevista | POST | date | Data prevista di inizio progetto, obbligatoria | |
DataFinePrevista | POST | date | Data prevista di fine progetto | |
GiorniAttivitaPrevisti | POST | double | Numero di giornate di lavoro (da 8 ore) previste per il progetto; da valorizzare solo per progetti mono-attività, non nel caso di progetti con più attività abbinate | |
TariffaOrariaProgetto | POST | double | Tariffa oraria predefinita per il progetto | |
idContratto | POST | integer | ID assegnato da BiPro al contratto (cfr web-service get_contratti ); da usare solo se abilitata la gestione dei contratti |
|
RiferimentoContratto | POST | string | max 200 | Riferimento al contratto |
RiferimentoOfferta | POST | string | max 200 | Riferimento all'offerta |
idAreaBusiness | POST | integer | ID assegnato da BiPro all'area di business (cfr web-service get_aree_business ) |
|
idSettore | POST | integer | ID assegnato da BiPro al settore (cfr web-service get_settori ) |
|
idTipoProgetto | POST | integer | ID assegnato da BiPro alla tipologia di progetto (cfr web-service get_tipi_progetti ) |
{ valid (boolean), message (string): Progetto creato/aggiornato, idProgetto (integer): ID assegnato da BiPro al progetto }
{ "valid": true, "message": "Progetto creato", "idProgetto": "1" }
https://api.bipro.it/pm2/ws/set_progetto_attivita/
get_progetto
è possibile verificare l'elenco delle attività che costituiscono il progetto (array Attivita
).
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idAttivita | POST | integer | ID assegnato da BiPro all'utente (cfr web-service get_utente ), obbligatorio |
|
idProgetto | POST | integer | ID assegnato da BiPro al progetto (cfr web-service get_progetto ), obbligatorio |
|
idStatoAttivita | POST | integer | ID stato dell'attività (cfr web-service get_stati_attivita ); default=3 (aperto) |
|
Attivita | POST | string | min 1, max 250 | Nome dell'attività |
CodiceAttivita | POST | string | max 20 | Codice dell'attività |
DataInizioPrevista | POST | date | Data prevista di inizio attività | |
DataFinePrevista | POST | date | Data prevista di fine attività | |
GiorniAttivitaPrevisti | POST | double | Numero di giornate di lavoro (da 8 ore) previste per l'attività; da valorizzare solo per progetti mono-attività, non nel caso di progetti con più attività abbinate | |
CostoBudgetAttivita | POST | double | Costo a budget previsto per attività | |
RicavoBudgetAttivita | POST | double | Ricavo a budget previsto per attività |
{ valid (boolean), message (string): Attività di progetto creata/aggiornata }
{ "valid": true, "message": "Attività di progetto creata" }
https://api.bipro.it/pm2/ws/set_progetto_utente/
get_progetto
è possibile verificare l'elenco degli utenti abbinati ad un progetto (array Utenti
).
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idProgetto | POST | integer | ID assegnato da BiPro al progetto (cfr web-service get_progetto ), obbligatorio |
|
idUtente | POST | integer | ID assegnato da BiPro all'utente (cfr web-service get_utente ), obbligatorio |
|
TariffaOraria | POST | double | Tariffa oraria dell'utente per il progetto; se non valorizzata in fase di creazione di una nuova assegnazione progetto/utente verrà considerata la tariffa oraria impostata come generica sul progetto (se valorizzata) | |
OreAssegnate | POST | double | Numero di ore complessive assegnate all'utente sul progetto | |
OreAssegnateVincolanti | POST | boolean | impostare a true se l'utente non deve poter dichiarare più ore di quante gli sono state assegnate; default=false |
{ valid (boolean), message (string): Abbinamento utente/progetto creato/aggiornato }
{ "valid": true, "message": "Abbinamento utente/progetto creato" }
https://api.bipro.it/pm2/ws/del_progetto/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idProgetto | POST | integer | ID assegnato da BiPro al progetto; identifica il progetto da eliminare (cfr web-service get_progetti o get_progetto ) |
{ valid (boolean), message (string): Progetto eliminato }
{ "valid": true, "message": "Progetto eliminato" }
https://api.bipro.it/pm2/ws/del_progetto_attivita/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idAttivita | POST | integer | ID assegnato da BiPro all'attività di progetto; identifica l'attività da eliminare (cfr web-service get_progetto ) |
{ valid (boolean), message (string): Attività eliminata }
{ "valid": true, "message": "Attività eliminata" }
https://api.bipro.it/pm2/ws/del_progetto_utente/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idProgetto | POST | integer | ID del progetto (cfr web-service get_progetti o get_progetto ) |
idUtente | POST | integer | ID dell'utente (cfr web-service get_utenti o get_utente ) |
{ valid (boolean), message (string): Abbinamento progetto/utente eliminato }
{ "valid": true, "message": "Abbinamento progetto/utente eliminato" }
https://api.bipro.it/pm2/ws/get_stati_progetti/
[ { idStatoProgetto (integer): ID stato del progetto, StatoProgetto (string): stato del progetto }, { ... } ]
[ { "idStatoProgetto": "1", "StatoProgetto": "Da approvare" }, { "idStatoProgetto": "2", "StatoProgetto": "Non approvato" }, { "idStatoProgetto": "3", "StatoProgetto": "Aperto" }, { "idStatoProgetto": "4", "StatoProgetto": "Sospeso" }, { "idStatoProgetto": "5", "StatoProgetto": "Chiuso" } ]
https://api.bipro.it/pm2/ws/get_stati_attivita/
[ { idStatoAttivita (integer): ID stato dell'attività di progetto, StatoAttivita (string): stato dell'attività di progetto }, { ... } ]
[ { "idStatoAttivita": "1", "StatoAttivita": "Da approvare" }, { "idStatoAttivita": "2", "StatoAttivita": "Non approvata" }, { "idStatoAttivita": "3", "StatoAttivita": "Aperta" }, { "idStatoAttivita": "4", "StatoAttivita": "Sospesa" }, { "idStatoAttivita": "5", "StatoAttivita": "Chiusa" } ]
https://api.bipro.it/pm2/ws/get_tipi_attivita/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTipoAttivita | GET | integer | ID tipologia di attività |
[ { idTipoAttivita (integer): ID tipologia di attività, TipoAttivita (string): tipologia di attività, CodiceTipoAttivita (string): codice della tipologia di attività, idTipoAttivitaGruppo1 (integer): ID del gruppo della tipologia di attività, TipoAttivitaGruppo1 (integer): gruppo della tipologia di attività, TariffaFissa (double): se per la tipologia di attività va applicata una tariffa fissa e non oraria indicare in questo campo il valore da considerare, NonRetribuita (boolean): true se la tipologia di attività non è retribuita, VisibileATutti (boolean): true se la tipologia di attività deve essere visibile a tutti gli utenti, InMonteOre (boolean): true se la tipologia di attività deve essere considerata nel controllo del monte ore assegnato agli utenti }, { ... } ]
[ { "idTipoAttivita": "2", "TipoAttivita": "Programmazione", "CodiceTipoAttivita": "PRG", "idTipoAttivitaGruppo1": "1", "TipoAttivitaGruppo1": "Realizzazione", "TariffaFissa": false, "NonRetribuita": true, "VisibileATutti": true, "InMonteOre": true }, { "idTipoAttivita": "3", "TipoAttivita": "Analisi", "CodiceTipoAttivita": "ANL", "idTipoAttivitaGruppo1": "1", "TipoAttivitaGruppo1": "Realizzazione", "TariffaFissa": false, "NonRetribuita": false, "VisibileATutti": false, "InMonteOre": true }, ... ]
https://api.bipro.it/pm2/ws/get_tipi_attivita_gruppi/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTipoAttivitaGruppo | GET | integer | ID del gruppo |
[ { idTipoAttivitaGruppo (integer): ID del gruppo, TipoAttivitaGruppo (string): Nome del gruppo }, { ... } ]
[ { "idTipoAttivitaGruppo": "2", "TipoAttivitaGruppo": "Gruppo A" }, { "idTipoAttivitaGruppo": "3", "TipoAttivitaGruppo": "Gruppo B" }, ... ]
https://api.bipro.it/pm2/ws/set_tipo_attivita/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idTipoAttivita | POST | integer | ID assegnato da BiPro alla tipologia di attività; identifica la tipologia di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una nuova tipologia | |
TipoAttivita | POST | string | min 1, max 100 | Tipologia di attività |
CodiceTipoAttivita | POST | string | max 20 | Codice della tipologia |
idTipoAttivitaGruppo1 | POST | integer | ID identificativo del gruppo della tipologia di attività (cfr web-service get_gruppi_tipi_attivita ) |
|
TariffaFissa | POST | double | Se valorizzata alla tipologia di attività viene applicata una tariffa fissa e non oraria | |
NonRetribuita | POST | boolean | (default false) true se la tipologia di attività non è retribuita | |
VisibileATutti | POST | boolean | (default true) true se la tipologia di attività deve essere visibile a tutti gli utenti | |
InMonteOre | POST | boolean | (default false) true se la tipologia di attività deve essere considerata nel controllo del monte ore assegnato agli utenti |
{ valid (boolean), message (string): Tipologia di attività creata/aggiornata, idTipoAttivita (integer): ID assegnato da BiPro alla tipologia di attività }
{ "valid": true, "message": "Tipologia di attività creata", "idTipoAttivita": "1" }
https://api.bipro.it/pm2/ws/del_tipo_attivita/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTipoAttivita | POST | integer | ID assegnato da BiPro alla tipologia di attività; identifica la tipologia di attività da eliminare (cfr web-service get_tipi_attivita ) |
{ valid (boolean), message (string): Tipologia di attività eliminata }
{ "valid": true, "message": "Tipologia di attività eliminata" }
https://api.bipro.it/pm2/ws/get_luoghi/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idLuogoEsecuzioneAttivita | GET | integer | ID assegnato da BiPro al luogo (da usare per avere le informazioni di un singolo contratto) |
[ { idLuogoEsecuzioneAttivita (integer): ID assegnato da BiPro al luogo, LuogoEsecuzioneAttivita (string): Nome del luogo }, { ... } ]
[ { "idLuogoEsecuzioneAttivita": "1", "LuogoEsecuzioneAttivita": "Sede" }, { "idLuogoEsecuzioneAttivita": "2", "LuogoEsecuzioneAttivita": "Cliente" }, ... ]
https://api.bipro.it/pm2/ws/set_luogo/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idLuogoEsecuzioneAttivita | POST | integer | ID assegnato da BiPro al luogo: identifica il luogo di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo luogo | |
LuogoEsecuzioneAttivita | POST | string | min 1, max 50 | LuogoEsecuzioneAttivita |
{ valid (boolean), message (string): luogo creato/aggiornato, idLuogoEsecuzioneAttivita (integer): ID assegnato da BiPro al luogo }
{ "valid": true, "message": "luogo creato", "idLuogoEsecuzioneAttivita": "1" }
https://api.bipro.it/pm2/ws/del_luogo/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idLuogoEsecuzioneAttivita | POST | integer | ID assegnato da BiPro al luogo; identifica il luogo da eliminare (cfr web-service get_luoghi ) |
{ valid (boolean), message (string): Luogo eliminato }
{ "valid": true, "message": "Luogo eliminato" }
https://api.bipro.it/pm2/ws/get_contratti/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idCliente | GET | integer | ID assegnato da BiPro al cliente |
idContratto | GET | integer | ID assegnato da BiPro al contratto (da usare per avere le informazioni di un singolo contratto) |
[ { idContratto (integer): ID assegnato da BiPro al contratto, idCliente (integer): ID del cliente, RagioneSociale (string): Nome del cliente, idUtenteResponsabile (integer): ID dell'utente responsabile del contratto internamente all'azienda, ResponsabileContratto: (string): Nome dell'utente responsabile del contratto, CodiceContratto (string): codice del contratto, DataContratto (date): Data del contratto, DataInizioValidita (date): Data di inizio validità del contratto, DataFineValidita (date): Data di fine validità del contratto, ContrattoAttivo (boolean): true se il contratto è attivo, DataDisdetta (date): Data di disdetta del contratto, DataCessazione (date): Data cessazione del contratto, NoteContratto (string): Note, NumeroOfferta (string): Numero dell'offerta a cui il contratto si riferisce, DataOfferta (date): Data dell'offerta a cui il contratto si riferisce, ImportoComplessivo (double): Importo complessivo del contratto, TitoloContratto (string): Titolo del contratto, TipoContratto (string): Tipologia di contratto }, { ... } ]
[ { "idContratto": "1", "idCliente": "200", "RagioneSociale": "Bianchi Srl", "idUtenteResponsabile": "175", "ResponsabileContratto": "Verdi Mario", "CodiceContratto": "0123", "DataContratto": "10/12/2022", "DataInizioValidita": "01/12/2022", "DataFineValidita": "31/12/2022", "ContrattoAttivo": true, "DataDisdetta": "", "DataCessazione": "", "NoteContratto": "Testo descrittivo", "NumeroOfferta": "123", "DataOfferta": "01/12/2022", "ImportoComplessivo": "5.000,00", "TitoloContratto": "Contratto X", "TipoContratto": "Contratto prepagato" }, { "idContratto": "1", "idCliente": "200", "RagioneSociale": "Rossi SpA", "idUtenteResponsabile": "28", "ResponsabileContratto": "Arancio Luigi", "CodiceContratto": "X675", "DataContratto": "02/07/2022", "DataInizioValidita": "15/07/2022", "DataFineValidita": "31/12/2022", "ContrattoAttivo": true, "DataDisdetta": "", "DataCessazione": "", "NoteContratto": "Testo descrittivo", "NumeroOfferta": "456", "DataOfferta": "01/07/2022", "ImportoComplessivo": "19.000,00", "TitoloContratto": "Contratto Y", "TipoContratto": "Contratto chiavi in mano" }, ... ]
https://api.bipro.it/pm2/ws/set_contratto/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idContratto | POST | integer | ID assegnato da BiPro al contratto; da non valorizzare in caso di creazione di un nuovo contratto | |
idCliente | POST | integer | ID del cliente a cui il contratto si riferisce, obbligatorio | |
idUtenteResponsabile | POST | integer | ID dell'utente responsabile del contratto | |
CodiceContratto | POST | string | min 1, max 100 | Codice del contratto |
DataContratto | POST | date | Data del contratto, obbligatoria | |
DataInizioValidita | POST | date | Data inizio validità del contratto, obbligatoria | |
DataFineValidita | POST | date | Data fine validità del contratto | |
ContrattoAttivo | POST | boolean | Contratto attivo (true, valore di default) o non attivo (false) | |
DataDisdetta | POST | date | Data di disdetta del contratto | |
DataCessazione | POST | date | Data di cessazione del contratto | |
NoteContratto | POST | string | max 1000 | Note |
NumeroOfferta | POST | string | max 30 | Numero dell'offerta a cui il contratto si riferisce |
DataOfferta | POST | date | Data dell'offerta a cui il contratto si riferisce | |
ImportoComplessivo | POST | double | Importo complessivo del contratto | |
TitoloContratto | POST | string | max 300 | Titolo del contratto |
TipoContratto | POST | string | max 200 | Tipologia di contratto |
{ valid (boolean), message (string): Contratto creato/aggiornato, idContratto (integer): ID assegnato da BiPro al contratto }
{ "valid": true, "message": "Contratto creato", "idContratto": "1" }
https://api.bipro.it/pm2/ws/del_contratto/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idContratto | POST | integer | ID assegnato da BiPro al contratto; identifica il contratto da eliminare (cfr web-service get_contratti ) |
{ valid (boolean), message (string): Contratto eliminato }
{ "valid": true, "message": "Contratto eliminato" }
https://api.bipro.it/pm2/ws/get_aree_business/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idAreaBusiness | GET | integer | ID area di business |
[ { idAreaBusiness (integer): ID area di business, AreaBusiness (string): Area di business }, { ... } ]
[ { "idAreaBusiness": "2", "AreaBusiness": "Assistenza" }, { "AreaBusiness": "3", "TipoAttivita": "Consulenza" }, ... ]
https://api.bipro.it/pm2/ws/get_settori/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idSettore | GET | integer | ID settore |
[ { idSettore (integer): ID settore, Settore (string): Settore }, { ... } ]
[ { "idSettore": "2", "Settore": "Industria" }, { "idSettore": "3", "Settore": "Commercio" }, ... ]
https://api.bipro.it/pm2/ws/get_tipi_progetti/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTipoProgetto | GET | integer | ID tipologia di progetto |
[ { idTipoProgetto (integer): ID tipologia di progetto, TipoProgetto (string): Tipologia di progetto }, { ... } ]
[ { "idTipoProgetto": "1", "TipoProgetto": "Chiavi in meno" }, { "idTipoProgetto": "2", "TipoProgetto": "A fatturazione oraria" }, ... ]
https://api.bipro.it/pm2/ws/set_area_business/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idAreaBusiness | POST | integer | ID assegnato da BiPro all'area di business: identifica l'area di business di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una nuova area di business | |
AreaBusiness | POST | string | min 1, max 50 | Area di business |
{ valid (boolean), message (string): Area di business creata/aggiornata, idAreaBusiness (integer): ID assegnato da BiPro all'area di business }
{ "valid": true, "message": "Area di business creata", "idAreaBusiness": "1" }
https://api.bipro.it/pm2/ws/set_settore/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idSettore | POST | integer | ID assegnato da BiPro al settore: identifica il settore di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo settore | |
Settore | POST | string | min 1, max 50 | Settore |
{ valid (boolean), message (string): Settore creato/aggiornato, idSettore (integer): ID assegnato da BiPro al settore }
{ "valid": true, "message": "Settore creato", "idSettore": "1" }
https://api.bipro.it/pm2/ws/set_tipo_progetto/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idTipoProgetto | POST | integer | ID assegnato da BiPro alla tipologia di progetto: identifica la tipologia di progetto di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una nuova tipologia di progetto | |
TipoProgetto | POST | string | min 1, max 50 | TipoProgetto |
{ valid (boolean), message (string): Tipologia di progetto creata/aggiornata, idTipoProgetto (integer): ID assegnato da BiPro alla tipologia di progetto }
{ "valid": true, "message": "Tipologia di progetto creata", "idTipoProgetto": "1" }
https://api.bipro.it/pm2/ws/del_area_business/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idAreaBusiness | POST | integer | ID assegnato da BiPro all'area di business; identifica l'area di business da eliminare (cfr web-service get_aree_business ) |
{ valid (boolean), message (string): Area di business eliminata }
{ "valid": true, "message": "Area di business eliminata" }
https://api.bipro.it/pm2/ws/del_settore/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idSettore | POST | integer | ID assegnato da BiPro al settore; identifica il settore da eliminare (cfr web-service get_settori ) |
{ valid (boolean), message (string): Settore eliminato }
{ "valid": true, "message": "Settore eliminato" }
https://api.bipro.it/pm2/ws/del_tipo_progetto/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTipoProgetto | POST | integer | ID assegnato da BiPro alla tipologia di progetto; identifica la tipologia di progetto da eliminare (cfr web-service get_tipi_progetti ) |
{ valid (boolean), message (string): Tipologia di progetto eliminata }
{ "valid": true, "message": "Tipologia di progetto eliminata" }
https://api.bipro.it/pm2/ws/get_canali/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idCanale | GET | integer | ID canale |
[ { idCanale (integer): ID settore, Canale (string): Canale }, { ... } ]
[ { "idCanale": "2", "Canale": "Internet" }, { "idCanale": "3", "Canale": "Passaparola" }, ... ]
https://api.bipro.it/pm2/ws/set_canale/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idCanale | POST | integer | ID assegnato da BiPro al canale: identifica il canale di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di un nuovo canale | |
Canale | POST | string | min 1, max 100 | Canale |
{ valid (boolean), message (string): Canale creato/aggiornato, idCanale (integer): ID assegnato da BiPro al canale }
{ "valid": true, "message": "Settore creato", "idCanale": "1" }
https://api.bipro.it/pm2/ws/del_canale/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idCanale | POST | integer | ID assegnato da BiPro al canale; identifica il canale da eliminare (cfr web-service get_canali ) |
{ valid (boolean), message (string): Canale eliminato }
{ "valid": true, "message": "Canale eliminato" }
https://api.bipro.it/pm2/ws/get_ore_lavorabili/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idUtente | GET | integer | ID assegnato da BiPro all'utente (opzionale) |
DataDa | GET | date | La data di inizio del periodo richiesto |
DataA | GET | date | La data di fine del periodo richiesto (il periodo non deve superare i 365 giorni) |
[ { Utenti (array): Lista degli utenti con ore giornaliere assegnate nel periodo }, { ... } ] Utenti { idUtente (integer): ID assegnato da BiPro all'utente, Cognome (string): Cognome, Nome (string): Nome, OreLavorabili (array): Lista delle date del periodo considerato con ore giornaliere assegnate } OreLavorabili { Data (date): Data, Ore (double): Ore lavorabili previste per la data }
[{ "Utenti": [{ "idUtente": "100", "Cognome": "Rossi", "Nome": "Mario", "OreLavorabili": [{ "Data": "01/04/2022", "Ore": "8" }, { "Data": "02/04/2022", "Ore": "8" }, { "Data": "05/04/2022", "Ore": "0" }] }, { "idUtente": "101", "Cognome": "Verdi", "Nome": "Alessandra", "OreLavorabili": [{ "Data": "01/04/2022", "Ore": "6" }, { "Data": "02/04/2022", "Ore": "6" }, { "Data": "05/04/2022", "Ore": "0" }] } ] }]
https://api.bipro.it/pm2/ws/get_ore_mese_progetto/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idUtente | GET | integer | ID assegnato da BiPro all'utente (opzionale*) |
idProgetto | GET | integer | ID assegnato da BiPro al progetto (opzionale*) |
Anno | GET | integer | Anno di assegnazione (opzionale*) |
[ { Utenti (array): Lista degli utenti con ore giornaliere assegnate nel periodo }, { ... } ] Utenti { idUtente (integer): ID assegnato da BiPro all'utente, Cognome (string): Cognome, Nome (string): Nome, Ore (array): Lista delle assegnazioni di ore mensili per ciascun progetto } Ore { Anno (integer): Anno, Mese (integer): Mese, idProgetto (integer): ID assegnato da BiPro al progetto, Progetto (string): Titolo del progetto, Ore (double): Ore assegnate alla persona }
[{ "Utenti": [{ "idUtente": "120", "Cognome": "Rossi", "Nome": "Mario", "Ore": [{ "Anno": "2022", "Mese": "1", "idProgetto": "888", "Progetto": "Progetto A", "Ore": "48" }, { "Anno": "2022", "Mese": "1", "idProgetto": "999", "Progetto": "Progetto B", "Ore": "56" }, { "Anno": "2022", "Mese": "2", "idProgetto": "888", "Progetto": "Progetto A", "Ore": "24" }] }, { "idUtente": "121", "Cognome": "Verdi", "Nome": "Maria", "Ore": [{ "Anno": "2022", "Mese": "1", "idProgetto": "888", "Progetto": "Progetto A", "Ore": "12" }] } ] }]
https://api.bipro.it/pm2/ws/get_esecuzioni_attivita/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
idEsecuzioneAttivita | GET | integer | ID assegnato da BiPro all'attività dichiarata sul calendario; da utilizzare per recuperare le informazioni di una singola attività (se specificato questo valore non verranno considerati gli altri parametri di ricerca) |
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
idSede | GET | integer | ID della sede aziendale |
idUtente | GET | integer | ID dell'utente |
idResponsabile | GET | integer | ID del responsabile |
idCliente | GET | integer | ID del cliente |
idProgetto | GET | integer | ID del progetto |
idAttivita | GET | integer | ID dell'attività di progetto |
idTipoAttivita | GET | integer | ID della tipologia di attività |
idContratto | GET | integer | ID del contratto |
idSettore | GET | integer | ID del settore |
idAreaBusiness | GET | integer | ID dell'area di business |
idTipoProgetto | GET | integer | ID della tipologia di progetto |
idCanale | GET | integer | ID del canale di provenienza del cliente |
idLuogoEsecuzioneAttivita | GET | integer | ID del luogo di esecuzione dell'attività |
Retribuita | GET | boolean | non valirizzato=tutte; true=solo retribuite; false=solo non retribuite |
Fatturata | GET | boolean | non valirizzato=tutte; true=solo fatturate; false=solo non fatturate |
FeriePermessi | GET | boolean | non valirizzato=tutte; true=solo assenze; false=solo attività lavorative |
DataDa | GET | date | La data di esecuzione dell'attività dovrà essere uguale o successiva |
DataA | GET | date | La data di esecuzione dell'attività dovrà essere uguale o precedente |
[ { idEsecuzioneAttivita (integer): ID assegnato da BiPro all'esecuzione dell'attività, idUtente (integer): ID assegnato da BiPro all'utente, Cognome (string): Cognome dell'utente che ha effettuato l'attività, Nome (string): Nome dell'utente che ha effettuato l'attività, Data (date): Data in cui è stata effetturata l'attività, OraInizio (time): Ora di inizio dell'attività, OraFine (time): Ora di fine dell'attività, Minuti (integer): Durata dell'attività in minuti, CodiceProgetto (string): Codice del progetto, idCliente (integer): ID assegnato da BiPro al cliente, RagioneSociale (string): Nome o ragione sociale del cliente, idProgetto (integer): ID assegnato da BiPro al progetto, Progetto (string): Titolo del progetto, idAttivita (integer): ID assegnato da BiPro all'attività di progetto, Attivita (string): Titolo dell'attività di progetto, idTipoAttivita (integer): ID tipologia di attività, TipoAttivita (string): tipologia di attività, Numero (double): Numero di elementi oggetto dell'attività, TariffaAttivita (double): Tariffa complessiva dell'attività, idLuogoEsecuzioneAttivita (integer): ID assegnato da BiPro al luogo, LuogoEsecuzioneAttivita (string): Luogo di esecuzione dell'attività, CostoAttivita (double): Costo complessivo dell'attività, CostoOrario (double): Costo orario dell'attività, Fatturata (boolean): true se l'attività è identificata con fatturata al cliente, Note (string): Descrizione dell'attività svolta dall'utente, idSettore (integer): ID settore, Settore (string): Settore, idAreaBusiness (integer): ID area di business, AreaBusiness (string): Area di business, idTipoProgetto (integer): ID tipologia di progetto, TipoProgetto (string): Tipologia di progetto }, { ... } ]
[ { "idEsecuzioneAttivita":"1000", "idUtente":"7", "Utente":"Verdi Stefano", "Data":"04/02/2022", "OraInizio":"09:00", "OraFine":"11:00", "Minuti":"120", "CodiceProgetto":"INT0002", "idCliente":"", "RagioneSociale":"", "idProgetto":"867", "Progetto":"Progetto interno", "idAttivita":"661", "Attivita":"Amministrazione", "idTipoAttivita":"4", "TipoAttivita":"Interna", "Numero":"", "TariffaAttivita": "", "idLuogoEsecuzioneAttivita":"7", "LuogoEsecuzioneAttivita":"Sede", "CostoAttivita": "60,000", "CostoOrario": "30,000", "Fatturata": true, "Note":"Emissione fatture", "idSettore":"", "Settore":"", "idAreaBusiness":"", "AreaBusiness":"", "idTipoProgetto":"", "TipoProgetto":"" }, { "idEsecuzioneAttivita":"1001", "idUtente":"8", "Utente":"Bianchi Luigi", "Data":"19/02/2022", "OraInizio":"10:00", "OraFine":"11:00", "Minuti":"60", "CodiceProgetto":"ARA0016", "idCliente":"9", "RagioneSociale":"Arancio s.r.l.", "idProgetto":"17", "Progetto":"Sviluppo sito internet", "idAttivita":"432", "Attivita":"Analisi preliminare", "idTipoAttivita":"4", "TipoAttivita":"Incontro", "Numero":"", "TariffaAttivita": "50,00", "idLuogoEsecuzioneAttivita":"7", "LuogoEsecuzioneAttivita":"c/o cliente", "CostoAttivita": "30,00", "CostoOrario": "30,00", "Fatturata": true, "Note":"Incontro con responsabile per definizione delle specifiche", "idSettore":"15", "Settore":"Automotive", "idAreaBusiness":"22", "AreaBusiness":"Comunicazione", "idTipoProgetto":"30", "TipoProgetto":"Chiavi in mano" } ]
https://api.bipro.it/pm2/ws/set_esecuzione_attivita/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idEsecuzioneAttivita | POST | integer | ID assegnato da BiPro all'attività: identifica l'attività da modificare e di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una nuova attività | |
idUtente | POST | integer | ID dell'utente; obbligatorio (cfr web-service get_utenti o get_utente ) |
|
idAttivita | POST | integer | ID dell'attività di progetto; obbligatorio (il progetto è sempre identificato da questo campo; cfr web-service get_progetto ) |
|
idTipoAttivita | POST | integer | ID della tipologia di attività (cfr web-service get_tipi_attivita ) |
|
idLuogoEsecuzioneAttivita | POST | integer | ID del luogo di esecuzione dell'attività (cfr web-service get_luoghi ) |
|
Data | POST | date | min 10, max 10 (GG/MM/AAAA) | Data di esecuzione dell'attività; obbligatorio |
OraInizio | POST | time | min 5, max 5 (HH:MM) | Orario di inizio esecuzione dell'attività; da valorizzare solo se si usa la modalità "con orario" |
OraFine | POST | time | min 5, max 5 (HH:MM) | Orario di fine esecuzione dell'attività; da valorizzare solo se si usa la modalità "con orario" |
Ore | POST | time | double | Ore di esecuzione dell'attività; da valorizzare solo se si usa la modalità "senza orario"; nel caso "con orario" le ore saranno calcolate in automatico come differenza tra l'orario di inizio e fine |
Note | POST | string | max 500 | Testo libero descrittivo dell'attività svolta |
CodiceEsecuzioneAttivitaExt | POST | integer | Codice esterno dell'attività (es. assegnato dal gestionale aziendale) | |
Numero | POST | double | Eventuale numero di elementi oggetto dell'attività (es. numero di cedolini elaborati per un'attività di uno studio paghe) |
{ valid (boolean), message (string): Esecuzione attività creata/aggiornata, idEsecuzioneAttivita (integer): ID assegnato da BiPro all'attività }
{ "valid": true, "message": "Esecuzione attività creata", "idEsecuzioneAttivita": "1" }
https://api.bipro.it/pm2/ws/del_esecuzione_attivita/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idEsecuzioneAttivita | POST | integer | ID assegnato da BiPro all'attività; identifica l'attività da eliminare (cfr web-service get_esecuzioni_attivita ) |
{ valid (boolean), message (string): Esecuzione attività eliminata }
{ "valid": true, "message": "Esecuzione attività eliminata" }
https://api.bipro.it/pm2/ws/get_spese/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
idNotaSpese | GET | integer | ID assegnato da BiPro alla spesa; da utilizzare per recuperare le informazioni di una singola spesa (se specificato questo valore non verranno considerati gli altri parametri di ricerca) |
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
idUtente | GET | integer | ID dell'utente |
idCliente | GET | integer | ID del cliente |
idProgetto | GET | integer | ID del progetto |
DataDa | GET | date | La data della spesa dovrà essere uguale o successiva |
DataA | GET | date | La data della spesa dovrà essere uguale o precedente |
NonRimborsabile | GET | boolean | non valirizzato=tutte; true=solo spese non rimborsabili; false=solo spese rimborsabili |
AddebitoCliente | GET | boolean | non valirizzato=tutte; true=solo spese addebitabili al cliente; false=solo spese non addebitabili al cliente |
Approvazione | GET | boolean | non valirizzato=tutte; true=solo spese approvate; false=solo spese non approvate |
Fatturata | GET | boolean | non valirizzato=tutte; true=solo fatturate al cliente; false=solo non fatturate al cliente |
[ { idNotaSpese (integer): ID assegnato da BiPro alla spesa, idEsecuzioneAttivita (integer): ID assegnato da BiPro all'attività a cui la spesa è collegata, idUtente (integer): ID dell'utente che ha effettuato la spesa, Utente (string): Utente che ha effettuato l'attivit`, DataSpesa (date): Data in cui è stata effetturata la spesa, idNotaSpeseCategoria (integer): ID della categoria della spesa, NotaSpeseCategoria (string): Categoria della spesa, idNotaSpeseGiustificativo (integer): ID del giustificativo della spesa, NotaSpeseGiustificativo (string): Giustificativo della spesa, ImportoSpesa (double): Importo della spesa, Luogo (string): Luogo della spesa, Descrizione (string): Descrizione della spesa, idModalitaPagamento (integer): ID della modalità di pagamento della spesa, ModalitaPagamento (string): Modalità di pagamento della spesa, Km (double): Chilometri, nel caso di rimborso chilometrico, CostoKm (double): Costo chilometrico, nel caso di rimborso chilometrico, NonRimborsabile (boolean): true se la spesa non è rimborsabile, AddebitoCliente (boolean): true se la spesa è addebitabile al cliente, Approvazione (boolean): true se la spesa è approvata, Fatturata (boolean): true se la spesa è identificata con fatturata al cliente, idCliente (integer): ID assegnato da BiPro al cliente, RagioneSociale (string): Nome o ragione sociale del cliente, idProgetto (integer): ID assegnato da BiPro al progetto, Progetto (string): Titolo del progetto }, { ... } ]
[ { "idNotaSpese":"13", "idEsecuzioneAttivita":"7027", "idUtente":"7", "Utente":"Rossi Stefano", "DataSpesa":"30/06/2022", "idNotaSpeseCategoria":"4", "NotaSpeseCategoria":"Pranzo", "idNotaSpeseGiustificativo":"1", "NotaSpeseGiustificativo":"Ricevuta fiscale", "ImportoSpesa": "30,00", "Luogo":"Ristorante Mediterraneo", "Descrizione":"Pranzo con responsabile Verdi SpA", "idModalitaPagamento":"2", "ModalitaPagamento":"Contanti", "Km": "", "CostoKm": "", "NonRimborsabile": false, "AddebitoCliente": true, "Approvazione": true, "Fatturata": true, "idCliente":"7", "RagioneSociale":"Verdi SpA", "idProgetto":"9", "Progetto":"Consulenza" }, { "idNotaSpese":"14", "idEsecuzioneAttivita":"7028", "idUtente":"8", "Utente":"Bianchi Luigi", "DataSpesa":"01/07/2022", "idNotaSpeseCategoria":"2", "NotaSpeseCategoria":"Hotel", "idNotaSpeseGiustificativo":"2", "NotaSpeseGiustificativo":"Fattura", "ImportoSpesa": "120,00", "Luogo":"Rimini", "Descrizione":"Soggiorno per fiera", "idModalitaPagamento":"1", "ModalitaPagamento":"Carta di credito", "Km": "", "CostoKm": "", "NonRimborsabile": false, "AddebitoCliente": true, "Approvazione": true, "Fatturata": false, "idCliente":"10", "RagioneSociale":"Neri srl", "idProgetto":"9", "Progetto":"Esposizione prodotti fiera" } ]
https://api.bipro.it/pm2/ws/get_categorie_spese/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idNotaSpeseCategoria | GET | integer | ID della categoria di spesa |
[ { idNotaSpeseCategoria (integer): ID della categoria di spesa, NotaSpeseCategoria (string): Nome della categoria di spesa }, { ... } ]
[ { "idNotaSpeseCategoria": "100", "NotaSpeseCategoria": "Pernottamento" }, { "idNotaSpeseCategoria": "101", "NotaSpeseCategoria": "Ristorante" }, ... ]
https://api.bipro.it/pm2/ws/get_giustificativi_spese/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idNotaSpeseGiustificativo | GET | integer | ID del giustificativo di spesa |
[ { idNotaSpeseGiustificativo (integer): ID del giustificativo di spesa, NotaSpeseGiustificativo (string): Nome del giustificativo di spesa }, { ... } ]
[ { "idNotaSpeseGiustificativo": "1", "NotaSpeseGiustificativo": "Ricevuta fiscale" }, { "idNotaSpeseGiustificativo": "2", "NotaSpeseGiustificativo": "Fattura" }, { "idNotaSpeseGiustificativo": "3", "NotaSpeseGiustificativo": "Non documentata" }, { "idNotaSpeseGiustificativo": "4", "NotaSpeseGiustificativo": "Scontrino fiscale" } ]
https://api.bipro.it/pm2/ws/get_modalita_pagamento/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idModalitaPagamento | GET | integer | ID della modalità di pagamento |
[ { idModalitaPagamento (integer): ID della modalità di pagamento, ModalitaPagamento (string): Modalità di pagamento }, { ... } ]
[ { "idModalitaPagamento": "1", "ModalitaPagamento": "Carta di credito" }, { "idModalitaPagamento": "2", "ModalitaPagamento": "Bonifico" }, { "idModalitaPagamento": "3", "ModalitaPagamento": "Contanti" }, { "idModalitaPagamento": "4", "ModalitaPagamento": "Assegno" } ]
https://api.bipro.it/pm2/ws/set_spesa/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idNotaSpese | POST | integer | ID assegnato da BiPro alla spesa: identifica la spesa da modificare e di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una nuova spesa | |
idEsecuzioneAttivita | POST | integer | ID dell'attività dell'utente a cui deve essere collegata la spesa; obbligatorio (cfr web-service get_esecuzioni_attivita ) |
|
ImportoSpesa | POST | double | Importo della spesa; obbligatorio | |
Descrizione | POST | string | max 500 | Testo libero descrittivo della spesa; obbligatorio |
Luogo | POST | string | max 100 | Luogo dove è stata sostenuta la spesa |
idNotaSpeseCategoria | POST | integer | ID della categoria di spesa (cfr web-service get_categorie_spese ) |
|
idModalitaPagamento | POST | integer | ID della modalità di pagamento (cfr web-service get_modalita_pagamento ) |
|
idNotaSpeseGiustificativo | POST | integer | ID del giustificativo (fattura, ricevuta,... cfr web-service get_giustificativi_spese ) |
|
NonRimborsabile | POST | boolean | (default false) true se la spesa non è rimborsabile | |
Km | POST | double | Numero di chilometri, se la spesa si riferisce al rimborso chilometrico | |
CostoKm | POST | double | Costo al chilometro, se la spesa si riferisce al rimborso chilometrico |
{ valid (boolean), message (string): Spesa creata/aggiornata, idNotaSpese (integer): ID assegnato da BiPro alla spesa }
{ "valid": true, "message": "Spesa creata", "idNotaSpese": "1" }
https://api.bipro.it/pm2/ws/del_spesa/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idNotaSpese | POST | integer | ID assegnato da BiPro alla spesa; identifica la spesa da eliminare (cfr web-service get_spese ) |
{ valid (boolean), message (string): Spesa eliminata }
{ "valid": true, "message": "Spesa eliminata" }
set_timbratura
) oppure registrare in tempo reale le entrate
(cfr set_timbratura_ingresso
) e le uscite (cfr set_timbratura_uscita
) di un utente.
https://api.bipro.it/pm2/ws/get_timbrature/
NumeroPagina
per scorrere tra le pagine dei risultati.Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTimbratura | GET | integer | ID assegnato da BiPro alla timbratura; da utilizzare per recuperare le informazioni di una singola timbratura (se specificato questo valore non verranno considerati gli altri parametri di ricerca) |
NumeroPagina | GET | integer | Specifica il numero di pagina dei risultati (se non specificato vale 1) |
idUtente | GET | integer | ID dell'utente |
DataDa | GET | date | La data di timbratura dovrà essere uguale o successiva |
DataA | GET | date | La data di timbratura dovrà essere uguale o precedente |
[ { idTimbratura (integer): ID assegnato da BiPro all'esecuzione dell'attivit`, idUtente (integer): ID assegnato da BiPro all'utente, Cognome (string): Cognome dell'utente che ha effettuato la timbratura, Nome (string): Nome dell'utente che ha effettuato la timbratura, Data (date): Data in cui è stata effetturata la timbratura, OraEntrata (time): Ora di ingresso, OraUscita (time): Ora di uscita, Permanenza (integer): Minuti di permanenza (tra ora ingresso e di uscita oppure ora attuale se uscita non ancora registrata) }, { ... } ]
[ { "idTimbratura":"1", "idUtente":"3", "Utente":"Rossi Stefano", "Data":"30/03/2022", "OraEntrata":"09:11", "OraFine":"11:11", "Permanenza":"120" }, { "idTimbratura":"2", "idUtente":"7", "Utente":"Bianchi Luigi", "Data":"30/03/2022", "OraEntrata":"14:01", "OraFine":"18:01", "Permanenza":"240" } ]
https://api.bipro.it/pm2/ws/set_timbratura/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idTimbratura | POST | integer | ID assegnato da BiPro alla timbratura: identifica la timbratura di cui eseguire l'aggiornamento; da non valorizzare in caso di creazione di una timbratura | |
idUtente | GET | integer | ID dell'utente; obbligatorio (cfr web-service get_utenti o get_utente ) |
|
Data | GET | date | min 10, max 10 (GG/MM/AAAA) | Data di timbratura; obbligatorio |
OraEntrata | GET | time | min 5, max 5 (HH:MM) | Orario di ingresso; obbligatorio |
OraUscita | GET | time | min 5, max 5 (HH:MM) | Orario di uscita; obbligatorio |
{ valid (boolean), message (string): Timbratura creata/aggiornata, idTimbratura (integer): ID assegnato da BiPro alla timbratura }
{ "valid": true, "message": "Timbratura creata", "idTimbratura": "1" }
https://api.bipro.it/pm2/ws/set_timbratura_ingresso/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idUtente | GET | integer | ID dell'utente che entra in azienda; obbligatorio (cfr web-service get_utenti o get_utente ) |
{ valid (boolean), message (string): Ingresso registrato, idTimbratura (integer): ID assegnato da BiPro alla timbratura }
{ "valid": true, "message": "Ingresso registrato", "idTimbratura": "1" }
https://api.bipro.it/pm2/ws/set_timbratura_uscita/
Parametro | Modalità | Tipo | Vincoli / Lunghezza max | Note |
---|---|---|---|---|
idUtente | GET | integer | ID dell'utente che esce dell'azienda; obbligatorio (cfr web-service get_utenti o get_utente ) |
{ valid (boolean), message (string): Uscita registrata, idTimbratura (integer): ID assegnato da BiPro alla timbratura }
{ "valid": true, "message": "Uscita registrata", "idTimbratura": "1" }
https://api.bipro.it/pm2/ws/del_timbratura/
Parametro | Modalità | Tipo | Note |
---|---|---|---|
idTimbratura | POST | integer | ID assegnato da BiPro alla timbratura; identifica la timbratura da eliminare (cfr web-service get_timbrature ) |
{ valid (boolean), message (string): Timbratura eliminata }
{ "valid": true, "message": "Timbratura eliminata" }