Ir al contenido

API 目录(Portelcore)

已部署到生产环境的分析型 OData V4 端点实时文档及其数据架构。

0阅读

作为我们商业智能和数据治理战略的一部分,我们已部署了一套优化的原生 API。本文档作为所有工程师、数据分析师或流程(Power BI、Python、Power Automate)连接到 ERP 的单一事实来源。

所有 OData 调用都必须指向此路由基础:\nhttps://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/

该端点是物流的核心。它从 Item Ledger Entry(产品流水)表中提取整合后的信息,提供完整的进出历史记录。

  • OData 端点:/movimientos
  • 源表: Item Ledger Entry
  • 源端过滤器(下推):
    • 跳过 Global Dimension 1 Code = ‘20’ 的记录。
    • 仅限类型:采购、销售、正负调整。
    • 忽略虚拟供应商 'PROVEEDOR_DEMO'。
  • 列架构(干净映射):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • OData 端点: /lineasCompra
  • 源表: Purchase Line
  • 源端过滤器(下推):
    • 仅订单类型文档(Order)。
    • 仅未结数量不等于 0(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
  • OData 端点: /lineasVenta
  • 源表: Sales Line
  • 源端过滤器(下推):
    • 仅订单类型文档(Order)。
    • 仅待处理数量不为0。
    • 仅限“已打开”或“已发布”状态 (Status 为 Open 或 Released)。
  • 列架构:
    • 状态
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad 和 Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ 基础 URL: 指向企业发布者 portelcore 的标准化路由,其 API 版本为 v1.0。
  • ✓ 方案: 标准化字段映射,无特殊字符或空格以加快数据摄入。
  • ✓ 关键过滤器: 源端(推送)过滤器完全文档化并直接应用于ERP的物理表。