FreshBooks (préversion)
FreshBooks est un logiciel de comptabilité basé sur le cloud. Envoyez des factures, suivez le temps, gérez les reçus et les dépenses.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://www.freshbooks.com/ |
| Politique de confidentialité | https://www.freshbooks.com/policies/privacy |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
| Fréquence des sondages déclencheurs | 1 | 60 secondes |
Actions
| Ajouter un nouveau client |
Cette opération crée un client dans votre compte. Au moins un champ du client (c’est-à-dire le prénom, le nom, l’organisation, l’e-mail, etc.) doit être spécifié dans le cas contraire, l’opération échouera. |
| Créer une dépense |
Cette opération crée une dépense dans votre compte. |
| Mettre à jour les dépenses |
Cette opération est utilisée pour mettre à jour une dépense existante dans votre compte. |
| Répertorier les dépenses |
Récupère une liste de toutes vos dépenses. |
| Supprimer les dépenses |
Cette opération est utilisée pour supprimer une dépense existante de votre compte. |
Ajouter un nouveau client
Cette opération crée un client dans votre compte. Au moins un champ du client (c’est-à-dire le prénom, le nom, l’organisation, l’e-mail, etc.) doit être spécifié dans le cas contraire, l’opération échouera.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
|
Prénom
|
fname | string | ||
|
Nom de famille
|
lname | string | ||
|
Organisation
|
organization | string | ||
|
Adresse électronique
|
string | |||
|
Numéro de téléphone
|
bus_phone | string | ||
|
Monnaie
|
currency_code | string |
Code monétaire de 3 lettres. |
|
|
Adresse postale 1
|
p_street | string | ||
|
Adresse postale 2
|
p_street2 | string | ||
|
Ville
|
p_city | string | ||
|
Code postal
|
p_code | string | ||
|
Pays
|
p_country | string | ||
|
Province
|
p_province | string |
Retours
- Corps
- Client
Créer une dépense
Cette opération crée une dépense dans votre compte.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
|
Montant
|
amount | True | string | |
|
Monnaie
|
code | string |
Code monétaire de 3 lettres. |
|
|
Catégorie
|
categoryid | True | integer |
Choisissez une catégorie de dépenses. |
|
Personnel
|
staffid | True | integer |
Choisissez le membre du personnel à payer. |
|
Date
|
date | True | string |
AAAA -MM-DD ou format ISO datetime. |
|
Fournisseur
|
vendor | string |
Choisissez un fournisseur à frais. |
|
|
Remarques
|
notes | string |
Retours
- Corps
- Expense
Mettre à jour les dépenses
Cette opération est utilisée pour mettre à jour une dépense existante dans votre compte.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
|
Id des dépenses
|
expenseid | True | string |
ID unique des dépenses. |
|
Montant
|
amount | string | ||
|
Monnaie
|
code | string |
Code monétaire de 3 lettres. |
|
|
Catégorie
|
categoryid | integer |
Choisissez une catégorie de dépenses. |
|
|
Personnel
|
staffid | integer |
Choisissez le membre du personnel à payer. |
|
|
Date
|
date | string |
AAAA -MM-DD ou format ISO datetime. |
|
|
Fournisseur
|
vendor | string |
Choisissez un fournisseur à frais. |
|
|
Remarques
|
notes | string |
Répertorier les dépenses
Récupère une liste de toutes vos dépenses.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
Retours
Tableau de dépenses.
- Objets
- ExpenseList
Supprimer les dépenses
Cette opération est utilisée pour supprimer une dépense existante de votre compte.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
|
Id des dépenses
|
expenseid | True | string |
ID unique des dépenses. |
Déclencheurs
| Lorsqu’un paiement est enregistré ou mis à jour |
Se déclenche lorsqu’un nouveau paiement est enregistré ou qu’un nouveau paiement est mis à jour. |
| Lorsqu’une dépense est créée ou mise à jour |
Se déclenche lorsqu’une nouvelle dépense est créée ou qu’une dépense existante est mise à jour. |
| Lorsqu’une facture est créée ou mise à jour |
Se déclenche lorsqu’une nouvelle facture est créée ou qu’une facture existante est mise à jour. |
Lorsqu’un paiement est enregistré ou mis à jour
Se déclenche lorsqu’un nouveau paiement est enregistré ou qu’un nouveau paiement est mis à jour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
Retours
- Corps
- Payment
Lorsqu’une dépense est créée ou mise à jour
Se déclenche lorsqu’une nouvelle dépense est créée ou qu’une dépense existante est mise à jour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
Retours
- Corps
- Expense
Lorsqu’une facture est créée ou mise à jour
Se déclenche lorsqu’une nouvelle facture est créée ou qu’une facture existante est mise à jour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Compte
|
accountid | True | string |
ID du compte de frais. |
Retours
- Corps
- Invoice
Définitions
ExpenseList
Tableau de dépenses.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Objets
|
Expense |
Dépense
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID des dépenses
|
id | integer |
Unique à cet ID d’entreprise pour les dépenses. |
|
Pourcentage de balisage
|
markup_percent | string |
Décimale, pourcentage pour marquer les dépenses. |
|
ID de projet
|
projectid | integer |
ID du projet associé, le cas échéant. |
|
ID client
|
clientid | integer |
ID du client associé, le cas échéant. |
|
Pourcentage d’impôt 1
|
taxPercent1 | string |
Décimal, premier pourcentage d’impôt. |
|
Nom fiscal 1
|
taxName1 | string |
Nom de la première taxe. |
|
Première quantité de tâches
|
taxAmount1.amount | string |
Montant de la première taxe. |
|
Premier code monétaire fiscal
|
taxAmount1.code | string |
Code monétaire de 3 lettres. |
|
Pourcentage d’impôt 2
|
taxPercent2 | string |
Décimal, deuxième pourcentage d’impôt. |
|
Nom fiscal 2
|
taxName2 | string |
Nom de la deuxième taxe. |
|
Deuxième montant fiscal
|
taxAmount2.amount | string |
Montant de la deuxième taxe. |
|
Deuxième code monétaire fiscal
|
taxAmount2.code | string |
Code monétaire de 3 lettres. |
|
ID de facture
|
invoiceid | integer |
ID de la facture associée, le cas échéant. |
|
Statut
|
status | integer |
Valeur de la table d’état des dépenses. |
|
Nom de la banque
|
bank_name | string |
Le nom des dépenses bancaires a été importé, le cas échéant. |
|
Fournisseur
|
vendor | string |
Nom du fournisseur. |
|
Reçu
|
has_receipt | boolean |
True si le reçu est joint. |
|
ID système externe
|
ext_systemid | integer |
ID du système d’entrepreneur associé, le cas échéant. |
|
Date
|
date | string |
Date des dépenses. |
|
ID de la transaction
|
transactionid | string |
ID de la transaction associée, le cas échéant. |
|
Remarques
|
notes | string |
Notes de frais. |
|
Nom du compte
|
account_name | string |
Nom du compte associé, le cas échéant. |
|
Montant
|
amount.amount | string |
Valeur décimale. |
|
Code monétaire
|
amount.code | string |
Code monétaire de 3 lettres. |
|
Taxe composée
|
compounded_tax | boolean |
Vrai si l’impôt 2 était un impôt composé. |
|
ID de compte
|
accountid | string |
ID du compte de frais, le cas échéant. |
Facture
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID facture
|
id | integer |
ID de facture unique à ce système. |
|
Numéro de facture
|
invoice_number | string |
ID de facture spécifié par l’utilisateur et visible. |
|
ID de compte
|
accountid | string |
ID unique pour le système. |
|
Code monétaire de 3 lettres
|
currency_code | string |
Code monétaire à trois lettres pour la facture. |
|
Statut de la facture
|
v3_status | string |
État de la facture. |
|
Descriptif
|
description | string |
Description de la première ligne de facture. |
|
Remarques
|
notes | string |
Notes répertoriées sur facture. |
|
Code de langue à deux lettres
|
language | string |
Code de langue à deux lettres de la facture. |
|
ID de client
|
customerid | integer |
ID client unique à ce système. |
|
Organisation facturée
|
organization | string |
Nom de l’organisation facturée. |
|
Prénom du client
|
fname | string |
Prénom du client sur facture. |
|
Nom du client
|
lname | string |
Nom du client sur facture. |
|
Date de création de facture
|
create_date | string |
Date de création de la facture, format aaaa-MM-DD. |
|
Date d’échéance de la facture
|
due_date | string |
La facture de date est marquée comme due par le format aaaa-MM-DD. |
|
Dernière mise à jour
|
updated | string |
Heure de la dernière mise à jour de la facture, aaaa-MM-DD format HH :MM :SS. |
|
Créer une date
|
created_at | string |
Date de création de la facture, AAAA -MM-DD format HH :MM :SS. |
|
Date de paiement de la facture
|
date_paid | string |
La facture de date a été entièrement payée, formatMM-DD aaaa. |
|
État du paiement
|
payment_status | string |
Description de l’état du paiement. L’un des « non payés », « partiels », « payés » et « payés automatiquement ». |
|
Montant de la facture
|
amount.amount | string |
Montant total de la facture, à deux décimales. |
|
Montant payé
|
paid.amount | string |
Montant payé sur facture, à deux décimales. |
|
Montant en suspens
|
outstanding.amount | string |
Montant en attente sur facture, à deux décimales. |
|
Montant de la remise
|
discount.amount | string |
Montant de remise, à deux décimales. |
|
Messagerie électronique
|
client.email | string |
E-mail du client. |
Paiement
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de paiement
|
id | integer |
ID de paiement unique à ce système. |
|
Type de paiement
|
type | string |
Type de paiement - Espèces, chèque, crédit |
|
Note
|
note | string |
Notes répertoriées sur le paiement. |
|
Date de paiement
|
date | string |
Date à laquelle le paiement a été effectué, format aaaa-MM-DD. |
|
ID de client
|
clientid | integer |
ID client unique à ce système. |
|
Montant de la facture
|
amount.amount | string |
Montant total du paiement, à deux décimales. |
|
Code monétaire de 3 lettres
|
amount.code | string |
Code monétaire à trois lettres. |
|
ID de compte
|
accounting_systemid | string |
ID unique pour les entreprises. |
|
ID facture
|
invoiceid | integer |
ID de la facture associée. |
|
Prénom
|
client.fname | string |
Prénom du client. |
|
Nom de famille
|
client.lname | string |
Nom du client. |
|
Messagerie électronique
|
client.email | string |
E-mail du client. |
|
Nom d’utilisateur
|
client.username | string |
Nom d’utilisateur utilisé par le client pour se connecter. |
|
Organisation
|
client.organization | string |
Nom de l’entreprise du client. |
Client
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Prénom
|
response.result.client.fname | string |
Prénom du client. |
|
Nom de famille
|
response.result.client.lname | string |
Nom du client. |
|
Fa Number
|
response.result.client.fax | string |
Numéro de télécopie du client. |
|
Numéro de TVA
|
response.result.client.vat_number | string |
Numéro de taxe sur la valeur ajoutée. |
|
Nom de la TVA
|
response.result.client.vat_name | string |
Nom de la taxe sur la valeur ajoutée. |
|
ID client
|
response.result.client.id | integer |
Unique à cet ID d’entreprise pour le client. |
|
Province
|
response.result.client.s_province | string |
Adresse d’expédition. |
|
Pays
|
response.result.client.s_country | string |
Adresse d’expédition. |
|
Ville
|
response.result.client.s_city | string |
Adresse d’expédition. |
|
Rue
|
response.result.client.s_street | string |
Adresse d’expédition. |
|
Rue 2
|
response.result.client.s_street2 | string |
Adresse d’expédition. |
|
Code postal
|
response.result.client.s_code | string |
Adresse d’expédition. |
|
Note
|
response.result.client.note | string |
Notes conservées par l’administrateur sur le client. |
|
Téléphone mobile
|
response.result.client.mob_phone | string |
Numéro de téléphone mobile. |
|
Téléphone personnel
|
response.result.client.home_phone | string |
Numéro de téléphone à domicile. |
|
Industrie de l’entreprise
|
response.result.client.company_industry | string |
Description du client de l’industrie. |
|
Messagerie électronique
|
response.result.client.email | string |
E-mail du client. |
|
Nom d’utilisateur
|
response.result.client.username | string |
Nom d’utilisateur utilisé par le client pour se connecter. |
|
Province
|
response.result.client.p_province | string |
Adresse de facturation. |
|
Pays
|
response.result.client.p_country | string |
Adresse de facturation. |
|
Ville
|
response.result.client.p_city | string |
Adresse de facturation. |
|
Rue
|
response.result.client.p_street | string |
Adresse de facturation. |
|
Code postal
|
response.result.client.p_code | string |
Adresse de facturation. |
|
Rue 2
|
response.result.client.p_street2 | string |
Adresse de facturation. |
|
Téléphone
|
response.result.client.bus_phone | string |
Adresse de facturation. |
|
Taille
|
response.result.client.company_size | string |
Adresse de facturation. |
|
ID système
|
response.result.client.accounting_systemid | string |
L’identificateur unique du client d’entreprise existe. |
|
Language
|
response.result.client.language | string |
Shortcode indiquant la langue de l’utilisateur. |
|
Organisation
|
response.result.client.organization | string |
Nom de l’entreprise du client. |
|
Code monétaire
|
response.result.client.currency_code | string |
Shortcode à 3 lettres pour la devise préférée. |