API 目录(Portelcore)
已部署到生产环境的分析型 OData V4 端点实时文档及其数据架构。
0阅读
作为我们商业智能和数据治理战略的一部分,我们已部署了一套优化的原生 API。本文档作为所有工程师、数据分析师或流程(Power BI、Python、Power Automate)连接到 ERP 的单一事实来源。
🔗 生态系统基础 URL
Sección titulada «🔗 URL Base del Ecosistema»所有 OData 调用都必须指向此路由基础:\nhttps://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 - 源端过滤器(下推):
- 跳过
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 - 源端过滤器(下推):
- 仅订单类型文档(
Order)。 - 仅未结数量不等于 0(
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 - 源端过滤器(下推):
- 仅订单类型文档(
Order)。 - 仅待处理数量不为0。
- 仅限“已打开”或“已发布”状态 (
Status为 Open 或 Released)。
- 仅订单类型文档(
- 列架构:
- 状态
Num_DocumentoNombre_ClienteDescripcionCantidad和Cantidad_PendienteCod_Dimension_1Fecha_Envio
- ✓ 基础 URL: 指向企业发布者
portelcore的标准化路由,其 API 版本为v1.0。 - ✓ 方案: 标准化字段映射,无特殊字符或空格以加快数据摄入。
- ✓ 关键过滤器: 源端(推送)过滤器完全文档化并直接应用于ERP的物理表。

