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.

0lectures

Com a part de la nostra estratègia d'Intel·ligència de Negoci i govern de la dada, hem desplegat una suite d'APIs natives optimitzades. Aquest document serveix com a punt únic de veritat per a qualsevol enginyer, analista de dades o procés (Power BI, Python, Power Automate) que necessiti connectar-se a l'ERP.

Totes les crides OData han d'apuntar a aquesta base d'enrutament: 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 a l'Origen (Pushdown):
    • Se omiten registros con Global Dimension 1 Code = ‘20’.
    • Restringit a tipus: Compres, Vendes, i Ajustos Positius/Negatius.
    • S'omet el proveïdor fictici ‘PROVEEDOR_DEMO’.
  • Esquema de Columnes (Mapeig net):
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha de Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • Endpoint OData: /lineasCompra
  • Tabla Origen: Purchase Line
  • Filtros a l'Origen (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Sol quantitats pendents diferents a 0 (Outstanding Quantity <> 0).
    • Solo proveedores cuyo código empiece por P40 (Buy-from Vendor No. = ‘P40*’).
  • Esquema de Columnes:
    • Tipo_Documento
    • Num_Documento
    • Número de Proveedor y Nombre de Proveedor
    • Descripcion
    • Cantidad y Cantidad Pendiente
    • Cod_Dimension_1
    • Fecha Confirmada y Fecha Estimada
  • Endpoint OData: /lineasVenta
  • Tabla Origen: Sales Line
  • Filtros a l'Origen (Pushdown):
    • Solo documentos tipo Pedido (Order).
    • Només quantitats pendents diferents de 0.
    • Solo Estados Abiertos o Lanzados (Status) en Open o Released.
  • Esquema de Columnes:
    • Status
    • Num_Documento
    • Nombre del Cliente
    • Descripcion
    • Cantidad y Cantidad Pendiente
    • Cod_Dimension_1
    • Fecha de Envío
  • 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.