API DOCS RapportiniLavoro.it (1.0.0)
Docs API RapportiniLavoro.it
Caricamento lista articoli filtrata e paginata
FILTRI
- Ogni filtro deve essere strutturato nel seguente modo: oggetto.nome_campo=valore|tipo
- Esempio: articolo.codice_articolo=ABC123|string
PAGINAZIONE
- page: number (default 0). Indice pagina, 0-based.
- Esempio: page=0|number.
TABLE INFOS: informazioni di costruzione della tabella (colonne e ordinamento)
- tableInfos: boolean
- se true: include tableInfos in response
- se assente: tableInfos viene incluso solo quando page = 0
ORDINAMENTO
- order.
: "ASC" | "DESC" - Esempio: order.codice_articolo=ASC|string
- Campi ordinabili dipendono dalle colonne esposte in tableInfos.columns (isSortable=true).
Responses
Response samples
- 200
- 400
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "codice_articolo": "string",
- "codice_articolo_esterno": "string",
- "descrizione": "string",
- "um": "string",
- "netCost": 0,
- "netPrice": 0,
- "matricola": "string",
- "barcode": "string",
- "label": "string",
- "key": 0
}
], - "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "totaleElementi": 0,
- "itemsPerPage": 0
}Inserimento massivo di una lista di articoli
Servizio per l'inserimento massivo degli articoli nell'anagrafica articoli. Ogni elemento dell'array rappresenta un articolo.
- codice_articolo_esterno: identificativo dell'articolo nel gestionale esterno dell'utente. Campo obbligatorio.
- descrizione: descrizione dell'articolo. Campo obbligatorio.
- codice_articolo: codice utilizzabile internamente in RapportiniLavoro. Campo facoltativo.
Request Body schema: application/json
| id | integer Default: 0 |
| codice_articolo | string <= 63 characters |
| codice_articolo_esterno required | string <= 63 characters |
| matricola | string |
| barcode | string |
| descrizione required | string <= 2047 characters |
| um | string <= 100 characters |
Responses
Request samples
- Payload
[- {
- "id": 0,
- "codice_articolo": "string",
- "codice_articolo_esterno": "string",
- "matricola": "string",
- "barcode": "string",
- "descrizione": "string",
- "um": "string"
}
]Response samples
- 201
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "codice_articolo": "string",
- "message": "string",
- "success": true
}
]
}Eliminazione massiva di più articoli
Servizio che permette di eliminare in blocco più articoli.
Gli articoli devono essere identificati tramite i campi interni di RapportiniLavoro.
È possibile indicare:
- id: identificativo interno dell'articolo in RapportiniLavoro.
- codice_articolo: codice articolo utilizzato in RapportiniLavoro.
Attenzione: non utilizzare codice_articolo_esterno.
Request Body schema: application/json
| id | integer |
| codice_articolo | string |
Responses
Request samples
- Payload
[- {
- "id": 0,
- "codice_articolo": "string"
}
]Response samples
- 201
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "codice_articolo": "string",
- "message": "string",
- "success": true
}
]
}Elenco di tutti i clienti
Servizio che ritorna l'elenco di tutti i clienti presenti per l'aziendaMap dell'utente.
Questo servizio non supporta filtri o paginazione. Per avere un elenco dei clienti filtrato e paginato utilizzare il servizio /clienti-filtered
Responses
Response samples
- 200
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "ragione_sociale": "string",
- "citta": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "lingua": "st",
- "tipologiaIvaId": 0
}
], - "totaleElementi": 0
}[DEPRECATED] Caricamento del dettaglio di un cliente
[DEPRECATED] Servizio che permette di caricare il dettaglio di un cliente
Request Body schema: application/json
Responses
Request samples
- Payload
{ }Response samples
- 200
- 400
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true,
- "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true
}
]
}
], - "totalItems": 0,
- "perPage": 0
}Caricamento del dettaglio di un cliente
Servizio che permette di caricare il dettaglio di un cliente
path Parameters
| id required | integer |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "item": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true,
- "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true,
- "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
]
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "agente": {
- "id": 0,
- "aziendamap_id": 0,
- "denominazione": "string",
- "referente": "string",
- "telefono": "string",
- "cellulare": "string",
- "mail": "string",
- "pec": "string",
- "piva": "string",
- "codicefiscale": "string",
- "indirizzo": "string",
- "cap": "string",
- "citta": "string",
- "provincia": "str",
- "note": "string",
- "numeroClienti": 0,
- "end_date": "string"
}
}
}Caricamento lista clienti filtrata e paginata
FILTRI
- Ogni filtro deve essere strutturato nel seguente modo: oggetto.nome_campo=valore|tipo
- Esempio: cliente.ragione_sociale=ABC123|string
CARICAMENTO INCREMENTALE
- Clienti creati, modificati o eliminati da una certa data (UTC): cliente.updatedAt.value=2026-11-03 08:00:00|string&cliente.updatedAt.operator=gte|string
- updatedAt cambia anche quando viene modificato un campo personalizzato del cliente
- Di default i clienti eliminati non vengono restituiti. Per averli passare cliente.includeDeleted=true|boolean: sono quelli con end_date valorizzato
CAMPI PERSONALIZZATI
- includeCampiPersonalizzati=true|boolean: ogni cliente ha anche campi_personalizzati, come nel dettaglio del cliente ma senza i file dei campi media
FILTRI CAMPI PERSONALIZZATI
- campi_personalizzati.
=valore (id del campo della configurazione anagraficacliente) - Testo: ricerca like case insensitive. Esempio: campi_personalizzati.12=abc
- Multi select: opzioni separate da virgola, devono essere presenti tutte. Esempio: campi_personalizzati.5=m1,m3
- Media: 1 = presente, 0 = assente, - = indifferente. Esempio: campi_personalizzati.7=1
- Più campi personalizzati sono in AND tra loro
STATO CICLO DI VITA
- Di default vengono restituiti solo i clienti (stato_ciclo_vita: cliente, ex_cliente)
- Per caricare altri stati (prospect, perso) passare il filtro con operatore in
- Esempio: cliente.stato_ciclo_vita.value$0=prospect|string&cliente.stato_ciclo_vita.value$1=perso|string&cliente.stato_ciclo_vita.operator=in|string
PAGINAZIONE
- page: number (default 0). Indice pagina, 0-based.
- Esempio: page=0|number.
TABLE INFOS: informazioni di costruzione della tabella (colonne e ordinamento)
- tableInfos: boolean
- se true: include tableInfos in response
- se assente: tableInfos viene incluso solo quando page = 0
ORDINAMENTO
- order.
: "ASC" | "DESC" - Esempio: order.ragione_sociale=ASC|string
- Campi ordinabili dipendono dalle colonne esposte in tableInfos.columns (isSortable=true).
Responses
Response samples
- 200
- 400
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true,
- "end_date": "string",
- "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0
}
]
}
], - "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "totalItems": 0,
- "perPage": 0
}Caricamento massivo di un elenco di clienti
Ogni elemento dell’array rappresenta un cliente da inserire.
Note sui campi principali:
- id: identificativo del cliente su RapportiniLavoro. Va valorizzato solo per aggiornare un cliente già esistente. Per la creazione di nuovi recapiti deve essere omesso o null.
- idanagrafica: identificativo del cliente nel gestionale del sistema chiamante.
- idEsternoCliente: identificativo del cliente nel gestionale del sistema chiamante a cui associare il cliente. Il cliente deve essere già presente su RapportiniLavoro.
- mail_predefinita_rapportino: indica se la mail del cliente deve essere usata per l’invio dei rapportini al cliente. Valori possibili "S" o "N". Default "S".
Request Body schema: application/json
| id | integer Default: null |
| idanagrafica | string Default: null |
| ragione_sociale | string <= 150 characters |
| piva | string <= 20 characters |
| telefono2 | string <= 60 characters |
| codicefiscale | string <= 60 characters |
| provincia | string <= 3 characters |
| cap | string <= 10 characters |
| localita | string <= 40 characters |
| citta | string <= 60 characters |
| nazione | string |
| km | string <= 60 characters |
| ore | string <= 60 characters |
| indirizzo | string <= 300 characters |
| cellulare | string <= 250 characters |
| note | string <= 2047 characters |
string <= 50 characters | |
| telefono | string <= 50 characters |
| riferimento | string <= 255 characters |
Responses
Request samples
- Payload
[- {
- "id": null,
- "idanagrafica": null,
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string"
}
]Response samples
- 201
- 400
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "idanagrafica": "string",
- "message": "string",
- "success": true
}
]
}Eliminazione in blocco di un elenco di clienti
Servizio che permette di eliminare in blocco un elenco di clienti.
Ogni elemento dell'array rappresenta un cliente da eliminare.
È possibile identificare il cliente tramite il suo id su RapportiniLavoro oppure tramite il campo idanagrafica che corrisponde all'identificativo del cliente sul gestionale esterno dell'utente.
Request Body schema: application/json
| id | integer |
| idanagrafica | string |
Responses
Request samples
- Payload
[- {
- "id": 0,
- "idanagrafica": "string"
}
]Response samples
- 201
- 400
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "idanagrafica": "string",
- "message": "string",
- "success": true
}
]
}Creazione in blocco di un insieme di recapiti
Ogni elemento dell’array rappresenta un recapito ed è associato a un singolo cliente.
Note sui campi principali:
- id: identificativo del recapito su RapportiniLavoro. Va valorizzato solo per aggiornare un recapito già esistente. Per la creazione di nuovi recapiti deve essere omesso o null.
- idanagrafica: identificativo del recapito nel gestionale del sistema chiamante.
- idEsternoCliente: identificativo del cliente nel gestionale del sistema chiamante a cui associare il recapito. Il cliente deve essere già presente su RapportiniLavoro.
- mail_predefinita_rapportino: indica se la mail del recapito deve essere usata per l’invio dei rapportini al cliente. Valori possibili "S" o "N". Default "S".
Request Body schema: application/json
| id | integer Default: null |
| nominativo | string <= 200 characters |
string <= 50 characters | |
| telefono | string <= 50 characters |
| mail_predefinita_rapportino | string Enum: "S" "N" |
| note | string <= 2047 characters |
| idanagrafica | string <= 100 characters |
| idEsternoCliente | string <= 100 characters |
Responses
Request samples
- Payload
[- {
- "id": null,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "S",
- "note": "string",
- "idanagrafica": "string",
- "idEsternoCliente": "string"
}
]Response samples
- 201
- 400
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "idanagrafica": "string",
- "message": "string",
- "success": true
}
]
}Lista configurazioni intervento
Lista delle configurazioni intervento associate ad una azienda con il dettaglio di ogni campo personalizzato associato ad ogni configurazione
Responses
Response samples
- 200
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "nome": "string",
- "colore": "string",
- "default": true,
- "visibileStampa": true,
- "enabled": true,
- "abilitaNumerazioneCustom": true,
- "configurazioneUsata": true,
- "numerazioneId": 0,
- "previsto_in_remoto": true,
- "interventiACorpo": true,
- "importoInterventiACorpo": 0,
- "entity": "rapportino",
- "articoloOreLavoroAttivo": true,
- "articoloOreLavoroId": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "numerazione": {
- "id": 0,
- "aziendamap_id": 0,
- "azzeraInizioAnno": true,
- "prefisso": "string",
- "suffisso": "string",
- "numero": 0,
- "isNumerazioneDefault": true
}, - "configurazioneinterventocampi": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "configurazioneinterventocampiposizione": {
- "id": 0,
- "nome_posizione": "string",
- "i18nKey": "string"
}
}
]
}
]
}Lista configurazioni note spese
Servizio che carica la lista delle tipologie di notespese custom disponibili per l'utente.
Per questo servizio non sono disponibili filtri e paginazione.
Responses
Response samples
- 200
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "nome": "string",
- "key": "string",
- "aziendamap_id": 0,
- "ordinamento": 0,
- "addebitaAlCliente": false,
- "netCost": 0,
- "netPrice": 0,
- "prezzoUgualeACosto": true
}
]
}Creazione di un impianto
Servizio che permette di creare un nuovo impianto per un cliente.
Note sui campi principali:
- id: identificativo dell'impianto su RapportiniLavoro. Va valorizzato solo per aggiornare un impianto già esistente. Per la creazione di nuovi impianti deve essere omesso o null.
- idEsterno: identificativo dell'impianto nel gestionale del sistema chiamante.
- idanagrafica: identificativo del cliente nel gestionale del sistema chiamante a cui associare l'impianto. Il cliente deve essere già presente su RapportiniLavoro.
- anagraficaclientiId: id del cliente su RapportiniLavoro. Può essere usato in alternativa a idanagrafica per indicare a quale cliente è associato l'impianto.
Request Body schema: application/json
| id | integer Default: null |
| idEsterno | string |
| nome | string |
| provincia | string |
| cap | string |
| citta | string |
| nazione | string |
| indirizzo | string |
| telefono | string |
| nominativo | string |
string | |
| note | string |
| km | string |
| ore | string |
| disabled | boolean |
| idanagrafica | string |
| anagraficaclientiId | integer |
| forzaCoordinate | boolean |
| latitudine | string or null |
| longitudine | string or null |
| fromDevice | boolean |
Array of objects |
Responses
Request samples
- Payload
{- "id": null,
- "idEsterno": "string",
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "nazione": "string",
- "indirizzo": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "idanagrafica": "string",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "latitudine": "string",
- "longitudine": "string",
- "fromDevice": true,
- "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
]
}Response samples
- 201
- 400
- 500
{- "success": true,
- "alert": [
- "string"
], - "item": {
- "id": 0,
- "idEsterno": "string",
- "campiPersonalizzatiMediaSalvati": [
- {
- "id": 0,
- "configurazioneinterventocampi_id": 0
}
]
}
}Creazione in blocco di un elenco di impianti
Ogni elemento dell’array rappresenta un impianto ed è associato a un singolo cliente.
Note sui campi principali:
- id: identificativo dell'impianto su RapportiniLavoro. Va valorizzato solo per aggiornare un impianto già esistente. Per la creazione di nuovi impianti deve essere omesso o null.
- idEsterno: identificativo dell'impianto nel gestionale del sistema chiamante.
- idEsternoCliente: identificativo del cliente nel gestionale del sistema chiamante a cui associare l'impianto. Il cliente deve essere già presente su RapportiniLavoro.
Request Body schema: application/json
| id | integer Default: null |
| idEsterno | string |
| nome | string |
| provincia | string |
| cap | string |
| citta | string |
| nazione | string |
| indirizzo | string |
| telefono | string |
| nominativo | string |
string | |
| note | string |
| km | string |
| ore | string |
| disabled | boolean |
| idanagrafica | string |
| anagraficaclientiId | integer |
| idEsternoCliente | string |
Responses
Request samples
- Payload
[- {
- "id": null,
- "idEsterno": "string",
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "nazione": "string",
- "indirizzo": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "idanagrafica": "string",
- "anagraficaclientiId": 0,
- "idEsternoCliente": "string"
}
]Response samples
- 201
- 400
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "idEsterno": "string",
- "message": "string",
- "success": true
}
]
}Caricamento del dettaglio di un impianto
Servizio che permette di caricare il dettaglio di un impianto, comprensivo di cliente associato, macchinari, recapiti, media, geolocation e campi personalizzati.
path Parameters
| id required | string id dell'impianto su RapportiniLavoro |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "item": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true
}
], - "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}, - "latitudine": 0,
- "longitudine": 0,
- "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
]
}
}Eliminazione di un impianto
Servizio che permette di eliminare un impianto
path Parameters
| id required | string Può contenere il campo id dell'impianto su RapportiniLavoro o il campo idEsterno (identificativo dell'impianto sul gestionale esterno dell'utente) |
Responses
Response samples
- 201
- 403
- 500
{- "success": true,
- "alert": [
- "string"
], - "id": 0
}Elenco degli impianti di un cliente
Servizio che ritorna l'elenco degli impianti associati al cliente indicato.
Note sui campi principali:
- id (parametro path): id del cliente su RapportiniLavoro al quale sono associati gli impianti.
PAGINAZIONE
- ?page=0|number. Indice pagina, 0-based. Se omesso, la risposta non è paginata e vengono restituiti tutti gli impianti del cliente.
ORDINAMENTO E COLONNE
- ?order.
=ASC|DESC e ?columns= , . Vengono salvati come preferenze dell'utente. - tableInfos viene restituito solo con ?tableInfos=true oppure ?page=0.
path Parameters
| id required | integer |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0
}
], - "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "perPage": 0,
- "totalItems": 0
}Creazione di un macchinario
Servizio che permette di creare un nuovo macchinario associato ad un impianto o ad un cliente.
Note sui campi principali:
- id: identificativo del macchinario su RapportiniLavoro. Va valorizzato solo per aggiornare un macchinario già esistente. Per la creazione di nuovi macchinari deve essere omesso o 0.
- idEsterno: identificativo del macchinario nel gestionale del sistema chiamante.
- impiantiId: id dell'impianto su RapportiniLavoro al quale associare il macchinario.
- anagraficaclientiId: id del cliente su RapportiniLavoro al quale associare il macchinario. Può essere usato in alternativa a impiantiId: in questo caso il macchinario viene associato all'impianto di default del cliente (creato automaticamente se non già presente).
Request Body schema: application/json
| id | integer Default: 0 |
| idEsterno | string |
| matricola | string |
| barcode | string |
| nome | string |
| note | string |
| impiantiId | number |
| anagraficaclientiId | integer |
Array of objects |
Responses
Request samples
- Payload
{- "id": 0,
- "idEsterno": "string",
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "impiantiId": 0,
- "anagraficaclientiId": 0,
- "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
]
}Response samples
- 201
- 400
- 403
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "item": {
- "id": 0,
- "campiPersonalizzatiMediaSalvati": [
- {
- "id": 0,
- "configurazioneinterventocampi_id": 0
}
]
}
}Caricamento del dettaglio di un macchinario
Servizio che permette di caricare il dettaglio di un macchinario, comprensivo di media e campi personalizzati.
path Parameters
| id required | string id del macchinario su RapportiniLavoro |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "item": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
]
}
}Elenco dei macchinari di un cliente
Servizio che ritorna l'elenco dei macchinari associati agli impianti del cliente indicato.
PAGINAZIONE
- ?page=0|number. Indice pagina, 0-based. Se omesso, la risposta non è paginata e vengono restituiti tutti i macchinari del cliente.
ORDINAMENTO E COLONNE
- ?order.
=ASC|DESC e ?columns= , . Vengono salvati come preferenze dell'utente. - tableInfos viene restituito solo con ?tableInfos=true oppure ?page=0.
path Parameters
| id required | string id del cliente su RapportiniLavoro al quale sono associati, tramite i relativi impianti, i macchinari. |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0,
- "impianti": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
}
], - "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "perPage": 0,
- "totalItems": 0
}Export rapportini CSV per Mexal
Servizio che permette di generare un file csv che contiene i rapportini da esportare su Mexal.
Filtro disponibile tramite query string:
- rapportino.chiusura_date: filtra i rapportini per intervallo di data di chiusura.
- Il filtro deve essere strutturato nel seguente modo: ?rapportino.chiusura_date.startDate=YYYY-MM-DD&rapportino.chiusura_date.endDate=YYYY-MM-DD
- Esempio: ?rapportino.chiusura_date.startDate=2026-01-01&rapportino.chiusura_date.endDate=2026-11-21
Responses
Response samples
- 200
- 401
- 500
{- "success": true,
- "alert": [
- "string"
]
}Elenco rapportini
Servizio che permette di caricare un elenco di rapportini filtrato e paginato.
Filtri disponibili tramite query string:
- pagesize: numero di elementi per pagina (default 20, massimo 1000).
- page: indice della pagina da recuperare (default 0).
- stato: stato del rapportino da filtrare (default "CHIUSO").
- datachiusura: restituisce i rapportini con chiusura_date maggiore o uguale alla data indicata oppure con chiusura_date null.
- completato: filtra per stato completato (0 = false, 1 = true).
- importato: filtra i rapportini in base alla presenza di idgestionale:
- true → solo rapportini importati (idgestionale diverso da null)
- false → solo rapportini non importati (idgestionale null).
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "numero_assistenza": "string",
- "progressivo_numero_assistenza": 0,
- "idgestionale": "string",
- "stato": "string",
- "motivazione": "string",
- "inserimento_libero": "st",
- "tipologia_inserimento_ore": "string",
- "dirittointervento": "st",
- "lavorazione": "string",
- "nominativo_accettazione": "string",
- "note": "string",
- "signature": "string",
- "chiusura_date": "2019-08-24T14:15:22Z",
- "revisione": "2019-08-24T14:15:22Z",
- "flagged": true,
- "completato": true,
- "totore": 0,
- "totoreViaggio": 0,
- "totoreCoperteContratto": 0,
- "lastFailureGestionale": "string",
- "trasferta_ritorno_effettuata": true,
- "in_remoto": true,
- "configurazioneintervento_id": 0,
- "prezzoDirittoInterventoImpostato": 0,
- "netPriceACorpo": 0,
- "gestionePrezziIntervento": true,
- "visualizzazionePrezziPdf": true,
- "note_spese_abilitate_rapportino": true,
- "stampa_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "addebita_note_spese_al_cliente": 0,
- "addebita_solo_note_spese": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "giustificativo_materiale_da_portare": "string",
- "end_date": "string",
- "schedule": {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string",
- "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "clienteFatturazione": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}
}, - "rapportinomateriale": [
- {
- "id": 0,
- "rapportino_id": 0,
- "macchinariId": 0,
- "anagraficamateriale_id": 0,
- "matricola": "string",
- "barcode": "string",
- "quantita": 0,
- "descrizione": "string",
- "cod_articolo": "string",
- "cod_articolo_esterno": "string",
- "um": "string",
- "note": "string",
- "netPrice": 0,
- "netCost": 0,
- "caricato": true,
- "type": "rapportino",
- "end_date": "string"
}
], - "orelavorate": [
- {
- "id": 0,
- "masterid": "string",
- "attivita": 0,
- "rif_id": 0,
- "user_id": 0,
- "data": "string",
- "ora_mattino_da": "string",
- "ora_mattino_a": "string",
- "ora_pomeriggio_da": "string",
- "ora_pomeriggio_a": "string",
- "ora_sera_da": "string",
- "ora_sera_a": "string",
- "totale_ore": 0,
- "trasferta_andata_da": "string",
- "trasferta_andata_a": "string",
- "trasferta_ritorno_da": "string",
- "trasferta_ritorno_a": "string",
- "pranzo": "str",
- "cena": "str",
- "pernotto": "str",
- "ore_viaggio": 0,
- "km_viaggio": 0,
- "signature": "string",
- "nominativo": "string",
- "numero_tecnici": 0,
- "macchinariId": 0,
- "mezzo_id": 0,
- "prezzoTecnicoCalcolato": 0,
- "prezzoImpostato": 0,
- "prezzoKmViaggioCalcolato": 0,
- "prezzoKmViaggioImpostato": 0,
- "prezzoOreViaggioCalcolato": 0,
- "prezzoOreViaggioImpostato": 0,
- "prezzoPranzoCalcolato": 0,
- "prezzoPranzoImpostato": 0,
- "prezzoCenaCalcolato": 0,
- "prezzoCenaImpostato": 0,
- "prezzoPernottoCalcolato": 0,
- "prezzoPernottoImpostato": 0,
- "costoTecnicoCalcolato": 0,
- "costoTecnicoImpostato": 0,
- "costoOreViaggioCalcolato": 0,
- "costoOreViaggioImpostato": 0,
- "costoKmViaggioCalcolato": 0,
- "costoKmViaggioImpostato": 0,
- "end_date": "string"
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "attivita": null,
- "pdf": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "totalItems": 0,
- "perPage": 0
}Caricamento lista rapportini filtrata-paginata
FILTRI
- Ogni filtro deve essere strutturato nel seguente modo: oggetto.nome_campo=valore|tipo
- Esempio: rapportino.numero_assistenza=ABC123|string
PAGINAZIONE
- page: number (default 0). Indice pagina, 0-based.
- Esempio: page=0|number.
TABLE INFOS: informazioni di costruzione della tabella (colonne e ordinamento)
- tableInfos: boolean
- se true: include tableInfos in response
- se assente: tableInfos viene incluso solo quando page = 0
ORDINAMENTO
- order.
: "ASC" | "DESC" - Esempio: order.numero_assistenza=ASC|string
- Campi ordinabili dipendono dalle colonne esposte in tableInfos.columns (isSortable=true).
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "item": null,
- "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "perPage": 0,
- "totalItems": 0
}Dettaglio rapportino
Servizio che permette di caricare il dettaglio di un rapportino
path Parameters
| id required | integer |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "item": {
- "id": 0,
- "aziendamap_id": 0,
- "numero_assistenza": "string",
- "progressivo_numero_assistenza": 0,
- "idgestionale": "string",
- "stato": "string",
- "motivazione": "string",
- "inserimento_libero": "st",
- "tipologia_inserimento_ore": "string",
- "dirittointervento": "st",
- "lavorazione": "string",
- "nominativo_accettazione": "string",
- "note": "string",
- "signature": "string",
- "chiusura_date": "2019-08-24T14:15:22Z",
- "revisione": "2019-08-24T14:15:22Z",
- "flagged": true,
- "completato": true,
- "totore": 0,
- "totoreViaggio": 0,
- "totoreCoperteContratto": 0,
- "lastFailureGestionale": "string",
- "trasferta_ritorno_effettuata": true,
- "in_remoto": true,
- "configurazioneintervento_id": 0,
- "prezzoDirittoInterventoImpostato": 0,
- "netPriceACorpo": 0,
- "gestionePrezziIntervento": true,
- "visualizzazionePrezziPdf": true,
- "note_spese_abilitate_rapportino": true,
- "stampa_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "addebita_note_spese_al_cliente": 0,
- "addebita_solo_note_spese": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "giustificativo_materiale_da_portare": "string",
- "schedule": {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string",
- "app_date_f": "string",
- "posizione": {
- "latitudine": 0,
- "longitudine": 0,
- "forzata": true
}, - "usersList": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
], - "contratti": {
- "id": 0,
- "aziendamap_id": 0,
- "idEsterno": "string",
- "descrizione": "string",
- "tipoContratto": "string",
- "dataInizio": "string",
- "dataFine": "string",
- "rinnovoDate": "string",
- "anniDurataProssimoRinnovo": 0,
- "rinnovoAutomaticoScadenzaData": true,
- "note": "string",
- "reportCliente": true,
- "reportUfficio": true,
- "firmaCliente": true,
- "abilitaPrezzoContratto": true,
- "prezzoContratto": "string",
- "abilitaPrezziContratto": 0,
- "monteOre": 0,
- "monteOreUsato": 0,
- "durataGiornata": "str",
- "giorniVincolo": 0,
- "contrattoChild": 0,
- "rinnovoAutomaticoTermineOre": true,
- "cessato": true,
- "giorniAnticipoRinnovo": 0,
- "mailAvvisoScadenzaEnabled": true,
- "mailAvvisoScadenzaSent": true,
- "mailAvvisoScadenzaGiorniAnticipo": 0,
- "mailAvvisoScadenzaOreResidue": 0,
- "anagraficaclientiId": 0,
- "configurazioneInterventoDefault": 0,
- "abilitaSelezioneConfigurazioneIntervento": true,
- "esportaGestionalePacchettoOre": true,
- "esportaGestionaleForfait": true,
- "esportaGestionaleManutenzione": true,
- "fatturazioneOreAContratto": 0,
- "fatturazioneMaterialeAContratto": 0,
- "fatturazioneOreViaggioAContratto": 0,
- "fatturazioneKmAContratto": 0,
- "fatturazioneDiarieAContratto": 0,
- "fatturazioneNoteSpeseAContratto": 0,
- "fatturazioneCampiPersonalizzatiAContratto": 0,
- "fatturazioneAttivitaAContratto": 0,
- "abilitaPriceTecnico": true,
- "netPriceTecnico": 0,
- "abilitaPriceKm": true,
- "netPriceKm": 0,
- "abilitaPriceOreViaggio": true,
- "netPriceOreViaggio": 0,
- "abilitaPricePranzo": true,
- "netPricePranzo": 0,
- "abilitaPriceCena": true,
- "netPriceCena": 0,
- "abilitaPricePernotto": true,
- "netPricePernotto": 0,
- "abilitaPriceDirittoIntervento": true,
- "netPriceDirittoIntervento": 0,
- "abilitaPriceMateriale": true,
- "abilitaPriceAttivitaContratto": true,
- "visualizzazionePrezziPdf": true,
- "interventiACorpo": true,
- "importoInterventiACorpo": 0,
- "contratti_child": {
- "id": 0,
- "aziendamap_id": 0,
- "idEsterno": "string",
- "descrizione": "string",
- "tipoContratto": "string",
- "dataInizio": "string",
- "dataFine": "string",
- "rinnovoDate": "string",
- "anniDurataProssimoRinnovo": 0,
- "rinnovoAutomaticoScadenzaData": true,
- "note": "string",
- "reportCliente": true,
- "reportUfficio": true,
- "firmaCliente": true,
- "abilitaPrezzoContratto": true,
- "prezzoContratto": "string",
- "abilitaPrezziContratto": 0,
- "monteOre": 0,
- "monteOreUsato": 0,
- "durataGiornata": "str",
- "giorniVincolo": 0,
- "contrattoChild": 0,
- "rinnovoAutomaticoTermineOre": true,
- "cessato": true,
- "giorniAnticipoRinnovo": 0,
- "mailAvvisoScadenzaEnabled": true,
- "mailAvvisoScadenzaSent": true,
- "mailAvvisoScadenzaGiorniAnticipo": 0,
- "mailAvvisoScadenzaOreResidue": 0,
- "anagraficaclientiId": 0,
- "configurazioneInterventoDefault": 0,
- "abilitaSelezioneConfigurazioneIntervento": true,
- "esportaGestionalePacchettoOre": true,
- "esportaGestionaleForfait": true,
- "esportaGestionaleManutenzione": true,
- "fatturazioneOreAContratto": 0,
- "fatturazioneMaterialeAContratto": 0,
- "fatturazioneOreViaggioAContratto": 0,
- "fatturazioneKmAContratto": 0,
- "fatturazioneDiarieAContratto": 0,
- "fatturazioneNoteSpeseAContratto": 0,
- "fatturazioneCampiPersonalizzatiAContratto": 0,
- "fatturazioneAttivitaAContratto": 0,
- "abilitaPriceTecnico": true,
- "netPriceTecnico": 0,
- "abilitaPriceKm": true,
- "netPriceKm": 0,
- "abilitaPriceOreViaggio": true,
- "netPriceOreViaggio": 0,
- "abilitaPricePranzo": true,
- "netPricePranzo": 0,
- "abilitaPriceCena": true,
- "netPriceCena": 0,
- "abilitaPricePernotto": true,
- "netPricePernotto": 0,
- "abilitaPriceDirittoIntervento": true,
- "netPriceDirittoIntervento": 0,
- "abilitaPriceMateriale": true,
- "abilitaPriceAttivitaContratto": true,
- "visualizzazionePrezziPdf": true,
- "interventiACorpo": true,
- "importoInterventiACorpo": 0
}, - "anagraficamateriale": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "codice_articolo": "string",
- "codice_articolo_esterno": "string",
- "descrizione": "string",
- "um": "string",
- "netCost": 0,
- "netPrice": 0,
- "anagraficamateriale_contratti": {
- "quantitaAContratto": 0,
- "quantitaDisponibile": 0,
- "quantitaUtilizzata": 0
}
}
]
}, - "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}, - "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true,
- "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true,
- "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [ ]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
]
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
]
}, - "clienteFatturazione": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "agente": {
- "id": 0,
- "aziendamap_id": 0,
- "denominazione": "string",
- "referente": "string",
- "telefono": "string",
- "cellulare": "string",
- "mail": "string",
- "pec": "string",
- "piva": "string",
- "codicefiscale": "string",
- "indirizzo": "string",
- "cap": "string",
- "citta": "string",
- "provincia": "str",
- "note": "string",
- "numeroClienti": 0,
- "end_date": "string"
}, - "anagraficaclientisedi": {
- "id": 0,
- "idsede": 0,
- "cliente_id": 0,
- "telefono": "string",
- "telefono2": "string",
- "indirizzo": "string",
- "localita": "string",
- "citta": "string",
- "provincia": "str",
- "cap": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string"
}, - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0
}
], - "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "ticket": [
- {
- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "cliente_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "alertNonVisibileCliente": true,
- "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0
}
]
}
], - "alert_appuntamenti": [
- {
- "id": 0,
- "inviato": true,
- "anticipo": 0,
- "disattivato": true,
- "scheduleId": 0,
- "anagraficaclientirecapiti": [
- {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true
}
]
}
]
}, - "rapportinomateriale": [
- {
- "id": 0,
- "rapportino_id": 0,
- "macchinariId": 0,
- "anagraficamateriale_id": 0,
- "matricola": "string",
- "barcode": "string",
- "quantita": 0,
- "descrizione": "string",
- "cod_articolo": "string",
- "cod_articolo_esterno": "string",
- "um": "string",
- "note": "string",
- "netPrice": 0,
- "netCost": 0,
- "caricato": true,
- "type": "rapportino",
- "anagraficamateriale": {
- "id": 0,
- "aziendamap_id": 0,
- "codice_articolo": "string",
- "codice_articolo_esterno": "string",
- "descrizione": "string",
- "um": "string",
- "netCost": 0,
- "netPrice": 0,
- "matricola": "string",
- "barcode": "string"
}, - "macchinari": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
}
], - "orelavorate": [
- {
- "id": 0,
- "masterid": "string",
- "attivita": 0,
- "rif_id": 0,
- "user_id": 0,
- "data": "string",
- "ora_mattino_da": "string",
- "ora_mattino_a": "string",
- "ora_pomeriggio_da": "string",
- "ora_pomeriggio_a": "string",
- "ora_sera_da": "string",
- "ora_sera_a": "string",
- "totale_ore": 0,
- "trasferta_andata_da": "string",
- "trasferta_andata_a": "string",
- "trasferta_ritorno_da": "string",
- "trasferta_ritorno_a": "string",
- "pranzo": "str",
- "cena": "str",
- "pernotto": "str",
- "ore_viaggio": 0,
- "km_viaggio": 0,
- "signature": "string",
- "nominativo": "string",
- "numero_tecnici": 0,
- "macchinariId": 0,
- "mezzo_id": 0,
- "prezzoTecnicoCalcolato": 0,
- "prezzoImpostato": 0,
- "prezzoKmViaggioCalcolato": 0,
- "prezzoKmViaggioImpostato": 0,
- "prezzoOreViaggioCalcolato": 0,
- "prezzoOreViaggioImpostato": 0,
- "prezzoPranzoCalcolato": 0,
- "prezzoPranzoImpostato": 0,
- "prezzoCenaCalcolato": 0,
- "prezzoCenaImpostato": 0,
- "prezzoPernottoCalcolato": 0,
- "prezzoPernottoImpostato": 0,
- "costoTecnicoCalcolato": 0,
- "costoTecnicoImpostato": 0,
- "costoOreViaggioCalcolato": 0,
- "costoOreViaggioImpostato": 0,
- "costoKmViaggioCalcolato": 0,
- "costoKmViaggioImpostato": 0,
- "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}, - "macchinari": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
}
], - "notespese": [
- {
- "id": 0,
- "nome": "string",
- "data": "string",
- "netCost": 0,
- "netPrice": 0,
- "prezzoUgualeACosto": true,
- "descrizione": "string",
- "addebitaAlCliente": true,
- "rapportino_id": 0,
- "configurazioneNoteSpese_id": 0,
- "users": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
]
}
], - "configurazioneintervento": {
- "id": 0,
- "aziendamap_id": 0,
- "nome": "string",
- "colore": "string",
- "default": true,
- "visibileStampa": true,
- "enabled": true,
- "abilitaNumerazioneCustom": true,
- "configurazioneUsata": true,
- "numerazioneId": 0,
- "previsto_in_remoto": true,
- "interventiACorpo": true,
- "importoInterventiACorpo": 0,
- "entity": "rapportino",
- "articoloOreLavoroAttivo": true,
- "articoloOreLavoroId": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0
}, - "geolocation": [
- {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}
], - "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "pdf": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "attachments": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "attivita": null,
- "emailSent": true,
- "chatAttiva": true
}
}Lavorazione rapportino
Servizio che permette di aggiornare il rapportino con le ultime modifiche effettuate
Request Body schema: application/json
| id | integer |
| numero_assistenza | string |
| motivazione | string |
| note | string |
| lavorazione | string |
| dirittointervento | string |
| isACorpo | boolean |
| netPriceACorpo | number or null |
| gestionePrezziIntervento | boolean |
| visualizzazionePrezziPdf | boolean |
| prezzoDirittoInterventoImpostato | number or null |
| note_spese_abilitate_rapportino | boolean or null |
| stampa_note_spese_pdf | boolean or null |
| prezzi_note_spese | boolean or null |
| addebita_note_spese_al_cliente | integer or null |
| addebita_solo_note_spese | boolean or null |
Array of objects | |
| inserimento_libero | string |
| tipologia_inserimento_ore | string or null |
Array of objects | |
Array of objects | |
Array of objects | |
| revisione | string or null |
Array of objects | |
| in_remoto | boolean |
| lingua_pdf | string or null |
Responses
Request samples
- Payload
{- "id": 0,
- "numero_assistenza": "string",
- "motivazione": "string",
- "note": "string",
- "lavorazione": "string",
- "dirittointervento": "string",
- "isACorpo": true,
- "netPriceACorpo": 0,
- "gestionePrezziIntervento": true,
- "visualizzazionePrezziPdf": true,
- "prezzoDirittoInterventoImpostato": 0,
- "note_spese_abilitate_rapportino": true,
- "stampa_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "addebita_note_spese_al_cliente": 0,
- "addebita_solo_note_spese": true,
- "campi_personalizzati": [
- {
- "id": 0,
- "configurazionetipocampotable_id": 0,
- "visibile_web": true,
- "visibile_app": true,
- "visibile_stampa": true,
- "importante": true,
- "configurazioneinterventocampiposizione_id": 0,
- "nome_campo": "string",
- "tipo_campo": "string",
- "options": "string",
- "abilitazione": true,
- "obbligatorio": true,
- "default": "string",
- "valore_richiesto": "string",
- "nomeCampoGestionale": "string",
- "abilitaFatturazioneGestionale": true,
- "valore": "string",
- "valore_id": 0,
- "value_abilitazione": true,
- "netCost": 0,
- "netPrice": 0,
- "riferimento_id": 0,
- "start_date": "string",
- "end_date": "string",
- "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "inserimento_libero": "string",
- "tipologia_inserimento_ore": "string",
- "orelavorate": [
- {
- "id": 0,
- "masterid": "string",
- "attivita": 0,
- "rif_id": 0,
- "user_id": 0,
- "data": "string",
- "ora_mattino_da": "string",
- "ora_mattino_a": "string",
- "ora_pomeriggio_da": "string",
- "ora_pomeriggio_a": "string",
- "ora_sera_da": "string",
- "ora_sera_a": "string",
- "totale_ore": 0,
- "trasferta_andata_da": "string",
- "trasferta_andata_a": "string",
- "trasferta_ritorno_da": "string",
- "trasferta_ritorno_a": "string",
- "pranzo": "str",
- "cena": "str",
- "pernotto": "str",
- "ore_viaggio": 0,
- "km_viaggio": 0,
- "signature": "string",
- "nominativo": "string",
- "numero_tecnici": 0,
- "macchinariId": 0,
- "mezzo_id": 0,
- "prezzoTecnicoCalcolato": 0,
- "prezzoImpostato": 0,
- "prezzoKmViaggioCalcolato": 0,
- "prezzoKmViaggioImpostato": 0,
- "prezzoOreViaggioCalcolato": 0,
- "prezzoOreViaggioImpostato": 0,
- "prezzoPranzoCalcolato": 0,
- "prezzoPranzoImpostato": 0,
- "prezzoCenaCalcolato": 0,
- "prezzoCenaImpostato": 0,
- "prezzoPernottoCalcolato": 0,
- "prezzoPernottoImpostato": 0,
- "costoTecnicoCalcolato": 0,
- "costoTecnicoImpostato": 0,
- "costoOreViaggioCalcolato": 0,
- "costoOreViaggioImpostato": 0,
- "costoKmViaggioCalcolato": 0,
- "costoKmViaggioImpostato": 0,
- "start_date": "string",
- "end_date": "string",
- "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false,
- "start_date": "string",
- "end_date": "string"
}, - "macchinari": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0,
- "start_date": "string",
- "end_date": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "deletedAt": "string"
}
}
], - "rapportinomateriale": [
- {
- "id": 0,
- "rapportino_id": 0,
- "macchinariId": 0,
- "anagraficamateriale_id": 0,
- "matricola": "string",
- "barcode": "string",
- "quantita": 0,
- "descrizione": "string",
- "cod_articolo": "string",
- "cod_articolo_esterno": "string",
- "um": "string",
- "note": "string",
- "netPrice": 0,
- "netCost": 0,
- "caricato": true,
- "type": "rapportino",
- "anagraficamateriale": {
- "id": 0,
- "aziendamap_id": 0,
- "codice_articolo": "string",
- "codice_articolo_esterno": "string",
- "descrizione": "string",
- "um": "string",
- "netCost": 0,
- "netPrice": 0,
- "matricola": "string",
- "barcode": "string"
}, - "macchinari": {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0,
- "start_date": "string",
- "end_date": "string",
- "createdAt": "string",
- "updatedAt": "string",
- "deletedAt": "string"
}, - "salvaInAnagrafica": true
}
], - "notespese": [
- {
- "id": 0,
- "nome": "string",
- "data": "string",
- "netCost": 0,
- "netPrice": 0,
- "prezzoUgualeACosto": true,
- "descrizione": "string",
- "addebitaAlCliente": true,
- "rapportino_id": 0,
- "configurazioneNoteSpese_id": 0,
- "users": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
]
}
], - "revisione": "string",
- "attivita": [
- {
- "id": 0,
- "contratto_date": "string",
- "lavorazione_date": "string",
- "valore": "string",
- "value_abilitazione": true
}
], - "in_remoto": true,
- "lingua_pdf": "string"
}Response samples
- 201
- 403
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "item": {
- "id": 0,
- "campiPersonalizzatiMediaSalvati": [
- {
- "id": 0,
- "configurazioneinterventocampi_id": 0
}
]
}
}Aggiornamento idgestionale per più rapportini
Servizio che permette di di aggiornare il campo idgestionale per un elenco di rapportini
Request Body schema: application/json
| id required | integer |
| idgestionale | string |
Responses
Request samples
- Payload
[- {
- "id": 0,
- "idgestionale": "string"
}
]Response samples
- 201
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "idgestionale": "string"
}
]
}Elenco appuntamenti pianificatore
Servizio che permette di caricare gli appuntamenti e i todos in un periodo di tempo specificato
path Parameters
| startDate required | string Data inizio periodo selezionato nel formato YYYYMMDD (required) |
| endDate required | string Data fine periodo selezionato nel formato YYYYMMDD (required) |
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "items": [
- {
- "user": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false,
- "mansioni": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "nome": "string",
- "isDefault": true,
- "end_date": "string"
}
]
}, - "impegni": [
- [
- {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string",
- "rapportino": {
- "id": 0,
- "aziendamap_id": 0,
- "numero_assistenza": "string",
- "progressivo_numero_assistenza": 0,
- "idgestionale": "string",
- "stato": "string",
- "motivazione": "string",
- "inserimento_libero": "st",
- "tipologia_inserimento_ore": "string",
- "dirittointervento": "st",
- "lavorazione": "string",
- "nominativo_accettazione": "string",
- "note": "string",
- "signature": "string",
- "chiusura_date": "2019-08-24T14:15:22Z",
- "revisione": "2019-08-24T14:15:22Z",
- "flagged": true,
- "completato": true,
- "totore": 0,
- "totoreViaggio": 0,
- "totoreCoperteContratto": 0,
- "lastFailureGestionale": "string",
- "trasferta_ritorno_effettuata": true,
- "in_remoto": true,
- "configurazioneintervento_id": 0,
- "prezzoDirittoInterventoImpostato": 0,
- "netPriceACorpo": 0,
- "gestionePrezziIntervento": true,
- "visualizzazionePrezziPdf": true,
- "note_spese_abilitate_rapportino": true,
- "stampa_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "addebita_note_spese_al_cliente": 0,
- "addebita_solo_note_spese": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "giustificativo_materiale_da_portare": "string"
}, - "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- null
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "clienteFatturazione": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- null
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [ ]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
], - "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "usersList": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
], - "alert_appuntamenti": [
- {
- "id": 0,
- "inviato": true,
- "anticipo": 0,
- "disattivato": true,
- "scheduleId": 0,
- "anagraficaclientirecapiti": [
- {
- "id": null,
- "nominativo": null,
- "mail": null,
- "telefono": null,
- "mail_predefinita_rapportino": null,
- "note": null,
- "idanagrafica": null,
- "cliente_id": null,
- "user_id": null,
- "flag_abilita_ticket": null,
- "flag_abilita_mail_ticket": null,
- "flag_abilita_riapertura_ticket": null
}
]
}
]
}
]
]
}
], - "todos": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string",
- "rapportino": {
- "id": 0,
- "aziendamap_id": 0,
- "numero_assistenza": "string",
- "progressivo_numero_assistenza": 0,
- "idgestionale": "string",
- "stato": "string",
- "motivazione": "string",
- "inserimento_libero": "st",
- "tipologia_inserimento_ore": "string",
- "dirittointervento": "st",
- "lavorazione": "string",
- "nominativo_accettazione": "string",
- "note": "string",
- "signature": "string",
- "chiusura_date": "2019-08-24T14:15:22Z",
- "revisione": "2019-08-24T14:15:22Z",
- "flagged": true,
- "completato": true,
- "totore": 0,
- "totoreViaggio": 0,
- "totoreCoperteContratto": 0,
- "lastFailureGestionale": "string",
- "trasferta_ritorno_effettuata": true,
- "in_remoto": true,
- "configurazioneintervento_id": 0,
- "prezzoDirittoInterventoImpostato": 0,
- "netPriceACorpo": 0,
- "gestionePrezziIntervento": true,
- "visualizzazionePrezziPdf": true,
- "note_spese_abilitate_rapportino": true,
- "stampa_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "addebita_note_spese_al_cliente": 0,
- "addebita_solo_note_spese": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "giustificativo_materiale_da_portare": "string"
}, - "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "clienteFatturazione": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}, - "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
], - "usersList": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
]
}
]
}Inserimento appuntamenti in blocco
Servizio che permette di inserire un blocco di appuntamenti.
Note sui campi principali:
- user: se user.id e app_date non sono valorizzati l'intervento viene creato nei "Da fare", senza tecnico assegnato
- configurazioneintervento_id: tipologia di intervento, tra quelle restituite da GET /configuration/intervento con entity "rapportino" ed enabled true
- impianti: sedi del cliente da collegare all'intervento (es. "impianti": [{ "id": 123 }]), tra quelle restituite da GET /impianti/cliente/:id
- macchinari: macchinari del cliente da collegare all'intervento (es. "macchinari": [{ "id": 456 }]), tra quelli restituiti da GET /macchinari/macchinari/:id. Se sono indicati anche degli impianti, ogni macchinario deve appartenere a uno di questi
- se un impianto o un macchinario non appartiene al cliente dell'intervento, o un macchinario non appartiene agli impianti indicati, l'intervento non viene creato e nella risposta l'elemento è restituito senza id
- idgestionale: identificativo del sistema chiamante, restituito nella risposta per associare ogni risultato alla richiesta. Non viene salvato e non garantisce unicità
Per collegare uno o più ticket all'intervento valorizzare il campo ticket con l'array degli id dei ticket (es. "ticket": [{ "id": 123 }]). Lo stato dei ticket collegati viene aggiornato automaticamente in base allo stato dell'intervento.
Gestione del campo ticket (attivo solo se il modulo ticket è abilitato per l'azienda):
- campo assente: i ticket già collegati all'intervento restano invariati
- array valorizzato: i ticket collegati vengono sostituiti con quelli indicati
- array vuoto ("ticket": []): su un intervento esistente vengono scollegati tutti i ticket
I ticket devono esistere e appartenere allo stesso cliente dell'intervento, altrimenti viene restituito errore e l'intervento non viene salvato.
Request Body schema: application/json
| id | string |
object | |
| app_date | any |
object | |
| clienteFatturazione | object or null |
| titolo required | string |
| note | string |
| app_ora | any |
| app_ora_end | any |
| idgestionale | string |
| configurazioneintervento_id | integer |
Array of objects | |
Array of objects | |
Array of objects | |
Array of objects |
Responses
Request samples
- Payload
[- {
- "id": "string",
- "user": {
- "id": 0
}, - "app_date": null,
- "anagraficaclienti": {
- "id": 0
}, - "clienteFatturazione": { },
- "titolo": "string",
- "note": "string",
- "app_ora": null,
- "app_ora_end": null,
- "idgestionale": "string",
- "configurazioneintervento_id": 0,
- "impianti": [
- {
- "id": 0
}
], - "macchinari": [
- {
- "id": 0
}
], - "rapportinomateriale": [
- {
- "quantita": 0,
- "cod_articolo": "string",
- "note": "string"
}
], - "ticket": [
- {
- "id": 0
}
]
}
]Response samples
- 200
- 403
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "rapportino_id": 0,
- "idgestionale": "string"
}
]
}Caricamento lista ticket filtrata e paginata
FILTRI
- Ogni filtro deve essere strutturato nel seguente modo: oggetto.nome_campo=valore|tipo
- Filtri sul ticket: ticket.nome_campo (es. ticket.stato=chiuso|string)
- Filtri sul cliente del ticket: cliente.nome_campo (es. cliente.ragione_sociale=ABC123|string)
- ticket.haScheduleAssociata=true|boolean: solo i ticket collegati ad almeno un intervento (false: solo quelli non collegati)
PAGINAZIONE
- pagina: number. Indice pagina, 0-based.
- Esempio: pagina=0|number
- Se omessa vengono restituiti tutti i ticket senza paginazione.
TABLE INFOS: informazioni di costruzione della tabella (colonne e ordinamento)
- tableInfos: boolean
- se true: include tableInfos in response
- se assente: tableInfos viene incluso solo quando pagina = 0 o non valorizzata
ORDINAMENTO
- order.
: "ASC" | "DESC" - Esempio: order.numero=DESC|string
- Campi ordinabili dipendono dalle colonne esposte in tableInfos.columns (isSortable=true).
Responses
Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "tickets": [
- {
- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "cliente_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "alertNonVisibileCliente": true,
- "schedule": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string"
}
], - "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
], - "anagraficaclientirecapiti": {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true,
- "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "utenteConQuestoComePrincipale": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
}, - "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}
}
], - "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true
}
], - "order": null
}, - "totalItems": 0,
- "perPage": 0
}Creazione di un ticket
Servizio che permette di creare un nuovo ticket.
Lo schema del body riporta tutti i campi del ticket, ma solo alcuni vanno effettivamente valorizzati in fase di creazione, gli altri sono utilizzati esclusivamente in fase di aggiornamento e vengono ignorati (o gestiti automaticamente) in creazione.
Campi da valorizzare in creazione:
- titolo: titolo del ticket.
- descrizione: descrizione del ticket.
- recapito_id: id del recapito cliente (RapportiniLavoro) da associare al ticket come richiedente. OBBLIGATORIO per le chiamate effettuate tramite API KEY.
- priorita: 'bassa' | 'media' | 'alta' | 'urgente'. Se omessa viene impostata automaticamente a 'media'.
- dataApertura: data di apertura del ticket. Se omessa il campo rimane vuoto.
- impianti: array di impianti da associare al ticket. Per ogni elemento va valorizzato solo il campo id (con l'id dell'impianto su RapportiniLavoro).
- macchinari: array di macchinari da associare al ticket. Per ogni elemento va valorizzato solo il campo id (con l'id del macchinario su RapportiniLavoro).
Campi da NON valorizzare in creazione (usati solo in aggiornamento o gestiti automaticamente dal servizio):
- id: va omesso per la creazione. Se valorizzato il servizio esegue un aggiornamento del ticket esistente invece di crearne uno nuovo.
- numero: se omesso viene generato automaticamente.
- stato: se omesso viene impostato automaticamente a 'nuovo'.
- dataChiusura, previstaFatturazione, confermaFatturazione, dataConfermaFatturazione, utenteConfermaFatturazione: campi gestiti solo in fase di aggiornamento del ticket (es. gestione fatturazione), non hanno effetto in creazione.
- aziendamap_id: viene sempre impostato automaticamente in base all'azienda dell'utente/API KEY che effettua la chiamata, un eventuale valore passato viene ignorato.
Request Body schema: application/json
| id | integer |
| titolo | string |
| numero | number or null |
| descrizione | string |
| stato | string Enum: "nuovo" "pianificato intervento" "in lavorazione" "chiuso" "eliminato" "riaperto" |
| priorita | string Enum: "" "bassa" "media" "alta" "urgente" |
| dataApertura | string |
| dataChiusura | string or null |
| recapito_id | number or null |
| cliente_id | integer or null |
| aziendamap_id | integer or null |
| ordinamento | integer or null |
| previstaFatturazione | boolean |
| confermaFatturazione | boolean |
| dataConfermaFatturazione | string or null |
| utenteConfermaFatturazione | integer or null |
| alertNonVisibileCliente | boolean or null |
Array of objects | |
Array of objects |
Responses
Request samples
- Payload
{- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "cliente_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "alertNonVisibileCliente": true,
- "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
]
}Response samples
- 200
- 404
- 500
{- "success": true,
- "message": "string",
- "ticket": {
- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "cliente_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "alertNonVisibileCliente": true
}
}Dettaglio di un ticket
Servizio che restituisce il dettaglio di un ticket a partire dal suo id, con interventi collegati (e relativi pdf), impianti, macchinari, recapito/cliente e allegati.
path Parameters
| id required | string |
Responses
Response samples
- 200
- 400
- 404
- 500
{- "success": true,
- "message": "string",
- "ticket": {
- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "cliente_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "alertNonVisibileCliente": true,
- "schedule": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_id": 0,
- "fornitore_id": 0,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "stato": "string",
- "user_id": 0,
- "rif_user_id": 0,
- "priorita": 0,
- "urgenza": 0,
- "update_date": "string",
- "day_of_year": 0,
- "app_date": "string",
- "app_end_date": "string",
- "app_ora": "string",
- "app_ora_end": "string",
- "order": 0,
- "riferimento": "string",
- "contratto_id": 0,
- "fatturazioneOre": 0,
- "fatturazioneMateriale": 0,
- "fatturazioneOreViaggio": 0,
- "fatturazioneKm": 0,
- "fatturazioneDiarie": 0,
- "fatturazioneNoteSpese": 0,
- "fatturazioneCampiPersonalizzati": 0,
- "fatturazioneAttivita": 0,
- "indirizzocantiere": true,
- "indirizzo": "string",
- "citta": "string",
- "provincia": "string",
- "ragione_sociale_libera": "string",
- "mail": "string",
- "telefono": "string",
- "previsto_in_remoto": true,
- "stato_rapportino": "string",
- "configurazioneintervento_id": 0,
- "commessa_id": 0,
- "documento_id": 0,
- "geolocationId": 0,
- "start_date": "string",
- "pdf": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
]
}
], - "macchinari": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "matricola": "string",
- "barcode": "string",
- "nome": "string",
- "note": "string",
- "disabled": true,
- "impiantiId": 0
}
], - "impianti": [
- {
- "id": 0,
- "idEsterno": "string",
- "isDefault": true,
- "nome": "string",
- "provincia": "string",
- "cap": "string",
- "citta": "string",
- "indirizzo": "string",
- "nazione": "string",
- "telefono": "string",
- "nominativo": "string",
- "email": "string",
- "note": "string",
- "km": "string",
- "ore": "string",
- "disabled": true,
- "lingua": "st",
- "anagraficaclientiId": 0,
- "forzaCoordinate": true,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
], - "anagraficaclientirecapiti": {
- "id": 0,
- "nominativo": "string",
- "mail": "string",
- "telefono": "string",
- "mail_predefinita_rapportino": "string",
- "note": "string",
- "idanagrafica": "string",
- "cliente_id": 0,
- "user_id": 0,
- "flag_abilita_ticket": true,
- "flag_abilita_mail_ticket": true,
- "flag_abilita_riapertura_ticket": true,
- "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "utenteConQuestoComePrincipale": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
}, - "anagraficaclienti": {
- "id": 0,
- "aziendamap_id": 0,
- "gestionale": true,
- "idanagrafica": "string",
- "ragione_sociale": "string",
- "piva": "string",
- "telefono2": "string",
- "codicefiscale": "string",
- "provincia": "str",
- "cap": "string",
- "localita": "string",
- "citta": "string",
- "nazione": "string",
- "km": "string",
- "ore": "string",
- "indirizzo": "string",
- "cellulare": "string",
- "note": "string",
- "mail": "string",
- "telefono": "string",
- "riferimento": "string",
- "lingua": "st",
- "geolocationId": 0,
- "condizionePagamentoId": 0,
- "giornoFissoTerminePagamento": 0,
- "pubblicaAmministrazione": true,
- "abi": "string",
- "cab": "string",
- "codiceSdi": "string",
- "codicePa": "string",
- "pec": "string",
- "tipologiaIvaId": 0,
- "agenteId": 0,
- "stato_ciclo_vita": "prospect",
- "data_conversione": "string",
- "preventivo_conversione_id": 0,
- "estendi_visibilita_ticket_cliente": true
}, - "media": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}
], - "clienteConfermaFatturazione": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false
}
}
}Caricamento dettaglio utente
Servizio che permette di caricare il dettaglio di un singolo utente
path Parameters
| id required | integer |
Responses
Response samples
- 200
- 500
{- "success": true,
- "message": "string",
- "item": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "string",
- "dataScadenzaPassword": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": 0,
- "failed_attempts": 0,
- "status": "string",
- "scheduleorder": 0,
- "scheduleenabled": "s",
- "email": "string",
- "emailConfermaIntervento": true,
- "signature": true,
- "last_attempt": "string",
- "superuser": true,
- "loginWithGoogle": true,
- "netCostTecnico": 0,
- "netPriceTecnico": 0,
- "netCostKm": 0,
- "netPriceKm": 0,
- "netPriceOreViaggio": 0,
- "netPricePranzo": 0,
- "netPriceCena": 0,
- "netPricePernotto": 0,
- "lingua": "st",
- "abilita_suggerimenti_app": true,
- "abilitaChatAI": "Sì",
- "mezzo_id": 0,
- "forceRefreshStore": false,
- "media": {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": true,
- "allega_a_fattura": true,
- "visibile_tecnico": true,
- "visibile_sottocliente": true,
- "nome_visualizzato": "string"
}, - "mansioni": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "nome": "string",
- "isDefault": true,
- "end_date": "string"
}
], - "geolocation": [
- {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0,
- "start_date": null
}
], - "gruppiRuolo": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "name": "string",
- "key": "string",
- "tipo": "string",
- "selezionabileDaUtente": true
}
], - "gruppiCustom": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "name": "string",
- "key": "string",
- "tipo": "string",
- "selezionabileDaUtente": true
}
]
}
}Elenco utenti per azienda
Servizio che permette di caricare la lista degli utenti appartenenti ad una azienda.
Questo servizio restituisce sempre la lista completa. Non supporta né filtri né paginazione.
Responses
Response samples
- 200
- 401
- 500
{- "success": true,
- "message": "string",
- "tecnici": [
- {
- "id": 0,
- "username": "string",
- "role": "string",
- "name": "string",
- "surname": "string",
- "customer_id": "string",
- "status": "string",
- "email": "string"
}
]
}Caricamento lista commesse filtrata e paginata
FILTRI
- Ogni filtro deve essere strutturato nel seguente modo: oggetto.nome_campo=valore|tipo
- Esempio: commessa.numero=ABC123|string
CARICAMENTO INCREMENTALE
- Commesse create, modificate o eliminate da una certa data (UTC): commessa.updatedAt.value=2026-11-03 08:00:00|string&commessa.updatedAt.operator=gte|string
- Di default le commesse eliminate non vengono restituite. Per averle passare commessa.includeDeleted=true|boolean: sono quelle con deletedAt valorizzato
FILTRI CAMPI PERSONALIZZATI (validi anche per /commesse/export-csv)
- campi_personalizzati.
=valore (id del campo della configurazione commessa) - Testo: ricerca like case insensitive. Esempio: campi_personalizzati.12=abc
- Multi select: opzioni separate da virgola, devono essere presenti tutte. Esempio: campi_personalizzati.5=m1,m3
- Media: 1 = presente, 0 = assente, - = indifferente. Esempio: campi_personalizzati.7=1
- Più campi personalizzati sono in AND tra loro
PAGINAZIONE
- page: number. Indice pagina, 0-based. Esempio: page=0|number. Se omesso, la risposta non è paginata e vengono restituite tutte le commesse.
TABLE INFOS: informazioni di costruzione della tabella (colonne e ordinamento)
- tableInfos: boolean
- se true: include tableInfos in response
- se assente: tableInfos viene incluso solo quando page = 0 o non è passato
ORDINAMENTO
- order.
: "ASC" | "DESC" - Esempio: order.numero=ASC|string
- Campi ordinabili dipendono dalle colonne esposte in tableInfos.columns (isSortable=true).
Responses
Response samples
- 200
- 500
{- "success": true,
- "alert": [
- "string"
], - "commesse": [
- {
- "id": 0,
- "titolo": "string",
- "idEsterno": "string",
- "numero": 0,
- "numeroCalcolato": "string",
- "descrizione": "string",
- "dataApertura": "string",
- "dataChiusura": "string",
- "clienteId": 0,
- "stato": "aperto",
- "tipoDocumentoId": 0,
- "numerazioneId": 0,
- "statoCommessaId": 0,
- "deletedAt": "string",
- "commesseImpianti": [
- {
- "impianto_id": 0
}
], - "commesseMacchinari": [
- {
- "macchinario_id": 0
}
], - "statoCommessaCustom": {
- "id": 0,
- "aziendamap_id": 0,
- "key": "string",
- "descrizione": "string",
- "order": 0,
- "flusso": "ingresso",
- "tipoDocumentoId": 0
}
}
], - "perPage": 0,
- "totaleElementi": 0,
- "tableInfos": {
- "columns": [
- {
- "key": "string",
- "label": "string",
- "visible": true,
- "isSortable": true,
- "columnOrder": 0
}
], - "order": { }
}
}