Nuvemshop
Objetivo
O conector Nuvemshop (Tiendanube) permite a integração da plataforma Fluid com lojas virtuais para automação de inventário, gestão de vendas e sincronização de clientes. Ele viabiliza o controle centralizado de operações de e-commerce através de chamadas estruturadas à API oficial.
Doc oficial da API:
Para mais informações, acesse o portal de desenvolvedores do conector:
Configuração da conexão
Como configurar no painel da Fluid
- Acesse Conexões > Nova conexão > Nuvemshop.
- Preencha os campos obrigatórios conforme as credenciais do seu aplicativo no Painel de Parceiros Nuvemshop.
- A URL Modal será utilizada para o fluxo de autorização do lojista.
- Clique em Salvar e utilize o botão Autorizar/Testar para validar o acesso via OAuth2.
Campos da conexão
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ID da Loja | string | Sim | Identificador numérico exclusivo da loja na Tiendanube. |
APP ID | string | Sim | Identificador da aplicação (Client ID) gerado no painel de parceiros. |
Chave Secreta do Cliente | string | Sim | Client Secret da aplicação para autenticação segura. |
URL Modal | string | Não | URL utilizada para redirecionar o usuário ao fluxo de concessão de acesso. |
Métodos de autenticação
O conector utiliza o fluxo OAuth2 (Authorization Code).
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
grant_type | string | Sim | Valor padrão: authorization_code. |
redirect_uri | string | Sim | URL de retorno configurada no console da Fluid. |
Observações de segurança
- A Chave Secreta é tratada como dado sensível e não é exposta em logs de execução.
- O conector está configurado para operar sem refresh token, o que significa que, caso o acesso seja revogado, uma nova autorização manual será necessária.
Requisitos
- App na Nuvemshop: É obrigatório ter um aplicativo criado no Portal de Parceiros Nuvemshop.
- Escopos: O aplicativo deve possuir permissões (scopes) compatíveis com as operações desejadas (ex: read_products, write_orders).
- Endpoint: O conector aponta automaticamente para https://api.tiendanube.com/v1/{store_id}.
Configurando um fluxo
Recurso: Produtos
Operação: Listar Produtos
Recupera uma lista de produtos cadastrados com suporte a filtros.
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
IDs | string | Não | IDs separados por vírgula (máximo 30). |
Busca | string | Não | Termo para busca no nome, tag ou SKU. |
Estoque Máximo | integer | Não | Filtra produtos com estoque menor ou igual ao valor informado. |
Itens por Página | integer | Não | Quantidade de registros (Máx: 200). |
|
Recurso: Pedidos
Operação: Consultar Pedido por ID
Retorna os dados detalhados de uma venda específica.
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ID | integer | Sim | Identificador único do pedido. |
Recurso: Clientes
Operação: Listar Clientes
Busca clientes na base da loja utilizando filtros de identificação.
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
string | Não | Busca exata por endereço de e-mail. | |
Busca | string | Não | Busca por nome ou identificação do cliente. |
Criado a partir de | string | Não | Data inicial no formato ISO 8601. |
Na prática
Cenário: Alerta de Estoque Crítico
- Configuração: Utilizar a operação Listar Produtos com o campo Estoque Máximo definido como 2.
- Resultado: O fluxo identificará todos os produtos com baixo estoque para reposição imediata.
Boas práticas:
- Rate Limit: A API monitora a frequência de chamadas; adicione delays em fluxos de alta volumetria.
- Paginação: Utilize o parâmetro page para percorrer todos os registros em listas grandes.
Conclusão
O conector Nuvemshop é a peça central para automatizar desde o pós-venda até o controle de estoque, garantindo que a loja opere de forma sincronizada com outros sistemas.