Intégration ERP et MES

Cette page s'adresse à l'ingénieur d'intégration qui raccorde Scalarcut à un ERP, un MES ou un contrôleur de table de découpe.

Le document Factory MBOM atteint vos systèmes de deux façons :

• Export du planificateur — un utilisateur Enterprise planifie dans le planificateur et clique sur le bouton Factory MBOM pour télécharger le JSON et le CSV.
• API HTTP — votre middleware récupère le même document via le point de terminaison à clé.

Les deux produisent le même schéma scalarcut.factory_bom.v1.1 ; le mappage ci-dessous s'applique aux deux.

Choisissez JSON ou CSV

• JSON est le document complet : en-tête, pièces, recettes, consommables, totaux et geometry optionnel. Utilisez-le quand votre middleware peut consommer du JSON structuré.
• CSV est uniquement la liste de pièces — les colonnes plates à déposer directement dans une table de découpe ou un import de tableur. L'emballage, les ids, les tarifs et les totaux ne sont pas dans le CSV.

Les deux décrivent la même liste de découpe ; le CSV est une projection avec perte des pièces JSON.

Mappage des champs

Champ Factory MBOM	Cible ERP / MES typique
schema	Verrou de version de contrat (épingler à scalarcut.factory_bom.v1.1)
scene_id / project_id	Clé d'ordre de fabrication / ordre de travail
surface_id	Zone ou ligne (wall-a…wall-d, floor)
group_id	Clé de routage stable pour un groupe de coupe
letter	Légende lisible de la liste de découpe pour l'atelier
sku	Référence article / fiche article
w_mm / h_mm	Dimensions de coupe pour la table de découpe
cut_type	Stratégie de coupe / centre de travail
qty	Quantité de commande pour le groupe
fragile	Blocage qualité / indicateur de manipulation manuelle
cre_recycled / cre_parent	Traçabilité du recyclage vers le carreau d'origine
is_l_cut	Routage de coupe en L
rates	Constantes de formule des consommables
totals.cut_qty	Audit contre l'en-tête de la liste de découpe du plan
totals.boxes_to_order	Cartons à acheter

Récupérations idempotentes

Le point de terminaison est un GET avec ETag. Sondez avec If-None-Match pour qu'une requête inchangée renvoie 304 au lieu de retraiter le document. Traitez la combinaison scene_id/project_id + ETag comme votre clé d'idempotence lors de l'ingestion dans une file.

Récupérer, pas pousser

Il y a deux voies de livraison. Un utilisateur peut exporter le document depuis le bouton d'en-tête du planificateur (télécharge JSON + CSV). Pour l'automatisation, votre middleware peut récupérer le document via l'API HTTP à la demande — il n'y a pas de push par webhook dans cette version. Planifiez votre sondage à votre rythme et appuyez-vous sur l'ETag.

Coupes fragiles

Une coupe sous le seuil de fragilité de 50 mm est marquée fragile: true. Orientez-les vers une manipulation manuelle plutôt que vers une machine qui les briserait. Sliver Guard tente déjà de réancrer les agencements pour les éviter ; l'indicateur est le dernier filet de sécurité.

Consommables

La colle, le joint et l'apprêt sont toujours présents dans les rates et totals de Factory MBOM — à l'opposé du panier du Online Store Widget, où les consommables sont une ligne de panier optionnelle. Mappez rates une fois sur vos constantes de formule ; le document porte les kg/L calculés, vous n'avez donc pas à les recalculer.

Audit

totals.cut_qty doit être égal à la somme des qty des pièces. À l'ingestion d'un document, rapprochez totals.cut_qty de l'en-tête de la liste de découpe du plan de la même scène. Tout écart signifie que l'agencement a changé entre l'export et l'ingestion — récupérez à nouveau avant de lancer en production.

Récupérer un projet par id

Votre middleware récupère un projet par son scene_id (ou project_id) avec votre Enterprise Key. La requête est limitée à votre entreprise, vous ne récupérez donc que vos propres projets. Le fixture du garage est un échantillon public pour les essais d'intégrateurs et le panneau Try MBOM API, pas le seul document que sert le point de terminaison.