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 de nuestra estrategia de Inteligencia de Negocio y gobierno del dato, hemos desplegado una suite de APIs nativas optimizadas. Este documento sirve como punto único de verdad para cualquier ingeniero, analista de datos o proceso (Power BI, Python, Power Automate) que necesite conectarse al ERP.

Todas las llamadas OData deben apuntar a esta base de enrutamiento: https://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 en Origen (Pushdown):
    • Se omiten registros con Global Dimension 1 Code = ‘20’.
    • Restringido a tipos: Compras, Ventas, y Ajustes Positivos/Negativos.
    • Se omite el proveedor ficticio ‘PROVEEDOR_DEMO’.
  • Esquema de Columnas (Mapeo limpio):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • Endpoint OData: /lineasCompra
  • Tabla Origen: Purchase Line
  • Filtros en Origen (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Solo cantidades pendientes diferentes a 0 (Outstanding Quantity <> 0).
    • Solo proveedores cuyo código empiece por P40 (Buy-from Vendor No. = ‘P40*’).
  • Esquema de Columnas:
    • 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 en Origen (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Solo cantidades pendientes diferentes a 0.
    • Solo Estados Abiertos o Lanzados (Status en Open o Released).
  • Esquema de Columnas:
    • 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.