Katalog API (Portelcore)
Żywa dokumentacja punktów końcowych analitycznych OData V4 wdrożonych w produkcji i ich schematów danych.
W ramach naszej strategii Business Intelligence i zarządzania danymi, wdrożliśmy zestaw zoptymalizowanych, natywnych API. Ten dokument służy jako jedyne źródło prawdy dla każdego inżyniera, analityka danych lub procesu (Power BI, Python, Power Automate), który potrzebuje połączyć się z ERP.
🔗 Podstawowy adres URL ekosystemu
Sección titulada «🔗 URL Base del Ecosistema»Wszystkie połączenia OData muszą wskazywać na tę podstawę routingu:
https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/
1. Ruchy Produktu (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»Ten punkt końcowy jest sercem logistyki. Wyciąga informacje skonsolidowane z tabeli Item Ledger Entry (Ruchy Produktu), zapewniając kompletny historyczny zapis wejść i wyjść.
- Punkt końcowy OData:
/movimientos - Tabela Źródłowa:
Item Ledger Entry - Filtros en Origen (Pushdown):
- Pomija się rekordy z
Global Dimension 1 Code= ‘20’. - Ograniczone do typów: Zakupy, Sprzedaż i Korekty dodatnie/ujemne.
- Pomijany jest fikcyjny dostawca ‘PROVEEDOR_DEMO’.
- Pomija się rekordy z
- Esquema de Columnas (Mapeo limpio):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Linie zakupu (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- Punkt końcowy OData:
/lineasCompra - Tabela źródłowa:
Purchase Line - Filtros en Origen (Pushdown):
- Tylko dokumenty typu Zamówienie (
Order). - Solo cantidades pendientes diferentes a 0 (
Outstanding Quantity <> 0). - Tylko dostawcy, których kod zaczyna się od P40 (
Buy-from Vendor No.= ‘P40*’).
- Tylko dokumenty typu Zamówienie (
- Esquema de Columnas:
Tipo_DocumentoNum_DocumentoNum_ProveedoriNombre_ProveedorDescripcionCantidadiCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaiFecha_Estimada
3. Linie sprzedaży (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- Punkt końcowy OData:
/lineasVenta - Tabela źródłowa:
Sales Line - Filtros en Origen (Pushdown):
- Tylko dokumenty typu Zamówienie (
Order). - Tylko ilości oczekujące różne od 0.
- Tylko stany otwarte lub uruchomione (
Statusw Open lub Released).
- Tylko dokumenty typu Zamówienie (
- Esquema de Columnas:
- Status
Num_DocumentoNombre_ClienteDescripcionCantidadiCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Lista kontrolna integralności katalogu
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Adres URL: Ujednolicony routing wskazujący na korporacyjnego wydawcę
portelcorew wersji APIv1.0. - ✓ Schematy: Ujednolicony mapping pól bez znaków specjalnych ani spacji w celu przyspieszenia pobierania danych.
- ✓ Kluczowe filtry: Filtry w źródle (pushdown) w pełni udokumentowane i stosowane bezpośrednio na fizyczne tabele ERP.

