Ir al contenido

Katalóg API (Portelcore)

Živá dokumentácia analytických endpointov OData V4 nasadených vo výrobe a ich dátové schémy.

0lecturas

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}')/

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'.
  • Schémy stĺpcov (čisté mapovanie):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • 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*’).
  • Schéma stĺpcov:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor a Nombre_Proveedor
    • Descripcion
    • Cantidad a Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada a Fecha_Estimada
  • 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 (Status v Open alebo Released).
  • Schéma stĺpcov:
    • Stav
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad a Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ Základná adresa URL: Štandardizované smerovanie ukazujúce na firemného vydavateľa portelcore vo verzii API v1.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.