Ir al contenido

API-catalogus (Portelcore)

Levende documentatie van de OData V4 analytische endpoints die in productie zijn uitgerold en hun dataschema's.

0lecturas

Als onderdeel van onze Business Intelligence- en data governance-strategie hebben we een suite van geoptimaliseerde native API's geïmplementeerd. Dit document dient als de enige bron van waarheid voor elke engineer, data-analist of proces (Power BI, Python, Power Automate) dat verbinding moet maken met het ERP.

Alle OData-aanroepen moeten naar deze routebasis wijzen: https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/

Dit endpoint is het hart van de logistiek. Het haalt geconsolideerde informatie op uit de tabel Item Ledger Entry (Productbewegingen), waarbij het volledige historische overzicht van in- en uitgaande stromen wordt verstrekt.

  • OData-endpoint: /movimientos
  • Bron-tabel: Item Ledger Entry
  • Filters at Source (Pushdown):
    • Records met Global Dimension 1 Code = ‘20’ worden overgeslagen.
    • Beperkt tot typen: Inkopen, Verkopen en Positieve/Negatieve Aanpassingen.
    • De fictieve leverancier ‘PROVEEDOR_DEMO’ wordt weggelaten.
  • Column Schema (Clean Mapping):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • OData-endpoint: /lineasCompra
  • Bron-tabel: Purchase Line
  • Filters at Source (Pushdown):
    • Alleen documenten van het type Inkooporder (Order).
    • Only pending amounts different from 0 (Outstanding Quantity <> 0).
    • Alleen leveranciers waarvan de code begint met P40 (Buy-from Vendor No. = ‘P40*’).
  • Column Schema:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor en Nombre_Proveedor
    • Descripcion
    • Cantidad en Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada en Fecha_Estimada
  • OData-endpoint: /lineasVenta
  • Bron-tabel: Sales Line
  • Filters at Source (Pushdown):
    • Alleen documenten van het type Inkooporder (Order).
    • Alleen openstaande hoeveelheden ongelijk aan 0.
    • Alleen Open of Released statussen (Status in Open of Released).
  • Column Schema:
    • Status
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad en Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ Base URL: Standaard routeren naar de corporate publisher portelcore in zijn API-versie v1.0.
  • ✓ Schema's: Gestandaardiseerde veldmapping zonder speciale tekens of spaties om de data-ingestie te versnellen.
  • ✓ Kernfilters: Filters aan de bron (pushdown) volledig gedocumenteerd en direct toegepast op de fysieke ERP-tabellen.