Nesse artigo você vai aprender
Como ativar a integração com a Hunter Douglas, onde informar o token de cada unidade de negócio e como trazer um orçamento feito no portal de revendas da Hunter Douglas para um orçamento, pedido de venda ou revisão de pedido no Pontta.
Descrição
A integração com a Hunter Douglas tem uma única função: importar os itens de um orçamento já feito no portal de revendas da Hunter Douglas (persianas, cortinas e similares). O Pontta só lê dados da Hunter Douglas; não envia pedido, não consulta catálogo e não acompanha status.
Cada linha do orçamento da Hunter Douglas vira um item no Pontta, com as medidas e as escolhas do produto (linha, coleção, cor, acionamento, instalação, ambiente) guardadas como variáveis do item.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Ativar a integração
- 2. Informar o token da unidade de negócio
- 3. Importar um orçamento
- O que entra em cada item
- Dúvidas frequentes
- Para o time de suporte
Pré-requisitos
- Módulo Hunter Douglas no plano. Ele precisa estar contratado de forma explícita: a opção Todos os módulos da assinatura não o inclui.
- Permissão Integrações para quem vai configurar.
- Token de autenticação fornecido pela Hunter Douglas para a revenda.
- As unidades de medida usadas nos orçamentos da Hunter Douglas (por exemplo, pcs) cadastradas no Pontta com o mesmo símbolo ou nome.
Não é preciso cadastrar fornecedor nem vincular produtos para importar.
Consulte também: Editar permissões do papel de colaborador
1. Ativar a integração
Acesse Administração > Vendas > Integrações e localize a seção Integração com Hunter Douglas.
1 - Ligue a chave Ativar integração com Hunter Douglas.
2 - Abaixo da chave aparece a tabela Configurações, com as colunas Nome e Unidades de negócio.
A chave é o que mostra a opção Hunter Douglas no botão + dos orçamentos e pedidos.
2. Informar o token da unidade de negócio
O token fica guardado por unidade de negócio. Na tabela Configurações:
1 - Clique em Adicionar. Abre a janela Configuração Hunter Douglas.
2 - Em Nome, dê um nome para a configuração (até 50 caracteres).
3 - Em Unidades de negócio, escolha as unidades que vão usar este token.
4 - Em Token de autenticação, cole o token da Hunter Douglas.
5 - Clique em Salvar.
Nota: uma unidade de negócio só pode estar em uma configuração. Se ela já estiver em outra, aparece Unidade de negócio da configuração em uso.
Nota: a integração só funciona nas unidades que têm configuração. Em uma unidade sem token, a importação mostra Integração Hunter Douglas não ativa, mesmo com a chave ligada.
3. Importar um orçamento
Abra o orçamento, o pedido de venda ou a revisão de pedido. Se quiser que os itens fiquem em um ambiente, entre nele antes.
1 - Clique no botão + (Adicionar produtos / serviços) e escolha Hunter Douglas - Buscar os orçamentos no Hunter Douglas. O atalho de teclado é a tecla h.
2 - Na janela Integração com o Hunter Douglas, informe o Número do orçamento ou ajuste o período em Data início e Data fim. O padrão são os últimos 7 dias, e a busca começa sozinha ao digitar.
3 - A lista mostra o número (#), o Cliente e a Data de cada orçamento.
4 - Clique no número do orçamento para importar. Não há botão Importar.
Enquanto os itens são copiados aparece Importação em andamento, por favor aguarde.
Nota: importar o mesmo orçamento duas vezes adiciona os itens duas vezes. O Pontta não verifica se o orçamento já foi importado.
Nota: a busca usa o token da unidade de negócio em que você está logado; a importação usa a unidade do orçamento ou pedido. Trabalhe na mesma unidade do documento para evitar o erro Orçamento não encontrado.
O que entra em cada item
- Código e nome: o código e a descrição do produto na Hunter Douglas.
- Quantidade: a quantidade do orçamento, na unidade informada pela Hunter Douglas.
- Preço unitário: o preço ao consumidor.
- Custo unitário: o preço Hunter (preço de compra da revenda).
- Variáveis do item: linha, coleção, cor, acionamento, controle, instalação, ambiente, largura, altura e IPI.
Se existir no Pontta um produto com o mesmo código da Hunter Douglas, o item fica ligado a ele. Se não existir, o item entra assim mesmo, com os dados do orçamento.
Nota: o NCM e o IPI do orçamento não vão para os dados fiscais do item. O IPI fica só como variável, e o item usa a tributação configurada no Pontta. Confira a parte fiscal antes de faturar.
Dúvidas frequentes
A seção Hunter Douglas não aparece em Integrações.
O módulo Hunter Douglas não está no plano da assinatura. Lembre que Todos os módulos não o inclui; ele precisa ser adicionado ao plano.
Aparece "Integração Hunter Douglas não ativa", mas a chave está ligada.
Falta o token na unidade de negócio do documento. Na prática, essa mensagem quase sempre significa token ausente. Confira a tabela Configurações e veja se a unidade está incluída.
Aparece "Não foi encontrado unidade de medida com o símbolo ...".
Uma linha do orçamento usa uma unidade que não existe no Pontta, e isso interrompe a importação do orçamento inteiro. Cadastre a unidade com o símbolo indicado na mensagem e importe de novo.
Aparece "Falha ao se comunicar com a Hunter Douglas".
O portal da Hunter Douglas não respondeu ou recusou a chamada. Confira o token e tente de novo em alguns minutos. Se persistir, o detalhe técnico está em Administração > Outros > Logs de integração.
Busquei pelo número, deu erro e a lista continuou com os resultados anteriores.
A lista não é limpa quando a busca por número falha. Confira o número digitado; os resultados que ficaram na tela são da busca anterior.