Catálogo de APIs (Portelcore)
Documentación viva de los endpoints analíticos OData V4 desplegados en producción y sus esquemas de datos.
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.
🔗 URL Base de l'Ecosistema
Sección titulada «🔗 URL Base del Ecosistema»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}')/
1. Movimientos de Producto (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»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
2. Líneas de Compra (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- 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
Líneas de Venta (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- 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
4. Checklist d'Integritat de Catàleg
Sección titulada «4. Checklist de Integridad de Catálogo»- 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.

