Katalog API (Portelcore)
Živá dokumentace analytických OData V4 endpointů nasazených do produkce a jejich schémat dat.
Jako součást naší strategie Business Intelligence a správy dat jsme nasadili sadu optimalizovaných nativních API. Tento dokument slouží jako jediný zdroj pravdy pro každého inženýra, datového analytika nebo proces (Power BI, Python, Power Automate), který se potřebuje připojit k ERP.
🔗 Základní URL ekosystému
Sección titulada «🔗 URL Base del Ecosistema»Todas las llamadas OData deben apuntar a esta base de enrutamiento:\r
https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/
1. Pohyby produktů (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»Tento endpoint je srdcem logistiky. Extrahuje konsolidované informace z tabulky Item Ledger Entry (Pohyby produktů) a poskytuje kompletní historii vstupů a výstupů.
- OData endpoint:
/movimientos - Zdrojová tabulka:
Item Ledger Entry - Filtrování na zdroji (Pushdown):
- Záznamy s
Global Dimension 1 Code= '20' jsou vynechány. - Omezeno na typy: Nákupy, Prodeje a Kladné/Záporné úpravy.
- Fiktivní dodavatel ‘PROVEEDOR_DEMO’ je vynechán.
- Záznamy s
- Schéma sloupců (čisté mapování):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Nákupní položky (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- Endpoint OData:
/lineasCompra - Zdrojová tabulka:
Purchase Line - Filtrování na zdroji (Pushdown):
- Pouze dokumenty typu Objednávka (
Order). - Pouze nevyrovnané částky různé od 0 (
Outstanding Quantity <> 0). - Pouze dodavatelé, jejichž kód začíná na P40 (
Buy-from Vendor No.= ‘P40*’).
- Pouze dokumenty typu Objednávka (
- Schéma sloupců:
Tipo_DocumentoNum_DocumentoNum_ProveedoraNombre_ProveedorDescripcionCantidadaCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaaFecha_Estimada
3. Prodejní řádky (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- OData endpoint:
/lineasVenta - Zdrojová tabulka:
Sales Line - Filtrování na zdroji (Pushdown):
- Pouze dokumenty typu Objednávka (
Order). - Pouze nevyřízená množství různá od 0.
- Pouze otevřené nebo vydané stavy (
Statusv Open nebo Released).
- Pouze dokumenty typu Objednávka (
- Schéma sloupců:
- Stav
Num_DocumentoNombre_ClienteDescripcionCantidadaCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Kontrolní seznam integrity katalogu
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Základní URL: Standardizované směrování ukazující na firemního vydavatele
portelcoreve verzi APIv1.0. - ✓ Schémata: Standardizované mapování polí bez speciálních znaků a mezer pro zrychlení příjmu dat.
- ✓ Klíčové filtry: Filtry na zdroji (pushdown) kompletně zdokumentovány a aplikovány přímo na fyzické tabulky ERP.

