Sincronizar ajustes de inventário externo por meio da Visibilidade do Inventário

Este artigo explica como configurar o sistema para sincronizar transações de ajuste de inventário registradas em um sistema externo com o Microsoft Dynamics 365 Supply Chain Management e o Inventory Visibility por meio da camada de negócios do serviço Inventory Visibility.

Algumas organizações têm várias fontes ou canais de operações de inventário que funcionam fora de Gerenciamento da Cadeia de Suprimentos. Usando esse recurso, essas organizações podem usar a Visibilidade de Inventário para armazenar suas transações de inventário omnichannel. Com base nessas transações, a Visibilidade de Inventário pode criar e postar diários de ajuste de inventário para Gerenciamento da Cadeia de Suprimentos. Esses recursos fornecem os seguintes principais benefícios comerciais:

• Gerencie todos os ajustes de inventário omnichannel em um só lugar. Você pode postar ajustes de inventário em todos os canais e fontes de dados na Visibilidade do Inventário. Em seguida, o Inventory Visibility gerencia a agregação e o lançamento para o Gerenciamento da Cadeia de Suprimentos.
• Acompanhe o fluxo de inventário de ponta a ponta. Você pode acompanhar os fluxos de estoque a partir das transações e dos documentos de origem até os registros de estoque e financeiros no Gerenciamento da Cadeia de Suprimentos. O sistema armazena tipos de documento de origem e números de referência ao postar ajustes de inventário na Visibilidade do Inventário. A Visibilidade de Estoque também vincula os números de diário do Gerenciamento da Cadeia de Suprimentos à transação de estoque original.

Arquitetura e fluxo de dados

A Visibilidade de Estoque apresenta o conceito da camada de negócios, que fica na parte superior do serviço de Visibilidade de Estoque. O serviço visibilidade de inventário processa e atualiza dados no cache, mas não grava dados diretamente no Gerenciamento da Cadeia de Suprimentos. O recurso de camada de negócios adiciona os seguintes elementos e recursos:

• Uma API de ajuste de inventário (/api/environment/{environmentId}/transaction/adjustment/bulk) projetada para criar transações de ajuste de inventário na camada de negócios visibilidade de inventário. A camada de negócio tem colunas que são usadas para integrar-se aos diários do Gerenciamento da Cadeia de Suprimentos e rastrear transações e documentos de origem.
• Uma entidade que armazena os detalhes das transações de inventário omnicanal que são enviados para a camada de negócios do Inventory Visibility usando a nova API.
• Um mecanismo configurável que atualiza automaticamente as transações de ajuste de inventário postadas no serviço de Visibilidade de Inventário (serviço de cache na memória) em um intervalo regular.
• Um mecanismo configurável que agrega as transações detalhadas de ajuste de inventário e sincroniza com Gerenciamento da Cadeia de Suprimentos em um intervalo regular e de acordo com as regras definidas.
• Uma nova página da interface do usuário para o aplicativo Visibilidade de Estoque no Power Apps. Esta página permite que você publique manualmente transações de ajuste de inventário na camada de negócios do Inventory Visibility. É uma alternativa ao uso da API. A interface do usuário também permite exibir transações em um formato detalhado ou agregado.

Pré-requisitos

Antes de usar os recursos descritos neste artigo, verifique se o sistema atende aos seguintes requisitos:

• Você está executando Dynamics 365 Supply Chain Management versão 10.0.41 ou posterior.

• Você está executando o serviço de Visibilidade de Estoque na versão 1.2.3.88 ou posterior. Para obter mais informações sobre como instalar a Visibilidade do Inventário, verifique seu número de versão e atualize-o conforme necessário, consulte Instalar e configurar a Visibilidade do Inventário.

• Os seguintes recursos são ativados no gerenciamento de recursos:

  • Integração do Inventory Visibility com compensação de ajuste de estoque (Esse recurso é um pré-requisito. A partir da versão 10.0.45 do Gerenciamento da Cadeia de Suprimentos, esse recurso é obrigatório e não pode ser desativado.)
  • Inventory Visibility integration (esse recurso é um pré-requisito. A partir de Gerenciamento da Cadeia de Suprimentos versão 10.0.45, esse recurso é ativado por padrão.)
  • Integração com transações de Visibilidade de Estoque (Este recurso adiciona os recursos descritos neste artigo. A partir da versão 10.0.45 do Gerenciamento da Cadeia de Suprimentos, esse recurso está ativado por padrão. A partir da versão 10.0.49, é obrigatório e não pode ser desligado.)

Configurar a sincronização de transações de inventário

Configurar o recurso pela primeira vez

Para configurar o recurso pela primeira vez, siga estas etapas:

1. Entre no Gerenciamento da Cadeia de Suprimentos.
2. Vá para Gerenciamento de estoque>Configuração>Visibilidade de estoque>Parâmetros de integração da Visibilidade de estoque.
3. Na guia Transação , defina a opção Habilitar sincronização de diário de ajuste como Sim.
4. Selecione Generate configurations para executar um script de implantação automática que inicializa a configuração no Gerenciamento da Cadeia de Suprimentos e no serviço visibilidade de inventário.
5. Selecione Ativar trabalho de lançamento para abrir a caixa de diálogo Trabalho de lançamento da Visibilidade do Inventário.
6. Cada vez que o trabalho de lançamento da Visibilidade de Estoque é executado, ele lança automaticamente os diários de ajuste de estoque enviados da camada de negócios da Visibilidade de Estoque. Agende esse trabalho para ser executado com a frequência que for apropriado para sua empresa. Dependendo do volume de dados de entrada, esse trabalho pode ser intensivo em recursos, portanto, agende-o para ser executado fora do horário de pico. Selecione o link Recorrência para abrir a caixa de diálogo Definir recorrência , use-a para configurar sua agenda e selecione OK para salvar suas configurações.
7. Selecione OK para fechar a caixa de diálogo.

Gerenciar a configuração do recurso

Para gerenciar a configuração de recursos, siga estas etapas:

1. Entre no Power Apps e abra o aplicativo Inventory Visibility.

2. No painel de navegação, selecione Configurações>Gerenciamento de recursos.

3. No bloco De inventário de transações , selecione Gerenciar.

4. Na página Transação , na seção superior, defina os seguintes campos:

   • Habilitar recurso – Defina essa opção como True para habilitar o recurso. Defina-o como False para desabilitar o recurso. O recurso é ativado automaticamente quando você inicializa a configuração, conforme descrito na seção anterior.
   • Sincronizar periodicamente a transação com IV – defina essa opção como True se você quiser que o sistema sincronize automaticamente as atualizações de inventário da camada de negócios visibilidade de inventário para o serviço visibilidade de inventário em intervalos regulares. Defina-o como False para desabilitar essa funcionalidade.
   • Inventory Visibility synchronization frequency – insira um inteiro para especificar com que frequência (em minutos) o sistema sincroniza atualizações de inventário da camada de negócios visibilidade de inventário para Gerenciamento da Cadeia de Suprimentos (se você habilitou essa funcionalidade). O valor padrão é 5.

5. Na seção Configurações de Sincronização do Fno , defina os seguintes campos:

   • Habilitar trabalho de sincronização – Defina esta opção como True caso queira que o sistema agregue e sincronize automaticamente as atualizações de inventário da camada de negócios Inventory Visibility para o Gerenciamento da Cadeia de Suprimentos em intervalos regulares. Quando essa opção é definida como False, as transações omnichannel ainda são armazenadas na camada de negócios visibilidade de inventário. No entanto, eles não são sincronizados com Gerenciamento da Cadeia de Suprimentos.
   • Configurações de trabalho – selecione o valor de configuração para abrir a página de configurações detalhadas, em que você pode especificar a hora de início e término, o intervalo de recorrência e a unidade para sincronizar atualizações de inventário da camada de negócios visibilidade de inventário para o serviço visibilidade de inventário (se essa funcionalidade estiver habilitada). O trabalho é agendado automaticamente com configurações padrão quando você instala a Visibilidade do Inventário.
   • Contagem do máximo de linhas de sincronização do FnO no diário de ajuste – insira um número inteiro para especificar o número máximo de linhas de ajuste de estoque permitidas por diário de ajuste durante a sincronização de volta com o Gerenciamento da Cadeia de Suprimentos. O valor padrão é 10.000.
   • Contagem máxima de diários no pacote para sincronização do Fno – Insira um número inteiro para especificar o número máximo de diários de ajuste de estoque permitidos por pacote de dados durante a sincronização de volta para o Gerenciamento da Cadeia de Suprimentos. O valor padrão é 1.

6. Use a seção Fno integration mappings para controlar como os dados são mapeados da camada de negócio da Visibilidade de Inventário para o Gerenciamento da Cadeia de Suprimentos. Use os botões na barra de ferramentas para adicionar, editar ou excluir mapeamentos conforme necessário. Para cada mapeamento, defina os seguintes campos:

   • Nome da medida física – selecione a medida física que fornece a quantidade do inventário.

   • Target FnO Transaction type – Especifique o tipo de diário de inventário criado no Gerenciamento da Cadeia de Suprimentos. O valor padrão é o diário de ajuste de inventário.

   • Target FnO Transaction Status – selecione um dos seguintes valores para especificar o status do diário de inventário criado no Gerenciamento da Cadeia de Suprimentos:

     • None – o sistema não cria transações no Gerenciamento da Cadeia de Suprimentos.
     • Created – O sistema cria transações, mas não as publica automaticamente em Gerenciamento da Cadeia de Suprimentos.
     • Lançado – o sistema cria transações e lança financeiramente o diário no Gerenciamento da Cadeia de Suprimentos.

7. Se você definir a opção Sincronizar periodicamente a transação com o Fno como True, deverá garantir que seu sistema esteja configurado para compensar os ajustes de inventário e impedir que as quantidades em inventário sejam atualizadas duas vezes. Saiba mais em Compensação de ajuste de Visibilidade de Estoque.

Insira manualmente os ajustes de inventário no aplicativo Visibilidade do Inventário

Use o aplicativo Inventory Visibility no Power Apps para inserir manualmente ajustes de estoque diretamente na camada de negócios do Inventory Visibility.

1. Entre no Power Apps e abra o aplicativo Inventory Visibility.

2. No painel de navegação, selecione Consultas e relatórios>transações de inventário.

3. Na barra de ferramentas, selecione Criar transação>Ajuste de inventário.

4. Em Criar ajuste de inventário, no FastTab de informações de produto e dimensão , especifique o produto para o qual você deseja ajustar o inventário. Se algumas das dimensões do produto de que você precisa (como cor ou estilo) não forem mostradas, selecione Editar dimensões para adicioná-las.

5. Na FastTab Quantidade de ajuste, selecione a fonte de dados, a medida física e a quantidade do ajuste de inventário. Para atualizar imediatamente os ajustes de estoque no cache do serviço de Visibilidade de Estoque a partir da área de preparação, marque a caixa de seleção Atualização instantânea para o serviço VE.

6. No FastTab de informações adicionais , defina os seguintes campos opcionais:

   • Categoria de referência externa – especifique o tipo de transação de origem para o ajuste de inventário, como ordem de vendas, delta de contagem de inventário ou transação de POS.
   • ID de referência externa – insira a ID do documento de origem do sistema externo.
   • Nome do diário do Gerenciamento da Cadeia de Suprimentos – Especifique o diário de ajuste de estoque a ser usado no Gerenciamento da Cadeia de Suprimentos. Se você deixar esse campo em branco, o nome do diário padrão definido em Gerenciamento da Cadeia de Suprimentos será usado.
   • Preço de custo do item – Especifique o preço de custo do item para criar no Gerenciamento da Cadeia de Suprimentos. Se você deixar esse campo em branco, o diário criado no Gerenciamento da Cadeia de Suprimentos usará o método de cálculo de custo padrão definido em Gerenciamento da Cadeia de Suprimentos para calcular o preço do custo.
   • Trans date – a data da transação a ser definida na linha de diário quando ela é criada no Gerenciamento da Cadeia de Suprimentos.

7. Para visualizar como o ajuste de inventário ficará quando for enviado para a camada de negócios do Inventory Visibility por meio da API, selecione Referência do desenvolvedor. Esta ação mostra o corpo JSON (JavaScript Object Notation) que é enviado para a camada de negócios do Inventory Visibility quando você lança a transação.

8. Na barra de ferramentas, selecione Post.

Enviar ajustes de inventário para a API de Visibilidade de Inventário

Os sistemas externos normalmente enviam ajustes de inventário para a camada de negócios do Inventory Visibility por meio da API de ajuste de inventário. O exemplo a seguir mostra os detalhes da API e do conteúdo do corpo.

Path:
    /api/environment/{environmentId}/transaction/adjustment/bulk
Method:
    Post
Headers:
    Api-Version="1.0"
    Authorization="Bearer $access_token"
ContentType:
    application/json
Query(Url Parameters):
    createWithIVSync # bool, optional
Body:
[
    {
        "id": string
        "organizationId": string,
        "productId": string,
        "quantityDataSource": string,
        "physicalMeasure": string,
        "dimensions": {
            "siteId": string,
            "locationId": string,
            [key:string]: string, # optional
        },
        "quantity": number,
        "externalReferenceCategory": string, # optional
        "externalReferenceId": string, # optional
        "fnoJournalNameId": string, # optional
        "costPrice": number, # optional
        "transDate": date, # optional
    },
]

Saiba mais sobre como trabalhar com a API de Visibilidade de Inventário, incluindo como autenticar e obter um token de acesso, em APIs públicas de Visibilidade de Inventário.

Exibir transações de inventário no aplicativo Visibilidade do Inventário

O aplicativo Visibilidade de Inventário no Power Apps fornece uma interface do usuário em que você pode exibir transações de inventário detalhadas e agregadas.

• As transações de inventário detalhadas incluem todas as transações individuais, juntamente com todos os detalhes originais.
• As transações de inventário agregadas combinam linhas que têm valores de dimensão correspondentes (como site, warehouse e cor). Algumas informações podem ser omitidas. Em vez de mostrar cada transação individual, a interface do usuário mostra totais ou médias nas dimensões especificadas. Somente as transações agregadas são sincronizadas com Gerenciamento da Cadeia de Suprimentos.

As transações detalhadas e agregadas diferem das seguintes maneiras:

• Granularidade:

  • Transações detalhadas mostram transações de ajuste de inventário originais individuais e fornecem dados refinados.
  • As transações agregadas mostram dados resumidos e fornecem uma visão geral de nível superior.

• Volume de dados:

  • Os conjuntos de dados de transação detalhados normalmente são maiores porque incluem todas as transações.
  • Os conjuntos de dados de transação agregados normalmente são menores porque condensam várias transações semelhantes em registros únicos.

Exibir transações de inventário detalhadas

Para exibir transações de inventário detalhadas, siga estas etapas:

1. Entre no Power Apps e abra o aplicativo Inventory Visibility.

2. No painel de navegação, selecione Consultas e relatórios>transações de inventário.

3. Na linha em que o campo Tipo está definido como Detalhe, na coluna Ação , selecione Exibição.

   Na página detalhes da transação , uma grade lista os detalhes de cada transação bem-sucedida. A maioria das colunas é autoexplicativa, mas aqui estão algumas colunas importantes a serem observadas:

   • ID do registro de linha – o GUID (identificador global exclusivo) gerado automaticamente para cada transação original de ajuste de estoque. Selecione o link para exibir mais detalhes sobre a transação.

   • Status da linha de origem – o status atual da transação. Os seguintes valores são usados:

     • Criado – O ajuste foi criado na camada de negócios de Visibilidade de Estoque e está aguardando lançamento. Esse status é o status inicial dos registros de ajuste de inventário.
     • IVPosted – o ajuste foi atualizado com êxito no cache de Visibilidade de Estoque a partir da área de preparo. Esse status é o status pré-requisito para agregação.
     • Agregado – as linhas detalhadas foram agregadas com êxito com base nos valores de dimensão correspondentes. Esse status é o pré-requisito para a sincronização com o Gerenciamento da Cadeia de Suprimentos.

   • ID de linha agregada – selecione o link para exibir detalhes sobre a linha agregada vinculada. Depois que as linhas agregadas são criadas com êxito e/ou lançadas no Gerenciamento da Cadeia de Suprimentos, a ID do diário e a ID da linha de diário que o Gerenciamento da Cadeia de Suprimentos retorna são adicionadas aos detalhes da transação agregada.

Exibir transações de inventário agregadas

Para exibir transações de inventário agregadas, siga estas etapas:

1. Entre no Power Apps e abra o aplicativo Inventory Visibility.

2. No painel de navegação, selecione Consultas e relatórios>transações de inventário.

3. Na linha em que o campo Tipo é definido como Agregado, na coluna Ação , selecione Exibição.

   Na página Transação agregada, uma grade exibe os detalhes de cada transação agregada bem-sucedida. A maioria das colunas é autoexplicativa, mas aqui estão algumas colunas importantes a serem observadas:

   • ID da linha de registro – o GUID que é gerado automaticamente para cada transação agregada de ajuste de inventário. Selecione o link para exibir mais detalhes sobre a transação agregada. Depois que as linhas agregadas são criadas com êxito e/ou lançadas no Gerenciamento da Cadeia de Suprimentos, a ID do diário e a ID da linha de diário que o Gerenciamento da Cadeia de Suprimentos retorna são incluídas nos detalhes da transação agregada.

   • Status da linha agregada – o status atual da transação agregada. Os seguintes valores são usados:

     • Criado – o registro de transação agregado foi criado com êxito. Esse status é o status inicial do registro de transação agregado.
     • DoNotSync – a linha não está sincronizada com Gerenciamento da Cadeia de Suprimentos. Esse status normalmente ocorre porque a quantidade de alteração de inventário da linha agregada é 0 (zero). (Como a quantidade de inventário não foi alterada, não há necessidade de sincronizá-la.)
     • FnOSyncEnqueued – A Visibilidade do Inventário enviou uma solicitação para sincronizar a linha com Gerenciamento da Cadeia de Suprimentos. Esse status indica que o registro foi sincronizado em Gerenciamento da Cadeia de Suprimentos e está aguardando processamento adicional.
     • FnOTransCreated – Gerenciamento da Cadeia de Suprimentos processou com êxito a solicitação de sincronização e criou o diário de inventário.
     • FnOTransCreateError – ocorreu um erro durante a tentativa de criar o diário de inventário no Gerenciamento da Cadeia de Suprimentos. Use a ID da mensagem para verificar o erro. Acesse Gerenciamento da Cadeia de Suprimentos>Espaço de trabalho de administração do sistema>Gerenciamento de Dados de TI>Trabalhos de dados recorrentes.
     • FnOTransPosted – O diário de inventário foi publicado com êxito.
     • FnOTransPostError – Falha na postagem do diário de inventário.

Exportar detalhes da transação

Para exportar detalhes da transação, você deve acessá-los da entidade dataverse e exportá-los de lá. Os nomes de entidade são Linha de Ajuste e Linha de Ajuste Agregado.

Verificar os diários de inventário postados no Gerenciamento da Cadeia de Suprimentos

Para exibir as linhas agregadas que são postadas ou criadas com êxito no Gerenciamento da Cadeia de Suprimentos, siga estas etapas:

1. Entre no Gerenciamento da Cadeia de Suprimentos.
2. Vá para Gerenciamento de inventário>Lançamentos contábeis>Itens>Ajuste de inventário.
3. Altere o filtro da coluna Posted conforme necessário para exibir diários postados, diários não postados ou todos os diários.