--- title: Nuvemshop slug: nuvemshop docTags: createdAt: 2026-03-10T20:19:27.369Z --- ## 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:** :::hint{type="info"} Para mais informações, acesse o portal de desenvolvedores do conector: [https://tiendanube.github.io/api-documentation/intro](https://tiendanube.github.io/api-documentation/intro) ::: *** ### Configuração da conexão ### Como configurar no painel da Fluid 1. Acesse **Conexões** > **Nova conexão** > **Nuvemshop**. 2. Preencha os campos obrigatórios conforme as credenciais do seu aplicativo no Painel de Parceiros Nuvemshop. 3. A **URL Modal** será utilizada para o fluxo de autorização do lojista. 4. Clique em **Salvar** e utilize o botão **Autorizar/Testar** para validar o acesso via OAuth2. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/LsP7elLyvjZhOMrhzqYPO_1.png) ### 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](https://www.nuvemshop.com.br/parceiros). - **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. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/c0O3bzzJM25Rs0R-e_McY_image-1.png" size="70" width="1448" height="777" position="center" darkWidth="1448" darkHeight="777" showCaption="false"} ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/vY6wArUQ55q3ZO0IblCew_image.png) | 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. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/IsHrFskLDHA7rcu1L2xQB_image-2.png) ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/ouTEXA4VxVonhIbsn1WTh_image-3.png) | 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. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/nOob85sD8MUekDi6A6fjo_image-4.png) ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/HInk8JAz0UH7qhKOzC7uX_image-5.png" size="70" width="1012" height="695" position="center" darkWidth="1012" darkHeight="695" showCaption="false"} | Campo | Tipo | Obrigatório | Descrição | | ------------------ | ------ | ----------- | ------------------------------------------- | | E-mail | 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.