Skip to content

API.md

Latest commit

 

History

History
1377 lines (1003 loc) · 40.6 KB

API.md

File metadata and controls

1377 lines (1003 loc) · 40.6 KB
Raw

WebErpMesv2 — Documentation API

Base URL : /api
Format : JSON (Content-Type: application/json)
Authentification : Token API Laravel (Authorization: Bearer {token}) sauf exceptions notées

Sommaire

  1. Authentification
  2. Clients
  3. Companies
  4. Devis
  5. Articles (produits)
  6. Commandes
  7. Tâches de production
  8. Statut de tâche (MES)
  9. KPI & Dashboard
  10. Consommation énergie
  11. Export commandes
  12. Inspection qualité
  13. Collaboration — Tableaux blancs
  14. Intégration Qonto
  15. Objets de réponse

Authentification

Deux systèmes d'authentification coexistent selon l'origine de l'appel.

Routes externes — Bearer Token (Sanctum)

Utilisé pour les intégrations tierces (ERP externe, scripts, automatisations).
Token créé dans Admin → Votre société → Tokens API.

Authorization: Bearer {token}

Routes concernées :

  • GET /api/clients
  • POST /api/quote
  • PUT /api/quote/{id}
  • POST /api/product
  • PUT /api/product/{id}

Routes internes — auth:api

Utilisé historiquement pour les autres endpoints. Le guard token attend une colonne api_token sur les utilisateurs — actuellement non provisionnée, ces routes retournent 401 si appelées sans session active.

Routes publiques (sans authentification)

  • GET /api/integrations/qonto/callback — callback OAuth (state token vérifié)
  • POST /api/integrations/qonto/webhook/invoice — webhook Qonto (signature HMAC vérifiée)

Clients

GET /api/clients 🔑 Bearer

Retourne les clients actifs (statu_customer = 2) avec leurs contacts et adresses.
Utile pour les selects d'une intégration externe (devis, commandes).

Query params

Param Type Requis Description
search string Non Filtre par label ou code (LIKE)

Réponse 200

[
  {
    "id": 12,
    "code": "CLI001",
    "label": "Acier Dupont SA",
    "contacts": [
      {
        "id": 3,
        "first_name": "Jean",
        "name": "Martin",
        "mail": "j.martin@example.com",
        "number": "0387000000",
        "mobile": "0612345678",
        "default": true
      }
    ],
    "addresses": [
      {
        "id": 5,
        "label": "Siège",
        "adress": "12 rue de la Forge",
        "zipcode": "57000",
        "city": "Metz",
        "country": "France",
        "default": true
      }
    ]
  }
]

Companies

GET /api/companies

Liste paginée de toutes les companies (clients + fournisseurs), avec contacts et adresses.

Pagination : 10 par page
Query params : ?page=N

Réponse 200 → collection de CompanieResource

GET /api/companies/{id}

Détail d'une company.

Réponse 200 → CompanieResource

POST /api/companies

Crée une nouvelle company.

Body JSON

Champ Type Requis Règles
code string Oui unique, max 50
label string Oui max 255
siren string Non max 14
naf_code string Non max 10
intra_community_vat string Non max 20
website string Non URL valide, max 255
longitude string Non max 50
latitude string Non max 50
user_id integer Non doit exister dans users

Réponse 201 → CompanieResource

Devis

GET /api/quote

Liste paginée des devis avec lignes, company, contact, adresse.

Pagination : 10 par page

Réponse 200 → collection de QuoteResource

GET /api/quote/{id}

Détail complet d'un devis avec lignes, détails techniques et tâches.

Réponse 200 → QuoteResource (avec detail et tasks dans chaque ligne)

POST /api/quote 🔑 Bearer

Crée un devis avec ses lignes, détails techniques et tâches.

Body JSON — entête

Champ Type Requis Notes
code string Non Auto-généré via la codification interne si absent
label string Oui
companies_id integer Oui doit exister dans companies
companies_contacts_id integer Non doit exister dans companies_contacts
companies_addresses_id integer Non doit exister dans companies_addresses
accounting_payment_conditions_id integer Non doit exister dans accounting_payment_conditions
accounting_payment_methods_id integer Non doit exister dans accounting_payment_methods
accounting_deliveries_id integer Non doit exister dans accounting_deliveries
customer_reference string Non
validity_date date Non
statu integer Non 1=Ouvert 2=Envoyé 3=Gagné 4=Perdu 5=Clôturé
opportunities_id integer Non
comment string Non
lines array Non Si absent : aucune ligne créée

Structure d'une ligne (lines[])

Champ Type Requis si lines Notes
id integer Non Absent → création
ordre integer Oui
label string Oui
qty numeric Oui
code string Non
product_id integer Non
methods_units_id integer Non
selling_price numeric Non
discount numeric Non 0–100
accounting_vats_id integer Non
delivery_date date Non
statu integer Non
use_calculated_price boolean Non
detail object Non Voir structure ci-dessous
tasks array Non Voir structure ci-dessous

Structure du détail technique (lines[].detail)

Champ Type Notes
x_size numeric mm
y_size numeric mm
z_size numeric mm
x_oversize numeric
y_oversize numeric
z_oversize numeric
diameter numeric
diameter_oversize numeric
material string
thickness numeric mm
finishing string
weight numeric kg
bend_count integer
material_loss_rate numeric %
internal_comment string
external_comment string
custom_requirements object JSON libre

Structure d'une tâche (lines[].tasks[])

Champ Type Requis si tasks Notes
id integer Non Absent → création
label string Oui
ordre integer Non
code string Non
type integer Non 1=Prod 2=MP 3=Tôle 4=Profil 5=Bloc 6=Fournitures 7=Sous-traitance 8=Composé
qty numeric Non
qty_init numeric Non
methods_services_id integer Non
methods_units_id integer Non
methods_tools_id integer Non
products_id integer Non
seting_time numeric Non Temps de réglage (h)
unit_time numeric Non Temps unitaire (h)
unit_cost numeric Non
unit_price numeric Non
status_id integer Non
priority integer Non 1=Haute 2=Moyenne 3=Basse
delay date Non
due_date date Non
material string Non
thickness numeric Non
x_size…z_oversize numeric Non
to_schedule boolean Non
not_recalculate boolean Non

Exemple de payload complet

{
  "label": "Châssis tôle A",
  "companies_id": 1,
  "companies_contacts_id": 2,
  "companies_addresses_id": 3,
  "accounting_payment_conditions_id": 1,
  "accounting_payment_methods_id": 1,
  "accounting_deliveries_id": 1,
  "validity_date": "2026-06-30",
  "lines": [
    {
      "ordre": 1,
      "label": "Flanc latéral",
      "qty": 4,
      "selling_price": 85.00,
      "detail": {
        "material": "Acier S235",
        "thickness": 3.0,
        "x_size": 500,
        "y_size": 300,
        "finishing": "Galvanisé"
      },
      "tasks": [
        {
          "label": "Découpe laser",
          "type": 1,
          "ordre": 1,
          "qty": 4,
          "seting_time": 0.25,
          "unit_time": 0.1,
          "unit_cost": 12.00,
          "unit_price": 20.00
        }
      ]
    }
  ]
}

Réponse 201

{
  "id": 42,
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "code": "DEV-2026-042",
  "label": "Châssis tôle A",
  "...": "...",
  "quote_lines": [
    {
      "id": 101,
      "ordre": 1,
      "label": "Flanc latéral",
      "qty": 4,
      "selling_price": "85.000",
      "detail": { "material": "Acier S235", "thickness": "3.000", "x_size": "500.000", "...": "..." },
      "tasks": [
        { "id": 55, "label": "Découpe laser", "type": 1, "qty": 4, "unit_cost": "12.000", "...": "..." }
      ]
    }
  ]
}

code et uuid sont toujours présents dans la réponse, qu'ils aient été fournis ou auto-générés.

PUT /api/quote/{id} 🔑 Bearer

Met à jour un devis existant. Même payload que POST.

Comportement du sync sur les lignes et tâches

Cas Résultat
Clé lines absente du payload Lignes existantes non modifiées
lines présent, ligne avec id Mise à jour de la ligne
lines présent, ligne sans id Création d'une nouvelle ligne
Ligne existante absente du payload Soft-delete
detail fourni pour une ligne updateOrCreate sur quote_lines_id
Tâche avec id Mise à jour
Tâche sans id Création
Tâche existante absente de tasks[] Soft-delete

Réponse 200 → même structure que POST

Articles (produits)

Endpoints destinés aux intégrations externes qui créent des articles dans WEM (ex. : Nest4Quote pour les pièces issues du nesting/CAO).

GET /api/product

Liste paginée des articles avec service, famille et unité.

Pagination : 10 par page

Réponse 200 → collection de ProductResource

GET /api/product/{id}

Détail d'un article.

Réponse 200 → ProductResource

POST /api/product 🔑 Bearer

Crée un article. Conçu pour recevoir un payload depuis Nest4Quote ou tout outil externe.

Logique de résolution des références

Pour chaque référence (service, famille, unité), trois sources sont essayées dans l'ordre :

Référence 1. ID direct 2. Code (string) 3. Fallback serveur
Service methods_services_id service_code (ex. COMPO) Premier methods_services avec type=8 (composant)
Famille methods_families_id family_code Première famille rattachée au service retenu
Unité methods_units_id unit_code MethodsUnits::getDefault()

Chaque résolution par fallback ou échec de match est tracée dans storage/logs/product_import.log.

Body JSON — entête

Champ Type Requis Notes
code string Non Auto-généré via la codification interne (product) si absent ; unique
label string Oui max 255
service_code string Non Code du methods_services ; résolu vers methods_services_id
family_code string Non Code du methods_families ; résolu vers methods_families_id
unit_code string Non Code du methods_units ; résolu vers methods_units_id
methods_services_id integer Non Prioritaire sur service_code ; doit exister dans methods_services
methods_families_id integer Non Prioritaire sur family_code ; doit exister dans methods_families
methods_units_id integer Non Prioritaire sur unit_code ; doit exister dans methods_units
sold integer Non 1=oui 2=non — défaut 1
purchased integer Non 1=oui 2=non — défaut 1
tracability_type integer Non 1=lot 2=série 3=aucune — défaut 1
ind string Non Indice/révision, max 50

Body JSON — caractéristiques techniques

Champ Type Notes
material string
finishing string
thickness numeric mm
weight numeric kg
bend_count integer
x_size numeric mm
y_size numeric mm
z_size numeric mm
x_oversize numeric
y_oversize numeric
z_oversize numeric
diameter numeric
diameter_oversize numeric
section_size numeric

Body JSON — économique

Champ Type
qty_eco_min numeric
qty_eco_max numeric
purchased_price numeric
selling_price numeric

Body JSON — fichiers et commentaire

Champ Type Notes
comment string
picture string Nom de fichier image
drawing_file string Plan technique
stl_file string
svg_file string
cad_file_path string
cam_file_path string
csv_file_name string Nom du CSV d'import si l'article vient d'un import

Exemple — payload minimal

Tout est optionnel sauf label. Les fallbacks serveur prennent le relais.

{
  "label": "Tôle pliée 2mm",
  "material": "S235",
  "thickness": 2,
  "x_size": 500,
  "y_size": 300,
  "weight": 2.35
}

Exemple — payload Nest4Quote (recommandé, explicite)

{
  "label": "Flanc latéral châssis A",
  "service_code": "COMPO",
  "family_code": "TOLERIE",
  "unit_code": "PCE",
  "material": "S235",
  "finishing": "Galvanisé",
  "thickness": 3,
  "weight": 4.5,
  "bend_count": 4,
  "x_size": 500,
  "y_size": 300,
  "z_size": 60,
  "purchased_price": 8.50,
  "selling_price": 18.00,
  "drawing_file": "PLAN-A-001.pdf",
  "cad_file_path": "Z:/CAO/A-001.step",
  "cam_file_path": "Z:/CAM/A-001.lasercam"
}

Réponse 201 → ProductResource

{
  "id": 142,
  "code": "ART-2026-142",
  "label": "Flanc latéral châssis A",
  "methods_services_id": 7,
  "methods_families_id": 3,
  "methods_units_id": 1,
  "material": "S235",
  "thickness": "3.000",
  "...": "..."
}

code est toujours présent dans la réponse, qu'il ait été fourni ou auto-généré.

PUT /api/product/{id} 🔑 Bearer

Met à jour un article existant. Même payload que POST (mêmes règles de résolution *_code → *_id, mêmes fallbacks). Le champ code reste unique mais l'article courant est exclu de la contrainte d'unicité.

Réponse 200 → ProductResource

Commandes

GET /api/order

Liste paginée des commandes avec lignes, company, contact, adresse.

Pagination : 10 par page

Réponse 200 → collection de OrderResource

GET /api/order/{id}

Détail d'une commande.

Réponse 200 → OrderResource

Tâches de production

GET /api/tasks

Liste de toutes les tâches.

Réponse 200 → collection de TaskResource

GET /api/tasks/{id}

Détail d'une tâche.

Réponse 200 → TaskResource

Statut de tâche (MES)

Routes utilisées par les terminaux de production (tablettes/bornes MES).

GET /api/production/Task/Statu/Api/{id}

Détail complet d'une tâche avec tout le contexte MES.

Réponse 200

{
  "id": 42,
  "label": "Découpe laser",
  "ordre": 1,
  "type": "machining",
  "status_id": 2,
  "methods_services_id": 3,
  "order_lines_id": 15,
  "component_id": 7,
  "seting_time": 30,
  "unit_time": 45,
  "qty": 10,
  "end_date": "2026-05-10",
  "not_recalculate": false,
  "total_log_time": 120,
  "total_log_good_qt": 8,
  "total_log_bad_qt": 1,
  "total_net_good_qt": 8,
  "trs": 85.5,
  "progress": 80,
  "formatted_end_date": "10/05/2026",
  "formatted_unit_cost": "12,50 €",
  "formatted_unit_price": "18,00 €",
  "margin": 44.0,
  "total_time": 450,
  "order_qty": 10,
  "status": { "id": 2, "title": "En cours" },
  "service": { "id": 3, "label": "Laser", "type": "machine", "picture": "...", "color": "#e74c3c" },
  "resources": [{ "id": 1, "label": "Laser 3015", "picture": "...", "userforced_ressource": false }],
  "order_lines": { "id": 15, "orders_id": 5, "label": "Pièce A", "qty": 10, "order": 1, "picture": "...", "product": {} },
  "component": { "id": 7, "code": "COMP-001", "label": "Tôle acier 3mm", "drawing_file": "..." },
  "previous_task": 41,
  "next_task": 43,
  "last_activity_type": "start",
  "service_resources": [],
  "selected_resource_id": 1,
  "userforced_resource": false,
  "stock_locations": [],
  "timeline": []
}

POST /api/production/Task/Statu/Api/{id}/start

Démarre la tâche (enregistre l'activité, passe le statut à "En cours").

Réponse 200 → { "success": true }

POST /api/production/Task/Statu/Api/{id}/pause

Met la tâche en pause.

Réponse 200 → { "success": true }

POST /api/production/Task/Statu/Api/{id}/finish

Termine la tâche (statut → "Terminé").

Réponse 200 → { "success": true }

POST /api/production/Task/Statu/Api/{id}/good-qty

Déclare une quantité bonne.

Body JSON

Champ Type Requis Règles
qty numeric Oui min : 0

Réponse 200 → { "success": true }

POST /api/production/Task/Statu/Api/{id}/good-qty-stock

Déclare une quantité bonne et crée les mouvements de stock.

Body JSON

Champ Type Requis
qty numeric Oui
component_id integer Oui

Réponse 200 → { "success": true, "negative_stock": false }

POST /api/production/Task/Statu/Api/{id}/bad-qty

Déclare une quantité mauvaise (rebut).

Body JSON

Champ Type Requis Règles
qty numeric Oui min : 0

Réponse 200 → { "success": true }

PUT /api/production/Task/Statu/Api/{id}/date

Met à jour la date de fin prévue.

Body JSON

Champ Type Requis
end_date date Oui
not_recalculate boolean Non

Réponse 200 → { "success": true }

PUT /api/production/Task/Statu/Api/{id}/resource

Assigne une ressource (opérateur/machine) à la tâche.

Body JSON

Champ Type Requis Règles
resource_id integer Oui doit exister dans methods_ressources

Réponse 200 → { "success": true }

POST /api/production/Task/Statu/Api/{id}/nc

Crée une non-conformité liée à la tâche.

Réponse 200 → { "success": true, "redirect_url": "/fr/non-conformities/42" }

KPI & Dashboard

Middleware : auth, verified, has.role, check.factory

GET /api/kpi/recent/orders

Param Type Défaut Max
limit integer 5 20

Réponse 200

[{ "id": 1, "code": "CMD-001", "statu": 2, "type": "standard", "companies_id": 12, "companie_label": "Acier Dupont", "formatted_total_price": "1 250,00 €", "validity_date": "2026-05-01" }]

GET /api/kpi/recent/quotes

Param Type Défaut Max
limit integer 5 20

Réponse 200 — même structure que recent/orders avec created_at_human à la place de validity_date.

GET /api/kpi/recent/invoices

Param Type Défaut Max
limit integer 8 20

GET /api/kpi/recent/deliveries

Param Type Défaut Max
limit integer 8 20

GET /api/kpi/recent/purchases

Permission requise : purchases-menu

Param Type Défaut Max
limit integer 8 20

Retourne les achats en attente (statuts 1, 2 ou 3).

GET /api/kpi/delivery/board

Tableau des livraisons à venir et en retard.

Réponse 200

{
  "incoming": [{ "orders_id": 5, "delivery_date": "2026-05-03", "order": { "id": 5, "code": "CMD-005" } }],
  "incoming_more": 0,
  "late": [],
  "late_more": 0
}

GET /api/kpi/quotes/rate

Taux de transformation des devis par statut.

Param Type Défaut
year integer Année courante
company_id integer —

Réponse 200

{ "year": 2026, "data": [{ "statu": 2, "QuoteCountRate": 42 }] }

GET /api/kpi/orders/monthly

Chiffres mensuels commandes / livraisons / factures / achats.

Param Type Défaut
year integer Exercice en cours

Réponse 200

{
  "year": 2026,
  "fiscalYearStartMonth": 1,
  "orders": [{ "month": 1, "orderSum": 15000.0 }],
  "deliveries": [...],
  "invoices": [...],
  "purchases": [...],
  "target": { "amount1": 20000, "amount2": 20000, "...": "..." }
}

purchases et target sont null si l'utilisateur n'a pas la permission purchases-menu.

GET /api/kpi/top-clients

Top 5 clients par chiffre d'affaires (tous temps).

Réponse 200

[{ "companies_id": 12, "total_amount": 85000.0, "companie": { "label": "Acier Dupont SA" } }]

GET /api/kpi/nc-stats

Statistiques qualité (non-conformités).

Réponse 200

{
  "internalNonConformityRate": 2.3,
  "externalNonConformityRate": 0.8
}

GET /api/kpi/supplier-delays

Délai moyen de réception par fournisseur, trié par délai croissant.

Permission requise : purchases-menu

GET /api/kpi/otd

On-Time Delivery — taux de livraisons à l'heure.

Réponse 200

{ "rate": 91.5, "onTime": 183, "total": 200 }

GET /api/kpi/mood

Humeur de l'équipe pour aujourd'hui.

Réponse 200

{
  "myMood": "happy",
  "date": "2026-04-27",
  "team": [{ "user_id": 3, "name": "Jean Martin", "mood": "neutral" }],
  "counts": { "happy": 3, "neutral": 1, "sad": 0 }
}

POST /api/kpi/mood

Enregistre ou met à jour l'humeur de l'utilisateur connecté pour aujourd'hui.

Body JSON

Champ Type Valeurs autorisées
mood string happy, neutral, sad

Réponse 200 → même structure que GET /api/kpi/mood

Consommation énergie

GET /api/energy-consumptions

Liste des consommations avec la ressource associée.

POST /api/energy-consumptions

Body JSON

Champ Type Requis Règles
methods_ressource_id integer Oui doit exister dans methods_ressources
kwh numeric Oui
cost_per_kwh numeric Oui

Réponse 201 → objet créé avec relation methodsRessource

Export commandes

GET /api/exports/sales-orders

Export des commandes en JSON pour intégration comptable ou ERP externe.

Query params

Param Type Requis Description
from date Non Date de début
to date Non Date de fin (≥ from)
status integer Non Filtre par statut
date_format string Non Format des dates (défaut Y-m-d)
datetime_format string Non Format des datetimes (défaut Y-m-d H:i:s)
include_lines boolean Non Inclure les lignes de commande

Réponse 200

{
  "data": [ { "...": "..." } ],
  "meta": { "count": 42 }
}

Inspection qualité

Ces routes utilisent le middleware auth:api.

GET /api/inspection-projects/{id}

Détail d'un projet d'inspection.

GET /api/inspection-sessions/{id}

Détail d'une session de mesure.

POST /api/inspection-measures

Crée une mesure.

PUT /api/inspection-measures/{id}

Met à jour une mesure.

POST /api/inspection-nonconformities

Crée une non-conformité liée à une inspection.

Collaboration — Tableaux blancs

GET /api/collaboration/whiteboards

Liste de tous les tableaux blancs (plus récent en premier).

POST /api/collaboration/whiteboards

Crée un tableau blanc.

Body JSON

Champ Type Requis Règles
title string Non max 255, défaut : "Nouveau tableau"
state any Non JSON libre

Réponse 201 → tableau blanc avec relations snapshots et files

GET /api/collaboration/whiteboards/{id}

Détail avec snapshots et fichiers.

PUT /api/collaboration/whiteboards/{id}

Met à jour le titre ou l'état (canvas).

Body JSON — mêmes champs que POST

GET /api/collaboration/whiteboards/{id}/snapshots

Liste des snapshots (plus récent en premier).

POST /api/collaboration/whiteboards/{id}/snapshots

Crée un snapshot.

Body JSON

Champ Type Requis
state any Oui

Réponse 201

GET /api/collaboration/whiteboards/{id}/files

Liste des fichiers attachés.

POST /api/collaboration/whiteboards/{id}/files

Upload de fichiers (multipart/form-data).

Form-data

Champ Type Règles
files[] file max 10 Mo par fichier

Réponse 201 — tableau d'objets fichiers :

[{ "original_name": "plan.pdf", "path": "whiteboards/...", "mime_type": "application/pdf", "size": 204800, "uploaded_by": 3 }]

Intégration Qonto

GET /api/integrations/qonto/status

État de la connexion Qonto.

Réponse 200

{
  "feature_enabled": true,
  "connected": true,
  "last_sync_at": "2026-04-26T14:30:00Z",
  "import_bidirectionnel": false,
  "scope": "openid offline_access ..."
}

GET /api/integrations/qonto/connect

Lance le flux OAuth Qonto.

Réponse 200

{ "authorization_url": "https://oauth.qonto.com/...", "state": "abc123" }

GET /api/integrations/qonto/callback (public)

Callback OAuth. Reçoit code + state en query params. Redirige vers les paramètres d'intégration.

POST /api/integrations/qonto/clients/sync

Synchronise les clients WEM → Qonto (crée ceux absents dans Qonto).

Body JSON (optionnel)

Champ Type
import_bidirectionnel boolean

POST /api/integrations/qonto/clients/reconcile

Réconcilie sans créer — identifie les doublons et conflits.

POST /api/integrations/qonto/clients/{wemClientId}/push

Pousse un client individuel vers Qonto.

Réponse 200 → { "mapping": { "...": "..." } }

POST /api/integrations/qonto/clients/{reviewId}/resolve

Résout un conflit de synchronisation.

Body JSON

Champ Type Requis Valeurs
action string Oui link, ignore
qonto_client_id string Non requis si action = link

POST /api/integrations/qonto/settings

Met à jour les paramètres de l'intégration.

Body JSON

Champ Type Requis
import_bidirectionnel boolean Oui

POST /api/integrations/qonto/disconnect

Déconnecte et supprime les tokens Qonto.

Réponse 200 → { "disconnected": true }

POST /api/integrations/qonto/invoices/{invoiceId}/submit

Soumet une facture à Qonto.

Uniquement pour les factures de type 1 (pas les avoirs). Erreur 422 sinon.

POST /api/integrations/qonto/invoices/{invoiceId}/poll

Interroge Qonto pour le statut mis à jour d'une facture.

POST /api/integrations/qonto/webhook/invoice (public — HMAC vérifié)

Reçoit les mises à jour de statut de facture depuis Qonto.

Objets de réponse

CompanieResource

{
  "id": 12,
  "name": null,
  "code": "CLI001",
  "label": "Acier Dupont SA",
  "siren": "123456789",
  "naf_code": "2511Z",
  "intra_community_vat": "FR12123456789",
  "website": "https://example.com",
  "longitude": "6.1757",
  "latitude": "49.1193",
  "created_at": "01/01/2026",
  "contacts": [{ "id": 3, "first_name": "Jean", "name": "Martin", "mail": "j.martin@example.com", "number": "0387000000" }],
  "addresses": [{ "id": 5, "adress": "12 rue de la Forge", "zipcode": "57000", "city": "Metz", "province": null, "country": "France" }]
}

ContactResource

{ "civility": "M.", "first_name": "Jean", "name": "Martin", "number": "0387000000", "mobile": "0612345678", "mail": "j.martin@example.com" }

AdresseResource

{ "adress": "12 rue de la Forge", "zipcode": "57000", "city": "Metz", "province": null, "country": "France", "number": "0387000000", "mail": "contact@example.com" }

QuoteResource

{
  "id": 7,
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "code": "DEV-2026-007",
  "label": "Châssis acier",
  "customer_reference": "REF-CLIENT-42",
  "companies_id": { "...": "CompanieResource" },
  "companies_contacts_id": { "...": "ContactResource" },
  "companies_addresses_id": { "...": "AdresseResource" },
  "accounting_payment_conditions_id": { "label": "30 jours net" },
  "accounting_payment_methods_id": { "label": "Virement" },
  "accounting_deliveries_id": { "label": "Franco" },
  "validity_date": "2026-05-31",
  "statu": 1,
  "comment": "Urgent",
  "created_at": "2026-04-01T08:00:00.000000Z",
  "updated_at": "2026-04-15T10:30:00.000000Z",
  "quote_lines": [
    {
      "id": 101,
      "quotes_id": 7,
      "ordre": 1,
      "code": "L001",
      "product_id": null,
      "label": "Flanc latéral",
      "qty": "4.000",
      "methods_units_id": 1,
      "selling_price": "85.000",
      "discount": "0.000",
      "accounting_vats_id": 1,
      "delivery_date": "2026-06-15",
      "statu": 1,
      "use_calculated_price": false,
      "detail": {
        "id": 88,
        "quote_lines_id": 101,
        "x_size": "500.000",
        "y_size": "300.000",
        "z_size": null,
        "material": "Acier S235",
        "thickness": "3.000",
        "finishing": "Galvanisé",
        "weight": "4.500",
        "internal_comment": null,
        "external_comment": null,
        "custom_requirements": null
      },
      "tasks": [
        {
          "id": 55,
          "label": "Découpe laser",
          "ordre": 1,
          "type": 1,
          "qty": 4,
          "quote_lines_id": 101,
          "methods_services_id": 3,
          "seting_time": "0.250",
          "unit_time": "0.100",
          "unit_cost": "12.000",
          "unit_price": "20.000",
          "status_id": 1,
          "to_schedule": false,
          "not_recalculate": false
        }
      ],
      "created_at": "2026-04-01T08:00:00.000000Z",
      "updated_at": "2026-04-15T10:30:00.000000Z"
    }
  ]
}

detail et tasks ne sont présents que sur GET /api/quote/{id}, POST /api/quote et PUT /api/quote/{id}.
GET /api/quote (liste) ne charge pas ces relations.

ProductResource

{
  "id": 142,
  "code": "ART-2026-142",
  "label": "Flanc latéral châssis A",
  "ind": null,
  "methods_services_id": 7,
  "methods_families_id": 3,
  "methods_units_id": 1,
  "purchased": 1,
  "purchased_price": "8.500",
  "sold": 1,
  "selling_price": "18.000",
  "material": "S235",
  "finishing": "Galvanisé",
  "thickness": "3.000",
  "weight": "4.500",
  "bend_count": 4,
  "x_size": "500.000",
  "y_size": "300.000",
  "z_size": "60.000",
  "x_oversize": null,
  "y_oversize": null,
  "z_oversize": null,
  "diameter": null,
  "diameter_oversize": null,
  "section_size": null,
  "qty_eco_min": null,
  "qty_eco_max": null,
  "tracability_type": 1,
  "comment": null,
  "picture": null,
  "drawing_file": "PLAN-A-001.pdf",
  "stl_file": null,
  "svg_file": null,
  "cad_file_path": "Z:/CAO/A-001.step",
  "cam_file_path": "Z:/CAM/A-001.lasercam",
  "csv_file_name": null,
  "created_at": "2026-05-04T09:15:00.000000Z",
  "updated_at": "2026-05-04T09:15:00.000000Z"
}

OrderResource

{
  "id": 5,
  "uuid": "...",
  "code": "CMD-2026-005",
  "label": "Châssis acier",
  "customer_reference": "REF-CLIENT-42",
  "companies_id": { "...": "CompanieResource" },
  "companies_contacts_id": { "...": "ContactResource" },
  "companies_addresses_id": { "...": "AdresseResource" },
  "accounting_payment_conditions_id": { "label": "30 jours net" },
  "accounting_payment_methods_id": { "label": "Virement" },
  "accounting_deliveries_id": { "label": "Franco" },
  "validity_date": "2026-05-31",
  "statu": 2,
  "comment": null,
  "created_at": "2026-04-01T08:00:00.000000Z",
  "updated_at": "2026-04-15T10:30:00.000000Z",
  "order_lines": []
}

TaskResource

{
  "id": 42, "name": "OP10", "label": "Découpe laser",
  "ordre": 1, "quote_lines_id": null, "order_lines_id": 15,
  "products_id": 7, "sub_assembly_id": null,
  "methods_services_id": 3,
  "setting_time": 30, "unit_time": 45, "remaining_time": 90,
  "status_id": 2, "type": "machining", "delay": 0,
  "qty": 10, "qty_init": 10, "qty_aviable": 10,
  "unit_cost": 12.5, "unit_price": 18.0, "methods_units_id": 1,
  "x_size": 500, "y_size": 300, "z_size": 3,
  "x_oversize": 10, "y_oversize": 10, "z_oversize": 0,
  "diameter": null, "diameter_oversize": null,
  "to_schedule": true, "end_date": "2026-05-10", "not_recalculate": false,
  "material": "Acier S235", "thickness": 3.0, "weight": 4.5
}

Dernière mise à jour : 2026-05-04 — Ajout section Articles (POST/PUT /api/product) pour intégration Nest4Quote, résolution service_code/family_code/unit_code avec fallbacks