Ir al contenido

Katalog API (Portelcore)

Żywa dokumentacja punktów końcowych analitycznych OData V4 wdrożonych w produkcji i ich schematów danych.

0odwiedzin

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

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’.
  • Esquema de Columnas (Mapeo limpio):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • 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*’).
  • Esquema de Columnas:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor i Nombre_Proveedor
    • Descripcion
    • Cantidad i Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada i Fecha_Estimada
  • 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 (Status w Open lub Released).
  • Esquema de Columnas:
    • Status
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad i Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
Sección titulada «4. Checklist de Integridad de Catálogo»
  • ✓ Adres URL: Ujednolicony routing wskazujący na korporacyjnego wydawcę portelcore w wersji API v1.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.