Visão geral
Facilitar o gerenciamento das vendas realizadas, a emissão de notas fiscais e boletos gerados com a plataforma de e-commerce e marketplace entre o Consistem ERP e o Sistema de Gestão Bling.
Requisitos
Consistem ERP | Bling |
---|---|
Versão 6.13 ou superior Lembrando que a versão 6.13 se aplica ao ramo Têxtil/Confecção Lembrando que a versão 6.14 se aplica ao ramo Padrão Módulos Comercial e Financeiro Somente esses que o cliente precisa estar contratado? Tabela de preço configurada no 010. Aquisição de licença Após a aquisição, nossa equipe de consultores está pronta para auxiliá-los. Se for essa a situação. Katiani, tem treinamento após a contratação, ou o cliente configura sozinho? Necessidade em citar no processo? Algum suporte ou responsável caso apresente algum erro no meio do processo? | Aquisição do plano com integração E-Commerce Saiba mais |
Por onde eu começo?
Sistema de Gestão Bling
- Acesse o Bling com os dados de login;
- Cadastre o usuário do tipo API e realize a geração do token da API;
- Configure o marketplace para integrar com o Bling;
- Realize a configuração e cadastro dos produtos, vendas, integração automática de pedidos e meios de pagamento;
- Realize a configuração e cadastro dos produtos, vendas, integração automática de pedidos e meios de pagamento;
- Configure a logística;
- Consulte os produtos cadastrados no Bling e realize a exportação para o marketplace;
Importante: atente-se ao cadastro dos pesos líquido e bruto dos produtos, caso não sejam preenchidas essas informações não será possível realizar a exportação para o marketplace.- Após realizada a exportação da primeira vez não terá a necessidade de refazer, pois será feita atualização de forma automática, sempre atualizando preço e estoque.
- Realize a importação dos pedidos de venda.
Sistema Consistem ERP
- Acesse o programa Integração (CSINTEGRACAO010) e no grid selecione a Integração API Bling;
- Acione o Editar para executar o Cadastro de Integração (CSINTEGRACAO010A) permitindo realizar a parametrização e ativação da integração.
- Na Aba Dados Gerais (CSINTEGRACAO010ATAB1) inicia-se a configuração e habilita-se a integração.
Importante: se atentar ao campo Situação, pois se permanecer como Inativo não irá funcionar a integração.
Importante: os dados incluídos no sistema Consistem ERP devem ser os mesmos que foram cadastrados no sistema de Gestão Bling.No grid constam dados de Campos existentes no Bling e, ao lado, na coluna Valor é possível preencher com as informações relacionadas.
Campo Valor API Key É gerado na Bling. Diretório FTP Quando for enviar as imagens para algum FTP. Envia Imagem URL FTP Combo Sim ou Não. Intervalo Importação em minutos Intervalo de tempo importação dos pedidos Motivo pra Pedidos Cancelado Motivo para quando um pedido for Cancelado Porta FTP Caso haja. Senha FTP Caso haja. Situação pra Pedidos Bloqueado Informação disponível na Bling conforme o cadastro. Situação pra Pedidos Cancelado Informação disponível na Bling conforme o cadastro. Sugere Cor Pedido Parcial Combo Sim ou Não. Sugere Tamanho Pedido Parcial Combo Sim ou Não. Forma de Envio de Imagem Combo de opções disponíveis. URL Imagem/FTP Caso haja. URL Imagem Bling Caso haja. Usuário FTP Caso haja. - No botão Empresa é exibido o programa Configurações Gerais por Empresa (CSINTEGRACAO010ATAB1A), para os casos que é necessário realizar uma configuração diferente para outra empresa.
No grid constam dados de Campos existentes no Bling, a empresa em questão e, ao lado, na coluna Valor é possível preencher com as informações relacionadas.
Campo Valor Categoria Categoria padrão. Natureza Quais naturezas fazem parte da integração. Ramo de Atividade Qual o ramo de atividade para os novos clientes que surgirem. Representante Qual o representante padrão. Situação Pedido Venda Importação Quais as situações do pedido de venda que irão ser monitorados. Quando configurado aqui, o sistema não irá mais considerar o tempo de intervalo de importação dos pedidos que foi preenchido na tela anterior. Situação Pedido Venda Bling depois de Cancelado Determinar a situação que o pedido será considerado no Bling depois de Cancelado no Consistem. Tabela de Preço Custo Tabela de preço padrão. Tabela de Preço Venda Tabela de preço padrão.
- No botão Específico é exibido o programa Configuração Integração Bling (CCPV093) permitindo configurar os dados da loja para geração do pedido na integração com o Bling.
- Campos: código da loja configurada no Bling, uma descrição, código da empresa e a tabela de preço para essa loja.
- Grid: informar qual o campo da integração, o representante para essa integração quando entrar os pedidos, o tipo de nota, o ramo de atividade, informar a etapa do pedido que irá entrar caso haja, a condição de venda, o portador e o tipo de cobrança.
- No botão Forma de Pagamento é exibido o programa Configuração Integração Bling - Forma de Pagamento (CCPV093B) permitindo relacionar os códigos das formas de pagamento da Bling com a condição de venda, portador e tipo de cobrança do Consistem para quando for importado um pedido o sistema identificar qual deverá utilizar.
- No botão Transportadora é executado o programa Configuração Integração Bling - Transportadora/Serviço (CCPV093A) permitindo configurar a transportadora do Consistem com o serviço ou transportadora da Bling para gerar os dados na entrada do pedido.
Importante: o código do serviço é o mesmo que foi cadastrado no Bling.
- Retornando para o programa Cadastro de Integração (CSINTEGRACAO010A) temos a Aba Endpoints (CSINTEGRACAO010ATAB2) que estão disponíveis os endpoints vinculados à integração do Bling. Aqui é possível habilitar e desabilitar os endpoints da integração conforme necessidade e, ainda, verificar e detalhar os possíveis erros caso hajam.
- O endpoint de contatos não é utilizada pois a Bling não monitora os clientes cadastrados no marketplace e que ainda não realizaram nenhum pedido. Quando o cliente realizar o pedido, automaticamente, o cadastro do mesmo será importado para o Bling e consequentemente para o Consistem.
Método | Endpoint | Descrição | Direcionado |
---|---|---|---|
DELETE | /Api/v2/produto/{codProduto}/json | Enviar Exclusão Produto Bling | Consistem > Bling |
GET | /Api/v2/contatos/json | Importar Cliente Bling | x |
GET | /Api/v2/formaspagamento/json | Importar Forma de Pagamento Bling | Bling > Consistem |
GET | /Api/v2/pedido/{codPedido}/json | Importar Pedido Automação Bling | Bling > Consistem |
GET | /Api/v2/pedidos/{stringPagina}/json | Importar Pedido Bling | Bling > Consistem |
GET | /Api/v2/produto/{codProduto}/json | Obter Código Produto Loja Bling | |
GET | /Api/v2/produtos/{stringPagina}/json | Importar Produto Bling | Bling > Consistem |
GET | /Api/v2/situacao/{stringModulo}/json | Importar Cadastro de Situação Bling | Bling > Consistem |
POST | /Api/v2/categoria/json | Enviar Categoria Bling | Consistem > Bling |
POST | /Api/v2/contato/json | Enviar Cliente Bling | x |
POST | /Api/v2/deposito/json | Enviar Natureza Bling | Consistem > Bling |
POST | /Api/v2/formapagamento/json | Enviar Forma de Pagamento Bling | Consistem > Bling |
POST | /Api/v2/notafiscal/json | Enviar Nota Fiscal Bling | Consistem > Bling |
POST | /Api/v2/produto/json | Enviar Produto Bling | Consistem > Bling |
POST | /Api/v2/produto/{codProduto}/json | Enviar Atualização Produto Bling | Consistem > Bling |
POST | /Api/v2/produtoLoja/{codLoja}/{codProduto}/json | Enviar Produto Loja Bling | Consistem > Bling |
PUT | /Api/v2/categoria/{codCategoria}/json | Enviar Atualização de Categoria Bling | Consistem > Bling |
PUT | /Api/v2/contato/{codCliente}/json | Enviar Atualização de Cliente Bling | x |
PUT | /Api/v2/deposito/{codNatureza}/json | Enviar Atualização Natureza Bling | Consistem > Bling |
PUT | /Api/v2/formapagamento/{codFormaPagamento}/json | Enviar Atualização da Forma de Pagamento Bling | Consistem > Bling |
PUT | /Api/v2/pedido/{codPedido}/json | Enviar Atualização Pedido Bling | Consistem > Bling |
PUT | /Api/v2/produtoLoja/{codLoja}/{codProduto}/json | Enviar Atualização Produto Loja Bling | Consistem > Bling |
- Já a Aba Integração Manual (CSINTEGRACAO010ATAB3) poderá ser utilizada caso o usuário queira realizar a geração de uma requisição manual para integração com o sistema terceiro.
- Envio/atualização no Consistem para o Bling
- Importar Bling para o Consistem
- Agora sim, na Aba Carga Dados (CSINTEGRACAO010ATAB4) é possível a geração de carga de dados para todo o sistema integrado, agilizando assim o processo de integração.
- Envio para o Bling em massa
- Se houver erros ou não constaram no log de integração Ações 010 (a consulta é a mesma).
- Ações - Agendamento de tarefas (015) tanto para consumir ou enviar dados.
- O que envia vai do Consistem para o Bling (endpoint envia)
- O que recebe do Bling importa para o Consistem
- Endpoint Obter não entra nessa consulta de vai e vem.
- Bling - Configuração de lojas - Botão Específico -mesmos dados cadastrados manualmente no Bling.
- Integrar dados/informações entre o Consistem e o Bling.
Cadastro de Integração → Aba Dados Gerais → Botão específico
Abre o programa Configuração Integração Bling (CCPV093) que é utilizado para fazer a configuração da loja no Consistem EPR inserindo o código da respectiva loja, e campos da tela.
Na loja em questão, o cliente pode se cadastrar, porém a loja somente disponibiliza para o Bling os clientes quando o cliente fizer uma compra.
Na integração do pedido da Bling para o Consistem, o cliente já é criado. Não tem necessidade de ativar a integração de clientes.
Se o cliente atualizar os dados na loja, e fizer um novo pedido, esses novos dados do cliente serão atualizados no Consistem quando o novo pedido entrar no Consistem.
O cliente tem que configurar uma tabela de preços geral para integração e pode trabalhar tabela de preços por loja configurada.
É obrigado ter uma tabela de preços no Consistem. Os preços dessa tabela serão enviados ao Bling junto com o produto.
Configuração Integração Bling→ Forma Pagamento
Abre o programa Configuração Integração Bling - Forma de Pagamento (CCPV093B) para fazer o De Para da Forma de Pagamento da loja com o Consistem ERP.
Configuração Integração Bling→ Transportadora
Abre o programa Configuração Integração Bling - Transportadora/Serviço (CCPV093A) para fazer o De Para da Transportadora da loja com o Consistem ERP
Cadastro de Integração → Aba Endpoints
Apresenta todos os endpoints disponíveis para a integração:
Método | Endpoint | Descrição |
---|---|---|
DELETE | /Api/v2/produto/{codProduto}/json | Enviar Exclusão Produto Bling |
GET | /Api/v2/contatos/json | Importar Cliente Bling |
GET | /Api/v2/formaspagamento/json | Importar Forma de Pagamento Bling |
GET | /Api/v2/pedido/{codPedido}/json | Importar Pedido Automação Bling |
GET | /Api/v2/pedidos/{stringPagina}/json | Importar Pedido Bling |
GET | /Api/v2/produto/{codProduto}/json | Obter Código Produto Loja Bling |
GET | /Api/v2/produtos/{stringPagina}/json | Importar Produto Bling |
GET | /Api/v2/situacao/{stringModulo}/json | Importar Cadastro de Situação Bling |
POST | /Api/v2/categoria/json | Enviar Categoria Bling |
POST | /Api/v2/contato/json | Enviar Cliente Bling |
POST | /Api/v2/deposito/json | Enviar Natureza Bling |
POST | /Api/v2/formapagamento/json | Enviar Forma de Pagamento Bling |
POST | /Api/v2/notafiscal/json | Enviar Nota Fiscal Bling |
POST | /Api/v2/produto/json | Enviar Produto Bling |
POST | /Api/v2/produto/{codProduto}/json | Enviar Atualização Produto Bling |
POST | /Api/v2/produtoLoja/{codLoja}/{codProduto}/json | Enviar Produto Loja Bling |
PUT | /Api/v2/categoria/{codCategoria}/json | Enviar Atualização de Categoria Bling |
PUT | /Api/v2/contato/{codCliente}/json | Enviar Atualização de Cliente Bling |
PUT | /Api/v2/deposito/{codNatureza}/json | Enviar Atualização Natureza Bling |
PUT | /Api/v2/formapagamento/{codFormaPagamento}/json | Enviar Atualização da Forma de Pagamento Bling |
PUT | /Api/v2/pedido/{codPedido}/json | Enviar Atualização Pedido Bling |
PUT | /Api/v2/produtoLoja/{codLoja}/{codProduto}/json | Enviar Atualização Produto Loja Bling |
É possível ativar ou desativar um endpoint e consultar seu status e logs de integração.
Cadastro de Integração → Aba Integração Manual
Utilizada em caso de contingência em virtude de indisponibilidade com a integração automática.
Cadastro de Integração → Aba Carga de Dados
Utilizada pra dar a carga inicial da integração.
Fluxo do processo
O pedido é gerado pelo cliente na loja do Marketplace que envia ao Sistema de Gestão Bling.
Ao receber o pedido o Sistema de Gestão Bling dispara a integração com o Consistem ERP que gera o pedido no Consistem ERP de acordo com as parametrizações.
Caso cliente do pedido não exista na base de dados do ERP o mesmo é criado de forma automática.
Caso a condição de pagamento escolhida for boleto o pedido entra no Consistem ERP com a situação Bloqueado.
Após o pagamento do pedido ser efetuado o sistema atualiza a situação para Liberado/Sugerido.
Caso o pedido seja alterado para Cancelado ou Faturado no Consistem ERP a integração atualiza a situação do pedido no Sistema de Gestão Bling.
Quando o pedido é faturado no Consistem ERP o sistema envia a nota para o Sistema de Gestão Bling.