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 https //tiendanube github io/api documentation/intro 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 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 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 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