Bleno API REST

Colleghi a Bleno moduli del sito web, portali di richieste, timbratrici o il Suo software: crei clienti, progetti e lead, recuperi preventivi e fatture, trasferisca le registrazioni delle ore.

Versione 1.0.0

Il riferimento API qui sotto è generato dalla specifica. La specifica JSON descrive i campi in tedesco.

Autenticazione

API REST per clienti, progetti, lead, preventivi/fatture, registrazioni delle ore e webhook di un'impresa Bleno.

Autenticazione tramite chiave API (Authorization: Bearer bleno_…). Ogni chiave ha scope per risorsa (read/write); uno scope mancante restituisce 403.

Rate limit: 60 chiamate per chiave ogni 60 secondi, oltre si riceve 429 con Retry-After.

Gli amministratori creano una chiave in “Einstellungen → API & Webhooks” (impostazioni) e lì scelgono gli scope. La chiave viene mostrata una sola volta. I dati di altre imprese non sono mai raggiungibili: gli ID di un'altra impresa restituiscono 404 come quelli sconosciuti e, usati come filtro, un elenco vuoto.

La descrizione leggibile da macchina per generatori di codice e strumenti API: Specifica OpenAPI (JSON, descrizioni in tedesco)

curl https://bleno.de/api/v1/customers \
  -H "Authorization: Bearer bleno_…"
Scope
AmbitoLetturaScrittura
Clienticustomers:readcustomers:write
Progettiprojects:readprojects:write
Leadleads:readleads:write
Documentidocuments:readdocuments:write
Registrazioni delle oretime_entries:readtime_entries:write
Webhookwebhooks:readwebhooks:write

Clienti

Leggere, creare e modificare i clienti dell'impresa.

GET/api/v1/customers

Elencare i clienti

A pagine; i clienti archiviati solo con include_archived=true.

Scope richiesto: customers:read.

Scope: customers:read

Parametri
CampoTipoObbligatorioNote
limit(query)integernoPredefinito: 50 · min. 1 · max. 100
offset(query)integernoPredefinito: 0 · min. 0
include_archived(query)"true" | "false"noPredefinito: "false"

Risposte

  • 200 Elenco clienti.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobject[]sì
data[].idstring (uuid)sì
data[].customer_numberstring | nullsì
data[].customer_type"company" | "private"sì
data[].salutation"herr" | "frau" | nullsì
data[].company_namestring | nullsì
data[].first_namestring | nullsì
data[].last_namestring | nullsì
data[].display_namestringsì
data[].emailstring | nullsì
data[].phonestring | nullsì
data[].mobile_phonestring | nullsì
data[].faxstring | nullsì
data[].address_streetstring | nullsì
data[].address_zipstring | nullsì
data[].address_citystring | nullsì
data[].tax_idstring | nullsì
data[].notesstring | nullsì
data[].is_archivedbooleansì
data[].created_atstringsì
data[].updated_atstring | nullsì
paginationobjectsì
pagination.limitintegersì
pagination.offsetintegersì
pagination.totalintegersì
POST/api/v1/customers

Creare un cliente

Senza customer_type vale: con ragione sociale un'azienda, altrimenti un privato. Campi obbligatori come nel modulo cliente.

Scope richiesto: customers:write.

Scope: customers:write

Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
customer_type"company" | "private"no
salutation"herr" | "frau" | nullno
company_namestring | nullnoal massimo 200 caratteri
first_namestring | nullnoal massimo 100 caratteri
last_namestring | nullnoal massimo 100 caratteri
emailstring (email) | "" | qualsiasi | nullno
customer_numberstring | nullnoal massimo 50 caratteri
phonestring | nullnoal massimo 50 caratteri
mobile_phonestring | nullnoal massimo 50 caratteri
faxstring | nullnoal massimo 50 caratteri
address_streetstring | nullnoal massimo 200 caratteri
address_zipstring | nullnoal massimo 20 caratteri
address_citystring | nullnoal massimo 100 caratteri
tax_idstring | nullnoal massimo 50 caratteri
notesstring | nullnoal massimo 5000 caratteri

Risposte

  • 201 Cliente creato.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 409 Conflitto, ad es. numero cliente o di progetto duplicato oppure registrazione delle ore già fatturata.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 201
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.customer_numberstring | nullsì
data.customer_type"company" | "private"sì
data.salutation"herr" | "frau" | nullsì
data.company_namestring | nullsì
data.first_namestring | nullsì
data.last_namestring | nullsì
data.display_namestringsì
data.emailstring | nullsì
data.phonestring | nullsì
data.mobile_phonestring | nullsì
data.faxstring | nullsì
data.address_streetstring | nullsì
data.address_zipstring | nullsì
data.address_citystring | nullsì
data.tax_idstring | nullsì
data.notesstring | nullsì
data.is_archivedbooleansì
data.created_atstringsì
data.updated_atstring | nullsì
GET/api/v1/customers/{id}

Recuperare un cliente

Scope richiesto: customers:read.

Scope: customers:read

Parametri
CampoTipoObbligatorioNote
id(percorso)string (uuid)sì

Risposte

  • 200 Cliente.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.customer_numberstring | nullsì
data.customer_type"company" | "private"sì
data.salutation"herr" | "frau" | nullsì
data.company_namestring | nullsì
data.first_namestring | nullsì
data.last_namestring | nullsì
data.display_namestringsì
data.emailstring | nullsì
data.phonestring | nullsì
data.mobile_phonestring | nullsì
data.faxstring | nullsì
data.address_streetstring | nullsì
data.address_zipstring | nullsì
data.address_citystring | nullsì
data.tax_idstring | nullsì
data.notesstring | nullsì
data.is_archivedbooleansì
data.created_atstringsì
data.updated_atstring | nullsì
PATCH/api/v1/customers/{id}

Modificare un cliente

Cambiano solo i campi inviati; null svuota un campo.

Scope richiesto: customers:write.

Scope: customers:write

Parametri
CampoTipoObbligatorioNote
id(percorso)string (uuid)sì
Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
customer_type"company" | "private"no
salutation"herr" | "frau" | nullno
company_namestring | nullnoal massimo 200 caratteri
first_namestring | nullnoal massimo 100 caratteri
last_namestring | nullnoal massimo 100 caratteri
emailstring (email) | "" | qualsiasi | nullno
customer_numberstring | nullnoal massimo 50 caratteri
phonestring | nullnoal massimo 50 caratteri
mobile_phonestring | nullnoal massimo 50 caratteri
faxstring | nullnoal massimo 50 caratteri
address_streetstring | nullnoal massimo 200 caratteri
address_zipstring | nullnoal massimo 20 caratteri
address_citystring | nullnoal massimo 100 caratteri
tax_idstring | nullnoal massimo 50 caratteri
notesstring | nullnoal massimo 5000 caratteri

Risposte

  • 200 Cliente modificato.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 409 Conflitto, ad es. numero cliente o di progetto duplicato oppure registrazione delle ore già fatturata.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.customer_numberstring | nullsì
data.customer_type"company" | "private"sì
data.salutation"herr" | "frau" | nullsì
data.company_namestring | nullsì
data.first_namestring | nullsì
data.last_namestring | nullsì
data.display_namestringsì
data.emailstring | nullsì
data.phonestring | nullsì
data.mobile_phonestring | nullsì
data.faxstring | nullsì
data.address_streetstring | nullsì
data.address_zipstring | nullsì
data.address_citystring | nullsì
data.tax_idstring | nullsì
data.notesstring | nullsì
data.is_archivedbooleansì
data.created_atstringsì
data.updated_atstring | nullsì

Progetti

Leggere e creare progetti.

GET/api/v1/projects

Elencare i progetti

Tutti i progetti non archiviati con cliente e stato, ordinati per nome.

Scope richiesto: projects:read.

Scope: projects:read

Risposte

  • 200 Elenco progetti.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
projectsobject[]sì
projects[].idstring (uuid)sì
projects[].namestringsì
projects[].status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"sì
projects[].customerobject | nullsì
projects[].customer.idstring (uuid)sì
projects[].customer.namestringsì
POST/api/v1/projects

Creare un progetto

Se l'impresa usa numeri di progetto automatici, Bleno assegna il numero successivo quando non ne viene inviato uno.

Scope richiesto: projects:write.

Scope: projects:write

Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
namestringsìalmeno 1 caratteri · al massimo 200 caratteri
customer_idstring (uuid)sì
descriptionstring | nullnoal massimo 5000 caratteri
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"no
project_type"fixed_fee" | "time_and_materials" | "non_billable"no
project_numberstring | nullnoal massimo 60 caratteri
start_datestring | nullnoPattern ^\d{4}-\d{2}-\d{2}$
end_datestring | nullnoPattern ^\d{4}-\d{2}-\d{2}$
address_streetstring | nullnoal massimo 200 caratteri
address_zipstring | nullnoal massimo 20 caratteri
address_citystring | nullnoal massimo 100 caratteri

Risposte

  • 201 Progetto creato.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 409 Conflitto, ad es. numero cliente o di progetto duplicato oppure registrazione delle ore già fatturata.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 201
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.namestringsì
data.project_numberstring | nullsì
data.status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"sì
data.project_type"fixed_fee" | "time_and_materials" | "non_billable" | nullsì
data.customer_idstring (uuid)sì
data.descriptionstring | nullsì
data.start_datestring | nullsì
data.end_datestring | nullsì
data.address_streetstring | nullsì
data.address_zipstring | nullsì
data.address_citystring | nullsì
data.created_atstringsì

Lead

Creare lead da moduli del sito web e portali.

POST/api/v1/leads

Creare un lead

Per moduli del sito web e portali di richieste. I nuovi lead partono con stato new e origine website.

Scope richiesto: leads:write.

Scope: leads:write

Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
namestringsìalmeno 1 caratteri · al massimo 200 caratteri
emailstring (email) | "" | qualsiasi | nullno
phonestring | nullnoal massimo 50 caratteri
notesstring | nullnoal massimo 5000 caratteri
customer_idstring (uuid) | nullno
external_referencestring | nullnoal massimo 200 caratteri

Risposte

  • 201 Lead creato.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 201
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.namestringsì
data.emailstring | nullsì
data.phonestring | nullsì
data.notesstring | nullsì
data.status"new" | "contacted" | "quote_sent" | "won" | "lost"sì
data.source"whatsapp" | "voice" | "test" | "website" | nullsì
data.customer_idstring (uuid) | nullsì
data.project_idstring (uuid) | nullsì
data.external_referencestring | nullsì
data.created_atstringsì

Documenti

Leggere preventivi e fatture con stato, importi e link al PDF.

GET/api/v1/documents

Elencare preventivi e fatture

Filtrabili per tipo, stato, cliente e progetto. L'elenco non contiene link ai PDF.

Scope richiesto: documents:read.

Scope: documents:read

Parametri
CampoTipoObbligatorioNote
limit(query)integernoPredefinito: 50 · min. 1 · max. 100
offset(query)integernoPredefinito: 0 · min. 0
type(query)"quote" | "invoice"no
status(query)"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"no
customer_id(query)string (uuid)no
project_id(query)string (uuid)no

Risposte

  • 200 Elenco documenti.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobject[]sì
data[].idstring (uuid)sì
data[].numberstring | nullsì
data[].type"quote" | "invoice"sì
data[].invoice_kind"partial" | "final" | nullsì
data[].status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"sì
data[].datestring | nullsì
data[].due_datestring | nullsì
data[].currencystringsì
data[].net_amountnumber | nullsì
data[].tax_ratenumber | nullsì
data[].tax_amountnumber | nullsì
data[].gross_amountnumber | nullsì
data[].customer_idstring (uuid) | nullsì
data[].project_idstring (uuid) | nullsì
data[].has_pdfbooleansì
data[].created_atstringsì
data[].updated_atstring | nullsì
paginationobjectsì
pagination.limitintegersì
pagination.offsetintegersì
pagination.totalintegersì
GET/api/v1/documents/{id}

Recuperare un preventivo o una fattura

Con link al PDF: a tempo limitato, e all'apertura Bleno chiede il codice postale del cliente.

Scope richiesto: documents:read.

Scope: documents:read

Parametri
CampoTipoObbligatorioNote
id(percorso)string (uuid)sì

Risposte

  • 200 Documento.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.numberstring | nullsì
data.type"quote" | "invoice"sì
data.invoice_kind"partial" | "final" | nullsì
data.status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"sì
data.datestring | nullsì
data.due_datestring | nullsì
data.currencystringsì
data.net_amountnumber | nullsì
data.tax_ratenumber | nullsì
data.tax_amountnumber | nullsì
data.gross_amountnumber | nullsì
data.customer_idstring (uuid) | nullsì
data.project_idstring (uuid) | nullsì
data.has_pdfbooleansì
data.created_atstringsì
data.updated_atstring | nullsì
data.pdfobject | nullsì
data.pdf.urlstring (uri)sì
data.pdf.expires_atstringsì
data.pdf.requires_postal_codetruesì

Registrazioni delle ore

Leggere le registrazioni delle ore e trasferirle da terminali o sistemi esterni.

GET/api/v1/time-entries

Elencare le registrazioni delle ore

Registrazioni nel periodo da from a to, facoltativamente per un solo collaboratore.

Scope richiesto: time_entries:read.

Scope: time_entries:read

Parametri
CampoTipoObbligatorioNote
from(query)stringsìPattern ^\d{4}-\d{2}-\d{2}$
to(query)stringsìPattern ^\d{4}-\d{2}-\d{2}$
user_id(query)string (uuid)no
limit(query)integernoI valori oltre 500 vengono ridotti a 500. · Predefinito: 200 · min. 1 · max. 500
offset(query)integernoPredefinito: 0 · min. 0

Risposte

  • 200 Registrazioni delle ore.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
entriesobject[]sì
entries[].idstring (uuid)sì
entries[].user_idstring (uuid) | nullsì
entries[].project_idstring (uuid)sì
entries[].datestringsì
entries[].start_timestring | nullsì
entries[].end_timestring | nullsì
entries[].break_minutesintegersì
entries[].duration_minutesintegersì
entries[].work_type"arbeiten" | "laden" | "fahren" | "pause"sì
entries[].descriptionstring | nullsì
entries[].is_billableboolean | nullsì
entries[].status"pending" | "approved" | "rejected" | "invoiced"sì
entries[].external_sourcestring | nullsì
entries[].external_idstring | nullsì
entries[].projectobject | nullsì
entries[].project.idstring (uuid)sì
entries[].project.namestringsì
has_morebooleansì
POST/api/v1/time-entries

Trasferire una registrazione delle ore

O duration_minutes oppure start_time e end_time. Con external_source e external_id una nuova chiamata aggiorna la stessa registrazione invece di crearne una seconda. L'approvazione la stabilisce l'impresa.

Scope richiesto: time_entries:write.

Scope: time_entries:write

Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
user_idstring (uuid)sì
project_idstring (uuid)sì
datestringsìPattern ^\d{4}-\d{2}-\d{2}$
work_type"arbeiten" | "laden" | "fahren" | "pause"noPredefinito: "arbeiten"
start_timestringnoPattern ^\d{1,2}:\d{2}$
end_timestringnoPattern ^\d{1,2}:\d{2}$
break_minutesnumbernomin. 0
duration_minutesnumbernomin. 0 · max. 1440
descriptionstringno
is_billablebooleanno
external_sourcestringno
external_idstringno

Risposte

  • 200 Registrazione esistente della stessa origine aggiornata.
  • 201 Registrazione creata (`created`); con origine nota 200 con `updated`.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 409 Conflitto, ad es. numero cliente o di progetto duplicato oppure registrazione delle ore già fatturata.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
action"created" | "updated"sì
idstring (uuid)sì
Risposta 201
CampoTipoObbligatorioNote
action"created" | "updated"sì
idstring (uuid)sì

Webhook

Iscriversi ai webhook in uscita per Zapier, Make e ricevitori propri.

GET/api/v1/webhooks

Elencare i webhook

Endpoint dell'impresa senza secret di firma. Test di connessione per Zapier e Make.

Scope richiesto: webhooks:read.

Scope: webhooks:read

Risposte

  • 200 Endpoint.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 200
CampoTipoObbligatorioNote
dataobject[]sì
data[].idstring (uuid)sì
data[].urlstringsì
data[].descriptionstring | nullsì
data[].eventsstring[]sì
data[].is_activebooleansì
POST/api/v1/webhooks

Iscriversi a un webhook

Crea un endpoint. Zapier invia target_url ed event, gli altri client url ed events. Il secret di firma compare solo in questa risposta.

Scope richiesto: webhooks:write.

Scope: webhooks:write

Corpo della richiesta (JSON)
CampoTipoObbligatorioNote
urlstringno
target_urlstringno
event"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"no
events"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"[]no
descriptionstringnoal massimo 200 caratteri

Risposte

  • 201 Endpoint creato.
  • 400 Input non valido.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.
Risposta 201
CampoTipoObbligatorioNote
dataobjectsì
data.idstring (uuid)sì
data.urlstringsì
data.events"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"[]sì
data.secretstringsì
DELETE/api/v1/webhooks/{id}

Annullare l'iscrizione a un webhook

Rimuove un endpoint. Un ID sconosciuto o di un'altra impresa restituisce 404.

Scope richiesto: webhooks:write.

Scope: webhooks:write

Parametri
CampoTipoObbligatorioNote
id(percorso)string (uuid)sì

Risposte

  • 204 Endpoint rimosso.
  • 401 Chiave API mancante, sconosciuta o revocata. Corpo vuoto.
  • 403 Alla chiave manca lo scope richiesto.
  • 404 Non trovato – anche per ID di un'altra impresa.
  • 429 Troppe richieste per questa chiave.
  • 500 Errore interno.

Modelli di dati

Error

Campi
CampoTipoObbligatorioNote
errorstringsì

ValidationError

Campi
CampoTipoObbligatorioNote
errorstringsì
fieldsobjectsì

Customer

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
customer_numberstring | nullsì
customer_type"company" | "private"sì
salutation"herr" | "frau" | nullsì
company_namestring | nullsì
first_namestring | nullsì
last_namestring | nullsì
display_namestringsì
emailstring | nullsì
phonestring | nullsì
mobile_phonestring | nullsì
faxstring | nullsì
address_streetstring | nullsì
address_zipstring | nullsì
address_citystring | nullsì
tax_idstring | nullsì
notesstring | nullsì
is_archivedbooleansì
created_atstringsì
updated_atstring | nullsì

Project

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
namestringsì
project_numberstring | nullsì
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"sì
project_type"fixed_fee" | "time_and_materials" | "non_billable" | nullsì
customer_idstring (uuid)sì
descriptionstring | nullsì
start_datestring | nullsì
end_datestring | nullsì
address_streetstring | nullsì
address_zipstring | nullsì
address_citystring | nullsì
created_atstringsì

ProjectListItem

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
namestringsì
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"sì
customerobject | nullsì
customer.idstring (uuid)sì
customer.namestringsì

Lead

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
namestringsì
emailstring | nullsì
phonestring | nullsì
notesstring | nullsì
status"new" | "contacted" | "quote_sent" | "won" | "lost"sì
source"whatsapp" | "voice" | "test" | "website" | nullsì
customer_idstring (uuid) | nullsì
project_idstring (uuid) | nullsì
external_referencestring | nullsì
created_atstringsì

Document

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
numberstring | nullsì
type"quote" | "invoice"sì
invoice_kind"partial" | "final" | nullsì
status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"sì
datestring | nullsì
due_datestring | nullsì
currencystringsì
net_amountnumber | nullsì
tax_ratenumber | nullsì
tax_amountnumber | nullsì
gross_amountnumber | nullsì
customer_idstring (uuid) | nullsì
project_idstring (uuid) | nullsì
has_pdfbooleansì
created_atstringsì
updated_atstring | nullsì

DocumentDetail

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
numberstring | nullsì
type"quote" | "invoice"sì
invoice_kind"partial" | "final" | nullsì
status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"sì
datestring | nullsì
due_datestring | nullsì
currencystringsì
net_amountnumber | nullsì
tax_ratenumber | nullsì
tax_amountnumber | nullsì
gross_amountnumber | nullsì
customer_idstring (uuid) | nullsì
project_idstring (uuid) | nullsì
has_pdfbooleansì
created_atstringsì
updated_atstring | nullsì
pdfobject | nullsì
pdf.urlstring (uri)sì
pdf.expires_atstringsì
pdf.requires_postal_codetruesì

TimeEntry

Campi
CampoTipoObbligatorioNote
idstring (uuid)sì
user_idstring (uuid) | nullsì
project_idstring (uuid)sì
datestringsì
start_timestring | nullsì
end_timestring | nullsì
break_minutesintegersì
duration_minutesintegersì
work_type"arbeiten" | "laden" | "fahren" | "pause"sì
descriptionstring | nullsì
is_billableboolean | nullsì
status"pending" | "approved" | "rejected" | "invoiced"sì
external_sourcestring | nullsì
external_idstring | nullsì
projectobject | nullsì
project.idstring (uuid)sì
project.namestringsì