
![]() | TABLE DES MATIÈRES Provider/getProvider/getlist Provider/create Provider/edit Description des codes d’erreurs de fournisseur |
Fournisseurs de services
Les « fournisseurs de services » sont les dispensateurs de formations de votre environnement. Un dispensateur dans l'API est nommé « provider ». | ![]() |
Provider/get
![]() | Retourne l’ensemble des informations relatives à un fournisseur de services de votre environnement. |
Requête
Exemple de contenu d'appel de requête des informations pour un fournisseur de services :
{
"id":"tOUS7VjIr5yFDEemJYsldA%3d%3d"
}Description des champs
| Nom | Obligatoire | Commentaire/description |
| id | X | Identifiant unique du fournisseur de services. (Type string) |
Réponse
Exemple d'un contenu d'appel de réponse des informations pour un fournisseur de services :
{
"id": "tOUS7VjIr5yFDEemJYsldA%3d%3d",
"branchId": "5vZqv7xWJ1HQb84%2fhKf0Tg%3d%3d",
"name": {
"texts": [
{
"text": "SVIeSolutions",
"languageId": 1
},
{
"text": "SVIeSolutions",
"languageId": 2
},
{
"text": "SVIeSolutions",
"languageId": 3
}
],
"ErrorID": 0
},
"shortName": {
"texts": [
{
"text": "SVI",
"languageId": 1
},
{
"text": "SVI",
"languageId": 2
},
{
"text": "SVI",
"languageId": 3
}
],
"ErrorID": 0
},
"allowUnsubscribe": true,
"refundPolicies": [
{
"refundPolicyId": "BD3xDerLkQkM1lZrxBxOUw%3d%3d",
"providerId": "tOUS7VjIr5yFDEemJYsldA%3d%3d",
"refundPercent": 75.0,
"daysBeforeEventLimit": 15
}
],
"allowLimitSubscribe": true,
"nbDaysLimitSubscribe": 1,
"allowSubscribeRebate": true,
"percentSubscribeRebate": 15.0,
"nbDaysSubscribeRebate": 20,
"currencyId": 1,
"countryId": 37,
"stateId": 11,
"providerEmail": "Via",
"providerSenderName": "SVIeSolutions",
"providerEmailDomain": "@SVIeSolutions.com",
"cancellationText": {
"texts": [
{
"text": "<p><strong>Politique d'inscription :</strong></p><ul><li>Les inscriptions ne peuvent être effectuées qu'en ligne sur notre portail de formation.</li><li>Les places sont attribuées dans l'ordre d'inscription.</li><li>Une confirmation d'inscription vous sera envoyée par courrier électronique une fois que nous aurons reçu votre paiement intégral.</li></ul><p><strong>",
"languageId": 1
}
],
"ErrorID": 0
},
"creationDate": "2023-01-11T09:29:41.457",
"createdByUserID": "npx3BF6FKYVE4SX0Ltve2Q%3d%3d"
}Description des champs
Nom | Commentaires/description |
| Id | Identifiant unique du fournisseur de services. |
branchId | Identifiant unique de la branche du fournisseur de services. |
name | Nom du fournisseur de services affiché aux administrateurs.
|
shortName | Nom court du fournisseur de services affiché aux administrateurs.
|
allowUnsubscribe | Permettre ou non l'annulation des inscriptions aux formations pour les utilisateurs en autoinscription. |
allowLimitSubscribe | Limiter la capacité d'inscription jusqu'à un nombre de jours avant le début de la session. |
nbDaysLimitSubscribe | Nombre de jours avant le début de la session pour recevoir les inscriptions. |
allowSubscribeRebate | Activer un rabais pour les inscriptions hâtives. |
percentSubscribeRebate | Pourcentage de rabais octroyé pour les inscriptions hâtives. |
nbDaysSubscribeRebate | Nombre de jours avant le début de la session pour attribuer un rabais hâtif. |
currencyId | Identifiant de la devise associée au fournisseur de services.
|
countryId | Pays associé au fournisseur de services. (Voir Annexe 3 : Pays et États/Provinces) |
stateId | État ou province associée au fournisseur de services. (Voir Annexe 3 : Pays et États/Provinces) |
cancellationText | Politique d'inscription et d'annulation du fournisseur de services.
|
providerEmail | La première partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : via dans le courriel via@sviesolutions.com |
providerSenderName | Le nom qui sera affiché lors de la réception du courriel. Ex : Support de via |
providerEmailDomain | La deuxième partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : @sviesolutions.com dans le courriel via@sviesolutions.com
Ce champ n’est pas modifiable. Il sera seulement disponible dans la requête get. |
| refundPolicies | Politiques de remboursement associées au fournisseur de services.
|
| creationDate | Date de création du fournisseur de services. |
| createdByUserID | Identifiant unique de l’utilisateur ayant créé le fournisseur de services. |
Provider : provider/getlist
https://www.domaine.com/lmsapi/provider/getlist
![]() | Retourne la liste de l’ensemble des fournisseurs de services de votre environnement. |
Requête
Exemple de contenu d'appel de requête de la liste des fournisseurs de services :
{
"filterDate": “YYYY-MM-DDTHH:MM:SSZ”
}Le paramètre de filtre par date est optionnel et correspond à la date de création de l’élément. La méthode retourne la liste des objets qui ont été créés après la date passée comme filtre.
(Date de création minimale) -String (YYYY-MM-DDTHH:MM:SSZ)
Description des champs
| Nom | Obligatoire | Commentaires/description |
| filterDate | Paramètre optionnel correspondant à la date de création de l’élément. La méthode retourne la liste des objets qui ont été créés après la date passée comme filtre. Type : String (YYYY-MM-DDTHH:MM:SSZ) |
Réponse
Exemple de contenu d'appel de réponse de la liste des fournisseurs de services :
[
{
"id": "tOUS7VjIr5yFDEemJYsldA%3d%3d",
"branchId": "5vZqv7xWJ1HQb84%2fhKf0Tg%3d%3d",
"name": {
"texts": [
{
"text": "SVIeSolutions",
"languageId": 1
}
],
"ErrorID": 0
},
"shortName": {
"texts": [
{
"text": "SVI",
"languageId": 1
}
],
"ErrorID": 0
},
"allowUnsubscribe": true,
"allowLimitSubscribe": true,
"nbDaysLimitSubscribe": 1,
"allowSubscribeRebate": true,
"percentSubscribeRebate": 15.0,
"nbDaysSubscribeRebate": 20,
"currencyId": 1,
"countryId": 37,
"stateId": 11,
"creationDate": "2023-01-11T09:29:41.457",
"createdByUserID": "npx3BF6FKYVE4SX0Ltve2Q%3d%3d"
}
]Description des champs
Chaque élément de la liste contient les mêmes champs que ceux retournés par provider/get :
Nom | Commentaires/description |
| Id | Identifiant unique du fournisseur de services. |
branchId | Identifiant unique de la branche du fournisseur de services. |
name | Nom du fournisseur de services affiché aux administrateurs.
|
shortName | Nom court du fournisseur de services affiché aux administrateurs.
|
allowUnsubscribe | Permettre ou non l'annulation des inscriptions aux formations pour les utilisateurs en autoinscription. |
allowLimitSubscribe | Limiter la capacité d'inscription jusqu'à un nombre de jours avant le début de la session. |
nbDaysLimitSubscribe | Nombre de jours avant le début de la session pour recevoir les inscriptions. |
allowSubscribeRebate | Activer un rabais pour les inscriptions hâtives. |
percentSubscribeRebate | Pourcentage de rabais octroyé pour les inscriptions hâtives. |
nbDaysSubscribeRebate | Nombre de jours avant le début de la session pour attribuer un rabais hâtif. |
currencyId | Identifiant de la devise associée au fournisseur de services.
|
countryId | Pays associé au fournisseur de services. (Voir Annexe 3 : Pays et États/Provinces) |
stateId | État ou province associée au fournisseur de services. (Voir Annexe 3 : Pays et États/Provinces) |
cancellationText | Politique d'inscription et d'annulation du fournisseur de services.
|
providerEmail | La première partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : via dans le courriel via@sviesolutions.com |
providerSenderName | Le nom qui sera affiché lors de la réception du courriel. Ex : Support de via |
providerEmailDomain | La deuxième partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : @sviesolutions.com dans le courriel via@sviesolutions.com
Ce champ n’est pas modifiable. Il sera seulement disponible dans la requête get. |
| refundPolicies | Politiques de remboursement associées au fournisseur de services.
|
| creationDate | Date de création du fournisseur de services. |
| createdByUserID | Identifiant unique de l’utilisateur ayant créé le fournisseur de services. |
Provider : provider/create
https://www.domaine.com/lmsapi/provider/create
![]() | Permet de créer un fournisseur de services dans votre environnement. |
Requête
Exemple de contenu d'appel de requête de création d'un fournisseur de services :
{
"branchId": "5vZqv7xWJ1HQb84%2fhKf0Tg%3d%3d",
"allowUnsubscribe": false,
"allowLimitSubscribe": false,
"nbDaysLimitSubscribe": 0,
"allowSubscribeRebate": false,
"percentSubscribeRebate": 0.0,
"nbDaysSubscribeRebate": 0,
"currencyId": 2,
"countryId": 37,
"stateId": 11,
"name": {
"texts": [{
"text": "Fournisseur 1",
"languageId": 1
}
]
},
"shortName": {
"texts": [{
"text": "Fournisseur 1",
"languageId": 1
}
]
},
"cancellationText": {
"texts": []
}
}Description des champs
| Nom | Obligatoire | Commentaires/description |
| branchId | X | Identifiant unique de la branche à laquelle le fournisseur de services est rattaché. (Type string) |
| name | X | Nom du fournisseur de services affiché aux administrateurs, sous forme de textes multilingues (texts). (Type string entre 3 et 150 caractères) |
| shortName | X | Nom court du fournisseur de services, sous forme de textes multilingues (texts). (Type string entre 3 et 50 caractères) |
| allowUnsubscribe | Permettre ou non l'annulation des inscriptions aux formations pour les utilisateurs en auto-inscription. (Type Boolean, false par défaut) | |
| allowLimitSubscribe | Limiter les inscriptions jusqu'à un nombre de jours avant le début de la session. (Type Boolean) | |
| nbDaysLimitSubscribe | Nombre de jours avant le début de la session pour recevoir les inscriptions. (Type Short) | |
| allowSubscribeRebate | Allouer un rabais pour les inscriptions hâtives. (Type Boolean) | |
| percentSubscribeRebate | Pourcentage de rabais d'une inscription hâtive. (Type Number) | |
| nbDaysSubscribeRebate | Nombre de jours avant le début de la session pour attribuer un rabais. (Type Short) | |
| currencyId | Identifiant de la devise associée au fournisseur de services. 1 = CAD, 2 = USD, 3 = EUR (Type Number) | |
| countryId | Pays du fournisseur de services. (Type Number – Voir Annexe 3 : Pays et États/Provinces) | |
| stateId | État ou province du fournisseur de services. (Type Number – Voir Annexe 3 : Pays et États/Provinces) | |
| cancellationText | Politique d'inscription et d'annulation, sous forme de textes multilingues (texts). (Type string) |
Réponse
Exemple de contenu d'appel de réponse de création d'un fournisseur de services :
{
"id": "BzEm1iKI2qP86aUK38RlVg%3d%3d"
}La fonction vous retourne l’identifiant du fournisseur de services créé.
Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique du fournisseur de services créé. (Type string) |
Provider : provider/edit
https://www.domaine.com/lmsapi/provider/edit
![]() | Permet de modifier un fournisseur de services existant. |
Requête
Exemple de contenu d'appel de requête d'édition d'un fournisseur de services :
{
"id": "BzEm1iKI2qP86aUK38RlVg%3d%3d",
"branchId": "",
"allowUnsubscribe": false,
"allowLimitSubscribe": false,
"nbDaysLimitSubscribe": 0,
"allowSubscribeRebate": false,
"percentSubscribeRebate": 0.0,
"nbDaysSubscribeRebate": 0,
"currencyId": 2,
"countryId": 37,
"stateId": 11,
"name": {
"texts": [{
"text": "Fournisseur 1",
"languageId": 1
}
]
},
"shortName": {
"texts": [{
"text": "Fournisseur 1",
"languageId": 1
}
]
},
"cancellationText": {
"texts": []
},
"providerEmail": "via",
"providerSenderName": "Support de via"
}ATTENTION : En édition, seule la valeur Id est obligatoire.
Description des champs
Nom | Obligatoire | Commentaires/description |
| Id | X | Identifiant unique du fournisseur de services. |
branchId |
| Identifiant unique de la branche du fournisseur de services. |
name | Nom du fournisseur de services affiché aux administrateurs.
| |
shortName text languageId | Text : Nom du fournisseur de service raccourci tel que vu par les utilisateurs dans le système. (Type string doit être entre 5 et 50 caractères) languageId : Le nom peut être multilingue :
(Type Number) Obligatoire en mode création seulement | |
allowUnsubscribe |
| Permettre ou non l'annulation des inscriptions aux formations pour les utilisateurs en auto-inscription (Type: Boolean, false par défaut) |
percentPartialRefund |
| Pourcentage de remboursement applicable lors de l’annulation du participant pendant le délai prescrit (Type Number) |
allowLimitSubscribe |
| Limiter les inscriptions jusqu'à un nombre de jours avant le début de la session (Type Boolean)
|
nbDaysLimitSubscribe |
| Limite de jours avant le début de la session pour recevoir des inscriptions (Type Short) |
allowSubscribeRebate |
| Allouer un rabais pour les inscriptions hâtives (Type Boolean) |
percentSubscribeRebate |
| Pourcentage de rabais d'une inscription hâtive (Type Number) |
nbDaysSubscribeRebate |
| Nombre de jours avant le début de la session pour attribuer un rabais (Type Short) |
currencyId |
| Identifiant de la devise associée (Type Number)
|
countryId | Pays du fournisseur de service - Type Number (Voir Annexe 3 : Pays et États/Provinces)
| |
stateId | État ou province du fournisseur de service - Type Number (Voir Annexe 3 : Pays et États/Provinces)
| |
cancellationText text languageId |
| Textes multilingues de la politique d’inscription et d’annulation
"texts": [{ "text": "Mon annulation", -Type: String "languageId": 1 -Type: Number
|
providerEmail |
| La première partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : via dans le courriel via@sviesolutions.com |
providerSenderName |
| Le nom qui sera affiché lors de la réception du courriel. Ex : Support de via |
providerEmailDomain |
| La deuxième partie du courriel du fournisseur qui sera utilisée pour envoyer les notifications. Exemple : @sviesolutions.com dans le courriel via@sviesolutions.com
Ce champ n’est pas modifiable. Il sera seulement disponible dans la requête get. |
Réponse
Exemple de contenu d'appel de réponse d'édition d'un fournisseur de services :
{
"id": "BzEm1iKI2qP86aUK38RlVg%3d%3d"
}Description des champs
| Nom | Commentaires/description |
| id | Identifiant unique du fournisseur de services modifié. (Type string) |
Description des codes d’erreurs de fournisseur
Numéro | Message | Commentaires/description |
300 | Required id | Vous devez fournir un identifiant pour le fournisseur. |
301 | Invalid id | L’identifiant fourni pour le fournisseur est invalide. |
302 | Required branchId | Vous devez fournir un identifiant pour la branche. |
303 | Invalid branchId | L’identifiant fourni pour la branche est invalide. |
304 | Invalid allowLimitSubscribe | Vous devez fournir "True" ou "False". |
305 | Invalid allowSubscribeRebate | Vous devez fournir "True" ou "False". |
306 | Invalid allowUnsubscribe | Vous devez fournir "True" ou "False". |
307 | Required name | Vous devez fournir un nom pour le fournisseur. |
308 | Invalid nameLength | Le nom du fournisseur doit contenir de 3 à 150 caractères inclusivement. |
309 | Required shortName | Vous devez fournir une abréviation pour le fournisseur. |
310 | Invalid shortNameLength | L’abréviation du fournisseur doit contenir de 3 à 50 caractères inclusivement. |
311 | Invalid providerEmailLength | La première partie du courriel est requise et doit contenir de 1 à 250 caractères inclusivement. |
312 | Invalid providerSenderNameLength | Le nom d’expéditeur doit contenir un maximum de 50 caractères. |


