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>.