Publicar, revisar, revertir, retirar, y habilitar los productos (el ciclo de vida de productos)
De forma predeterminada, un registro de producto está en estado Borrador cuando lo crea, y no está disponible para los agentes de ventas. El registro pasa a estar disponible para los agentes de ventas sólo cuando lo publica, lo que cambia el estado del registro a Activo. Para los productos que no están asociados con una familia de productos, es decir, los productos que no tienen un registro de familia de productos primario, puede crearlos directamente en un estado Activo al establecer la columna Organization.CreateProductsWithoutParentInActiveState como 1 (true). De forma predeterminada, esta columna se establece en 0 (false) para una nueva instalación de Dynamcis 365 Sales y en 1 (true) si actualiza desde una versión anterior de Dynamics 365 Sales para garantizar la compatibilidad para las aplicaciones que trabajan con la versión anterior de Dynamics 365 donde los registros de productos se crearon en un estado Activo.
También puede usar la pestaña Ventas en el área de configuración del sistema en Dynamics 365 Sales o Microsoft Dynamics 365 for Outlook para especificar si los productos se crean en un estado Activo. Más información: Administrar configuración del catálogo de productos
Además, puede revisar, revertir, retirar, y activar los registros de productos para mantener su catálogo de productos según los requisitos de su negocio. El siguiente ejemplo muestra las transiciones de estado de un producto cuando realiza varias operaciones en un registro de producto en Dynamics 365 Sales.
Activar\*: la operación de activar es aplicable solo para un determinado tipo de registros de producto. Más información: Activar un registro de producto o de kit
Publique una familia de productos, un producto, o agrupación
Use el mensaje de SetStateRequest para publicar un registro individual de familia de productos, producto, o agrupación. En este caso, el estado del registro de destino cambia de Borrador a Activo. Un registro de producto o agrupación secundario bajo un registro de la familia de productos solo puede publicarse si se publica el registro primario de la familia de productos (en el estado Activo ). No puede publicar varios registros de familia de productos, producto o agrupación al mismo tiempo.
Use el mensaje de PublishProductHierarchyRequest para publicar una jerarquía de familia de productos incluidos los productos y las agrupaciones secundarios. Puede usar este mensaje solo con un registro de familia de productos. El estado del registro de familia de productos de destino y todos los registros secundarios de productos o agrupaciones cambia de Borrador a Activo.
El siguiente código de ejemplo demuestra cómo puede publicar un registro individual de familia de productos, producto, o agrupación.
SetStateRequest publishRequest = new SetStateRequest
{
EntityMoniker = new EntityReference(Product.EntityLogicalName, _productId),
State = new OptionSetValue((int)ProductState.Active),
Status = new OptionSetValue(1)
};
_serviceProxy.Execute(publishRequest);
El siguiente código de ejemplo demuestra cómo puede publicar una familia de productos, incluidos sus registros secundarios.
PublishProductHierarchyRequest publishRequest = new PublishProductHierarchyRequest
{
Target = new EntityReference(Product.EntityLogicalName, _productFamilyId)
};
_serviceProxy.Execute(publishRequest);
Para ver un código de ejemplo completo, consulte Ejemplo: Crear y publicar productos.
Importante
Para los registros de producto o agrupación que no están asociados con una familia de productos, debe publicarlos individualmente después de crearlos o modificarlos para que estén disponibles para los agentes de ventas. Para los registros de producto o agrupación asociados con una familia de productos, use el mensaje PublishProductHierarchyRequest en el registro de familia de productos primario para publicar varios registros de producto o agrupación secundarios, junto con el registro de familia de productos primario, al mismo tiempo.
Además, para los productos que no están asociados con una familia de productos, puede crearlos directamente en un estado Activo al establecer la columna Organization.CreateProductsWithoutParentInActiveState como 1 (true). Además, use la ficha Ventas en el área de configuración del sistema en Dynamics 365 Sales o Microsoft Dynamics 365 for Outlook para especificar si los productos no asociados con familias de productos se crean en un estado activo. Más información: Configurar información del catálogo de productos
Revisar una familia de productos, un producto, o agrupación
Use el mensaje de SetStateRequest para revisar un registro de familia de productos, producto, o agrupación.
Cuando se invoca para un registro de familia de productos, revisa la familia de productos y sus registros secundarios.
Cuando se invocado para un registro de producto o agrupación, revisa el registro individual solo.
El estado del registro de destino cambia de Activo a En revisión.
Después de actualizar las propiedades del producto (columnas), el registro de destino debe publicarse para que los cambios se reflejen. Al publicarse, el estado del registro de destino cambia de En revisión a Activo.
Nota
Cuando revisa un producto y cambia las propiedades, Dynamics 365 Sales internamente crea una nueva versión del producto y copia los detalles del producto desde el producto existente hasta la versión más reciente. La nueva versión del producto tiene todos los detalles incluidas listas de precios, relaciones de productos, y propiedades. Las oportunidades creadas con la versión anterior del producto pueden seguir haciendo referencia a la versión anterior del producto. Las oportunidades que se crean una vez se revisa o se retira el producto harán referencia a la versión actual (más reciente) del producto.
Revertir una familia de productos, un producto, o agrupación
Use el mensaje de RevertProductRequest para revertir un registro de familia de productos, un producto, o agrupación a su último estado Activo. Se perderán todos los cambios de propiedad del producto (columna) realizados en el registro desde que se publicó por última vez (Activo ).
Cuando se invoca para un registro de familia de productos, revierte la familia de productos y sus registros secundarios a su último estado Activo, y se perderán todos los cambios realizados en las propiedades del producto de los registros desde que se publicaron por última vez.
Cuando se invoca para un registro de producto o agrupación, revierte el registro individual del producto y o agrupación a su último estado Activo, y se perderán todos los cambios realizados en las propiedades del producto del registro desde que se publicó por última vez.
El estado del registro de destino cambia de En revisión a Activo.
El siguiente código de ejemplo demuestra cómo revertir un registro de producto.
RevertProductRequest revertReq = new RevertProductRequest
{
Target = new EntityReference(Product.EntityLogicalName, _productId)
};
RevertProductResponse reverted = (RevertProductResponse)_serviceProxy.Execute(revertReq);
Retirar una familia de productos, un producto, o agrupación
Use el mensaje de SetStateRequest para retirar un registro de familia de productos, producto, o agrupación.
Cuando se invoca para un registro de familia de productos, retira toda la jerarquía de familia de productos.
Cuando se invocado para un registro de producto o agrupación, retira el registro individual solo.
El estado del registro de destino cambia a Retirado.
Nota
No se puede retirar un producto que forma parte de una agrupación publicada (Activa). Además, no se puede agregar un producto retirado a una agrupación ni se puede agregar un producto a una agrupación retirada.
Activar un registro de producto o de kit
Use el mensaje de SetStateRequest para activar solo los siguientes tipos de registros:
Un registro de producto retirado que no tiene un registro primario.
Un registro de kit retirado.
El estado del registro de destino cambia de Retirado a Activo.
Nota
No puede activar una familia de producto retirada ni un registro de agrupación retirado.
Información relacionada
Administrar precios de productos
Crear y administrar familias de productos, productos y agrupaciones
Tablas del catálogo de productos