Dynamics 365 Commerce Merchandising [PRETERIDO]
O conector expõe ações para pesquisar e procurar informações relacionadas ao produto, como catálogos, inventário, preço e recomendações. O conector conecta-se à CSU (Commerce Cloud Scale Unit) como um wrapper para fornecer as APIs de comércio sem cabeça de maneira simplificada e fácil para que as empresas possam facilmente consumir e criar aplicativos de Comércio.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://support.microsoft.com/ |
| abapi@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Site | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| Política de privacidade | https://privacy.microsoft.com/en-us/privacystatement |
| Termos complementares | https://go.microsoft.com/fwlink/?linkid=2105274 |
| Categorias | Comércio; Financiar |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URL do Servidor de Varejo | cadeia | URL do Servidor de Varejo | Verdade |
| URL da base de mídia avançada | cadeia | URL a ser usada no caso de o canal não ter configurado corretamente o servidor de perfil/mídia. Espera-se que esteja na forma de "https://.../imageFileData/search?fileName= ". |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Obter atributos de produto (preterido) [PRETERIDO] |
Obter atributos de um produto (preterido). |
| Obter canais (preterido) [PRETERIDO] |
Obter Canais (preterido). |
| Obter categorias (preteridas) [PRETERIDO] |
Obter Categorias (preterido). |
| Obter catálogos (preterido) [PRETERIDO] |
Obter Catálogos (preterido). |
| Obter configuração de ambiente (preterida) [PRETERIDA] |
Obter a Configuração do Ambiente (preterida). |
| Obter inventário de produtos (preterido) [PRETERIDO] |
Obter Inventário de Produtos em lojas (preterido). |
| Obter locais de imagem do Produto (preterido) [PRETERIDO] |
Obter locais de imagem de um Produto (preterido). |
| Obter produtos por IDs (preterido) [PRETERIDO] |
Pesquisa de produto por IDs (preterida). |
| Obter produtos recomendados (preteridos) [PRETERIDO] |
Uma coleção de recomendações de produto fornecida uma coleção de identificadores de produto (preterida). |
| Obter valores de dimensão (preteridos) [PRETERIDO] |
Os valores de Dimensão com disponibilidades de inventário para um produto com base nos requisitos especificados (preteridos). |
| Obter variante do produto (preterido) [PRETERIDO] |
Pesquisa de variante do produto por dimensões (preterida). |
| Produtos de pesquisa (preteridos) [PRETERIDO] |
Pesquisa de Produto por palavra-chave e categoria (preterida). |
| Verificação de integridade (preterida) [PRETERIDA] |
Verificação de integridade do servidor de varejo (preterido). |
Obter atributos de produto (preterido) [PRETERIDO]
Obter atributos de um produto (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Produto
|
ProductId | True | integer |
ID do produto. |
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Attribute
Obter canais (preterido) [PRETERIDO]
Obter categorias (preteridas) [PRETERIDO]
Obter Categorias (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Category
Obter catálogos (preterido) [PRETERIDO]
Obter Catálogos (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Catalog
Obter configuração de ambiente (preterida) [PRETERIDA]
Obter a Configuração do Ambiente (preterida).
Retornos
Classe de entidade EnvironmentConfiguration.
- Corpo
- EnvironmentConfiguration
Obter inventário de produtos (preterido) [PRETERIDO]
Obter Inventário de Produtos em lojas (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
IDs do produto
|
ProductIds | True | array of integer |
IDs do produto. |
|
Longitude
|
Longitude | double |
Longitude. Um valor deve estar entre -15069 e 15.069 graus, inclusive. |
|
|
Latitude
|
Latitude | double |
Latitude. Um valor deve estar entre -90 e 90 graus, inclusive. |
|
|
Raio
|
Radius | double |
Raio. Um valor deve ser não negativo. |
|
|
Unidade radius de medida
|
RadiusUnitOfMeasure | string |
Métricas de raio, como Milhas ou Quilômetros. O padrão será baseado na configuração do canal. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of ProductInventory
Obter locais de imagem do Produto (preterido) [PRETERIDO]
Obter locais de imagem de um Produto (preterido).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Produto
|
ProductId | True | integer |
ID do produto. |
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of string |
Obter produtos por IDs (preterido) [PRETERIDO]
Pesquisa de produto por IDs (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
IDs do produto
|
ProductIds | True | array of integer |
IDs do produto. |
|
Ignorar expansão de variante
|
SkipVariantExpansion | boolean |
Retorna variantes no resultado da pesquisa, se definido como false, true retornará apenas o produto mestre. |
|
|
Data ativa
|
ActiveDate | date-time |
Data para a qual o preço é necessário. |
|
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Product
Obter produtos recomendados (preteridos) [PRETERIDO]
Uma coleção de recomendações de produto fornecida uma coleção de identificadores de produto (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do cliente
|
CustomerId | string |
Número da conta do cliente. |
|
|
IDs do produto
|
ProductIds | True | array of integer |
Identificadores de produto usados para recuperar as recomendações do produto. |
|
Data ativa
|
ActiveDate | date-time |
Data para a qual o preço é necessário. |
|
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Product
Obter valores de dimensão (preteridos) [PRETERIDO]
Os valores de Dimensão com disponibilidades de inventário para um produto com base nos requisitos especificados (preteridos).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Produto
|
ProductId | True | integer |
Identificador do produto cujos valores de dimensão devem ser recuperados. |
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Dimension
Obter variante do produto (preterido) [PRETERIDO]
Pesquisa de variante do produto por dimensões (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do Produto
|
ProductId | True | integer |
Identificador do produto mestre. |
|
Data ativa
|
ActiveDate | date-time |
Data para a qual o preço é necessário. |
|
|
ID do tipo
|
TypeId | True | integer |
Identificador de tipo. |
|
Value
|
Value | True | string |
Valor da dimensão. |
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
Representa a instância do produto
- Corpo
- Product
Produtos de pesquisa (preteridos) [PRETERIDO]
Pesquisa de Produto por palavra-chave e categoria (preterida).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Keyword
|
Keyword | string |
Texto de pesquisa do produto. |
|
|
Ignorar expansão de variante
|
SkipVariantExpansion | boolean |
Retorna variantes no resultado da pesquisa, se definido como false, true retornará apenas o produto mestre. |
|
|
ID da categoria
|
CategoryId | integer |
ID da categoria. |
|
|
Data ativa
|
ActiveDate | date-time |
Data para a qual o preço é necessário. |
|
|
ID do catálogo
|
CatalogId | integer |
ID do catálogo do canal. O padrão será Zero. |
|
|
Channel
|
ChannelId | True | integer |
ID do canal. |
|
ID do idioma
|
LanguageId | string |
ID do idioma. Por padrão, será o idioma do canal. |
Retornos
- response
- array of Product
Verificação de integridade (preterida) [PRETERIDA]
Verificação de integridade do servidor de varejo (preterido).
Retornos
- response
- array of HealthCheckResult
Definições
Catalog
Representa a instância do Catálogo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | integer |
A ID. |
|
Nome
|
Name | string |
O nome. |
|
Description
|
Description | string |
A descrição. |
|
ImageUrl
|
ImageUrl | string |
A URL da imagem. |
|
ExpiryDate
|
ExpiryDate | date-time |
A data de expiração. |
Categoria
Representa a instância de Categoria
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | integer |
A ID. |
|
Nome
|
Name | string |
O nome. |
|
ImageUrl
|
ImageUrl | string |
A URL da imagem. |
|
ParentId
|
ParentId | integer |
A ID da categoria pai. |
EnvironmentConfiguration
Classe de entidade EnvironmentConfiguration.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
EnvironmentId
|
EnvironmentId | string |
Obtém ou define a EnvironmentId. |
|
EnvironmentName
|
EnvironmentName | string |
Obtém ou define o EnvironmentName. |
|
ID do Inquilino (TenantId)
|
TenantId | string |
Obtém ou define a TenantId. |
|
ClientAppInsightsInstrumentationKey
|
ClientAppInsightsInstrumentationKey | string |
Obtém ou define o ClientAppInsightsInstrumentationKey. |
|
HardwareStationAppInsightsInstrumentationKey
|
HardwareStationAppInsightsInstrumentationKey | string |
Obtém ou define o HardwareStationAppInsightsInstrumentationKey. |
|
WindowsPhonePosAppInsightsInstrumentationKey
|
WindowsPhonePosAppInsightsInstrumentationKey | string |
Obtém ou define o WindowsPhonePosAppInsightsInstrumentationKey. |
|
BaseVersion
|
BaseVersion | string |
Obtém ou define o BaseVersion. |
|
ScaleUnit
|
ScaleUnit | ScaleUnitConfiguration |
Classe de entidade ScaleUnitConfiguration. |
|
AADAuthority
|
AADAuthority | string |
Obtém ou define a AADAuthority. |
|
FrameworkName
|
FrameworkName | string |
Obtém ou define o FrameworkName. |
ScaleUnitConfiguration
Classe de entidade ScaleUnitConfiguration.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | string |
Obtém ou define o Id. |
|
Nome
|
Name | string |
Obtém ou define o Nome. |
|
Região
|
Region | string |
Obtém ou define a Região. |
Channel
Representa a instância do Canal
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | integer |
A ID. |
|
Nome
|
Name | string |
O nome. |
|
OperatingUnitNumber
|
OperatingUnitNumber | string |
O número da unidade operacional. |
|
DisplayName
|
DisplayName | string |
O nome a apresentar. |
HealthCheckResult
O resultado do HealthCheck
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
Name | string |
O nome da verificação. |
|
Resultado
|
Result | string |
O resultado. |
Attribute
Representa a instância de atributo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | integer |
A ID. |
|
Nome
|
Name | string |
O nome. |
|
Value
|
Value | string |
O valor. |
ProductInventory
Representa a instância de Inventário de Produtos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do Produto
|
ProductId | integer |
ID do produto. |
|
TotalAvailableQuantity
|
TotalAvailableQuantity | double |
A quantidade total disponível. |
|
OrgUnitNumber
|
OrgUnitNumber | string |
A ID do local. |
|
OrgUnitName
|
OrgUnitName | string |
O nome do local. |
|
Endereço
|
Address | string |
O endereço. |
|
FormattedStoreHours
|
FormattedStoreHours | string |
As horas de repositório formatadas. |
|
Distância
|
Distance | double |
A distância. |
Product
Representa a instância do produto
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
Id | integer |
A ID do registro. |
|
ItemId
|
ItemId | string |
A ID do item. |
|
Nome
|
Name | string |
O nome do produto. |
|
Description
|
Description | string |
A descrição do produto. |
|
PrimaryImageUrl
|
PrimaryImageUrl | string |
A URL da imagem primária. |
|
Unidade de Medida
|
UnitOfMeasure | string |
A unidade padrão de medida configurada para o produto. |
|
Preço
|
Price | double |
O preço. |
|
StrikePrice
|
StrikePrice | double |
O preço de greve. |
|
MinMaxPrice
|
MinMaxPrice | string |
A faixa de preço do produto. |
|
Código de moeda
|
CurrencyCode | string |
O código de moeda. |
|
FormattedPrice
|
FormattedPrice | string |
O preço formatado. |
|
Desconto
|
Discount | double |
O desconto do produto. |
Dimensão
Representa a instância de Dimensão
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
TypeId
|
TypeId | integer |
A ID do tipo. |
|
TypeName
|
TypeName | string |
O nome do tipo. |
|
Valores
|
Values | array of DimensionValue |
A coleção de valores de dimensão. |
DimensionValue
Representa a instância do DimensionValue
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
DimensionId
|
DimensionId | string |
A ID. |
|
Value
|
Value | string |
O valor. |
|
Description
|
Description | string |
A descrição. |
|
ProductIds
|
ProductIds | array of integer |
A coleção de IDs do produto. |