Passa al contenuto principale
API docs by Redocly

API DOCS RapportiniLavoro.it (1.0.0)

Docs API RapportiniLavoro.it

API Integrazioni esterne

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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ],
  • "tableInfos": {
    },
  • "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
Array
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

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ]
}

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
Array
id
integer
codice_articolo
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ]
}

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

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ],
  • "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
object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ],
  • "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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "item": {
    }
}

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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ],
  • "tableInfos": {
    },
  • "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
Array
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
mail
string <= 50 characters
telefono
string <= 50 characters
riferimento
string <= 255 characters

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ]
}

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
Array
id
integer
idanagrafica
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ]
}

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
Array
id
integer
Default: null
nominativo
string <= 200 characters
mail
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

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ]
}

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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ]
}

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
email
string
note
string
km
string
ore
string
disabled
boolean
idanagrafica
string
anagraficaclientiId
integer

Responses

Request samples

Content type
application/json
{
  • "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
}

Response samples

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "item": {
    }
}

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
Array
id
integer
Default: 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
boolean
idanagrafica
string
anagraficaclientiId
integer
idEsternoCliente
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ]
}

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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "id": 0
}

Contenuto media

Servizio che permette di caricare il contenuto di un media

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string"
}

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

Content type
application/json
{
  • "success": true,
  • "alert": [
    ]
}

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

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ],
  • "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

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "item": null,
  • "tableInfos": {
    },
  • "perPage": 0,
  • "totalItems": 0
}

Dettaglio rapportino

Servizio che permette di caricare il dettaglio di un rapportino

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "item": {
    }
}

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
boolean 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

Content type
application/json
{
  • "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": true,
  • "includi_prezzi_note_spese_nei_prezzi_rapportino": true,
  • "campi_personalizzati": [
    ],
  • "inserimento_libero": "string",
  • "tipologia_inserimento_ore": "string",
  • "orelavorate": [
    ],
  • "rapportinomateriale": [
    ],
  • "notespese": [
    ],
  • "revisione": "string",
  • "attivita": [
    ],
  • "in_remoto": true,
  • "lingua_pdf": "string"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "item": {
    }
}

Aggiornamento idgestionale per più rapportini

Servizio che permette di di aggiornare il campo idgestionale per un elenco di rapportini

Request Body schema: application/json
Array
id
required
integer
idgestionale
string

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ]
}

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

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "items": [
    ],
  • "todos": [
    ]
}

Inserimento appuntamenti in blocco

Servizio che permette di inserire un blocco di appuntamenti

Request Body schema: application/json
Array
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

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true,
  • "alert": [
    ],
  • "items": [
    ]
}

Caricamento dettaglio utente

Servizio che permette di caricare il dettaglio di un singolo utente

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "item": {
    }
}

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

Content type
application/json
{
  • "success": true,
  • "message": "string",
  • "tecnici": [
    ]
}