Ir al contenido

Catalogue d'APIs (Portelcore)

Documentation vivante des endpoints analytiques OData V4 déployés en production et de leurs schémas de données.

0vues

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}')/

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é.
  • Schéma de colonnes (mapping propre) :
    • Tipo_Movimiento
    • Num_Documento
    • Descripcion
    • Cod_Dimension_1
    • Fecha_Registro
    • Cantidad
    • Nombre_Proveedor
    • Nombre_cliente
  • 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*’).
  • Schéma de colonnes :
    • Tipo_Documento
    • Num_Documento
    • Num_Proveedor et Nombre_Proveedor
    • Descripcion
    • Cantidad et Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Confirmada et Fecha_Estimada
  • 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 (Status en Open ou Released).
  • Schéma de colonnes :
    • État
    • Num_Documento
    • Nombre_Cliente
    • Descripcion
    • Cantidad et Cantidad_Pendiente
    • Cod_Dimension_1
    • Fecha_Envio
  • ✓ URL de base : Routage standardisé pointant vers l'éditeur d'entreprise portelcore dans sa version API v1.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.