Liste des champs
Certains champs peuvent avoir des valeurs spécifiques
| Champs | libellé | Type | Accès |
|---|---|---|---|
| id | Identifiant | int | lecture |
| customer_id | Client | int | 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 | modifiable |
| followup_id | Suivi commercial | int | modifiable |
| invoiced_on | Date facture | date | modifiable |
| term_on | Date d’échéance | date | modifiable |
| draft | Brouillon | boolean | modifiable |
| balance_year | Exercice fiscal Indique l’année de début de l’exercice fiscal lorsque l’exercice fiscal est personnalisé. | int | modifiable |
| 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 | modifiable |
| items | Lignes de facturation | array | modifiable |
| api_id | API - Référence numérique libre | bigint | 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 |
| payment_mode | Mode de règlement | int | modifiable |
| paid_on | Payé le | date | modifiable |
| next_run_on | A partir du | date | modifiable |
| last_run_on | Derniere facture enregistrée | date | lecture |
| occurrence | Occurrences | int | modifiable |
| frequency | Répeter | int | modifiable |
| invoice_ids | Tableau des IDs des factures associées à cette facture récurrente | array | lecture |
| mailing | Transmettre par courriel | boolean | modifiable |
| Configuration de l’email si la facture doit être transmise par courriel | hash | modifiable |
Ligne de facturation
Les lignes de facturations sont transmises sous forme d’un tableau de lignes, dans le champ items de la facture récurrente
Certains champs peuvent avoir des valeurs spécifiques
| Champs | libellé | Type | Accès |
|---|---|---|---|
| id | Identifiant | int | 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 | modifiable |
| position | Ligne n° | int | 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, la valeur ‘new_page’ permet d’indiquer un saut de page et la valeur ‘subsidy’ permet d’indiquer une déduction à appliquer sur le total TTC (ex: Prime CEE). | 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 | 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 |
Si vous activez l’envoi automatique des nouvelles factures (i.e. lorsque le paramètre mailing est à 1), vous devez indiquer les informations relatives à l’email dans le champ email de la facture récurrente.
Certains champs peuvent avoir des valeurs spécifiques
| Champs | libellé | Type | Accès |
|---|---|---|---|
| to | Destinataire(s) | string(255) | modifiable |
| cc | Copie | string(255) | modifiable |
| bcc | Copie cachée | string(255) | modifiable |
| subject | Sujet | string(255) | modifiable |
| message | Message | text | modifiable |