Nesse artigo você vai aprender
Como ativar a integração com o Gabster, onde colocar o token, o que cada opção da configuração muda na importação e como trazer os itens de um pedido de fábrica ou de um orçamento do Gabster para dentro de um orçamento, pedido de venda ou revisão de pedido no Pontta.
Descrição
O Gabster é um software de projeto de móveis. A integração com o Pontta funciona em um sentido só: o Pontta consulta o Gabster e copia os itens do projeto para um documento que já existe. Nada é enviado de volta ao Gabster, e o Pontta não sincroniza estoque nem preço.
Para não haver surpresa, vale saber o que a integração não faz:
- Não cria orçamento nem pedido: a importação entra em um orçamento, pedido ou revisão que você já abriu.
- Não cadastra produto nem serviço: item do Gabster sem produto correspondente entra com o código, o nome e o preço que vieram do Gabster.
- Não evita duplicidade: importar o mesmo projeto duas vezes adiciona os itens duas vezes.
Sumário
Utilize os links abaixo para ir diretamente à seção desejada:
- Pré-requisitos
- 1. Ativar a integração e informar o token
- 2. O que cada opção da configuração faz
- 3. Vincular produtos do Pontta ao Gabster (opcional)
- 4. Importar um projeto do Gabster
- Como o preço e o código de cada item são definidos
- Dúvidas frequentes
- Para o time de suporte
Pré-requisitos
- Módulo Gabster na assinatura. Sem ele, a seção do Gabster não aparece em Integrações.
- Permissão Integrações no papel do colaborador que vai configurar.
- Token de API (API Key) fornecido pelo Gabster para a sua loja ou fábrica.
- Um orçamento, pedido de venda ou revisão de pedido aberto para receber os itens.
Consulte também: Editar permissões do papel de colaborador
1. Ativar a integração e informar o token
Acesse Administração > Vendas > Integrações e role até a seção Gabster.
1 - Ligue a chave Ativar integração com o Gabster.
2 - Em Versão, escolha V2. A V1 é a API antiga do Gabster e só deve ser usada se o Gabster orientar.
3 - Em Ambiente, deixe Produção. Homologação é o ambiente de testes do Gabster e só traz projetos criados lá.
4 - Cole o token em Token Gabster (API Key).
Depois, clique em Salvar, no fim da tela.
Nota: as chaves liga/desliga são gravadas na hora, assim que você clica. Versão, Ambiente e o token só são gravados pelo botão Salvar. Se você sair da tela sem salvar, o token se perde.
Nota: o token da V1 e o da V2 ficam guardados em lugares diferentes, apesar de o campo ter o mesmo nome nas duas versões. Ao trocar a versão, informe o token de novo.
2. O que cada opção da configuração faz
As opções abaixo mudam como os itens chegam ao Pontta. Algumas só valem em uma versão ou em um tipo de documento do Gabster, e a tela não avisa isso.
Opções da V2 (valem só para Pedido fábrica)
- Realizar explosão dos itens: quebra cada item nos recursos que o compõem (chapas, ferragens, acessórios), que entram como itens filhos.
- Utilizar identificador de preço como código de recurso: usa o identificador de preço do recurso no Gabster como código do item. Ligue se os produtos do Pontta foram cadastrados com esse identificador.
- Utilizar quantidade de recurso com quebra: usa a quantidade com perda de corte (quebra) calculada pelo Gabster, quando ela existir.
- Carregar referência externa dos recursos: usa a referência externa do recurso como código do item.
Nota: as três últimas opções não afetam a importação de Orçamento cliente. Elas só mudam os itens de um Pedido fábrica.
Opções que valem para as duas versões
- Fator multiplicador: multiplica o preço de cada item importado. O fator da unidade de negócio vale mais que o fator geral. Fator 0 é tratado como 1.
- Precificar projetos Gabster usando tabela de preço do Pontta: faz a janela de importação pedir uma tabela de preço e troca o preço do Gabster pelo preço do Pontta (veja a seção sobre preço).
- Precificar projetos Gabster pela matéria prima: só tem efeito na V1, e mesmo lá não vale para Pedido fábrica. Na V2, ligar ou desligar não muda nada.
- Limpar cache Gabster: apaga as consultas guardadas. O Pontta guarda o resultado das buscas por 30 minutos (V2) ou 1 hora (V1); use o botão quando alterou o projeto no Gabster e a mudança ainda não apareceu.
3. Vincular produtos do Pontta ao Gabster (opcional)
Este passo só é necessário se você ligou Precificar projetos Gabster usando tabela de preço do Pontta. Sem essa opção, os itens entram com os dados do Gabster e nenhum cadastro é exigido.
O Pontta procura o produto primeiro pelo código: se o código do produto no Pontta for igual ao código do item no Gabster, o vínculo é automático. Quando os códigos são diferentes, informe o código do Gabster 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 Gabster com o código do item no projeto do Gabster.
2 - Clique em Salvar.
Nota: o mesmo Código no Gabster não pode ser usado em dois produtos.
Consulte também: Código de terceiros no produto
4. Importar um projeto do Gabster
Abra o orçamento, o pedido de venda ou a revisão de pedido. Se quiser que os itens fiquem dentro de um ambiente (Cozinha, Quarto...), entre no ambiente antes de importar.
1 - Clique no botão + (Adicionar produtos / serviços) e escolha Gabster - Buscar os projetos no Gabster. O atalho de teclado é a tecla g.
1 - No primeiro campo, escolha o tipo de documento do Gabster: Pedido fábrica ou Orçamento cliente (na V1 também existe Pedido cliente).
2 - No segundo campo, escolha se a busca é Por código ou Por projeto.
3 - Digite o código ou o nome do projeto em Pesquisar.
A lista de resultados mostra as colunas #, Cod. projeto, Descrição e Valor. Clique no número da linha (coluna #) do projeto que quer importar. Não há botão Importar: o clique no número já importa.
Enquanto os itens são copiados aparece a mensagem Importação em andamento, por favor aguarde. Ao terminar, os itens aparecem no documento com o selo de integração.
Nota: os dois campos do topo da janela aparecem com o mesmo rótulo, Tipo de busca. O primeiro é o tipo de documento do Gabster; o segundo é a forma de busca.
Como o preço e o código de cada item são definidos
Sem tabela de preço do Pontta
O preço é o do Gabster multiplicado pelo fator. No Pedido fábrica da V2, o preço unitário é o Valor final Loja dividido pela quantidade, e o custo é o Valor Fábrica dividido pela quantidade.
Com tabela de preço do Pontta
A janela pede a tabela de preço e, para cada item, o Pontta:
1 - Procura um produto com o mesmo código do item no Gabster que esteja na tabela escolhida.
2 - Se não acha, procura pelo Código no Gabster do cadastro do produto.
3 - Se acha, troca código, nome, preço e custo pelos dados do Pontta.
4 - Se não acha, mantém o preço do Gabster, mas sem aplicar o fator.
Nota: com tabela de preço, um item do Gabster sem código faz a importação inteira falhar. Corrija o item no Gabster e importe de novo.
Roteiros e composições
- Roteiros do Gabster viram itens filhos do tipo serviço. Se existir no Pontta um serviço com o mesmo código, ele é usado; senão o item entra com o código e o nome do roteiro.
- Composições viram um item com quantidade 1 cujo preço é a soma dos itens filhos.
Dúvidas frequentes
A opção Gabster não aparece no botão +. Por quê?
A chave Ativar integração com o Gabster está desligada. Ela é o que mostra a opção no menu de adicionar itens.
Aparece "Gabster autenticação não foi configurada". O que falta?
O token da versão escolhida está vazio. Confira se o token foi colado no campo da versão em uso (V1 e V2 têm tokens separados) e se você clicou em Salvar.
Aparece "Falha na comunicação com a API do Gabster". O que fazer?
Na V2, essa mensagem aparece para qualquer falha, inclusive token inválido ou vencido. Confira o token com o Gabster e se o Ambiente (Produção ou Homologação) é o mesmo em que o projeto foi criado.
Aparece "Não foi possível identificar o serviço apropriado...". O que significa?
A integração está desligada. Ligue a chave Ativar integração com o Gabster e tente de novo.
Alterei o projeto no Gabster e o Pontta ainda traz a versão antiga.
O Pontta guarda as buscas por até 30 minutos (V2). Clique em Limpar cache Gabster em Integrações e busque de novo.
A busca não retorna nada e não mostra erro.
Na V2, quando o Gabster não encontra o projeto a lista simplesmente fica vazia. Confira o tipo de documento (Pedido fábrica ou Orçamento cliente), a forma de busca e o ambiente.
Na V2, Limpar cache Gabster mostra erro de autenticação.
O botão também tenta limpar o cache da V1 e, para isso, exige o token da V1. O cache da V2 já foi limpo quando a mensagem aparece; você pode ignorá-la.