Partilhar via


Disponível para promessa e agendas de alterações de disponibilidade da aplicação Visibilidade do Inventário

Este artigo descreve como configurar a caraterística Agenda de alterações de disponibilidade para agendar alterações futuras de disponibilidade e calcular quantidades de disponível para promessa (ATP). ATP é a quantidade de um item que está disponível e pode ser prometida a um cliente no período seguinte. O uso deste cálculo pode aumentar muito a sua capacidade de cumprimento de pedidos.

Para muitos fabricantes, retalhistas ou vendedores, não é suficiente saber apenas o que está atualmente disponível. Devem ter total visibilidade da disponibilidade futura. Esta disponibilidade futura deve considerar o fornecimento futuro, a procura futura e o ATP.

Medidas calculadas para as quantidades de ATP

A medida calculada de ATP é uma medida calculada predefinida que, normalmente, é usada para encontrar a quantidade disponível para entrega imediata disponível no momento. A quantidade de fornecimento é a soma das quantidades das medidas físicas que têm um tipo de modificador de adição e a quantidade de procura é a soma das quantidades das medidas físicas que têm um tipo de modificador de subtração.

Pode adicionar várias medidas calculadas para calcular várias quantidades de ATP. No entanto, o número total de medidas físicas distintas em todas as medidas calculadas de ATP deve ser inferior a nove.

Importante

Uma medida calculada é uma composição de medidas físicas. A fórmula pode incluir apenas medidas físicas sem duplicados, não medidas calculadas.

Por exemplo, pode configurar a seguinte medida configurada:

Disponível para entrega imediata = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (ReservPhysical + SoftReservePhysical + Outbound)

A soma (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) representa o fornecimento, e a soma (ReservPhysical + SoftReservePhysical + Outbound) representa a procura. Por conseguinte, a medida calculada pode ser entendida da seguinte forma:

Disponível para entrega imediata = OfertaProcura

Pode adicionar outra medida calculada para calcular a quantidade de ATP Fisicamente disponível.

Fisicamente disponível para entrega imediata = (PhysicalInvent + OnHand + Unrestricted + QualityInspection + Inbound) – (Outbound)

Existem oito medidas físicas distintas entre essas duas medidas calculadas de ATP: PhysicalInvent, OnHand, Unrestricted, QualityInspection, Inbound, ReservPhysical, SoftReservePhysical e Outbound.

Para mais informações sobre medidas calculadas, consulte Medidas calculadas.

Ativar e configurar o agendamento de alterações de disponibilidade e ATP na versão 2 da IU

Esta secção aplica-se quando estiver a utilizar a versão 2 da IU da Visibilidade do Inventário.

Antes de poder utilizar o ATP, tem de configurar uma ou mais medidas calculadas para calcular as quantidades de ATP. Também tem de ativar a caraterística e configurar as definições de ATP no Microsoft Power Apps.

Siga estes passos para ativar a caraterística de Agenda de alterações de disponibilidade no Power Apps e configurar as definições de ATP.

  1. Inicie sessão no Power Apps e abra a aplicação Visibilidade do Inventário.

  2. No painel de navegação, selecione Gestão de caraterísticas.

  3. No mosaico Disponível para promessa, selecione Gerir.

  4. Defina a opção Ativar caraterística como True para ativar a caraterística de ATP.

  5. Defina a opção Agendar por 180 dias como True para suportar o período de agenda de ATP mais longo (180 dias).

    Importante

    Por predefinição, a caraterística de ATP está limitada a sete dias. As caraterísticas de ATP de sete dias e de ATP de 180 dias são separadas e independentes uma da outra. As alterações de agenda que criar ou modificar utilizando a caraterística de ATP de sete dias não entrarão em vigor quando ativar a caraterística de ATP de 180 dias. Se tiver utilizado a caraterística de ATP de sete dias e pretender migrar para a caraterística de 180 dias, recomendamos que elimine os dados antigos e volte a publicar a sua agenda de alterações de disponibilidade depois de ativar a caraterística de 180 dias.

  6. Defina o campo Período de agenda máx. (dias) para o número de dias em que os utilizadores podem ver e submeter alterações de disponibilidade agendadas. Os utilizadores que consultam as informações de inventário obtêm a quantidade disponível, as alterações de disponibilidade agendadas e o ATP para cada dia do período definido, a partir da data atual. O valor máximo para este campo é 180 dias. Por predefinição, está definido para 30 dias. Por conseguinte, pode agendar alterações para até 30 dias a partir de hoje.

    Importante

    O período da agenda inclui a data atual. Portanto, os utilizadores podem agendar alterações de disponibilidade para ocorrerem a qualquer momento a partir da data atual (o dia em que a modificação é submetida) até (período da agenda — 1) dias no futuro.

  7. Na secção Agendar medidas, configure as medidas da agenda. Pode utilizar medidas calculadas existentes como medidas da agenda ou pode criar novas medidas. Quando consulta a Visibilidade do Inventário, o valor de ATP é fornecido para medidas calculadas definidas, com base nas alterações agendadas das medidas físicas do componente. Na secção Agendar medidas, selecione Nova configuração da agenda de alterações de disponibilidade V2 na barra de ferramentas para adicionar o enlace de medida calculada para ATP. A medida calculada é o que pretende utilizar para encontrar a quantidade disponível no momento. Para mais informações sobre como criar uma medida calculada, consulte Medidas calculadas.

    Importante

    A fórmula calculada de ATP predefinida é para referência. Pode modificar e adicionar outras origens de dados e medidas físicas para configurar o cálculo de ATP correto para a sua empresa.

  8. Na secção Configuração do conjunto de índices de ATP, configure o seu índice de ATP. O índice de ATP assemelha-se à hierarquia do índice de produtos que lhe permite agrupar os resultados da consulta por dimensões específicas. Por exemplo, se definir ColorId e SizeId como o seu conjunto de índices de ATP, os resultados da consulta serão agrupados por cor e tamanho. Pode ter vários conjuntos de índices.

    Importante

    O índice ColorId e SizeId predefinido é para referência. Pode remover dimensões e adicionar outras dimensões.

  9. Selecione Guardar.

  10. Quando tiver terminado de configurar todas as definições necessárias, selecione Atualizar Configuração em Definições de Administração no painel de navegação.

Para mais informações, consulte Concluir e atualizar a configuração.

Ativar e configurar o agendamento de alterações de disponibilidade e ATP na versão 1 da IU

Esta secção aplica-se quando estiver a utilizar a versão 1 da IU da Visibilidade do Inventário.

Siga estes passos para ativar a caraterística de Agenda de alterações de disponibilidade no Power Apps e configurar as definições de ATP.

  1. Inicie sessão no Power Apps e abra a aplicação Visibilidade do Inventário.

  2. Abra a página Configuração.

  3. No separador Gestão de Caraterísticas, ative a caraterística Disponível para promessa.

  4. Selecione o separador Definição de ATP.

  5. Ao consultar a Visibilidade do Inventário, este fornecerá um resultado que inclui cada medida calculada de ATP que adicionar aqui. Selecione Adicionar para adicionar uma nova medida calculada para ATP.

  6. Defina os seguintes campos:

    • Origem de Dados — Selecione a origem de dados que está associada à medida calculada.
    • Medida Calculada — Selecione a medida calculada que está associada à origem de dados selecionada e que pretende utilizar para encontrar a quantidade disponível atualmente.
    • Período da Agenda — Introduza o número de dias em que os utilizadores podem ver e submeter alterações de disponibilidade agendadas quando a medida calculada selecionada é utilizada. Os utilizadores que consultam as informações de inventário obtêm a quantidade disponível, as alterações de disponibilidade agendadas e o ATP para cada dia deste período, a partir da data atual. Selecione um número inteiro entre 1 e 7.

    Importante

    O período da agenda inclui a data atual. Portanto, os utilizadores podem agendar alterações de disponibilidade para ocorrerem a qualquer momento a partir da data atual (o dia em que a modificação é submetida) até (período da agenda — 1) dias no futuro.

  7. Selecione Guardar.

  8. Repita os passos 5 a 7 até adicionar todas as medidas calculadas de que necessita para o ATP.

  9. Quando acabar de configurar todas definições necessárias, selecione Atualizar Configuração.

Como funciona a agenda de alterações de disponibilidade e os cálculos de ATP

Uma agenda de alterações de disponibilidade estabelece as datas e quantidades esperadas de alterações de disponibilidade agendadas. Pode submeter uma agenda de alterações de disponibilidade para a Visibilidade do Inventário, desde que as datas estejam dentro do período definido pela definição Agendar período (consulte a secção Ativar e configurar as caraterísticas deste artigo). Os utilizadores que consultam as informações de inventário obtêm a quantidade disponível, as alterações de disponibilidade agendadas e o ATP para cada dia desse período.

As alterações agendadas são inicialmente não confirmadas e, portanto, não afetam as quantidades reais disponíveis no sistema. Para confirmar as alterações, tem de submeter um evento de alteração de disponibilidade, o que atualiza a quantidade real de disponibilidade. O utilizador tem então de reverter a alteração agendada ao submeter uma agenda de alterações de disponibilidade para uma quantidade negativa correspondente.

Por exemplo, faz uma encomenda de 10 bicicletas e espera que cheguem amanhã. Portanto, submete uma agenda de alterações de disponibilidade que tem uma quantidade de entrada de 10 e é datado para amanhã. Quando a encomenda chega no dia seguinte, adiciona as bicicletas ao inventário físico disponível. Em seguida, tem de confirmar a alteração no sistema para atualizar a quantidade real disponível. Para confirmar a alteração, submete um evento de alteração manual de disponibilidade com uma quantidade de entrada de 10. Tem então de reverter a alteração agendada ao submeter uma agenda de alterações de disponibilidade que tenha uma quantidade de entrada de -10.

Quando consulta a Visibilidade do Inventário para quantidades disponíveis e de ATP, devolve as seguintes informações para cada dia no período da agenda:

  • Data — A data a que o resultado se aplica. O fuso horário é Hora Universal Coordenada (UTC).
  • Quantidade disponível — A quantidade real disponível para a data especificada. Este cálculo é efetuado de acordo com a medida calculada de ATP que está configurada para a Visibilidade do Inventário.
  • Fornecimento agendado — A soma de todas as quantidades de entrada agendadas que não se tornaram fisicamente disponíveis para consumo imediato ou envio a partir da data especificada.
  • Procura agendada — A soma de todas as quantidades agendadas de saída que não foram consumidas ou enviadas até a data especificada.
  • Quantidade de ATP — A quantidade disponível mínima projetada a partir da data especificada até ao final do período da agenda. Esta quantidade inclui todos os ajustes de quantidades agendadas. É a quantidade máxima que pode ser prometida na data atual para entrega ou consumo nesse dia.

Por exemplo, se a data atual for 1 de fevereiro de 2022 e o período da agenda for 7, os utilizadores podem submeter alterações agendadas de disponibilidade que se espera que ocorram de 1 a 7 de fevereiro de 2022. Neste caso, a quantidade de ATP para 3 de fevereiro, por exemplo, é calculada com base na quantidade disponível para esse dia e nas quantidades agendadas de 3 a 7 de fevereiro.

Exemplo

O exemplo a seguir mostra como uma série de alterações de quantidade agendadas afeta as quantidades disponíveis e o ATP que a Visibilidade do Inventário reporta. Também mostra como confirmar uma alteração agendada, como uma alteração agendada confirmada afeta os resultados e o que pode acontecer se não confirmar uma alteração agendada.

Os resultados neste exemplo mostram um valor de projetado disponível. Este valor incorpora todas as atualizações agendadas para fins ilustrativos, mas não é realmente reportado quando consulta a Visibilidade do Inventário.

  1. As seguintes definições são configuradas para o seu sistema na página Definição de ATP da aplicação Visibilidade do Inventário no Power Apps:

    • Agendar medidas — Uma medida calculada com o nome Disponível é adicionada aqui. É calculada como Disponível = FornecimentoProcura.
    • Período máximo da agenda (dias) — O valor é definido como 7.
    • Configuração do conjunto de índices de ATPColorId e SizeId são adicionados aqui.
  2. Aplicam-se também as seguintes condições:

    • A data atual é 1 de fevereiro de 2022.
    • A quantidade disponível atual é 20.
  3. Para a data atual (1 de fevereiro de 2022), submete uma quantidade de procura agendada de 3 para a Visibilidade do Inventário. Portanto, a quantidade disponível projetada é 17. A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-01 20 3 17 17
    2022-02-02 20 17 17
    2022-02-03 20 17 17
    2022-02-04 20 17 17
    2022-02-05 20 17 17
    2022-02-06 20 17 17
    2022-02-07 20 17 17
  4. Na data atual (1 de fevereiro de 2022), submete uma quantidade de fornecimento agendada de 10 para 3 de fevereiro de 2022. A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-01 20 3 17 17
    2022-02-02 20 17 17
    2022-02-03 20 10 27 27
    2022-02-04 20 27 27
    2022-02-05 20 27 27
    2022-02-06 20 27 27
    2022-02-07 20 27 27
  5. Na data atual (1 de fevereiro de 2022), submete as seguintes alterações a quantidades agendadas:

    • Quantidade de procura de 15 para 4 de fevereiro de 2022
    • Quantidade de fornecimento de 1 para 5 de fevereiro de 2022
    • Quantidade de fornecimento de 3 para 6 de fevereiro de 2022

    A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-01 20 3 17 12
    2022-02-02 20 17 12
    2022-02-03 20 10 27 12
    2022-02-04 20 15 12 12
    2022-02-05 20 1 13 13
    2022-02-06 20 3 16 16
    2022-02-07 20 16 16
  6. Na data atual (1 de fevereiro de 2022), envia a quantidade de procura agendada de 3. Portanto, tem de confirmar esta alteração para que seja refletida na quantidade real disponível. Para confirmar a alteração, submete um evento de alteração manual de disponibilidade com uma quantidade de saída de 3. Tem então de reverter a alteração agendada ao submeter uma agenda de alterações de disponibilidade que tenha uma quantidade de saída de -3. A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-01 17 0 17 12
    2022-02-02 17 17 12
    2022-02-03 17 10 27 12
    2022-02-04 17 15 12 12
    2022-02-05 17 1 13 13
    2022-02-06 17 3 16 16
    2022-02-07 17 16 16
  7. No dia seguinte (2 de fevereiro de 2022), o período da agenda avança um dia. A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-02 17 17 12
    2022-02-03 17 10 27 12
    2022-02-04 17 15 12 12
    2022-02-05 17 1 13 13
    2022-02-06 17 3 16 16
    2022-02-07 17 16 16
    2022-02-08 17 16 16
  8. No entanto, dois dias depois (4 de fevereiro de 2022), a quantidade de fornecimento de 10 que estava agendada para 3 de fevereiro ainda não chegou. A tabela seguinte apresenta o resultado.

    Data Disponível para entrega imediata Fornecimento agendado Procura agendada Disponibilidade projetada ATP
    2022-02-04 17 15 2 2
    2022-02-05 17 1 3 3
    2022-02-06 17 3 6 6
    2022-02-07 17 6 6
    2022-02-08 17 6 6
    2022-02-09 17 6 6
    2022-02-10 17 6 6

    Como pode ver, as alterações de disponibilidade agendadas (mas não confirmadas) não afetam a quantidade real disponível.

Submeter agendamento de alterações, eventos de alteração e consultas ATP através da API

Pode utilizar os seguintes URLs da interface de programação de aplicações (API) para submeter agendas de alterações de disponibilidade, eventos de alterações e consultas.

Caminho Método Descrição
/api/environment/{environmentId}/onhand/changeschedule POST Criar uma alteração de disponibilidade entrega imediata agendada.
/api/environment/{environmentId}/onhand/changeschedule/bulk POST Criar várias alterações de disponibilidade entrega imediata agendadas.
/api/environment/{environmentId}/onhand POST Criar um evento de alteração de disponibilidade.
/api/environment/{environmentId}/onhand/bulk POST Crie vários eventos de alteração.
/api/environment/{environmentId}/onhand/indexquery POST Consultar utilizando o método POST.
/api/environment/{environmentId}/onhand GET Consultar utilizando o método GET.
/api/environment/{environmentId}/onhand/exactquery POST Consulta exata utilizando o método POST.

Para mais informações, consulte APIs públicas da Visibilidade do Inventário.

Criar um agendamento de alteração de disponibilidade

É criado um calendário de alterações disponível através da apresentação de um pedido POST para o URL serviço de visibilidade do inventário relevante. Também pode submeter pedidos em massa.

Só é possível criar uma agenda de alterações de disponibilidade se a data agendada estiver entre a data atual e o final do período atual da agenda. O formato de datetime deve ser ano-mês-dia (por exemplo, 2022-02-01). O formato da hora tem de ser exato apenas para o dia.

Esta API cria uma única agenda de alteração de disponibilidade.

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,
                },
            },
        },
    }

O exemplo a seguir mostra o conteúdo de amostra do corpo sem 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
            }
        }
    }
}

Criar várias agendas de alterações de disponibilidade

Esta API pode criar vários registos ao mesmo tempo. As únicas diferenças entre esta API e a API de evento único são os valores Path e Body. Para esta API, Body fornece uma série de registos. O número máximo de registos é 512. Por conseguinte, a API de agenda de alterações de disponibilidade em massa pode suportar até 512 alterações agendadas de cada vez.

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,
                    },
                },
            },
        },
        ...
    ]

O exemplo a seguir mostra o conteúdo de amostra do corpo.

[
    {
        "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
                }
            }
        }
    }
]

Criar eventos de alteração de disponibilidade

Os eventos de alteração em curso são efectuados através da apresentação de um pedido POST para o URL serviço de visibilidade do inventário relevante (ver o início da secção Enviar calendários de alteração, eventos de alteração e consultas ATP através da API ).

Nota

Os eventos de alterações de disponibilidade não são exclusivos da funcionalidade de ATP, mas fazem parte da API de Visibilidade do Inventário padrão. Este exemplo foi incluído porque os eventos são relevantes quando trabalha com ATP. Os eventos de alterações de disponibilidade são semelhantes às reservas de alterações de disponibilidade, mas as mensagens de eventos têm de ser enviadas para um URL de API diferente e os eventos utilizam quantities em vez de quantityByDate no corpo da mensagem. Para mais informações sobre os eventos de alterações de disponibilidade e outras caraterísticas da API de Visibilidade do Inventário, consulte APIs públicas da Visibilidade do Inventário.

O exemplo a seguir mostra um corpo do pedido que contém um único evento de alteração de disponibilidade manual.

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

Consultar as alterações de disponibilidade agendadas e os resultados de ATP

Pode consultar as alterações de disponibilidade agendadas e os resultados de ATP ao submeter um pedido POST ou um pedido GET ao URL da API apropriado (consulte a secção Submeter agendas de alterações, eventos de alterações e consultas de ATP através da API).

No seu pedido, defina QueryATP como true se pretender consultar as alterações de disponibilidade agendadas e os resultados de ATP. Por predefinição, a consulta devolve todos os dados relacionados com ATP a partir de hoje. Pode especificar ATPFromDate e ATPToDate para restringir os resultados. (As datas "para" e "de" apenas filtram o resultado. Não afetam a forma como o ATP é calculado).

  • Se estiver a submeter o pedido através do método GET, defina este parâmetro no URL.
  • Se estiver a submeter o pedido através do método POST, defina este parâmetro no corpo do pedido.

Nota

Independentemente de o parâmetro returnNegative estar definido como true ou false no corpo do pedido, o resultado incluirá valores negativos quando consultar as alterações de disponibilidade agendadas e os resultados de ATP. Estes valores negativos serão incluídos porque, se apenas as encomendas de procura estiverem agendadas, ou se as quantidades de fornecimento forem inferiores às quantidades de procura, as quantidades de alterações de disponibilidade agendadas serão negativas. Se os valores negativos não foram incluídos, os resultados seriam confusos. Para mais informações sobre esta opção e como funciona para outros tipos de consultas, consulte APIs públicas da Visibilidade do Inventário.

Consultar utilizando o método 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,
    }

O exemplo a seguir mostra como criar um corpo do pedido de consulta de índice que pode ser submetido à Visibilidade do Inventário utilizando o método 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",
}

Consultar utilizando o método 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]

O exemplo a seguir mostra como criar um URL de pedido de consulta de índice como um pedido 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

O resultado deste pedido GET é exatamente o mesmo que o resultado do pedido POST no exemplo anterior.

Consulta exata utilizando o método POST

Para configurar uma consulta exata, adicione campos relacionados com ATP ao corpo da consulta. Para mais informações, consulte Consulta exata utilizando o método POST.

{
    // Exact query fields
    // ...

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

Exemplo de resultado da consulta

Qualquer um dos exemplos de consulta anteriores pode produzir a resposta que se segue. Para este exemplo, o sistema é configurado com as seguintes definições:

  • Medida calculada de ATP:iv.onhand = pos.inbound – pos.outbound
  • Período da agenda:7

Eis um exemplo do corpo da resposta.

[
    {
        "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,
            }
        }
    }
]