Nesse artigo você vai aprender
Como ativar a integração com o DinaBox, como cada usuário entra com a própria conta, como vincular os produtos do Pontta aos itens do DinaBox e como importar um projeto para um orçamento, pedido de venda ou revisão de pedido. Você também vai ver como o Pontta escolhe o preço e o produto de cada item.
Descrição
O DinaBox é um software de projeto de móveis planejados. O Pontta consulta a API do DinaBox e copia os módulos, peças, chapas, fitas de borda, ferragens e furações do projeto para dentro de um documento que já existe. Não há arquivo para exportar e importar: tudo é feito pela janela de integração.
Diferente de outras integrações, a configuração do DinaBox não tem token. A tela de administração só tem chaves e opções; o login é feito por cada usuário, com a conta dele no DinaBox, na hora de importar.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Ativar a integração
- 2. Vincular os produtos do Pontta ao DinaBox
- 3. Importar produtos do DinaBox (opcional)
- 4. Importar um projeto
- Como o Pontta encontra o produto de cada item
- Preço do DinaBox ou da tabela do Pontta
- Dúvidas frequentes
- Para o time de suporte
Pré-requisitos
- Módulo DinaBox na assinatura. Sem ele, a seção não aparece em Integrações.
- Permissão Integrações para quem vai configurar.
- Uma conta no DinaBox para cada usuário que vai importar projetos.
- Unidade de medida un cadastrada no Pontta, além das unidades usadas pelos componentes do projeto.
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 o DinaBox.
1 - Ligue Ativar integração com DinaBox. As demais opções aparecem em seguida.
2 - Em Origem do custo no DinaBox, escolha de onde vem o custo dos itens: Custo da fábrica (padrão) ou Custo de compra.
3 - Agrupar produtos: junta, dentro de cada módulo, as ferragens e insumos com o mesmo código e o mesmo nome em uma linha só. Vem ligado por padrão.
4 - Precificar projetos DinaBox usando tabela de preço do Pontta: troca o preço do DinaBox pelo preço de uma tabela do Pontta. Veja a seção sobre preço antes de ligar.
5 - Clique aqui para testar integração com o Dinabox abre a janela de importação em modo de teste: ao escolher um projeto, ela mostra os dados brutos que o DinaBox devolveu, sem importar nada.
As chaves são gravadas assim que você clica. A Origem do custo só é gravada pelo botão Salvar, no fim da tela.
Nota: Agrupar produtos não junta itens de módulos diferentes. Duas dobradiças iguais em módulos distintos continuam em linhas separadas, cada uma dentro do seu módulo.
2. Vincular os produtos do Pontta ao DinaBox
O Pontta tenta primeiro achar o produto pelo próprio código. Se o código do produto no Pontta for igual ao código do item no DinaBox, não é preciso fazer nada. Quando os códigos são diferentes, informe o código do DinaBox no cadastro do produto:
Abra o produto e, no menu de três pontos, clique em Integração com terceiros.
1 - Preencha Código no DinaBox.
2 - Nome no DinaBox (opcional): use quando o mesmo código aparece em itens diferentes no DinaBox. O vínculo passa a considerar código e nome juntos.
3 - Manter nome do DinaBox: o item importado fica com o nome que veio do DinaBox, e não com o nome do produto do Pontta.
4 - Clique em Salvar.
Nota: o campo Código de integração, no topo da mesma janela, é do Promob. Ele não vale para o DinaBox. Use sempre Código no DinaBox.
Se o código já estiver em outro produto, aparece a mensagem Esse código de integração com o Dinabox já é usado em outro produto.
Consulte também: Código de terceiros no produto
3. Importar produtos do DinaBox (opcional)
Se o seu catálogo de insumos ainda não está no Pontta, você pode criá-lo a partir do DinaBox. Acesse Administração > Produção > Produtos.
1 - Clique no botão de nuvem, Importar produtos.
2 - Escolha Importar produtos do DinaBox e informe a conta, a senha e o tipo do cadastro (Inputs para insumos; Dinabox ou User para materiais).
Cada produto é criado com o código e o nome do DinaBox, a unidade un e o Código no DinaBox já preenchido. Se o código já existir no Pontta, o produto é pulado com o aviso Produto já existe.
Nota: os produtos importados entram sempre na unidade un. Revise a unidade de chapas (m²) e fitas de borda antes de usar o cadastro em produção.
4. Importar um projeto
Abra o orçamento, o pedido de venda ou a revisão de pedido e entre no ambiente que vai receber os itens. A integração não cria ambientes: os itens entram no ambiente aberto.
1 - Clique no botão + (Adicionar produtos / serviços) e escolha DinaBox - Buscar os projetos do DinaBox. O atalho de teclado é a tecla d.
1 - Na primeira vez, informe Sua conta no DinaBox (o login do DinaBox, não o do Pontta).
2 - Informe a Senha do DinaBox.
3 - Clique em Autenticar no DinaBox.
O Pontta não guarda a senha. O acesso fica salvo no navegador até vencer; para trocar de conta, use Logout conta DinaBox na mesma janela.
Depois do login, a janela lista os projetos da conta:
1 - Em Projeto do DinaBox, digite parte do nome do projeto para filtrar a lista.
2 - Se você ligou a precificação pelo Pontta, escolha a Tabela de preço.
3 - Clique no nome do projeto. A importação começa na hora.
Nota: projetos com tamanho acima de 60 são importados em segundo plano. Aparece Projeto do Dinabox sendo baixado e, ao terminar, Projeto do Dinabox foi importado com sucesso. Se os itens não aparecerem, atualize a lista.
Como o Pontta encontra o produto de cada item
Cada módulo do projeto vira um item de integração com filhos: as peças (com a chapa em m² e as fitas de borda) e as ferragens e insumos. Componentes avulsos e furações entram como itens separados.
Para cada item, o Pontta testa alguns códigos que vêm do DinaBox, nesta ordem, e para no primeiro que encontrar:
- Insumos e ferragens: uref, id com as dimensões, id e ref.
- Chapas: uref, id com a espessura, id e ref.
- Fitas de borda: uref, id com espessura e ABS, id com espessura e id.
- Peças: uref, ref e id.
Para cada código, procura primeiro um produto com esse código no Pontta e depois o Código no DinaBox do cadastro. Quando encontra, o item fica ligado ao produto e a quantidade passa a usar a unidade dele.
Preço do DinaBox ou da tabela do Pontta
Com a precificação pelo Pontta desligada (padrão)
O preço de venda vem do DinaBox e o custo vem da origem escolhida (fábrica ou compra). Item sem produto correspondente entra assim mesmo, com o código, o nome e os preços do DinaBox.
Com Precificar projetos DinaBox usando tabela de preço do Pontta ligado
- A tabela de preço passa a ser obrigatória na janela de importação.
- Cada chapa, fita, ferragem, furação e componente recebe o código, o nome, o custo e o preço do produto na tabela. Módulos e peças somam o preço dos filhos.
- Todo item precisa existir no Pontta: se um único item não tiver produto correspondente, a importação inteira falha com Commodity com código ... não encontrada. Se o produto existe mas não está na tabela, a mensagem é Não encontrei um negociável ... na tabela de preço.
Nota: antes de ligar a precificação pelo Pontta, importe um projeto de teste com a chave desligada e confira quais itens ficaram sem produto vinculado. Eles são os que vão travar a importação depois.
Dúvidas frequentes
A opção DinaBox não aparece no botão +.
A chave Ativar integração com DinaBox está desligada em Administração > Vendas > Integrações.
A lista de projetos vem vazia.
A busca não mostra erro quando o acesso venceu ou falhou: só devolve a lista vazia. Clique em Logout conta DinaBox e entre de novo.
Aparece "Falha de autenticação com DinaBox".
A conta ou a senha do DinaBox estão erradas. O login é o do DinaBox, não o do Pontta.
Aparece "Unidade de medida (...) do item de ... integração não encontrada".
O projeto usa uma unidade que não está cadastrada no Pontta. Cadastre a unidade com o mesmo símbolo e importe de novo. Em peças e insumos filhos, a unidade ausente não gera erro: a quantidade apenas não é carregada.
Digitei o ID do projeto e apertei Enter, mas nada foi importado.
Prefira localizar o projeto pelo nome e clicar nele na lista. A importação pelo ID digitado pode falhar porque não traz o tamanho do projeto.
Na revisão de pedido, um projeto grande nunca termina de importar.
Projetos grandes vão para segundo plano, e na revisão de pedido esse processamento não está concluindo. Importe o projeto no pedido ou no orçamento, ou acione o suporte.