Katalóg API (Portelcore)
Živá dokumentácia analytických endpointov OData V4 nasadených vo výrobe a ich dátové schémy.
V rámci našej stratégie Business Intelligence a správy dát sme nasadili optimalizovanú sadu natívnych API. Tento dokument slúži ako jediný bod pravdy pre akéhokoľvek inžiniera, dátového analytika alebo procesu (Power BI, Python, Power Automate), ktorý potrebuje pripojiť sa k ERP.
🔗 Základná adresa ekosystému
Sección titulada «🔗 URL Base del Ecosistema»Všetky volania OData musia smerovať k tejto základnej trase:
https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/
1. Pohyby produktu (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»Tento endpoint je srdcom logistiky. Extrahuje konsolidované informácie z tabuľky Item Ledger Entry (Pohyby produktu), poskytujúc kompletnú históriu vstupov a výstupov.
- Endpoint OData:
/movimientos - Zdrojová tabuľka:
Item Ledger Entry - Filtrovanie na zdroji (Pushdown):
- Sú vynechané záznamy s
Global Dimension 1 Code= ‘20’. - Obmedzené na typy: Nákupy, Predaje a Pozitívne/Záporné úpravy.
- Je vynechaný fiktívny dodávateľ 'PROVEEDOR_DEMO'.
- Sú vynechané záznamy s
- Schémy stĺpcov (čisté mapovanie):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Riadky nákupu (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- OData Endpoint:
/lineasCompra - Pôvodná tabuľka:
Purchase Line - Filtrovanie na zdroji (Pushdown):
- Iba dokumenty typu objednávka (
Order). - Iba rôzne čiastky záväzkov ako 0 (
Outstanding Quantity <> 0). - Iba dodávatelia, ktorých kód začína na P40 (
Buy-from Vendor No.= ‘P40*’).
- Iba dokumenty typu objednávka (
- Schéma stĺpcov:
Tipo_DocumentoNum_DocumentoNum_ProveedoraNombre_ProveedorDescripcionCantidadaCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaaFecha_Estimada
3. Riadky predaja (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- OData Endpoint:
/lineasVenta - Pôvodná tabuľka:
Sales Line - Filtrovanie na zdroji (Pushdown):
- Iba dokumenty typu objednávka (
Order). - Iba čakajúce množstvá rôzne od 0.
- Iba otvorené alebo spustené stavy (
Statusv Open alebo Released).
- Iba dokumenty typu objednávka (
- Schéma stĺpcov:
- Stav
Num_DocumentoNombre_ClienteDescripcionCantidadaCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Kontrolný zoznam integrity katalógu
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Základná adresa URL: Štandardizované smerovanie ukazujúce na firemného vydavateľa
portelcorevo verzii APIv1.0. - ✓ Schémy: Štandardizované mapovanie polí bez špeciálnych znakov alebo medzier pre rýchle spracovanie údajov.
- ✓ Kľúčové filtre: Filtre na pôvode (pushdown) úplne zdokumentované a aplikované priamo na fyzické tabuľky ERP.

