Catálogo de APIs (Portelcore)
Documentación viva de los endpoints analíticos OData V4 desplegados en producción y sus esquemas de datos.
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.
🔗 URL Base del Ecosistema
Sección titulada «🔗 URL Base del Ecosistema»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}')/
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 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’.
- Se omiten registros con
- Esquema de Columnas (Mapeo limpio):
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Líneas de Compra (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- 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*’).
- Solo documentos tipo Pedido (
- Esquema de Columnas:
Tipo_DocumentoNum_DocumentoNum_ProveedoryNombre_ProveedorDescripcionCantidadyCantidad_PendienteCod_Dimension_1Fecha_ConfirmadayFecha_Estimada
3. Líneas de Venta (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- 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 (
Statusen Open o Released).
- Solo documentos tipo Pedido (
- Esquema de Columnas:
EstadoNum_DocumentoNombre_ClienteDescripcionCantidadyCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Checklist de Integridad de Catálogo
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ Base URL: Enrutamiento estandarizado apuntando al publicador corporativo
portelcoreen su versión APIv1.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.

