VTEX

Visão geral

Configuração da integração

No Consistem ERP:

1. Parametrização Base: Acesse o programa Integração (CSINTEGRACAO010) para realizar a amarração das lojas e canais de venda.
2. Cadastro da Integração: Localize a Integração API VTEX e clique em Editar para executar o Cadastro de Integração (CSINTEGRACAO010A).

   
3. Credenciais e Adequação para a API v3 do Bling (Obrigatório): Defina os parâmetros de endpoint e as credenciais necessárias para a comunicação via API. Configure os campos de autenticação OAuth 2.0 (Client ID e Secret ID), gerando os Access/Refresh Tokens, e realize o mapeamento manual "de/para" das Naturezas de Operação entre os códigos internos do Consistem e os códigos criados no Bling.
4. Ativação: No campo Situação, selecione a opção Ativo.

   
5. Configuração de Múltiplas Lojas e Regras de Negócio: Através do botão Específico, execute o programa Cadastro de Lojas VTEX (CCPVH080) para inserir o ID do canal de venda (gerado no Bling para a VTEX) dentro dos parâmetros do Consistem. Isso permite separar e direcionar corretamente os pedidos da VTEX de outros marketplaces.

   
6. Amarração de Parâmetros: Informe o "código da loja" no campo de descrição de integração no Consistem e vincule o ID da loja cadastrado às respectivas tabelas de preço, naturezas de operação (CFOP) e representantes comerciais padrão para o e-commerce.

Na VTEX / Bling:

1. No painel da VTEX, gere o AppKey e AppToken para liberar o acesso direto do ERP.
2. No Bling, configure a integração com a VTEX e certifique-se de obter o ID do canal de venda (ID da loja) que será informado no Consistem ERP.
3. Configure as naturezas de operação no painel do Bling para que correspondam ao mapeamento que será feito dentro do ERP.

Como a integração funciona

• Comunicação de Entrada (Via Bling): O Consistem consome a API do Bling para ler e importar os pedidos que foram realizados na VTEX.
• Comunicação de Saída Direta (Consistem → VTEX): O Consistem utiliza os endpoints diretos da API da VTEX (autenticados via AppKey e AppToken) para realizar o bypass no Bling em etapas críticas onde o hub possui limitações de atualização.

O que o Consistem Recebe?

• Dados do Pedido: Importa do Bling as informações consolidadas do pedido (itens, valores, frete, descontos). Os dados cadastrais do cliente vêm embutidos no arquivo do pedido e são gravados automaticamente no banco de dados do Consistem no momento da importação.

O que o Consistem Envia?

• Para o Bling: Cadastro base de produtos, amarração de produtos pai/filho (grades), tabelas de preço vigentes e as atualizações de saldo de estoque.
• Direto para a VTEX: Comandos de alteração de status de logística (Em Manuseio) e o envio de dados de faturamento juntamente com o arquivo XML da nota.

Fluxo do processo

1. Geração do Pedido: O cliente final conclui a compra na plataforma VTEX. O pedido é enviado automaticamente da VTEX para o Bling.
2. Reserva de Estoque (Aguardando Pagamento): Se o pedido entrar na VTEX com pagamento pendente (status Em andamento), o Consistem ERP realiza a leitura do leiaute de pedidos e o importa com a situação Bloqueado. Isso garante a reserva imediata do estoque físico.
3. Liberação do Pedido: Assim que o pagamento é autorizado na VTEX, o status muda no Bling. O Consistem monitora a alteração e atualiza internamente a situação do pedido para Liberado/Sugerido, disponibilizando-o para faturamento.
4. Início de Manuseio (Via Direta): Assim que o pedido atinge a situação Liberado no Consistem, o ERP dispara uma requisição direta para a API da VTEX, alterando o status do pedido na plataforma para Início de Manuseio.
5. Faturamento e Envio Fiscal (Via Direta): Após a emissão e autorização da Nota Fiscal Eletrônica no Consistem ERP, o sistema envia a atualização para o Bling e, simultaneamente, transmite os dados de faturamento e o XML da nota diretamente para a VTEX. Esse gatilho encerra o fluxo na VTEX e dispara os e-mails de acompanhamento ao cliente final.
6. Movimentação de PPCP (Segmento Industrial / Confecção): A confirmação e liberação do pedido geram as demandas correspondentes no módulo de PPCP Industrial ou Confecção para controle de empenhos, geração de ordens de produção ou baixas de estoque manufaturado.

Como consultar e monitorar a integração

• Logs de Erro e Requisições: Tela de monitoramento Consulta Logs de Integração (CSINTEGRACAO100) onde ficam gravados os históricos de erros e o corpo (payload) completo das requisições (XML/JSON) de todos os endpoints. Caso um produto ou pedido não integre, o motivo exato retornado pela API estará nesta tela.
• Monitoramento de Produtos: Na Importação e Manutenção do Código de Automação do Produto (CCCGI910) é permitido avaliar visualmente o relacionamento de códigos ("de/para") entre as referências de produtos do Consistem e do Bling. Utilizada para auditar divergências de saldos de estoque ou identificar vínculos quebrados.
• Monitor de Pedidos de Integração (CCPV990): Painel que compara de forma analítica a situação do pedido dentro do Bling versus a situação real interna no Consistem. Permite que o operador execute ações manuais de contingência, tais como: forçar a importação de um pedido travado, registrar cancelamentos ou reenviar atualizações de status pendentes.

Sim Não