--- title: Uappi slug: uappi docTags: createdAt: 2026-08-27T19:08:08.979Z --- ## Objetivo Este conector permite integrar a plataforma Fluid com lojas hospedadas na **Uappi E-commerce**, viabilizando operações de consulta e gestão de **Pedidos**, **Produtos** e **Clientes** diretamente pela API v3 da plataforma. ## Criando um fluxo 1. Acesse a aba **Fluxos** na plataforma Fluid 2. Clique em **Criar fluxo** 3. Selecione o conector **Uappi E-commerce** como origem ou destino da ação ## Criando conexão A conexão usa **e-mail e senha** de um usuário do painel Uappi. O conector faz login automaticamente e gerencia o token de acesso — você não precisa se preocupar com isso. :::hint{type="success"} **Dica:** crie um usuário exclusivo para a integração, com permissão apenas nos recursos que ela precisa acessar. ::: ### Campos obrigatórios - **Endereço da loja** — escolha uma das duas opções: - **Subdomínio Uappi:** informe apenas o trecho antes de .uappi.store. Exemplo: se você acessa https\://minhaloja.uappi.store, digite minhaloja. - **Domínio próprio:** informe o endereço completo, com https\://. Exemplo: https\://loja.minhaempresa.com.br. - **E-mail do usuário** — e-mail com acesso ao painel da Uappi - **Senha** — senha do usuário acima (entre 8 e 64 caracteres). Se for alterada no painel, a conexão precisará ser atualizada na Fluid. # Recursos e Operações Após criar a conexão, escolha o **recurso** (Pedidos, Produtos ou Clientes) e a **operação** desejada. Algumas operações oferecem dois modos de preenchimento do corpo da requisição: - **Dinâmico** — preencha campos estruturados na interface, sem escrever código. - **Template** — escreva o corpo manualmente em Go Template (para cenários avançados). ## Recurso: Pedidos ### Listar pedidos Retorna uma lista paginada de pedidos com filtros e ordenação. No modo **Dinâmico** você pode configurar: - **Dados adicionais** — blocos de informação extras na resposta (ex.: dados do comprador, itens, pagamentos, endereços, notas fiscais, rastreio, etc.) - **Filtros** — condições combinadas com "E" (AND). Campos como id, paymentStatus, customerEmail, totalValue, entre outros - **Ordenação** — por id, orderStatusId, data de criação ou emissão (asc ou desc) - **Registros por página** e **Página (offset)** — controle de paginação ### Buscar pedido Retorna os dados completos de um único pedido. **Campo obrigatório:** - **ID do pedido** — número interno do pedido na Uappi Também permite selecionar quais blocos de dados adicionais retornar. ### Alterar status em massa Move um ou mais pedidos para outro status. Permite processar até **100 pedidos** por execução. **Corpo (Template):** lista de objetos com orderId, newStatusId e, opcionalmente, retroactiveDate. ### Atualizar dados fiscais Informa os dados da nota fiscal emitida para cada pedido. Até **100 pedidos** por execução. **Corpo (Template):** lista de objetos com orderId e number (obrigatórios); key, serie, url e xml são opcionais. ### Atualizar rastreamento da entrega Informa o código e o link de rastreio de cada pedido. Até **100 pedidos** por execução. **Corpo (Template):** lista de objetos com orderId (obrigatório); trackingCode, trackingUrl e reserveLogisticsCode são opcionais. ## Recurso: Produtos ### Listar produtos Retorna uma lista paginada de produtos com filtros e ordenação avançada. No modo **Dinâmico** você pode configurar: - **Dados adicionais** — ex.: marca, preço, estoque, categorias, variações, mídias, avaliações, entre outros - **Filtros** — campos como id, sku, brandId, active, category, salePrice, stock, etc. - **Ordenação** — por id, price, stock, name, relevance, entre outros - **Metadados** — unidade de dimensões e peso, parâmetros de preço personalizado - **Registros por página** e **Página (offset)** ### Cadastrar produto Cria um novo produto no catálogo. **Corpo (Template) — campos obrigatórios:** sku, name, brandId, basePrice, active e priority. Opcionalmente: tradePolicies. ### Atualizar produto Substitui os dados cadastrais de um produto existente. **Campo obrigatório:** - **ID do produto** — identificador interno na Uappi (não é o SKU) **Corpo (Template):** mesmos campos do cadastro (sku, name, brandId, basePrice, active, priority). ### Atualizar preços em lote Atualiza o preço de vários produtos de uma vez, por política comercial. **Corpo (Template):** lista de objetos com productId, tradePolicyId, type (Value ou PercentageIncrease) e changeValue. Opcionais: comparisonPrice, fixCents, availableForSale. ### Atualizar estoque em lote Ajusta o estoque de vários produtos de uma vez, por armazém. **Corpo (Template):** lista de objetos com productId, storageId, type (entry, out ou balance) e stock. ## Recurso: Clientes ### Listar clientes Retorna uma lista paginada de clientes cadastrados. No modo **Dinâmico** você pode configurar: - **Dados adicionais** — endereços, documentos, preferências de notificação, quantidade e valor de pedidos, último pedido, saldo de pontos, campos adicionais - **Filtros** — campos como id, email, nameCorporateName, isCorporate, active, salesChannelId - **Ordenação** — por id, email, nameCorporateName ou createdAt - **Registros por página** e **Página (offset)** ### Buscar cliente Retorna os dados completos de um único cliente. **Campo obrigatório:** - **ID do cliente** — número interno na Uappi Também permite selecionar quais blocos de dados adicionais retornar. # Na prática Nesta seção vamos montar um fluxo de exemplo: **buscar um pedido** e trazer dados complementares como comprador, pagamentos e logística. ## Exemplo — Buscar um pedido Fluxo com um único passo, cujo objetivo é retornar os dados de um pedido pelo seu ID. ![Conector Uappi - Buscar pedido](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL\&content_type=image%2Fpng\&attachment_token=AOo0EEUMM73mlqWtaWHaFYEJjZ%2B3%2FMUtdVc1%2B3oUdZbCfO%2BArwo1r9Xo1zQK9ECLpXE7kj45OHXq51yyVdGtnJ4GZQ3%2B5jrXHQzoYXuw0HGsdpAnzYmGnwjAADWXpFni%2Fvq7nUmmcUv7x%2FRCnBRgMzbLD1BstsESFQuUFbGfudlnfNCUXvdXQgyKBI3okBN%2FBxXLu0jIg7nyqtFBAUAIEFOVKEi%2BUo0VHltQar1Qus20BoC6dp1F1IdYdrYaZIE1kL%2BiEGmcMmlYFG%2Fsa8LkgCA%2F3xaSL65iy3zzkj0ZILnTudv6zHmFfD9YoYh2o9gQv5Aqd7liYTo0Dlifmasi0T0uYymKHfHxu3pyF6O2U42rNHlpNdvntewFyVJZ4MhP37FBJn1LFdosh4ZG96HD324oVp2Oar9%2BnpFbQh93VDGoUxVlqKaHaY2kfbfykK8q4w0KOB%2Fi1u5e3pTXzT%2BsJ3VnAZu2DJ6liiJEVzcvJnnKbWKgWE9thkM%2BW4EASBDlxVRkAsp6MKpqDPx5dB0dAQztTTefUfLR%2Bl5Gn9haWxLFXu9iFsRYdQYOSC8yHYrRE0F7t7yVgTdhHjsZIFiwe%2B6IoDEoHaRvk1t5GoyaV4vMVvaYwgEQUJ21hfMSJxPIJj8sMApxlfgGDllUtMN51NqX7bfx5u1AxPgf35fNpQ%3D%3D\&allow_caching=true\&sz=w1470-h837-rw\&auditContext=prefetch) 1. Adicione um passo do conector **Uappi E-commerce** ao canvas. 2. Em **Recurso**, selecione **Pedidos**. 3. Em **Operação**, selecione **Buscar pedido**. 4. Em **ID do pedido**, informe o número do pedido que deseja consultar. Você pode digitar um valor fixo (ex.: 1) ou usar uma variável dinâmica do fluxo (ex.: \{\{.input.body.ped}}). 5. Em **Corpo**, selecione **Dinâmico**. 6. Em **Dados adicionais**, clique para configurar e selecione os blocos de informação que deseja receber na resposta. No exemplo abaixo, foram selecionados quatro blocos: - **orderGroup** — dados do agrupador de pedidos - **payments** — informações de pagamento - **customer** — dados do comprador - **shipping** — dados logísticos e rastreio ![Conector Uappi - Dados adicionais do Pedido](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL\&content_type=image%2Fpng\&attachment_token=AOo0EEUblsQU3DDhZsbAzKqMqwWlnvrJcDS4bp6odtTJ7lPpqbsuHqMrC7A%2FlKT3XYDdvO%2FTWzwzR4mApyJ4A%2BF4MtujUkdZhMPidLrglrnq0DKA7L3m28L5XwJXiJquw7jMiE5M6%2FCdf%2FeuoqrEDUjGi8ufwS2xUs1mAljS29AXabwwYiGepxofefQJO9iky0Xb7WupoBuYWHTsVJRZILmbPbBGqnbj3Opg9y%2BjGU6ohLn17VrD5%2FLtsdpFtFzkO1pBaaSeEtsCTQCPjtDqhvfp3921yLAzCMeVn6Z2Y0wBgZROHcoikbtEG6fJk2rk1MFSzPSVHnuMQfKWPnYPm1h%2FgayO00vhSQd2SV9L2AMCaj93xs4Sp0nEfZ7yVcPZlaWILmLvYrfMsa5qPHksO62nbgD5i0doq%2FNwg8cdp1KnBWg8npN41srW6AEL%2FTHhrc%2FLlzq%2F5F53QbVbfvVZoM1UdqJrPzWplCTwwygiPcyeKBVkZG6Xnj20SBrPOb%2FbNKIFi7qj%2FH5xmUw6ZPXxVBPqi6jMK2RPBym26O79zephOFEbp7R1N0rpA7O%2Fdaxoy545EWigdwanEiOz8Bk%2FT9Ege8wgQf%2FuehMtxlJPsK2yLm%2BSaI%2FzZnEoChSwwrTp%2FST%2FX0nobF4yZlQ1BoJtjwHms8PiTyfH8MyqaXAXgg%3D%3D\&allow_caching=true\&sz=w1470-h837-rw\&auditContext=forDisplay) Ao executar, o passo retorna os dados completos do pedido informado, incluindo apenas os blocos selecionados. # Observações adicionais - A autenticação é feita automaticamente: o conector obtém e renova o token de acesso sem intervenção manual. - Operações em lote (status, fiscal e rastreio de pedidos; preços e estoque de produtos) aceitam até **100 registros** por execução. - Ao usar o modo **Template**, o corpo deve seguir a estrutura JSON esperada pela API v3 da Uappi, escrito em Go Template. - Se a senha do usuário for alterada no painel da Uappi, a conexão na Fluid precisará ser atualizada. # Conclusão O conector Uappi E-commerce amplia a integração da plataforma Fluid com lojas virtuais, permitindo gerenciar pedidos, produtos e clientes de forma automatizada e sem necessidade de código.