Catalogo API (Portelcore)
Documentazione live degli endpoint analitici OData V4 distribuiti in produzione e dei relativi schemi di dati.
Come parte della nostra strategia di Business Intelligence e data governance, abbiamo implementato una suite di API native ottimizzate. Questo documento funge da unica fonte di verità per qualsiasi ingegnere, analista di dati o processo (Power BI, Python, Power Automate) che necessiti di connettersi all'ERP.
🔗 URL Base dell'Ecosistema
Sección titulada «🔗 URL Base del Ecosistema»Tutte le chiamate OData devono puntare a questa base di instradamento:
https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/
1. Movimenti di Prodotto (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»Questo endpoint è il cuore della logistica. Estrae le informazioni consolidate dalla tabella Item Ledger Entry (Movimenti di Prodotto), fornendo lo storico completo di entrate e uscite.
- Endpoint OData:
/movimientos - Tabella Sorgente:
Item Ledger Entry - Filtri in Origine (Pushdown):
- Vengono omessi i record con
Global Dimension 1 Code= ‘20’. - Limitato ai tipi: Acquisti, Vendite e Rettifiche Positive/Negative.
- Viene omesso il fornitore fittizio ‘PROVEEDOR_DEMO’.
- Vengono omessi i record con
- Schema di Colonne (Mappatura pulita):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Righe di acquisto (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- Endpoint OData:
/lineasCompra - Tabella di origine:
Purchase Line - Filtri in Origine (Pushdown):
- Solo documenti di tipo Ordine (
Order). - Solo quantità pendenti diverse da 0 (
Outstanding Quantity <> 0). - Solo fornitori il cui codice inizia con P40 (
Buy-from Vendor No.= ‘P40*’).
- Solo documenti di tipo Ordine (
- Schema di Colonne:
Tipo_DocumentoNum_DocumentoNum_ProveedoreNombre_ProveedorDescripcionCantidadeCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaeFecha_Estimada
3. Righe di vendita (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- Endpoint OData:
/lineasVenta - Tabella di Origine:
Sales Line - Filtri in Origine (Pushdown):
- Solo documenti di tipo Ordine (
Order). - Solo quantità in sospeso diverse da 0.
- Solo stati Aperti o Rilasciati (
Statusin Open o Released).
- Solo documenti di tipo Ordine (
- Schema di Colonne:
- Stato
Num_DocumentoNombre_ClienteDescripcionCantidadeCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Checklist di Integrità del Catalogo
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Base URL: Instradamento standardizzato che punta al publisher aziendale
portelcorenella sua versione APIv1.0. - ✓ Schemi: Mappatura dei campi standardizzata senza caratteri speciali o spazi per velocizzare l'ingestione dei dati.
- ✓ Filtri Chiave: Filtri all'origine (pushdown) completamente documentati e applicati direttamente sulle tabelle fisiche dell'ERP.

