Sincronizar ajustes externos de inventário através da Visibilidade de Inventário

Este artigo explica como configurar o sistema para sincronizar transações de ajuste de inventário registadas num sistema externo para Microsoft Dynamics 365 Supply Chain Management e a Visibilidade de Inventário através da camada de negócio do serviço de Visibilidade de Inventário.

Algumas organizações têm múltiplas fontes ou canais de operações de inventário que atuam fora da Supply Chain Management. Ao utilizar esta funcionalidade, essas organizações podem usar a Visibilidade de Inventário para armazenar as suas transações de inventário omnichannel. Com base nestas transações, a Visibilidade de Inventário pode criar e publicar diários de ajuste de inventário na Supply Chain Management. Estas capacidades proporcionam os seguintes benefícios empresariais chave:

• Gerir todos os ajustes de inventário omnicanal num só lugar. Podes publicar ajustes de inventário em todos os canais e fontes de dados na Visibilidade do Inventário. A Visibilidade de Inventário gere então a agregação e a publicação para a Supply Chain Management.
• Acompanha o fluxo de inventário de ponta a ponta. Pode acompanhar fluxos de inventário desde transações e documentos de origem até aos registos de inventário e financeiros da Supply Chain Management. O sistema armazena os tipos de documentos de origem e os números de referência quando publica ajustes de inventário na Visibilidade de Inventário. Inventory Visibility também associa os números de diário do Supply Chain Management às transações de inventário originais.

Arquitetura e fluxo de dados

A Visibilidade do Inventário introduz o conceito de camada de negócio, que assenta no topo do serviço de Visibilidade do Inventário. O serviço de Visibilidade de Inventário processa e atualiza os dados na cache, mas não escreve diretamente os dados de volta para a Supply Chain Management. A funcionalidade da camada de negócio acrescenta os seguintes elementos e capacidades:

• Uma API de ajuste de inventário (/api/environment/{environmentId}/transaction/adjustment/bulk) concebida para criar transações de ajuste de inventário na camada de negócio de Visibilidade de Inventário. A camada de negócio tem colunas que são usadas para integrar com os diários de Supply Chain Management e acompanhar transações e documentos de origem.
• Uma entidade que armazena detalhes das transações de inventário omnicanal que são publicados na camada de negócio de Visibilidade de Inventário através da nova API.
• Um mecanismo configurável que atualiza automaticamente as transações de ajuste de inventário publicadas para o serviço de Visibilidade de Inventário (serviço de cache em memória) a intervalos regulares.
• Um mecanismo configurável que agrega as transações detalhadas de ajuste de inventário e sincroniza com a Supply Chain Management a intervalos regulares e de acordo com regras definidas.
• Uma nova página de interface de utilizador (UI) para a aplicação Inventory Visibility no Power Apps. Esta página permite-lhe publicar manualmente as transações de ajuste de inventário na camada de negócio Visibilidade de Inventário. É uma alternativa à utilização da API. A interface também permite visualizar as transações num formato detalhado ou agregado.

Pré-requisitos

Antes de poder utilizar as funcionalidades descritas neste artigo, certifique-se de que o seu sistema cumpre os seguintes requisitos:

• Estás a usar o Dynamics 365 Supply Chain Management versão 10.0.41 ou posterior.

• Está a executar o serviço de Visibilidade de Inventário versão 1.2.3.88 ou posterior. Para mais informações sobre como instalar o Inventory Visibility, verificar o número de versão e atualizá-lo conforme necessário, consulte Instalar e configurar Inventory Visibility.

• As seguintes funcionalidades estão ativadas na gestão de funcionalidades:

  • Integração da Visibilidade do inventário com compensação de ajuste do inventário (Esta funcionalidade é um pré-requisito. A partir da versão 10.0.45 do Supply Chain Management, esta funcionalidade é obrigatória e não pode ser desativada.)
  • Integração da Visibilidade do Inventário (Esta funcionalidade é um pré-requisito. A partir da versão 10.0.45 do Supply Chain Management, esta funcionalidade está ativada por predefinição.)
  • Integração de transações com Visibilidade de Inventário (Esta funcionalidade acrescenta as funcionalidades descritas neste artigo. A partir da versão 10.0.45 do Supply Chain Management, esta funcionalidade está ativada por defeito. A partir da versão 10.0.49, é obrigatório e não pode ser desligado.)

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

Configurar a funcionalidade pela primeira vez

Para configurar a funcionalidade pela primeira vez, siga estes passos:

1. Inicie sessão no Supply Chain Management.
2. Vá a Gestão de Inventário>Configuração>Visibilidade de Inventário>Parâmetros de integração da Visibilidade de Inventário.
3. No separador Transação , defina a opção Ativar sincronização do diário de ajuste para Sim.
4. Selecione Gerar configurações para executar um script automático de implementação que inicializa a configuração no Supply Chain Management e no serviço de Visibilidade de Inventário.
5. Selecione Ativar tarefa de publicação para abrir a caixa de diálogo Tarefa de publicação da Visibilidade de Inventário.
6. Cada vez que o trabalho de publicação de Visibilidade de Inventário é executado, publica automaticamente os diários de ajuste de inventário submetidos pela camada de negócio de Visibilidade de Inventário. Agende esta tarefa para ser executada com a frequência mais adequada para a sua empresa. Dependendo do volume de dados recebidos, este trabalho pode ser intensivo em recursos, por isso agenda-o para funcionar durante as horas de menor afluência. Seleciona o link Recorrência para abrir o diálogo Definir recorrência , usa-o para configurar o teu calendário e depois seleciona OK para guardar as definições.
7. Selecione OK para fechar a caixa de diálogo.

Gerir a configuração das funcionalidades

Para gerir a configuração das funcionalidades, siga estes passos:

1. Inicia sessão no Power Apps e abre a aplicação Inventory Visibility.

2. No painel de navegação, selecione Definições>Gestão de funcionalidades.

3. No mosaico Transações de Inventário , selecione Gerir.

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

   • Ativar funcionalidade – Defina esta opção para Verdadeiro para ativar a funcionalidade. Defina como Falso para desativar a funcionalidade. A funcionalidade é ativada automaticamente quando inicializa a configuração conforme descrito na secção anterior.
   • Sincronize periodicamente a transação com IV – Defina esta opção para Verdadeiro se quiser que o sistema sincronize automaticamente as atualizações de inventário da camada de negócio de Visibilidade de Inventário para o serviço de Visibilidade de Inventário em intervalos regulares. Defina para Falso para desativar esta funcionalidade.
   • Frequência de sincronização da Visibilidade de Inventário – Introduza um número inteiro para especificar com que frequência (em minutos) o sistema sincroniza as atualizações de inventário da camada de negócio da Visibilidade de Inventário para o Supply Chain Management (se tiver ativado esta funcionalidade). O valor padrão é 5.

5. Na secção de Definições de Sincronização Fno , defina os seguintes campos:

   • Habilitar Sync Job – Defina esta opção para True se quiser que o sistema agregue e sincronize automaticamente as atualizações de inventário da camada de negócio de Visibilidade de Inventário para Supply Chain Management a intervalos regulares. Quando esta opção está definida como Falso, as transações omnicanal continuam armazenadas na camada de negócio Visibilidade de Inventário. No entanto, não estão sincronizados com a Supply Chain Management.
   • Definições do trabalho – Selecione o valor de definição para abrir a página de definições detalhadas, onde pode especificar a hora de início e fim, o intervalo de recorrência e a unidade para sincronizar as atualizações de inventário da camada de negócio Visibilidade de Inventário para o serviço de Visibilidade de Inventário (se esta funcionalidade estiver ativada). A tarefa é agendada automaticamente com as definições predefinidas quando instalar o Inventory Visibility.
   • Contagem máxima de linhas para sincronização de Fno no diário de ajustes – Introduza um número inteiro para especificar o número máximo de linhas de ajustes de inventário permitidas por diário de ajustes durante a sincronização de volta para o Supply Chain Management. O valor padrão é 10.000.
   • Número máximo de diários na sincronização do FNO por pacote – Introduza um número inteiro para especificar o número máximo de diários de ajuste de inventário permitidos por pacote de dados durante a sincronização de regresso com o Supply Chain Management. O valor padrão é 1.

6. Utilize a secção mapeamentos de integração de Fno para controlar como os dados são mapeados da camada empresarial de Visibilidade do Inventário para Supply Chain Management. Use os botões na barra de ferramentas para adicionar, editar ou eliminar 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.

   • Tipo de Transação FnO Alvo – Especifique o tipo de diário de inventário criado em Supply Chain Management. O valor padrão é o diário de ajuste de inventário.

   • Estado da Transação FnO Alvo – Selecione um dos seguintes valores para especificar o estado do diário de inventário criado em Supply Chain Management:

     • Nenhum – O sistema não cria transações em Supply Chain Management.
     • Criado – O sistema cria transações, mas não as publica automaticamente no Supply Chain Management.
     • Lançado – O sistema cria transações e lança financeiramente o diário no Supply Chain Management.

7. Se definir a opção Sincronizar Periodicamente a transação para Fno como Verdadeiro, deve garantir que o seu sistema está configurado para compensar ajustes de inventário e evitar que as quantidades de inventário sejam atualizadas duas vezes. Saiba mais em Contrapartida de ajuste da Visibilidade do Inventário.

Introduza manualmente os ajustes de inventário na aplicação Visualização de Inventário

Use a aplicação Visibilidade de Inventário no Power Apps para inserir manualmente os ajustes de inventário diretamente na camada de negócio Visibilidade de Inventário.

1. Inicia sessão no Power Apps e abre a aplicação Inventory Visibility.

2. No painel de navegação, selecione Consultas e reporte>Transações de Inventário.

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

4. No Criar ajuste de inventário, no FastTab de informação de produto e dimensões , especifique o produto para o qual pretende ajustar o inventário. Se algumas das dimensões do produto que precisa (como cor ou estilo) não estiverem mostradas, selecione Editar dimensões para as adicionar.

5. No FastTab Quantidade do ajuste, selecione a origem dos dados, a medida física e a quantidade do ajuste de inventário. Para atualizar imediatamente os ajustes de inventário na memória cache do serviço de Visibilidade de Inventário a partir da área de preparação, selecione a caixa de seleção Atualização instantânea para o serviço IV.

6. No FastTab de Informação Adicional , 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 venda, delta de contagem de inventário ou transação POS.
   • ID de referência externa – Introduza o ID do documento de origem do sistema externo.
   • Nome do diário do Supply Chain Management – Especifique o diário de ajuste de inventário a utilizar no Supply Chain Management. Se deixar este campo em branco, é usado o nome padrão do diário definido em Supply Chain Management.
   • Preço de custo do item – Especifique o preço de custo do item a criar em Supply Chain Management. Se deixar este campo em branco, o diário criado em Supply Chain Management utiliza o método padrão de cálculo de custos definido em Supply Chain Management para calcular o preço de custo.
   • Data da transação – A data da transação a definir na linha do diário quando esta é criada no Supply Chain Management.

7. Para pré-visualizar como é o seu ajuste de inventário quando é publicado na camada de negócio de Visibilidade de Inventário através da API, selecione Referência do Desenvolvedor. Esta ação mostra o corpo JavaScript Object Notation (JSON) que é enviado para a camada empresarial da Visibilidade do Inventário ao lançar a transação.

8. Na barra de ferramentas, selecione Publicar.

Submeta ajustes de inventário à API de Visibilidade de Inventário

Sistemas externos normalmente submetem ajustes de inventário à camada de negócio de Visibilidade de Inventário através da API de ajuste de inventário. O exemplo seguinte apresenta os detalhes sobre a API e o conteúdo do corpo da mensagem.

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, nas APIs públicas de Visibilidade de Inventário.

Veja as transações de inventário na aplicação Visualização de Inventário

A aplicação Inventory Visibility no Power Apps fornece uma interface onde pode visualizar transações detalhadas e agregadas de inventário.

• As transações detalhadas de inventário incluem todas as transações individuais juntamente com todos os detalhes originais.
• As transações agregadas de inventário combinam linhas que têm valores dimensionais correspondentes (como local, armazém e cor). Algumas informações podem ser omitidas. Em vez de mostrar cada transação individual, a interface mostra totais ou médias sobre as dimensões especificadas. Apenas as transações agregadas sincronizam com a Supply Chain Management.

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

• Granularidade:

  • As transações detalhadas mostram as transações originais individuais de ajuste de inventário e fornecem dados detalhados.
  • As transações agregadas mostram dados resumidos e fornecem uma visão geral a um nível mais elevado.

• Volume de dados:

  • Os conjuntos de dados detalhados das transações são tipicamente maiores porque incluem todas as transações.
  • Os conjuntos de dados agregados de transações são tipicamente mais pequenos porque condensam múltiplas transações semelhantes em registos únicos.

Ver transações detalhadas de inventário

Para visualizar transações detalhadas de inventário, siga estes passos:

1. Inicia sessão no Power Apps e abre a aplicação Inventory Visibility.

2. No painel de navegação, selecione Consultas e reporte>Transações de Inventário.

3. Na linha onde o campo Tipo está definido como Detalhe, na coluna Ação , selecione Visualizar.

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

   • ID de registo de linha – O identificador globalmente único (GUID) que é gerado automaticamente para cada transação original de ajuste de inventário. Selecione o link para ver mais detalhes sobre a transação.

   • Estado da linha de origem – O estado atual da transação. Os seguintes valores são utilizados:

     • Criado – O ajuste foi criado na camada de negócio Visibilidade de Inventário e está à espera de ser publicado. Este estado é o estado inicial dos registos de ajuste de inventário.
     • IVPosted – O ajuste foi atualizado com êxito na cache de Visibilidade do Inventário a partir da área de teste. Este estatuto é o pré-requisito para a agregação.
     • Agregado – As linhas detalhadas foram agregadas com sucesso com base nos valores de dimensão correspondentes. Este estado é o pré-requisito para a sincronização com Supply Chain Management.

   • ID de linha agregado – Selecione o link para ver detalhes sobre a linha agregada ligada. Depois de as linhas agregadas serem criadas e/ou publicadas com sucesso no Supply Chain Management, o ID do diário e o ID da linha do diário que o Supply Chain Management devolve são adicionados aos detalhes agregados das transações.

Ver transações agregadas de inventário

Para visualizar as transações agregadas de inventário, siga estes passos:

1. Inicia sessão no Power Apps e abre a aplicação Inventory Visibility.

2. No painel de navegação, selecione Consultas e reporte>Transações de Inventário.

3. Na linha onde o campo Tipo está definido como Agregado, na coluna Ação , selecione Visualizar.

   Na página Transação agregada, é apresentada uma grelha com os detalhes de cada transação agregada bem-sucedida. A maioria das colunas é autoexplicativa, mas aqui ficam algumas colunas importantes a notar:

   • ID do registo de linha – O GUID que é gerado automaticamente para cada transação agregada de ajuste de inventário. Selecione o link para ver mais detalhes sobre a transação agregada. Depois de as linhas agregadas serem criadas e/ou publicadas com sucesso no Supply Chain Management, o ID do diário e o ID da linha do diário que o Supply Chain Management devolve estão incluídas nos detalhes agregados das transações.

   • Estado agregado da linha – O estado atual da transação agregada. Os seguintes valores são utilizados:

     • Criado – O registo agregado da transação foi criado com sucesso. Este estado é o estado inicial do registo agregado da transação.
     • DoNotSync – A linha não está sincronizada com Supply Chain Management. Este estado ocorre tipicamente porque a quantidade de variação de inventário da linha agregada é 0 (zero). (Como a quantidade do inventário não foi alterada, não há necessidade de a sincronizar.)
     • FnOSyncEnqueued – Inventory Visibility enviou uma solicitação para sincronizar a linha com Supply Chain Management. Este estado indica que o registo foi sincronizado em Supply Chain Management e está à espera de processamento adicional.
     • FnOTransCreated – Supply Chain Management processou com sucesso o pedido 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 em Supply Chain Management. Use o ID da mensagem para verificar o erro. Vá a Supply Chain Management>Área de trabalho de administração do sistema>Gestão de Dados IT>Trabalhos recorrentes de dados.
     • FnOTransPosted – O diário de inventário foi publicado com sucesso.
     • FnOTransPostError – Falha na publicação do diário de inventário.

Detalhes da transação de exportação

Para exportar detalhes das transações, deve aceder a eles a partir da entidade Dataverse e exportá-los a partir daí. Os nomes das entidades são Linha de Ajuste e Linha de Ajuste Agregada.

Consulte os diários de inventário publicados na Supply Chain Management

Para visualizar as linhas agregadas que são publicadas ou criadas com sucesso em Supply Chain Management, siga estes passos:

1. Inicie sessão no Supply Chain Management.
2. Vá a Gestão de Inventário>Entradas de diário>Itens>Ajuste de inventário.
3. Altere o filtro da coluna Publicado conforme necessário para visualizar diários publicados, diários não publicados ou todos os diários.