Catalogue d'APIs (Portelcore)
Documentation vivante des endpoints analytiques OData V4 déployés en production et de leurs schémas de données.
Dans le cadre de notre stratégie de Business Intelligence et de gouvernance des données, nous avons déployé une suite d'API natives optimisées. Ce document sert de source unique de vérité pour tout ingénieur, analyste de données ou processus (Power BI, Python, Power Automate) devant se connecter à l'ERP.
🔗 URL de base de l'écosystème
Sección titulada «🔗 URL Base del Ecosistema»Tous les appels OData doivent pointer vers cette base de routage :
https://api.businesscentral.dynamics.com/v2.0/{Tenant_ID}/{Entorno}/api/portelcore/api_portelcore_1/v1.0/companies('{Company_ID}')/
1. Mouvements de produits (movimientos)
Sección titulada «1. Movimientos de Producto (movimientos)»Cet endpoint est le cœur de la logistique. Il extrait les informations consolidées de la table Item Ledger Entry (Mouvements de produits), fournissant l'historique complet des entrées et des sorties.
- Endpoint OData :
/movimientos - Table source :
Item Ledger Entry - Filtres à la source (Pushdown) :
- Les enregistrements avec
Global Dimension 1 Code= ‘20’ sont omis. - Restreint aux types : Achats, Ventes et Ajustements positifs/négatifs.
- Le fournisseur fictif ‘PROVEEDOR_DEMO’ est ignoré.
- Les enregistrements avec
- Schéma de colonnes (mapping propre) :
Tipo_MovimientoNum_DocumentoDescripcionCod_Dimension_1Fecha_RegistroCantidadNombre_ProveedorNombre_cliente
2. Lignes d'achat (lineasCompra)
Sección titulada «2. Líneas de Compra (lineasCompra)»- Endpoint OData :
/lineasCompra - Table source :
Purchase Line - Filtres à la source (Pushdown) :
- Uniquement les documents de type Commande (
Order). - Quantités pendantes différentes de 0 (
Outstanding Quantity <> 0). - Uniquement les fournisseurs dont le code commence par P40 (
Buy-from Vendor No.= ‘P40*’).
- Uniquement les documents de type Commande (
- Schéma de colonnes :
Tipo_DocumentoNum_DocumentoNum_ProveedoretNombre_ProveedorDescripcionCantidadetCantidad_PendienteCod_Dimension_1Fecha_ConfirmadaetFecha_Estimada
3. Lignes de vente (lineasVenta)
Sección titulada «3. Líneas de Venta (lineasVenta)»- Endpoint OData :
/lineasVenta - Table source :
Sales Line - Filtres à la source (Pushdown) :
- Uniquement les documents de type Commande (
Order). - Uniquement les quantités en attente différentes de 0.
- Uniquement les états Ouverts ou Lancés (
Statusen Open ou Released).
- Uniquement les documents de type Commande (
- Schéma de colonnes :
- État
Num_DocumentoNombre_ClienteDescripcionCantidadetCantidad_PendienteCod_Dimension_1Fecha_Envio
4. Checklist d'intégrité du catalogue
Sección titulada «4. Checklist de Integridad de Catálogo»- ✓ URL de base : Routage standardisé pointant vers l'éditeur d'entreprise
portelcoredans sa version APIv1.0. - ✓ Schémas : Mapping de champs standardisé sans caractères spéciaux ni espaces pour accélérer l'ingestion de données.
- ✓ Filtres clés : Filtres à la source (pushdown) entièrement documentés et appliqués directement sur les tables physiques de l'ERP.

