RN Integracao Bling V3

Regra de negócio do tipo habilitadora que pode ser acoplada ao DataPlus ERP e tem o objetivo configurar e manipular a integração entre API Bling na versão 3 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.

Acoplamento

Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento ExecutaOperacao, sendo seu designador por Execução e tempo de execução Depois.

Parâmetros

UrlEcommerce: Url do e-commerce https://api.bling.com.br/Api/v3;

IntegracaoMagalu: Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto);

ClientId: Credencial ClientId do aplicativo;

ClientSecret: Credencial ClientSecret do aplicativo;

CodigoStatusPedido: Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;
Códigos verificados e possíveis para utilização:
6: em aberto
9: atendido
12: cancelado
15: em andamento
18: venda agenciada
21: em digitação
24: verificado

SituacaoCodigo: Código da situação padrão para a gravação dos pedidos;

PortadorCodigo: Código do portador padrão para a gravação dos pedidos;

TransportadoraCodigo: Código da(s) transportadora(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;

OpSaidaCodigo: Código da operação de saída padrão para a gravação dos pedidos;

RepresentanteCodigo: Código do(s) representante(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;

TelevendasCodigo: Código do(s) televendas (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;

CaracteristicaCodigo: Código da característica de venda padrão para a gravação dos pedidos;

DiasPrazoEntrega: Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);

TipoFrete: Tipo de frete;

StatusCliente: Código do status de pessoa para clientes trazidos do e-commerce;

RamoAtividadeCodigo: Código do ramo de atividade padrão para a gravação dos clientes;

DefinirEnqFiscal: Define o enquadramento fiscal do cliente ao integrá-lo;

EnqFiscalPessoaFisica: Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;

EnqFiscalPessoaJuridica: Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;

FamiliasKit: Define quais famílias serão consideradas para kits na integração;

NumeroListaPrecoProdutos: Lista de Preços para realizar o envio dos produtos para o web service;

IdsLojas: ID das lojas (separadas por ;), em que cada id corresponde a um canal (Os valores informados serão incluídos na consulta dos pedidos, coletando dados apenas das lojas especificadas.);

PercentualLojas: Percentuais (separados por ;) a serem aplicados nos preços da lista de preços para cada loja. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 5; 10; 15;

QtdeEstoque: Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.

EmpresaReceptora: Empresa em que o pedido será integrado.

DepositoId: Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.

ImpostoCodigoComissao: Código do imposto para comissão do marketplace.

ImpostoCodigoFreteCusto: Código do imposto para custo de frete que o vendedor paga.

Sobre os valores separados por ponto e vírgula, eles devem ser informados da seguinte forma:

Para que o recurso funcione, é preciso informar nos campos RepresentanteCodigo, TelevendasCodigo e TransportadoraCodigo os valores separados por ponto e vírgula (;). A quantidade de valores deve ser a mesma do campo IdsLojas. Caso contrário, será exibida uma mensagem para que o ajuste seja feito.

Exemplo:

• RepresentanteCodigo: 30179;22610
• TelevendasCodigo: 30179;22610
• IdsLojas: 206050338;205992462

Dessa forma, o RepresentanteCodigo e o TelevendasCodigo (30179) serão utilizados para a loja (206050338).

O RepresentanteCodigo e o TelevendasCodigo (22610) serão utilizados para a loja (205992462).

Se não for informado um ID de loja e apenas um representante, televendas ou transportadora for passado, o valor será utilizado para todas as lojas. Porém, se mais de um for informado, o sistema entenderá que a loja correspondente deve ser especificada.

Para a versão 3 da API da Bling, foi incluído um novo processo de autenticação de usuário/aplicativo.

1° Passo - Acessar Aplicativos

Acessar Link: <ref>https://www.bling.com.br/login</ref>

Após acessar a conta, basta ir no Ícone de configurações -> Todas as configurações:

Depois basta ir em Cadastro -> Cadastro de Aplicativos: https://www.bling.com.br/login?r=https%3A%2F%2Fwww.bling.com.br%2Fcadastro.aplicativos.php

Depois basta selecionar o aplicativo ou criar um novo:

Para criar um novo basta seguir as seguintes instruções: <ref>https://developer.bling.com.br/homologacao#inscri%C3%A7%C3%A3o</ref>

Ao criar um novo aplicativo, a URL de Callback será essa: <ref>https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationEcommerce</ref>. Será uma URL definida no servidor da DataPlus.

Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o ClientId e o ClientSecret:

2° Passo - Configuração no ERP

No ERP basta informar as credencias ClientId e ClientSecret e uma identificação para recebimento do Token de autorização temporário (O token tem o tempo de expiração de 1 minuto) para a configuração do E-commerce:

Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão Gerar Token Autorização, após o click uma tela na Web será aberta, para a autorização do aplicativo com o ERP:

Basta selecionar autorizar logo abaixo:

Após a autorização, você será redirecionado para o webservice da DataPlus, com a mensagem de ok você pode fechar a página e prosseguir com o segundo passo:

Lembrando que o token gerado após a aparição da mensagem expira em 1 minuto, caso o token expire será necessário repetir o processo.

Após gerar o token de acesso temporário, basta clicar em Gerar Token Acesso:

Com a mensagem o ecommerce está configurado corretamente. As credenciais de acesso é guardado em um XML na pasta do usuário (C:\Users\Vinicius\AppData\Local) no arquivo ApiConfig no nó <ApiBlingV3>.