Ir al contenido

Catálogo de APIs (Portelcore)

Documentación viva de los endpoints analíticos OData V4 desplegados en producción y sus esquemas de datos.

0lecturas

Como parte da nossa estratégia de Inteligência de Negócios e governança de dados, implantamos um conjunto de APIs nativas otimizadas. Este documento serve como fonte única de verdade para qualquer engenheiro, analista de dados ou processo (Power BI, Python, Power Automate) que precise se conectar ao ERP.

Todas as chamadas OData devem apontar para esta base de roteamento:\r\nhttps://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/

Este endpoint es el corazón de la logística. Extrae la información consolidada de la tabla Item Ledger Entry (Movimientos de Producto), proporcionando el histórico completo de entradas y salidas.

  • Endpoint OData: /movimientos
  • Tabla Origen: Item Ledger Entry
  • Filtros na Origem (Pushdown):
    • Se omiten registros con Global Dimension 1 Code = ‘20’.
    • Restrito aos tipos: Compras, Vendas e Ajustes Positivos/Negativos.
    • O fornecedor fictício ‘PROVEEDOR_DEMO’ é omitido.
  • Esquema de Colunas (Mapeamento limpo):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • Endpoint OData: /lineasCompra
  • Tabla Origen: Purchase Line
  • Filtros na Origem (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Somente quantidades pendentes diferentes de 0 (Outstanding Quantity <> 0).
    • Solo proveedores cuyo código empiece por P40 (Buy-from Vendor No. = ‘P40*’).
  • Esquema de Colunas:
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor y Nombre_Proveedor
    • Descripcion
    • Cantidad y Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada y Fecha_Estimada
  • Endpoint OData: /lineasVenta
  • Tabla Origen: Sales Line
  • Filtros na Origem (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Apenas quantidades pendentes diferentes de 0.
    • Solo Estados Abiertos o Lanzados (Status en Open o Released).
  • Esquema de Colunas:
    • Estado
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad y Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ Base URL: Enrutamiento estandarizado apuntando al publicador corporativo portelcore en su versión API v1.0.
  • ✓ Esquemas: Mapeo de campos estandarizado sin caracteres especiales ni espacios para agilizar la ingesta de datos.
  • ✓ Filtros Clave: Filtros en origen (pushdown) completamente documentados y aplicados directamente sobre las tablas físicas del ERP.