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 conector uappi buscar pedido 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 conector uappi dados adicionais do pedido 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