Publicar, revisar, reverter, aposentar e ativar produtos (ciclo de vida do produto)

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Por padrão, um registro de produto está no estado Rascunho ao criar e não está disponível para os agentes de vendas. O registro será disponibilizado para os agentes de vendas somente ao publicá-lo, o que altera o estado do registro para Ativo. Para produtos que não estão associados com a família de produtos, ou seja, produtos que não tem um registro primário da família de produtos, você poderá optar por criá-los diretamente em um estado Ativo definindo o atributo Organization.CreateProductsWithoutParentInActiveState para 1 (verdadeiro). Por padrão, este atributo é definido como 0 (false) para a instalação nova do Microsoft Dynamics 365 e para 1 (true) se você estiver atualizando de uma versão anterior do Dynamics 365 para garantir a compatibilidade de seus aplicativos trabalhando com a versão anterior do Dynamics 365 onde os registros do produto foram criados em um estado Ativo.

Você também pode usar a guia Vendas na área configurações do sistema no Microsoft Dynamics 365 ou Microsoft Dynamics CRM para Outlook para especificar se os produtos são criados em um estado ativo.Para obter mais informações:TechNet: Gerenciar a configuração do catálogo de produtos

Além disso, você pode revisar, reverter, desativar e ativar seus registros de produtos para manter seu catálogo de produtos conforme suas necessidades comerciais. A seguinte ilustração mostra as transações de estado de um produto ao executar várias operações em um registro de produto no Dynamics 365.

Transações de ciclo de vida e status do produto

Ativar*: A operação ativar é aplicável apenas para determinados tipos de registro de produto.Para obter mais informações:Ativar um produto ou registro de kit

Neste tópico

Publicar uma família de produtos, um produto ou um pacote

Revise uma família de produtos, um produto ou um pacote

Inverter uma família de produtos, um produto ou um pacote

Aposente uma família de produtos, um produto ou um pacote

Ativar um produto ou registro de kit

Publicar uma família de produtos, um produto ou um pacote

Use a mensagem SetStateRequest para publicar uma família de produtos, um produto ou um registro do grupo. Nesse caso, o estado do registro de destino muda de Rascunho para Ativo. Um produto secundário ou registro de pacote em um registro de família de produtos pode ser publicado somente se o registro primário da família de produtos for publicado (no estado Ativo). Não é possível publicar a família de múltiplos produtos, registros do produto ou do pacote de uma vez.

Use a mensagem PublishProductHierarchyRequest para publicar uma hierarquia da família de produtos incluindo segundos secundários e grupos. Você pode usar esta mensagem apenas um registro da família de produtos. O estado do registro da família de produtos de destino e todos os registros de grupo ou produto secundário altera de Rascunho para Ativo.

A amostra de código a seguir demonstra como você pode publicar uma família de produtos individual, um produto ou um registro do grupo.

SetStateRequest publishRequest = new SetStateRequest
{
   EntityMoniker = new EntityReference(Product.EntityLogicalName, _productId),
   State = new OptionSetValue((int)ProductState.Active),
   Status = new OptionSetValue(1)
};            
_serviceProxy.Execute(publishRequest);

A amostra de código a seguir demonstra como você pode publicar uma família de produtos, incluindo registros secundários.

PublishProductHierarchyRequest publishRequest = new PublishProductHierarchyRequest
{
   Target = new EntityReference(Product.EntityLogicalName, _productFamilyId)
};
_serviceProxy.Execute(publishRequest);

Para o código de exemplo completo, consulte Exemplo: Criar e publicar produtos.

Importante

Para os registros de produtos ou de pacotes que não estão associados à família de produtos, publique-os individualmente após criá-los e editá-los para torná-los disponíveis para os agentes de vendas. Para os registros de produtos ou de pacotes associados à família de produtos, use a mensagem PublishProductHierarchyRequest no registro da família de produtos principal para publicar vários registros de produtos ou de pacotes secundários, juntamente com o registro da família de produtos principal de uma vez.

Além disso, para produtos que não estão associados à família de produtos, você pode escolher criá-los diretamente em um estado Ativo definindo o atributo Organization.CreateProductsWithoutParentInActiveState para 1 (verdadeiro). De outra forma, você também pode usar a guia Vendas na área de configurações do sistema no Microsoft Dynamics 365 ou no Microsoft Dynamics CRM para Outlook para especificar se os produtos não foram criados em um estado ativo.Para obter mais informações:Configurar informações do catálogo de produtos

Revise uma família de produtos, um produto ou um pacote

Use a mensagem SetStateRequest para revisar uma família de produtos, um produto ou um registro do grupo.

  • Quando invocado para um registro da família de produtos, revisa a família de produtos e seus registros secundários.

  • Quando invocado por um produto ou um registro do pacote, revisa apenas o registro individual.

O estado do registro de destino muda de Ativo para Sob Revisão.

Depois que as propriedades do produto (atributos) são atualizadas, o registro de destino deve ser publicado para que reflitam as alterações. Na publicação, o estado do registro de destino muda de Sob Revisão para Ativo.

Observação

Quando você revisa um produto e altera as propriedades, o Dynamics 365cria internamente uma nova versão do produto e copia os detalhes do produto do produto existente para a versão mais recente. A nova versão do produto contém todos os detalhes incluindo listas de preços, relações de produto e propriedades. As oportunidades criadas com a versão anterior do produto podem continuar a fazer referência à versão anterior do produto. As oportunidades que são criadas depois que o produto é revisado ou aposentado farão referência à versão mais atual do produto (nova).

Você pode adicionar ou alterar as propriedades do produto usando apenas Microsoft Dynamics 365 ou Microsoft Dynamics CRM para Outlook; isso não tem suporte de forma programática. Para obter mais informações sobre como criar e gerenciar propriedades do produto, consulte Ajuda e Treinamento: Use propriedades para descrever um produto.

Inverter uma família de produtos, um produto ou um pacote

Use a mensagem RevertProductRequest para reverter a família de produtos, produto ou registro do grupo para seu último estado de Ativo. Todas as alterações de propriedades do produto (atributos) feitas no registro desde que ele foi publicado (estado Ativo) pela última vez serão perdidos.

  • Quando invocado para um registro da família de produtos, reverte a família de produtos e seus registros secundários para o estado Ativo mais recente e todas as alterações feitas nas propriedades do produto dos registros desde que foram publicadas serão perdidos.

  • Quando invocoado para um produto ou registro de grupo, reverte o produto individual ou o registro de grupo para seu estado Ativo mais recente e todas as alterações feitas nas propriedades do produto do registro desde que foi publicado serão perdidos.

O estado do registro de destino muda de Sob Revisão para Ativo.

O código de amostra a seguir demonstra como reverter um registro de produtos.

RevertProductRequest revertReq = new RevertProductRequest
{
   Target = new EntityReference(Product.EntityLogicalName, _productId)
};
RevertProductResponse reverted = (RevertProductResponse)_serviceProxy.Execute(revertReq);

Aposente uma família de produtos, um produto ou um pacote

Use a mensagem SetStateRequest para aposentar uma família de produtos, um produto ou um registro do grupo.

  • Quando invocado para um registro da família de produtos, aposenta toda a hierarquia da família de produtos.

  • Quando invocado por um produto ou um registro do pacote, aposenta apenas o registro individual.

O estado do registro de destino muda para Aposentado.

Observação

Você não pode aposentar um produto que faz parte de um grupo publicado (Ativo). Além disso, você não pode adicionar um produto aposentado a um pacote ou não pode adicionar um produto a um pacote aposentado.

Ativar um produto ou registro de kit

Use a mensagem SetStateRequest para habilitar apenas os seguintes tipos de registro:

  • Um registro do produto desativado que não tenha um registro primário.

  • Um registro do kit desativado.

O estado do registro de destino muda de Aposentado para Ativo.

Observação

Você não pode ativar uma família de produtos aposentada ou registro de pacote aposentado.

Confira Também

Métodos de precificação do produto
Criar e gerenciar famílias de produtos, produtos e pacotes
Entidades do catálogo de produtos

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais