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 <= 60 characters |
| codice_articolo_esterno required | string <= 60 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,
- "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,
- "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,
- "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,
- "nome_visualizzato": "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
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,
- "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
}
]
}
], - "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 <= 600 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 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
}
]
}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 |
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,
- "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,
- "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,
- "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
}, - "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,
- "nome_visualizzato": "string"
}
], - "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,
- "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: number. Indice pagina, 0-based. Se omesso, la risposta non è paginata e vengono restituiti tutti gli impianti del cliente.
path Parameters
| id required | integer |
query Parameters
| page | number |
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,
- "geolocationId": 0
}
], - "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,
- "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,
- "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,
- "nome_visualizzato": "string"
}
]
}
]
}
}Elenco dei macchinari di un cliente
Servizio che ritorna l'elenco dei macchinari associati agli impianti del cliente indicato.
PAGINAZIONE
- page: number. Indice pagina, 0-based. Se omesso, la risposta non è paginata e vengono restituiti tutti i macchinari del cliente.
path Parameters
| id required | string id del cliente su RapportiniLavoro al quale sono associati, tramite i relativi impianti, i macchinari. |
query Parameters
| page | number |
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,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
}
], - "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,
- "visualizza_note_spese": true,
- "visualizza_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "prezzi_note_spese_pdf": 0,
- "includi_prezzi_note_spese_nei_prezzi_rapportino": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "end_date": "string",
- "schedule": {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_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",
- "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,
- "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
}, - "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
}
}, - "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,
- "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,
- "autista_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,
- "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,
- "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,
- "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,
- "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,
- "visualizza_note_spese": true,
- "visualizza_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "prezzi_note_spese_pdf": 0,
- "includi_prezzi_note_spese_nei_prezzi_rapportino": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "string",
- "schedule": {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_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",
- "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,
- "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",
- "usersList": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}
], - "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,
- "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,
- "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,
- "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,
- "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
}
}, - "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}, - "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,
- "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,
- "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,
- "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
}, - "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,
- "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,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 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,
- "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,
- "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,
- "autista_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,
- "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}, - "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",
- "importo": 0,
- "descrizione": "string",
- "addebitaAlCliente": true,
- "rapportino_id": 0,
- "configurazioneNoteSpese_id": 0,
- "users": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}
]
}
], - "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"
}, - "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,
- "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,
- "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,
- "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,
- "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 |
| visualizza_note_spese | boolean or null |
| visualizza_note_spese_pdf | boolean or null |
| prezzi_note_spese | boolean or null |
| prezzi_note_spese_pdf | integer or null |
| includi_prezzi_note_spese_nei_prezzi_rapportino | 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,
- "visualizza_note_spese": true,
- "visualizza_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "prezzi_note_spese_pdf": 0,
- "includi_prezzi_note_spese_nei_prezzi_rapportino": 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,
- "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,
- "autista_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,
- "start_date": "string",
- "end_date": "string",
- "users": {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì",
- "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,
- "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"
}
}
], - "notespese": [
- {
- "id": 0,
- "nome": "string",
- "data": "string",
- "importo": 0,
- "descrizione": "string",
- "addebitaAlCliente": true,
- "rapportino_id": 0,
- "configurazioneNoteSpese_id": 0,
- "users": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}
]
}
], - "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
- 404
- 500
{- "success": true,
- "message": "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",
- "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ì",
- "mansioni": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "nome": "string",
- "isDefault": true,
- "end_date": "string"
}
]
}, - "impegni": [
- [
- {
- "id": 0,
- "aziendamap_id": 0,
- "cliente_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",
- "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,
- "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,
- "visualizza_note_spese": true,
- "visualizza_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "prezzi_note_spese_pdf": 0,
- "includi_prezzi_note_spese_nei_prezzi_rapportino": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "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
}, - "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
}, - "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,
- "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",
- "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ì"
}
], - "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,
- "sede_id": 0,
- "titolo": "string",
- "note": "string",
- "inviato_operatore": "st",
- "data_ora_inviato_operatore": null,
- "rapportino_id": 0,
- "conferma_cliente": "st",
- "tipologia": "str",
- "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,
- "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,
- "visualizza_note_spese": true,
- "visualizza_note_spese_pdf": true,
- "prezzi_note_spese": true,
- "prezzi_note_spese_pdf": 0,
- "includi_prezzi_note_spese_nei_prezzi_rapportino": true,
- "isACorpo": true,
- "pagato": true,
- "lingua_pdf": "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
}, - "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
}, - "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,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
], - "usersList": [
- {
- "id": 0,
- "aziendamap_id": 0,
- "username": "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ì"
}
]
}
]
}Inserimento appuntamenti in blocco
Servizio che permette di inserire un blocco di appuntamenti
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 |
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",
- "rapportinomateriale": [
- {
- "quantita": 0,
- "cod_articolo": "string",
- "note": "string"
}
]
}
]Response samples
- 200
- 403
- 404
- 500
{- "success": true,
- "alert": [
- "string"
], - "items": [
- {
- "id": 0,
- "rapportino_id": 0,
- "idgestionale": "string"
}
]
}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 |
| aziendamap_id | integer or null |
| ordinamento | integer or null |
| previstaFatturazione | boolean |
| confermaFatturazione | boolean |
| dataConfermaFatturazione | string or null |
| utenteConfermaFatturazione | integer 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,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0,
- "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,
- "geolocationId": 0,
- "geolocation": {
- "id": 0,
- "geolocationValue": {
- "coordinates": [
- 0
]
}, - "inChiusura": true,
- "fromDevice": true,
- "usersId": 0,
- "rapportinoId": 0
}
}
]
}Response samples
- 200
- 500
{- "success": true,
- "message": "string",
- "ticket": {
- "id": 0,
- "titolo": "string",
- "numero": 0,
- "descrizione": "string",
- "stato": "nuovo",
- "priorita": "",
- "dataApertura": "string",
- "dataChiusura": "string",
- "recapito_id": 0,
- "aziendamap_id": 0,
- "ordinamento": 0,
- "previstaFatturazione": true,
- "confermaFatturazione": true,
- "dataConfermaFatturazione": "string",
- "utenteConfermaFatturazione": 0
}
}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",
- "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ì",
- "media": {
- "id": 0,
- "aziendamap_id": 0,
- "type_id": 0,
- "tag_id": 0,
- "section": "string",
- "uid": "string",
- "filetype": "string",
- "media": "string",
- "allega_a_mail": 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"
}
]
}