{
  "info": {
    "name": "VisioFormation API v1",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Créer un prospect",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/leads",
        "description": "Crée un nouveau prospect. name, phone, address, email, crm_settings_id et particulier_entreprise sont obligatoires. Le produit reste le texte fourni. Le statut initial est géré par VisioFormation. Deux demandes avec des clés différentes peuvent créer deux prospects, même si leur email est identique. Permission : leads:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"L\",\n  \"phone\": \"0\",\n  \"address\": \"A\",\n  \"email\": \"lead@example.com\",\n  \"particulier_entreprise\": \"Particulier\",\n  \"crm_settings_id\": \"1\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Créer ou retrouver un apprenant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/students",
        "description": "Crée un compte ou réutilise un compte unique de même email ET même nom normalisés. Aucun rattachement à une session ni aucune pré-inscription. Les champs facultatifs sont des données de création : une réutilisation ne met pas à jour les coordonnées. company_id exige le statut Employé et une entreprise de votre organisme. Permission : students:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Élodie Exemple\",\n  \"email\": \"elodie@example.com\",\n  \"numero_rpps\": \"00012345\",\n  \"numero_ordinal\": \"001\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Créer ou retrouver une entreprise",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/companies",
        "description": "Crée ou réutilise une entreprise, sans apprenant et sans inscription. name, email et address sont obligatoires. Sans téléphone, une chaîne vide est enregistrée. Le SIRET est facultatif ici. Aucun identifiant de connexion ni mot de passe entreprise n’est généré. Permission : companies:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"Entreprise Exemple\",\n  \"email\": \"office@example.com\",\n  \"address\": \"10 rue Exemple\",\n  \"siret\": \"12345678900010\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Inscrire immédiatement un apprenant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/enrollments/students",
        "description": "Inscription immédiate, sans étape de validation manuelle : crée/réutilise l’apprenant puis l’inscription dans la session course_id. price, type et payment_source sont obligatoires. La classification de la session est héritée automatiquement. Une inscription compatible est réutilisée ; un contrat/payeurs/prix incompatible provoque une erreur 409. Permission : enrollments:students:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"course_id\": \"1\",\n  \"student\": {\n    \"name\": \"Élodie Exemple\",\n    \"email\": \"elodie@example.com\",\n    \"numero_rpps\": \"00012345\",\n    \"numero_ordinal\": \"001\"\n  },\n  \"enrollment\": {\n    \"price\": \"0\",\n    \"type\": \"Particuliers à leurs propres frais formés par votre organisme de formation\",\n    \"payment_source\": \"de contrats conclus avec des personnes à titre individuel et à leurs frais\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Inscrire immédiatement une entreprise et ses apprenants",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/enrollments/companies",
        "description": "Une entreprise avec SIRET et 1 à 100 apprenants sont obligatoires. La demande est atomique : tout est enregistré ou rien. price_type=total place le montant uniquement au niveau entreprise ; price_type=par_apprenant le place uniquement sur chaque apprenant. Les apprenants reçoivent le statut Employé et l’entreprise résolue ; ne fournissez ni status ni company_id dans students. Un employeur différent ne sera jamais remplacé silencieusement. Un employeur absent peut être renseigné si les liens existants sont compatibles ; les autres données personnelles restent inchangées. student_enrollment peut être omis : les valeurs BPF/paiement salarié et les trois indicateurs à no sont alors appliqués. change_address=Oui nécessite une session intra et la permission supplémentaire sessions:location:update. Il ne modifie pas le lieu lorsque l’inscription entreprise existe déjà. Permission : enrollments:companies:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"course_id\": \"1\",\n  \"company\": {\n    \"name\": \"Entreprise Exemple\",\n    \"email\": \"office@example.com\",\n    \"address\": \"10 rue Exemple\",\n    \"siret\": \"12345678900010\"\n  },\n  \"students\": [\n    {\n      \"name\": \"Employee A\",\n      \"email\": \"shared@example.com\"\n    },\n    {\n      \"name\": \"Employee B\",\n      \"email\": \"shared@example.com\"\n    }\n  ],\n  \"company_enrollment\": {\n    \"price\": \"900.00\",\n    \"price_type\": \"total\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Préinscrire un particulier",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/preinscriptions/individuals",
        "description": "Crée uniquement une demande en attente de validation manuelle. Aucun compte apprenant, inscription, facture ou paiement n’est créé par cet appel. name, email, phone, address et profession sont obligatoires. Selon le paramétrage de votre organisme, postal_code, city, dob et city_of_birth deviennent aussi obligatoires. Le programme doit être public, les sessions publiques activées, la session non terminée et associée à ce programme. Une session déjà commencée mais non terminée reste admissible. Permission : preinscriptions:individuals:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"course_id\": \"1\",\n  \"library_id\": \"1\",\n  \"student\": {\n    \"name\": \"Pending Exemple\",\n    \"email\": \"pending@example.com\",\n    \"phone\": \"0123456789\",\n    \"address\": \"12 rue Exemple\",\n    \"profession\": \"Technicien\"\n  }\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Préinscrire une entreprise et ses apprenants",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/preinscriptions/companies",
        "description": "Crée uniquement une demande entreprise et ses demandes apprenants en attente, sans créer de comptes ni d’inscriptions immédiates. L’entreprise nécessite name, siret, address, postal_code, city, email et representant, et au moins un apprenant. Les règles des informations complémentaires des apprenants sont les mêmes que pour un particulier. Les identifiants retournés sont ceux des demandes en attente, pas ceux de comptes entreprise/apprenant. Permission : preinscriptions:companies:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"course_id\": \"1\",\n  \"library_id\": \"1\",\n  \"company\": {\n    \"name\": \"Entreprise Exemple\",\n    \"email\": \"office@example.com\",\n    \"address\": \"10 rue Exemple\",\n    \"siret\": \"12345678900010\",\n    \"postal_code\": \"75000\",\n    \"city\": \"Paris\",\n    \"representant\": \"Alex\"\n  },\n  \"students\": [\n    {\n      \"name\": \"Pending Exemple\",\n      \"email\": \"pending@example.com\",\n      \"phone\": \"0123456789\",\n      \"address\": \"12 rue Exemple\",\n      \"profession\": \"Technicien\"\n    }\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Créer une session à partir d’un programme",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{operation_id}}"
          }
        ],
        "url": "{{base_url}}/sessions",
        "description": "Accepte uniquement library_id, course_start_date, course_end_date et inter_intra. Le titre, la description, la durée, le lieu et la classification proviennent du programme. Aucun créneau, formateur ou apprenant n’est ajouté. La fin ne peut pas précéder le début. Un titre de programme incompatible avec la capacité du nom de session est refusé ; aucune troncature silencieuse. Permission : sessions:create",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"library_id\": \"1\",\n  \"course_start_date\": \"2030-03-15\",\n  \"course_end_date\": \"2030-03-16\",\n  \"inter_intra\": \"inter\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "Vérifier la connexion",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-VF-Token-1",
            "value": "{{token_1}}"
          },
          {
            "key": "X-VF-Token-2",
            "value": "{{token_2}}"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": "{{base_url}}/auth/check",
        "description": "Vérifie les deux jetons et les règles d’accès actuelles. Aucun corps de requête. Réponse sans données personnelles. Cette requête consomme les mêmes quotas authentifiés. Permission : connexion valide"
      }
    }
  ]
}
