Uappi
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
- Acesse a aba Fluxos na plataforma Fluid
- Clique em Criar fluxo
- 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.
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.
- Adicione um passo do conector Uappi E-commerce ao canvas.
- Em Recurso, selecione Pedidos.
- Em Operação, selecione Buscar pedido.
- 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}}).
- Em Corpo, selecione Dinâmico.
- 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
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.