Ir al contenido

API-Katalog (Portelcore)

Lebendige Dokumentation der produktiven OData V4-Analyse-Endpoints und deren Datenschemata.

0Lesungen

Als Teil unserer Business-Intelligence- und Data-Governance-Strategie haben wir eine Suite optimierter nativer APIs bereitgestellt. Dieses Dokument dient als Single Source of Truth für jeden Ingenieur, Datenanalysten oder Prozess (Power BI, Python, Power Automate), der eine Verbindung zum ERP herstellen muss.

Alle OData-Aufrufe müssen auf diese Routingbasis zeigen: https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/

Dieser Endpunkt ist das Herzstück der Logistik. Er extrahiert die konsolidierten Informationen aus der Tabelle Item Ledger Entry (Produktbewegungen) und stellt den vollständigen Verlauf von Eingängen und Ausgängen bereit.

  • OData-Endpunkt: /movimientos
  • Quelltabelle: Item Ledger Entry
  • Filter am Ursprung (Pushdown):
    • Datensätze mit Global Dimension 1 Code = ‘20’ werden ausgeschlossen.
    • Beschränkt auf die Typen: Einkäufe, Verkäufe und positive/negative Anpassungen.
    • Der fiktive Lieferant ‘PROVEEDOR_DEMO’ wird weggelassen.
  • Spaltenschema (saubere Zuordnung):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • Endpoint OData: /lineasCompra
  • Quelltable: Purchase Line
  • Filter am Ursprung (Pushdown):
    • Nur Dokumente vom Typ Bestellung (Order ).
    • Nur ausstehende Mengen ungleich 0 (Outstanding Quantity <> 0).
    • Nur Lieferanten, deren Code mit P40 beginnt (Buy-from Vendor No. = ‘P40*’).
  • Spaltenschema:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor und Nombre_Proveedor
    • Descripcion
    • Cantidad und Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada und Fecha_Estimada
  • Endpoint OData: /lineasVenta
  • Quelltabelle: Sales Line
  • Filter am Ursprung (Pushdown):
    • Nur Dokumente vom Typ Bestellung (Order ).
    • Nur ausstehende Mengen ungleich 0.
    • Nur offene oder veröffentlichte Status (Status in Open oder Released).
  • Spaltenschema:
    • Status
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad und Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
Sección titulada «4. Checklist de Integridad de Catálogo»
  • ✓ Base URL: Standardisiertes Routing, das auf den Unternehmens-Publisher portelcore in seiner API-Version v1.0 verweist.
  • ✓ Schemata: Standardisiertes Feldmapping ohne Sonderzeichen oder Leerzeichen, um die Datenaufnahme zu beschleunigen.
  • ✓ Wesentliche Filter: Vollständig dokumentierte Quellfilter (Pushdown), die direkt auf die physischen ERP-Tabellen angewendet werden.