Sincronizar ordens de serviço no Field Service com ordens de venda no Supply Chain Management

Artigo
03/08/2023

Este artigo discute os modelos e as tarefas subjacentes que são usados para sincronizar ordens de trabalho no Dynamics 365 Field Service com ordens de venda no Dynamics 365 Supply Chain Management.

Modelos e tarefas

Os modelos e as tarefas subjacentes a seguir são usados para executar a sincronização de ordens de serviço no Field Service com ordens de venda no Supply Chain Management.

Nomes dos modelos na Integração de dados

O modelo Ordens de serviço para Ordens de venda (Field Service para Supply Chain Management) é usado para executar a sincronização.

Nomes das tarefas no projeto de Integração de dados

WorkOrderHeader
WorkOrderServiceLineEstimate
WorkOrderServiceLineUsed
WorkOrderProductLineEstimate
WorkOrderProductLineUsed

As seguintes tarefas de sincronização são obrigatórias para que a sincronização de cabeçalhos e linhas de ordem de venda possa ocorrer:

Produtos do Field Service (Supply Chain Management para Field Service)
Contas (Sales para Supply Chain Management) – Direto

Conjunto de entidades

Field Service	Gerenciamento da Cadeia de Fornecedores
msdyn_workorders	Cabeçalhos de ordens de venda do Dataverse
msdyn_workorderservices	Linhas de ordens de venda do Dataverse
msdyn_workorderproducts	Linhas de ordens de venda do Dataverse

Fluxo de entidades

As ordens de serviço são criadas no Field Service. Se as ordens de serviço incluem somente produtos mantidos externamente e se o valor de Status da ordem de serviço for diferente de Aberto – Não Agendado e Fechado – Cancelado, as ordens de serviço podem ser sincronizadas com o Supply Chain Management por meio de um projeto de Integração de dados do Microsoft Dataverse. As atualizações nas ordens de serviço serão sincronizadas como ordens de venda no Supply Chain Management. Essas atualizações incluem as informações sobre o tipo e status de origem.

Previsto versus usado

No Field Service, os produtos e serviços nas ordens de trabalho têm os valores Previsto e Usado para quantidades e valores. No entanto, no Supply Chain Management, as ordens de venda não têm o mesmo conceito de valores Previsto e Usado. Para oferecer suporte à alocação de produtos que usa a quantidade prevista na ordem de venda no Supply Chain Management, mas mantém a quantidade usada que deve ser consumida e faturada, dois conjuntos de tarefas sincronizam os produtos e serviços na ordem de serviço. Um conjunto de tarefas é para os valores Previsto e outro conjunto de tarefas é para os valores Usado.

Esse comportamento permite cenários em que os valores previstos são usados para a alocação ou a reserva no Supply Chain Management, enquanto os valores usados são utilizados para o consumo e o faturamento.

Previsto

Para a sincronização das linhas do produto, os valores Previsto serão usados quando o Status da Linha for Previsto, a opção Alocado estiver definida como Sim e o valor Status do Sistema não for Fechado - Lançado.

Para a sincronização das linhas do serviço, os valores Previsto serão usados quando o valor Status da Linha for Previsto e o valor Status do Sistema não for Fechado - Lançado.

Usado

Os valores Usado serão usados para consumo e o faturamento. Nesses casos, os valores Usado serão sincronizados.

A tabela a seguir fornece uma visão geral das várias combinações para linhas de produto.

Status do Sistema (Field Service)	Status da Linha (Field Service)	Alocado (Field Service)	Valor sincronizado (Supply Chain Management)
Aberto - Agendado	Previsto	Sim	Previsto
Aberto - Agendado	Previsto	Não	Usado
Aberto - Agendado	Usado	Sim	Usado
Aberto - Agendado	Usado	Não	Usado
Aberto - Em Andamento	Previsto	Sim	Previsto
Aberto - Em Andamento	Previsto	Não	Usado
Aberto - Em Andamento	Usado	Sim	Usado
Aberto - Em Andamento	Usado	Não	Usado
Aberto - Concluído	Previsto	Sim	Previsto
Aberto - Concluído	Previsto	Não	Usado
Aberto - Concluído	Usado	Sim	Usado
Aberto - Concluído	Usado	Não	Usado
Fechado - Lançado	Previsto	Sim	Usado
Fechado - Lançado	Previsto	Não	Usado
Fechado - Lançado	Usado	Sim	Usado
Fechado - Lançado	Usado	Não	Usado

A tabela a seguir fornece uma visão geral das várias combinações para linhas de serviço.

Status do Sistema (Field Service)	Status da Linha (Field Service)	Valor sincronizado (Supply Chain Management)
Aberto - Agendado	Previsto	Previsto
Aberto - Agendado	Usado	Usado
Aberto - Em Andamento	Previsto	Previsto
Aberto - Em Andamento	Usado	Usado
Aberto - Concluído	Previsto	Previsto
Aberto - Concluído	Usado	Usado
Fechado - Lançado	Previsto	Usado
Fechado - Lançado	Usado	Usado

A sincronização dos valores Previsto versus Usado é gerenciada por meio de dois conjuntos de tarefas para as linhas de produto e as linhas de serviço. Os filtros predefinidos disparam a tarefa correta, e o mapeamento subjacente ajuda a garantir que os valores corretos de Esperado versus Usado sejam sincronizados.

Exemplo

Uma ordem de trabalho é criada e agendada no Field Service.

O valor Status do Sistema é Aberto - Agendado.
- Linha de produtos: Qtd. Prevista = 5ea, Qtd. Usada = 0ea, Status da Linha = Previsto, Alocado = Não
- Linha de serviço: Qtd. Prevista = 2h, Qtd. Usada = 0h, Status da Linha = Previsto
Neste exemplo, o valor Qtd Usada do produto de 0 (zero) e o valor Qtd Prevista do serviço de 2h são sincronizados com o Supply Chain Management.
Os produtos são alocados no Field Service.

O valor Status do Sistema é Aberto - Agendado.
- Linha de produtos: Qtd. Prevista = 5ea, Qtd. Usada = 0ea, Status da Linha = Previsto, Alocado = Sim
- Linha de serviço: Qtd. Prevista = 2h, Qtd. Usada = 0h, Status da Linha = Previsto
Neste exemplo, o valor Qtd. Prevista do produto de 5ea e o valor Qtd. Prevista do serviço de 2h são sincronizados com o Supply Chain Management.
O técnico de serviço comeã a trabalhar na ordem de trabalho e registra o uso de material de 6.

O valor Status do Sistema é Aberto - Em Andamento.
- Linha de produtos: Qtd. Prevista = 5ea, Qtd. Usada = 6ea, Status da Linha = Usado, Alocado = Sim
- Linha de serviço: Qtd. Prevista = 2h, Qtd. Usada = 0h, Status da Linha = Previsto
Neste exemplo, o valor Qtd Usada do produto de 6 e o valor Qtd Prevista do serviço de 2h são sincronizados com o Supply Chain Management.
O técnico de serviço conclui a ordem de trabalho e registra o tempo usado de 1,5 horas.

O valor Status do Sistema é Aberto - Concluído.
- Linha de produtos: Qtd. Prevista = 5ea, Qtd. Usada = 6ea, Status da Linha = Usado, Alocado = Sim
- Linha de serviço: Qtd. Prevista = 2h, Qtd. Usada = 1,5h, Status da Linha = Usado
Neste exemplo, o valor Qtd Usada do produto de 6 e o valor Qtd Usada do serviço de 1,5h são sincronizados com o Supply Chain Management.

Origem e status da ordem de venda

Origem de venda

Para manter o controle das ordens de venda que são originárias de ordens de serviço, você pode criar uma origem de venda em que a opção Atribuição do tipo de origem é definida como Sim e o campo Tipo de origem de venda é definido como Integração de ordem de serviço.

Por padrão, o mapeamento seleciona a origem de venda para o tipo de origem de vendas Integração de ordem de trabalho para todas as ordens de venda criadas da partir de ordens de trabalho. Esse comportamento pode ser útil quando você trabalha com a ordem de venda no Supply Chain Management. Você deve certificar-se de que as ordens de venda que são originárias das ordens de trabalho não sejam sincronizadas de volta com o Field Service como ordens de trabalho.

Para obter detalhes sobre como criar a configuração correta para a origem de venda no Supply Chain Management, consulte a seção "Pré-condições e configuração de mapeamento" deste artigo.

Status

Quando a ordem de venda for originária de uma ordem de trabalho, o campo Status de ordens de trabalho externas será exibido na guia Configuração no cabeçalho da ordem de venda. Esse campo mostra o status do sistema da ordem de serviço no Field Service para ajudar a rastrear o status da ordem de serviço sincronizada de ordens de venda no Supply Chain Management. Esse campo também pode ajudar o usuário a determinar quando a ordem de venda deverá ser enviada ou faturada.

O campo Status de ordens de trabalho externas pode ter os seguintes valores:

Aberto - Agendado
Aberto - Em Andamento
Aberto - Concluído
Fechado - Lançado

Solução Field Service CRM

Para oferecer suporte à integração entre o Field Service e o Supply Chain Management, a funcionalidade adicional da solução Field Service CRM é necessária. A solução inclui as alterações a seguir.

Entidade de ordem de trabalho

O campo Tem Somente Produtos Mantidos Externamente foi adicionado à entidade Ordem de trabalho e é exibido na página. Ele é usado para controlar consistententemente se uma ordem de trabalho consiste inteiramente em produtos mantidos externamente. Uma ordem de serviço consiste inteiramente em produtos mantidos externamente quando todos os produtos relacionados são mantidos no Supply Chain Management. Esse campo ajuda a garantir que os usuários não sincronizem ordens de serviço com produtos desconhecidos.

Entidade do produto da ordem de trabalho

O campo A Ordem Tem Somente Produtos Mantidos Externamente foi adicionado à entidade Produto da Ordem de trabalho e é exibido na página. Ele é usado para controlar consistentemente se o produto da ordem de serviço é mantido no Supply Chain Management. Esse campo ajuda a garantir que os usuários não sincronizem produtos da ordem de serviço desconhecidos para o Supply Chain Management.
O campo Status do Sistema do Cabeçalho foi adicionado à entidade Produto da Ordem de trabalho e é exibido na página. Ele é usado para controlar consistentemente o status do sistema da ordem de serviço e ajuda a garantir a filtragem correta quando os produtos da ordem de serviço são sincronizados com o Supply Chain Management. Quando os filtros são definidos nas tarefas de integração, as informações Status do Sistema do Cabeçalho também serão usadas para determinar se os valores previstos ou usados devem ser sincronizados.
O campo Valor da Unidade Faturada mostra o valor que foi faturado por unidade real usada. O valor é calculado como o valor Valor Total dividido pelo valor Quantidade real . O campo é usado para a integração a sistemas que não oferecem suporte a valores diferentes para a quantidade usada e a quantidade faturada. Esse campo não é exibido na interface de usuário (IU).
O campo Valor do Desconto Faturado é calculado como o valor Valor de desconto mais arredondamento do cálculo do valor Valor da Unidade Faturada . Esse campo é usado para a integração e não é exibido na interface do usuário.
O campo Quantidade Decimal armazena do campo Quantidade como um número decimal. Esse campo é usado para a integração e não é exibido na interface do usuário.
O valor nos campos Usado será redefinido como 0 (zero) se o valor Status da Linha do produto da ordem de trabalho for alterado de Usado para Previsto. Essa alteração ajuda a evitar situações em que uma quantidade usada inserida incorretamente é usada pela sincronização quando o valor Status da Linha é Previsto e a opção Alocado está definida como Não.

Entidade do serviço da ordem de trabalho

O campo A Ordem Tem Somente Produtos Mantidos Externamente foi adicionado à entidade Serviço da Ordem de trabalho e é exibido na página. Ele é usado para controlar consistentemente se o serviço da ordem de serviço é mantido no Supply Chain Management. Esse campo ajuda a garantir que os usuários não sincronizem serviços da ordem de serviço desconhecidos para o Supply Chain Management.
O campo Status do Sistema do Cabeçalho foi adicionado à entidade Serviço da Ordem de trabalho e é exibido na página. Ele é usado para controlar consistentemente o status do sistema da ordem de serviço e ajuda a garantir a filtragem correta quando os serviços da ordem de serviço são sincronizados com o Supply Chain Management. Quando os filtros são definidos nas tarefas de integração, as informações Status do Sistema do Cabeçalho também serão usadas para determinar se os valores previstos ou usados devem ser sincronizados.
O campo Duração em Horas armazena o valor do campo Duração depois que o valor é convertido de minutos em horas. Esse campo é usado para a integração e não é exibido na interface do usuário.
O campo Duração Prevista em Horas armazena o valor do campo Duração Prevista depois que o valor é convertido de minutos em horas. Esse campo é usado para a integração e não é exibido na interface do usuário.
O campo Valor da Unidade Faturada armazena o valor que foi faturado por unidade real usada. O valor é calculado como o valor Valor Total dividido pelo valor Quantidade real . Esse campo é usado para a integração a sistemas que não oferecem suporte a valores diferentes para a quantidade usada e a quantidade faturada. O campo não é exibido na interface de usuário.
O campo Valor do Desconto Faturado é calculado como o valor Valor de desconto mais arredondamento do cálculo do valor Valor da Unidade Faturada . Esse campo é usado para a integração e não é exibido na interface do usuário.
O campo Ordem de Linha Externa é um número negativo calculado da ordem de linha que pode ser usado nos sistemas externos em que as linhas de produtos e serviços da ordem de trabalho sejam combinadas. Esse campo permite que produtos da ordem de trabalho que são inseridos tenham os números de linha positivos e os serviços da ordem de trabalho tenham números de linha negativos. O valor desse campo é calculado como o valor Ordem de Linha multiplicado por -1. Esse campo não é exibido na interface de usuário.
O valor nos campos Usado será redefinido como 0 (zero) se o valor Status da Linha do serviço da ordem de trabalho for alterado de Usado para Previsto por algum motivo. Essa alteração ajuda a evitar situações em que uma quantidade usada inserida incorretamente é usada pela sincronização quando o valor Status da Linha é Previsto e o valor Status do Sistema do Cabeçalho é Fechado - Lançado.

Precondições e configuração de mapeamento

Antes de sincronizar ordens de trabalho, é importante atualizar as configurações a seguir nos sistemas.

Configuração no Field Service

Verifique se a série de números usada para as ordens de serviço no Field Service não se sobrepõe à sequência numérica usada para as ordens de venda no Supply Chain Management. Caso contrário, as ordens de venda existentes podem ser atualizadas incorretamente no Field Service ou no Supply Chain Management.
O campo Criação de Fatura de Ordem de Serviço deve ser definido como Nunca, pois o faturamento será feito no Supply Chain Management. Acesse Field Service>Configurações>Administração>Configurações do Field Service e verifique se o campo Criação de Fatura de Ordem de Trabalho está definido como Nunca.

Configuração no Supply Chain Management

A integração da ordem de trabalho exige que você configure a origem de venda. A origem de venda é usada para diferenciar as ordens de venda no Supply Chain Management criadas com base em ordens de serviço no Field Service. Quando uma ordem de venda tiver uma origem de venda do tipo Integração de ordem de trabalho, o campo Status de ordens de trabalho externas será exibido no cabeçalho da ordem de venda. Além disso, a origem de venda ajuda a garantir que as ordens de venda criadas com base em ordens de serviço no Field Service sejam filtradas durante a sincronização de ordens de venda do Supply Chain Management para o Field Service.

Acesse Vendas e marketing>Configuração>Ordens de venda>Origem de venda.
Selecione Nova para criar uma nova origem de venda.
No campo Origem de venda , insira um nome para a origem de venda, como WorkOrder.
No campo Descrição insira uma descrição, como Ordem de Trabalho do Field Service.
Marque a caixa de seleção Atribuição do tipo de origem .
Defina o campo Tipo de origem de vendas como Integração de ordem de trabalho.
Selecione Salvar.

Configurar em Integração de dados

Verifique se Chave de integração existe para msdyn_workorders

Acesse Integração de dados
Selecione a guia Conjunto de conexão
Selecione o Conjunto de conexão usado para sincronização da Ordem de trabalho
Selecione a guia Chave de integração
Localize msdyn_workorders e verifique se a chave msdyn_name (Número da ordem de trabalho) está adicionada. Se não for exibida, adicione-a clicando em Adicionar chave e clique em Salvar na parte superior da página

Mapeamento de modelo na Integração de dados

As ilustrações a seguir mostram um mapeamento de modelo na Integração de dados.

Ordens de serviço para Ordens de venda (Field Service para Supply Chain Management): WorkOrderHeader

Filtro: (msdyn_systemstatus ne 690970005) e (msdyn_systemstatus ne 690970000) e (msdynce_hasexternallymaintainedproductsonly eq true)

Ordens de serviço para Ordens de venda (Field Service para Supply Chain Management): WorkOrderServiceLineEstimate

Filtro: (msdynce_headersystemstatus ne 690970005) e (msdynce_headersystemstatus ne 690970000) e (msdynce_orderhasexternalmaintainedproductsonly eq true) e (msdyn_linestatus eq 690970000) e (msdynce_headersystemstatus ne 690970004)

Ordens de serviço para Ordens de venda (Field Service para Supply Chain Management): WorkOrderServiceLineUsed

Filtro: (msdynce_headersystemstatus ne 690970005) e (msdynce_headersystemstatus ne 690970000) e (msdynce_orderhasexternalmaintainedproductsonly eq true) e ((msdyn_linestatus eq 690970001) ou (msdynce_headersystemstatus eq 690970004))