# Criar produto

{% tabs %}
{% tab title="Parâmetros" %}

| Descrição                                      | Campo de texto       | Descrição visual do conector na construção do fluxo.                                                                                                                                                          |
| ---------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Conta de Serviço](#user-content-fn-1)[^1]     | Seletor              | Permite selecionar uma conta de serviço do tipo Bearer Token, cadastrada no Workspace Floui, para realizar a conexão e autenticação com o ambiente Adobe Commerce Magento.                                    |
| Tipo do produto                                | Seletor              | <p>Permite selecionar o tipo de produto que será criado. Opções:</p><ul><li>Simple.</li><li>Virtual</li><li>Downloadable.</li><li>Configurable.</li><li>Bundle.</li><li>Grouped.</li><li>Gift Card.</li></ul> |
| ID do grupo de atributos                       | Campo de texto       | Permite selecionar o identificador do conjunto de atributos. O conjunto de atributos está disponível na plataforma Adobe Commerce.                                                                            |
| Status                                         | Seletor              | <p>Define a disponibilidade do produto na plataforma. Opções:</p><ul><li>Habilitado.</li><li>Desabilitado.</li><li>Valor customizado</li></ul>                                                                |
| Valor do status                                | Campo de texto       | <p>Disponível quando o <strong>Status</strong> é um valor personalizado.  </p><p></p><p>Permite definir um valor customizável para status do produto.</p>                                                     |
| Nome do produto                                | Campo de texto       | Define o nome do produto na plataforma Adobe Commerce.                                                                                                                                                        |
| SKU do produto                                 | Campo de texto       | Permite definir um código único para identificação do produto.                                                                                                                                                |
| Preço base                                     | Campo de texto       | Preço base do produto, sem descontos. Não disponível para produtos tipo Grouped e Gift Card.                                                                                                                  |
| Preço especial                                 | Campo de texto       | Preço com desconto do produto. Não disponível para produtos tipo Configurable, Grouped e Gift Card.                                                                                                           |
| Data inicial do preço especial                 | Campo de texto       | Data inicial em que o preço especial estará vigente no produto. Inserir a data em formato “YYYY-MM-DD HH:mm:ss”. Não disponível para produtos tipo Configurable, Grouped e Gift Card.                         |
| Data final do preço especial                   | Campo de texto       | Data final em que o preço especial será encerrado no produto. Inserir a data em formato “YYYY-MM-DD HH:mm:ss”. Não disponível para produtos tipo Configurable, Grouped e Gift Card.                           |
| Quantidade em estoque (estoque simples)        | Campo de texto       | Representa a quantidade de produtos disponíveis para venda.                                                                                                                                                   |
| Status do estoque (estoque simples)            | Seletor              | Indica o estado do estoque de um produto.                                                                                                                                                                     |
| Peso                                           | Campo de texto       | Medida de peso, em kg, do produto. Disponível apenas para produto Simple.                                                                                                                                     |
| Tipo do Gift Card                              | Seletor              | Permite selecionar o tipo do cartão de presente, como Físico, Virtual ou Combinado. Disponível apenas para produtos Gift Card.                                                                                |
| Validade do Giftcard (em dias)                 | Campo de texto       | Quantidade em dias que o cartão presente ficará disponível. Disponível apenas para produtos Gift Card.                                                                                                        |
| Permitir valor aberto                          | Seletor              | Define se o usuário poderá ou não configurar o valor do seu gift card. Disponível apenas para produtos Gift Card.                                                                                             |
| Valor mínimo do Giftcard                       | Campo de texto       | Valor mínimo permitido para o gift card. Disponível apenas para produtos Gift Card e após selecionar a opção Sim em Permitir Valor Aberto.                                                                    |
| Valor máximo do Giftcard                       | Campo de texto       | Valor máximo permitido para o gift card. Disponível apenas para produtos Gift Card e após selecionar a opção Sim em Permitir Valor Aberto.                                                                    |
| Valores do Giftcard                            | Tabela de parâmetros | Permite definir os valores disponíveis para seleção no Gift Card. Disponível apenas para produtos Gift Card.                                                                                                  |
| Permitir mensagem                              | Seletor              | Permite que o usuário possa adicionar uma mensagem no Gift Card. Disponível apenas para produtos Gift Card.                                                                                                   |
| Tipo de preço                                  | Seletor              | Permite escolher se o produto Bundle terá um preço fixo definido no produto pai, ou dinâmico conforme o preço dos produtos associados. Disponível apenas para produto Bundle.                                 |
| Descrição do produto                           | Campo de texto       | Fornece informações detalhadas e descritivas sobre o produto.                                                                                                                                                 |
| Visibilidade                                   | Seletor              | <p>Permite selecionar a visibilidade do produto produto no e-commerce:</p><ul><li>Catálogo e pesquisa.</li><li>Catálogo.</li><li>Busca.</li><li>Não visível individualmente.</li></ul>                        |
| ID da classe de impostos                       | Campo de texto       | Representa o identificador associado à classe de impostos aplicada ao produto.                                                                                                                                |
| Website IDs                                    | Campo de texto       | Refere-se ao identificador do website associado ao produto.                                                                                                                                                   |
| IDs categorias (associação simplificada)       | Campo de texto       | Representa os identificadores das categorias às quais o produto está associado.                                                                                                                               |
| Atributos customizados adicionais              | Tabela de parâmetros | Refere-se a atributos específicos e personalizados do produto além dos atributos padrão. Configurado no formato de Chave e Valor.                                                                             |
| Atributos extensíveis adicionais               | Tabela de parâmetros | Definem informações adicionais e extensíveis associadas ao produto. Configurado no formato de Chave e Valor.                                                                                                  |
| Atributos para configuração do produto (grade) | Tabela de parâmetros | Permite configurar as variações do produto a partir de atributos da loja (por exemplo, opções de Cor e Tamanho). Configurado no formato de Chave e Valor. Disponível apenas para produto Configurable.        |
| Output Path                                    | Campo de texto       | Refere-se ao caminho do resultado da requisição na saída do conector no contexto de execução do fluxo                                                                                                         |
| {% endtab %}                                   |                      |                                                                                                                                                                                                               |

{% tab title="Payload" %}

## Detalhes

O conector Criar produto fornece uma interface simples para a criação de vários tipos de produtos para o e-commerce, via API REST.&#x20;

O conector utiliza o endpoint **POST** `/rest/V1/products`. Para saber mais sobre esta ou outras APIs disponibilizadas para Adobe Commerce Magento, acesse o link [REST endpoints (ReDocly)](https://developer.adobe.com/commerce/webapi/rest/quick-reference/).

#### Sucesso

Ao ocorrer sucesso na requisição, será retornada a carga de dados com todos os dados do produto criado. Segue um exemplo do retorno da execução:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd-itEicij_xIHP7TXtM4TpgjfJ5poymLc4lQaWtQ4KwxxCJMUg-YCgPt7rFokAxbRpsATIt-UNd2XXCpBXr4Yfq0c6rbH86guK-Igi_e2CGGql_nQCz2PkqlaoXuBsCHDm_e-jXA?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Sucesso na criação de produto.</p></figcaption></figure>

## Erros

Visto que o endpoint possui vários atributos de criação de produtos, poderá ocorrer vários cenários de erro. Nestes casos, de preenchimento e validação de atributos, a API irá retornar uma mensagem de acordo com o cenário. Segue exemplo de mensagem de erro da API.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FtamZfTSzTUGsOfgeC8p7%2Fimage.png?alt=media&#x26;token=25149ba8-ebec-4b66-a669-c6b760a920c4" alt=""><figcaption><p>Erro na criação de produto.</p></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: A conta de serviço precisa ser adicionada no painel de configuração do Floui antes de ser selecionada dentro do componente.
