Nesse artigo você vai aprender
Como ligar a integração com o Pontta V1 (também chamado de Pontta Gestor) e como trazer os itens de um orçamento feito no V1 para um orçamento ou pedido de venda no Pontta.
Descrição
A integração com o Pontta V1 serve para quem ainda faz a engenharia dos projetos no sistema antigo. Ela só traz dados do V1 para o Pontta: não envia pedidos, clientes nem produtos de volta.
Cada item principal do orçamento do V1 entra como um ambiente, com os módulos, materiais e subitens dentro dele. O preço e o custo vêm prontos do V1.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Configurar a integração
- 2. Importar um orçamento do V1
- O que entra em cada item
- Importar arquivo pela engenharia do Pontta Gestor
- Dúvidas frequentes
- Para o time de suporte
Pré-requisitos
- Módulo Integração Pontta V1 no plano (vem incluído em Todos os módulos).
- Permissão Integrações para quem vai configurar.
- O endereço (URL) do Pontta V1 do cliente.
- As unidades de medida usadas no V1 cadastradas no Pontta com o mesmo símbolo.
Consulte também: Editar permissões do papel de colaborador
1. Configurar a integração
Acesse Administração > Vendas > Integrações e localize a seção Integração Pontta v1. Ela tem duas chaves, e as duas precisam ser usadas:
1 - Ligue Ativar integração com Pontta v1 via API. Aparecem os campos URL da v1, Conta na v1 e Senha na v1.
2 - Em URL da v1, informe o endereço do Pontta V1 do cliente. É esse campo que a importação usa.
3 - Ligue Ativar integração com Pontta v1 via banco de dados. É essa chave que faz a opção Pontta v1 aparecer no botão + dos orçamentos e pedidos.
4 - Clique em Salvar, no fim do card.
Nota: apesar dos nomes, a importação de orçamentos usa a URL da parte via API, mas só aparece no menu com a chave via banco de dados ligada. Os campos de banco de dados (Endereço, Usuário e Senha) não são usados na importação; servem apenas para o teste de conexão.
Nota: a chave via API sempre aparece desligada quando você abre a tela, mesmo com a URL gravada. Os dados não se perdem: ligue a chave para ver e conferir os campos.
As chaves são gravadas ao clicar; os campos de texto só são gravados pelo botão Salvar.
2. Importar um orçamento do V1
Abra o orçamento (rascunho) ou a tela de novo pedido de venda.
1 - Clique no botão + (Adicionar produtos / serviços) e escolha Pontta v1 - Buscar os itens de um orçamento do Pontta v1.
2 - Na janela que abre, digite o número da pasta do orçamento no V1. A janela não tem título: só um campo numérico.
3 - Clique em Confirmar.
Aparece a mensagem Importação em andamento, por favor aguarde. Ao terminar, o documento é recarregado com os itens importados.
O que entra em cada item
- Ambientes: cada item principal do orçamento do V1 vira um ambiente, com a descrição, a quantidade, a observação e os atributos do V1.
- Código: o identificador do item no V1 vira o código do item no Pontta.
- Preço e custo: o preço unitário e o custo do V1 são mantidos. O Pontta não recalcula pela tabela de preço nem pela soma dos itens filhos.
- Unidade: o Pontta procura a unidade pelo símbolo que veio do V1. Se não encontrar, usa un, sem aviso.
- Quantidade zero: itens filhos com quantidade zero são descartados.
Nota: confira as unidades depois da primeira importação. Uma chapa em m² que chega como un indica que o símbolo do V1 não bate com o cadastro do Pontta.
Importar arquivo pela engenharia do Pontta Gestor
Existe um segundo modo, em que o Pontta envia um arquivo de projeto ao Pontta Gestor e recebe os itens já com preço. Ele não tem chave na tela: precisa ser habilitado pelo suporte.
Quando habilitado, aparece abaixo dos itens a área Para importar um arquivo utilizando a engenharia do Pontta Gestor. Arraste o arquivo para ela. Esse modo usa a URL da v1, a Conta na v1 e a Senha na v1.
Dúvidas frequentes
A opção Pontta v1 não aparece no botão +.
A chave Ativar integração com Pontta v1 via banco de dados está desligada. Ela é a que libera a opção, mesmo que a importação use a URL da parte via API.
Aparece "URL de integração Pontta Gestor deve preenchida".
A URL da v1 está vazia. Ligue a chave via API, preencha a URL e clique em Salvar.
A importação dá erro e a mensagem não explica o motivo.
Os erros devolvidos pelo V1 não são traduzidos pelo Pontta. Confira se o número da pasta existe no V1 e se a URL está acessível. Se continuar, acione o suporte com o número da pasta.
Preciso preencher Conta na v1 e Senha na v1?
Não para importar orçamentos pelo botão +. Elas só são usadas no modo de importar arquivo pela engenharia do Pontta Gestor.
Para que serve o teste do banco de dados?
O ícone no campo Senha do banco de dados testa a conexão com o banco do V1. Em caso de sucesso, aparece Sucesso; em caso de falha, Falha ao conectar com o Pontta v1, seguido do erro. O Endereço do banco de dados é uma URL de conexão completa, por exemplo jdbc:postgresql://servidor:5432/base.