API-catalogus (Portelcore)
Levende documentatie van de OData V4 analytische endpoints die in productie zijn uitgerold en hun dataschema's.
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.
🔗 Basis-URL van het Ecosysteem
Sección titulada «🔗 URL Base del Ecosistema»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}')/
1. Productbewegingen (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»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.
- Records met
- Column Schema (Clean Mapping):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Inkoopregels (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- 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*’).
- Alleen documenten van het type Inkooporder (
- Column Schema:
Tipo_DocumentoNum_DocumentoNum_ProveedorenNombre_ProveedorDescripcionCantidadenCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaenFecha_Estimada
3. Verkoopregels (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- 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 (
Statusin Open of Released).
- Alleen documenten van het type Inkooporder (
- Column Schema:
- Status
Num_DocumentoNombre_ClienteDescripcionCantidadenCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Checklist Catalogusintegriteit
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Base URL: Standaard routeren naar de corporate publisher
portelcorein zijn API-versiev1.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.

