curlcurl -X POST \
  "$BASE_URL/upsertCompagnies" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "id": "1", "nom": "TrackChantier" }'

Création / mise à jour de compagnies.

curlcurl -X POST "$BASE_URL/upsertCompagnies" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "1",
    "nom": "TrackChantier",
    "salarie_de_pret": false,
    "loan_ids": [],
    "chantiersDePret": [
      { "companyId": "1", "chantierId": "1" }
    ]
  }'

jsawait fetch(`${BASE_URL}/upsertCompagnies`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${TOKEN}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    id: "1",
    nom: "TrackChantier",
    salarie_de_pret: false,
    loan_ids: [],
    chantiersDePret: [
      { companyId: "1", chantierId: "1" }
    ]
  })
});

Création / mise à jour d’agences. Supporte un objet unique ou un tableau d’agences.

exemple{
  "id": "1",
  "nom": "Agence Grenoble",
  "companyId": "1",
  "city": "Grenoble",
  "color": "#1976D2",
  "samsara_tracking": false,
  "display_invoice_ratio_dashboard": true,
  "display_exploitation_dashboard": true,
  "warehouse": 1,
  "show_on_dashboard": true,
  "show_on_dashboard_widget": true,
  "show_on_missing_hours_widget": false,
  "show_widget_holidays_on_dashboard": true,
  "show_widget_late_invoices": true,
  "show_widget_projects_to_invoice": true,
  "show_widget_hours_tracking": true,
  "show_widget_agora_invoices": false,
  "show_widget_acomptes_to_validate": false,
  "margin_goals": {},
  "goals": {},
  "is_principal": true
}

Référentiel de postes utilisés par les employés.

exemple[
  { "id": "1", "nom": "Chargé d'affaires",      "actif": true },
  { "id": "2", "nom": "Conducteur de travaux",  "actif": true },
  { "id": "3", "nom": "Chef de chantier",       "actif": true },
  { "id": "4", "nom": "Opérateur de chantier",  "actif": true }
]

Création / mise à jour d’employés dans la collection employees. L’API vérifie notamment que agenceId et posteId existent.

exemple[
  {
    "id": "1",
    "firstName": "Fabien",
    "lastName": "BEL",
    "poste": "Chargé d'affaires",
    "posteId": "1",
    "agence": "Agence Grenoble",
    "agenceId": "1",
    "company": "TrackChantier",
    "companyId": "1",
    "mail": "fabien@fbel.info",
    "active": true,
    "telephonePro": "+33 4 00 00 00 00",
    "adresse": {
      "rue1": "5 Rue des Écoles",
      "cp": "38210",
      "ville": "La Rivière"
    },
    "skills": [],
    "formations": {}
  }
]

Endpoint principal pour créer / mettre à jour un chantier et ses métadonnées (agence, client, dates, objectifs, hiérarchie, etc.). La plupart des champs sont conditionnés par la présence de la clef dans le body (si vous ne l’envoyez pas, la valeur existante est conservée).

exemple{
  "id": "1",
  "name": "Réhabilitation école de La Rivière",
  "start_date": "2025-11-15",
  "end_date": "2026-03-31",
  "street": "5 Rue des Écoles",
  "zip": "38210",
  "city": "La Rivière",
  "country": "FR",
  "agence": "Agence Grenoble",
  "agence_id": "1",
  "client": "Ville de La Rivière",
  "client_id": "1",
  "client_type": "public",
  "company": "TrackChantier",
  "company_id": "1",
  "number": "25001",
  "status": "demarre",
  "odoo_project": 123,
  "odoo_account": 456,
  "id_drive_folder": "DRIVE_FOLDER_ID",
  "drive": {
    "plans": "FOLDER_ID_PLANS",
    "photos": "FOLDER_ID_PHOTOS"
  },
  "advancement_hours": 120,
  "target_hours": 200,
  "times_set": true,
  "is_closed": false,
  "ca": { "id": "1", "name": "Fabien BEL" },
  "ct": { "id": "2", "name": "Nicolas Dubost" },
  "ce": { "id": "3", "name": "Jonathan Paterne" },
  "phases": [
    {
      "id": 1,
      "name": "Phase 1",
      "order": 1,
      "start_date": "2025-11-15",
      "end_date": "2025-12-15",
      "zones": [
        {
          "id": 1,
          "name": "Zone A",
          "order": 1,
          "etapes": [
            { "uuid": "etp-1", "name": "Préparation", "planned_hours": 40 }
          ]
        }
      ]
    }
  ]
}

1. /upsertPostes – créer vos postes (Chargé d’affaires, Conducteur de travaux, Chef de chantier, Opérateur…).
2. /upsertCompagnies – créer la compagnie principale (ex : id = "1", nom = "TrackChantier").
3. /upsertAgences – rattacher des agences à la compagnie (companyId = "1").
4. /upsertEmployes – créer les employés en précisant posteId + agenceId + companyId.
5. /upsertChantierFields – créer vos chantiers en pointant ca.id, ct.id, ce.id sur les employés créés à l’étape 4.

Téléchargez le fichier suivant et importez-le dans Postman :

👉 Télécharger la collection TrackChantiers – API INIT

Important : après l’import, ouvrez l’onglet Variables de la collection et configurez :

• TOKEN – le secret attendu par les endpoints (header Authorization: Bearer <TOKEN>).
• BASE_URL – l’URL de base de vos fonctions HTTP Firebase (ex: https://europe-west1-votre-projet.cloudfunctions.net).

Une fois ces variables renseignées, vous pouvez lancer les requêtes dans l’ordre recommandé (section “Flow d’init”) pour initialiser votre environnement de tests.