Documentation API – Tax

Tax API

Consultez les taxes configurées dans vos systèmes ERP avec une API REST unifiée.
Récupérez les informations de taxes pour Acomba, QuickBooks Online et autres systèmes ERP.

GET/Entity/Tax

Aperçu

L’entité Tax représente une taxe configurée dans votre système ERP (TPS, TVQ, TVA, etc.).
Cette API permet d’effectuer des opérations de lecture (GET) sur les taxes
de manière standardisée, peu importe le système ERP sous-jacent.

L’API utilise des endpoints REST standards avec les méthodes HTTP appropriées :

GET /Entity/Tax – Récupérer la liste des taxes configurées

💡 Note importante

Les champs retournés varient selon le système ERP. Acomba retourne un modèle plus détaillé (InfoTaxe) incluant les taux et les comptes GL, tandis que QuickBooks Online retourne un modèle simplifié (FicheTaxe) avec le nom et l’identifiant unique.

Matrice de Support

Opérations supportées pour l’entité Tax par système ERP :

Système ERP	GET	POST	PUT
Acomba	✓ Oui	✗ Non	✗ Non
QuickBooks Online	✓ Oui	✗ Non	✗ Non
Avantage	✗ Non	✗ Non	✗ Non
Sage 50	✗ Non	✗ Non	✗ Non
Servex	✗ Non	✗ Non	✗ Non
Servicentre	✗ Non	✗ Non	✗ Non

GET Tax

Récupère la liste des taxes configurées dans le système ERP avec support de filtrage, pagination et sélection de champs.

GET/Entity/Tax

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionnel	Expression de filtrage de style OData
$select	string	Optionnel	Champs à retourner (séparés par des virgules)
$top	integer	Optionnel	Nombre maximum de résultats
$skip	integer	Optionnel	Nombre de résultats à ignorer (pagination)

💡 Note importante

Pour plus de détails sur la composition des requêtes, consultez : Composer une requête à l’API d’ERP Connector

⚠️ Filtrage QuickBooks Online

Pour QuickBooks Online, seuls les champs NoUniqueSystemeSource et NomTaxe sont supportés pour le filtrage.

Get Tax

GET /Entity/Tax
Host: https://v4.api.onlineerp.solution.quebec/api
Content-Type: application/json

Response Acomba (200 OK)

[
    {
        "NoUniqueSystemeSource": "1",
        "Fiche_DerniereModification": "2024-01-10T14:30:00",
        "Taxe_Numero": "T.P.S. 100%",
        "Taxe_Description": "Taxe sur les produits et services",
        "MontantTaxe": 0,
        "Taxe_NumeroLegalGouv": "RT100393939933",
        "NoCompteGL_PayedTax": "2310",
        "NoCompteGL_PerceivedTax": "2300",
        "ListeTaux": [
            {
                "TaxRateId": 0,
                "EffectiveTaxRate": 5.0
            }
        ]
    },
    {
        "NoUniqueSystemeSource": "2",
        "Fiche_DerniereModification": "2024-01-10T14:30:00",
        "Taxe_Numero": "T.V.Q. 100%",
        "Taxe_Description": "Taxe de Vente Québec",
        "MontantTaxe": 0,
        "Taxe_NumeroLegalGouv": "TQ1000292929922",
        "NoCompteGL_PayedTax": "2315",
        "NoCompteGL_PerceivedTax": "2305",
        "ListeTaux": [
            {
                "TaxRateId": 0,
                "EffectiveTaxRate": 9.975
            }
        ]
    }
]

Response QuickBooks Online (200 OK)

[
    {
        "NoUniqueSystemeSource": "2",
        "NoTaxe": null,
        "NomTaxe": "TAX",
        "Fiche_DerniereModification": null
    },
    {
        "NoUniqueSystemeSource": "3",
        "NoTaxe": null,
        "NomTaxe": "NON",
        "Fiche_DerniereModification": null
    }
]

Modèle de Données

Acomba – InfoTaxe

Le modèle retourné par Acomba est InfoTaxe, qui contient le détail complet de chaque taxe incluant les taux et les comptes GL.

Champ	Type	Description
NoUniqueSystemeSource	string	Identifiant unique du système source ERP (CardPos dans Acomba)
Fiche_DerniereModification	datetime?	Date de dernière modification de la fiche
Taxe_Numero	string	Numéro de la taxe (ex: T.P.S. 100%, T.V.Q. 100%)
Taxe_Description	string	Description de la taxe
MontantTaxe	decimal	Montant de la taxe
Taxe_NumeroLegalGouv	string	Numéro d’enregistrement légal gouvernemental
NoCompteGL_PayedTax	string	Numéro de compte GL pour les taxes payées
NoCompteGL_PerceivedTax	string	Numéro de compte GL pour les taxes perçues
ListeTaux	List<TaxRate>	Liste des différents taux de la taxe (0 à 9 dans Acomba)

Détail d’un taux (TaxRate)

Champ	Type	Description
TaxRateId	int	Identifiant du taux (index 0 à 9 dans Acomba)
EffectiveTaxRate	decimal	Taux effectif de la taxe (ex: 5.0 pour 5%)

QuickBooks Online – FicheTaxe

Le modèle retourné par QuickBooks Online est FicheTaxe, un modèle simplifié.

Champ	Type	Description
NoUniqueSystemeSource	string	Identifiant unique QuickBooks
NoTaxe	string	Numéro de la taxe
NomTaxe	string	Nom de la taxe
Fiche_DerniereModification	datetime?	Date de dernière modification de la fiche

💡 Différences entre ERP

Acomba retourne le modèle InfoTaxe avec les comptes GL et les taux détaillés, tandis que QuickBooks Online retourne le modèle FicheTaxe qui correspond aux TaxCode de QuickBooks.