Introduction
Dendreo est un logiciel de gestion performant pour centres de formation exigeants !
Vous pouvez créer un compte d'essai de 14 jours sur notre site internet.
Fonctionnement général
Authentification
Nous proposons une authentification par token. Le token peut être communiqué de deux manières différentes :
- un paramètre POST ou GET sur la clef
key
(ex:?key=123456
) - dans header "Authorization" (ex:
Token token="123456"
)
Vous pouvez retrouver vos clés d'API ici.
L'absence de ce token ou l'utilisation d'un token invalide, entrainera une erreur 401
(Unauthorized).
Permissions
La gestion de clés d'API multiple vous permet de leur attribuer des droits spécifiques de lecture (GET) et d'écriture (POST, PUT et DELETE) indépendamment sur chaque point d'entrée.
L'absence de permissions sur un point d'entrée entrainera une erreur 401 (Unauthorized).
Formats
Requêtes
Deux stratégies sont proposées pour les requêtes liées à la création ou la mise à jour d'un élément :
- l'usage de
form-data
- l'usage d'un payload JSON (nécessite de préciser en header
Content-Type: application/json
)
Réponses
Seul le format JSON est proposé actuellement.
Erreurs
{
"status": "failure",
"errors": [
"Une raison sociale est obligatoire (raison_sociale est vide)"
]
}
Quand des attributs sont validés par l'API (présence, format, existence), si aucune erreur n'est détectée, un statut 200
(Success) ou 201
(Created) sera retourné par l'API.
Dans le cas contraire, un statut 422
(Unprocessable Entity) sera retourné accompagné des messages d'erreurs associés aux validations qui ont échouée.
Throttling
L'API de Dendreo impose les limites suivantes :
- Burst : 100 requêtes max par période de 10 secondes
- Mensuelle : dépend de votre niveau d'abonnement
- Quotidienne : 100 000 requêtes max par jour, quel que soit votre limite mensuelle
En cas de dépassement, vous recevrez une erreur 429 - HTTP_TOO_MANY_REQUESTS.
Cache
Sur certains endpoint, le retour peut contenir des urls pointant vers des ressources du type https://public.dendreo.com/xxxx/media/
Les ressources servies par les URL de ce type sont mises en cache pendant 1h.
Si vous effectuez un nouvel appel à l'API, l'url retournée sera différente, donc une nouvelle version du fichier sera servie.
Requêtes
[
{
"id_entreprise": "3",
"raison_sociale": "EDF"
},
{
"id_entreprise": "4",
"raison_sociale": "Peugeot"
}
]
Dans le cas des requêtes GET
il est possible de requêter plus d'un objet, en mettant plusieurs id
à la suite, séparés par des virgules
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id=12,14,16
Pour les objets de type : Entreprise, Contact, Participant, Formateur et Action De Formation il est possible d'utiliser id_externe
à la place de id
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?id_externe=externe_12,externe_14,externe_16
Notez qu'il est possible d'utiliser id
ou id_objet
, par exemple id
ou id_contact
pour afficher un contact particulier :
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id=12
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id_contact=12
Dans le cas des requêtes SHOW
et INDEX
il est possible de restreindre les colonnes à afficher en renseignant le paramètre fields
.
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?fields=id_entreprise,raison_sociale
Il est aussi possible d'inclure dans la réponse des éléments liés en les indiquant dans le paramètre "include".
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?include=entreprise
Enfin, certains attributs sont cachés par défaut mais vous pouvez les afficher avec le paramètre show
. Ces champs champs sont notamment date_add
, date_edit
et date_delete
.
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id=12&show=date_edit,date_delete
Édition
La plupart du temps il est possible, d'éditer les objets en envoyant simplement une requête POST
(ou PUT
) et en précisant un identifiant déjà existant via le paramètre id
ou id_objet
(ex. id_participant
).
L'endpoint Particulier est un cas spécifique : la création se fait via l'endpoint Contacts et l'édition via l'endpoint Particuliers.
Suppression
Il est également souvent possible de supprimer les objets en envoyant une requête DELETE
sur un objet identifié par son ID.
Recherche/filtre
Dans le cas des requêtes INDEX
il est possible de filtrer les résultats en indiquant une clef de recherche dans le paramètre search
.
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?search=EDF
Les champs sur lesquels cette recherche est effectuée sont précisés pour chaque objet.
Certains objets proposent de filtrer les résultats de recherche par date d'ajout et d'édition:
nb_jours
, created_after
, created_before
, updated_after
, updated_before
le format de date est : YYYY-MM-DD
(= 'YYYY-MM-DD 00:00:00' ou YYYY-MM-DD hh:mm:ss
)
Et retournera les objets dont la date_add
ou date_edit
est "inférieur ou égale" ou "supérieur ou égale" à la date donnée.
Ces parametres peuvent être cumulés.
Les objets sur lesquels ce filtre est disponible sont : Contact
, Facture
, Financement
, Entreprise
, Formateur
, Participant
, Opportunité
, Module
, Lap
, Lmp
et les Fichiers
.
Pour les objets ActionDeFormation
, Lam
et Creneaux
vous pouvez filtrer sur la date de début ou de fin:
started_after
, started_before
, ended_after
, ended_before
le format de date est : YYYY-MM-DD
(= YYYY-MM-DD 00:00:00
ou YYYY-MM-DD hh:mm:ss
)
Et retournera les objets dont la date_debut
ou date_fin
est "inférieur ou égale" ou "supérieur ou égale" à la date donnée.
Ces parametres peuvent être cumulés.
Catégories de Module
Lister toutes les Catégories de Module
Une Catégorie de Module correspond à un système de classification des Modules de formation qui constituent le Catalogue.
Requête HTTP
GET https://pro.dendreo.com/demo/api/categories_module.php
[
{
"id_categorie_module": "1",
"date_add": "2011-09-29 16:47:36",
"id_add": "1",
"date_edit": "2021-09-24 15:40:08",
"id_edit": "0",
"intitule": "Management",
"description": "",
"color": "",
"status": "1",
"order": "0",
"id_parent": "",
"deleted_at": ""
},
{
"id_categorie_module": "3",
"date_add": "2021-02-18 07:59:59",
"id_add": "0",
"date_edit": "2022-02-15 10:30:42",
"id_edit": "0",
"intitule": "Cuisine",
"description": "",
"color": "",
"status": "1",
"order": "1",
"id_parent": "",
"deleted_at": ""
},
]
Afficher une catégorie de Module
Requête HTTP
GET https://pro.dendreo.com/demo/api/categories_module.php?id=8
{
"id_categorie_module": "8",
"date_add": "2022-09-02 15:46:16",
"id_add": "0",
"date_edit": "2022-09-02 15:46:19",
"id_edit": "0",
"intitule": "Cuisine végétarienne",
"description": "",
"color": "",
"status": "1",
"order": "2",
"id_parent": "3",
"deleted_at": ""
}
Ajouter / Editer une catégorie de Module
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_categorie_module | non | ID de la Catégorie (si vide -> création d'une nouvelle Catégorie, sinon -> édition de la Catégorie existante) |
intitule | oui | Intitulé de la catégorie |
description | non | Description de la catégorie |
color | non | Si non vide remplace la couleur dans l'Agenda |
status | non | Booléen : 1 Catégorie active, 0 Catégorie désactivée |
order | non | Ordre d'affichage (entier) |
id_parent | non | ID de la Catégorie parent |
{
"id_categorie_module": "10",
"date_add": "2023-01-05T10:39:05.000000Z",
"id_add": "0",
"date_edit": "2023-01-05T10:39:05.000000Z",
"id_edit": "0",
"intitule": "Ma catégorie de module",
"description": "Description de ma catégorie de module",
"color": "7866FF",
"status": "0",
"order": "1",
"id_parent": "3",
"deleted_at": ""
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/categories_module.php
Types de produit
Lister tous les types de produit
Lorsque le mode "Multi-Produits" est activé, Dendreo est capable de gérer différents Produits autres que de la formation. Vous pouvez ajouter différents types de Produits à votre Catalogue, puis utiliser ces Produits au sein de vos Actions de Formation. Vous pouvez même réaliser des Actions Hors Formation, c'est à dire des Actions ne comportant aucun Module de formation.
Requête HTTP
GET https://pro.dendreo.com/demo/api/categories_produit.php
[
{
"id_categorie_produit": "1",
"date_add": "2021-07-18 17:20:45",
"id_add": "0",
"date_edit": "",
"id_edit": "0",
"intitule": "Formation",
"color": "1b86d8",
"status": "1"
},
{
"id_categorie_produit": "2",
"date_add": "2021-09-16 10:33:18",
"id_add": "0",
"date_edit": "",
"id_edit": "0",
"intitule": "Licences",
"color": "",
"status": "1"
}
]
Afficher un type de produit
Requête HTTP
GET https://pro.dendreo.com/demo/api/categories_produit.php?id=2
{
"id_categorie_produit": "2",
"date_add": "2021-09-16 10:33:18",
"id_add": "0",
"date_edit": "",
"id_edit": "0",
"intitule": "Licences",
"color": "",
"status": "1"
}
Modules/Produits
Par défaut, Dendreo permet de programmer de la formation. Il existe cependant une option appelée "Multi-Produits" qui permet d'associer d'autres produits (modules) à une action de formation.
La catégorie de Produit par défaut (id_categorie_produit
= 1) correspond à de la formation. Un module avec un id_categorie_produit
différent de 1 est donc considéré comme un produit autre que de la formation.
Lister tous les Modules de formation
[
{
"id_module": "4",
"id_categorie_produit": "1",
"intitule": "[Demo] Les Bases Du Management",
"include_in_bpf": "1",
"numero": "4",
"numero_complet": "MOD_2014004",
"numero_comptable": "",
"description": "Les bases du management",
"prix": "1000.00",
"prix_intra": "0.0000",
"prix_edof": "0.0000",
"prix_inter_category_1": "0.0000",
"prix_intra_category_1": "0.0000",
"prix_achat": "0.0000",
"duree_heures": "4.00",
"duree_jours": "1.00",
"id_formacode": "0",
"id_specialite": "2",
"id_formateur": "0",
"id_categorie_module": "1",
"nb_participants_min": "0",
"nb_participants": "0",
"objectif": "",
"public_vise": "",
"pre_requis": "",
"intitules": "",
"id_salle_de_formation": "0",
"moyens_pedago": "",
"id_centre_de_formation": "1,2",
"formateurs_aptes": [
{
"id_formateur": "5",
"date_add": "2012-05-10 10:53:30",
"id_add": "1",
"date_edit": "2021-09-13 09:20:03",
"id_edit": "0",
"user_id": "9300",
"anonyme": "0",
"numero": "1",
"numero_complet": "FORM_2012001",
"numero_perso": "0",
"n_secu": "000",
"civilite": "Mme",
"nom": "Skapa",
"nom_jeune_fille": "",
"prenom": "Petra",
"color": "",
"date_de_naissance": "",
"lieu_de_naissance": "",
"nationalite": "Française",
"situation_familiale": "marie",
"adresse": "",
"code_postal": "",
"ville": "",
"profession": "",
"invisible_catalogue": "0",
"biographie_catalogue": "",
"telephone_perso": "",
"telephone_pro": "",
"email_perso": "",
"email_pro": "",
"statut": "Travailleur indépendant\/gérant non salarié",
"statut_bpf": "Personne de votre organisme (CDI, CDD, occasionnel, bénévole)",
"mode_remu": "Horaire",
"remu_horaire_par_defaut": "0.0000",
"adeli_rpps": "",
"key_uniq": "cd66ec97913376e2f9f3e6b34a9b1f66",
"id_externe": "",
"global_visible": "1",
"id_entreprise": "",
"message_extranet": "",
"infos_adf": "",
"num_da": "",
"siret": "",
"diplomes": "",
"nom_commercial": "",
"responsable_dequipe_id": "",
"tva": "",
"centre_id": "0",
"pivot": {
"id_module": "69",
"id_formateur": "5"
}
}
],
"competences_requises": [
{
"id": "15",
"label": "Management",
"badge_type": "competences",
"evaluable": "",
"created_at": "2018-03-01 10:25:26",
"updated_at": "2021-11-05 19:29:30",
"deleted_at": "",
"pivot": {
"badgeable_id": "4",
"badge_id": "15",
"badgeable_type": "Models\\Module"
}
}
]
}
]
Accède à tous les modules de formation présents sur Dendreo.
Il est possible de filtrer les Modules via les paramètres suivants :
numero_complet
: Le numéro complet du Module
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?numero_complet=MOD_2019001
intitule
: L'intitulé du Module (ou intitulé court)
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?intitule=Excel
id_categorie_module
: ID de categorie du Moduleid_formateur
: ID du Formateur par défaut
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?id_categorie_module=12
catalogue
: 0/1 si le module est présent ou non dans le catalogue publiceligible_cpf
: 0/1 si le module est éligible au CPF
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?catalogue=1
keywords
: des mots-clés à rechercher parmi les intitulés, descriptions et différents champs du module, telle que pour la recherche sur le catalogue public.
Il est aussi possible d'inclure les informations formateurs_aptes
, competences_requises
ou certification_complete_code
sur les modules via l'attribut include
.
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=formateurs_aptes
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=competences_requises
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=certification_complete_code
certification_complete_code
permet d'obtenir les informations liées à la Certification (Code RS / RNCP / CPF / CertifInfo)
Requête HTTP
GET https://pro.dendreo.com/demo/api/modules.php
Afficher un module de formation
{
"id_module": "4",
"id_externe": "",
"catalogue": "1",
"id_categorie_produit": "1",
"intitule": "[Demo] Les Bases Du Management",
"intitule_court": "BM",
"slug": "les-bases-du-management",
"color": "",
"include_in_bpf": "1",
"numero": "4",
"numero_complet": "MOD_2014004",
"numero_comptable": "",
"description": "Les bases du management",
"description_meta": "",
"hors_formation_dates": "0",
"hors_formation_prix_par_jour": "0",
"prix": "1000.0000",
"prix_intra": "2000.0000",
"prix_edof": "0.0000",
"prix_inter_category_1": "0.0000",
"prix_intra_category_1": "0.0000",
"prix_achat": "0.0000",
"duree_heures": "4.00",
"duree_jours": "1.00",
"id_formacode": "0",
"id_specialite": "2",
"id_formateur": "0",
"id_entreprise_formateur": "0",
"id_categorie_module": "1",
"nb_participants_min": "0",
"nb_participants": "0",
"objectif": "",
"public_vise": "",
"pre_requis": "",
"profil_formateurs": "",
"id_salle_de_formation": "0",
"modalites_devaluation": "",
"moyens_supports_pedagogiques": "",
"modalites_pedagogiques": "",
"id_centre_de_formation": "1,2",
"duree_de_validite": "0",
"id_responsable": "0",
"eligible_cpf": "0",
"code_certifinfo": "",
"mode_organisation": "presentiel",
"duree_planning_type": "907200",
"duree_plage_jours": "38",
"commentaires_devis": "",
"type_parcours_id": "1",
"objectif_general_id": "0",
"niveau_entree_id": "0",
"codes_modalites_admission": [
"99999"
],
"points_forts": "",
"eligible_dpc": "0",
"mention_a_partir_de": "0",
"nouveaute": "0",
"cache_note_moyenne": "0",
"moyenne_satisfaction": "100",
"satisfaction_nb_avis": "1",
"satisfaction_nb_total": "1",
"document_presentation_url": "",
"visuel_url": "",
"actions_de_formation_programmees": [
{
"id_action_de_formation": "132",
"intitule": "[Demo] Les Bases Du Management",
"date_debut": "2016-09-02 09:00:00",
"date_fin": "2016-09-02 17:00:00"
}
],
"competences_list": [
"word",
"excel"
],
"public_url_catalogue": "https://catalogue-demo.dendreo.test/formation/4/formation-les-bases-du-management",
"formateurs_aptes": [
{
"id_formateur": "5",
"date_add": "2012-05-10 10:53:30",
"id_add": "1",
"date_edit": "2021-09-13 09:20:03",
"id_edit": "0",
"user_id": "9300",
"anonyme": "0",
"numero": "1",
"numero_complet": "FORM_2012001",
"numero_perso": "0",
"n_secu": "000",
"civilite": "Mme",
"nom": "Skapa",
"nom_jeune_fille": "",
"prenom": "Petra",
"color": "",
"date_de_naissance": "",
"lieu_de_naissance": "",
"nationalite": "Française",
"situation_familiale": "marie",
"adresse": "",
"code_postal": "",
"ville": "",
"profession": "",
"invisible_catalogue": "0",
"biographie_catalogue": "",
"telephone_perso": "",
"telephone_pro": "",
"email_perso": "",
"email_pro": "",
"statut": "Travailleur indépendant\/gérant non salarié",
"statut_bpf": "Personne de votre organisme (CDI, CDD, occasionnel, bénévole)",
"mode_remu": "Horaire",
"remu_horaire_par_defaut": "0.0000",
"adeli_rpps": "",
"key_uniq": "cd66ec97913376e2f9f3e6b34a9b1f66",
"id_externe": "",
"global_visible": "1",
"id_entreprise": "",
"message_extranet": "",
"infos_adf": "",
"num_da": "",
"siret": "",
"diplomes": "",
"nom_commercial": "",
"responsable_dequipe_id": "",
"tva": "",
"centre_id": "0",
"pivot": {
"id_module": "69",
"id_formateur": "5"
}
}
],
"competences_requises": [
{
"id": "15",
"label": "Management",
"badge_type": "competences",
"evaluable": "",
"created_at": "2018-03-01 10:25:26",
"updated_at": "2021-11-05 19:29:30",
"deleted_at": "",
"pivot": {
"badgeable_id": "4",
"badge_id": "15",
"badgeable_type": "Models\\Module"
}
}
]
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/modules.php?id=4
GET https://pro.dendreo.com/demo/api/modules.php?id_module=4
Il est possible de récupérer l'url du visuel
associé au module dans la réponse, en rajoutant include=visuel
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?id=4&include=visuel
Il est aussi possible d'inclure les informations formateurs_aptes
, competences_requises
ou certification_complete_code
sur les modules via l'attribut include
.
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=formateurs_aptes
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=competences_requises
Exemple : GET https://pro.dendreo.com/demo/api/modules.php?include=certification_complete_code
certification_complete_code
permet d'obtenir les informations liées à la Certification (Code RS / RNCP / CPF / CertifInfo)
Notez que les actions_de_formation_programmees
retournées pour un Module sont uniquement les Actions de Formation dans une étape de type "prévisionnelle" (cela exclue donc les formations en cours de réalisation ou terminées).
Ajouter / Editer un Module de formation
{
"id_module": "91",
"date_add": "2023-01-06 17:46:56",
"id_add": "0",
"date_edit": "2023-01-06 17:46:56",
"id_edit": "0",
"id_delete": "0",
"id_externe": "",
"lms_custom_url": "",
"catalogue": "1",
"intitule": "Mon nouveau Module",
"intitule_court": "",
"slug": "mon-nouveau-module",
"color": "",
"id_categorie_produit": "1",
"include_in_bpf": "1",
"numero": "91",
"numero_complet": "MOD_2023091",
"numero_perso": "0",
"numero_comptable": "",
"langue": "FR",
"description": "",
"description_meta": "",
"hors_formation_dates": "1",
"hors_formation_prix_par_jour": "1",
"prix": "0.0000",
"prix_intra": "0.0000",
"prix_edof": "",
"prix_inter_category_1": "0.0000",
"prix_intra_category_1": "0.0000",
"prix_achat": "0.0000",
"duree_heures": "18.000",
"duree_jours": "2",
"id_formacode": "0",
"id_specialite": "0",
"id_formateur": "0",
"id_entreprise_formateur": "",
"id_categorie_module": "",
"nb_participants_min": "0",
"nb_participants": "0",
"objectif": "",
"public_vise": "",
"pre_requis": "",
"profil_formateurs": "",
"id_salle_de_formation": "0",
"id_orientation_ogdpc": "0",
"color_adf_par_defaut": "",
"modalites_devaluation": "",
"moyens_supports_pedagogiques": "",
"infos_admission": "",
"accessibilite": "",
"modalites_pedagogiques": "",
"global_visible": "1",
"duree_de_validite": "",
"infos_adf": "",
"id_responsable": "",
"eligible_cpf": "0",
"code_cpf_id": "",
"mode_organisation": "presentiel",
"duree_planning_type": "64800",
"duree_plage_jours": "2",
"commentaires_devis": "",
"type_parcours_id": "1",
"objectif_general_id": "",
"niveau_entree_id": "0",
"codes_modalites_admission": "",
"points_forts": "",
"eligible_dpc": "0",
"mention_a_partir_de": "0",
"nouveaute": "0",
"formation_prioritaire": "0",
"cache_note_moyenne": "1",
"cache_taux_reussite": "1",
"moyenne_satisfaction_init": "",
"ponderation_satisfaction_init": "",
"date_satisfaction_init": "",
"taux_reussite_evaluation_init": "",
"ponderation_evaluation_init": "",
"date_evaluation_init": "",
"frais_certif_inclus": "1",
"frais_anpec": "",
"detail_frais_anpec": "",
"catalogue_order": "76",
"satisfaction_evaluable": "1",
"evaluation_evaluable": "1",
"c_bool": "",
"code_certifinfo": "",
"c_description": "",
"catalogue_limited_visibility": "0",
"stripe_catalogue_public_payment_strategy": "",
"stripe_catalogue_public_module_help_text": "",
"code_certification_id": "",
"is_master_module": "0",
"code_analytique": ""
}
Précisions concernant le planning d'un Module de formation
Les champs duree_jours
et duree_plage_jours
servent si vous faites de la planification progressive, c'est-à-dire lorsque vous connaissez la durée totale du Module, mais pas encore son planning.
Si vous connaissez déjà le planning type de votre Module, vous avez 5 solutions :
- ne renseigner aucun paramètre spécifique et votre Module prendra la durée d'une 'journée type' (définie en configuration)
- passer uniquement le paramètre
import_jours
= X et votre Module aura un planning contenant X jours d'une durée égale à la 'journée type' - passer les paramètres
import_jours
= X etimport_duree
= Y et votre Module aura un planning contenant X jours d'une durée de Y heures chacun (en mode durée) - passer les paramètres
import_jours
= X etimport_creneaux
avec la valeurdefault_config
et votre Module aura un planning contenant X jours, chaque jour contenant le ou les Créneaux par défaut (définis en configuration) - passer les paramètres
import_jours
= X etimport_creneaux
sous la forme08:30-11:00;14:30-16:50
et votre Module aura un planning contenant X jours, chaque jour contenant le ou les Créneaux correspondant aux horaires précisés
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id (ou id_module) | non | ID du Module de formation (si vide -> ajout d'un nouveau Module au Catalogue, sinon -> édition du Module existant) |
id_centre_de_formation | non | ID Centre de formation (existence vérifiée), plusieurs ID possible (séparés par des virgules ex : 1,2,3 ) |
intitule | oui | Intitulé du Module |
intitule_court | non | Intitulé court du Module |
include_in_bpf | non | Module inclus dans le BPF : 1 ou 0 |
catalogue | non | Module affiché sur le Catalogue : 1 ou 0 |
eligible_cpf | non | Éligibilité CPF : 1 ou 0 |
mode_organisation | non | Mode d'organisation (valeurs possibles : presentiel , elearning_sync , mixte , elearning_async , stage ) |
import_creneaux | non | Créneaux du Module de formation (si renseigné, prend le dessus sur import_duree ) ex : 09:00-12:00;14:30-18:00 ou default_config (prendra la configuration par défaut de vos Créneaux) |
import_duree | non | Durée en heures (si import_creneaux non renseigné) |
duree_heures | non | Durée en heures (si import_duree non renseigné) |
duree_plage_jours_elearning | non | Si mode_organisation = elearning_async uniquement. Si non renseigné, prend la valeur de la configuration de vos Modules du champ "Durée en jours par défaut" |
import_jours | non | Durée (en nombre de jours) du Module |
prix | non | Prix INTER |
prix_intra | non | Prix INTRA |
prix_inter_category_1 | non | Prix Adhérents INTER |
prix_intra_category_1 | non | Prix Adhérents INTRA |
prix_achat | non | Prix achat (hors-formation uniquement) |
id_formateur | non | ID du Formateur (existence et visibilité sur les centers de formation vérifiées) staffé par défault |
id_entreprise_formateur | non | ID de l'Entreprise sous-traitante (existence et visibilité sur les centers de formation vérifiées) staffée par défault |
formateurs | non | ID Formateurs aptes à réaliser ce Module de formation, plusieurs ID possible (séparés par des virgules ex : 1,2,3 ) |
orientations_dpc | non | Éligibilité DPC : 1 ou 0 |
competences_ids | non | ID des compétences (Objectifs à atteindre par les stagiaires), plusieurs ID possible (séparés par des virgules ex : 1,2,3 ) |
competences_list | non | Intitulé des compétences, plusieurs intitulés possible (séparés par des point-virgules ex: Compétences n°1;Compétences n°2 ) |
competences_requises | non | Intitulé des compétences requises par les formateurs, plusieurs intitulés possible (séparés par des point-virgules ex : Compétences requises n°1;Compétences requises n°2 ) |
id_specialite | non | ID Spécialité (si renseigné, prend le dessus sur specialite_code ) |
specialite_code | non | Code Spécialité (si id_specialite non renseigné) |
id_categorie_module | non | ID Catégorie (si renseigné, prend le dessus sur categorie_module_intitule ) |
categorie_module_intitule | non | Intitulé Catégorie (si id_categorie_module non renseigné) |
codes_modalites_admission | non | Modalités d'admission |
points_forts | non | Points forts (limite de 254 caractères) |
certification_code | non | Code de certification (Si eligible_cpf = 1) ex: RS5355 , CPF5355 , RNCP5355 , CERTIFINFO5355 |
formacode | non | Formacode |
nb_participants_min | non | Nombre minimum de Participants |
nb_participants | non | Nombre maximum de Participants |
public_vise | non | Public visé |
pre_requis | non | Prérequis |
infos_admission | non | Informations sur l'admission |
modalites_pedagogiques | non | Modalités pédagogiques |
moyens_supports_pedagogiques | non | Moyens et supports pédagogiques |
modalites_devaluation | non | Modalités d'évaluation et de suivi |
accessibilite | non | Informations sur l'accessibilité |
duree_plage_jours_elearning | non | Période d'ouverture |
num_programme_dpc | non | Numéro de programme DPC : valeur modifiable si l'option "Affichage des options DPC sur les ADFs et Participants" est activé |
nouveaute | non | Nouveauté ? : 1 ou 0 |
Requête HTTP
POST https://pro.dendreo.com/demo/api/modules.php
Supprimer un Module
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/modules.php?id=1
DELETE https://pro.dendreo.com/demo/api/modules.php?id_module=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_module | oui | ID Module (existence vérifiée) |
Sessions Permanentes
Lister toutes les Sessions Permanentes
Accède à toutes les Sessions Permanentes présentes sur Dendreo.
Exemple : GET https://pro.dendreo.com/demo/api/sessions_permanentes.php
[
{
"id": "39",
"salle_de_formation_id": "73",
"module_id": "320",
"responsable_id": "",
"mode_pricing": "forfaitaire",
"rythmes": [
"1"
],
"prix": "1800.0000",
"duree": "0",
"garantie": "0",
"active": "1",
"url_edof": "",
"created_at": "2022-10-18 16:44:51",
"updated_at": "2022-11-24 10:43:56",
"deleted_at": "",
"id_centre_de_formation": "0",
"pre_requis": "",
"visible_cp": "0"
},
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/sessions_permanentes.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_session_permanente | non | ID des sessions (séparé par des virgules) |
id_module ou module_id | non | ID du Module (séparé par des virgules) |
Afficher une Session Permanente
{
"id": "39",
"salle_de_formation_id": "73",
"module_id": "320",
"responsable_id": "",
"mode_pricing": "forfaitaire",
"rythmes": [
"1"
],
"prix": "1800.0000",
"duree": "0",
"garantie": "0",
"active": "1",
"url_edof": "",
"created_at": "2022-10-18 16:44:51",
"updated_at": "2022-11-24 10:43:56",
"deleted_at": "",
"id_centre_de_formation": "0",
"pre_requis": "",
"visible_cp": "0"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/sessions_permanentes.php?id=372
Ajouter une Session Permanente
{
"id": "44",
"salle_de_formation_id": "69",
"module_id": "314",
"responsable_id": "",
"mode_pricing": "forfaitaire",
"rythmes": "",
"prix": "1700.0000",
"duree": "0",
"garantie": "0",
"active": "1",
"url_edof": "",
"created_at": "2022-12-20 14:59:18",
"updated_at": "2022-12-20 14:59:18",
"deleted_at": "",
"id_centre_de_formation": "0",
"pre_requis": "",
"visible_cp": "0"
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/sessions_permanentes.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | ID Session Permanente |
salle_de_formation_id | oui | ID de la salle de formation (existence vérifiée) |
id_module | oui | ID du Module (existence vérifiée) |
id_centre_de_formation | non | ID du Centre de formation |
mode_pricing | non | Mode de pricing ('forfaitaire' (default) ou 'assiduite') |
prix | non | Prix |
duree | non | Durée en heures, |
rythmes | non | Rythmes de la formation () ('1' => 'En journée','2' => 'En soirée','3' => 'En semaine','4' => 'Le week-end','5' => 'Temps plein','6' => 'Temps partiel','7' => 'Plusieurs rythmes possibles') |
id_responsable | non | ID du Responsable Administrateur (existence vérifiée) |
active | non | Session ouverte (booléen) |
garantie | non | Session garantie (booléen) |
pre_requis | non | Pré requis (format HTML) |
url_edof | non | URL de l'Action (optionnel) |
Modifier une Session Permanente
{
"id": "44",
"salle_de_formation_id": "69",
"module_id": "314",
"responsable_id": "",
"mode_pricing": "forfaitaire",
"rythmes": "",
"prix": "1200.0000",
"duree": "0",
"garantie": "0",
"active": "1",
"url_edof": "",
"created_at": "2022-12-20 14:59:18",
"updated_at": "2022-12-20 15:02:45",
"deleted_at": "",
"id_centre_de_formation": "0",
"pre_requis": "",
"visible_cp": "0"
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/sessions_permanentes.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | non | ID Session Permanente |
salle_de_formation_id | non | ID de la salle de formation (existence vérifiée) |
id_centre_de_formation | non | ID du Centre de formation |
mode_pricing | non | Mode de pricing ('forfaitaire' (default) ou 'assiduite') |
prix | non | Prix |
duree | non | Durée en heures, |
rythmes | non | Rythmes de la formation () ('1' => 'En journée','2' => 'En soirée','3' => 'En semaine','4' => 'Le week-end','5' => 'Temps plein','6' => 'Temps partiel','7' => 'Plusieurs rythmes possibles') |
id_responsable | non | ID du Responsable Administrateur (existence vérifiée) |
active | non | Session ouverte (booleen) |
garantie | non | Session garantie (booleen) |
pre_requis | non | Pré requis (format HTML) |
url_edof | non | URL de l'Action (optionnel) |
Supprimer une Session Permanente
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/sessions_permanentes.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | ID Session Permanente (existence vérifiée) |
Formateurs
Lister tous les formateurs
[
{
"id_formateur": "5",
"numero": "1",
"numero_complet": "",
"n_secu": "",
"civilite": "M.",
"nom": "Dupond",
"nom_jeune_fille": "",
"prenom": "Jacques",
"date_de_naissance": "1963-09-01",
"lieu_de_naissance": "LYON",
"nationalite": "Française",
"situation_familiale": "-",
"adresse": "33 rue Bichat",
"code_postal": "75006",
"ville": "PARIS",
"pays_alpha2" : "fr",
"pays" : "France",
"profession": "Formateur Professionnel d'Adultes",
"telephone_perso": "0676655443",
"telephone_pro": "0676655443",
"email_perso": "",
"email_pro": "contact@cformateur.fr",
"statut": "travailleur_independant",
"remu_horaire_par_defaut": "0.00",
"diplomes": "",
"id_externe": "",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
]
Accède à tous les formateurs présents sur Dendreo.
Il est possible de filtrer les formateurs via les paramètres suivants (vous pouvez faire plusieurs recherches d'un coup en séparant les keywords par des virgules) :
numero_complet
: Le numéro complet du formateurnom
: Le nom du formateurprenom
: Le prenom du formateuremail_pro
: L'adresse email professionnelle du formateurtelephone_pro
: Le numéro de téléphone professionnel du formateur
Exemple : GET https://pro.dendreo.com/demo/api/formateurs.php?numero_complet=FORM_2019001
Requête HTTP
GET https://pro.dendreo.com/demo/api/formateurs.php
Afficher un formateur
{
"id_formateur": "5",
"numero": "1",
"numero_complet": "",
"n_secu": "",
"civilite": "M.",
"nom": "Dupond",
"nom_jeune_fille": "",
"prenom": "Jacques",
"date_de_naissance": "1963-09-01",
"lieu_de_naissance": "LYON",
"nationalite": "Française",
"situation_familiale": "-",
"adresse": "33 rue Bichat",
"code_postal": "75006",
"ville": "PARIS",
"pays_alpha2": "fr",
"pays": "France",
"profession": "Formateur Professionnel d'Adultes",
"telephone_perso": "0676655443",
"telephone_pro": "0676655443",
"email_perso": "",
"email_pro": "contact@cformateur.fr",
"statut": "travailleur_independant",
"remu_horaire_par_defaut": "0.00",
"diplomes": "",
"id_externe": "",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/formateurs.php?id=5
Il est possible de récupérer l'url de la photo
de profil du formateur dans la réponse, en rajoutant include=photo
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/formateurs.php?id=5&include=photo
Ajouter / Editer un formateur
{
"id_formateur": "5",
"id_add": "0",
"id_edit": "0",
"numero": "9",
"numero_complet": "FORM_2018009",
"numero_perso": "0",
"n_secu": "",
"civilite": "M.",
"nom": "Dupond",
"nom_jeune_fille": "",
"prenom": "Jacques",
"color": "",
"date_de_naissance": "1963-09-01",
"lieu_de_naissance": "LYON",
"nationalite": "Française",
"situation_familiale": "-",
"adresse": "33 rue Bichat",
"code_postal": "75006",
"ville": "PARIS",
"pays_alpha2": "fr",
"pays": "France",
"profession": "Formateur Professionnel d'Adultes",
"biographie_catalogue": "",
"telephone_perso": "0676655443",
"telephone_pro": "0676655443",
"email_perso": "",
"email_pro": "contact@cformateur.fr",
"statut": "Travailleur indépendant/gérant non salarié",
"statut_bpf": "Personne de votre organisme (CDI, CDD, occasionnel, bénévole)",
"mode_remu": "Horaire",
"remu_horaire_par_defaut": "0",
"key_uniq": "",
"id_externe": "",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_formateur | non | ID du Formateur (si vide -> ajout d'un nouveau Formateur, sinon -> édition) |
nom | oui | Nom |
prenom | oui | Prénom |
civilite | non | Civilité (format vérifié) |
date_de_naissance | non | Date de naissance (format "AAAA-MM-JJ" ou "JJ/MM/AAAA") |
statut | non | travailleur_independant, cdi, cdd, occasionnel, benevoles, exterieur |
statut_bpf | non | interieur, exterieur |
centre_id | non | ID Centre de formation sur lequel statut_bpf interne s'applique (existence vérifiée) |
mode_remu | non | Mode de rémunération : horaire, journalier |
remu_horaire_par_defaut | non | Rémunération Horaire par défaut |
remu_journaliere_par_defaut | non | Rémunération Journalière par défaut |
n_secu | non | Numéro de sécurité sociale |
num_da | non | Numéro de Déclaration d’Activité |
lieu_de_naissance | non | Lieu de naissance |
nationalite | non | Nationalité |
situation_familiale | non | Situation familliale |
adresse | non | Adresse (Rue) |
code_postal | non | Code postal |
ville | non | Ville |
pays | non | Pays. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
pays_alpha2 | non | Code ISO-3166-2 du Pays |
profession | non | Profession |
biographie_catalogue | non | Biographie affichée sur le catalogue |
telephone_perso | non | Téléphone perso |
telephone_pro | non | Téléphone pro |
email_perso | non | Email perso |
email_pro | non | Email pro |
id_centre_de_formation | non | ID Centre de formation (existence vérifiée, possibilité de mettre des IDs séparés par une virgule) |
langue_principale | non | Langue principale du Formateur (ISO 639-1) |
langues_secondaires | non | Liste des langues secondaires du Formateur (existence vérifiée, codes ISO 639-1 séparés par des virgules) |
competences_ids | non | ID des Compétences du Formateur, plusieurs ID possible (séparés par des virgules ex : 1,2,3 ) |
competences_list | non | Label des Compétences du Formateur, plusieurs labels possible (séparés par des points-virgules ex : Management;Conseil;Informatique ). Les Compétences seront créées si aucune correspondance exacte n'est trouvée |
dispo_geo_ids | non | ID des Disponibilités géographiques du Formateur, plusieurs ID possible (séparés par des virgules ex : 1,2,3 ) |
dispo_geo_list | non | Label des Disponibilités géographiques du Formateur, plusieurs labels possible (séparés par des points-virgules ex : Lyon;Marseille;Paris ). Les Disponibilités géographiques seront créées si aucune correspondance exacte n'est trouvée |
id_entreprise | non | Permet de rattacher le formateur à une Entreprise (Fournisseur) |
entreprise_raison_sociale | non | Liaison avec l'entreprise via la raison sociale |
entreprise_id_externe | non | Liaison avec l'entreprise via son id externe |
Requête HTTP
POST https://pro.dendreo.com/demo/api/formateurs.php
Supprimer un Formateur
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/formateurs.php?id=1
DELETE https://pro.dendreo.com/demo/api/formateurs.php?id_formateur=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_formateur | oui | ID Formateur (existence vérifiée) |
Entreprises
Lister toutes les entreprises
[
{
"id_entreprise": "1375",
"numero": "1",
"numero_complet": "",
"numero_compte_client": "",
"siret": "1678637863 00013",
"raison_sociale": "EDF",
"appellation": "",
"sigle": "Entreprise privée",
"statut_juridique": "SARL",
"telephone": "04 76 76 54 53",
"fax": "04 67 65 53 64",
"site_internet": "",
"email_standard": "",
"adresse": "8 AVenue du Gal ",
"code_postal": "75002",
"ville": "Paris",
"pays_alpha2": "fr",
"pays": "France",
"facturation_raison_sociale": "",
"facturation_adresse": "",
"facturation_code_postal": "",
"facturation_ville": "",
"facturation_pays_alpha2": "",
"facturation_pays": "",
"mode_financement_par_defaut": "entreprise",
"nb_employes": "0",
"enjeu": "0",
"client": "0",
"id_contact": "0",
"id_contact_secondaire": "0",
"commentaires": "",
"post_it_commercial": "",
"particulier": "0",
"id_externe": "",
"num_tva_intra": "16786387 00013",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"ape_code": "3511Z",
"code_naf": {
"id_code_naf": "639",
"code_naf": "3511Z",
"intitule": "Production d'électricité"
}
}
]
Il est possible de filtrer les entreprises via les paramètres suivant :
search
: La raison_sociale
ou le siret
de l'entreprise (recherche partielle)
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?search=EDF
numero_complet
: Le numéro complet de l'entreprise
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?numero_complet=ENT_2019001
particulier
: Filtrer pour avoir soit les Particuliers, soit les Entreprises (1 pour avoir uniquement les Particuliers, 0 pour avoir uniquement les Entreprises)
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?particulier=1
Il est possible d'afficher des statistiques supplémentaires en renseignant le paramètre include
sur la valeur stats
.
Le retour ajoute "ca_facture" (chiffre d'affaire facturé), "ca_genere_formation" (chiffre d'affaire lié uniquement à la formation) et "recettes_with_previsionnal" (Recettes incluant prévisionnel),
Exemple : GET https://pro.dendreo.com/demo/api/entreprises.php?include=stats
Requête HTTP
GET https://pro.dendreo.com/demo/api/entreprises.php
Afficher une entreprise
{
"id_entreprise": "1375",
"numero": "1",
"numero_complet": "",
"numero_compte_client": "",
"siret": "1678637863 00013",
"raison_sociale": "EDF",
"appellation": "",
"sigle": "Entreprise privée",
"statut_juridique": "SARL",
"telephone": "04 76 76 54 53",
"fax": "04 67 65 53 64",
"site_internet": "",
"email_standard": "",
"adresse": "8 AVenue du Gal ",
"code_postal": "75002",
"ville": "Paris",
"pays_alpha2": "fr",
"pays": "France",
"facturation_raison_sociale": "",
"facturation_adresse": "",
"facturation_code_postal": "",
"facturation_ville": "",
"facturation_pays_alpha2": "",
"facturation_pays": "",
"mode_financement_par_defaut": "entreprise",
"nb_employes": "0",
"enjeu": "0",
"client": "0",
"id_contact": "0",
"id_contact_secondaire": "0",
"commentaires": "",
"post_it_commercial": "",
"particulier": "0",
"id_externe": "",
"num_tva_intra": "16786387 00013",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/entreprises.php?id=1375
Ajouter / Editer une entreprise
Seule la présence de l'attribut raison_sociale
est validée.
{
"id_entreprise": "1375",
"numero": "1",
"numero_complet": "",
"numero_compte_client": "",
"numero_compte_client_auxiliaire": "",
"numero_comptable_adf": "",
"siret": "1678637863 00013",
"raison_sociale": "EDF",
"appellation": "",
"sigle": "Entreprise privée",
"statut_juridique": "SARL",
"telephone": "04 76 76 54 53",
"fax": "04 67 65 53 64",
"site_internet": "",
"email_standard": "",
"adresse": "8 Avenue du Gal ",
"code_postal": "75002",
"ville": "Paris",
"pays": "France",
"facturation_raison_sociale": "Facturation étrangère",
"facturation_adresse": "",
"facturation_code_postal": "",
"facturation_ville": "Utrech",
"facturation_pays_alpha2": "nl",
"mode_financement_par_defaut": "entreprise",
"nb_employes": "0",
"enjeu": "0",
"client": "0",
"id_contact": "0",
"id_contact_secondaire": "0",
"commentaires": "",
"post_it_commercial": "",
"particulier": "0",
"id_externe": "",
"num_tva_intra": "16786387 00013",
"id_centre_de_formation": "1,2",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_entreprise | non | ID de l'Entreprise (si vide -> ajout d'une nouvelle Entreprise, sinon -> édition) |
raison_sociale | oui | Raison sociale |
siret | non | N° SIRET |
num_tva_intra | non | N° TVA Intracommunautaire |
num_tva_intra_auto | non | N° TVA Intracommunautaire automatique (1 ou 0), si 1, le numéro TVA sera généré automatiquement en fonction de la présence du SIRET, du pays_alpha2 = 'fr' et du Taux de TVA (formation) > 0% |
numero_compte_client | non | N° Compte général |
numero_compte_client_auxiliaire | non | N° compte tiers (auxiliaire) |
appellation | non | Appellation |
sigle | non | Sigle |
statut_juridique | non | Statut juridique |
telephone | non | Téléphone |
fax | non | Fax |
site_internet | non | Site internet |
telephone | non | Téléphone |
email_standard | non | Email standard |
adresse | non | Adresse |
code_postal | non | Code postal |
ville | non | Ville |
pays | non | Pays. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
pays_alpha2 | non | Code ISO-3166-2 du Pays |
code_naf | non | Code Naf (alphanumerique, type 6201Z) |
nb_employes | non | Nombre d'employés |
commentaires | non | Commentaires |
post_it_commercial | non | Texte du Post-it Actions Commerciales |
id_administrateur | non | Commercial associé (existence vérifiée) |
id_externe | non | ID externe (synchro) |
facturation_raison_sociale | non | Raison sociale (facturation) |
facturation_adresse | non | Adresse (facturation) |
facturation_code_postal | non | Code postal (facturation) |
facturation_ville | non | Ville (facturation) |
facturation_pays | non | Pays (facturation). Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
facturation_pays_alpha2 | non | Code ISO-3166 du Pays (facturation) |
infos_adf | non | Rappel à afficher lors de la création d'une Opportunité, la programmation d’une formation ou à la réception d'une demande d'inscription pour ce client |
id_entreprise_parente (ou entreprise_id ) |
non | ID de l'Entreprise parente. Vous pouvez aussi utiliser : |
entreprise_parente (ou entreprise_parente_raison_sociale ) |
non | Raison sociale de l'Entreprise parente, pour rechercher automatiquement un ID Entreprise parente |
id_centre_de_formation | non | ID Centre de formation (existence vérifiée, possibilité de mettre des IDs séparés par une virgule) |
delai_paiement | non | Délai de paiement ( 'reception'=> 'À réception', '10_j' => '10 jours', '15_j'=> '15 jours', '30_j'=> '30 jours', '30_j_fdm' => '30 jours fin de mois', '30_j_fdm_10' => '30 jours fin de mois le 10', '30_j_fdm_15' => '30 jours fin de mois le 15', '40_j' => '40 jours', '40_j_fdm' => '40 jours fin de mois', '45_j'=> '45 jours', '45_j_fdm' => '45 jours fin de mois', '45_j_fdm_15' => '45 jours fin de mois le 15', '50_j'=> '50 jours', '50_j_fdm' => '50 jours fin de mois', '60_j'=> '60 jours', '60_j_fdm' => '60 jours fin de mois', '90_j'=> '90 jours', 'manuel' => 'Manuel') |
statut_bpf_participants_entreprise | non | Statut par défaut des participants de l'entreprise (salarie, agent_public, non_salarie, benevole, apprenti, autre, hors_bpf) |
mode_financement_par_defaut | non | Mode de financement par défaut (entreprise, opca, public, public_client, sous_traitance) |
has_chorus_pro_invoices | non | À déposer sur Chorus Pro ou non (1 ou 0) |
Requête HTTP
POST https://pro.dendreo.com/demo/api/entreprises.php
Supprimer une Entreprise
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/entreprises.php?id=1
DELETE https://pro.dendreo.com/demo/api/entreprises.php?id_entreprise=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_entreprise | oui | ID Entreprise (existence vérifiée) |
Contacts
Lister tous les contacts
[
{
"id_contact": "3",
"id_entreprise": "3",
"civilite": "Mme",
"nom": "Marue ",
"prenom": "",
"fonction": "Responsable Formation ",
"telephone_direct": "01 02 03 04 05",
"portable": "",
"email": "maru@domaine.fr",
"particulier": "0",
"id_externe": "",
"id_centre_de_formation": "1,2"
}
]
Il est possible de n'afficher que les contacts appartenants à une entreprise en renseignant l'attribut id_entreprise
. Il est aussi possible de filtrer les contacts sur les attributs nom
ou email
via l'argument search
(recherche partielle).
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id_entreprise=3
Il est aussi possible de filtrer les contacts sur les attributs nom
ou email
ainsi que d'inclure les informations de l'entreprise via l'attribut include
.
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?include=entreprise
Requête HTTP
GET https://pro.dendreo.com/demo/api/contacts.php
Afficher un contact
{
"id_contact": "3",
"id_entreprise": "3",
"civilite": "Mme",
"nom": "Marue ",
"prenom": "",
"fonction": "Responsable Formation ",
"telephone_direct": "01 02 03 04 05",
"portable": "",
"email": "maru@domaine.fr",
"particulier": "0",
"id_externe": "",
"id_centre_de_formation": "1,2"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/contacts.php?id=3
Il est possible de récupérer l'url de la photo
de profil du contact dans la réponse, en rajoutant include=photo
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/contacts.php?id=5&include=photo
Ajouter / Editer un contact
{
"id_contact": "3",
"id_entreprise": "3",
"civilite": "Mme",
"nom": "Marue ",
"prenom": "",
"fonction": "Responsable Formation ",
"telephone_direct": "01 02 03 04 05",
"portable": "",
"email": "maru@domaine.fr",
"particulier": "0",
"id_externe": "",
"id_centre_de_formation": "1,2"
}
Rattacher le contact à une entreprise
Il existe trois façons de rattacher un contact à une entreprise qui sont évaluées dans l'ordre de préférence suivant :
id_entreprise
: l'existence est vérifiéeentreprise_raison_sociale
: une recherche est effectuée sur le champsraison_sociale
, le premier résultat est pris en compteentreprise_id_externe
: une recherche est effectuée sur le champsid_externe
, seul un résultat exact est pris en compte
Configurer le type de contact
Il est possible de choisir si ce contact sera le contact principal, secondaire, ou facturation de son entreprise.
Pour cela, ajoutez un des paramètres suivant à votre requête :
contact_principal
: true
contact_secondaire
: true
contact_facturation
: true
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_contact | non | ID du Contact (si vide -> ajout d'un nouveau Contact, sinon -> édition) |
id_entreprise | oui (sauf pour édition) | ID Entreprise (existence vérifiée), indispensable pour rattacher le contact à une entreprise à sa création |
nom | oui | Nom |
prenom | non | prénom |
civilite | non | Civilité (format vérifié) |
fonction | non | Fonction |
telephone_direct | non | Téléphone direct |
portable | non | Portable |
non | ||
id_externe | non | ID Externe (synchro) |
entreprise_raison_sociale | non | Liaison avec l'entreprise via la raison sociale |
entreprise_id_externe | non | Liaison avec l'entreprise via son id externe |
contact_principal | non | Contact principal de l'entreprise |
contact_secondaire | non | Contact secondaire de l'entreprise |
contact_facturation | non | Contact facturation de l'entreprise |
langue_principale | non | Langue principale du Contact (ISO 639-1) |
langues_secondaires | non | Liste des langues secondaires du Contact (existence vérifiée, codes ISO 639-1 séparés par des virgules) |
Requête HTTP
POST https://pro.dendreo.com/demo/api/contacts.php
Transformer un Particulier en Entreprise + Contact + Participant
Il faut rajouter le paramètre suivant dans le corps de la requête POST : convert_to_entreprise_contact_participant=1
Requête HTTP
POST https://pro.dendreo.com/demo/api/contacts.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_contact | oui | ID du Contact |
convert_to_entreprise_contact_participant | oui | Paramètre à mettre à "1" pour effectuer la conversion |
Supprimer un contact
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/contacts.php?id=1
DELETE https://pro.dendreo.com/demo/api/contacts.php?id_contact=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_contact | oui | ID contact (existence vérifiée) |
Particuliers
Ajouter un particulier
L'ajout d'un particulier se fait sur la même URL qu'un contact avec la variable particulier
égale à 1.
{
"id_contact": "3",
"id_entreprise": "3",
"particulier": "1",
"civilite": "Mme",
"nom": "Marue",
"prenom": "Estelle",
"fonction": "Responsable Formation",
"telephone_direct": "01 02 03 04 05",
"portable": "",
"email": "marue@domaine.fr",
"id_externe": "",
"id_participant": 5
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
particulier | oui | valeur égale à 1 sinon ajout d'un contact |
civilite | non | Civilité (format vérifié) |
nom | oui | Nom |
prenom | oui | prénom |
fonction | non | Fonction |
telephone_direct | non | Téléphone direct |
portable | non | Portable |
non | ||
adresse | non | Adresse |
code_postal | non | Code postal |
ville | non | Ville |
pays | non | Pays. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
pays_alpha2 | non | Code ISO-3166-2 du Pays |
id_administrateur | non | Commercial associé (existence vérifiée) |
statut_bpf | non | independant,cpf_autonome,recherche_emploi,hors_bpf |
id_externe | non | ID Externe (synchro) |
id_participant | non | ID du Participant crée |
facturation_raison_sociale | non | Raison sociale (facturation) |
facturation_adresse | non | Adresse (facturation) |
facturation_code_postal | non | Code postal (facturation) |
facturation_ville | non | Ville (facturation) |
facturation_pays | non | Pays (facturation). Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
facturation_pays_alpha2 | non | Code ISO-3166 du Pays (facturation) |
Requête HTTP
POST https://pro.dendreo.com/demo/api/contacts.php
Editer un particulier
{
"id": "3",
"nom": "Marie",
"portable": "06 02 03 04 05",
"email": "marie@domaine.fr",
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_entreprise ou id_contact ou id_participant | oui | ID de la fiche à modifier (Fournir un seul des ID au choix) |
nom | non | Nom |
prenom | non | prénom |
civilite | non | Civilité (format vérifié) |
fonction | non | Fonction |
telephone_direct | non | Téléphone direct |
portable | non | Portable |
non | ||
id_externe | non | ID Externe (synchro) |
adresse | non | Adresse |
code_postal | non | Code postal |
ville | non | Ville |
pays | non | Pays. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
pays_alpha2 | non | Code ISO-3166-2 du Pays |
facturation_pays | non | Pays de Facturation. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
facturation_pays_alpha2 | non | Code ISO-3166-2 du Pays de Facturation |
id_administrateur | non | Commercial associé (existence vérifiée) |
statut_bpf | non | independant,cpf_autonome,recherche_emploi,hors_bpf |
Requête HTTP
POST https://pro.dendreo.com/demo/api/particuliers.php
Participants
Lister tous les participants
[
{
"id_participant": "17",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru ",
"prenom": "Françoise ",
"email": "",
"commentaires": "",
"portable": "",
"fonction": "Assistante RH",
"statut_bpf": "salarie",
"date_de_naissance": "0000-00-00",
"departement_naissance": "",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_entreprise": "4",
"particulier": "0",
"id_externe": "",
"lmsuniversel_user_id": "",
"tslearning_user_id": "",
"moodle_user_id": "",
"thinkific_user_id": "",
"dokeos_user_id": "",
"global_visible": "1",
"id_contact": "",
"responsable_type": "",
"responsable_id": "",
"newsletter_optin": "0",
"message_extranet": "",
"nom_naissance": "",
"pays_naissance_alpha2": "",
"pays_naissance": "",
"langue_principale": "",
"langues_secondaires": "",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"extranet_url": "https://extranet.centredemo.com",
"id_centre_de_formation": "1,2",
"extranet_code": "012-345-678",
"extranet_autologin_url": "https://extranet.centredemo.com/autologin/012-345-678"
}
]
Il est possible de n'afficher que les participants appartenants à une entreprise en renseignant l'attribut id_entreprise
.
Exemple : GET https://pro.dendreo.com/demo/api/participants.php?id_entreprise=4
Il est aussi possible de filtrer les participants sur les attributs nom
, email
ou date_de_naissance
(format “AAAA-MM-JJ” ou “JJ/MM/AAAA”
) (via l'attribut search
qui fera une recherche "OR" sur email
, nom
ou date_de_naissance
). Si vous souhaitez chercher juste sur l'email ou le nom (ou faire une recherche "AND"), vous pouvez le faire via les attributs email
ou nom
en GET qui sont aussi acceptés (par exemple participants.php?email=test@example.com&nom=dupont
pour chercher les participants ayant cet email ET ce nom).
Vous pouvez aussi inclure les informations de l'entreprise via l'attribut include
.
Exemple : GET https://pro.dendreo.com/demo/api/participants.php?search=user@domain.tld
Exemple : GET https://pro.dendreo.com/demo/api/participants.php?include=entreprise
Requête HTTP
GET https://pro.dendreo.com/demo/api/participants.php
Afficher un participant
{
"id_participant": "17",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru ",
"prenom": "Françoise ",
"email": "",
"commentaires": "",
"portable": "",
"fonction": "Assistante RH",
"statut_bpf": "salarie",
"date_de_naissance": "0000-00-00",
"departement_naissance": "",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_entreprise": "4",
"particulier": "0",
"id_externe": "",
"lmsuniversel_user_id": "",
"tslearning_user_id": "",
"moodle_user_id": "",
"thinkific_user_id": "",
"dokeos_user_id": "",
"global_visible": "1",
"id_contact": "",
"responsable_type": "",
"responsable_id": "",
"newsletter_optin": "0",
"message_extranet": "",
"nom_naissance": "",
"pays_naissance_alpha2": "",
"pays_naissance": "",
"langue_principale": "",
"langues_secondaires": "",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"extranet_url": "https://extranet.centredemo.com",
"extranet_code": "012-345-678",
"extranet_autologin_url": "https://extranet.centredemo.com/autologin/012-345-678"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/participants.php?id=17
ou
GET https://pro.dendreo.com/demo/api/participants.php?code_extranet=123-456-789
Il est possible de récupérer l'url de la photo
de profil du participant dans la réponse, en rajoutant include=photo
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/participants.php?id=5&include=photo
Il est aussi possible de requêter directement les informations de l'entreprise, du contact principal de l'entreprise, et du contact secondaire de l'entreprise du ou des participants via l'attribut include
.
Exemple : GET https://pro.dendreo.com/demo/api/participants.php?id=12,14,28&include=entreprise,entreprise_contact,entreprise_contact_secondaire
Ajouter / Editer un participant
{
"id_participant": "17",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru ",
"prenom": "Françoise ",
"email": "",
"commentaires": "",
"portable": "",
"fonction": "Assistante RH",
"statut_bpf": "salarie",
"date_de_naissance": "0000-00-00",
"departement_naissance": "",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_entreprise": "4",
"particulier": "0",
"id_externe": "",
"lmsuniversel_user_id": "",
"tslearning_user_id": "",
"moodle_user_id": "",
"thinkific_user_id": "",
"dokeos_user_id": "",
"global_visible": "1",
"id_contact": "",
"responsable_type": "",
"responsable_id": "",
"newsletter_optin": "0",
"message_extranet": "",
"nom_naissance": "",
"pays_naissance_alpha2": "",
"pays_naissance": "",
"langue_principale": "",
"langues_secondaires": "",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"extranet_url": "https://extranet.centredemo.com",
"id_centre_de_formation": "1,2",
"extranet_code": "012-345-678",
"extranet_autologin_url": "https://extranet.centredemo.com/autologin/012-345-678"
}
Attention, si votre Participant est un Particulier (personne en recherche d'emploi, indépendant, CPF Auotonme), vous ne devriez pas utiliser cet endpoint, mais plutôt l'endpoint Particuliers. En savoir plus.
Rattacher le participant à une entreprise
Il existe trois façons de rattacher un participant à une entreprise qui sont évaluées dans l'ordre de préférence suivant :
id_entreprise
: l'existence est vérifiéeentreprise_raison_sociale
: une recherche est effectuée sur le champsraison_sociale
, le premier résultat est pris en compteentreprise_id_externe
: une recherche est effectuée sur le champsid_externe
, seul un résultat exact est pris en compte
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_participant | non | ID du Participant (si vide -> ajout d'un nouveau Participant, sinon -> édition) |
id_entreprise | non | ID Entreprise (existence vérifiée) |
nom | oui | Nom |
prenom | oui | Prénom |
civilite | non | Civilité (format vérifié) |
fonction | non | Fonction |
commentaires | non | Commentaires |
portable | non | Portable |
non | ||
date_de_naissance | non | Date de naissance (format "AAAA-MM-JJ" ou "JJ/MM/AAAA") |
id_externe | non | ID Externe (synchro) |
entreprise_raison_sociale | non | Liaison avec l'entreprise via la raison sociale |
entreprise_id_externe | non | Liaison avec l'entreprise via son id externe |
statut_bpf | non | Salarie,agent_public,non_salarie,benevole,autre |
id_centre_de_formation | non | ID Centre de formation (existence vérifiée, possibilité de mettre des IDs séparés par une virgule) |
id_contact | non | Liaison avec une fiche contact (même personne, existence vérifiée) |
newsletter_optin | non | Accepte les newsletters |
responsable_id | non | Liaison avec un Participant ou un Contact en tant que responsable hierarchique (existence vérifiée) |
responsable_id_externe | non | Liaison avec un Participant ou un Contact en tant que responsable hierarchique (existence vérifiée) via son ID externe |
responsable_type | non | Type du responsable hierarchique : participant ou contact |
message_extranet | non | Message pour le Participant sur son accès extranet (au format HTML) |
generer_code_extranet | non | Générer le code extranet immédiatement même si le Participant n'est encore inscrit à aucune Action de Formation |
langue_principale | non | Langue principale du Participant (ISO 639-1) |
langues_secondaires | non | Liste des langues secondaires du Participant (existence vérifiée, codes ISO 639-1 séparés par des virgules) |
niveau_diplome | non | Valeurs possibles : sans , cqp , cap-bep , bac , bac+2 , bac+3 , bac+5 , bac+8 |
participant_commentaires | non | Commentaires liés au Participant (uniquement dans le cas d'un Particulier) |
entreprise_commentaires | non | Commentaires liés a l'Entreprise (uniquement dans le cas d'un Particulier) |
Champs disponibles en modification uniquement
Intitulé | Obligatoire | Description |
---|---|---|
date_changement_entreprise_id | oui | Id de l'Entreprise concerné par la date de changement d'Entreprise |
date_changement_entreprise | non | Date de changement d'Entreprise (format "AAAA-MM-JJ" ou "JJ/MM/AAAA") |
Requête HTTP
POST https://pro.dendreo.com/demo/api/participants.php
Supprimer un Participant
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/participants.php?id=1
DELETE https://pro.dendreo.com/demo/api/participants.php?id_participant=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_participant | oui | ID Participant (existence vérifiée) |
Tâches
Lister les tâches en attente sur les Extranets Participants
[
{
"id_participant": "17",
"counts": {
"esignature": "2",
"esignature-doc": "2",
"satisfaction": {
"froid": "2",
"chaud": "1"
},
"auto-positionnement": {
"post": "4",
"pre": "1"
}
},
"taches": [
{
"type": "esignature",
"intitule": "Emargement électronique",
"id_adf": "462",
"id_lcp": "3249",
"creneau_date_debut": "2024-06-18 13:30:00",
"creneau_date_fin": "2024-06-18 15:30:00",
"url": "https://extranet.centredemo.com/participants/emargement/3249/create"
},
{
"type": "esignature-doc",
"intitule": "Signature électronique d'un document",
"id_media": "779",
"date": "2024-04-18 15:06:02",
"id_adf": "340",
"url": "https://extranet.centredemo.com/participants/signatures/4Ew07ZTbqmKmHYwVsluDHnNLohfslPe3/779/viewer"
},
{
"type": "satisfaction",
"intitule": "Questionnaire de Satisfaction",
"questionnaire_type": "Questionnaire à Chaud",
"id_adf": "462",
"id_lap": "1509",
"url": "https://extranet.centredemo.com/participants/gy60fzdfyu906wqmgd4n/satisfaction/1/edit"
},
{
"type": "satisfaction",
"intitule": "Questionnaire de Satisfaction",
"questionnaire_type": "Questionnaire à Froid",
"id_adf": "104",
"id_lap": "201",
"url": "https://extranet.centredemo.com/participants/3avkwbubvhxqmuyw02fg/satisfaction/2/edit"
},
{
"type": "auto-positionnement",
"intitule": "Questionnaire d'Auto-positionnement",
"positionnement_type": "Formulaire post-formation",
"id_adf": "339",
"id_lap": "303",
"url": "https://extranet.centredemo.com/participants/g543kl2ve2fehkuumlfc/post_formation/create"
},
{
"type": "auto-positionnement",
"intitule": "Questionnaire d'Auto-positionnement",
"positionnement_type": "Formulaire pré-formation",
"id_adf": "463",
"id_lap": "1514",
"url": "https://extranet.centredemo.com/participants/ne07pmtbje3frvbmuu9z/pre_formation/create"
}
]
}
]
Vous pouvez récupérer les tâches en attente sur les Extranets d'un ou plusieurs Participants.
GET https://pro.dendreo.com/demo/api/taches.php?id=...
L'un des paramètres id
ou code_extranet
est obligatoire :
- Le paramètre
id
peut contenir une liste d'ID de participants séparés par une virgule. - Le paramètre
code_extranet
ne permet de récupérer qu'un seul participant.
Les différentes tâches en attente pour un Participant sont :
- Les émargements électroniques en cours (esignature)
- Les signatures électroniques en attente (esignature-doc)
- Les questionnaires de Satisfaction en attente (satisfaction)
- Les questionnaires d'Auto-positionnement en attente (auto-positionnement)
Il est possible de filtrer les tâches selon leur type, via l'attribut types
en fournissant la liste des tâches séparées par une virgule.
Le paramètre autologin=1
permet d'obtenir les URL avec l'autologin à l'extranet des Participants.
Requêtes HTTP
Par ID d'un Participant :
GET https://pro.dendreo.com/demo/api/taches.php?id=17
Par ID d'un Participant avec autologin:
GET https://pro.dendreo.com/demo/api/taches.php?id=17&autologin=1
Liste de participants par IDs :
GET https://pro.dendreo.com/demo/api/taches.php?id=17,18,19
Par le code extranet d'un Participant :
GET https://pro.dendreo.com/demo/api/taches.php?code_extranet=123-456-789
Uniquement les emargements en cours et les documents à signer
Exemple : GET https://pro.dendreo.com/demo/api/taches.php?id=17&types=esignature,esignature-doc
Etapes
Lister toutes les étapes
[
{
"id_etape_process": "2",
"intitule": "Réalisation",
"id_parent": "0",
"status": "1",
"ordre": "2",
"name": "real",
"cible": "intra"
}
]
Accède à toutes les étapes présentes sur Dendreo.
Requête HTTP
GET https://pro.dendreo.com/demo/api/etapes.php
Afficher une étape
{
"id_etape_process": "2",
"intitule": "Réalisation",
"id_parent": "0",
"status": "1",
"ordre": "2",
"name": "real",
"cible": "intra"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/etapes.php?id=2
Centres de formation
Lister tous les centres de formation
[
{
"id_centre_de_formation": "1",
"raison_sociale": "Centre principal",
"nom_commercial": "Demo Formation"
}
]
Accède à tous les centres de formation présents sur Dendreo.
Requête HTTP
GET https://pro.dendreo.com/demo/api/centres_de_formation.php
Afficher un centre de formation
{
"id_centre_de_formation": "1",
"raison_sociale": "Centre principal",
"nom_commercial": "Demo Formation"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/centres_de_formation.php?id=1
Salles de formation
Lister toutes les salles de formation
[
{
"id_salle_de_formation": "3",
"intitule": "Salle Einstein",
"color": "",
"status": "1",
"capacite_max": "20",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_centre_de_formation": "1,2",
"lien_google_maps": "https://www.google.fr/maps",
"acces": "Porte extérieure : appuyer sur P",
"inside": "1",
"telephone": "01 23 45 67 89",
"email": "",
"accueil": "",
"nom_contact": "",
"commentaires_internes": "",
"no_conflits": "0",
"elearning": "0",
"url_connexion": "",
"emplacement_type": "CentresDeFormation",
"emplacement_id": "1",
"acces_handicapes": "1",
"acces_handicapes_desc": "Précisions sur l'accès aux personnes en situation de handicap",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
]
Accède à toutes les salles de formation présentes sur Dendreo.
L'emplacement de la salle peut être CentresDeFormation
ou Entreprise
.
Dans les 2 cas, le champ inside
peut être à 1 ou 0.
Dans le cas où c'est une salle elearning
, le champ elearning
sera à 1, et le champ inside
à 0.
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
inside | non | Permet de filtrer sur le champ "inside" (valeur : 0 ou 1) |
emplacement_cible | non | Permet de filtrer sur le champ "Emplacement de la salle" (valeur : 'CentresDeFormation' ou 'Entreprise') |
Requête HTTP
GET https://pro.dendreo.com/demo/api/salles_de_formation.php
Afficher une salle de formation
{
"id_salle_de_formation": "4",
"intitule": "Salle Amandre",
"color": "",
"status": "1",
"capacite_max": "42",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_centre_de_formation": "1,2",
"lien_google_maps": "",
"acces": "",
"inside": "1",
"telephone": "",
"email": "",
"accueil": "",
"nom_contact": "",
"commentaires_internes": "",
"no_conflits": "0",
"elearning": "0",
"url_connexion": "",
"emplacement_type": "CentresDeFormation",
"emplacement_id": "1",
"acces_handicapes": "1",
"acces_handicapes_desc": "Précisions sur l'accès aux personnes en situation de handicap",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
L'emplacement de la salle peut être CentresDeFormation
ou Entreprise
.
Dans les 2 cas, le champ inside
peut être à 1 ou 0.
Dans le cas où c'est une salle elearning
, le champ elearning
sera à 1, et le champ inside
à 0.
Requête HTTP
GET https://pro.dendreo.com/demo/api/salles_de_formation.php?id=4
Ajouter une salle de formation
{
"id_salle_de_formation": "4",
"intitule": "Salle Amandre",
"color": "",
"status": "1",
"capacite_max": "42",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_centre_de_formation": "1,2",
"lien_google_maps": "",
"acces": "",
"inside": "1",
"telephone": "",
"email": "",
"accueil": "",
"nom_contact": "",
"commentaires_internes": "",
"no_conflits": "0",
"elearning": "0",
"url_connexion": "",
"emplacement_type": "CentresDeFormation",
"emplacement_id": "1",
"acces_handicapes": "1",
"acces_handicapes_desc": "Précisions sur l'accès aux personnes en situation de handicap",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
intitule | oui | Nom de la salle |
emplacement_cible | oui | Emplacement de la salle ('cdf_outside', 'elearning', 'client', 'client_outside' ou un id_centre_de_formation valide) |
id_entreprise | oui si emplacement_cible = client ou client_outside | Entreprise lié à cette salle (existance vérifiée) |
color | non | Couleur de la salle |
id_centre_de_formation | non | Visiblité de la salle (possibilité de mettre des IDs séparés par une virgule) |
capacite_max | non | Capaxité maximum de la salle |
commentaires_internes | non | Commentaires internes de la salle |
no_conflits | non | Détecter ou non les conflit de la salle (0 ou 1) |
acces_handicapes | non | Accès aux personnes en situation de handicap (0 ou 1) |
acces_handicapes_desc | non | Précisions sur l'accès aux personnes en situation de handicap |
Uniquement si emplacement_cible
= client_outside
ou cdf_outside
Intitulé | Obligatoire | Description |
---|---|---|
nom_contact | non | Nom du contact |
adresse | non | Adresse de la salle |
code_postal | non | Code postal de la salle |
ville | non | Ville de la salle |
pays | non | Pays. Le libellé doit correspondre à un pays reconnu dans la norme ISO-3166 |
pays_alpha2 | non | Code ISO-3166-2 du Pays |
telephone | non | Téléphone de la salle |
non | Email de la salle (structure vérifiée) | |
lien_google_maps | non | Lien Google Maps |
acces | non | Informations pratiques d'accès de la salle |
accueil | non | Informations d'accueil de la salle |
Uniquement si emplacement_cible
= elearning
Intitulé | Obligatoire | Description |
---|---|---|
url_connexion | non | Url de connexion de la salle |
Actions de Formation
Lister toutes les Actions de Formation
[
{
"id_action_de_formation": "37",
"id_centre_de_formation": "0",
"id_salle_de_formation": "0",
"numero": "1",
"numero_complet": "",
"numero_comptable": "",
"type": "intra",
"intitule": "Intitulé",
"description": "Description",
"id_entreprise": "4",
"id_contact": "4",
"id_etape_process": "10",
"date_debut": "2016-01-20 09:00:00",
"date_fin": "2016-01-21 16:00:00",
"date_etape_realisation": "2016-01-23 16:21:44",
"date_etape_archivage": "2016-02-06 14:17:06",
"date_etape_echec": "0000-00-00 00:00:00",
"lieu": "",
"nb_participants_min": "0",
"nb_participants_max": "12",
"objectif": "autre",
"nature": "2",
"inscription_online": "1",
"include_in_bpf": "1",
"total_heures_participants": "14",
"total_participants": "10",
"categorie_module_id": "9",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"pourcentage_planification": 70,
"emargements_url": "https://extranet-demo.dendreo.com/formations/PemelmMaKB"
}
]
Accède à toutes les actions de formation présentes sur Dendreo.
Il est possible d'afficher des données supplémentaires pour les actions de formations en renseignant le paramètre include
.
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?include=stats,modules,participants,formateurs,entreprises,creneaux,visuel,salles,etapeProcess,recettes
Il est possible de filtrer les actions de formation via les paramètres suivant :
nb_jours
: les actions de formation ajoutées et/ou modifiées sur les N derniers jours
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?nb_jours=3
type
: les actions de formation de type "inter" ou "intra"
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?type=inter
id_entreprise
: les actions de formation INTRA liées à l'entreprise sélectionnée
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?type=intra&id_entreprise=38
id_module
: les actions de formation qui contiennent le module sélectionné
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id_module=657
id_salle_de_formation
: les actions de formation qui ont au moins un lieu correspondant à cette salle
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id_salle_de_formation=2
id_formateur
: les actions de formation qui ont ce formateur staffé à au moins 1 créneau
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id_formateur=56
numero_complet
: l'action de formation portant ce numero complet
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?numero_complet=ADF_2019001
id_centre_de_formation
: les actions de formation qui sont rattachées à ce centre de formation
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id_centre_de_formation=1
id_externe
: l'action de formation portant cet id externe
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id_externe=1
Il est enfin possible de filtrer les actions de formations sur les attributs intitule
ou numero_complet
via l'argument search
(recherche partielle).
Attention, par défaut, seules les actions de formation de la dernière année sont retournées !
Mais, comme indiqué dans la section recherche/filtre, vous pouvez filtrer les Actions de Formation selon leur date de début ou de fin pour étendre cette sélection ou affiner votre recherche.
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?ended_after=2020-12-31
Requête HTTP
GET https://pro.dendreo.com/demo/api/actions_de_formation.php
Listing pour Catalogue public
Si vous souhaitez afficher un petit widget sur votre site web qui indique par exemple "Nos 3 prochaines sessions de formation", vous pouvez utiliser cet endpoint spécial qui a pour effet de vous retourner une liste pré-compilées de prochaines Actions de Formation.
Il ne s'agit pas exactement de l'objet Action de Formation, le retour est un mélange d'informations simples du Module, et de l'Action de Formation, ainsi que certaines infos concernant le prix, le remplissage et le lieux de la session.
Cet endpoint a l'avantage de filtrer automatiquement les Modules et Actions de Formation pour ne prendre en compte uniquement :
- les Modules qui sont présents dans votre Catalogue (pas les modules Hors Catalogue)
- les Modules des Actions de Formation qui sont configurées pour s'afficher sur votre Catalogue (automatique pour les Actions de Formation mono-Module, manuel pour les Actions de Formation multi-Module)
- les Modules des Actions de Formation dans le futur uniquement
- les Modules des Actions de Formation INTER uniquement (sauf réglage explicite différent)
- les Modules des Actions de Formation qui sont dans des étapes prévisionnelles uniquement (configurable)
Le résultat est donc identique à ce que notre option Catalogue en ligne affiche si vous l'utilisez.
[
{
"intitule": "Intitule",
"date_debut": "2019-07-31 08:00:00",
"date_fin": "2019-07-31 17:00:00",
"id_action_de_formation": "193",
"id_lam": "112",
"id_module": "39",
"categorie": "Catégorie",
"slug_categorie": "https://pro.dendreo.com/demo/public/catalogue/categorie/1/categorie",
"remplissage": "2/5",
"total_participants": "2",
"nb_participants_max": "5",
"prix_formation": "100",
"prix_module": "300",
"slug": "https://pro.dendreo.com/demo/public/catalogue/formation/117/intitule/75",
"lieux": [
{
"intitule": "Salle 1",
"adresse": "4 rue du Test",
"ville": "Paris",
"code_postal": "75008",
"pays_alpha2": "fr",
"pays": "France",
"lien_google_maps": "",
"acces": "",
"telephone": "01 02 03 04 05",
"email": "",
"accueil": "",
"nom_contact": ""
}
]
}
]
Requête HTTP
Notez que l'endpoint n'est pas actions_de_formation
!
GET https://pro.dendreo.com/demo/api/catalogue_prochaines_sessions.php
Il est possible de récupérer l'URL du visuel
associé à chaque Module, dans la réponse, en rajoutant include=visuel
à votre requête.
Exemple : `GET https://pro.dendreo.com/demo/api/catalogue_prochaines_sessions.php?include=visuel
Il est possible de récupérer la moyenne de satisfaction associé à chaque Module, dans la réponse, en rajoutant include=satisfaction
à votre requête.
Exemple : `GET https://pro.dendreo.com/demo/api/catalogue_prochaines_sessions.php?include=satisfaction
Il est possible de récupérer les Créneaux dans la réponse, en rajoutant include=creneaux
à votre requête.
Exemple : `GET https://pro.dendreo.com/demo/api/catalogue_prochaines_sessions.php?include=creneaux
Il est possible de récupérer les Salles de chaque Créneaux dans la réponse, en rajoutant include=creneaux,creneaux.salle
(les 2 sont nécessaires) à votre requête.
Exemple : `GET https://pro.dendreo.com/demo/api/catalogue_prochaines_sessions.php?include=creneaux,creneaux.salle
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
limit | non | Nombre d'Actions de Formation renvoyées (défaut: 10) |
id_centre_de_formation | non | Id du centre de formation à afficher |
id_module | non | Id du Module pour filtre |
id_categorie | non | Id de la Catégorie pour filtre |
show_inter_only | non | Si mis à "true", alors les Intra sont exclues |
Afficher une Action de Formation
{
"id_action_de_formation": "37",
"id_centre_de_formation": "0",
"id_salle_de_formation": "0",
"numero": "1",
"numero_complet": "",
"numero_comptable": "",
"type": "intra",
"intitule": "Intitulé",
"description": "Description",
"id_entreprise": "4",
"id_contact": "4",
"id_etape_process": "10",
"date_debut": "2016-01-20 09:00:00",
"date_fin": "2016-01-21 16:00:00",
"date_etape_realisation": "2016-01-23 16:21:44",
"date_etape_archivage": "2016-02-06 14:17:06",
"date_etape_echec": "0000-00-00 00:00:00",
"lieu": "",
"nb_participants_min": "0",
"nb_participants_max": "12",
"objectif": "autre",
"nature": "2",
"inscription_online": "1",
"include_in_bpf": "1",
"total_heures_participants": "14",
"total_participants": "10",
"nb_participants_inscrits": "6",
"nb_participants_non_inscrits": "2",
"nb_participants_en_attente": "1",
"tva_formation": "10.00",
"tva_hors_formation": "20.00",
"tva_frais": "5.5",
"categorie_module_id": "9",
"ical_url": "https://public.dendreo.com/demo/ical/nxlfbn57t75shd1q1h3flzsk5hwctyv77Anfhdxsl4tbhrjz8wb1",
"pourcentage_planification": 70,
"emargements_url": "https://extranet-demo.dendreo.com/formations/PemelmMaKB"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id=37
Il est possible de récupérer l'url du visuel
associé à l'action de formation dans la réponse, en rajoutant include=visuel
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/actions_de_formation.php?id=37&include=visuel
Ajouter / Editer une Action de Formation
Les validations effectuées sont dépendantes du type
fourni.
{
"id_action_de_formation": "37",
"id_centre_de_formation": "0",
"id_salle_de_formation": "0",
"numero": "1",
"numero_complet": "",
"numero_comptable": "",
"type": "intra",
"intitule": "Intitulé",
"description": "Description",
"id_entreprise": "4",
"id_contact": "4",
"id_etape_process": "10",
"date_debut": "2016-01-20 09:00:00",
"date_fin": "2016-01-21 16:00:00",
"date_etape_realisation": "2016-01-23 16:21:44",
"date_etape_archivage": "2016-02-06 14:17:06",
"date_etape_echec": "0000-00-00 00:00:00",
"lieu": "",
"nb_participants_min": "0",
"nb_participants_max": "12",
"objectif": "autre",
"nature": "2",
"inscription_online": "1",
"include_in_bpf": "1",
"total_heures_participants": "14",
"total_participants": "10",
"objectif_pedagogique": "Objectif pédagogique",
"modalites_pedagogiques": "Modalités pédagogiques",
"moyens_supports_pedagogiques": "Moyens et supports pédagogiques",
"public_vise": "Public visé",
"pre_requis": "Prérequis",
"infos_admission": "Informations sur l'admission",
"modalites_devaluation": "Modalités d’évaluation et de suivi",
"accessibilite": "Informations sur l'accessibilité",
"profil_formateurs": "Profil du / des Formateur(s)",
"nb_participants_inscrits": "6",
"nb_participants_non_inscrits": "2",
"nb_participants_en_attente": "1",
"categorie_module_id": "9",
"tva_formation": "10.00",
"tva_hors_formation": "20.00",
"tva_frais": "5.5"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | non | ID de l'Action de Formation (si vide -> ajout d'une nouvelle action de formation, sinon -> édition) |
intitule | oui | Intitulé |
intitule_court | non | Si non vide remplace l'Intitulé dans l'Agenda |
type | oui | Type (inter ou intra, non disponible en édition) |
include_in_bpf | oui | Booléen. Inclure dans le BPF, par défaut "1" |
date_debut | oui | Date de début (format vérifié : "AAAA-MM-JJ" ou "AAAA-MM-JJ HH:MM:SS" , non disponible en édition) |
date_fin | oui | (Obligatoire sauf si id_module est précisé) Date de fin (format vérifié : "AAAA-MM-JJ" ou "AAAA-MM-JJ HH:MM:SS", non disponible en édition) |
id_module | non | Module à programmer directement dans l'ADF |
prix | non | Défini un prix personnalisé si id_module est également précisé |
id_formateur | non | Permet de staffer automatiquement un Formateur si id_module est également précisé. Renseignez la valeur null ou 0 pour ne pas staffer le Formateur par défaut du Module (si renseigné) |
id_entreprise_formateur | non | Permet de staffer automatiquement une Entreprise Sous-Traitante si id_module est également précisé. Renseignez la valeur null ou 0 pour ne pas staffer l'Entreprise Sous-Traitante par défaut du Module (si renseigné) |
id_salle_de_formation | non | ID Salle de formation (existence vérifiée) |
salle_client | non | Booléen. Si à "true", le paramètre id_entreprise doit être fourni et le type de l'Action de formation doit être "Intra". Une salle de formation interne au client sera récupérée ou créée et liée à l'Action de formation |
id_centre_de_formation | non | ID Centre de formation (existence vérifiée, non disponible en édition) |
id_entreprise | oui si (type = 'intra') | ID Entreprise (existence vérifiée, paramètre interdit si type = 'inter') |
id_contact | non | ID Contact (existence vérifiée, paramètre interdit si type = 'inter') |
id_externe_contact | non | ID Contact Externe (existence vérifiée, paramètre interdit si type = 'inter') |
id_etape_process | non | ID Etape (existence vérifiée) |
numero | non | Numéro |
numero_complet | non | numero_complet |
objectif_pedagogique | non | Objectif pédagoqique |
modalites_pedagogiques | non | Modalités pédagogiques |
moyens_supports_pedagogiques | non | Moyens et supports pédagogiques |
public_vise | non | Public visé |
pre_requis | non | Prérequis |
infos_admission | non | Informations sur l'admission |
modalites_devaluation | non | Modalités d'évaluation et de suivi |
accessibilite | non | Informations sur l'accessibilité |
profil_formateurs | non | Profil du / des Formateur(s) |
categorie_module_id | non | ID catégorie du module (existence vérifiée) |
nb_participants_min | non | Nombre minimum de participants |
nb_participants_max | non | Nombre maximum de participants |
id_responsable | non | Responsable Dendreo |
id_commercial | non | Commercial rattaché à action de formation |
mode_pricing | non | En ajout et en INTRA seulement. Valeurs : par_jour ou global |
commentaires | non | Commentaires Internes |
commentaires_agenda | non | Commentaires visibles sur l'agenda (disponible pour les Extranets) |
esignature | non | Active ou non les émargements electroniques. Si absent, la configuration du centre sera utilisée. |
remuneration_par_lmf | non | Active ou non l'option "Rémunération des Formateurs par Module" |
objectif | non | Valeurs possibles : niveau12 , niveau3 , niveau4 , niveau5 , niveau2 , cqp_sans , cqp_rs , cqp_non_rs , autres , bilan , accompagnement |
nature | non | Valeurs possibles : 101 (Action de Formation), 102 (Bilan de compétences), 103 (Action permettant de faire valider les acquis de l'expérience), 104 (Action de Formation par apprentissage) |
num_session_dpc | non | Numéro de session DPC : valeur modifiable si l'option "Affichage des options DPC sur les ADFs et Participants" est activé |
tva_formation | non | Taux de TVA à appliquer sur la formation (doit faire partie des valeurs de tva autorisées) |
tva_hors_formation | non | Taux de TVA à appliquer sur le hors formation (doit faire partie des valeurs de tva autorisées) |
tva_frais | non | Taux de TVA à appliquer sur les frais (doit faire partie des valeurs de tva autorisées) |
Requête HTTP
POST https://pro.dendreo.com/demo/api/actions_de_formation.php
Supprimer une Action de Formation
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/actions_de_formation.php?id=1
DELETE https://pro.dendreo.com/demo/api/actions_de_formation.php?id_action_de_formation=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_action_de_formation | oui | ID Action de Formation (existence vérifiée) |
Créneaux
Afficher les créneaux
Vous pouvez sélectionner les créneaux d'une seule Action de formation via l'attribut id_action_de_formation
. De même
vous pouvez sélectionner tous les créneaux d'un Lam (Lien Action de formation - Module) via l'attribut id_lam
et tous
les créneaux d'un Module (quelle que soit l'Action de formation) via l'attribut id_module
.
Exemple : GET https://pro.dendreo.com/demo/api/creneaux.php?id_action_de_formation=12
Vous pouvez également inclure la liste des formateurs effectuant ces créneaux en ajoutant le
paramètre include=formateurs
Exemple : GET https://pro.dendreo.com/demo/api/creneaux.php?id_action_de_formation=12&include=formateurs
Vous pouvez également sélectionner les créneaux d'un seul Participant via l'attribut id_participant ou
participant_id_externe en ajoutant le paramètre id_participant=1912
ou participant_id_externe=1912
Exemple : GET https://pro.dendreo.com/demo/api/creneaux.php?id_participant=1912
Vous pouvez également sélectionner les créneaux d'un seul Formateur via l'attribut id_formateur ou formateur_id_externe
en ajoutant le paramètre id_formateur=1912
ou formateur_id_externe=1912
Exemple : GET https://pro.dendreo.com/demo/api/creneaux.php?id_formateur=1912
[
{
"id_creneau": "864",
"id_add": "5",
"id_edit": "0",
"id_action_de_formation": "617",
"id_lam": "619",
"date_debut": "2017-01-10 10:00:00",
"date_fin": "2017-01-10 11:00:00",
"name": "",
"icon": "",
"id_salle_de_formation": "4",
"formation_presente": "1"
},
{
"id_creneau": "1544",
"id_add": "5",
"id_edit": "0",
"id_action_de_formation": "1297",
"id_lam": "1299",
"date_debut": "2017-01-11 10:00:00",
"date_fin": "2017-01-11 12:00:00",
"name": "",
"icon": "",
"id_salle_de_formation": "4",
"formation_presente": "0",
"url_connexion": "https://extranet-demo.dendreo.com/participants/liverooms/5",
"url_connexion_invite": "https://extranet-demo.dendreo.com/liverooms/xxxx"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/creneaux.php
Afficher un créneau
{
"id_creneau": "950",
"id_add": "5",
"id_edit": "0",
"id_action_de_formation": "617",
"id_lam": "619",
"date_debut": "2017-01-11 10:00:00",
"date_fin": "2017-01-11 12:00:00",
"name": "Théorie",
"icon": "star",
"id_salle_de_formation": "4",
"formation_presente": "1",
"url_connexion": "https://extranet-demo.dendreo.com/participants/liverooms/5",
"url_connexion_invite": "https://extranet-demo.dendreo.com/liverooms/xxxx"
"lcps": [
{
"id_lcp": "93",
"id_add": "0",
"id_edit": "0",
"id_creneau": "950",
"id_lmp": "28",
"id_lap": "25",
"presence": "1",
"justified": "0",
"justification": "",
"lap": {
"id_lap": "25",
"id_participant": "2",
"id_entreprise": "1",
"participant": {
"id_participant": "2",
"nom": "Duru",
"prenom": "Françoise",
"email": "",
"id_entreprise": "2",
"particulier": "0"
}
}
}
]
}
Vous pouvez inclure :
la liste des formateurs effectuant ce créneau en ajoutant le paramètre
include=formateurs
la liste des participants (lcps) de ce créneau en ajoutant le paramètre
include=lcps
la liste des formateurs (lcfs) de ce créneau en ajoutant le paramètre
include=lcfs
(pour émargement formateur)le suivi pédagogique (suivi) de ce créneau en ajoutant le paramètre
include=suivi
Un lcp
est le lien entre un creneau
et un lap
, puis le lap
, fait le lien avec le participant
à proprement
parlé. Dans le lcp
vous avez accès aux variables concernant les présences, et l'émargement dans "emargement_count" (vaut 1 si signature, 0 si absence de signature)
Un lcf
est le lien entre un creneau
et un laf
, puis le laf
, fait le lien avec le formateur
à proprement
parlé. Dans le lcf
vous avez accès à l'émargement dans "emargement_count" (vaut 1 si signature, 0 si absence de signature)
Exemple : GET https://pro.dendreo.com/demo/api/creneaux.php?id=950&include=lcps
Requête HTTP
GET https://pro.dendreo.com/demo/api/creneaux.php?id=950
Ajouter / Editer un Créneau
{
"id_lam": "120",
"date_debut": "2021-07-21 13:30:00",
"date_fin": "2021-07-21 17:45:00",
"name": "Intitulé du créneau",
"id_salle_de_formation": "",
"date_edit": "2021-07-21 14:51:11",
"date_add": "2021-07-21 14:51:11",
"id_creneau": "328",
"id_add": "0",
"id_edit": "0"
}
Pour ajouter un Créneau vous avez le choix entre 3 solutions :
Fournir directement
id_lam
Fournir
id_action_de_formation
ETid_module
Fournir
id_externe_action_de_formation
ETid_externe_module
Dans les deux derniers cas, la première paire Action de Formation/Module sera prise en compte au cas où il y aurait plusieurs fois le même Module au sein d'une même Action de Formation.
Pour editer un Créneau :
- Fournir directement
id
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | non | ID du Créneau (si vide -> ajout d'un nouveau Créneau, sinon -> édition du Créneau existant) |
id_lam | oui | Obligatoire sauf si id_action_de_formation ET id_module sont fournis ou id_externe_action_de_formation ET id_externe_module sont fournis |
id_action_de_formation ou id_module | oui | Obligatoire sauf si id_lam , id_externe_action_de_formation ou id_externe_module sont fournis |
id_externe_action_de_formation ou id_externe_module | oui | Obligatoire sauf si id_lam , id_action_de_formation ou id_module |
date | oui | format AAAA-MM-JJ |
heure_debut | oui | format HH:MM |
heure_fin | oui | format HH:MM (doit être sur un interval de 5 minutes pleines) |
name | non | intitule spécifique du Créneau |
id_salle_de_formation | non | id d'une Salle (existence vérifiée). Obligatoire si url_participants est renseignée |
url_participants | non | URL de connexion pour les Participants (si la Salle est une Salle virtuelle) |
url_formateurs | non | URL de connexion pour les Formateurs (si la Salle est une Salle virtuelle et que url_participants est renseignée) |
delete_absence | non | Booléen. Si 1, supprime les absences et émargements formateur |
Requête HTTP
POST https://pro.dendreo.com/demo/api/creneaux.php
Inscription d'un participant
Afficher les inscriptions d'une action de formation
Attention, la sélection d'une action de formation, via id_action_de_formation
, id_participant
ou id_entreprise
est obligatoire.
Il est possible d'ajouter à la réponse les informations du participant via le paramètre include=participant
.
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_entreprise=371&include=participant
Il est également possible d'enrichir les informations de l'inscription d'un participant via le paramètre include=lmps
.
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_entreprise=371&include=lmps
Vous pouvez aussi utiliser les 2 paramètres conjointement :
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_entreprise=371&include=lmps,participant
Enfin, si vous voulez encore plus de détail vous pouvez inclure les lcps (créneaux) :
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_entreprise=371&include=lcps
[
{
"id_lap": "950",
"id_action_de_formation": "330",
"id_entreprise": "170",
"id_participant": "0",
"satisfaction_status": "0",
"status": "1",
"source": "dendreo",
"inscription_lmp": "1",
"id_groupe": "1",
"lmps": [
{
"id_lmp": "182",
"id_lam": "799",
"status": "1",
"prix": "670.00",
"prix_personnalise": "1",
"total_heures_presence": "0.00"
}
],
"participant" : {
"id_participant": "17",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru",
"prenom": "Françoise"
...
}
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/laps.php?id_action_de_formation=330
Afficher une inscription
{
"id_lap": "950",
"id_action_de_formation": "330",
"id_entreprise": "170",
"id_participant": "0",
"satisfaction_status": "0",
"status": "1",
"source": "dendreo",
"inscription_lmp": "1",
"id_groupe": "1",
"lmps": [
{
"id_lmp": "182",
"id_lam": "799",
"status": "1",
"prix": "670.00",
"prix_personnalise": "1",
"total_heures_presence": "0.00"
}
],
"participant" : {
"id_participant": "17",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru",
"prenom": "Françoise"
...
}
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/laps.php?id=950
Afficher toutes les inscriptions d'un Participant
Il est possible d'afficher l'ensemble des inscriptions d'un Participant sur l'ensemble des Actions de Formation en indiquant uniquement l'id_participant
.
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_participant=117
Il est également possible d'enrichir les informations de chaque inscription d'un Participant via le paramètre include=lmps
afin de voir le détail des Modules (via l'id_lam
) auxquels le Participant est inscrit pour chaque Action de Formation.
Exemple : GET https://pro.dendreo.com/demo/api/laps.php?id_participant=117&include=lmps
{
"id_lap": "950",
"id_action_de_formation": "330",
"id_entreprise": "170",
"id_participant": "117",
"satisfaction_status": "0",
"status": "1",
"source": "dendreo",
"inscription_lmp": "1",
"id_groupe": "1",
"lmps": [
{
"id_lmp": "182",
"id_lam": "799",
"status": "1",
"prix": "670.00",
"prix_personnalise": "1",
"total_heures_presence": "0.00"
}
],
"participant" : {
"id_participant": "117",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru",
"prenom": "Françoise"
...
}
},
{
"id_lap": "992",
"id_action_de_formation": "451",
"id_entreprise": "170",
"id_participant": "117",
"satisfaction_status": "0",
"status": "1",
"source": "dendreo",
"inscription_lmp": "1",
"id_groupe": "1",
"lmps": [
{
"id_lmp": "234",
"id_lam": "832",
"status": "1",
"prix": "670.00",
"prix_personnalise": "1",
"total_heures_presence": "0.00"
}
],
"participant" : {
"id_participant": "117",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"civilite": "Mme",
"nom": "Duru",
"prenom": "Françoise"
...
}
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/laps.php?id_participant=117
Ajouter / Editer une Inscription
Il est par ailleurs possible d'ajouter un Participant "Non identifié" (à renseigner ultérieurement dans Dendreo) en ne renseignant pas l'id_participant
(En Inter, un id_entreprise est requis).
Vous pouvez également ajouter plusieurs participants non identifiés d'un coup en précisant le paramètre nb_participants_anonymes
{
"id_lap": "950",
"id_action_de_formation": "330",
"id_entreprise": "170",
"id_participant": "0",
"satisfaction_status": "0",
"status": "1",
"source": "dendreo",
"inscription_lmp": "1",
"id_groupe": "1",
"total_heures_presence": "3",
"presence_percent": "42.86",
"total_heures_absence": "4",
"absence_percent": "57.14",
"presence": "INC."
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lap | non | ID du Lap (si vide -> inscription du Participant à l'ADF, sinon -> édition de l'inscription existante) |
id_action_de_formation | oui | ID action de formation (existence vérifiée) |
id_participant | non | ID participant (existence vérifiée, entreprise vérifiée) |
id_entreprise | non | sauf si id_participant non fourni en Inter : ID entreprise (existence vérifiée) |
id_groupe | non | ID du groupe auquel rattacher le Lap |
prix | non | Prix personnalisé par Participant (Valable uniquement dans le cas où l'action de formation ne contient qu'un seul Module) |
nb_participants_anonymes | non | Permet d'ajouter des Participants anonymes (ne pas préciser id_participant dans ce cas) |
Autres paramètres optionnels
Intitulé | Description |
---|---|
marquer_present | Si vaut "true", le Participant est marqué présent à tous les créneaux déjà passés |
disable_inscription_auto | Si ce paramètre est à 1, alors le Lap est ajouté mais il n'est pas inscrit aux Modules de formation |
force_sync_lms | Si ce paramètre est à 1, alors en cas de Module e-learning avec synchronisation LMS, l'inscription sur la plateforme est faite immédiatement, au lieu d'être faite à la date de début de la formation. Notez que si la formation a déjà commencé, il est nécessaire de passer ce paramètre à 1 si vous souhaitez que l'inscription côté LMS soit faite automatiquement. |
Requête HTTP
POST https://pro.dendreo.com/demo/api/laps.php
Supprimer une Inscription
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/laps.php?id_lap=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lap | oui | ID Lap (existence vérifiée) |
Réponses aux Questionnaires de Satisfaction
Lister les Réponses aux questionnaires
Accède à toutes les Réponses aux questionnaires de satisfaction en fonction d'un filtre.
Attention, au moins 1 filtre est obligatoire
Exemple : GET https://pro.dendreo.com/demo/api/reponses_questionnaire_satisfaction.php?id_action_de_formation=949
[
{
"id_reponse_satisfaction": "146",
"date_add": "2022-12-19 14:49:40",
"date_edit": "2022-12-19 14:49:40",
"id_question_satisfaction": "4",
"id_lam": "1354",
"id_laf": "0",
"note": "5",
"amplitude_notation": "6",
"texte": "",
"question_liste_choix_id": "",
"subsubject_type": "",
"subsubject_id": "",
"owner_type": "Models\\Lap",
"owner_id": "4227",
"notation_normalise": "83",
"id_action_de_formation": "949",
"module": {
"id_module": "308",
"intitule": "Anglais",
"numero_complet": "MOD_2022006"
},
"participant": {
"id_participant": "2002",
"date_add": "2022-08-23 16:29:11",
"id_add": "0",
"date_edit": "2022-08-23 16:29:11",
"id_edit": "0",
"civilite": "Mme.",
"nom": "Lebreton",
"prenom": "Adrienne",
"..." :
}
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/reponses_questionnaire_satisfaction.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_reponse_satisfaction | non | ID de la réponse (séparé par des virgules) |
id_question_satisfaction | non | Filtrer sur les l'ID du questionnaire (séparé par des virgules) |
id_action_de_formation | non | Filtrer sur les l'ID des Actions de Formation (séparé par des virgules) |
id_lam | non | Filtrer sur les l'ID des LAMs (séparé par des virgules) |
id_module | non | Filtrer sur les l'ID des Modules (séparé par des virgules) |
id_laf | non | Filtrer sur les l'ID du Staffing des Formateurs (séparé par des virgules) |
id_formateur | non | Filtrer sur les l'ID des Formateurs (séparé par des virgules) |
id_salle_de_formation | non | Filtrer sur les l'ID des Salles de Formation (séparé par des virgules) |
Entreprises liées
Lister toutes les Entreprises d'une Action De Formation
[
{
"id_lae": "876",
"id_add": "0",
"date_add": "2019-10-08 14:18:52",
"id_edit": "0",
"date_edit": "2019-10-08 14:18:52",
"id_action_de_formation": "538",
"id_entreprise": "551",
"mode_financement": "entreprise",
"id_contact": "",
"entreprise": {
"id_entreprise": "551",
"numero": "6",
"numero_complet": "ENT_2019006",
"siret": "",
"raison_sociale": "Monnier",
"...":
}
},
{
"id_lae": "877",
"id_add": "0",
"date_add": "2019-10-08 14:19:15",
"id_edit": "0",
"date_edit": "2019-10-08 14:19:15",
"id_action_de_formation": "532",
"id_entreprise": "551",
"mode_financement": "entreprise",
"id_contact": "",
"entreprise": {
"id_entreprise": "551",
"numero": "6",
"numero_complet": "ENT_2019006",
"siret": "",
"raison_sociale": "Monnier",
"...":
}
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/laes.php?id_action_de_formation=532
Afficher un lien Action de Formation <-> Entreprise (Lae)
Requête HTTP
GET https://pro.dendreo.com/demo/api/laes.php?id=877
Editer le Contact d'une Entreprise pour une Action De Formation
Il est possible de modifier le Contact associé à une Entreprise dans le cadre d'une Action De Formation particulière.
{
"id_lae": "876",
"id_add": "0",
"date_add": "2019-10-08 14:18:52",
"id_edit": "0",
"date_edit": "2019-10-09 15:27:48",
"id_action_de_formation": "538",
"id_entreprise": "551",
"mode_financement": "entreprise",
"id_contact": "386",
"entreprise": {
"id_entreprise": "551",
"numero": "6",
"numero_complet": "ENT_2019006",
"siret": "",
"raison_sociale": "Monnier",
"...":
}
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lae | oui | ID du lien Action de Formation <-> Entreprise |
id_contact | oui | ID contact (existence vérifiée, même entreprise obligatoire) |
Requête HTTP
POST https://pro.dendreo.com/demo/api/laes.php
Intervention d'un Formateur
Lister tous les Formateurs intervenants dans une Action de Formation
[
{
"id_laf": "62",
"date_add": "2021-02-18 10:46:10",
"id_add": "2",
"date_edit": "2021-02-18 10:48:44",
"id_edit": "2",
"id_action_de_formation": "51",
"id_formateur": "8",
"referent": "1",
"statut": "travailleur_independant",
"statut_bpf": "interieur", //interieur, exterieur
"id_entreprise": "6",
"id_contact": "",
"participant_evaluation_mode": "",
"tva": "",
"formateur": {
"id_formateur": "8",
"date_add": "2021-02-17 15:26:06",
"id_add": "2",
"date_edit": "2022-01-20 10:26:08",
"id_edit": "0",
"id_delete": "0",
"user_id": "",
"anonyme": "0",
"numero": "4",
"numero_complet": "FORM_20210004",
"...": ""
}
},
"...": ""
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lafs.php?id_action_de_formation=51
Vous pouvez également inclure la liste des Budgets liés à ces interventions de Formateurs en ajoutant le
paramètre include=budgets
Lister toutes les interventions d'un Formateur
[
{
"id_laf": "62",
"date_add": "2021-02-18 10:46:10",
"id_add": "2",
"date_edit": "2021-02-18 10:48:44",
"id_edit": "2",
"id_action_de_formation": "51",
"id_formateur": "8",
"referent": "1",
"statut": "travailleur_independant",
"statut_bpf": "interieur",
"id_entreprise": "6",
"id_contact": "",
"participant_evaluation_mode": "",
"tva": "",
"formateur": {
"id_formateur": "8",
"date_add": "2021-02-17 15:26:06",
"id_add": "2",
"date_edit": "2022-01-20 10:26:08",
"id_edit": "0",
"id_delete": "0",
"user_id": "",
"anonyme": "0",
"numero": "4",
"numero_complet": "FORM_20210004",
"...":
}
},
{
"id_laf": "64",
"date_add": "2021-03-12 15:27:36",
"id_add": "0",
"date_edit": "",
"id_edit": "0",
"id_action_de_formation": "55",
"id_formateur": "8",
"referent": "1",
"statut": "travailleur_independant",
"statut_bpf": "Personne extérieure (prestation de service, sous-traitance, honoraires)",
"id_entreprise": "6",
"id_contact": "",
"participant_evaluation_mode": "",
"tva": "20",
"formateur": {
"id_formateur": "8",
"date_add": "2021-02-17 15:26:06",
"id_add": "2",
"date_edit": "2022-01-20 10:26:08",
"id_edit": "0",
"id_delete": "0",
"user_id": "",
"anonyme": "0",
"numero": "4",
"numero_complet": "FORM_20210004",
"...":
}
},
"...":
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lafs.php?id_formateur=8
Vous pouvez également inclure la liste des Budgets liés à ces interventions de Formateurs en ajoutant le
paramètre include=budgets
Afficher le détail d'une intervention d'un Formateur
{
"id_laf": "62",
"date_add": "2021-02-18 10:46:10",
"id_add": "2",
"date_edit": "2021-02-18 10:48:44",
"id_edit": "2",
"id_action_de_formation": "51",
"id_formateur": "8",
"referent": "1",
"statut": "travailleur_independant",
"statut_bpf": "interieur",
"id_entreprise": "6",
"id_contact": "",
"participant_evaluation_mode": "",
"tva": "",
"formateur": {
"id_formateur": "8",
"date_add": "2021-02-17 15:26:06",
"id_add": "2",
"date_edit": "2022-01-20 10:26:08",
"id_edit": "0",
"id_delete": "0",
"user_id": "",
"anonyme": "0",
"numero": "4",
"numero_complet": "FORM_20210004",
"...":
}
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/lafs.php?id=62
Vous pouvez également inclure la liste des Budgets liés à ces interventions de Formateurs en ajoutant le
paramètre include=budgets
Créer une intervention pour un Formateur
Si la configuration Staffer automatiquement un Formateur sur tous les Modules
est à "Oui", le Formateur sera automatiquement staffé sur tous les Créneaux de tous les Modules de l'Action de formation.
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_formateur | oui si pas id_entreprise_formateur | ID du Formateur |
id_entreprise_formateur | oui si pas id_formateur | ID de l'entreprise sous-traitante |
id_action_de_formation | oui | ID action de formation |
autres | non | Tous les autres champs qui sont disponibles hormis "statut", "participant_evaluation_mode", "tva" et "id_entreprise" |
remuneration_horaire | non | Par défaut, est appliquée sur l'ensemble de l'ADF, ou sur chacun des Lams si le champ "Rémunération de Formateurs par Module" de l'ADF est à "Oui" |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lafs.php
Modifier une intervention d'un Formateur
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_laf | oui | ID du staffing de Formateur |
autres | non | Tous les autres champs qui sont disponibles |
remuneration_horaire | non | Par défaut, est appliquée sur l'ensemble de l'ADF, ou sur chacun des Lams si le champ "Rémunération de Formateurs par Module" de l'ADF est à "Oui" |
Attention, il n'est pas possible de modifier les champs : id_action_de_formation, id_formateur, statut, participant_evaluation_mode, tva et id_entreprise.
Requête HTTP
POST https://pro.dendreo.com/demo/api/lafs.php
Supprimer l'intervention d'un Formateur
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_laf | oui | ID du staffing |
Attention, un staffing ne peut pas être supprimé si il y a un émargement ou une Facture associée !
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/lafs.php
Intervention d'un Formateur par créneau
Lister les interventions des formateurs aux créneaux
Vous pouvez filtrer les résultats en fonction des paramètres suivants :
id_action_de_formation
, id_laf
, id_creneau
, id_formateur
, id_module
, id_lmf
Il est possible d'ajouter à la réponse les informations du Formateur via le paramètre include=formateur
.
Exemple : GET https://pro.dendreo.com/demo/api/lcfs.php?id_action_de_formation=330&include=formateur
Il est également possible d'afficher les données du Module :
Exemple : GET https://pro.dendreo.com/demo/api/lcfs.php?id_action_de_formation=330&include=module
Il est également possible d'afficher les données de l'Action de Formation :
Exemple : GET https://pro.dendreo.com/demo/api/lcfs.php?id_action_de_formation=330&include=formation
Enfin, si vous voulez encore plus de détail vous pouvez inclure les informations du créneau :
Exemple : GET https://pro.dendreo.com/demo/api/lcfs.php?id_action_de_formation=330&include=creneau
Vous pouvez aussi utiliser plusieurs paramètres conjointement : include=formateur,module,...
[
{
"id_lcf": "971",
"date_add": "2022-06-03 16:23:40",
"id_add": "0",
"date_edit": "2022-06-10 13:24:44",
"id_edit": "0",
"id_creneau": "3386",
"id_laf": "248",
"id_lmf": "271",
"status": "1",
"nb_heures": "3.000",
"role_id": "",
"formateur_factures_id": "",
"invoiced_at": "",
"rsvp_uuid": "",
"rsvp_status": "",
"rsvp_sent_at": "",
"rsvp_notes": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lcfs.php?id_action_de_formation=330
Afficher l'intervention à un créneau pour un Formateur
[
{
"id_lcf": "971",
"date_add": "2022-06-03 16:23:40",
"id_add": "0",
"date_edit": "2022-06-10 13:24:44",
"id_edit": "0",
"id_creneau": "3386",
"id_laf": "248",
"id_lmf": "271",
"status": "1",
"nb_heures": "3.000",
"role_id": "",
"formateur_factures_id": "",
"invoiced_at": "",
"rsvp_uuid": "",
"rsvp_status": "",
"rsvp_sent_at": "",
"rsvp_notes": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lcfs.php?id=971
Créer une intervention à un Créneau pour un Formateur
[
{
"id_lcf": "971",
"date_add": "2022-06-03 16:23:40",
"id_add": "0",
"date_edit": "2022-06-10 13:24:44",
"id_edit": "0",
"id_creneau": "3386",
"id_laf": "248",
"id_lmf": "271",
"status": "1",
"nb_heures": "3.000",
"role_id": "",
"formateur_factures_id": "",
"invoiced_at": "",
"rsvp_uuid": "",
"rsvp_status": "",
"rsvp_sent_at": "",
"rsvp_notes": ""
}
]
Paramètres
Intitule | Obligatoire | Description |
---|---|---|
id_creneau | oui | ID du Créneau (existence vérifiée) |
id_laf | oui si ni id_formateur ni id_entreprise_formateur ne sont fournis | ID du lien Action de formation <-> Formateur au sein d'une Action De Formation (existence vérifiée) |
id_formateur | oui si ni id_laf ni id_entreprise_formateur ne sont fournis | ID du Formateur (existence vérifiée). Le Formateur est staffé sur l'Action de formation si ce n'est pas déjà le cas. |
id_entreprise_formateur | oui si ni id_laf ni id_formateur ne sont fournis | ID de l'Entreprise sous-traitante (existence vérifiée). Un Formateur anonyme pour l'entreprise sous-traitante est staffé sur l'Action de formation si ce n'est pas déjà le cas. Attention : zéro ou un seul Formateur anonyme de cette Entreprise doit être staffé, sinon il faut utiliser l'id_laf ou l'id_formateur correspondant. |
status | non | Si mis à "true", le Lcf est staffé à 100% (nombre d'heure total du créneau). Si mis à "false", le Lcf est déstaffé (nombre d'heure = 0) |
nb_heures | non | Est pris en compte seulement si "status" vaut "true". Défini le nombre d'heures à staffer (ne peut pas dépasser le nombre d'heures totales du Créneau) |
date_facture | non | Déclarer un LCF comme déjà facturé |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lcfs.php
Modifier une intervention à un Créneau pour un Formateur
[
{
"id_lcf": "971",
"date_add": "2022-06-03 16:23:40",
"id_add": "0",
"date_edit": "2022-06-10 13:24:44",
"id_edit": "0",
"id_creneau": "3386",
"id_laf": "248",
"id_lmf": "271",
"status": "1",
"nb_heures": "3.000",
"role_id": "",
"formateur_factures_id": "",
"invoiced_at": "",
"rsvp_uuid": "",
"rsvp_status": "",
"rsvp_sent_at": "",
"rsvp_notes": "",
}
]
Paramètres
Intitule | Obligatoire | Description |
---|---|---|
id_lcf | oui si au moins l'un des couples (id_creneau, id_laf) ou (id_creneau, id_formateur) ou (id_creneau, id_entreprise_formateur) n'est pas fourni | ID du Lcf (existence vérifiée) |
id_creneau | oui si id_lcf n'est pas fourni | ID du lien Créneau <-> Formateur au sein d'une Action de formation (existence vérifiée) |
id_laf | oui si id_lcf, id_formateur, id_entreprise_formateur ne sont pas fournis | ID du lien Action de formation <-> Formateur au sein d'une Action De Formation (existence vérifiée) |
id_formateur | oui si id_lcf, id_laf, id_entreprise_formateur ne sont pas fournis | ID du Formateur (existence vérifiée). Le Formateur est staffé sur l'Action de formation si ce n'est pas déjà le cas. |
id_entreprise_formateur | oui si id_lcf, id_laf, id_formateur ne sont pas fournis | ID de l'Entreprise sous-traitante (existence vérifiée). Un Formateur anonyme pour l'entreprise sous-traitante est staffé sur l'Action de formation si ce n'est pas déjà le cas. Attention : zéro ou un seul Formateur anonyme de cette Entreprise doit être staffé, sinon il faut utiliser l'id_laf ou l'id_formateur correspondant. |
status | non | Si mis à "true", le Lcf est staffé à 100% (nombre d'heure total du créneau). Si mis à "false", le Lcf est déstaffé (nombre d'heure = 0) |
nb_heures | non | Est pris en compte seulement si "status" vaut "true". Défini le nombre d'heures à staffer (ne peut pas dépasser le nombre d'heures totales du Créneau) |
date_facture | non | Déclarer un LCF comme déjà facturé |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lcfs.php
Programmation d'un module
Afficher les programmations d'une action de formation
Sélectionnez l'Action de Formation via id_action_de_formation
.
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id_action_de_formation=882
Vous pouvez aussi filtrer les résultats par Module :
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id_module=175
[
{
"id_lam": "1195",
"date_add": "2023-04-25 16:31:24",
"id_add": "0",
"date_edit": "2023-04-26 10:53:55",
"id_edit": "0",
"id_action_de_formation": "882",
"id_module": "175",
"id_categorie_produit": "1",
"intitule": "Cours Laravel",
"date_debut": "2023-04-26 09:00:00",
"date_fin": "2023-04-27 17:00:00",
"duree": "50400",
"prix": "500.0000",
"prix_edof": "",
"prix_achat": "0.0000",
"id_shadow_lam": "0",
"dual_lam_id": "",
"quantite": "1.00",
"id_salle_de_formation": "0",
"duree_planifiee": "",
"mode_organisation": "presentiel",
"satisfaction_evaluable": "1",
"evaluation_evaluable": "1",
"duree_de_validite": "0",
"visible_on_cp_in_adf_mm": "0",
"dokeos_training_gate_id": "",
"master_lam_id": "",
"nb_participants_min": "1",
"nb_participants_max": "10",
"intitule_module": "Cours Laravel",
"description": "",
"formateurs": [
{
"id_laf": "750",
"id_lmf": "1066",
"id_formateur": "8",
"civilite": "M.",
"nom": "Banksto",
"prenom": "Arlen",
"email_pro": "arlen.bankston@lithespeed.com",
"email_perso": ""
}
]
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lams.php
Afficher une programmation
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195
Le champ id_salle_de_formation
correspond à la salle qui a été lié au Lam durant sa programmation, selon le contexte, cela peut être la Salle de l'Action de formation, la Salle par défaut du Module, ou une valeur vide.
Cependant s'il y a des Créneaux sur le Lam, il est pertinent de récupérer les Salles liées à ces Créneaux, pour cela, il est possible d'ajouter le paramètre include=lieux
.
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195&include=lieux
Il est également possible d'ajouter à la réponse les informations des Participants via le paramètre include=participants
.
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195&include=participants
Il est également possible d'afficher les données du Module :
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195&include=module
Des LMPs :
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195&include=lmps
Ou des Créneaux :
Exemple : GET https://pro.dendreo.com/demo/api/lams.php?id=1195&include=creneaux
Vous pouvez aussi utiliser plusieurs paramètres conjointement : include=participants,modules,...
[
{
"id_lam": "1195",
"date_add": "2023-04-25 16:31:24",
"id_add": "0",
"date_edit": "2023-04-26 10:53:55",
"id_edit": "0",
"id_action_de_formation": "882",
"id_module": "175",
"id_categorie_produit": "1",
"intitule": "Cours Laravel",
"date_debut": "2023-04-26 09:00:00",
"date_fin": "2023-04-27 17:00:00",
"duree": "50400",
"prix": "500.0000",
"prix_edof": "",
"prix_achat": "0.0000",
"id_shadow_lam": "0",
"dual_lam_id": "",
"quantite": "1.00",
"id_salle_de_formation": "0",
"duree_planifiee": "",
"mode_organisation": "presentiel",
"satisfaction_evaluable": "1",
"evaluation_evaluable": "1",
"duree_de_validite": "0",
"visible_on_cp_in_adf_mm": "0",
"dokeos_training_gate_id": "",
"master_lam_id": "",
"nb_participants_min": "1",
"nb_participants_max": "10",
"intitule_module": "Cours Laravel",
"description": "",
"formateurs": [
{
"id_laf": "750",
"id_lmf": "1066",
"id_formateur": "8",
"civilite": "M.",
"nom": "Banksto",
"prenom": "Arlen",
"email_pro": "arlen.bankston@lithespeed.com",
"email_perso": ""
}
],
"participants": [
{
"id_lap": "3911",
"id_lmp": "6246",
"id_participant": "707",
"civilite": "M.",
"nom": "Ababou",
"prenom": "Jamal",
"email": "jamalabadou@yahoo.com"
}
]
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lams.php?id=474
Ajouter une programmation
{
"id_lam": "197",
"id_action_de_formation": "330",
"id_module": "17",
"quantite": "0",
"prix": "0.00",
"prix_achat": "0.00",
"id_shadow_lam": "0"
}
Option "Multi-Produits"
Par défaut, l'option "Multi-Produits" n'est pas activée sur Dendreo, tous les modules correspondent donc à de la formation.
Si l'option Multi-Produits est activée, et que vous souhaitez programmer un module qui n'est pas de la formation mais qui a l'option hors_formation_dates
activée (produit ayant des dates), il faudra renseigner les paramètres date_debut
et date_fin
. Ces deux paramètres sont optionnels si le produit est réglé sur hors_formation_dates
à 0.
Par ailleurs, si un produit a des dates ET si l'option hors_formation_prix_par_jour
est désactivée (produit non configuré en tarification par jour), vous pouvez utiliser l'attribut quantite
. Si hors_formation_prix_par_jour
est réglé à 1 sur le produit, la quantité est automatiquement égale à la durée du produit en jours.
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_action_de_formation | oui | ID Action de Formation (existence vérifiée) |
id_module | oui | ID Module (existence vérifiée) |
date_debut | oui* | Date de début (format vérifié : "AAAA-MM-JJ") *Sauf en Multi-Produits, si l'option hors_formation_dates est désactivée sur le produit concerné |
date_fin | non* | Date de fin (format vérifié : "AAAA-MM-JJ"). *Sauf en Multi-Produits, si l'option hors_formation_dates est activée sur le produit concerné. Vous pouvez également passer une date de fin pour un Module en planification progressive ou pour un Module e-learning |
duree | non | Durée en heures. Permet de faire de la planification progressive |
id_formateur | non | ID du Formateur à staffer (si non fourni, le Formateur par défaut du Module -s'il est défini- sera staffé. Renseignez la valeur null ou 0 pour ne pas staffer le Formateur par défaut du Module) |
id_entreprise_formateur | non | ID de l'Entreprise sous-traitante à staffer (si non fourni, l'Entreprise sous-traitante par défaut du Module -si elle est définie- sera staffée. Renseignez la valeur null ou 0 pour ne pas staffer l'Entreprise sous-traitante par défaut du Module) |
prix | non | Prix |
prix_achat | non | Prix d'achat |
quantite | non* | Quantité *Sauf si l'option hors_formation_prix_par_jour (tarification à la journée) est désactivée sur le module concerné |
id_salle_de_formation | non | ID de la Salle. Si vide, la Salle programmée pour l'ADF sera utilisée, le cas échéant, ou alors la Salle par défaut du Module. |
intitule | non | Intitulé surchargeant l'intitulé du Module |
remuneration | non | Prix de rémunération du formateur par LAM (Nécessite que l'option "Rémunération des Formateurs par Module" soit active sur l'ADF et qu'un id_formateur et/ou id_entreprise_formateur soit également fourni) |
num_unite_dpc | non | Numéro d'unité DPC : valeur modifiable si l'option "Affichage des options DPC sur les ADFs et Participants" est activé |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lams.php
Ajouter une séance alternative
Permet de créer une séance alternative pour cette programmation . Sous reserve que l'option multi-séance soit activée sur votre compte et que cela concerne un Module de Formation (hors e-learning)
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lam | oui | ID du Lam sur lequel on souhaite ajouter une séance alternative |
create_shadow | oui | 1 ou true |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lams.php
Supprimer une programmation
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/lams.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lam | oui | ID Lam (existence vérifiée) |
Gérer les inscriptions aux modules
Un Lmp représente le lien entre un Participant et un Module, au sein d'une Action De Formation
En d'autres termes, c'est un lien entre un Lap et un Lam
Note importante : tous les Lmp sont créés en même temps que les Laps. C'est à dire que dès qu'un Participant est ajouté à une Action de Formation (Lap), tous les Lmp relatifs aux Modules (Lam) sont créés.
Lorsque l'Action de Formation ne comporte qu'un seul Module, le champ
status
est automatiquement réglé à 1.Lorsque l'Action de Formation comporte plusieurs Modules, le champ
status
est réglé en fonction de la configuration suivante sur Dendreo:Inscrire automatiquement un Participant à tous les Modules
Lister les inscriptions des participants aux modules
Vous pouvez filtrer les résultats en fonction des paramètres suivants :
id_action_de_formation
, id_lap
, id_lam
, id_participant
, id_module
Il est possible d'ajouter à la réponse les informations du Participant via le paramètre include=participant
.
Exemple : GET https://pro.dendreo.com/demo/api/lmps.php?id_action_de_formation=330&include=participant
Il est également possible d'afficher les données du Module :
Exemple : GET https://pro.dendreo.com/demo/api/lmps.php?id_action_de_formation=330&include=module
Si vous voulez encore plus de détail vous pouvez inclure les lcps (créneaux) :
Exemple : GET https://pro.dendreo.com/demo/api/lmps.php?id_action_de_formation=330&include=lcps
Enfin, il est également possible de consulter les évaluations des modules & des compétences associées :
Exemple : GET https://pro.dendreo.com/demo/api/lmps.php?id_action_de_formation=330&include=evaluation
Vous pouvez aussi utiliser plusieurs paramètres conjointement : include=participant,module,...
[
{
"id_lmp": "3093",
"date_add": "2019-11-28 16:31:54",
"id_add": "0",
"date_edit": "2019-12-03 09:58:49",
"id_edit": "0",
"id_lam": "674",
"id_lap": "2356",
"status": "0",
"prix": "100.0000",
"prix_personnalise": "0",
"total_heures_presence": "0.000",
"total_heures_absence": "0.000",
"duree_de_validite": "",
"recyclage_id": "",
"custom_properties": "",
"lms_progression": "",
"lms_started_at": "",
"lms_last_access_at": "",
"lms_completed_at": "",
"duree_de_validite": "",
"lms_tempspasse": "",
"master_lmp_id": "",
"is_thinkific_conflicted": "0",
"moyenne_satisfaction": "",
"satisfaction_nb_avis": "0",
"is_evaluated": "1",
"has_pre_auto_positionnements": "0",
"has_post_auto_positionnements": "0",
"evaluation_count": "1",
"budget": "",
"master_lmp": ""
},
{
"id_lmp": "3094",
"date_add": "2019-11-28 16:31:58",
"id_add": "0",
"date_edit": "2019-12-03 09:59:12",
"id_edit": "0",
"id_lam": "674",
"id_lap": "2357",
"status": "0",
"prix": "150.0000",
"prix_personnalise": "1",
"total_heures_presence": "4.000",
"total_heures_absence": "0.000",
"duree_de_validite": "",
"recyclage_id": "",
...
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lmps.php?id_action_de_formation=330
Afficher une inscription à un module
{
"id_lmp": "3093",
"date_add": "2019-11-28 16:31:54",
"id_add": "0",
"date_edit": "2019-12-03 09:58:49",
"id_edit": "0",
"id_lam": "674",
"id_lap": "2356",
"status": "0",
"prix": "100.0000",
"prix_personnalise": "0",
"total_heures_presence": "0.000",
"total_heures_absence": "0.000",
"duree_de_validite": "",
"recyclage_id": "",
...
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/lmps.php?id=3093
Modifier l'inscription d'un participant pour un module
{
"id_lmp": "3932",
"date_add": "2022-12-02 10:52:58",
"id_add": "0",
"date_edit": "2022-12-02 10:52:59",
"id_edit": "0",
"id_lam": "1129",
"id_lap": "741",
"status": "1",
"prix": "100.0000",
"prix_personnalise": "0",
"total_heures_presence": "0.000",
"total_heures_absence": "0.000",
"recyclage_id": "44",
...
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lmp | oui | ID du lien Participant <-> Module au sein d'une Action De Formation |
inscription | non | 1 ou 0 |
progression | non | Seulement pour le e-learning, progression en pourcentage |
prix | non | Prix personnalisé pour ce Lmp (seulement en Inter et si l'option est activée) |
validated | non | 1 ou 0 réussite ou non d'un Participant à un LMP |
note | non | décimal |
amplitude_notation | non | entier |
appreciation | non | text |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lmps.php
Gérer la présence des participants
Un LCP représente le lien entre le Créneau d'un Module de formation et un participant, au sein d'une Action De Formation
En d'autres termes, c'est un lien entre un Lap, un LMP et un Créneau
Note importante : tous les LCPs sont créés en même temps que les LAPs. C'est à dire que dès qu'un Participant est ajouté à une Action de Formation (LAP), tous les LMP relatifs aux Modules (LAM) sont créés et tous les LCP relatifs aux Créneaux de ces Modules également.
Lister les présences des participants aux créneaux
Vous pouvez filtrer les résultats en fonction des paramètres suivants :
id_action_de_formation
, id_lap
, id_creneau
, id_participant
, id_module
Il est possible d'ajouter à la réponse les informations du Participant via le paramètre include=participant
.
Exemple : GET https://pro.dendreo.com/demo/api/lcps.php?id_action_de_formation=330&include=participant
Il est également possible d'afficher les données du Module :
Exemple : GET https://pro.dendreo.com/demo/api/lcps.php?id_action_de_formation=330&include=module
Enfin, si vous voulez encore plus de détail vous pouvez inclure les informations du créneau :
Exemple : GET https://pro.dendreo.com/demo/api/lcps.php?id_action_de_formation=330&include=creneau
Vous pouvez aussi utiliser plusieurs paramètres conjointement : include=participant,module,...
[
{
"id_lcp": "7483",
"date_add": "2012-12-18 17:33:19",
"id_add": "2",
"date_edit": "2019-02-06 17:55:39",
"id_edit": "2",
"id_creneau": "873",
"id_lmp": "1858",
"id_lap": "1607",
"presence": "1",
"total_heures_presence": "2.5",
"total_heures_absence": "0",
"justified": "0",
"justification": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/lcps.php?id_action_de_formation=330
Afficher la présence à un créneau pour un participant
{
"id_lcp": "7483",
"date_add": "2012-12-18 17:33:19",
"id_add": "2",
"date_edit": "2019-02-06 17:55:39",
"id_edit": "2",
"id_creneau": "873",
"id_lmp": "1858",
"id_lap": "1607",
"presence": "1",
"total_heures_presence": "2.5",
"total_heures_absence": "0",
"justified": "0",
"justification": ""
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/lcps.php?id=7483
Modifier la présence d'un participant pour un créneau
{
"id_lcp":"13346",
"date_add":"2020-02-12 11:21:35",
"id_add":"0",
"date_edit":"2020-11-30 12:00:23",
"id_edit":"0",
"id_creneau":"2870",
"id_lmp":"3107",
"id_lap":"2366",
"presence":"1",
"total_heures_presence": "2.5",
"total_heures_absence": "0",
"justified":"0",
"justification":""
}
Pour effectuer la modification vous pouvez fournir soit : * un id_lcp * un id_creneau + id_lap * un id_creneau + id_participant
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lcp | oui si au moins l'un des couples id_creneau + id_lap ou id_creneau + id_participant n'est pas fourni | ID du lien Participant <-> Créneau au sein d'une Action De Formation |
id_creneau | oui si id_lcp n'est pas fourni | ID du lien Créneau <-> Participant au sein d'une Action de formation (existence vérifiée) |
id_lap | oui si id_participant n'est pas fourni | ID du lien Action de formation <-> Participant (existence vérifiée) |
id_participant | oui si id_lap n'est pas fourni | ID du Participant (existence vérifiée) |
presence | non | 1 ou 0 |
duree | non | En cas de présence ou absence partielle. Durée en heures. Si non précisée, la durée complète du créneau sera prise en compte. |
justified | non | 1 ou 0 selon si l'absence est justifiée ou non |
justification | non | texte de justification de l'absence |
Requête HTTP
POST https://pro.dendreo.com/demo/api/lcps.php
Pour indiquer un participant comme présent, renvoyer l'attribut presence à 1 Pour indiquer une absence, renvoyer l'attribut justified à 1 pour une absence justifiée, 0 pour une absence non-justifiée Pour annuler l'enregistrement d'une présence/absence, refaire un appel avec l'attribut presence de la même valeur que son état actuel (1 pour présence, 0 pour absence).
Évaluations des Participants
Les Évaluations se font à 2 niveaux : - au niveau de chaque Module auquel le Participant est inscrit pour une ADF (Lmp) - au niveau des Compétences de chaque Module auquel le Participant est inscrit pour une ADF
Lister les Évaluations des Modules
Vous pouvez filtrer les résultats en fonction des paramètres suivants :
id
, id_lmp
, id_action_de_formation
, id_participant
, id_module
Il est possible d'ajouter à la réponse les informations du Participant via le paramètre include=participant
.
Exemple : GET https://pro.dendreo.com/demo/api/evaluations?id_action_de_formation=330&include=participant
Il est également possible d'afficher les évaluations liées aux compétences :
Exemple : GET https://pro.dendreo.com/demo/api/evaluations.php?id_action_de_formation=293&include=competences,participant
[
{
"id_lmp": "1369",
"id_action_de_formation": "293",
"id_module": "15",
"id_participant": "113",
"id": "107",
"evaluation_set_id": "204",
"evaluator_type": "Models\\Formateur",
"evaluator_id": "6",
"note": "12.00",
"amplitude_notation": "20",
"appreciation": "qsdqsd",
"validated": "1",
"created_at": "2022-12-02 10:40:07",
"created_by_type": "",
"created_by_id": "",
"updated_at": "2022-12-02 10:40:19",
"updated_by_type": "Models\\SuperAdministrateur",
"updated_by_id": "18",
"deleted_at": "",
"deleted_by_type": "",
"deleted_by_id": "",
"id_evaluation": "27398",
"evaluation_name": "Evaluation 2",
"rattrapage": "",
"rattrapage_original_evaluation_set_id": ""
"competences": [
{
"id": "16",
"label": "Comp A",
"evaluation": {
"id": "61",
"evaluator_type": "Models\\Formateur",
"evaluator_id": "6",
"note": "14.00",
"amplitude_notation": "20",
"appreciation": "qsdqsd",
"status": "non-acquis",
"created_at": "2022-12-02T09:40:10.000000Z",
"created_by_type": "Models\\SuperAdministrateur",
"created_by_id": "18",
"updated_at": "2022-12-02T09:40:16.000000Z",
"updated_by_type": "Models\\SuperAdministrateur",
"updated_by_id": "18"
}
},
{
"id": "17",
"label": "Comp B",
"evaluation": {
"id": "62",
"evaluator_type": "Models\\Formateur",
"evaluator_id": "6",
"note": "",
"amplitude_notation": "20",
"appreciation": "",
"status": "en-cours",
"created_at": "2022-12-02T09:40:17.000000Z",
"created_by_type": "Models\\SuperAdministrateur",
"created_by_id": "18",
"updated_at": "2022-12-02T09:40:17.000000Z",
"updated_by_type": "Models\\SuperAdministrateur",
"updated_by_id": "18"
}
}
],
"participant": {
"id_participant": "113",
"date_add": "2021-12-24 15:16:11",
"id_add": "0",
"date_edit": "2022-12-13 09:51:17",
"id_edit": "0",
"civilite": "M.",
"nom": "Adama",
"prenom": "Lee",
"email": "lee@adama.com",
"commentaires": "",
"infos_adf": "rddfg",
"portable": "0102030405",
"fonction": "CEO",
"statut_bpf": "salarie",
"niveau_diplome": "",
"date_de_naissance": "",
"ville_naissance": "",
"departement_naissance": "",
"adresse": "",
"code_postal": "",
"ville": "",
"pays_alpha2": "",
"pays": "",
"id_entreprise": "34",
"particulier": "0",
"catalogue_entreprise": "",
"catalogue_entreprise_adresse": "",
"catalogue_entreprise_cp": "",
"catalogue_entreprise_ville": "",
"ogdpc_adeli": "",
"ogdpc_rpps": "",
"id_externe": "",
"moodle_user_id": "",
"thinkific_user_id": "",
"dokeos_user_id": "1234",
"ogdpc_id_specialite": "0",
"mode_dexercice_dominant": "",
"global_visible": "1",
"id_contact": "0",
"responsable_type": "",
"responsable_id": "",
"newsletter_optin": "0",
"message_extranet": "",
"nom_naissance": "",
"pays_naissance_alpha2": "",
"pays_naissance": "",
"num_forprev": "",
"language_code": "en"
}
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/evaluations.php?id_action_de_formation=293
Ajouter l'Évaluation d'un Participant sur un Module ou sur une Compétence
{
"id_lmp": "3931",
"id_action_de_formation": "293",
"id_module": "25",
"id_participant": "9",
"id": "111",
"evaluator_type": "",
"evaluator_id": "",
"note": "33.00",
"amplitude_notation": "38",
"appreciation": "Appréciation",
"validated": "1",
"created_at": "2022-12-29 11:56:27",
"created_by_type": "",
"created_by_id": "",
"updated_at": "2022-12-29 11:56:27",
"updated_by_type": "",
"updated_by_id": "",
"deleted_at": "",
"deleted_by_type": "",
"deleted_by_id": ""
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lmp | oui | ID du lien Participant <-> Module au sein d'une ADF (Lmp) |
id_action_de_formation | oui si id_lmp n'est pas fourni | ID de l'ADF concernée par l'évaluation |
id_module | oui si id_lmp n'est pas fourni | ID du Module à évaluer |
id_participant | oui si id_lmp n'est pas fourni | ID du Participant à évaluer |
id_competence | non | entier, ID de la Compétence, si renseigné, l'évaluation se fera sur la Compétence sinon, sur le Module |
id_formateur | non | entier, ID du formateur en charge de l'ADF ayant attribué l'évaluation |
validated | non | 0 ou 1 pour la réussite ou non d'un Participant à un Module (Lmp) |
status | non | "non-acquis", "acquis" ou "en-cours" pour l'acquisition ou non d'une Compétence |
note | non | entier |
amplitude_notation | non | entier |
appreciation | non | text |
Requête HTTP
POST https://pro.dendreo.com/demo/api/evaluations
Modifier l'évaluation d'un participant sur un module ou sur une compétence
{
"id_lmp": "1370",
"id_action_de_formation": "293",
"id_module": "15",
"id_participant": "9",
"id": "110",
"evaluator_type": "",
"evaluator_id": "",
"note": "33.00",
"amplitude_notation": "38",
"appreciation": "Appréciation",
"validated": "1",
"created_at": "2022-12-29 10:38:11",
"created_by_type": "",
"created_by_id": "",
"updated_at": "2022-12-29 11:47:37",
"updated_by_type": "Models\\SuperAdministrateur",
"updated_by_id": "27",
"deleted_at": "",
"deleted_by_type": "",
"deleted_by_id": ""
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_lmp | oui | ID du lien Participant <-> Module au sein d'une Action De Formation |
id_action_de_formation | oui si id_lmp n'est pas fourni | ID de l'ADF concernée par l'évaluation |
id_module | oui si id_lmp n'est pas fourni | ID du Module à évaluer |
id_participant | oui si id_lmp n'est pas fourni | ID du Participant à évaluer |
id_competence | non | ID de la Compétence, si renseigné, l'évaluation se fera sur la Compétence sinon, sur le Module |
id_formateur | non | ID du formateur en charge de l'ADF ayant attribué l'évaluation |
validated | non | 0 ou 1 pour la réussite ou non d'un Participant à un Module (Lmp) |
status | non | "non-acquis", "acquis" ou "en-cours" pour l'acquisition ou non d'une Compétence |
note | non | |
amplitude_notation | non | |
appreciation | non |
ATTENTION, cet endpoint d'API va prochainement évoluer. Merci de contacter le support si vous souhaitez la mettre en place !
Requête HTTP
POST https://pro.dendreo.com/demo/api/evaluations
Supprimer une Évaluation
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/evaluations.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_evaluation | oui | ID de l'Évaluation (existence vérifiée). Peut être plusieurs IDs séparés par des virgules : 12,13,14 … |
Souhaits des Participants
Un Souhait est l'expression du désir ou du besoin d'un Participant (de sa part ou de la part de son Entreprise) de réaliser un Module de Formation. Il s'agit donc d'associer des Participants à des Modules de Formation, en notant éventuellement une date d'échéance avant laquelle la formation souhaitée doit être réalisée.
Lister les Souhaits
[
{
"id": "2",
"participant_id": "1491",
"module_id": "55",
"deadline_at": "2021-04-17 23:59:59",
"created_at": "2021-03-19 14:25:48",
"wished_at": "2021-03-19 14:25:48",
"created_by_id": "2",
"created_by_type": "administrateur",
"updated_at": "2021-03-19 14:26:57",
"commentaire": "",
"lmp_ids": "",
"participant": {
"id_participant": "1491",
"nom": "Sabot",
"prenom": "Ludovic",
"adresse": "",
"code_postal": "",
"ville": "",
"portable": "",
"email": "sabot.ludovic@gmail.com",
"id_entreprise": "219",
"entreprise": {
"id_entreprise": "219",
"raison_sociale": "Bouygues Telecom"
}
},
"module": {
"id_module": "55",
"intitule": "Allemand",
"intitule_court": "",
"numero_complet": "MOD_2015007",
"id_categorie_module": "9",
"categorie": {
"id_categorie_module": "9",
"intitule": "Secourisme"
}
}
}
]
Vous pouvez filtrer les résultats en fonction des paramètres suivants :
Intitulé | Description |
---|---|
id | IDs des souhaits séparés par une virgule et sans espace |
participant_id | ID de participant |
module_id | ID du Module |
commentaire | Extrait du commentaire |
deadline_before | Date (YYYY-MM-DD), souhaité avant |
deadline_after | Date (YYYY-MM-DD), souhaité après |
date_add_before | Date (YYYY-MM-DD), souhaits créés avant |
date_add_after | Date (YYYY-MM-DD), souhaits créés après |
date_edit_before | Date (YYYY-MM-DD), souhaits édités avant |
date_edit_after | Date (YYYY-MM-DD), souhaits édités après |
created_by_id | Obligatoire si created_by_type |
created_by_type | {'administrateur'}, Obligatoire si created_by_id |
Il est possible d'ajouter à la réponse les informations du Module, du Participant et/ou des formations suivies exauçant
le Souhait, via le paramètre include
avec respectivement pour valeur module
, participant
, formation
et/ou module_compose
,
séparée par une virgule et sans espace.
S'il y a des champs personnalisés sur les Souhaits, ainsi que sur les Modules, les Participants et les Formations, alors ceux-ci seront inclus dans la réponse.
Requête HTTP
GET https://pro.dendreo.com/demo/api/souhaits.php?module_id=55&include=participant,module
Ajouter le Souhait d'un Participant pour un Module de formation
{
"participant_id": 1723,
"module_id": 6,
"commentaire": "Aurait besoin de renforcer ses compétences en langue anglaise. Souhaite s'inscrire sur une session en 2023, à distance.",
"deadline_at": "2023-12-31"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
participant_id | oui | ID du Participant |
module_id | oui | ID du Module |
commentaire | non | Texte |
deadline_at | non | Date (YYY-MM-DD) avant laquelle le souhait devrait être exaucé |
decompose_mc | non | true ou false pour décomposer le module en plusieurs souhaits |
Il est possible de renseigner les Champs Personnalisés qui sont configurés sur les Souhaits.
Requête HTTP
POST https://pro.dendreo.com/demo/api/souhaits
Modifier un Souhait
{
"id": "3",
"module_id": "7",
"commentaire": "Aurait besoin de renforcer ses compétences en langue allemande. Souhaite s'inscrire sur une session en 2023, à distance.",
"deadline_at": "2023-10-01"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | ID du Souhait |
participant_id | non | ID du Participant |
module_id | non | ID du Module |
commentaire | non | Texte |
deadline_at | non | Date (YYY-MM-DD) avant laquelle le souhait devrait être exaucé |
decompose_mc | non | true ou false pour décomposer le module en plusieurs souhaits |
Il est possible de modifier les Champs Personnalisés qui sont configurés sur les Souhaits.
Requête HTTP
POST https://pro.dendreo.com/demo/api/souhaits
Supprimer un Souhait
{
"id": "2,3"
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | IDs des souhaits séparés par une virgule et sans espace |
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/souhaits
Financeurs (externes)
Lister tous les financeurs
Il est possible de filtrer les financeurs sur l'attribut raison_sociale
en GET.
Exemple : GET https://pro.dendreo.com/demo/api/financeurs.php?raison_sociale=anfa
[
{
"id_opca": "2",
"opca": "1",
"raison_sociale": "AGEFOS-PME PACA",
"description": "FAF des petites et moyennes entreprises",
"cible": "",
"site_internet": "http://www.agefos-pme.org",
"adresse": "146 RUE PARADIS\r\nCS 30002",
"code_postal": "13294",
"ville": "MARSEILLE CEDEX 06",
"telephone": "0488445160",
"pays_alpha2": "fr",
"pays": "France"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/financeurs.php
Afficher un financeur
[
{
"id_opca": "2",
"opca": "1",
"raison_sociale": "AGEFOS-PME PACA",
"description": "FAF des petites et moyennes entreprises",
"cible": "",
"site_internet": "http://www.agefos-pme.org",
"adresse": "146 RUE PARADIS\r\nCS 30002",
"code_postal": "13294",
"ville": "MARSEILLE CEDEX 06",
"telephone": "0488445160",
"pays_alpha2": "fr",
"pays": "France"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/financeurs.php?id=1
Financements
Lister toutes les Financements
Accède à tous les financements présents sur Dendreo.
Il est possible d'afficher des données supplémentaires pour les Financements en renseignant le paramètre include
.
En ajoutant entreprise
(Entreprise bénéficiaire du Financement = lié à id_finance), financeur
(Financeur du Financement = lié à id_financeur), factures
(toutes les Factures liées à ce Financement), lfps
(LFP = Lien Financement Participant), vous pouvez obtenir directement des informations supplémentaires sur les Financements.
La paramètre lfps
vous donnera à la fois les LFPs, les LAPs liés à ces LFPs, et les Participants liés à ces LAPs.
Exemple : GET https://pro.dendreo.com/demo/api/financements.php?include=entreprise,financeur,factures,lfps
[
{
"id_financement": "790",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"id_action_de_formation": "39",
"type": "opca",
"categorie": "",
"id_finance": "522",
"id_financeur": "1",
"montant_finance": "2000",
"id_categorie_produit": "1",
"montant_finance_hors_formation": "0",
"montant_refacture": "0",
"numero_dossier": "",
"montant_total_finance": "2000",
"montant_total_facture": "2000",
"montant_total_paye": "0"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/financements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_action_de_formation | non | Filtrer sur les Financements d'une Action de Formation |
id_facture | non | Filtrer sur les Financements liés à une Facture |
id_lap | non | Filtrer sur les Financements liés à un LAP |
id_participant | non | Filtrer sur les les Financements liés à un Participant |
id_entreprise | non | Filtrer sur les Financements financés pour cette Entreprise |
id_financeur | non | Filtrer sur les Financements à destination de ce Financeur (si type est également fourni |
type | non, oui si id_financeur | Un type est obligatoire pour rechercher par Financeur : entreprise (Entreprise, Particulier, Sous-traitance, Financeur public client) ou financeur_externe (OPCA ou Financeur public externe) |
Afficher un Financement
{
"id_financement": "790",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"id_action_de_formation": "39",
"type": "opca",
"categorie": "",
"id_finance": "522",
"id_financeur": "1",
"montant_finance": "2000",
"id_categorie_produit": "1",
"montant_finance_hors_formation": "0",
"montant_refacture": "0",
"numero_dossier": "",
"montant_total_finance": "2000",
"montant_total_facture": "2000",
"montant_total_paye": "0"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/financements.php?id=790
Ajouter / Editer un Financement
{
"id_financement": "790",
"id_add": "0",
"id_edit": "0",
"id_delete": "0",
"id_action_de_formation": "39",
"type": "opca",
"categorie": "",
"id_finance": "522",
"id_financeur": "1",
"montant_finance": "2000",
"id_categorie_produit": "1",
"montant_finance_hors_formation": "0",
"montant_refacture": "0",
"numero_dossier": "",
"montant_total_finance": "2000",
"montant_total_facture": "2000",
"montant_total_paye": "0"
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/financements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_financement | non | ID du Financement (si vide -> création d'un nouveau Financement, sinon -> édition du Finacement existant) |
id_financeur | oui | ID Financeur Entreprise ou Opca |
id_action_de_formation | oui | ID Action de Formation INTRA (existence vérifiée) |
type | oui | Type de financement (valeurs acceptées : entreprise , participant , particulier , particulier_hors_bpf , opca , public , public_client , sous_traitance , entreprise_particulier ) |
id_categorie_produit | non | ID Produit financé (par défaut: 1 - Formation ) |
categorie | oui si type = opca , public , public_client |
Catégorie BPF (valeurs acceptées pour type opca : apprenti , contrat , promo , cif , cpf , dispositif_recherche_emploi , fonds , autres ; Pour type public ou public_client : agents , europe , etat , conseils_generaux , assedics , autre ) |
montant_total_finance | oui | Montant financé (Inférieur ou égal au restant à financer) |
numero_dossier | non | Numéro de dossier CPF |
Supprimer un Financement
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/financements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_financement | oui | ID Financement (existence vérifiée) |
Factures
Lister toutes les Factures émises
Accède à toutes les Factures présentes sur Dendreo.
Il est possible d'afficher des données supplémentaires pour les Factures en renseignant le paramètre include
.
En ajoutant financements
vous pouvez obtenir tous les financements associés à cette facture, et si vous avez ajouté ce paramètre vous pouvez aussi ajouter les paramètres entreprise
(Entreprise bénéficiaire du Financement = lié à id_finance), financeur
(Financeur du Financement = lié à id_financeur), lfps
(LFP = Lien Financement Participant) pour obtenir des informations additionnels sur ces Financements, details
pour avoir les différentes lignes composant la facture.
Exemple : GET https://pro.dendreo.com/demo/api/factures.php?include=financements,entreprise,financeur,factures,lfps,details
Il est possible de filtrer les factures via le paramètre suivant :
numero_complet
: Le numéro complet de la facture
Exemple : GET https://pro.dendreo.com/demo/api/factures.php?numero_complet=FA_2019001
[
{
"id_facture": "19",
"date_emission": "2016-10-09 10:42:59",
"date_paiement": "0000-00-00 00:00:00",
"moyen_paiement": "",
"numero": "1",
"numero_complet": "",
"id_entreprise": "876",
"id_opca": "0",
"id_participant": "0",
"montant_total_ht": "870.00",
"montant_total_ttc": "1044",
"raison_sociale": "EDF",
"adresse": "28 rue Bigleuil",
"code_postal": "75006",
"ville": "Paris",
"pays_alpha2": "fr",
"pays": "France",
"remarque": "",
"id_parent": "0",
"id_avoir": "0",
"id_centre_de_formation": "0",
"pourcentage_paiement": "100",
"public_url": "https://public.dendreo.com/xxxxx/facture/...",
"date_export_vente": ""
}
]
Il est aussi possible de récupérer toutes les factures d'une Action de formation via le paramètre suivant :
id_action_de_formation
: L'ID d'une Action de formation
Exemple : GET https://pro.dendreo.com/demo/api/factures.php?id_action_de_formation=566
Requête HTTP
GET https://pro.dendreo.com/demo/api/factures.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
date_emission | non | Filtrer sur la date d'émission (format vérifié : "AAAA-MM-JJ") |
date_paiement | non | Filtrer sur la date de paiement (format vérifié : "AAAA-MM-JJ") |
id_entreprise | non | Filtrer sur les factures à destination de cette entreprise |
id_opca | non | Filtrer sur les factures à destination de ce Financeur (opca ou financeur public) |
emission_after | non | Filtrer sur les dates d'émission supérieures ou égales à la date indiquée (format vérifié : "AAAA-MM-JJ") |
emission_before | non | Filtrer sur les dates d'émission inférieures ou égales à la date indiquée (format vérifié : "AAAA-MM-JJ") |
paiement_after | non | Filtrer sur les dates de paiement supérieures ou égales à la date indiquée (format vérifié : "AAAA-MM-JJ") |
paiement_before | non | Filtrer sur les dates de paiement inférieures ou égales à la date indiquée (format vérifié : "AAAA-MM-JJ") |
Afficher une Facture
[
{
"id_facture": "19",
"date_emission": "2016-10-09 10:42:59",
"date_paiement": "0000-00-00 00:00:00",
"moyen_paiement": "",
"numero": "1",
"numero_complet": "",
"id_entreprise": "876",
"id_opca": "0",
"id_participant": "0",
"montant_total_ht": "870.00",
"montant_total_ttc": "744",
"raison_sociale": "EDF",
"adresse": "28 rue Bigleuil",
"code_postal": "75006",
"ville": "Paris",
"pays_alpha2": "fr",
"pays": "France",
"remarque": "",
"id_parent": "0",
"id_avoir": "0",
"id_centre_de_formation": "0",
"pourcentage_paiement": "100",
"public_url": "https://public.dendreo.com/demo/facture/...",
"date_export_vente": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/factures.php?id=19
Pour télécharger la facture, utilisez le lien contenu dans la propriété 'public_url'.
Vous pouvez ajouter les paramètres suivants à cette URL :
pdf (0 ou 1) pour avoir le fichier original ou le fichier généré en pdf
inline=1 pour que le fichier soit affiché 'inline', au lieu d'être téléchargé. Cela signifie qu'il apparaitra directement dans le navigateur client (sous reserve que ce dernier sache afficher les pdf par exemple)
Exemple : GET https://public.dendreo.com/demo/facture/82wr61vkha?pdf=1&inline=1
Règlements
Lister tous les Règlements
Accède à tous les Règlements présents sur Dendreo.
Exemple : GET https://pro.dendreo.com/demo/api/reglements.php
[
{
"id": "372",
"facture_id": "3",
"date": "2021-05-27 00:00:00",
"exported_at": "",
"method": "",
"reference": "",
"amount": "1000.0000",
"account_id": "1",
"created_at": "2021-05-19 11:16:02",
"updated_at": "2021-06-15 15:48:17",
"deleted_at": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/reglements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | non | ID du règlement |
facture_id | non | Filter sur un ID de Facture |
date_before | non | Filtrer sur les dates de règlement inférieures ou égales à la date indiquée (format vérifié : "Y-m-d") |
date_after | non | Filtrer sur les dates de règlement supérieures ou égales à la date indiquée (format vérifié : "Y-m-d") |
Afficher un Règlement
[
[
{
"id": "372",
"facture_id": "3",
"date": "2021-05-27 00:00:00",
"exported_at": "",
"method": "",
"reference": "",
"amount": "1000.0000",
"account_id": "1",
"created_at": "2021-05-19 11:16:02",
"updated_at": "2021-06-15 15:48:17",
"deleted_at": ""
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/reglements.php?id=372
Ajouter un Règlement
[
{
"id": "372",
"facture_id": "3",
"date": "2021-05-27 00:00:00",
"exported_at": "",
"method": "",
"reference": "",
"amount": "1000.0000",
"account_id": "1",
"created_at": "2021-05-19 11:16:02",
"updated_at": "2021-06-15 15:48:17",
"deleted_at": ""
}
]
Requête HTTP
POST https://pro.dendreo.com/demo/api/reglements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
facture_id | oui | ID Facture (existence vérifiée) |
date | oui | Date du règlement (format vérifié : “AAAA-MM-JJ”) |
amount | oui | Montant du règlement. (numeric et différent de 0) |
reference | non | Référence du règlement. |
method | non | Moyen de règlement (virement , cheque , prelevement , cb , paypal , especes , stripe , cheque_formation (Belgique uniquement) |
account_id | non | ID Compte bancaire (existence vérifiée) |
Modifier un Règlement
[
{
"id": "372",
"facture_id": "3",
"date": "2021-05-27 00:00:00",
"exported_at": "",
"method": "",
"reference": "",
"amount": "1000.0000",
"account_id": "1",
"created_at": "2021-05-19 11:16:02",
"updated_at": "2021-06-15 15:48:17",
"deleted_at": ""
}
]
Seuls les Règlements non exportés sont modifiables
Requête HTTP
POST https://pro.dendreo.com/demo/api/reglements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | ID Règlement (existence vérifiée) |
facture_id | oui | ID Facture (existence vérifiée) |
date | oui | Date du règlement (format vérifié : “AAAA-MM-JJ”) |
amount | oui | Montant du règlement. (numeric et différent de 0) |
reference | non | Référence du règlement. |
method | non | Moyen de règlement (virement , cheque , prelevement , cb , paypal , especes , stripe , cheque_formation (Belgique uniquement) |
account_id | non | ID Compte bancaire (existence vérifiée) |
Supprimer un Règlement
Seuls les Règlements non exportés sont supprimables
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/reglements.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | oui | ID Règlement (existence vérifiée) |
Export Comptable
Télécharger un export comptable Ventes
Ce lien vous permet de déclencher le téléchargement automatique d'un fichier "export comptable de ventes" au format demandé en paramètre.
Paramètres disponibles
Intitulé | Obligatoire | Description |
---|---|---|
format_export | oui | Correspond au format du fichier de sortie (formats disponibles : "ebp", "ebp_v2", "ebp_v3", "ebp_aux", "ebp_aux_txt", "generique", "generique_txt", "sage_pnm", "cegid", "quadra", "quadra_analytics", "winbiz", "winfic", "louty", "cador_dorac") |
journal | oui | Correspond au type d'export comptable : "ventes" pour le journal des ventes |
factures | oui | Liste des factures à exporter. Indiquez l'ID de chaque facture séparé par une virgule. |
Exemple de Requête HTTP
GET https://pro.dendreo.com/demo/api/export_comptable.php?format_export=sage_pnm&journal=ventes&factures=614,615,616
Les IDs des factures sont récupérables via l'API des factures.
Mails
Logs des mails envoyé par Dendreo
[
{
"id_mail": "1",
"cible": "",
"id_entite": "0",
"id_action_de_formation": "0",
"id_mail_type": "0",
"id_add": "0",
"date_add": "0000-00-00 00:00:00",
"from_email": "nom@domaine.fr",
"domain": "dendreo.com",
"title": "Intitule",
"http_response_code": "200",
"http_error_msg": "",
"destinataires": [
{
"id": "1",
"id_mail": "1",
"email": "nom@domaine.fr",
"type_destinataire": "to",
"event": "",
"code": "0",
"error": "",
"notification": "",
"reason": "",
"description": ""
},
{
"id": "2",
"id_mail": "1",
"email": "nom@domaine.fr",
"type_destinataire": "cc",
"event": "",
"code": "0",
"error": "",
"notification": "",
"reason": "",
"description": ""
}
]
},
]
Affiche la liste des emails envoyés par Dendreo
Exemple : GET https://pro.dendreo.com/demo/api/emails.php
Un email contient les données qui lui sont propre, ainsi qu'un tableau de destinataires.
Le champ http_response_code
d'un email, définit s'il est bien parvenu à la plateforme d'emailing.
Ses valeurs possibles sont :
- 200 : l'email est bien parvenu à la plateforme d'emailing de Dendreo (Mailgun) pour être envoyé
- autre ou vide : une erreur est survenue.
Le champs destinataires
contient un tableau de destinataires.
Chaque destinataire possède un email, un type de destinataire ('to', 'cc' ou 'bcc'), ainsi que des informations de statut.
Les valeurs possibles de event
sont :
delivered
dropped
bounced
complained
- vide : status inconnu, l'email est encore en train d'être traité par la plateforme
Un destinataire ayant correctement reçu l'email doit donc associer un http_response_code
à 200
et un event
à delivered
.
En cas d'erreur, les champs http_error_msg
, code
, error
, notification
, reason
et description
peuvent contenir des informations de diagnostique. Le champ le plus utile et explicite est en général reason
.
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_action_de_formation | non | ID Action de formation (existence vérifiée) |
to_email | non | Destinataire |
http_response_code | non | Code de réponse de l'email |
event | non | delivered, dropped, bounced, complained |
offset | non | Pagination (affiche 100 résultats à partir de cette valeur) |
Checklists
Lister les Checklists suivant un type de cible
Pour les checklists de type action_de_formation_inter
, action_de_formation_intra
, action_de_formation
, lap
, laf
, n'affiche que celles dont l'action de formation n'a pas été supprimée.
[
{
"id_checklist": "4",
"id_add": "0",
"id_edit": "0",
"type_cible": "formateur",
"id_cible": "65",
"remarque": "Exemple de remarque",
"checks_total": "2",
"checks_done": "1",
"checks": [
{
"id_check": "7",
"id_add": "0",
"id_edit": "0",
"intitule": "première étape",
"done": "0"
},
{
"id_check": "8",
"id_add": "0",
"id_edit": "0",
"intitule": "deuxième étape",
"done": "1"
}
]
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/checklists.php?cible=formateur
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
cible | oui | Afficher toutes les checklists d'un type de cible (formateur , action_de_formation_inter , action_de_formation_intra , action_de_formation (inter et intra), lap , laf ) |
id_cible | non | Filtrer sur une ou plusieurs cibles particulières (id_cible=44,45,47) |
include_deleted | non | Inclut les checklists des actions de formation supprimées. |
Afficher une Checklist
[
{
"id_checklist": "4",
"id_add": "0",
"id_edit": "0",
"type_cible": "formateur",
"id_cible": "65",
"remarque": "Exemple de remarque",
"checks_total": "2",
"checks_done": "1",
"checks": [
{
"id_check": "7",
"id_add": "0",
"id_edit": "0",
"intitule": "première étape",
"done": "0"
},
{
"id_check": "8",
"id_add": "0",
"id_edit": "0",
"intitule": "deuxième étape",
"done": "1"
}
]
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/checklists.php?id=4
Checks
Modifier un check existant
{
"id_check": "7",
"id_add": "0",
"id_edit": "0",
"id_checklist": "4",
"intitule": "première étape",
"done": "1"
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/checks.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_check | oui | L'id du check à modifier |
intitule | non | L'intitule du check |
done | non | Le status du check (0,1) |
Créer un check pour une checklist existante
{
"id_check": "8",
"id_add": "0",
"id_edit": "0",
"id_checklist": "4",
"intitule": "seconde étape",
"done": "0"
}
Requête HTTP
POST https://pro.dendreo.com/demo/api/checks.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_checklist | oui | L'id de la checklist |
intitule | oui | L'intitule du check |
done | non | Le status du check (0,1) |
Administrateurs
Lister tous les administrateurs
[
{
"id_administrateur": "1",
"id_add": "0",
"id_edit": "0",
"id_delete": "1",
"nom": "DUPONT",
"prenom": "Mathieu",
"email": "dupont@dendreo.com",
"login": "mdupont",
"date_derniere_connexion": "2017-06-26 14:33:21",
"niveau": "40",
"fonction": "",
"telephone": "",
"use_email": "0",
"use_signature": "0",
"photo": "https://public.dendreo.com/njsx266nmvpw4ylnnfxg4/media/l27tk4k5j8sc9qlfgffA9wstjvth24cr4j7ts9txl3zf1zkp3fyg4pj8",
"nom_complet": "Mathieu DUPONT"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/administrateurs.php
Il est possible de récupérer l'url de la photo
de profil des administrateurs dans la réponse, en rajoutant include=photo
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/administrateurs.php?include=photo
Afficher un administrateur
[
{
"id_administrateur": "1",
"id_add": "0",
"id_edit": "0",
"id_delete": "1",
"nom": "DUPONT",
"prenom": "Mathieu",
"email": "dupont@dendreo.com",
"login": "mdupont",
"date_derniere_connexion": "2017-06-26 14:33:21",
"niveau": "40",
"fonction": "",
"telephone": "",
"use_email": "0",
"use_signature": "0",
"photo": "https://public.dendreo.com/njsx266nmvpw4ylnnfxg4/media/l27tk4k5j8sc9qlfgffA9wstjvth24cr4j7ts9txl3zf1zkp3fyg4pj8",
"nom_complet": "Mathieu DUPONT"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/administrateurs.php?id=1
Il est possible de récupérer l'url de la photo
de profil de l'administrateur dans la réponse, en rajoutant include=photo
à votre requête.
Exemple : GET https://pro.dendreo.com/demo/api/administrateurs.php?id=1&include=photo
Actions Commerciales
Lister toutes les actions commerciales
[
{
"id_action_commerciale": "105",
"date_add": "2022-04-19 10:53:00",
"id_add": "0",
"date_edit": "2022-04-27 10:17:04",
"id_edit": "0",
"date_action": "2022-04-19 00:00:00",
"id_categorie_ac": "1",
"compte_rendu": "...",
"date_relance": "2022-04-13 00:00:00",
"priorite": "1",
"devis_id": "",
"id_entreprise": "37",
"parent_id": "",
"commerciaux": [
{
"id_administrateur": "2",
"nom": "Ruiz",
"prenom": "Jose",
"nom_complet": "Jose Ruiz"
}
],
"interlocuteurs": [
{
"id_entreprise": "37",
"date_add": "2022-01-31 08:37:33",
"id_add": "0",
"date_edit": "2022-09-01 10:42:07",
"id_edit": "0",
"entreprise_id": "0",
"numero": "2",
"numero_complet": "ENT_2200002",
...
}
]
},
...
]
Il est possible de filtrer les actions commerciales via les paramètres suivant :
id_entreprise : les actions commerciales liées à l'entreprise sélectionnée
Exemple : GET https://pro.dendreo.com/demo/api/actions_commerciales.php?id_entreprise=3
id_categorie_ac : les actions commerciales de la catégorie sélectionnée
Exemple : GET https://pro.dendreo.com/demo/api/actions_commerciales.php?id_categorie_ac=1
commercial_id : les actions commerciales rattachée à l'administrateur sélectionné
Exemple : GET https://pro.dendreo.com/demo/api/actions_commerciales.php?commercial_id=19
relance : les actions commerciales qui ont une relance à venir (Dans ce cas, les actions commerciales seront triées par date de relance les plus anciennes)
Exemple : GET https://pro.dendreo.com/demo/api/actions_commerciales.php?relance=1
Attention, les actions commerciales sont triées par date la plus récente, et retournées par série de 100. Vous devez utiliser le paramètre 'offset' pour récupérer les précédentes actions commerciales
Exemple : GET https://pro.dendreo.com/demo/api/actions_commerciales.php?offset=500
Requête HTTP
GET https://pro.dendreo.com/demo/api/actions_commerciales.php
Afficher une action commerciale
{
"id_action_commerciale": "105",
"date_add": "2022-04-19 10:53:00",
"id_add": "0",
"date_edit": "2022-04-27 10:17:04",
"id_edit": "0",
"date_action": "2022-04-19 00:00:00",
"id_categorie_ac": "1",
"intitule_categorie_ac": "Relance simple",
"compte_rendu": "...",
"date_relance": "2022-04-13 00:00:00",
"priorite": "1",
"devis_id": "",
"id_entreprise": "37",
"parent_id": "",
"commerciaux": [
{
"id_administrateur": "2",
"nom": "Ruiz",
"prenom": "Jose",
"nom_complet": "Jose Ruiz"
}
],
"interlocuteurs": [
{
"id_entreprise": "37",
"date_add": "2022-01-31 08:37:33",
"id_add": "0",
"date_edit": "2022-09-01 10:42:07",
"id_edit": "0",
"entreprise_id": "0",
"numero": "2",
"numero_complet": "ENT_2200002",
...
}
]
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/actions_commerciales.php?id=1
Ajouter / Editer une action commerciale
{
"id_action_commerciale": "40",
"id_add": "1",
"date_action": "2018-09-26 14:14:42",
"id_categorie_ac": "2",
"id_contact": "25,35",
"participant_prenom_nom": "Michel Blanc",
"priorite": "3",
"commercial_id": "21,14",
"compte_rendu": "En attente du bon de commande pour formation ScrumMaster. A relancer si rien sous une huitaine.",
"date_relance": "2018-10-20",
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id | non | ID de l'action commercial (si vide -> ajout d'une nouvelle action commerciale, sinon -> édition) |
id_entreprise | non | IDs des entreprises rattachées à cette action commerciale (possibilité de passer 'entreprise_raison_sociale' au lieu de 'id_entreprise') |
id_contact | non | IDs des contacts rattachés à cette action commerciale (possibilité de passer 'contact_prenom_nom' au lieu de 'id_contact') |
id_participant | non | IDs des participants rattachés à cette action commerciale (possibilité de passer 'participant_prenom_nom' au lieu de 'id_participant') |
id_formateur | non | IDs des formateurs rattachés à cette action commerciale (possibilité de passer 'formateur_prenom_nom' au lieu de 'id_formateur') |
commercial_id | oui | IDs des administrateurs auteur de cette action commerciale |
date_action | non | Date au format AAAA-MM-JJ (Si vide prendra la date du jour) |
date_relance | non | Date au format AAAA-MM-JJ |
id_categorie_ac | non | ID de catégorie (Si vide en mode ajout, prendra la valeur de la configuration par défaut) |
priorite | non | Priorité de l'action commerciale (0,1,2) |
Une action commerciale DOIT être rattachée à un interlocuteur : entreprise, contact, ou participant. Plusieurs valeurs peuvent être renseignées, celles-ci doivent être séparées par des virgules. Pour ajouter une action commerciale à un particulier, vous devez envoyer l'id_entreprise de celui-ci.
Requête HTTP
POST https://pro.dendreo.com/demo/api/actions_commerciales.php
Supprimer une Action Commerciale
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/actions_commerciales.php?id=1
DELETE https://pro.dendreo.com/demo/api/actions_commerciales.php?id_action_commerciale=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_action_commerciale | oui | ID Action Commerciale (existence vérifiée) |
Convertir vers Particulier
Exemple de réponse
{
"status":"success"
}
Vous pouvez convertir un Participant en Particulier si :
Il n'a pas d'Entreprise ou est le seul dans son Entreprise
Si il a une Entreprise, celle-ci doit avoir 0 ou 1 Contact associé
Vous pouvez convertir une Entreprise en Particulier si :
Elle a 0 ou 1 seul Contact associé
Elle a 0 ou 1 seul Participant associé
Requête HTTP
POST https://pro.dendreo.com/demo/api/convert_particulier.php
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_entreprise | oui (sauf si id_participant fourni) | ID Entreprise (existence vérifiée) |
id_participant | oui (sauf si id_entreprise fourni) | ID Participant (existence vérifiée) |
Fichiers
Afficher un fichier
{
"id": "1",
"collection_name": "avatar",
"name": "sample",
"mime_type": "image/jpeg",
"size": "20461",
"created_at": "2018-10-26 12:44:49",
"updated_at": "2018-10-26 12:44:49",
"deleted_at": "",
"id_add": "1",
"id_edit": "0",
"public_url": "",
"cible": "formateur",
"id_cible": "59",
"entite_liee": {
"Entreprise": {
"id_entreprise": "482",
"id_add": "2",
"id_edit": "0",
"numero": "8",
"numero_complet": "ENT_2018001",
"...":
}
}
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/fichiers.php?id=1
Rechercher un fichier
Il est possible de rechercher les fichiers d'une 'collection', au sein d'une 'cible'.
Si le paramètre 'collection_name' est omis, les fichiers de l'espace de stockage seront retournés par défaut (Se reporter au tableau de correspondance cible/collection plus bas).
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&collection_name=visuel
Il est ensuite possible de filtrer les fichiers via les paramètres suivant :
id_doc_type
: les fichiers uploadés via QR Code qui ont été reconnus comme étant ce modèle de document
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&id_doc_type=2
id_formateur
: les fichiers 'liés' à un Formateur au sein d'une Action de formation
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&id_formateur=2
id_entreprise
: les fichiers 'liés' à une Entreprise au sein d'une Action de formation
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&id_entreprise=2
id_participant
: les fichiers 'liés' à un Participant au sein d'une Action de formation
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&id_participant=2
id_module
: les fichiers 'liés' à un Module au sein d'une Action de formation
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=action-de-formation&id_cible=1&id_module=2
Pour les entites Entreprise, Formateur, Participant et Module, vous pouvez obtenir la liste de tous les fichiers liés dans les ADFs en utilsant la collection fichiers_lies_adf
Exemple : GET https://pro.dendreo.com/demo/api/fichiers.php?cible=formateur&id_cible=1&collection_name=fichiers_lies_adf
Filtre avancé sur les cibles
Si vous choisissez de lister tous les fichiers d'un type de cible par exemple :
GET https://pro.dendreo.com/demo/api/fichiers.php?cible=participant
Vous pouvez alors filtrer sur un objet relatif à cette cible, exemple, l'Entreprise d'un Participant :
GET https://pro.dendreo.com/demo/api/fichiers.php?cible=participant&filter_cible[entreprise]=1
Ajouter un fichier
{
"id": "1",
"collection_name": "avatar",
"name": "sample",
"mime_type": "image/jpeg",
"size": "20461",
"created_at": "2018-10-30 15:17:06",
"updated_at": "2018-10-30 15:17:06",
"deleted_at": "",
"id_add": "1",
"id_edit": "0",
"cible": "formateur",
"id_cible": "59",
"chemin": "Répertoire/Sous_repertoire",
"entite_liee_type": "formateur",
"entite_liee_id": "1234",
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
file | oui | Fichier à envoyer (est attendu un fichier en POST multipart/form-data) |
cible | non | Type de la cible à laquelle rattacher le fichier (ex: formateur) |
id_cible | non | ID de la cible à laquelle rattacher le fichier |
collection | non | Le nom de la collection à laquelle associer le fichier (voir tableau ci-dessous) |
chemin | non | Permet de placer le fichier dans un répertoire (voire sous-répertoires). Le(s) répertoire(s) seront créés si besoin. |
entite_liee_type | non | Permet de lier le fichier à un élément de l'ADF, parmi les types suivants : entreprise, participant, formateur et module |
entite_liee_id | non | Permet de lier le fichier à un élément de l'ADF, en conjonction avec entite_liee_type |
Si un des paramètres cible, id_cible, ou collection est omis, alors Dendreo tentera de reconnaitre le fichier par l'intermédiaire du QR Code (si disponible avec votre abonnement).
Le paramètre 'chemin' ne peut être utilisé qu'avec la cible 'action-de-formation' et la collection 'docsaved'.
Les paramètres 'entite_liee_type' et 'entite_liee_id' doivent être utilisés ensemble. Ils ne peuvent être utilisés qu'avec la cible 'action-de-formation' et la collection 'docsaved' ou 'signature'. Dand le cas où vous souhaitez ajouter une demande de signature dans une ADF, il faut utiliser la cible 'action-de-formation' ET l'entite liée (cad le signataire)
Requête HTTP
POST https://pro.dendreo.com/demo/api/fichiers.php
Liste des cibles et collection_name correspondants
Voici la liste des correspondances entre cible et collection possibles :
cible | collection | commentaire |
---|---|---|
action-de-formation | visuel, docssaved, signature | |
formateur | avatar, docssaved, signature | |
contact | avatar, signature | |
participant | avatar, docssaved, signature | |
module | visuel, presentation, docssaved | |
entreprise | logo, docssaved, signature | |
salle-de-formation | image_map, pdf_map | |
centre-de-formation | logo, image_map, pdf_map, header, footer, cgv, reglement_interieur, centre_signature, docssaved, partage_cdf_formateurs, partage_cdf_entreprises, partage_cdf_participants | |
doctype | docstype | |
expense | expense | |
formateur-facture | formateur_facture | à utiliser avec id_cible = id de la facture formateur, permet d'obtenir la liste des fichiers associés à une facture de frais pedagogique |
laf | partage_laf | à utiliser avec id_cible = id du LAF, permet d'obtenir les fichiers pour 1 Formateur identifié dans 1 ADF |
lap | partage_lap, partage_lap_prive | à utiliser avec id_cible = id du LAP permet d'obtenir les fichiers pour 1 Participant identifié dans 1 ADF |
lae | partage_lae | à utiliser avec id_cible = id du LAE permet d'obtenir les fichiers pour 1 Entreprise identifié dans 1 ADF |
action-de-formation | partage_adf_participants | à utiliser avec id_cible = id ADF, permet d'obtenir les fichiers mis à disposition pour "Tous les Participants" |
action-de-formation | partage_adf_formateurs | à utiliser avec id_cible = id ADF, permet d'obtenir les fichiers mis à disposition pour "Tous les Formateurs" |
action-de-formation | partage_adf_entreprises | à utiliser avec id_cible = id ADF, permet d'obtenir les fichiers mis à disposition pour "Toutes les Entreprises" |
module | partage_module_public | à utiliser avec id_cible = id module, permet d'obtenir les fichiers mis à disposition pour "Public - Participants" d'un Module |
module | partage_module_formateurs | à utiliser avec id_cible = id module, permet d'obtenir les fichiers mis à disposition pour "Privé - Formateurs" d'un Module |
salle | partage_salle_public | à utiliser avec id_cible = id salle_de_formation, permet d'obtenir les fichiers mis à disposition pour "Public - Participants" d'une Salle de Formation |
La collection 'docssaved' correspond à l'espace de stockage. Vous pouvez y ajouter plusieurs fichiers.
La collection 'expense' correspond aux justificatifs des notes de frais. Vous pouvez également y ajouter plusieurs fichiers.
Toutes les autres collections sont des fichiers 'uniques' c'est à dire que l'ajout d'un nouveau fichier écrasera celui qui serait déjà présent.
Vous pouvez également avoir d'autres collections relatives aux Champs personnalisés de type fichier. Dans ce cas, le nom de la collection sera le 'Nom technique' du champ personnalisé, disponible dans votre interface d'administration Dendreo
Supprimer un Fichier
Requête HTTP
DELETE https://pro.dendreo.com/demo/api/fichiers.php?id=1
DELETE https://pro.dendreo.com/demo/api/fichiers.php?id_fichier=1,2,3
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id ou id_fichier | oui | ID du fichier (existence vérifiée) |
Génération de Documents
Cet endpoint vous permet de générer (publiposter) un document à partir d'un modèle de document existant sur Dendreo, et de le télécharger au format natif (.docx, .odt, .xlsx) ou PDF.
Le header 'Content-Disposition' renvoyé est 'attachment'
Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Entreprises d'une Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf_entreprise
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
id_lae | oui | ID du Lae (Lien entre l'Action De Formation et une Entreprise) |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Participants d'une Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf_participant
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
id_lap | oui | ID du Lap (Lien entre l'Action De Formation et un Participant) |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Formateurs d'une Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf_formateur
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
id_laf | oui | ID du Laf (Lien entre l'Action De Formation et un Formateur) |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Modules d'une Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf_module
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
id_lam | oui | ID du Lam (Lien entre l'Action De Formation et un Module) |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Modules + Participants d'une Action De Formation
GET https://pro.dendreo.com/demo/api/documents.php?m=adf_module_participant
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_adf | oui | ID de l'Action De Formation |
id_lmp | oui | ID du Lmp (Lien entre le Module et le Participant au sein de cette Action de Formation) |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Facture
GET https://pro.dendreo.com/demo/api/documents.php?m=facture
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_facture | oui | ID de la Facture |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Module (hors contexte d'une ADF)
GET https://pro.dendreo.com/demo/api/documents.php?m=module
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_module | oui | ID du Module |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Entreprise (hors contexte d'une ADF)
GET https://pro.dendreo.com/demo/api/documents.php?m=entreprise
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_entreprise | oui | ID de l'Entreprise |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Participant (hors contexte d'une ADF)
GET https://pro.dendreo.com/demo/api/documents.php?m=participant
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_participant | oui | ID du Participant |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Formateur (hors contexte d'une ADF)
GET https://pro.dendreo.com/demo/api/documents.php?m=formateur
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_formateur | oui | ID du Formateur |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Devis
GET https://pro.dendreo.com/demo/api/documents.php?m=devis
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_doc_type | oui | ID du Modèle de Document à utiliser |
id_devis | oui | ID du Devis |
generate | non | 1 pour génerer les tags, 0 pour télécharger le document brut |
non | 1 pour la version pdf, 0 pour la version word du document |
Catalogue en ligne - Prochaines sessions
Opportunités
Lister toutes les Opportunités
Accède à toutes les Opportunités présentes sur Dendreo.
Il est possible de filtrer sur certaines opportunités si l'on connait leur id
.
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?id=1
Vous pouvez également filtrer sur un id de devis
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?id_devis=2
Ou sur un id de centre de formation
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?id_centre_de_formation=2
Ou sur un id d'entreprise
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?id_entreprise=2
Il est possible d'afficher la liste des Devis par Opportunité en renseignant le paramètre include
sur la valeur devis
.
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?include=devis
Il est aussi possible d'afficher les devis avec les modules rattachés à ces derniers en renseignant le paramètre include
sur la valeur devis_modules
.
Exemple : GET https://pro.dendreo.com/demo/api/opportunites.php?include=devis_modules
{
"id": "1",
"opportunite_etape_id": "4",
"numero": "1",
"numero_complet": "OPP_2020001",
"numero_perso": "0",
"entreprise_id": "570",
"assigned_to": "26",
"contact_id": "393",
"created_by": "",
"edited_by": "",
"commentaires_internes": "",
"description": "test",
"closed_at": "",
"lost_at": "",
"deleted_at": "",
"created_at": "2020-02-04 11:48:36",
"updated_at": "2020-02-04 11:58:58",
"id_centre_de_formation": "1",
"source_id": "1",
"devis": [
{
"id": "1",
"opportunite_id": "1",
"parent_id": "",
"numero_complet": "DEVIS_2020001",
"numero_perso": "0",
"numero": "1",
"numero_auto": "1",
"locked_at": "2020-02-04 11:58:58",
"sent_at": "",
"accepted_at": "2020-02-04 11:58:58",
"declined_at": "",
"created_by": "",
"edited_by": "",
"doc_type_id": "70",
"linked": "",
"formation_id": "",
"type": "inter",
"pricing": "par_participant",
"participants": "1",
"mode_participants": "global",
"remarques": "",
"commentaires_internes": "",
"deleted_at": "",
"created_at": "2020-02-04 11:48:36",
"updated_at": "2020-02-04 11:58:58",
"modules": [
{
"id_module": "233",
"intitule": "Test",
"numero_complet": "MOD_2020011",
"id_externe": "",
"id_categorie_module": "117"
}
]
}
]
}
Ajouter une Opportunité
{
"id": "65",
"opportunite_etape_id": "2",
"numero": "9",
"numero_complet": "OPP_2020009",
"numero_perso": "0",
"entreprise_id": "600",
"assigned_to": "33",
"contact_id": "425",
"created_by": "0",
"edited_by": "0",
"commentaires_internes": "",
"description": "",
"closed_at": "",
"lost_at": "",
"deleted_at": "",
"created_at": "2020-03-17 14:02:43",
"updated_at": "2020-03-17 14:02:43",
"id_centre_de_formation": "1",
"devis": [
{
"id": "85",
"opportunite_id": "65",
"parent_id": "",
"numero_complet": "DEVIS_2020009",
"numero_perso": "0",
"numero": "9",
"numero_auto": "1",
"locked_at": "",
"sent_at": "",
"accepted_at": "",
"declined_at": "",
"created_by": "0",
"edited_by": "0",
"doc_type_id": "70",
"linked": "",
"formation_id": "",
"type": "inter",
"pricing": "par_participant",
"participants": "1",
"mode_participants": "global",
"remarques": "",
"commentaires_internes": "",
"deleted_at": "",
"created_at": "2020-03-17 14:02:43",
"updated_at": "2020-03-17 14:02:43"
}
]
}
Paramètres
Intitulé | Obligatoire | Description |
---|---|---|
id_entreprise | oui | ID de l'entreprise pour cette opportunité |
id_administrateur | non | ID du Commercial |
id_contact | non | ID du contact dans l'entreprise |
id_etape | non | ID de l'étape initiale pour cette opportunité (Probabilité de succès) |
id_source | non | ID de la source |
description | non | Champ texte de description |
commentaires_internes | non | Champ texte de commentaires internes |
id_centre_de_formation | non | Obligatoire si vous avez l'option multi-centres |
Requête HTTP
POST https://pro.dendreo.com/demo/api/opportunites.php
Etapes d'opportunité
Lister toutes les étapes des opportunités
[
"id": "1",
"name": "Lead",
"order": "0",
"success_chance": "25",
"deleted_at": "",
"created_at": "2018-05-17 12:24:20",
"updated_at": "2022-08-03 06:25:46",
"color": "f9c98f",
"status": "1"
]
Accède à toutes les étapes des opportunités présentes sur Dendreo.
Requête HTTP
GET https://pro.dendreo.com/demo/api/opportunite_etapes.php
Afficher une étape d'opportunité
{
"id": "2",
"name": "Négociation",
"order": "1",
"success_chance": "50",
"deleted_at": "",
"created_at": "2018-05-17 12:24:20",
"updated_at": "2018-11-26 09:21:29",
"color": "f6e67d",
"status": "1"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/opportunite_etapes.php?id=2
Sources
Lister toutes les sources
[
{
"id": "1",
"name": "Campagne Marketing",
"status": "1",
"order": "0"
},
{
"id": "2",
"name": "Salons",
"status": "1",
"order": "3"
}
]
Accède à toutes les sources présentes sur Dendreo.
Requête HTTP
GET https://pro.dendreo.com/demo/api/sources.php
Afficher une source
{
"id": "1",
"name": "Campagne Marketing",
"status": "1",
"order": "0"
}
Requête HTTP
GET https://pro.dendreo.com/demo/api/sources.php?id=2
Afficher plusieurs sources
[
{
"id": "1",
"name": "Campagne Marketing",
"status": "1",
"order": "0"
},
{
"id": "2",
"name": "Salons",
"status": "1",
"order": "3"
}
]
Requête HTTP
GET https://pro.dendreo.com/demo/api/sources.php?id=1,2
Exports
Télécharger un Export
Ce lien vous permet de déclencher le téléchargement automatique d'un fichier d'Export Dendreo au format demandé en paramètre.
Requête HTTP
GET https://pro.dendreo.com/demo/api/exports.php
Paramètres disponibles
Intitulé | Obligatoire | Description |
---|---|---|
nom_export | oui | Correspond au nom de l'export à télécharger (slug) |
date_debut | oui | Date de début des données à exporter (format vérifié : "AAAA-MM-JJ") |
date_fin | oui | Date de fin des données à exporter (format vérifié : "AAAA-MM-JJ") |
type | non | Correspond au type du fichier de sortie (formats disponibles : csv , xls ). Fichier XLS par défaut |
delimiter | non | Correspond au délimiteur du fichier CSV Formats disponibles : , , | , : Format par défaut : ; Attention, le paramètre est ignoré si le type est différent de csv . |
Exemple : GET https://pro.dendreo.com/demo/api/exports.php?nom_export=creneaux&date_debut=2021-01-01&date_fin=2021-12-31&type=csv
Webhooks
La documentation sur les Webhooks proposés par Dendreo est disponible ici : https://doc.dendreo.com/article/545-presentation-webhooks