RN Integracao Bling V3 - Histórico de revisão

Thales: Edições solicitadas pelo Vinicius

2026-05-12T11:57:04Z

Edições solicitadas pelo Vinicius

← Edição anterior		Edição das 08h57min de 12 de maio de 2026
Linha 22:		Linha 22:
	'''21''': em digitação<br>		'''21''': em digitação<br>
	'''24''': verificado		'''24''': verificado



Linha 28:		Linha 29:
	'''PortadorCodigo:''' Código do portador 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 transportadora 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;		'''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;

	'''RepresentanteCodigo:''' Código do representante 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 televendas padrão para a gravação dos pedidos;		'''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;		'''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;
Linha 56:		Linha 57:
	'''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;		'''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;

	'''IdsLojas:''' ID das lojas (separadas por ;), que ~~são utilizadas em questão de preço de produto~~;		'''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 ~~(relacionado com~~ IdsLojas);		'''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.		'''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.
Linha 68:		Linha 69:
	'''ImpostoCodigoComissao:''' Código do imposto para comissão do marketplace.		'''ImpostoCodigoComissao:''' Código do imposto para comissão do marketplace.

	'''ImpostoCodigoFreteCusto:''' Código do imposto para custo de frete que o vendedor paga.		'''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.

Vinicius em 19h34min de 20 de abril de 2026

2026-04-20T19:34:37Z

← Edição anterior		Edição das 16h34min de 20 de abril de 2026
Linha 65:		Linha 65:

	'''DepositoId:''' Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.		'''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.

Thales em 19h41min de 9 de abril de 2026

2026-04-09T19:41:44Z

← Edição anterior		Edição das 16h41min de 9 de abril de 2026
Linha 6:		Linha 6:
	== Parâmetros ==		== Parâmetros ==
	'''UrlEcommerce:''' Url do e-commerce https://api.bling.com.br/Api/v3;		'''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;		'''ClientId:''' Credencial ClientId do aplicativo;

Vinicius em 11h33min de 7 de abril de 2026

2026-04-07T11:33:21Z

@@ Linha 1: / Linha 1: @@
 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 ==
@@ Linha 89: / Linha 45: @@
 '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;
 '''FamiliasKit:''' Define quais famílias serão consideradas para kits na integração;
@@ Linha 103: / Linha 63: @@
 '''DepositoId:''' Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.

Matheus em 11h50min de 28 de julho de 2025

2025-07-28T11:50:12Z

← Edição anterior		Edição das 08h50min de 28 de julho de 2025
Linha 11:		Linha 11:
	[[Arquivo:Configurações Bling - Preferências.png\|centro]]		[[Arquivo:Configurações Bling - Preferências.png\|centro]]

	Depois basta ir em Cadastro -> Cadastro de Aplicativos:		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
	[[Arquivo:Configurações Bling - Cadastro de Aplicativos.png\|centro]]		[[Arquivo:Configurações Bling - Cadastro de Aplicativos.png\|centro]]

Vinicius em 19h30min de 9 de agosto de 2024

2024-08-09T19:30:03Z

← Edição anterior		Edição das 16h30min de 9 de agosto de 2024
Linha 49:		Linha 49:

	== Parâmetros ==		== Parâmetros ==
	'''UrlEcommerce:''' Url do e-commerce [https://api.bling.com.br/Api/v3];		'''UrlEcommerce:''' Url do e-commerce https://api.bling.com.br/Api/v3;

	'''ClientId:''' Credencial ClientId do aplicativo;		'''ClientId:''' Credencial ClientId do aplicativo;

Vinicius em 19h29min de 9 de agosto de 2024

2024-08-09T19:29:38Z

← Edição anterior		Edição das 16h29min de 9 de agosto de 2024
Linha 49:		Linha 49:

	== Parâmetros ==		== Parâmetros ==
	'''UrlEcommerce:''' Url do e-commerce;		'''UrlEcommerce:''' Url do e-commerce [https://api.bling.com.br/Api/v3];

	'''ClientId:''' Credencial ClientId do aplicativo;		'''ClientId:''' Credencial ClientId do aplicativo;

Vinicius em 13h29min de 31 de maio de 2024

2024-05-31T13:29:49Z

← Edição anterior		Edição das 10h29min de 31 de maio de 2024
Linha 2:		Linha 2:

	Para a versão 3 da API da Bling, foi incluído um novo processo de autenticação de usuário/aplicativo.		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:
			[[Arquivo:Configurações Bling - Preferências.png\|centro]]

			Depois basta ir em Cadastro -> Cadastro de Aplicativos:
			[[Arquivo:Configurações Bling - Cadastro de Aplicativos.png\|centro]]

			Depois basta selecionar o aplicativo ou criar um novo:
			[[Arquivo:Configurações Bling - Aplicativos.png\|centro]]

			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:
			[[Arquivo:Configurações Bling - Credenciais de Acesso.png\|centro]]

			== 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:
			[[Arquivo:Info configuração e-commerce ERP.png\|centro]]

			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:
			[[Arquivo:Autorização Aplicativo E-commerce Bling - scopos.png\|centro]]

			Basta selecionar autorizar logo abaixo:
			[[Arquivo:Autorização Aplicativo E-commerce Bling - Autorizar.png\|centro]]

			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:
			[[Arquivo:Retorno webservice ecommerce.png\|centro]]

			'''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''':
			[[Arquivo:Mensagem sucesso configuração ecommerce.png\|centro]]

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

	== Acoplamento ==		== Acoplamento ==

Vinicius em 13h11min de 31 de maio de 2024

2024-05-31T13:11:41Z

← Edição anterior		Edição das 10h11min de 31 de maio de 2024
Linha 1:		Linha 1:
	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.		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.

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

	== Acoplamento ==		== Acoplamento ==

Vinicius em 12h52min de 31 de maio de 2024

2024-05-31T12:52:40Z

← Edição anterior		Edição das 09h52min de 31 de maio de 2024
Linha 1:		Linha 1:
	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 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.		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 ==		== Acoplamento ==
Linha 6:		Linha 6:
	== Parâmetros ==		== Parâmetros ==
	'''UrlEcommerce:''' Url do e-commerce;		'''UrlEcommerce:''' Url do e-commerce;

			'''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;<br>		'''CodigoStatusPedido:''' Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;<br>
Linha 43:		Linha 47:

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

	~~'''ApiKey:''' Chave da API;~~

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

	'''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.		'''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.