API REST per Integrazione ERP

API REST per integrazione MES-ERP nell'Industria 4.0

Il modulo API REST di PLCinCloud espone un set ricco di endpoint HTTP per integrare il MES con il gestionale ERP aziendale in modo bidirezionale: anagrafiche e ordini fluiscono dall'ERP al MES, consuntivi e dati di processo fluiscono dal MES all'ERP. È il cuore dell'API-first architecture di PLCinCloud, progettata per non sostituire l'ERP esistente ma per affiancarlo e arricchirlo con i dati di stabilimento.

ERP supportati nativamente

Le API REST sono compatibili out-of-the-box con i principali gestionali ERP del mercato italiano:

• SAP Business One e SAP S/4HANA: connettore via DI API o OData.
• Microsoft Dynamics 365 Business Central / Finance & Operations: integrazione tramite Power Automate o connettori custom.
• Zucchetti Ad Hoc Enterprise / Infinity: tramite middleware REST o Trigger.
• TeamSystem Enterprise / Reviso: API REST native.
• Sage X3 e Sage 50: tramite Sage Web Services.
• Odoo: tramite XML-RPC o REST API.
• Oracle NetSuite: tramite SuiteScript REST endpoints.
• Qualsiasi gestionale custom in grado di fare chiamate HTTP REST.

Endpoint principali

Articoli

• POST api/erp/crea_articolo/{token} — l'ERP crea un articolo nel MES.
• PUT api/erp/aggiorna_articolo/{token} — aggiornamento incrementale.
• GET api/erp/lista_articoli/{token} — il MES espone la lista al gestionale.
• DELETE api/erp/elimina_articolo/{token} — eliminazione (soft delete).

Distinte basi (BOM)

• POST api/erp/crea_distinta_base/{token} — l'ERP invia la BOM completa.
• GET api/erp/leggi_distinta_base/{token} — lettura BOM dal MES.
• DELETE api/erp/elimina_distinta_base/{token}.

Ordini di lavoro

• POST api/erp/crea_odl/{token} — l'ERP lancia un ODL nel MES.
• GET api/erp/lista_odl/{token} — lista ODL aperti/chiusi.
• GET api/erp/dettaglio_odl/{token} — dettaglio singolo ordine.
• GET api/erp/consuntivi_odl/{token} — pezzi fatti/scartati/durata reale per la rendicontazione contabile.

Letture custom per BI

• GET api/erp/leggi_letture_custom/{token} — dump dei dati di processo grezzi.
• GET api/erp/leggi_letture_custom_aggregate/{token} — letture aggregate per timeframe (oraria, giornaliera, settimanale).
• GET api/erp/ultima_lettura_custom/{token} — l'ultimo valore letto per un tag specifico.

Anagrafiche di supporto

• GET api/erp/lista_materiali/{token}
• GET api/erp/lista_fasi/{token}
• GET api/erp/lista_plc/{token}

Sync bidirezionale

• api/sync_orders/{token} — riconciliazione ordini.
• api/sync_articles/{token} — riconciliazione articoli.
• api/get_orders/{token} — pull ordini con paginazione.

Sicurezza e autenticazione

Tutte le API REST sono protette da token cliente univoco, generato in fase di onboarding e univoco per ogni tenant (azienda). Il token funge da credenziale e da identificatore di tenant, garantendo che ogni cliente acceda solo ai propri dati. La trasmissione avviene esclusivamente via HTTPS con TLS 1.2+, con rate limiting per prevenire abusi.

Documentazione OpenAPI/Swagger

L'API è documentata in formato OpenAPI 3.0 (Swagger), accessibile via portale sviluppatori. Sono disponibili:

• Specifica YAML/JSON scaricabile.
• Try-it-out interattivo per testare gli endpoint.
• Esempi di payload per ogni operazione.
• Codici di errore e troubleshooting.
• SDK auto-generati (Python, Node.js, Java, C#) on demand.

API per Business Intelligence

Gli endpoint letture custom aggregate sono ottimizzati per il consumo da parte di piattaforme BI (Power BI, Tableau, Looker, Qlik): aggregazioni precomputate per timeframe, paginazione, filtri temporali. Permettono di costruire dashboard executive con KPI di stabilimento sempre aggiornati senza overhead sul database operativo del MES.