API REST Bleno

Connectez à Bleno les formulaires de votre site, des portails de demandes, des pointeuses ou votre propre logiciel : créez des clients, des projets et des demandes, récupérez devis et factures, transférez les saisies de temps.

Version 1.0.0

La référence API ci-dessous est générée à partir de la spécification. La spécification JSON elle-même décrit les champs en allemand.

Authentification

API REST pour les clients, projets, demandes, devis/factures, saisies de temps et webhooks d’une entreprise Bleno.

Authentification par clé API (Authorization: Bearer bleno_…). Chaque clé porte des scopes par ressource (read/write) ; un scope manquant renvoie 403.

Limite de débit : 60 appels par clé et par 60 secondes, au-delà 429 avec Retry-After.

Les administrateurs créent une clé sous « Einstellungen → API & Webhooks » (paramètres) et y choisissent les scopes. La clé n’est affichée qu’une seule fois. Les données d’autres entreprises ne sont jamais accessibles : les ID d’une autre entreprise renvoient 404 comme des ID inconnus et, utilisés comme filtre, une liste vide.

La description lisible par machine pour les générateurs de code et les outils API : Spécification OpenAPI (JSON, descriptions en allemand)

curl https://bleno.de/api/v1/customers \
  -H "Authorization: Bearer bleno_…"
Scopes
DomaineLectureÉcriture
Clientscustomers:readcustomers:write
Projetsprojects:readprojects:write
Demandesleads:readleads:write
Documentsdocuments:readdocuments:write
Saisies de tempstime_entries:readtime_entries:write
Webhookswebhooks:readwebhooks:write

Clients

Lire, créer et modifier les clients de l’entreprise.

GET/api/v1/customers

Lister les clients

Par pages ; clients archivés seulement avec include_archived=true.

Scope requis : customers:read.

Scope : customers:read

Paramètres
ChampTypeObligatoireRemarques
limit(query)integernonPar défaut : 50 · min. 1 · max. 100
offset(query)integernonPar défaut : 0 · min. 0
include_archived(query)"true" | "false"nonPar défaut : "false"

Réponses

  • 200 Liste des clients.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobject[]oui
data[].idstring (uuid)oui
data[].customer_numberstring | nulloui
data[].customer_type"company" | "private"oui
data[].salutation"herr" | "frau" | nulloui
data[].company_namestring | nulloui
data[].first_namestring | nulloui
data[].last_namestring | nulloui
data[].display_namestringoui
data[].emailstring | nulloui
data[].phonestring | nulloui
data[].mobile_phonestring | nulloui
data[].faxstring | nulloui
data[].address_streetstring | nulloui
data[].address_zipstring | nulloui
data[].address_citystring | nulloui
data[].tax_idstring | nulloui
data[].notesstring | nulloui
data[].is_archivedbooleanoui
data[].created_atstringoui
data[].updated_atstring | nulloui
paginationobjectoui
pagination.limitintegeroui
pagination.offsetintegeroui
pagination.totalintegeroui
POST/api/v1/customers

Créer un client

Sans customer_type : avec raison sociale une entreprise, sinon un particulier. Champs obligatoires comme dans le formulaire client.

Scope requis : customers:write.

Scope : customers:write

Requête (JSON)
ChampTypeObligatoireRemarques
customer_type"company" | "private"non
salutation"herr" | "frau" | nullnon
company_namestring | nullnonau plus 200 caractères
first_namestring | nullnonau plus 100 caractères
last_namestring | nullnonau plus 100 caractères
emailstring (email) | "" | quelconque | nullnon
customer_numberstring | nullnonau plus 50 caractères
phonestring | nullnonau plus 50 caractères
mobile_phonestring | nullnonau plus 50 caractères
faxstring | nullnonau plus 50 caractères
address_streetstring | nullnonau plus 200 caractères
address_zipstring | nullnonau plus 20 caractères
address_citystring | nullnonau plus 100 caractères
tax_idstring | nullnonau plus 50 caractères
notesstring | nullnonau plus 5000 caractères

Réponses

  • 201 Client créé.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 409 Conflit, p. ex. numéro de client ou de projet en double, ou saisie de temps déjà facturée.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 201
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.customer_numberstring | nulloui
data.customer_type"company" | "private"oui
data.salutation"herr" | "frau" | nulloui
data.company_namestring | nulloui
data.first_namestring | nulloui
data.last_namestring | nulloui
data.display_namestringoui
data.emailstring | nulloui
data.phonestring | nulloui
data.mobile_phonestring | nulloui
data.faxstring | nulloui
data.address_streetstring | nulloui
data.address_zipstring | nulloui
data.address_citystring | nulloui
data.tax_idstring | nulloui
data.notesstring | nulloui
data.is_archivedbooleanoui
data.created_atstringoui
data.updated_atstring | nulloui
GET/api/v1/customers/{id}

Récupérer un client

Scope requis : customers:read.

Scope : customers:read

Paramètres
ChampTypeObligatoireRemarques
id(chemin)string (uuid)oui

Réponses

  • 200 Client.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.customer_numberstring | nulloui
data.customer_type"company" | "private"oui
data.salutation"herr" | "frau" | nulloui
data.company_namestring | nulloui
data.first_namestring | nulloui
data.last_namestring | nulloui
data.display_namestringoui
data.emailstring | nulloui
data.phonestring | nulloui
data.mobile_phonestring | nulloui
data.faxstring | nulloui
data.address_streetstring | nulloui
data.address_zipstring | nulloui
data.address_citystring | nulloui
data.tax_idstring | nulloui
data.notesstring | nulloui
data.is_archivedbooleanoui
data.created_atstringoui
data.updated_atstring | nulloui
PATCH/api/v1/customers/{id}

Modifier un client

Seuls les champs transmis changent ; null vide un champ.

Scope requis : customers:write.

Scope : customers:write

Paramètres
ChampTypeObligatoireRemarques
id(chemin)string (uuid)oui
Requête (JSON)
ChampTypeObligatoireRemarques
customer_type"company" | "private"non
salutation"herr" | "frau" | nullnon
company_namestring | nullnonau plus 200 caractères
first_namestring | nullnonau plus 100 caractères
last_namestring | nullnonau plus 100 caractères
emailstring (email) | "" | quelconque | nullnon
customer_numberstring | nullnonau plus 50 caractères
phonestring | nullnonau plus 50 caractères
mobile_phonestring | nullnonau plus 50 caractères
faxstring | nullnonau plus 50 caractères
address_streetstring | nullnonau plus 200 caractères
address_zipstring | nullnonau plus 20 caractères
address_citystring | nullnonau plus 100 caractères
tax_idstring | nullnonau plus 50 caractères
notesstring | nullnonau plus 5000 caractères

Réponses

  • 200 Client modifié.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 409 Conflit, p. ex. numéro de client ou de projet en double, ou saisie de temps déjà facturée.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.customer_numberstring | nulloui
data.customer_type"company" | "private"oui
data.salutation"herr" | "frau" | nulloui
data.company_namestring | nulloui
data.first_namestring | nulloui
data.last_namestring | nulloui
data.display_namestringoui
data.emailstring | nulloui
data.phonestring | nulloui
data.mobile_phonestring | nulloui
data.faxstring | nulloui
data.address_streetstring | nulloui
data.address_zipstring | nulloui
data.address_citystring | nulloui
data.tax_idstring | nulloui
data.notesstring | nulloui
data.is_archivedbooleanoui
data.created_atstringoui
data.updated_atstring | nulloui

Projets

Lire et créer des projets.

GET/api/v1/projects

Lister les projets

Tous les projets non archivés avec client et statut, triés par nom.

Scope requis : projects:read.

Scope : projects:read

Réponses

  • 200 Liste des projets.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
projectsobject[]oui
projects[].idstring (uuid)oui
projects[].namestringoui
projects[].status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"oui
projects[].customerobject | nulloui
projects[].customer.idstring (uuid)oui
projects[].customer.namestringoui
POST/api/v1/projects

Créer un projet

Si l’entreprise utilise des numéros de projet automatiques, Bleno attribue le numéro suivant lorsqu’aucun n’est transmis.

Scope requis : projects:write.

Scope : projects:write

Requête (JSON)
ChampTypeObligatoireRemarques
namestringouiau moins 1 caractères · au plus 200 caractères
customer_idstring (uuid)oui
descriptionstring | nullnonau plus 5000 caractères
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"non
project_type"fixed_fee" | "time_and_materials" | "non_billable"non
project_numberstring | nullnonau plus 60 caractères
start_datestring | nullnonMotif ^\d{4}-\d{2}-\d{2}$
end_datestring | nullnonMotif ^\d{4}-\d{2}-\d{2}$
address_streetstring | nullnonau plus 200 caractères
address_zipstring | nullnonau plus 20 caractères
address_citystring | nullnonau plus 100 caractères

Réponses

  • 201 Projet créé.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 409 Conflit, p. ex. numéro de client ou de projet en double, ou saisie de temps déjà facturée.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 201
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.namestringoui
data.project_numberstring | nulloui
data.status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"oui
data.project_type"fixed_fee" | "time_and_materials" | "non_billable" | nulloui
data.customer_idstring (uuid)oui
data.descriptionstring | nulloui
data.start_datestring | nulloui
data.end_datestring | nulloui
data.address_streetstring | nulloui
data.address_zipstring | nulloui
data.address_citystring | nulloui
data.created_atstringoui

Demandes

Créer des demandes depuis les formulaires du site et des portails.

POST/api/v1/leads

Créer une demande

Pour les formulaires de site et les portails de demandes. Les nouvelles demandes démarrent avec le statut new et l’origine website.

Scope requis : leads:write.

Scope : leads:write

Requête (JSON)
ChampTypeObligatoireRemarques
namestringouiau moins 1 caractères · au plus 200 caractères
emailstring (email) | "" | quelconque | nullnon
phonestring | nullnonau plus 50 caractères
notesstring | nullnonau plus 5000 caractères
customer_idstring (uuid) | nullnon
external_referencestring | nullnonau plus 200 caractères

Réponses

  • 201 Demande créée.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 201
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.namestringoui
data.emailstring | nulloui
data.phonestring | nulloui
data.notesstring | nulloui
data.status"new" | "contacted" | "quote_sent" | "won" | "lost"oui
data.source"whatsapp" | "voice" | "test" | "website" | nulloui
data.customer_idstring (uuid) | nulloui
data.project_idstring (uuid) | nulloui
data.external_referencestring | nulloui
data.created_atstringoui

Documents

Lire les devis et factures avec statut, montants et lien PDF.

GET/api/v1/documents

Lister les devis et factures

Filtrable par type, statut, client et projet. La liste ne contient pas de liens PDF.

Scope requis : documents:read.

Scope : documents:read

Paramètres
ChampTypeObligatoireRemarques
limit(query)integernonPar défaut : 50 · min. 1 · max. 100
offset(query)integernonPar défaut : 0 · min. 0
type(query)"quote" | "invoice"non
status(query)"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"non
customer_id(query)string (uuid)non
project_id(query)string (uuid)non

Réponses

  • 200 Liste des documents.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobject[]oui
data[].idstring (uuid)oui
data[].numberstring | nulloui
data[].type"quote" | "invoice"oui
data[].invoice_kind"partial" | "final" | nulloui
data[].status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"oui
data[].datestring | nulloui
data[].due_datestring | nulloui
data[].currencystringoui
data[].net_amountnumber | nulloui
data[].tax_ratenumber | nulloui
data[].tax_amountnumber | nulloui
data[].gross_amountnumber | nulloui
data[].customer_idstring (uuid) | nulloui
data[].project_idstring (uuid) | nulloui
data[].has_pdfbooleanoui
data[].created_atstringoui
data[].updated_atstring | nulloui
paginationobjectoui
pagination.limitintegeroui
pagination.offsetintegeroui
pagination.totalintegeroui
GET/api/v1/documents/{id}

Récupérer un devis ou une facture

Avec lien PDF : limité dans le temps, et à l’ouverture Bleno demande le code postal du client.

Scope requis : documents:read.

Scope : documents:read

Paramètres
ChampTypeObligatoireRemarques
id(chemin)string (uuid)oui

Réponses

  • 200 Document.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.numberstring | nulloui
data.type"quote" | "invoice"oui
data.invoice_kind"partial" | "final" | nulloui
data.status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"oui
data.datestring | nulloui
data.due_datestring | nulloui
data.currencystringoui
data.net_amountnumber | nulloui
data.tax_ratenumber | nulloui
data.tax_amountnumber | nulloui
data.gross_amountnumber | nulloui
data.customer_idstring (uuid) | nulloui
data.project_idstring (uuid) | nulloui
data.has_pdfbooleanoui
data.created_atstringoui
data.updated_atstring | nulloui
data.pdfobject | nulloui
data.pdf.urlstring (uri)oui
data.pdf.expires_atstringoui
data.pdf.requires_postal_codetrueoui

Saisies de temps

Lire les saisies de temps et les transférer depuis des terminaux ou des systèmes tiers.

GET/api/v1/time-entries

Lister les saisies de temps

Saisies de la période from à to, en option pour un seul collaborateur.

Scope requis : time_entries:read.

Scope : time_entries:read

Paramètres
ChampTypeObligatoireRemarques
from(query)stringouiMotif ^\d{4}-\d{2}-\d{2}$
to(query)stringouiMotif ^\d{4}-\d{2}-\d{2}$
user_id(query)string (uuid)non
limit(query)integernonLes valeurs au-delà de 500 sont ramenées à 500. · Par défaut : 200 · min. 1 · max. 500
offset(query)integernonPar défaut : 0 · min. 0

Réponses

  • 200 Saisies de temps.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
entriesobject[]oui
entries[].idstring (uuid)oui
entries[].user_idstring (uuid) | nulloui
entries[].project_idstring (uuid)oui
entries[].datestringoui
entries[].start_timestring | nulloui
entries[].end_timestring | nulloui
entries[].break_minutesintegeroui
entries[].duration_minutesintegeroui
entries[].work_type"arbeiten" | "laden" | "fahren" | "pause"oui
entries[].descriptionstring | nulloui
entries[].is_billableboolean | nulloui
entries[].status"pending" | "approved" | "rejected" | "invoiced"oui
entries[].external_sourcestring | nulloui
entries[].external_idstring | nulloui
entries[].projectobject | nulloui
entries[].project.idstring (uuid)oui
entries[].project.namestringoui
has_morebooleanoui
POST/api/v1/time-entries

Transférer une saisie de temps

Soit duration_minutes, soit start_time et end_time. Avec external_source et external_id, un nouvel appel met à jour la même saisie au lieu d’en créer une deuxième. La validation relève de l’entreprise.

Scope requis : time_entries:write.

Scope : time_entries:write

Requête (JSON)
ChampTypeObligatoireRemarques
user_idstring (uuid)oui
project_idstring (uuid)oui
datestringouiMotif ^\d{4}-\d{2}-\d{2}$
work_type"arbeiten" | "laden" | "fahren" | "pause"nonPar défaut : "arbeiten"
start_timestringnonMotif ^\d{1,2}:\d{2}$
end_timestringnonMotif ^\d{1,2}:\d{2}$
break_minutesnumbernonmin. 0
duration_minutesnumbernonmin. 0 · max. 1440
descriptionstringnon
is_billablebooleannon
external_sourcestringnon
external_idstringnon

Réponses

  • 200 Saisie existante de la même origine mise à jour.
  • 201 Saisie de temps créée (`created`) ; pour une origine connue 200 avec `updated`.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 409 Conflit, p. ex. numéro de client ou de projet en double, ou saisie de temps déjà facturée.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
action"created" | "updated"oui
idstring (uuid)oui
Réponse 201
ChampTypeObligatoireRemarques
action"created" | "updated"oui
idstring (uuid)oui

Webhooks

S’abonner aux webhooks sortants pour Zapier, Make et vos propres récepteurs.

GET/api/v1/webhooks

Lister les webhooks

Points de terminaison de l’entreprise sans secret de signature. Test de connexion pour Zapier et Make.

Scope requis : webhooks:read.

Scope : webhooks:read

Réponses

  • 200 Points de terminaison.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 200
ChampTypeObligatoireRemarques
dataobject[]oui
data[].idstring (uuid)oui
data[].urlstringoui
data[].descriptionstring | nulloui
data[].eventsstring[]oui
data[].is_activebooleanoui
POST/api/v1/webhooks

S’abonner à un webhook

Crée un point de terminaison. Zapier envoie target_url et event, les autres clients url et events. Le secret de signature ne figure que dans cette réponse.

Scope requis : webhooks:write.

Scope : webhooks:write

Requête (JSON)
ChampTypeObligatoireRemarques
urlstringnon
target_urlstringnon
event"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"non
events"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"[]non
descriptionstringnonau plus 200 caractères

Réponses

  • 201 Point de terminaison créé.
  • 400 Saisie non valide.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.
Réponse 201
ChampTypeObligatoireRemarques
dataobjectoui
data.idstring (uuid)oui
data.urlstringoui
data.events"customer.created" | "project.created" | "project.status_changed" | "lead.created" | "quote.accepted" | "quote.rejected" | "invoice.sent" | "invoice.paid" | "time_entry.created"[]oui
data.secretstringoui
DELETE/api/v1/webhooks/{id}

Se désabonner d’un webhook

Supprime un point de terminaison. Un ID inconnu ou d’une autre entreprise renvoie 404.

Scope requis : webhooks:write.

Scope : webhooks:write

Paramètres
ChampTypeObligatoireRemarques
id(chemin)string (uuid)oui

Réponses

  • 204 Point de terminaison supprimé.
  • 401 Clé API absente, inconnue ou révoquée. Corps vide.
  • 403 Il manque à la clé le scope requis.
  • 404 Introuvable – y compris pour les ID d’une autre entreprise.
  • 429 Trop de requêtes pour cette clé.
  • 500 Erreur interne.

Modèles de données

Error

Champs
ChampTypeObligatoireRemarques
errorstringoui

ValidationError

Champs
ChampTypeObligatoireRemarques
errorstringoui
fieldsobjectoui

Customer

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
customer_numberstring | nulloui
customer_type"company" | "private"oui
salutation"herr" | "frau" | nulloui
company_namestring | nulloui
first_namestring | nulloui
last_namestring | nulloui
display_namestringoui
emailstring | nulloui
phonestring | nulloui
mobile_phonestring | nulloui
faxstring | nulloui
address_streetstring | nulloui
address_zipstring | nulloui
address_citystring | nulloui
tax_idstring | nulloui
notesstring | nulloui
is_archivedbooleanoui
created_atstringoui
updated_atstring | nulloui

Project

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
namestringoui
project_numberstring | nulloui
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"oui
project_type"fixed_fee" | "time_and_materials" | "non_billable" | nulloui
customer_idstring (uuid)oui
descriptionstring | nulloui
start_datestring | nulloui
end_datestring | nulloui
address_streetstring | nulloui
address_zipstring | nulloui
address_citystring | nulloui
created_atstringoui

ProjectListItem

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
namestringoui
status"planned" | "ready_for_work" | "in_progress" | "completed" | "cancelled" | "on_hold"oui
customerobject | nulloui
customer.idstring (uuid)oui
customer.namestringoui

Lead

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
namestringoui
emailstring | nulloui
phonestring | nulloui
notesstring | nulloui
status"new" | "contacted" | "quote_sent" | "won" | "lost"oui
source"whatsapp" | "voice" | "test" | "website" | nulloui
customer_idstring (uuid) | nulloui
project_idstring (uuid) | nulloui
external_referencestring | nulloui
created_atstringoui

Document

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
numberstring | nulloui
type"quote" | "invoice"oui
invoice_kind"partial" | "final" | nulloui
status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"oui
datestring | nulloui
due_datestring | nulloui
currencystringoui
net_amountnumber | nulloui
tax_ratenumber | nulloui
tax_amountnumber | nulloui
gross_amountnumber | nulloui
customer_idstring (uuid) | nulloui
project_idstring (uuid) | nulloui
has_pdfbooleanoui
created_atstringoui
updated_atstring | nulloui

DocumentDetail

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
numberstring | nulloui
type"quote" | "invoice"oui
invoice_kind"partial" | "final" | nulloui
status"draft" | "published" | "sent" | "accepted" | "rejected" | "lost" | "partially_paid" | "paid" | "cancelled"oui
datestring | nulloui
due_datestring | nulloui
currencystringoui
net_amountnumber | nulloui
tax_ratenumber | nulloui
tax_amountnumber | nulloui
gross_amountnumber | nulloui
customer_idstring (uuid) | nulloui
project_idstring (uuid) | nulloui
has_pdfbooleanoui
created_atstringoui
updated_atstring | nulloui
pdfobject | nulloui
pdf.urlstring (uri)oui
pdf.expires_atstringoui
pdf.requires_postal_codetrueoui

TimeEntry

Champs
ChampTypeObligatoireRemarques
idstring (uuid)oui
user_idstring (uuid) | nulloui
project_idstring (uuid)oui
datestringoui
start_timestring | nulloui
end_timestring | nulloui
break_minutesintegeroui
duration_minutesintegeroui
work_type"arbeiten" | "laden" | "fahren" | "pause"oui
descriptionstring | nulloui
is_billableboolean | nulloui
status"pending" | "approved" | "rejected" | "invoiced"oui
external_sourcestring | nulloui
external_idstring | nulloui
projectobject | nulloui
project.idstring (uuid)oui
project.namestringoui