Liste des champs
Certains champs peuvent avoir des valeurs spécifiques
| Champs | libellé | Type | Accès |
|---|---|---|---|
| id | Identifiant | int(11) | lecture |
| customer_id | Client | int(11) | modifiable |
| customer_identity | Nom de la société ou du client | string(255) | lecture |
| title | Objet | string(255) | modifiable |
| language | Langue du PDF | string(2) | modifiable |
| category_id | Catégorie | int(11) | modifiable |
| followup_id | Suivi commercial | int(11) | modifiable |
| invoiced_on | Date du devis | date | modifiable |
| term_on | Valide jusqu’au | date | modifiable |
| draft | Brouillon | boolean | lecture |
| total | Montant total HT | decimal(15,3) | lecture |
| total_with_vat | Montant total TTC | decimal(15,3) | lecture |
| currency | Devise | string(3) | modifiable |
| rebate_percentage | Réduction globale | decimal(8,3) | modifiable |
| exchange_rate | Taux de change | lecture | |
| estimated_rate | Taux de change estimé? | lecture | |
| vat_exemption | Motif d’exonération de TVA | string(255) | modifiable |
| vat_country | Code pays des taux TVA à appliquer | string(2) | modifiable |
| tax_title | Intitulé de la taxe additionnelle sur le total HT | string(255) | modifiable |
| tax_percent | Pourcentage de la taxe additionnelle sur le total HT | decimal(5,2) | modifiable |
| penalty | Pénalités de retard | decimal(8,3) | modifiable |
| pay_before | Délai de paiement | string(16) | modifiable |
| discount | Taux d’escompte | decimal(8,3) | modifiable |
| precompte | Précompte des cotisations | boolean | modifiable |
| activity_title | Nature de l’activité | string(255) | modifiable |
| service_personne | Service à la personne | boolean | modifiable |
| accounting_entry | Compte d’imputation | string(8) | modifiable |
| information | Informations complémentaires | text | modifiable |
| internal_note | Note interne | text | modifiable |
| purchase_number | Bon de commande | string(100) | modifiable |
| created_at | Créé le | datetime(3) | lecture |
| updated_at | Modifié le | datetime(3) | lecture |
| user_id | Géré par | int(11) | modifiable |
| public_download_url | Url de téléchargement publique | string(255) | lecture |
| items | Lignes de facturation | array | modifiable |
| files | Fichiers joints | array | lecture |
| api_id | API - Référence numérique libre | bigint(20) | modifiable |
| api_custom | API - Texte libre | string(255) | modifiable |
| soft_deleted | Enregistrement marqué comme à supprimer | boolean | lecture |
| hard_delete_on | Date définitive de la suppression | date | lecture |
| quote_status | Statut du devis | int(11) | modifiable |
| quote_ref | Devis n° | int(11) | lecture |
| ignore_quote | Ne pas faire de suivi de facturation | boolean | modifiable |
| fully_invoiced | Devis soldé? | boolean | lecture |
| amount_invoiced | Montant déjà facturé | decimal(15,3) | lecture |
| invoice_ids | Tableau des IDs des factures associées à ce devis | array | lecture |
| delivery_on | Livré/Réalisé le | date | modifiable |
| estimated_total_in_main_currency | Total TTC estimé en euro | decimal | lecture |
Ligne de facturation
Les lignes de facturations sont transmises sous forme d’un tableau de lignes, dans le champ items du devis.
Certains champs peuvent avoir des valeurs spécifiques
| Champs | libellé | Type | Accès |
|---|---|---|---|
| id | Identifiant | int(11) | modifiable |
| quantity | Quantité | decimal(12,4) | modifiable |
| measure | Unité de mesure | string(32) | modifiable |
| title | Libellé | text | modifiable |
| unit_price | Prix unitaire HT | decimal(15,3) | modifiable |
| vat | Taux de TVA | decimal(5,3) | modifiable |
| product_id | Identifiant du produit | int(11) | modifiable |
| position | Ligne n° | int(11) | modifiable |
| total | Total HT | decimal(15,3) | lecture |
| optional | En option Ce champ n’est utilisé que pour les devis. Lorsque la valeur de ce champ est ‘true’, la ligne est considérée comme une option, elle n’est donc pas prise en compte dans le calcul du total, et toutes les lignes optionnelles sont regroupées en fin de devis dans un bloc spécifique. | boolean | modifiable |
| style | Style de formattage Par défaut (ie valeur vide), ce champ indique une ligne de facturation standard. La valeur ‘comment’ permet d’indiquer qu’il s’agit d’une ligne de commentaire, la valeur ‘title’ permet d’indiquer une ligne de titre (mise en gras automatiquement), la value ‘subtotal’ permet d’indiquer une ligne de sous-total et la valeur ‘new_page’ permet d’indiquer un saut de page. | string(20) | modifiable |
| nature | Type la nature de la prestation n’est à préciser que pour les auto-entrepreneurs et les micro-entrepreneurs, afin de calculer correctement les cotisations sociales. | int(11) | modifiable |
| sap_nature | Code activité Le code d’activité d’une prestation de service à la personne ne doit être précisé que s’il s’agit d’une facture de service à la personne | modifiable |