Dynamics 365 CommerceComercialización [EN DESUSO]
El conector expone acciones para buscar y examinar información relacionada con el producto, como catálogos, inventario, precio y recomendaciones. El conector se conecta a la unidad de escalado en la nube de comercio (CSU) como contenedor para proporcionar las API comerciales sin encabezado de una manera simplificada y sencilla para que las empresas puedan consumir y compilar fácilmente aplicaciones comerciales.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://support.microsoft.com/ |
| Correo Electrónico | abapi@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| Directiva de privacidad | https://privacy.microsoft.com/en-us/privacystatement |
| Términos complementarios | https://go.microsoft.com/fwlink/?linkid=2105274 |
| Categorías | Comercio; Finanzas |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Dirección URL del servidor minorista | cuerda / cadena | Dirección URL del servidor minorista | Cierto |
| Dirección URL base de medios enriquecidos | cuerda / cadena | Dirección URL que se usará en caso de que el canal no tenga configurado correctamente el perfil o el servidor multimedia. Se espera que esté en forma de "https://.../imageFileData/search?fileName= ". |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Buscar productos (en desuso) [EN DESUSO] |
Búsqueda de productos por palabra clave y categoría (en desuso). |
| Comprobación de estado (en desuso) [EN DESUSO] |
Comprobación de estado del servidor minorista (en desuso). |
| Get Product variant (en desuso) [DEPRECATED] |
Búsqueda de variantes de producto por dimensiones (en desuso). |
| Obtener atributos de producto (en desuso) [EN DESUSO] |
Obtener atributos de un producto (en desuso). |
| Obtener canales (en desuso) [EN DESUSO] |
Obtener canales (en desuso). |
| Obtener categorías (en desuso) [EN DESUSO] |
Obtener categorías (en desuso). |
| Obtener catálogos (en desuso) [EN DESUSO] |
Obtener catálogos (en desuso). |
| Obtener configuración del entorno (en desuso) [EN DESUSO] |
Obtenga la configuración del entorno (en desuso). |
| Obtener inventario de productos (en desuso) [EN DESUSO] |
Obtener inventario de productos en tiendas (en desuso). |
| Obtener productos por identificadores (en desuso) [EN DESUSO] |
Búsqueda de productos por identificadores (en desuso). |
| Obtener productos recomendados (en desuso) [EN DESUSO] |
Colección de recomendaciones de producto dada una colección de identificadores de producto (en desuso). |
| Obtener ubicaciones de imágenes del producto (en desuso) [EN DESUSO] |
Obtener ubicaciones de imagen de un producto (en desuso). |
| Obtener valores de dimensión (en desuso) [EN DESUSO] |
Valores de dimensión con disponibilidad de inventario para un producto en función de los requisitos especificados (en desuso). |
Buscar productos (en desuso) [EN DESUSO]
Búsqueda de productos por palabra clave y categoría (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Keyword
|
Keyword | string |
Texto de búsqueda del producto. |
|
|
Omitir la expansión de variantes
|
SkipVariantExpansion | boolean |
Devuelve variantes en el resultado de búsqueda si se establece en false, true devolverá solo el producto maestro. |
|
|
Id. de categoría
|
CategoryId | integer |
Id. de categoría. |
|
|
Fecha activa
|
ActiveDate | date-time |
Fecha para la que se necesita el precio. |
|
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Product
Comprobación de estado (en desuso) [EN DESUSO]
Comprobación de estado del servidor minorista (en desuso).
Devoluciones
- response
- array of HealthCheckResult
Get Product variant (en desuso) [DEPRECATED]
Búsqueda de variantes de producto por dimensiones (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del producto
|
ProductId | True | integer |
Identificador del producto maestro. |
|
Fecha activa
|
ActiveDate | date-time |
Fecha para la que se necesita el precio. |
|
|
Identificador de tipo
|
TypeId | True | integer |
Identificador de tipo. |
|
Importancia
|
Value | True | string |
Valor de dimensión. |
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
Representa la instancia de Product
- Body
- Product
Obtener atributos de producto (en desuso) [EN DESUSO]
Obtener atributos de un producto (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del producto
|
ProductId | True | integer |
Id. de producto. |
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Attribute
Obtener canales (en desuso) [EN DESUSO]
Obtener categorías (en desuso) [EN DESUSO]
Obtener categorías (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Category
Obtener catálogos (en desuso) [EN DESUSO]
Obtener catálogos (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Catalog
Obtener configuración del entorno (en desuso) [EN DESUSO]
Obtenga la configuración del entorno (en desuso).
Devoluciones
Clase de entidad EnvironmentConfiguration.
Obtener inventario de productos (en desuso) [EN DESUSO]
Obtener inventario de productos en tiendas (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificadores de producto
|
ProductIds | True | array of integer |
Identificadores de producto. |
|
Longitude
|
Longitude | double |
Longitud. Un valor debe estar entre -15069 y 15069 grados, ambos incluidos. |
|
|
Latitude
|
Latitude | double |
Latitud. Un valor debe estar entre -90 y 90 grados, ambos incluidos. |
|
|
Radio
|
Radius | double |
Radio. Un valor debe ser no negativo. |
|
|
Unidad de medida de radio
|
RadiusUnitOfMeasure | string |
Métricas de radio como Millas o Kilómetros. El valor predeterminado se basará en la configuración del canal. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of ProductInventory
Obtener productos por identificadores (en desuso) [EN DESUSO]
Búsqueda de productos por identificadores (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificadores de producto
|
ProductIds | True | array of integer |
Identificadores de producto. |
|
Omitir la expansión de variantes
|
SkipVariantExpansion | boolean |
Devuelve variantes en el resultado de búsqueda si se establece en false, true devolverá solo el producto maestro. |
|
|
Fecha activa
|
ActiveDate | date-time |
Fecha para la que se necesita el precio. |
|
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Product
Obtener productos recomendados (en desuso) [EN DESUSO]
Colección de recomendaciones de producto dada una colección de identificadores de producto (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de cliente
|
CustomerId | string |
Número de cuenta del cliente. |
|
|
Identificadores de producto
|
ProductIds | True | array of integer |
Identificadores de producto usados para recuperar las recomendaciones del producto. |
|
Fecha activa
|
ActiveDate | date-time |
Fecha para la que se necesita el precio. |
|
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Product
Obtener ubicaciones de imágenes del producto (en desuso) [EN DESUSO]
Obtener ubicaciones de imagen de un producto (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del producto
|
ProductId | True | integer |
Id. de producto. |
|
Id. de catálogo
|
CatalogId | integer |
Id. de catálogo para el canal. El valor predeterminado será Cero. |
|
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of string |
Obtener valores de dimensión (en desuso) [EN DESUSO]
Valores de dimensión con disponibilidad de inventario para un producto en función de los requisitos especificados (en desuso).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del producto
|
ProductId | True | integer |
Identificador del producto cuyos valores de dimensión se van a recuperar. |
|
Channel
|
ChannelId | True | integer |
Id. de canal. |
|
Id. de idioma
|
LanguageId | string |
Id. de idioma. De forma predeterminada, será el idioma del canal. |
Devoluciones
- response
- array of Dimension
Definiciones
Catalog
Representa la instancia de Catalog.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | integer |
Identificador. |
|
Nombre
|
Name | string |
Nombre. |
|
Description
|
Description | string |
Descripción. |
|
ImageUrl
|
ImageUrl | string |
Dirección URL de la imagen. |
|
ExpiryDate
|
ExpiryDate | date-time |
Fecha de expiración. |
Categoría
Representa la instancia de categoría
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | integer |
Identificador. |
|
Nombre
|
Name | string |
Nombre. |
|
ImageUrl
|
ImageUrl | string |
Dirección URL de la imagen. |
|
ParentId
|
ParentId | integer |
Identificador de categoría primario. |
EnvironmentConfiguration
Clase de entidad EnvironmentConfiguration.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
EnvironmentId
|
EnvironmentId | string |
Obtiene o establece environmentId. |
|
EnvironmentName
|
EnvironmentName | string |
Obtiene o establece environmentName. |
|
Id del inquilino
|
TenantId | string |
Obtiene o establece tenantId. |
|
ClientAppInsightsInstrumentationKey
|
ClientAppInsightsInstrumentationKey | string |
Obtiene o establece ClientAppInsightsInstrumentationKey. |
|
HardwareStationAppInsightsInstrumentationKey
|
HardwareStationAppInsightsInstrumentationKey | string |
Obtiene o establece hardwareStationAppInsightsInstrumentationKey. |
|
WindowsPhonePosAppInsightsInstrumentationKey
|
WindowsPhonePosAppInsightsInstrumentationKey | string |
Obtiene o establece windowsPhonePosAppInsightsInstrumentationKey. |
|
BaseVersion
|
BaseVersion | string |
Obtiene o establece baseVersion. |
|
ScaleUnit
|
ScaleUnit | ScaleUnitConfiguration |
Clase de entidad ScaleUnitConfiguration. |
|
AADAuthority
|
AADAuthority | string |
Obtiene o establece AADAuthority. |
|
FrameworkName
|
FrameworkName | string |
Obtiene o establece frameworkName. |
ScaleUnitConfiguration
Clase de entidad ScaleUnitConfiguration.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | string |
Obtiene o establece el Id. |
|
Nombre
|
Name | string |
Obtiene o establece el nombre. |
|
Región
|
Region | string |
Obtiene o establece la región. |
Channel
Representa la instancia del canal.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | integer |
Identificador. |
|
Nombre
|
Name | string |
Nombre. |
|
OperatingUnitNumber
|
OperatingUnitNumber | string |
Número de unidad de operación. |
|
DisplayName (Nombre para mostrar)
|
DisplayName | string |
Nombre para mostrar. |
HealthCheckResult
Resultado de HealthCheck
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
Name | string |
Nombre de la comprobación. |
|
Resultado
|
Result | string |
Resultado. |
Atributo
Representa la instancia de atributo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | integer |
Identificador. |
|
Nombre
|
Name | string |
Nombre. |
|
Importancia
|
Value | string |
Valor. |
ProductInventory
Representa la instancia de Inventario de productos.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID de Producto
|
ProductId | integer |
Id. de producto. |
|
TotalAvailableQuantity
|
TotalAvailableQuantity | double |
Cantidad total disponible. |
|
OrgUnitNumber
|
OrgUnitNumber | string |
Identificador de ubicación. |
|
OrgUnitName
|
OrgUnitName | string |
Nombre de ubicación. |
|
Dirección
|
Address | string |
Dirección. |
|
FormattedStoreHours
|
FormattedStoreHours | string |
Horas de almacenamiento con formato. |
|
Distancia
|
Distance | double |
Distancia. |
Producto
Representa la instancia de Product
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id
|
Id | integer |
Identificador de registro. |
|
ItemId
|
ItemId | string |
Identificador del elemento. |
|
Nombre
|
Name | string |
Nombre del producto. |
|
Description
|
Description | string |
Descripción del producto. |
|
PrimaryImageUrl
|
PrimaryImageUrl | string |
Dirección URL de la imagen principal. |
|
Unidad de Medida
|
UnitOfMeasure | string |
Unidad de medida predeterminada configurada para el producto. |
|
Precio
|
Price | double |
El precio. |
|
StrikePrice
|
StrikePrice | double |
El precio de huelga. |
|
MinMaxPrice
|
MinMaxPrice | string |
Intervalo de precios del producto. |
|
Código de Moneda
|
CurrencyCode | string |
El código de moneda. |
|
FormattedPrice
|
FormattedPrice | string |
Precio con formato. |
|
Descuento
|
Discount | double |
Descuento del producto. |
Dimensión
Representa la instancia de Dimensión.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
TypeId (Identificación de tipo)
|
TypeId | integer |
Identificador de tipo. |
|
NombreDeTipo
|
TypeName | string |
Nombre de tipo. |
|
Valores
|
Values | array of DimensionValue |
Colección de valores dimension. |
DimensionValue
Representa la instancia de DimensionValue.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
DimensionId
|
DimensionId | string |
Identificador. |
|
Importancia
|
Value | string |
Valor. |
|
Description
|
Description | string |
Descripción. |
|
ProductIds
|
ProductIds | array of integer |
Colección de identificadores de producto. |