API-Katalog (Portelcore)
Lebendige Dokumentation der produktiven OData V4-Analyse-Endpoints und deren Datenschemata.
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.
🔗 Basis-URL des Ökosystems
Sección titulada «🔗 URL Base del Ecosistema»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}')/
1. Produktbewegungen (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»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.
- Datensätze mit
- Spaltenschema (saubere Zuordnung):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Bestellpositionen (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- 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*’).
- Nur Dokumente vom Typ Bestellung (
- Spaltenschema:
Tipo_DocumentoNum_DocumentoNum_ProveedorundNombre_ProveedorDescripcionCantidadundCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaundFecha_Estimada
3. Verkaufspositionen (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- 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 (
Statusin Open oder Released).
- Nur Dokumente vom Typ Bestellung (
- Spaltenschema:
- Status
Num_DocumentoNombre_ClienteDescripcionCantidadundCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Checkliste für die Katalogintegrität
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Base URL: Standardisiertes Routing, das auf den Unternehmens-Publisher
portelcorein seiner API-Versionv1.0verweist. - ✓ 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.

