Clé cabinet seulement : les dossiers clients accessibles (numéro, raison sociale, SIREN). Passez ensuite ce numéro dans le paramètre dossier des autres outils (ou dans VOXFACTURA_DOSSIER).

Liste les factures impayées (envoyées, partiellement payées, en retard).

Liste les factures émises, éventuellement filtrées par statut, chantier (chantier_id = numéro du chantier dans le compte) ou période d'émission (debut / fin en AAAA-MM-JJ, inclus).

Détail d'une facture (lignes comprises) par son numéro dans le compte (le champ id renvoyé par la liste des factures).

PDF Factur-X d'une facture émise (par son numéro dans le compte), en base64 avec son nom de fichier. Un brouillon n'a pas de PDF.

Liste les dépenses (factures de frais). Chacune dit à quel client, devis ou facture elle est rattachée (client_id, devis_id, facture_id, numéros du compte). Filtrables par client (client_id = numéro du client dans le compte), par chantier (numéro du chantier, ancien regroupement), catégorie ou période (debut / fin en AAAA-MM-JJ, inclus).

Liste les justificatifs (photo de ticket, PDF) d'une dépense, par son numéro dans le compte : id, nom, type, taille.

Télécharge un justificatif d'une dépense (depense_id = numéro de la dépense dans le compte, justificatif_id = le champ id de justificatifs_depense), en base64 avec son type.

Liste les chantiers (ancien regroupement, gardé pour compatibilité), éventuellement filtrés par statut (en_cours, termine…) ou par client (client_id = numéro du client dans le compte). Pour la marge, préférer marge_client.

Détail d'un chantier (ancien regroupement) par son numéro dans le compte (le champ id renvoyé par la liste des chantiers).

Liste les clients, avec une recherche textuelle optionnelle.

Marge d'un client (client_id = numéro du client dans le compte, le champ id de l'outil clients) : facturé HT, dépenses et marge, en tout et par travail (un devis et ses factures, une facture seule, ou un regroupement), plus une ligne sans_document pour les dépenses du client sans devis ni facture. Mêmes chiffres que la fiche client de VoxFactura ; depenses_en_ttc vrai pour un compte en franchise de TVA. Nécessite une clé avec les permissions factures + dépenses.

Ancien regroupement, gardé pour compatibilité : préférer marge_client. Marge d'un chantier (par son numéro dans le compte) : chiffre d'affaires facturé moins les dépenses rangées sur ce chantier. Nécessite une clé avec les permissions factures + dépenses.

Récapitulatif TVA sur une période (dates AAAA-MM-JJ) : collectée, déductible, TVA nette. Nécessite la permission comptabilité.

Journal des ventes sur une période (dates AAAA-MM-JJ) : une écriture par facture et avoir. Nécessite la permission comptabilité.

Journal des achats sur une période (dates AAAA-MM-JJ) : une écriture par dépense. Nécessite la permission comptabilité.

Journal des ventes en CSV (séparateur « ; », montants à virgule), tel que l'importe un logiciel de compta français. Permission comptabilité.

Journal des achats en CSV (séparateur « ; », montants à virgule). Permission comptabilité.

Factures encaissées sur une période (dates AAAA-MM-JJ) : facture, date, montant, moyen (carte, virement, déclaré). Permission encaissements.

Fichier des écritures comptables (FEC, texte tabulé) de l'année, à remettre à l'expert-comptable. Nécessite la permission comptabilité.

Crée un devis en BROUILLON (permission devis:write). client_id et chantier_id sont les numéros du client et du chantier dans le compte. Chaque ligne : {designation, quantite, unite, prix_unitaire_ht, taux_tva}, plus en option prestation_id (numéro de la prestation du catalogue ; prix omis, la ligne prend le prix de ce client, sinon celui du catalogue) et nature (« bien » pour une vente, « service » sinon ; omise, elle suit la prestation du catalogue puis le réglage du compte). validite_jours : durée de validité (omis = celle réglée sur le compte, 30 jours par défaut). delai_execution : délai imprimé sur le devis (ex. « 3 semaines après acceptation »). Le devis n'est jamais envoyé automatiquement : l'artisan le relit et l'envoie dans VoxFactura. Son numero est nul tant qu'il est brouillon : le numéro définitif lui est attribué à l'envoi.

Modèles de devis de l'artisan (permission devis:write) : numéro, nom, objet et variables à remplir pour devis_depuis_modele.

Crée un devis en BROUILLON depuis un modèle de devis (permission devis:write). modele : nom ou numéro du modèle (voir modeles_devis). variables : valeur de chaque variable sous son nom, dates en AAAA-MM-JJ. client_id : numéro du client dans le compte, sinon celui du modèle. Jamais envoyé automatiquement : l'artisan le relit et l'envoie dans VoxFactura.

Marque une facture payée (permission payments:write). facture_id = numéro de la facture dans le compte. montant (texte, ex. « 500.00 ») pour un paiement partiel ; vide = solde le total.

Ajoute une dépense (permission expenses:write). Montants en texte (ex. « 240.00 »). Rattache à un chantier via chantier_id (numéro du chantier dans le compte).