Ir al contenido

Catalogo API (Portelcore)

Documentazione live degli endpoint analitici OData V4 distribuiti in produzione e dei relativi schemi di dati.

0letture

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.

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}')/

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’.
  • Schema di Colonne (Mappatura pulita):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • 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*’).
  • Schema di Colonne:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor e Nombre_Proveedor
    • Descripcion
    • Cantidad e Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada e Fecha_Estimada
  • 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 (Status in Open o Released).
  • Schema di Colonne:
    • Stato
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad e Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ Base URL: Instradamento standardizzato che punta al publisher aziendale portelcore nella sua versione API v1.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.