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 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.
🔗 URL Base do Ecossistema
Sección titulada «🔗 URL Base del Ecosistema»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}')/
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 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
2. Líneas de Compra (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- 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
3. Líneas de Venta (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- 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
4. Checklist de Integridade de Catálogo
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.

