Каталог API (Portelcore)
Живая документация конечных точек аналитических OData V4, развернутых в производстве, и их схемы данных.
В рамках нашей стратегии бизнес-аналитики и управления данными мы развернули набор оптимизированных собственных 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_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_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_DocumentoNum_DocumentoNum_ProveedorиNombre_ProveedorDescripcionCantidadиCantidad_PendienteCod_Dimension_1Fecha_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_DocumentoNombre_ClienteDescripcionCantidadиCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Контрольный список целостности каталога
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Базовый URL: Стандартизированное маршрутизация, указывающее на корпоративного издателя
portelcoreв его версии APIv1.0. - ✓ Схемы: Стандартизированное сопоставление полей без специальных символов и пробелов для ускорения ингестии данных.
- ✓ Ключевые фильтры: Фильтры на уровне источника (pushdown), полностью задокументированные и применяемые непосредственно к физическим таблицам ERP.

