Partager via

Plannings de changement du stock disponible et disponibilité à la vente de la Visibilité des stocks

  • Article

Cet article explique comment configurer la fonction Planning de changement de stock disponible pour planifier les futurs changements du stock disponible et calculer les quantités disponibles à la vente (DAV). Le DAV correspond à la quantité d’un article qui est disponible et peut être promise à un client dans le courant d’une période à venir. L’utilisation de ce calcul peut augmenter considérablement votre capacité de traitement des commandes.

Pour de nombreux fabricants, détaillants ou vendeurs, il ne suffit pas de savoir ce qui est actuellement disponible. Ils doivent avoir une visibilité totale de la disponibilité future. Cette disponibilité future doit tenir compte de l’offre future, de la demande future et de la DAV.

Mesures calculées pour les quantités DAV

La Mesure DAV calculée est une mesure calculée prédéfinie qui est généralement utilisée pour trouver la quantité actuellement disponible. La quantité d’approvisionnement est la somme des quantités pour les mesures physiques qui ont un type de modificateur addition, et la quantité demandée est la somme des quantités pour les mesures physiques qui ont un type de modificateur soustraction.

Vous pouvez ajouter plusieurs mesures calculées pour calculer plusieurs quantités DAV. Cependant, le nombre total de mesures physiques distinctes pour toutes les mesures calculées DAV doit être inférieur à neuf.

Important

Une mesure calculée est une composition de mesures physiques. Sa formule ne peut inclure que des mesures physiques sans doublons, et non des mesures calculées.

Par exemple, vous pouvez définir la mesure calculée suivante :

Disponible immédiatement = (StockPhysique + Disponible + Illimité + InspectionQualité + Entrant) – (RéservPhysique + RéservPhysiqueProv + Sortant)

La somme (StockPhysique + Disponible + Illimité + InspectionQualité + Entrant) représente l’offre, et la somme (RéservPhysique + RéservPhysiqueProv + Sortant) représente la demande. Par conséquent, la mesure calculée peut être comprise de la manière suivante :

Disponible immédiatement = Offre – Demande

Vous pouvez ajouter une autre mesure calculée pour calculer la quantité DAV Disponible-physique.

On-hand-physical = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (Outbound)

Il existe huit mesures physiques distinctes dans ces deux mesures calculées DAV : PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical et Outbound.

Pour plus d’informations sur les mesures calculées, voir Mesures calculées.

Activer et configurer la planification des modifications disponibles et le DAV dans la version 2 de l’interface utilisateur

Cette section s’applique lorsque vous utilisez l’interface utilisateur de visibilité des stocks version 2.

Avant de pouvoir utiliser la DAV, vous devez paramétrer une ou plusieurs mesures calculées pour calculer les quantités DAV. Vous devez également activer la fonction et configurer les paramètres DAV dans Microsoft Power Apps.

Suivez ces étapes pour activer la fonctionnalité Planning de changement de stock disponible dans Power Apps et configurer les paramètres DAV.

  1. Connectez-vous à Power Apps et ouvrez l’application Visibilité des stocks.

  2. Dans le volet de navigation, sélectionnez Gestion des fonctionnalités.

  3. Dans la vignette Disponible à la vente, sélectionnez Gérer.

  4. Définissez l’option Activer la fonctionnalité sur True pour activer la fonctionnalité DAV.

  5. Définissez l’option Programme pour 180 jours sur True pour prendre en charge la période de planification DAV plus longue (180 jours).

    Important

    Par défaut, la fonctionnalité DAV est limitée à sept jours. Les fonctionnalités DAV sur sept jours et DAV sur 180 jours sont distinctes et indépendantes les unes des autres. Les modifications de planification que vous créez ou modifiez à l’aide de la fonctionnalité DAV sur sept jours ne prendront pas effet lorsque vous activez la fonctionnalité DAV sur 180 jours. Si vous avez utilisé la fonctionnalité DAV de sept jours et souhaitez migrer vers la fonctionnalité de 180 jours, nous vous recommandons de supprimer les anciennes données et de republier votre calendrier de modifications disponible après avoir activé la fonctionnalité de 180 jours.

  6. Définissez le champ Période de planification max (jours) sur le nombre de jours pendant lesquels les utilisateurs peuvent afficher et soumettre des changements planifiés de stock disponible. Les utilisateurs qui demandent des informations sur les stocks obtiendront le stock disponible, les changements planifiés du stock disponible et la DAV pour chaque jour de la période définie, en commençant par la date actuelle. La valeur maximale de ce champ est 180 jours. Par défaut, il est défini sur 30 jours. Par conséquent, vous pouvez planifier des modifications jusqu’à 30 jours à compter d’aujourd’hui.

    Important

    La période de planification inclut la date actuelle. Par conséquent, les utilisateurs peuvent programmer des changements de stock disponible pour qu’ils se produisent à tout moment entre la date du jour (le jour où le changement est soumis) et (période de planification - 1) jours dans le futur.

  7. Dans la section Mesures de planification, configurez les mesures de planification. Vous pouvez utiliser des mesures calculées existantes comme mesures de planification ou en créer de nouvelles. Lorsque vous interrogez la Visibilité des stocks, la valeur DAV est fournie pour les mesures calculées définies, en fonction des modifications planifiées des mesures physiques des composants. Dans la section Planifier les mesures, sélectionnez Nouvelle configuration du programme de modification disponible V2 dans la barre d’outils pour ajouter un nouveau mesure calculée de liaison pour la DAV. La mesure calculée est ce que vous souhaitez utiliser pour trouver la quantité disponible actuellement. Pour plus d’informations sur la manière de créer une mesure calculée, voir Mesures calculées.

    Important

    La formule calculée par défaut de la DAV est à titre de référence. Vous pouvez modifier et ajouter d’autres sources de données et mesures physiques pour configurer le calcul DAV correct pour votre entreprise.

  8. Dans la section Configuration du jeu d’index DAV, configurez votre index DAV. L’index DAV ressemble à la hiérarchie d’index de produits qui vous permet de regrouper les résultats de requête selon des dimensions spécifiques. Par exemple, si vous définissez ColorId et SizeId selon votre index DAV, les résultats de la requête seront regroupés par couleur et par taille. Vous pouvez avoir plusieurs jeux d’index.

    Important

    L’index par défaut ColorId et SizeId est à titre de référence. Vous pouvez supprimer des dimensions et ajouter d’autres dimensions.

  9. Sélectionnez Enregistrer.

  10. Lorsque vous avez terminé de configurer tous les paramètres requis, sélectionnez Mettre à jour la configuration sous Paramètres d’administration dans le volet de navigation.

Pour plus d’informations, voir Terminer et mettre à jour la configuration.

Activer et configurer la planification des modifications disponibles et le DAV dans la version 1 de l’interface utilisateur

Cette section s’applique lorsque vous utilisez l’interface utilisateur de visibilité des stocks version 1.

Suivez ces étapes pour activer la fonctionnalité Planning de changement de stock disponible dans Power Apps et configurer les paramètres DAV.

  1. Connectez-vous à Power Apps et ouvrez l’application Visibilité des stocks.

  2. Ouvrez la page Configuration.

  3. Sur l’onglet Gestion des fonctionnalités, activez la fonctionnalité Disponible à la vente.

  4. Sélectionnez l’onglet Paramètres DAV.

  5. Lorsque vous interrogez la visibilité du stock, elle renvoie un résultat qui inclut chaque mesure DAV calculée que vous ajoutez ici. Sélectionnez Ajouter pour ajouter une nouvelle mesure calculée pour la DAV.

  6. Définissez les champs suivants :

    • Source de données – Sélectionnez la source de données associée à la mesure calculée.
    • Mesure calculée – Sélectionnez la mesure calculée qui est associée à la source de données sélectionnée et que vous souhaitez utiliser pour trouver la quantité en stock actuellement disponible.
    • Période de planification – Entrez le nombre de jours pendant lesquels les utilisateurs peuvent afficher et soumettre des changements planifiés de stock disponible lorsque la mesure calculée sélectionnée est utilisée. Les utilisateurs qui demandent des informations sur les stocks obtiendront le stock disponible, les changements planifiés du stock disponible et la DAV pour chaque jour de cette période, en commençant par la date actuelle. Sélectionnez un nombre entier entre 1 et 7.

    Important

    La période de planification inclut la date actuelle. Par conséquent, les utilisateurs peuvent programmer des changements de stock disponible pour qu’ils se produisent à tout moment entre la date du jour (le jour où le changement est soumis) et (période de planification - 1) jours dans le futur.

  7. Cliquez sur Enregistrer.

  8. Répétez les étapes 5 à 7 jusqu’à ce que vous ayez ajouté toutes les mesures calculées dont vous avez besoin pour la DAV.

  9. Lorsque vous avez terminé de configurer tous les paramètres requis, sélectionnez Mettre à jour la configuration.

Fonctionnement des calculs du planning de changement du stock disponible et de la DAV

Un Planning de changement du stock disponible établit les dates et les quantités de changements de stock disponible prévues. Vous pouvez soumettre un planning de changement du stock disponible à la Visibilité du stock, à condition que les dates soient comprises dans la période définie par le paramètre Période de planification (voir la section Activer et configurer les fonctionnalités de cet article). Les utilisateurs qui demandent des informations sur les stocks obtiendront le stock disponible, les changements planifiés du stock disponible et la DAV pour chaque jour de cette période.

Les changements planifiés ne sont initialement pas validés et n’affectent donc pas les quantités réellement disponibles dans le système. Pour valider les changements, vous devez envoyer un événement de changement du stock disponible, qui met à jour la quantité réelle du stock disponible. Vous devez ensuite annuler le changement planifié en soumettant un planning de changement du stock disponible pour une quantité négative correspondante.

Par exemple, vous passez une commande de 10 vélos et vous vous attendez à ce qu’elle arrive demain. Par conséquent, vous soumettez un planning de changement du stock disponible qui a une quantité entrante de 10 et est daté de demain. Lorsque la commande arrive le lendemain, vous ajoutez les vélos à votre stock physique disponible. Vous devez ensuite valider la modification dans votre système pour mettre à jour la quantité en stock réelle. Pour valider la modification, vous soumettez un événement de changement du stock disponible dont la quantité entrante est de 10. Vous annulez ensuite le changement planifié en soumettant un programme de changement du stock disponible ayant une quantité entrante de -10.

Lorsque vous interrogez la Visibilité du stock pour connaître les quantités en stock et DAV, les informations suivantes sont renvoyées pour chaque jour de la période de planification :

  • Date – La date à laquelle le résultat s’applique. Le fuseau horaire est le temps universel coordonné (UTC).
  • Quantité disponible immédiatement – La quantité disponible réelle en stock pour la date spécifiée. Ce calcul est effectué en fonction de la mesure DAV calculée qui est configurée pour la Visibilité du stock.
  • Offre planifiée – La somme de toutes les quantités entrantes planifiées qui ne sont pas devenues physiquement disponibles pour une consommation ou une expédition immédiate à la date spécifiée.
  • Demande planifiée – La somme de toutes les quantités sortantes planifiées qui n’ont pas été consommées ou expédiées à la date spécifiée.
  • Quantité DAV – La quantité minimale projetée de stock disponible qui est disponible à partir de la date spécifiée jusqu’à la fin de la période de planification. Cette quantité comprend tous les ajustements de quantité planifiés. C’est la quantité maximale qui peut être promise à la date du jour pour livraison ou consommation ce jour-là.

Par exemple, si la date actuelle est le 1er février 2022 et que la période de planification est 7, les utilisateurs peuvent soumettre des changements planifiés de stock disponible attendus entre le 1er février et le 7 février 2022. Dans ce cas, la quantité DAV pour le 3 février, par exemple, est calculée en fonction de la quantité en stock pour ce jour et des quantités planifiées du 3 février au 7 février.

Exemple

L’exemple suivant montre comment une série de changements planifiés de quantité affecte les quantités de stock disponible et DAV rapportées par la Visibilité du stock. Il montre également comment valider un changement planifié, comment un changement planifié validé affecte les résultats, et ce qui peut se produire si vous ne validez pas un changement planifié.

Les résultats de cet exemple montrent une valeur stock disponible projeté. Cette valeur intègre toutes les mises à jour planifiées à des fins d’illustration, mais n’est pas réellement rapportée lorsque vous interrogez la Visibilité du stock.

  1. Les paramètres suivants sont configurés pour votre système sur la page Paramètre DAV de l’application Visibilité des stocks dans Power Apps :

    • Mesures du programme – Une mesure calculée nommée Stock disponible est ajoutée ici. Il est calculé comme Disponible = Offre – Demande.
    • Période de programmation maximale (jours) – La valeur est définie sur 7.
    • Configuration de l’ensemble d’index DAV – ColorId et SizeId sont ajoutés ici.

  2. Les conditions suivantes s’appliquent également :

    • La date actuelle est le 1er février 2022.
    • La quantité disponible actuelle est de 20.

  3. Pour la date actuelle (1er février 2022), vous soumettez une quantité de demande planifiée de 3 à la Visibilité du stock. Par conséquent, la quantité disponible projetée est 17. Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    01-02-2022 20 3 17 17
    02-02-2022 20 17 17
    03-02-2022 20 17 17
    04-02-2022 20 17 17
    05-02-2022 20 17 17
    06-02-2022 20 17 17
    07-02-2022 20 17 17

  4. À la date actuelle (1er février 2022), vous soumettez une quantité d’approvisionnement planifié de 10 pour le 3 février 2022. Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    01-02-2022 20 3 17 17
    02-02-2022 20 17 17
    03-02-2022 20 10 27 27
    04-02-2022 20 27 27
    05-02-2022 20 27 27
    06-02-2022 20 27 27
    07-02-2022 20 27 27

  5. À la date actuelle (1er février 2022), vous soumettez les changements de quantité planifiés suivants :

    • Quantité demandée de 15 pour le 4 février 2022
    • Quantité fournie de 1 pour le 5 février 2022
    • Quantité fournie de 3 pour le 6 février 2022

    Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    01-02-2022 20 3 17 12
    02-02-2022 20 17 12
    03-02-2022 20 10 27 12
    04-02-2022 20 15 12 12
    05-02-2022 20 1 13 13
    06-02-2022 20 3 16 16
    07-02-2022 20 16 16

  6. À la date actuelle (1er février 2022), vous expédiez la quantité demandée planifiée de 3. Par conséquent, vous devez valider ce changement afin qu’il se reflète dans votre quantité en stock réelle. Pour valider le changement, vous soumettez un événement de changement du stock disponible dont la quantité sortante est de 3. Vous annulez ensuite le changement planifié en soumettant un programme de changement du stock disponible ayant une quantité sortante de -3. Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    01-02-2022 17 0 17 12
    02-02-2022 17 17 12
    03-02-2022 17 10 27 12
    04-02-2022 17 15 12 12
    05-02-2022 17 1 13 13
    06-02-2022 17 3 16 16
    07-02-2022 17 16 16

  7. Le jour suivant (2 février 2022), la période de planification avance d’un jour. Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    02-02-2022 17 17 12
    03-02-2022 17 10 27 12
    04-02-2022 17 15 12 12
    05-02-2022 17 1 13 13
    06-02-2022 17 3 16 16
    07-02-2022 17 16 16
    08-02-2022 17 16 16

  8. Cependant, deux jours plus tard (le 4 février 2022), la quantité d’approvisionnement de 10 qui était prévue pour le 3 février n’est toujours pas arrivée. Le tableau suivant présente le résultat.

    Date Disponible Offre planifiée Demande planifiée Stock disponible projeté DAV
    04-02-2022 17 15 2 2
    05-02-2022 17 1 3 3
    06-02-2022 17 3 6 6
    07-02-2022 17 6 6
    08-02-2022 17 6 6
    09-02-2022 17 6 6
    10-02-2022 17 6 6

    Comme vous le voyez, les changements planifiés (mais non validés) du stock disponible n’affectent pas la quantité de stock disponible réelle.

Soumettre des plannings de changement, des événements de changement et des requêtes DAV via l’API

Vous pouvez utiliser les URL d’interface de programmation d’application (API) suivantes pour soumettre des plannings de changement du stock disponible, des événements de changement et des requêtes.

Chemin d’accès méthode Description
/api/environment/{environmentId}/onhand/changeschedule POST Créer un changement planifié du stock disponible.
/api/environment/{environmentId}/onhand/changeschedule/bulk POST Créer plusieurs changements planifiés du stock disponible.
/api/environment/{environmentId}/onhand POST Créer un événement de changement de stock disponible.
/api/environment/{environmentId}/onhand/bulk POST Créer plusieurs événements de changement.
/api/environment/{environmentId}/onhand/indexquery POST Requête à l’aide de la méthode POST.
/api/environment/{environmentId}/onhand GET Requête à l’aide de la méthode GET.
/api/environment/{environmentId}/onhand/exactquery POST Requête exacte à l’aide de la méthode POST.

Pour plus d’informations, voir API publiques de la Visibilité des stocks.

Créer un changement planifié du stock disponible

Un calendrier de modification disponible est créé en soumettant une POST demande à l’URL service de visibilité des stocks appropriée. Vous pouvez également soumettre des requêtes en masse.

Un programme de modification disponible ne peut être créé que si la date planifiée est comprise entre la date actuelle et la fin de la période de planification actuelle. Le format date/heure doit être jour-mois-année (par exemple, 01-02-2022). Le format de l’heure doit être précis uniquement au jour près.

Cette API crée un seul programme de modification de stock disponible.

Path:
    /api/environment/{environmentId}/onhand/changeschedule
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    {
        id: string,
        organizationId: string,
        productId: string,
        dimensionDataSource: string, # optional
        dimensions: {
            [key:string]: string,
        },
        quantitiesByDate: {
            [datetime:datetime]: {
                [dataSourceName:string]: {
                    [key:string]: number,
                },
            },
        },
    }

L’exemple suivant montre un exemple de contenu du corps sans dimensionDataSource.

{
    "id": "id-bike-0001",
    "organizationId": "usmf",
    "productId": "Bike",
    "dimensions": {
        "SiteId": "1",
        "LocationId": "11",
        "ColorId": "Red",
        "SizeId": "Small"
    },
    "quantitiesByDate": {
        "2022-02-01": {
            "pos": {
                "inbound": 10
            }
        }
    }
}

Créer plusieurs programmes de changement disponibles

Cette API peut créer plusieurs enregistrements en même temps. Les seules différences entre cette API et l’API d’événement unique sont les valeurs Path et Body. Pour cette API, Body fournit un tableau d’enregistrements. Le nombre maximal d’enregistrements est de 512. Par conséquent, l’API en bloc de planification des modifications disponibles peut prendre en charge jusqu’à 512 modifications planifiées à la fois.

Path:
    /api/environment/{environmentId}/onhand/changeschedule/bulk
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    [
        {
            id: string,
            organizationId: string,
            productId: string,
            dimensionDataSource: string,
            dimensions: {
                [key:string]: string,
            },
            quantityDataSource: string, # optional
            quantitiesByDate: {
                [datetime:datetime]: {
                    [dataSourceName:string]: {
                        [key:string]: number,
                    },
                },
            },
        },
        ...
    ]

L’exemple suivant montre un exemple de contenu du corps.

[
    {
        "id": "id-bike-0001",
        "organizationId": "usmf",
        "productId": "Bike",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red",
            "SizeId": "Small"
        },
        "quantitiesByDate": {
            "2022-02-01": {
                "pos": {
                    "inbound": 10
                }
            }
        }
    },
    {
        "id": "id-car-0002",
        "organizationId": "usmf",
        "productId": "Car",
        "dimensions": {
            "SiteId": "1",
            "LocationId": "11",
            "ColorId": "Red",
            "SizeId": "Small"
        },
        "quantitiesByDate": {
            "2022-02-05": {
                "pos": {
                    "outbound": 10
                }
            }
        }
    }
]

Créer des événements de modification de stock disponible

Les événements de modification disponibles sont effectués en soumettant une POST requête à l’URL service de visibilité des stocks appropriée (voir le début de la section Soumettre des calendriers de modification, des événements de modification et des requêtes ATP via l’API ).

Note

Les événements de changement du stock disponibles ne sont pas propres à la fonctionnalité DAV, mais font partie de l’API Visibilité du stock standard. Cet exemple a été inclus car les événements sont pertinents lorsque vous travaillez avec la DAV. Les événements de changement du stock disponible ressemblent aux réservations de changement du stock disponible, mais les messages d’événement doivent être envoyés à une URL d’API différente, et les événements utilisent quantities au lieu de quantityByDate dans le corps du message. Pour plus d’informations sur les événements de changement du stock disponible et d’autres fonctionnalités de l’API Visibilité du stock, consultez API publiques de visibilité du stock.

L’exemple suivant présente un corps de requête contenant un seul événement de changement du stock disponible.

{
    "id": "id-bike-0001",
    "organizationId": "usmf",
    "productId": "Bike",
    "dimensions": {
        "SiteId": "1",
        "LocationId": "11",
        "SizeId": "Big",
        "ColorId": "Red"
    },
    "quantities": {
        "pos": {
            "inbound": 10.0
        }
    }
}

Interroger les changements planifiés du stock disponible et les résultats de la DAV

Vous pouvez interroger les changements planifiés du stock disponible et les résultats de la DAV en soumettant soit une requête POST ou une requête GET à l’URL de l’API appropriée (voir la section oumettre des plannings de changement, des événements de changement et des requêtes DAV via l’API).

Dans votre requête, définissez QueryATP sur true si vous souhaitez interroger les changements planifiés du stock disponible et les résultats de la DAV. Par défaut, la requête renvoie toutes les données liées à la DAV à partir de ce jour. Vous pouvez préciser ATPFromDate et ATPToDate pour affiner les résultats. (Les dates « Fin » et « Début » filtrent simplement le résultat. Elles n’affectent pas la façon dont la DAV est calculée.)

  • Si vous soumettez la requête en utilisant la méthode GET, définissez ce paramètre dans l’URL.
  • Si vous soumettez la requête en utilisant la méthode POST, définissez ce paramètre dans le corps de la requête.

Note

Indépendamment du fait que le paramètre returnNegative est défini sur true ou false dans le corps de la requête, le résultat inclura des valeurs négatives lorsque vous interrogerez les changements planifiés du stock disponible et les résultats de la DAV. Ces valeurs négatives seront incluses car, si seules les commandes de demande sont planifiées, ou si les quantités d’approvisionnement sont inférieures aux quantités demandées, les quantités du changement planifié du stock disponible seront négatives. Si les valeurs négatives n’étaient pas incluses, les résultats seraient déroutants. Pour plus d’informations sur cette option et son fonctionnement pour d’autres types de requêtes, voir API publiques de visibilité du stock.

Requête à l’aide de la méthode POST

Path:
    /api/environment/{environmentId}/onhand/indexquery
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Body:
    {
        dimensionDataSource: string, # Optional
        filters: {
            organizationId: string[],
            productId: string[],
            siteId: string[],
            locationId: string[],
            [dimensionKey:string]: string[],
        },
        groupByValues: string[],
        returnNegative: boolean,
    }

L’exemple suivant montre comment créer un corps de requête d’interrogation d’index pouvant être soumis à la Visibilité du stock à l’aide de la méthode POST.

{
    // OnHand Index Query fields
    "filters": {
        "organizationId": ["usmf"],
        "productId": ["Bike"],
        "SiteId": ["1"],
        "LocationId": ["11"]
    },
    "groupByValues": ["ColorId", "SizeId"],
    "returnNegative": true,

    // ATP related fields
    "QueryATP":true,
    "ATPFromDate": "2022-02-01",
    "ATPToDate": "2022-02-10",
}

Requête à l’aide de la méthode GET

Path:
    /api/environment/{environmentId}/onhand
Method:
    Get
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Query(Url Parameters):
    groupBy
    returnNegative
    [Filters]

L’exemple suivant montre comment créer une URL de requête d’interrogation d’index sous forme de requête GET.

https://inventoryservice.{RegionShortName}-il301.gateway.prod.island.powerapps.com/api/environment/{EnvironmentId}/onhand?organizationId=usmf&productId=Bike&SiteId=1&LocationId=11&groupBy=ColorId,SizeId&returnNegative=true&QueryATP=true&ATPToDate=2022-02-01&ATPToDate=2022-02-10

Le résultat de cette GET requête est exactement le même que le résultat de la POST requête dans l’exemple précédent.

Requête exacte à l’aide de la méthode POST

Pour configurer une requête exacte, ajoutez des champs liés à la DAV au corps de la requête. Pour plus d’informations, consultez Interroger avec exactitude en utilisant la méthode post.

{
    // Exact query fields
    // ...

    // ATP related fields
    "QueryATP":true,
    "ATPFromDate": "2022-02-01",
    "ATPToDate": "2022-02-10",
}

Exemple de résultat de requête

N’importe lequel des exemples de requête précédents peut produire la réponse suivante. Pour cet exemple, le système est configuré avec les paramètres suivants :

  • Mesure DAV calculée :iv.onhand = pos.inbound – pos.outbound
  • Période planifiée :7

Voici un exemple du corps de la réponse.

[
    {
        "quantitiesByDate": {
            "2022-02-02T00:00:00": {
                "pos": {
                    "outbound": 5,
                    "inbound": 0,
                },
                "iv": {
                    "onhand": -5,
                },
            },
            "2022-02-06T00:00:00": {
                "pos": {
                    "inbound": 7,
                    "outbound": 0,
                },
                "iv": {
                    "onhand": 7,
                },
            }
        },
        "atpQuantities": {
            "2022-02-01T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-02T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-03T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-04T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-05T00:00:00Z": {
                "iv": {
                    "onhand": 5.0
                }
            },
            "2022-02-06T00:00:00Z": {
                "iv": {
                    "onhand": 12.0
                }
            },
            "2022-02-07T00:00:00Z": {
                "iv": {
                    "onhand": 12.0
                }
            }
        },
        "productId": "Bike ",
        "dimensions": {
            "ColorId": "Red",
            "SizeId": "Big",
            "siteid": "1",
            "locationid": "11"
        },
        "quantities": {
            "pos": {
                "inbound": 10.0,
                "outbound": 0,
            },
            "iv": {
                "onhand": 10.0,
            }
        }
    }
]