VIPP - API Logística
O VIPP é um sistema para gerenciar postagens para clientes que usam os serviços dos Correios, permitindo diversos controles a partir de entregas.
Configurando a integração
Para começar, você precisa instalar a extensão Token API no seu ERP. Siga os passos:
- Acesse menu > início > Loja de extensões.
- Procure por Token API na pesquisa.
- Clique em instalar para confirmar a instalação.
Agora, para gerar o token:
- Acesse menu > configurações > e-commerce.
- Clique em Token API.
- Clique em Gerar token API para criar o identificador da sua conta no ERP.
- Copie o código gerado, ele deve seno VisualSet - VIPP.
Configurando a forma de envio
É necessário cadastrar as Formas de Envio na sua conta no ERP para que o VIPP possa informar o serviço escolhido e o código de rastreamento.
- Acesse menu > configurações > aba vendas > Formas de envio.
- Clique em incluir forma de envio.
- No campo Tipo de logístico, selecione Customizado.
- No campo Descrição da forma de envio, informe VisualSet_Tecnologia.
- Em Configurações das formas de frete, clique em adicionar forma de frete
- Agora, informe a Descrição da forma de envio e o código de serviços conforme a tabela abaixo:
| Descrição | Código do serviço |
|---|---|
| 04162 - Sedex Corredor Negócios | 04162 |
| 04669 - Pac Corredor Negócios | 04669 |
| 12556 - Carta Comercial Registrada a Faturar | 12556 |
| 20150 - Impresso Normal a Faturar Módico | 20150 |
| 04553 - SEDEX Encomenda 2.0 (Contrato) | 04553 |
| 04596 - PAC Encomenda 2.0 (Contrato) | 04596 |
7. Cadastre todas as formas de envio que serão usadas na integração.
8. Clique em salvar.
Configuração no sistema VIPP
- No menu do VIPP, acesse Cadastros > Remetentes.
- Ao acessar a página de Remetentes, você verá um ícone no início de cada remetente. Escolha o remetente que será atribuído à integração e clique no ícone para expandir as opções.
- Ao expandir, você terá acesso ao botão Nova Integração. Clique nele para abrir a tela de cadastro.
- Ao acessar, selecione a opção ERP da Olist, preencha seu e-mail e, no campo API Token, coloque o Token gerado no ERP.
Observação: após seguir os passos acima, aguarde um tempo para que seus pedidos comecem a carregar.
Configuração de Contrato/Cartão, Serviços e Controle de Postagem
- No menu do VIPP, acesse: Cadastros > Remetentes.
- Na lista de remetentes, clique no ícone ao lado do remetente que deseja usar na integração.
- Clique no ícone de edição do ERP da Olist
- Selecione Logísticas Serviços.
- Na tabela exibida:
- Clique no campo Contrato/Cartão para escolher o contrato correspondente ao serviço vindo da integração.
- Ao selecionar, será aberta a tela de configuração.
- Controle de postagem
- Defina como os pedidos com esse serviço de entrega serão processados:
- Nenhuma ação selecionada → o pedido não terá nenhuma ação.
- Não integrar pedidos → os pedidos não serão integrados à plataforma.
- Processo manual → o pedido aguardará sua ação para seguir no fluxo postal.
- Etiquetar e aguardar liberação → o pedido será etiquetado e ficará em espera até liberação.
- Processo automático → o pedido será etiquetado e liberado automaticamente no fluxo postal.
- Se houver valor de Nota Fiscal, ele será usado como Valor Declarado.
- O campo exibe o Contrato/Cartão/Serviço que você deseja associar à Loja/Marketplace.
- Clique em Salvar para confirmar. O sistema retornará para a tabela anterior.
Efetuar postagem dos pedidos
Após seguir todo o processo de cadastro e vínculos de serviços de postagem, siga os passos abaixo para postar os pedidos:
- Acesse a tela de integração de pedidos em Minhas Postagens > Integração de Pedidos.
- No filtro Status das Vendas, mude a chave de Sim para Não no status de Aguardando Pagamento, para ver os pedidos já liberados para postagem.
- Quando os pedidos estiverem liberados para postar, o botão Postar Objetos ficará disponível. Selecione o pedido e clique no botão Postar Objetos para efetuar a postagem.
- Na lista abaixo, aparecerão os pedidos com as situações Aprovado, Preparando envio e Faturado do ERP.
- Para finalizar a postagem, selecione os registros na grade e clique em Postar Objetos.
- Depois que o pedido for liberado no VIPP, o código de rastreio será enviado ao ERP, e o pedido será atualizado para a situação Enviado.
- O pedido estará disponível para impressão de etiquetas na área de Check List no VIPP, acessando o menu Minhas Postagens > Check List (Modelo Simplificado) ou Minhas Postagens > Check List (Modelo Moderno).
- O VIPP atualizará o ERP de forma automática quando o pedido for entregue ao destinatário.
Como importar as vendas do ERP em sua conta no VIPP
As vendas da sua conta no ERP serão importadas de forma automática para a plataforma por meio de uma rotina que acontece a cada 5 minutos.
Depois que as vendas estiverem importadas, você poderá dar sequência no processo de envio e entrega.
Como marcar as vendas como entregues no ERP a partir do VIPP
O sistema VIPP atualizará o ERP de forma automática quando o pedido for entregue ao destinatário.