Documentation API – ProductGroup

ProductGroup API

Gérez les groupes/catégories de produits à travers différents systèmes ERP avec une API REST unifiée.
Lisez et organisez les classifications de produits pour Acomba, QuickBooks Online et autres systèmes ERP.

GET/Entity/ProductGroup

Aperçu

L’entité ProductGroup (aussi appelée ProductCategory dans certains systèmes) représente un groupe ou une catégorie de produits dans votre système ERP.
Cette API permet principalement d’effectuer des opérations de lecture (Read) sur les groupes de produits
de manière standardisée, facilitant l’organisation et la classification de votre catalogue.

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

GET /Entity/ProductGroup – Récupérer une liste de groupes de produits
GET /Entity/ProductGroup/{id} – Récupérer un groupe spécifique

💡 Note importante

Les champs disponibles varient selon le système ERP. Dans QuickBooks Online, les ProductGroup correspondent aux Items de type Category.

Matrice de Support

Opérations CRUD supportées pour l’entité ProductGroup 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

⚠️ Limitation

L’entité ProductGroup n’est pas supportée pour Avantage, Sage 50, Servex et Servicentre.

GET ProductGroup

Récupère une liste de groupes/catégories de produits avec support de filtrage, pagination et sélection de champs.

GET/Entity/ProductGroup

Paramètres de requêtes

Paramètre	Type	Requis	Description
$filter	string	Optionel	Expression de filtrage de style OData (ex: `EstActif eq true`)
$select	string	Optionel	Champs à retourner (séparés par des virgules)
$expand	string	Optionel	Champs à épandre (ex: `ExtendedProperties`)
$orderby	string	Optionel	Permet de trier les résultats (ex: `CodeGroupe asc`)
$top	integer	Optionel	Nombre maximum de résultats
$skip	integer	Optionel	Nombre de résultats à ignorer (pagination)

💡 Note pour composer une requête

Pour plus de détails, veuillez consulter cet article : Composer une requête à l’API d’ERP Connector

Get ProductGroups

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

Response (200 OK)

[
    {
        "NoUniqueSystemeSource": "2",
        "FicheNomComplet": "10 - Ordinateur",
        "CodeGroupe": "10",
        "DescGroupe": "Ordinateur",
        "NoCompteGL_Vente": "45100",
        "NoCompteGL_Achat": "55100",
        "ExceptionDeTaxesActives": false,
        "ExceptionDeTaxes": null,
        "EstActif": true,
        "Fiche_DerniereModification": "2025-08-07T11:52:53",
        "DefaultTaxCategoryId": null,
        "DefaultTaxCategoryCode": null,
        "ParentCategoryId": null,
        "ParentCategoryCode": null
    }
]

Propriétés détaillées de ProductGroup

Identification

Propriété	Type	Description
CodeGroupe	string	Code du groupe de produits (clé métier)
NoUniqueSystemeSource	string	Identifiant unique du système source ERP
FicheNomComplet	string (readonly)	Nom complet formaté (CodeGroupe – DescGroupe)
EstActif	bool	Indique si le groupe de produits est actif

Description

Propriété	Type	Description
DescGroupe	string	Description du groupe de produits

Comptes GL (Grand Livre)

Propriété	Type	Description
NoCompteGL_Vente	string	Numéro de compte du Grand Livre pour les ventes
NoCompteGL_Achat	string	Numéro de compte du Grand Livre pour les achats

Taxes

Propriété	Type	Description
ExceptionDeTaxesActives	bool	Indique si une exception de taxe est active pour ce groupe
ExceptionDeTaxes	ExceptionTaxesEntete	Détails de l’exception de taxe utilisée sur ce groupe
DefaultTaxCategoryId	string	Identifiant de la catégorie de taxe par défaut
DefaultTaxCategoryCode	string	Code de la catégorie de taxe par défaut

Hiérarchie

💡 Hiérarchie de catégories

Certains systèmes ERP supportent une hiérarchie de catégories (sous-catégories). Ces propriétés permettent de définir la relation parent-enfant.

Propriété	Type	Description
ParentCategoryId	string	Identifiant de la catégorie parente (hiérarchie)
ParentCategoryCode	string	Code de la catégorie parente (hiérarchie)

Autres propriétés

Propriété	Type	Description
Fiche_DerniereModification	DateTime?	Date et heure de la dernière modification de la fiche