Uappi
A integração com o Uappi conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 26 parâmetros distribuídos em 4 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: E-commerce.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
Erros mais comuns
Referência rápida
O que é a integração Uappi?
É a conexão entre o canal Uappi e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é E-commerce), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Uappi.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Uappi e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Token | Senha | Token de acesso à integração |
| Pass | Senha | Pass de acesso à integração |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
| Url da plataforma | Texto | Endereço Url utilizado para acessar o site |
Integração de Vendas
12 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Lista de status para importar pedido | Texto | Informar os status que deve baixar pedidos. Informar separado por | . Exemplo: 1| 3, etc... Caso não esteja preenchido serão importados pedidos no status "Pago" |
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Detalhar forma de pagamento | Sim/Não | Importar o detalhe da forma de pagamento utilizado pelo cliente, como cartão de crédito, boleto e etc. Exige realizar o DE/PARA de todas as formas |
| Data inicial para importação de pedidos | Data | Seleciona a data inicial da criação do pedido no canal para importar. Se não informar, sempre será importado pedidos dos últimos 14 dias |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Enviar dados NF quando for declaração conteúdo | Sim/Não | Enviar nota fiscal fícticia no caso do pedido ter declaração de conteúdo |
| Excluir valor de voucher do pedido | Sim/Não | Ative se quiser excluir o valor do voucher do total do pedido |
| Excluir valor de cupon do pedido | Sim/Não | Ative se quiser excluir o valor do cupom do total do pedido |
| Margem mínima desejável | % | Percentual mínimo de margem de contribuição para os pedidos desta integração. Quando a margem do pedido fica abaixo do valor configurado, o pedido é enviado para aprovação de margem em vez de seguir o fluxo automático. |
| Checar taxa/imposto efetivo do pedido | Sim/Não | Ao ativar, o sistema valida a margem de contribuição no fechamento do pedido. Exige que a Margem mínima desejável (ou a taxa efetiva) esteja preenchida. |
Integração de Produtos
9 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar categoria | Sim/Não | Ative se quiser enviar a atualização de categoria na integração |
| Atualizar marca | Sim/Não | Ative se quiser enviar atualização de marca na integração |
| Baixar cadastro produto | Sim/Não | Ative se quiser baixar o cadastro do produto na integração |
| Incluir código de barras nas palavras substitutas | Sim/Não | Ative se quiser incluir código de barras nas palavras substitutas |
Configurações Gerais
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Url para cotação de frete | Cópia | URL para enviar ao canal de vendas para cotação de frete com as regras e tabelas na idworks |
"O campo 'descricaoCurta' deve ter no máximo 250 caracteres"
Mensagem "O campo 'descricaoCurta' deve ter no máximo 250 caracteres", vista ao atualizar produto ou preço no Uappi. A plataforma limita a descrição curta do produto a 250 caracteres, e o texto enviado pelo idworks passou desse limite. O Uappi recusa a atualização inteira (o resto da chamada — preço, estoque, imagem — também não vai) até a descrição ser encurtada.
A descrição curta sai do cadastro do produto no idworks: o campo costuma se chamar Descrição curta, Descrição resumida ou Resumo, dependendo do layout da tela. Não confunda com a Descrição longa (que pode ter milhares de caracteres) — o limite de 250 vale só para a versão curta.
Como resolver:
- Em Produtos → Listar Produtos → editar o produto → aba Descrições, localize o campo Descrição curta.
- Reescreva o texto ficando dentro de 250 caracteres (espaços e pontuação contam). Use frases objetivas com os atributos essenciais do produto — material, função, indicação. A versão longa fica em Descrição completa.
- Salve o produto e refaça a sincronização do anúncio.
- Para fazer em massa, exporte o catálogo, ajuste a coluna Descrição curta na planilha e importe de volta — veja Como criar ou atualizar anúncios em massa?.
O Uappi também pode rejeitar atualização de preço ou estoque quando a descrição já passou do limite (mesmo que você só esteja atualizando o número). Por isso o erro costuma aparecer "do nada" — alguém editou a descrição em algum momento e estourou o limite, e desde então toda atualização cai. Encurte a descrição e os outros fluxos voltam.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |