Ir al contenido

Каталог API (Portelcore)

Живая документация конечных точек аналитических OData V4, развернутых в производстве, и их схемы данных.

0просмотры

В рамках нашей стратегии бизнес-аналитики и управления данными мы развернули набор оптимизированных собственных API. Этот документ служит единой точкой истины для любого инженера, аналитика данных или процесса (Power BI, Python, Power Automate), которому необходимо подключиться к ERP.

🔗 Базовый URL экосистемы

Sección titulada «🔗 URL Base del Ecosistema»

Все вызовы OData должны указывать на эту базовую маршрутизацию: https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/

1. Движения товара (movimientos)

Sección titulada «1. Movimientos de Producto (movimientos)»

Этот конечный пункт является сердцем логистики. Он извлекает сводную информацию из таблицы Item Ledger Entry (Движения товара), предоставляя полную историю поступлений и отгрузок.

  • Конечная точка OData: /movimientos
  • Исходная таблица: Item Ledger Entry
  • Фильтры в источнике (Pushdown):
    • Упускаются записи с Global Dimension 1 Code = ‘20’.
    • Ограничено типами: покупки, продажи и положительные/отрицательные корректировки.
    • Фиктивный поставщик ‘PROVEEDOR_DEMO’ опускается.
  • Схема столбцов (чистое сопоставление):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente

2. Линии покупки (lineasCompra)

Sección titulada «2. Líneas de Compra (lineasCompra)»
  • Конечная точка OData: /lineasCompra
  • Исходная таблица: Purchase Line
  • Фильтры в источнике (Pushdown):
    • Только документы типа Заказ (Order).
    • Только разные от 0 суммы pending (Outstanding Quantity <> 0).
    • Только поставщики, код которых начинается с P40 (Buy-from Vendor No. = ‘P40*’).
  • Схема столбцов:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor и Nombre_Proveedor
    • Descripcion
    • Cantidad и Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada и Fecha_Estimada

3. Линии продаж (lineasVenta)

Sección titulada «3. Líneas de Venta (lineasVenta)»
  • Конечная точка OData: /lineasVenta
  • Исходная таблица: Sales Line
  • Фильтры в источнике (Pushdown):
    • Только документы типа Заказ (Order).
    • Только ожидаемые количества, отличные от 0.
    • Только открытые или запущенные состояния (Status в Open или Released).
  • Схема столбцов:
    • Состояние
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad и Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
Sección titulada «4. Checklist de Integridad de Catálogo»
  • ✓ Базовый URL: Стандартизированное маршрутизация, указывающее на корпоративного издателя portelcore в его версии API v1.0.
  • ✓ Схемы: Стандартизированное сопоставление полей без специальных символов и пробелов для ускорения ингестии данных.
  • ✓ Ключевые фильтры: Фильтры на уровне источника (pushdown), полностью задокументированные и применяемые непосредственно к физическим таблицам ERP.