Bling! (v3)

Adicionando o conector

Este conector está em modo beta. Nos avise se encontrar algum resultado inesperado

Requisitos

  • Plano Mercúrio em diante
  • Acesso de administrador aos módulos Borderos, CT-e, Campos Customizados, Campos Customizados: Clientes e Fornecedores, Campos Customizados: Ordem de Serviço, Campos Customizados: Produtos, Categoria de Produtos, Categorias Receitas e Despesas, Clientes e Fornecedores, Contas Contábeis, Contas a Pagar, Contas a Receber, Contratos, Controle de Estoque, Depósitos de Estoque, Gerenciador de transições, Integrações Logísticas, Integrações e Lojas Virtuais, Nota de Serviço, Nota fiscal de consumidor eletrônica (NFC-e), Notas Fiscais, Notas de Entrada, Pedidos de Compra, Pedidos de Compra: Gerenciar situações de Pedidos de Compras, Pedidos de Venda, Pedidos de Venda: Gerenciar situações dos Pedidos de Venda, Produtos e Visualizar os dados básicos da empresa

Instruções

1) Faça login na plataforma da Kondado > No menu superior clique em "Criar +" > Conector > Selecione o conector do Bling! > Clique em Autenticar

Screenshot from 2024-04-16 16-06-27.png

2) Navegue até o final da página que se abirá e clique em Autorizar

3) Você será redirecionado para a página da Kondado. Agora basta salvar seu conector e começar a criar suas integrações!

Caso seu plano seja do Mercúrio em diante e receba um aviso similiar ao abaixo, peça ao suporte do Bling liberação dos módulos em questão na sua conta e no seu usuário, que podem estar bloqueados

Integrações

Índice

Gráfico de relacionamento

Clique para ampliar

Pedidos de venda

Campo Tipo

id

text

[pt] Id do pedido de venda

contato_id

text

[pt] Id do contato do pedido de venda

contato_nome

text

[pt] Nome do contato do pedido de venda

contato_numerodocumento

text

[pt] Número do documento do contato do pedido de venda

contato_tipopessoa

text

[pt] Tipo de pessoa do contato do pedido de venda

data

date

[pt] Data da venda do pedido

dataprevista

text

[pt] Data prevista para o pedido de venda

datasaida

date

[pt] Data de saída do pedido de venda

loja_id

text

[pt] Id da loja do pedido de venda

numero

text

[pt] Numero do pedido de venda

numeroloja

text

[pt] Numero da loja do pedido de venda

situacao_id

text

[pt] Id da situação do pedido de venda

situacao_valor

float

[pt] Valor da situação do pedido de venda

total

float

[pt] Total do pedido de venda

totalprodutos

float

[pt] Total de produtos do pedido de venda

Contas a pagar

Campo Tipo

id

text

[pt] Identificação da conta a pagar

contato_id

text

[pt] Identificador do contato associado à conta a pagar

formapagamento_id

text

[pt] Identificador da forma de pagamento da conta a pagar

situacao

float

[pt] Situação da conta a pagar

valor

float

[pt] Valor da conta a pagar

vencimento

date

[pt] Data de vencimento da conta a pagar

Contas a pagar: detalhes

Campo Tipo

id

text

[pt] Identificação da conta a pagar

    Contas a pagar > > id

borderos

text

[pt] Identificadores dos borderôs associados à conta a pagar separados por virgula

categoria_id

text

[pt] Identificador da categoria da conta a pagar

competencia

date

[pt] Data de competência da conta a pagar

contato_id

text

[pt] Identificador do contato associado à conta a pagar

dataemissao

date

[pt] Data de emissão da conta a pagar

formapagamento_id

text

[pt] Identificador da forma de pagamento da conta a pagar

    Formas de pagamento > > id

historico

text

[pt] Histórico ou descrição da conta a pagar

numerobanco

text

[pt] Número do banco para pagamento da conta a pagar

numerodocumento

text

[pt] Número do documento associado à conta a pagar

portador_id

text

[pt] Identificador do portador da conta a pagar

saldo

float

[pt] Saldo atual da conta a pagar

situacao

float

[pt] Situação da conta a pagar

valor

float

[pt] Valor da conta a pagar

vencimento

date

[pt] Data de vencimento da conta a pagar

vencimentooriginal

date

[pt] Data de vencimento original da conta a pagar

Contas a receber

Campo Tipo

id

text

[pt] Identificação da conta a receber

contacontabil_descricao

text

[pt] Descrição da conta contábil

contacontabil_id

text

[pt] Identificador da conta contábil associada à conta a receber

contato_id

text

[pt] Identificador do contato associado à conta a receber

contato_nome

text

[pt] Nome do contato associado à conta a receber

contato_numerodocumento

text

[pt] Número do documento do contato

contato_tipo

text

[pt] Tipo de entidade do contato (J para jurídica, F para física)

dataemissao

date

[pt] Data de emissão da conta a receber

formapagamento_codigofiscal

float

[pt] Código fiscal associado à forma de pagamento

formapagamento_id

text

[pt] Identificador da forma de pagamento da conta a receber

idtransacao

text

[pt] Identificador da transação associada à conta a receber

origem_dataemissao

date

[pt] Data de emissão da origem da conta a receber

origem_id

text

[pt] Identificador da origem da conta a receber

origem_numero

text

[pt] Número associado à origem da conta a receber

origem_situacao

float

[pt] Situação da origem da conta a receber

origem_tipoorigem

text

[pt] Tipo da origem da conta a receber

origem_url

text

[pt] URL associada à origem da conta a receber

origem_valor

float

[pt] Valor associado à origem da conta a receber

situacao

float

[pt] Situação da conta a receber

valor

float

[pt] Valor da conta a receber

vencimento

date

[pt] Data de vencimento da conta a receber

Contas a receber: detalhes

Campo Tipo

id

text

[pt] Identificação da conta a receber

    Contas a receber > > id

borderos

text

[pt] Identificadores dos borderôs associados à conta a receber

categoria_id

text

[pt] Identificador da categoria da conta a receber

competencia

date

[pt] Data de competência da conta a receber

contacontabil_descricao

text

[pt] Descrição da conta contábil

contacontabil_id

text

[pt] Identificador da conta contábil associada à conta a receber

contato_id

text

[pt] Identificador do contato associado à conta a receber

contato_nome

text

[pt] Nome do contato associado à conta a receber

contato_numerodocumento

text

[pt] Número do documento do contato

contato_tipo

text

[pt] Tipo de entidade do contato (J para jurídica, F para física)

dataemissao

date

[pt] Data de emissão da conta a receber

formapagamento_codigofiscal

float

[pt] Código fiscal associado à forma de pagamento

formapagamento_id

text

[pt] Identificador da forma de pagamento da conta a receber

    Formas de pagamento > > id

historico

text

[pt] Histórico ou descrição da conta a receber

idtransacao

text

[pt] Identificador da transação associada à conta a receber

numerobanco

text

[pt] Número do banco para pagamento da conta a receber

numerodocumento

text

[pt] Número do documento da conta a receber

ocorrencia_tipo

float

[pt] Tipo de ocorrência associada à conta a receber

origem_dataemissao

date

[pt] Data de emissão da origem da conta a receber

origem_id

text

[pt] Identificador da origem da conta a receber

origem_numero

text

[pt] Número associado à origem da conta a receber

origem_situacao

float

[pt] Situação da origem da conta a receber

origem_tipoorigem

text

[pt] Tipo da origem da conta a receber

origem_url

text

[pt] URL associada à origem da conta a receber

origem_valor

float

[pt] Valor associado à origem da conta a receber

portador_id

text

[pt] Identificador do portador da conta a receber

saldo

float

[pt] Saldo atual da conta a receber. É calculado subtraindo os valores dos recebimentos do valor da conta

situacao

float

[pt] Situação da conta a receber

valor

float

[pt] Valor da conta a receber

vencimento

date

[pt] Data de vencimento da conta a receber

vencimentooriginal

date

[pt] Data de vencimento original da conta a receber

vendedor_id

text

[pt] Identificador do vendedor associado à conta a receber

Contatos

Campo Tipo

id

text

[pt] Identificação do contato

celular

text

[pt] Celular do contato

codigo

text

[pt] Código do contato

nome

text

[pt] Nome do contato

numerodocumento

text

[pt] CPF ou CNPJ do contato

situacao

text

[pt] Situação do contato. A: Ativo; E: Excluido; I: Inativo; S: Sem movimentação

telefone

text

[pt] Telefone do contato

Contatos: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação do contato

celular

text

[pt] Celular do contato

codigo

text

[pt] Código do contato

dadosadicionais_datanascimento

date

[pt] Data de nascimento do contato

dadosadicionais_naturalidade

text

[pt] Naturalidade do contato

dadosadicionais_sexo

text

[pt] Sexo do contato

email

text

[pt] E-mail do contato

endereco_cobranca_bairro

text

[pt] Bairro do endereço de cobrança do contato

endereco_cobranca_cep

text

[pt] CEP do endereço de cobrança do contato

endereco_cobranca_complemento

text

[pt] Complemento do endereço de cobrança do contato

endereco_cobranca_endereco

text

[pt] Logradouro do endereço de cobrança do contato

endereco_cobranca_municipio

text

[pt] Município do endereço de cobrança do contato

endereco_cobranca_numero

text

[pt] Numero do endereço de cobrança do contato

endereco_cobranca_uf

text

[pt] UF do endereço de cobrança do contato

endereco_geral_bairro

text

[pt] Bairro do endereço geral

endereco_geral_cep

text

[pt] CEP do endereço geral

endereco_geral_complemento

text

[pt] Complemento do endereço geral

endereco_geral_endereco

text

[pt] Endereço geral

endereco_geral_municipio

text

[pt] Município do endereço geral

endereco_geral_numero

text

[pt] Número do endereço geral

endereco_geral_uf

text

[pt] UF do endereço geral

fantasia

text

[pt] Nome fantasia do contato

financeiro_categoria_id

text

[pt] ID da categoria financeira

financeiro_condicaopagamento

text

[pt] Condição de pagamento do contato

financeiro_limitecredito

float

[pt] Limite de crédito do contato

ie

text

[pt] Inscrição Estadual do contato

indicadorie

float

[pt] Indicador da Inscrição Estadual do contato

nome

text

[pt] Nome do contato

numerodocumento

text

[pt] CPF ou CNPJ do contato

orgaoemissor

text

[pt] Órgão Emissor do RG do contato

pais_nome

text

[pt] Nome do país do contato

rg

text

[pt] Registro Geral (RG) do contato

situacao

text

[pt] Situação do contato. A: Ativo; E: Excluido; I: Inativo; S: Sem movimentação

telefone

text

[pt] Telefone do contato

tipo

text

[pt] Tipo do contato (Física/Jurídica)

vendedor_id

text

[pt] Identificador do vendedor associado ao contato

    Vendedores > > id

bling_contatos_detalhes_pessoasContato

Campo Tipo

contato_id

text

[pt] Identificação do contato

pessoascontato_descricao

text

[pt] Descrição da pessoa de contato

pessoascontato_id

text

[pt] Identificador da pessoa de contato

bling_contatos_detalhes_tiposContato

Campo Tipo

contato_id

text

[pt] Identificação do contato

tiposcontato_descricao

text

[pt] Descrição do tipo de contato

tiposcontato_id

text

[pt] Identificador do tipo de contato

Depósitos

Campo Tipo

id

text

[pt] ID do deposito

desconsiderarsaldo

boolean

[pt] Indica se o saldo do depósito é desconsiderado (True ou False)

descricao

text

[pt] Descrição do depósito

padrao

boolean

[pt] Indica se o depósito é o padrão (True ou False)

situacao

float

[pt] Situação do depósito - 0: Inativo; 1: Ativo

Logísticas

Campo Tipo

id

text

[pt] ID da logística

descricao

text

[pt] Descrição da logística

integracao_id

text

[pt] ID da integração com a logística

integracaonativa

boolean

[pt] Indica se a integração é nativa (True ou False)

situacao

text

[pt] Situação da logística. H: Habilitado; D: Desabilitado

tipointegracao

text

[pt] Tipo da logística

Logísticas reversas

Campo Tipo

id

text

[pt] ID da logística

descricao

text

[pt] Descrição da logística

integracao_id

text

[pt] ID da integração com a logística

integracaonativa

boolean

[pt] Indica se a integração é nativa (True ou False)

situacao

text

[pt] Situação da logística. H: Habilitado; D: Desabilitado

tipointegracao

text

[pt] Tipo da logística

Logísticas reversas: detalhes

Objeto principal

Campo Tipo

id

text

[pt] ID da logística

    Logísticas reversas > > id

descricao

text

[pt] Descrição da logística

integracao_id

text

[pt] ID da integração com a logística

integracaonativa

boolean

[pt] Indica se a integração é nativa (True ou False)

situacao

text

[pt] Situação da logística. H: Habilitado; D: Desabilitado

tipointegracao

text

[pt] Tipo da logística

bling_logisticas_reversas_detalhes_servicos

Campo Tipo

logistica_id

text

[pt] ID da logística

servicos_aliases

text

[pt] Alias do serviço, separados por vírgula

servicos_codigo

text

[pt] Código do serviço

servicos_descricao

text

[pt] Descrição do serviço da logística

servicos_estimativaentrega

float

[pt] Será o prazo, em dias úteis, de entrega da mercadoria para esse serviço.

servicos_freteitem

float

[pt] Valor do frete que será calculado para cada item do pedido

servicos_id

text

[pt] ID do serviço da logística

servicos_transportador_id

text

[pt] ID do transportador do serviço da logística

    Contatos > > id

Categorias: lojas

Campo Tipo

id

text

[pt] ID da categoria-loja

categoriaproduto_id

text

[pt] ID da categoria de produto

    Categorias: produtos > > id

codigo

float

[pt] Código da categoria na loja

descricao

text

[pt] Categoria de produto vinculado à loja

loja_id

text

[pt] ID da loja associada à categoria

Categorias: produtos

Campo Tipo

id

text

[pt] ID da categoria-produto

categoriapai_id

text

[pt] ID da categoria pai do produto

    Categorias: produtos > > id

descricao

text

[pt] Descrição da categoria do produto

Categorias: receitas e despesas

Campo Tipo

id

text

[pt] ID da categoria de receitas e despesas

descricao

text

[pt] Descrição da categoria de receitas e despesas

idcategoriapai

text

    Categorias: receitas e despesas > > id

tipo

float

[pt] Tipo da categoria. 0: Todas; 1: Despesa; 2: Receita; 3: Receita e despesa

Contas contábeis

Campo Tipo

id

text

[pt] ID da conta contábil

aliasintegracao

text

descricao

text

[pt] Descrição da conta contábil

Formas de pagamento

Campo Tipo

id

text

[pt] ID da forma de pagamento

condicao

text

[pt] Condição de pagamento padrão (por exemplo, 1x, 2x, etc)

dadoscartao_bandeira

float

[pt] Bandeira do cartão. 1: Visa; 2: Mastercard; 3: American Express; 4: Sorocred; 5: Diners Club; 6: Elo; 7: Hipercard; 8: Aura; 9: Cabal; 99: Outros

dadoscartao_cnpjcredenciadora

text

[pt] CNPJ da credenciadora

dadoscartao_tipo

float

[pt] Tipo do cartão. 1: TEF; 2: POS

descricao

text

[pt] Situação da forma de pagamento. 0: Inativa; 1: Ativa

destino

float

[pt] Destino da forma de pagamento. 0: Conta a receber/pagar; 1: Ficha financeira; 2: Caixa e bancos

finalidade

float

[pt] Finalizade da forma de pagamento. 1: Pagamentos; 2: Recebimentos; 3: Pagamentos e Recebimentos

fixa

boolean

padrao

float

[pt] Padrão da forma de pagamento. 0: Não é padrão; 1: Padrão; 2: Padrão para devolução

situacao

float

taxas_aliquota

float

[pt] Valor da alíquota sobre o valor da parcela

taxas_prazo

float

[pt] Prazo em dias que o dinheiro é retido antes de estar disponível para movimentação

taxas_valor

float

[pt] Valor em Reais somado ao valor total da parcela

tipopagamento

float

[pt] Tipo do pagamento. 1: Dinheiro; 2: Cheque; 3: Cartão de Crédito; 4: Cartão de Débito; 5: Crédito Loja; 10: Vale Alimentação; 11: Vale Refeição; 12: Vale Presente; 13: Vale Combustível; 14: Duplicata Mercantil; 15: Boleto Bancário; 16: Depósito Bancário; 17: Pagamento Instantâneo (PIX); 18: Transferência Bancária, Carteira Digital; 19: Programa de Fidelidade, Cashback, Crédito Virtual; 90: Sem pagamento; 99: Outros

Informações dos campos customizados

Campo Tipo

id

text

[pt] ID do campo customizado

modulo_agrupador

text

[pt] Atributo do cadastro utilizado como agrupador

modulo_id

text

[pt] ID do módulo associado

modulo

text

[pt] Identificação do módulo

modulo_nome

text

[pt] Nome do módulo associado

nome

text

[pt] Nome do campo customizado

situacao

float

[pt] Situacao do campo customizado. 1: Ativo; 0: Inativo

Logísticas: detalhes

Objeto principal

Campo Tipo

id

text

[pt] ID da logística

    Logísticas > > id

descricao

text

[pt] Descrição da logística

integracao_id

text

[pt] ID da integração com a logística

integracaonativa

boolean

[pt] Indica se a integração é nativa (True ou False)

situacao

text

[pt] Situação da logística. H: Habilitado; D: Desabilitado

tipointegracao

text

[pt] Tipo da logística

bling_logisticas_detalhes_servicos

Campo Tipo

logistica_id

text

[pt] ID da logística

servicos_aliases

text

[pt] Alias do serviço, separados por vírgula

servicos_codigo

text

[pt] Código do serviço

servicos_descricao

text

[pt] Descrição do serviço da logística

servicos_estimativaentrega

float

[pt] Será o prazo, em dias úteis, de entrega da mercadoria para esse serviço.

servicos_freteitem

float

[pt] Valor do frete que será calculado para cada item do pedido

servicos_id

text

[pt] ID do serviço da logística

servicos_transportador_id

text

[pt] ID do transportador do serviço da logística

    Contatos > > id

NFe de entrada

Campo Tipo

id

text

[pt] Identificação da Nota Fiscal Eletronica

contato_email

text

[pt] Email do contato

contato_endereco_bairro

text

[pt] Bairro do endereço do contato

contato_endereco_cep

text

[pt] CEP do endereço do contato

contato_endereco_complemento

text

[pt] Complemento do endereço do contato

contato_endereco_endereco

text

[pt] Endereço do contato

contato_endereco_municipio

text

[pt] Município do endereço do contato

contato_endereco_numero

text

[pt] Número do endereço do contato

contato_endereco_uf

text

[pt] UF do endereço do contato

contato_id

text

[pt] Identificador do contato associado à Nota Fiscal Eletrônica

contato_ie

text

[pt] Inscrição Estadual do contato

contato_nome

text

[pt] Nome do contato associado à Nota Fiscal Eletrônica

contato_numerodocumento

text

[pt] Número do documento do contato

contato_rg

text

[pt] Registro Geral (RG) do contato

contato_telefone

text

[pt] Telefone do contato

dataemissao

timestamp

[pt] Data de emissão da Nota Fiscal Eletrônica

dataoperacao

timestamp

[pt] Data da operação da Nota Fiscal Eletrônica

loja_id

text

[pt] Identificador da loja associada à Nota Fiscal Eletrônica

numero

text

[pt] Número da Nota Fiscal Eletrônica

situacao

float

[pt] Situação da Nota Fiscal Eletrônica

NFe de entrada: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação da Nota Fiscal Eletronica

    NFe de entrada > > id

chaveacesso

text

[pt] Chave de acesso da Nota Fiscal Eletrônica

contato_email

text

[pt] Email do contato

contato_endereco_bairro

text

[pt] Bairro do endereço do contato

contato_endereco_cep

text

[pt] CEP do endereço do contato

contato_endereco_complemento

text

[pt] Complemento do endereço do contato

contato_endereco_endereco

text

[pt] Endereço do contato

contato_endereco_municipio

text

[pt] Município do endereço do contato

contato_endereco_numero

text

[pt] Número do endereço do contato

contato_endereco_uf

text

[pt] UF do endereço do contato

contato_id

text

[pt] Identificador do contato associado à Nota Fiscal Eletrônica

    Contatos > > id

contato_ie

text

[pt] Inscrição Estadual do contato

contato_nome

text

[pt] Nome do contato associado à Nota Fiscal Eletrônica

contato_numerodocumento

text

[pt] Número do documento do contato

contato_rg

text

[pt] Registro Geral (RG) do contato

contato_telefone

text

[pt] Telefone do contato

dataemissao

timestamp

[pt] Data de emissão da Nota Fiscal Eletrônica

dataoperacao

timestamp

[pt] Data da operação da Nota Fiscal Eletrônica

linkdanfe

text

[pt] Link para a visualização do DANFE da Nota Fiscal Eletrônica

linkpdf

text

[pt] Link para o arquivo PDF da Nota Fiscal Eletrônica

loja_id

text

[pt] Identificador da loja associada à Nota Fiscal Eletrônica

naturezaoperacao_id

text

[pt] Identificador da natureza da operação da Nota Fiscal Eletrônica

    Naturezas de operações > > id

numero

text

[pt] Número da Nota Fiscal Eletrônica

serie

text

[pt] Série da Nota Fiscal Eletrônica

situacao

float

[pt] Situação da Nota Fiscal Eletrônica

tipo

float

[pt] Tipo da Nota Fiscal Eletrônica

transporte_etiqueta_bairro

text

transporte_etiqueta_cep

text

transporte_etiqueta_complemento

text

transporte_etiqueta_endereco

text

transporte_etiqueta_municipio

text

transporte_etiqueta_nome

text

transporte_etiqueta_numero

text

transporte_etiqueta_uf

text

transporte_freteporconta

float

[pt] Indicativo de quem paga o frete

transporte_transportador_nome

text

transporte_transportador_numerodocumento

text

xml

text

[pt] Link para o arquivo XML da Nota Fiscal Eletrônica

bling_nfe_entrada_detalhes_transporte_volumes

Campo Tipo

nfe_id

text

[pt] Identificação da Nota Fiscal Eletronica

    NFe de entrada > > id

_transporte_volumes_id

text

[pt] Identificador dos volumes do transporte

NFe de saída

Campo Tipo

id

text

[pt] Identificação da Nota Fiscal Eletronica

contato_email

text

[pt] Email do contato

contato_endereco_bairro

text

[pt] Bairro do endereço do contato

contato_endereco_cep

text

[pt] CEP do endereço do contato

contato_endereco_complemento

text

[pt] Complemento do endereço do contato

contato_endereco_endereco

text

[pt] Endereço do contato

contato_endereco_municipio

text

[pt] Município do endereço do contato

contato_endereco_numero

text

[pt] Número do endereço do contato

contato_endereco_uf

text

[pt] UF do endereço do contato

contato_id

text

[pt] Identificador do contato associado à Nota Fiscal Eletrônica

contato_ie

text

[pt] Inscrição Estadual do contato

contato_nome

text

[pt] Nome do contato associado à Nota Fiscal Eletrônica

contato_numerodocumento

text

[pt] Número do documento do contato

contato_rg

text

[pt] Registro Geral (RG) do contato

contato_telefone

text

[pt] Telefone do contato

dataemissao

timestamp

[pt] Data de emissão da Nota Fiscal Eletrônica

dataoperacao

timestamp

[pt] Data da operação da Nota Fiscal Eletrônica

loja_id

text

[pt] Identificador da loja associada à Nota Fiscal Eletrônica

numero

text

[pt] Número da Nota Fiscal Eletrônica

situacao

float

[pt] Situação da Nota Fiscal Eletrônica

NFe de saída: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação da Nota Fiscal Eletronica

    NFe de saída > > id

chaveacesso

text

[pt] Chave de acesso da Nota Fiscal Eletrônica

contato_email

text

[pt] Email do contato

contato_endereco_bairro

text

[pt] Bairro do endereço do contato

contato_endereco_cep

text

[pt] CEP do endereço do contato

contato_endereco_complemento

text

[pt] Complemento do endereço do contato

contato_endereco_endereco

text

[pt] Endereço do contato

contato_endereco_municipio

text

[pt] Município do endereço do contato

contato_endereco_numero

text

[pt] Número do endereço do contato

contato_endereco_uf

text

[pt] UF do endereço do contato

contato_id

text

[pt] Identificador do contato associado à Nota Fiscal Eletrônica

    Contatos > > id

contato_ie

text

[pt] Inscrição Estadual do contato

contato_nome

text

[pt] Nome do contato associado à Nota Fiscal Eletrônica

contato_numerodocumento

text

[pt] Número do documento do contato

contato_rg

text

[pt] Registro Geral (RG) do contato

contato_telefone

text

[pt] Telefone do contato

dataemissao

timestamp

[pt] Data de emissão da Nota Fiscal Eletrônica

dataoperacao

timestamp

[pt] Data da operação da Nota Fiscal Eletrônica

linkdanfe

text

[pt] Link para a visualização do DANFE da Nota Fiscal Eletrônica

linkpdf

text

[pt] Link para o arquivo PDF da Nota Fiscal Eletrônica

loja_id

text

[pt] Identificador da loja associada à Nota Fiscal Eletrônica

naturezaoperacao_id

text

[pt] Identificador da natureza da operação da Nota Fiscal Eletrônica

    Naturezas de operações > > id

numero

text

[pt] Número da Nota Fiscal Eletrônica

serie

text

[pt] Série da Nota Fiscal Eletrônica

situacao

float

[pt] Situação da Nota Fiscal Eletrônica

tipo

float

[pt] Tipo da Nota Fiscal Eletrônica

transporte_etiqueta_bairro

text

transporte_etiqueta_cep

text

transporte_etiqueta_complemento

text

transporte_etiqueta_endereco

text

transporte_etiqueta_municipio

text

transporte_etiqueta_nome

text

transporte_etiqueta_numero

text

transporte_etiqueta_uf

text

transporte_freteporconta

float

[pt] Indicativo de quem paga o frete

transporte_transportador_nome

text

transporte_transportador_numerodocumento

text

xml

text

[pt] Link para o arquivo XML da Nota Fiscal Eletrônica

bling_nfe_saida_detalhes_transporte_volumes

Campo Tipo

nfe_id

text

[pt] Identificação da Nota Fiscal Eletronica

    NFe de entrada > > id

_transporte_volumes_id

text

[pt] Identificador dos volumes do transporte

Naturezas de operações

Campo Tipo

id

text

[pt] ID da natureza de operação

descricao

text

[pt] Descrição da natureza de operação

padrao

float

[pt] Padrão da natureza de operação. 0: Sem padrão; 1: Padrão venda; 2: Padrão compra; 3: Padrão venda física; 4: Padrão venda jurídica; 5: Padrão compra física; 6: Padrão compra jurídica; 7: Padrão venda cupom; 8: Padrão devolução (entrada); 9: Padrão devolução (saída)

situacao

float

[pt] Situação da natureza de operação. 0: Inativo; 1: Ativo

Pedidos de compra

Campo Tipo

id

text

    Pedidos de compra > > id

data

date

[pt] Data do pedido de compra

dataprevista

text

[pt] Data prevista de entrega do pedido de compra

fornecedor_id

text

[pt] Identificador do fornecedor do pedido de compra

numero

text

situacao_valor

float

[pt] Valor indicativo da situação do pedido de compra

total

float

[pt] Valor total do pedido de compra

totalprodutos

float

[pt] Valor total dos produtos no pedido de compra

Pedidos de compra: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação do pedido de compra

    Pedidos de compra > > id

categoria_id

text

[pt] Identificador da categoria do pedido de compra

data

date

[pt] Data do pedido de compra

dataprevista

text

[pt] Data prevista de entrega do pedido de compra

desconto_unidade

text

[pt] Unidade do valor do desconto (porcentagem ou real)

desconto_valor

float

[pt] Valor do desconto aplicado ao pedido

fornecedor_id

text

[pt] Identificador do fornecedor do pedido de compra

numero

text

[pt] Numero do pedido de compra

observacoes

text

[pt] Observações gerais sobre o pedido de compra

observacoesinternas

text

[pt] Observações internas do pedido de compra

ordemcompra

text

[pt] Número da ordem de compra associada ao pedido

situacao_valor

float

[pt] Valor indicativo da situação do pedido de compra

total

float

[pt] Valor total do pedido de compra

totalprodutos

float

[pt] Valor total dos produtos no pedido de compra

transporte_frete

float

[pt] Valor do frete do pedido

transporte_freteporconta

float

[pt] Indicativo de quem paga o frete (emitente ou destinatário)

transporte_pesobruto

float

[pt] Peso bruto total da mercadoria

transporte_transportador

text

[pt] Transportador utilizado no pedido

transporte_volumes

float

[pt] Total de volumes da mercadoria

tributacao_totalicms

float

[pt] Valor total de ICMS do pedido

tributacao_totalipi

float

[pt] Valor total de IPI do pedido

bling_pedidos_compra_detalhes_parcelas

Campo Tipo

pedido_compra_id

text

[pt] Identificação do pedido de compra

parcelas_datavencimento

date

[pt] Data de vencimento da parcela

parcelas_formapagamento_id

text

[pt] Identificador da forma de pagamento da parcela

parcelas_observacao

text

[pt] Observação sobre a parcela

parcelas_valor

float

[pt] Valor da parcela do pagamento

bling_pedidos_compra_detalhes_itens

Campo Tipo

pedido_compra_id

text

[pt] Identificador do pedido de compra

itens_aliquotaipi

float

[pt] Alíquota de IPI aplicada ao item

itens_codigofornecedor

text

[pt] Código do item fornecido pelo fornecedor

itens_descricao

text

[pt] Descrição dos itens do pedido

itens_descricaodetalhada

text

[pt] Descrição detalhada do item do pedido de compra

itens_produto_codigo

text

[pt] Código do produto no item

itens_produto_id

text

[pt] ID do produto no item

itens_quantidade

float

[pt] Quantidade do item no pedido

itens_unidade

text

[pt] Unidade de medida do item

itens_valor

float

[pt] Valor unitário do item

Pedidos de venda: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificador do pedido de venda

    Pedidos de venda > > id

categoria_id

text

[pt] Identificador da categoria do pedido de venda

contato_id

text

[pt] Identificador do contato associado ao pedido de venda

contato_nome

text

[pt] Nome do contato associado ao pedido de venda

contato_numerodocumento

text

[pt] Número do documento do contato

contato_tipopessoa

text

[pt] Tipo de pessoa do contato (Física/Jurídica)

data

date

[pt] Data de realização do pedido de venda

dataprevista

text

[pt] Data prevista para entrega do pedido de venda

datasaida

date

[pt] Data de saída do pedido de venda

desconto_unidade

text

[pt] Unidade do valor do desconto (porcentagem ou real)

desconto_valor

float

[pt] Valor do desconto aplicado ao pedido

intermediador_cnpj

text

[pt] CNPJ do intermediador da venda

intermediador_nomeusuario

text

[pt] Nome de usuário do intermediador da venda

loja_id

text

[pt] Identificador da loja do pedido de venda

notafiscal_id

text

[pt] Identificador da nota fiscal associada ao pedido

numero

text

[pt] Número do pedido de venda

numeroloja

text

[pt] Número da loja associada ao pedido de venda

numeropedidocompra

text

[pt] Número do pedido de compra associado

observacoes

text

[pt] Observações gerais sobre o pedido de venda

observacoesinternas

text

[pt] Observações internas sobre o pedido de venda

outrasdespesas

float

[pt] Total de outras despesas associadas ao pedido

situacao_id

text

[pt] Identificador da situação do pedido de venda

situacao_valor

float

[pt] Valor indicativo da situação do pedido de venda

taxas_custofrete

float

[pt] Custo do frete incluso na venda

taxas_taxacomissao

float

[pt] Taxa de comissão sobre a venda

taxas_valorbase

float

[pt] Valor base para cálculo das taxas

total

float

[pt] Valor total do pedido de venda

totalprodutos

float

[pt] Valor total dos produtos no pedido de venda

transporte_contato_id

text

[pt] Identificador do contato do transporte

transporte_contato_nome

text

[pt] Nome do contato do transporte

transporte_etiqueta_bairro

text

[pt] Bairro na etiqueta de transporte

transporte_etiqueta_cep

text

[pt] CEP na etiqueta de transporte

transporte_etiqueta_complemento

text

[pt] Complemento do endereço na etiqueta de transporte

transporte_etiqueta_endereco

text

[pt] Endereço na etiqueta de transporte

transporte_etiqueta_municipio

text

[pt] Município na etiqueta de transporte

transporte_etiqueta_nome

text

[pt] Nome na etiqueta de transporte

transporte_etiqueta_nomepais

text

[pt] Nome do país na etiqueta de transporte

transporte_etiqueta_numero

text

[pt] Número do endereço na etiqueta de transporte

transporte_etiqueta_uf

text

[pt] UF na etiqueta de transporte

transporte_frete

float

[pt] Valor do frete

transporte_freteporconta

float

[pt] Indicativo de quem paga o frete

transporte_pesobruto

float

[pt] Peso bruto total da carga

transporte_prazoentrega

float

[pt] Prazo de entrega do transporte

transporte_quantidadevolumes

float

[pt] Quantidade de volumes transportados

tributacao_totalicms

float

[pt] Valor total de ICMS do pedido

tributacao_totalipi

float

[pt] Valor total de IPI do pedido

vendedor_id

text

[pt] Identificador do vendedor do pedido de venda

bling_pedidos_venda_detalhes_transporte_volumes

Campo Tipo

pedido_venda_id

text

[pt] Identificador do pedido de venda

codigorastreamento

text

[pt] Código de rastreamento do volume de transporte

volumes_id

text

[pt] Identificador do volume de transporte

volumes_servico

text

[pt] Serviço de transporte do volume

bling_pedidos_venda_detalhes_itens

Campo Tipo

pedido_venda_id

text

[pt] Identificador do pedido de venda

itens_aliquotaipi

float

[pt] Alíquota de IPI aplicada sobre o item

itens_codigo

text

[pt] Código do item do pedido de venda

itens_comissao_base

float

[pt] Base de cálculo da comissão do item

itens_comissao_aliquota

float

[pt] Alíquota da comissão do item

itens_comissao_valor

float

[pt] Valor da comissão do item

itens_desconto

float

[pt] Desconto aplicado sobre o item

itens_descricao

text

[pt] Descrição do item

itens_descricaodetalhada

text

[pt] Descrição detalhada do item

itens_id

text

[pt] Identificador do item do pedido de venda

itens_produto_id

text

[pt] Identificador do produto do item

    Produtos > > id

itens_quantidade

float

[pt] Quantidade do item no pedido

itens_unidade

text

[pt] Unidade de medida do item do pedido

itens_valor

float

[pt] Valor do item

bling_pedidos_venda_detalhes_parcelas

Campo Tipo

pedido_venda_id

text

[pt] Identificador do pedido de venda

parcelas_datavencimento

date

[pt] Data de vencimento da parcela

parcelas_formapagamento_id

text

[pt] Identificador da forma de pagamento da parcela

parcelas_id

text

[pt] Identificador da parcela do pagamento

parcelas_observacoes

text

[pt] Observações sobre a parcela

parcelas_valor

float

[pt] Valor da parcela

Produtos

Campo Tipo

id

text

[pt] Identificação do produto

codigo

text

[pt] Código do produto

descricaocurta

text

[pt] Descrição curta do produto

formato

text

[pt] Formato do produto - S: Simples; V: Com variações; E: Com composição

imagemurl

text

[pt] Link da primeira imagem de acordo com tipo de armazenamento definido

nome

text

[pt] Nome do produto

preco

float

[pt] Preço de venda do produto

situacao

text

[pt] Situação do produto - A: Ativo; I: Inativo

tipo

text

[pt] Tipo do produto - S: Serviço; P: Produto; N: Serviço notas modelo 06, 21 e 22

Produtos: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação do produto

    Produtos > > id

actionestoque

text

[pt] Ação de estoque ao transformar produto Simples em Variação. Z: Irá zerar os saldos de estoque; T: Transfere o estoque do produto pai para a primeira variação informada

categoria_id

text

[pt] Identificador da categoria do produto

    Categorias: produtos > > id

codigo

text

[pt] Código do produto

condicao

float

[pt] Condição do produto. 0: Não especificado; 1: Novo; 2: Usado

datavalidade

date

[pt] Data de validade do produto

descricaocomplementar

text

[pt] Descrição complementar do produto

descricaocurta

text

[pt] Descrição curta do produto

descricaoembalagemdiscreta

text

[pt] Descrição discreta do produto para utilizar na declaração de conteúdo

dimensoes_altura

float

[pt] Altura do produto

dimensoes_largura

float

[pt] Largura do produto

dimensoes_profundidade

float

[pt] Profundidade do produto

dimensoes_unidademedida

float

[pt] Unidade de medida das dimensões do produto

estoque_crossdocking

float

[pt] Tempo (dias) de preparação do produto antes do envio

estoque_localizacao

text

[pt] Localização do produto no estoque

estoque_maximo

float

[pt] Quantidade máxima de estoque do produto

estoque_minimo

float

[pt] Quantidade mínima de estoque do produto

formato

text

[pt] Formato do produto - S: Simples; V: Com variações; E: Com composição

fretegratis

boolean

[pt] Indica se o produto possui frete grátis (True ou False)

gtin

text

[pt] Código GTIN (GTIN-8, GTIN-12, GTIN-13 ou GTIN-14) do produto que está sendo comercializado

gtinembalagem

text

[pt] Código GTIN (GTIN-8, GTIN-12 ou GTIN-13) da menor unidade comercializada no varejo

imagemurl

text

[pt] Link da primeira imagem de acordo com tipo de armazenamento definido

itensporcaixa

float

[pt] Quantidade de itens por caixa

linhaproduto_id

text

[pt] Identificador da linha do produto

linkexterno

text

[pt] Link externo do produto

marca

text

[pt] Marca do produto

midia_video_url

text

[pt] URL do vídeo do produto

nome

text

[pt] Nome do produto

observacoes

text

[pt] Observações do produto

pesobruto

float

[pt] Peso bruto em KG

pesoliquido

float

[pt] Peso líquido em KG

preco

float

[pt] Preço de venda do produto

situacao

text

[pt] Situação do produto - A: Ativo; I: Inativo

tipo

text

[pt] Tipo do produto - S: Serviço; P: Produto; N: Serviço notas modelo 06, 21 e 22

tipoproducao

text

[pt] Tipo da produção. P: Própria; T: Terceiros

tributacao_cest

text

[pt] Código CEST do produto

tributacao_classeenquadramentoipi

text

[pt] Classe de enquadramento do IPI para cigarros e bebidas

tributacao_codigoanp

text

[pt] Código ANP do produto

tributacao_codigoexcecaotipi

text

[pt] Código de exceção da TIPI

tributacao_codigoitem

text

[pt] Código do item de acordo com a tabela de produtos do contribuinte

tributacao_codigolistaservicos

text

[pt] Código da Lista de Serviços para o produto, se aplicável

tributacao_codigoseloipi

text

[pt] Código do selo de controle IPI

tributacao_dadosadicionais

text

[pt] Campo referente a tag infAdProd da nota fiscal

tributacao_descricaoanp

text

[pt] Descrição ANP do produto

tributacao_descricaocompletaarmamento

text

[pt] Descrição completa do armamento

tributacao_grupoproduto_id

text

[pt] Identificador do grupo do produto

tributacao_nfci

text

[pt] Número da FCI (Ficha de Conteúdo de Importação)

tributacao_ncm

text

[pt] Código NCM do produto

tributacao_origem

float

[pt] Origem do produto para fins tributários

tributacao_percentualglp

float

[pt] Percentual de Gás Liquefeito de Petróleo no produto

tributacao_percentualgasimportado

float

[pt] Percentual de gás natural importado no produto

tributacao_percentualgasnacional

float

[pt] Percentual de gás natural nacional no produto

tributacao_percentualtributos

float

[pt] Percentual de tributos incidentes sobre o produto

tributacao_spedtipoitem

text

[pt] Tipo do item conforme tabela do SPED

tributacao_tipoarmamento

float

[pt] Preencher quando a classificação do produto for armamento. 0: Uso permitido; 1: Uso restrito

tributacao_valorbasestretencao

float

[pt] Valor da base de cálculo de substituição tributária de retenção

tributacao_valorcofinsfixo

float

[pt] Valor fixo de COFINS por unidade de medida

tributacao_valoricmssubstituto

float

[pt] Valor do ICMS próprio do substituto

tributacao_valoripifixo

float

[pt] Valor fixo de IPI por unidade de medida

tributacao_valorpartida

float

[pt] Valor de partida, campo utilizado pela Zona Franca de Manaus

tributacao_valorpisfixo

float

[pt] Valor fixo de PIS por unidade de medida

tributacao_valorstretencao

float

[pt] Valor de substituição tributária de retenção

unidade

text

[pt] Unidade de medida do produto

volumes

float

[pt] Quantidade de volumes do produto

bling_produtos_detalhes_midia_imagens_internas

Campo Tipo

produto_id

text

[pt] Identificação do produto

_midia_imagens_internas_linkminiatura

text

[pt] Links das miniaturas das imagens internas do produto

_midia_imagens_internas_ordem

float

[pt] Ordem de exibição das miniaturas das imagens internas do produto

_midia_imagens_internas_validade

timestamp

[pt] Validade das miniaturas das imagens internas do produto

bling_produtos_detalhes_midia_imagens_externas

Campo Tipo

produto_id

text

[pt] Identificação do produto

_midia_imagens_externas_link

text

[pt] Links das imagens externas do produto

bling_produtos_detalhes_camposCustomizados

Campo Tipo

produto_id

text

[pt] Identificação do produto

camposcustomizados_idcampocustomizado

text

[pt] Identificador do campo customizado do produto

camposcustomizados_idvinculo

text

[pt] Identificador do vínculo para atualizar o valor do campo customizado

camposcustomizados_item

text

[pt] Item selecionado do campo customizado

camposcustomizados_valor

text

[pt] Valor do campo customizado

Produtos: estoque

Objeto principal

Campo Tipo

produto_id

text

[pt] ID do produto

    Produtos > > id

saldofisicototal

float

[pt] Saldo físico total do produto

saldovirtualtotal

float

[pt] Saldo total do produto desconsiderando produtos reservados

bling_produtos_estoque_depositos

Campo Tipo

produto_id

text

[pt] ID do produto

depositos_id

text

[pt] ID do depósito

    Depósitos > > id

depositos_saldofisico

float

[pt] Saldo físico do produto no depósito

depositos_saldovirtual

float

[pt] Saldo do produto desconsiderando produtos reservados no depósito

Produtos: estruturas

Objeto principal

Campo Tipo

produto_pai_id

text

[pt] Identificação do produto pai

    Produtos > > id

estrutura_lancamentoestoque

text

[pt] Lançamento de estoque. A: Produto e Componente; M: Componente; P: Produto

estrutura_tipoestoque

text

[pt] Tipo de estoque. F: Físico; V: Virtual

bling_produtos_estruturas_componentes

Campo Tipo

produto_pai_id

text

[pt] Identificação do produto pai

componentes_produto_id

text

[pt] Identificação do produto componente

    Produtos > > id

componentes_quantidade

float

[pt] Quantidade do produto componente na composição

Produtos: fornecedores

Campo Tipo

id

text

[pt] Identificação do relacionamento produto/fornecedor

fornecedor_id

text

[pt] Identificação do fornecedor

    Contatos > > id

produto_id

text

[pt] Identificação do produto

    Produtos > > id

codigo

text

[pt] Código do produto no fornecedor

descricao

text

[pt] Descrição do produto no fornecedor

padrao

boolean

[pt] Indica se é o fornecedor padrão do produto

precocompra

float

[pt] Valor de compra do produto

precocusto

float

[pt] Valor de compra do produto com rateio de frete, descontos e impostos

Produtos: lojas

Campo Tipo

id

text

[pt] Identificação do relacionamento produto/loja

codigo

text

[pt] Código do produto na loja virtual

fornecedorloja_id

text

[pt] ID do fornecedor na loja virtual

loja_id

text

[pt] ID da loja no Bling. Veja como obter este valor

marcaloja_id

text

[pt] ID da marca do produto na loja virtual

preco

float

[pt] Preço do produto na loja virtual

precopromocional

float

[pt] Preço promocional do produto na loja virtual

produto_id

text

[pt] ID do produto no Bling

    Produtos > > id

Produtos: variações

Campo Tipo

produto_pai_id

text

[pt] Identificação do produto pai

    Produtos > > id

produto_variacao_id

text

[pt] Identificação do produto variação

    Produtos > > id

variacao_nome

text

[pt] Nome da variação

variacao_ordem

int

[pt] Ordem de exibição da variação

produtopai_cloneinfo

boolean

[pt] Informação se a variação é um clone do produto pai

Situações dos módulos

Campo Tipo

situacao_id

text

[pt] ID da situação

situacao_cor

text

[pt] Cor associada à situação

situacao_idherdado

text

[pt] ID da situação herdada

situacao_nome

text

[pt] Nome da situação

modulo_criarsituacoes

boolean

[pt] Permite criar situações customizadas (True ou False)

modulo_descricao

text

[pt] Descrição do módulo

modulo_id

text

[pt] ID do módulo

modulo_nome

text

[pt] Nome do módulo

Vendedores

Campo Tipo

id

text

[pt] Identificação do vendedor

contato_id

text

[pt] Identificador do contato do vendedor

    Contatos > > id

contato_nome

text

[pt] Nome do contato do vendedor

contato_situacao

text

[pt] Situação do contato. A: Ativo, I: Inativo, S: Sem movimento, E: Excluído

descontolimite

float

[pt] Percentagem máxima para ceder como desconto, 0 para sem limite

loja_id

text

[pt] Identificador da loja associada ao vendedor

Vendedores: detalhes

Objeto principal

Campo Tipo

id

text

[pt] Identificação do vendedor

    Vendedores > > id

contato_id

text

[pt] Identificador do contato do vendedor

contato_nome

text

[pt] Nome do contato do vendedor

contato_situacao

text

[pt] Situação do contato. A: Ativo, I: Inativo, S: Sem movimento, E: Excluído

descontolimite

float

[pt] Percentagem máxima para ceder como desconto, 0 para sem limite

loja_id

text

[pt] Identificador da loja associada ao vendedor

bling_vendedores_detalhes_comissoes

Campo Tipo

vendedor_id

text

[pt] Identificação do vendedor

comissoes_aliquota

float

[pt] Alíquota de comissão para o vendedor

comissoes_descontomaximo

float

[pt] Desconto máximo permitido para comissão

Notas

ID da loja

O ID da loja não está disponível para leitura via API. Para obter o id da loja, você pode acessar sua conta do Bling! e clicar na engrenagem no canto superior direito > Configurações de integrações > Acesse uma loja > Veja o campo “Código da loja API Bling”

Descrição dos campos

Devido à ausência de descrição dos campos na documentação da API V3 do Bling!, grande parte das descrições foi gerada com inteligência artificial com exemplos dos valores retornados

Limites de API e integrações de detalhes

A API do Bling possui limites de requisições no tempo. Estes limites atualmente são de 3 requisições por segundo e 120mil requisições por dia. Estes limites são compartilhados por todos os seus aplicativos que consomem a API em sua conta. A Kondado lida com estes limites de forma transparente, mas eles podem fazer com que a leitura de dados de suas integrações seja um pouco mais demorada e afetar outros aplicativos. Isso se aplica principalmente a integrações do tipo “detalhes”, que fazem um número maior de requisições. Maneiras de contornar essa limitação da API são utilizar um savepoint mais recente e aguardar que uma integração realize sua carga histórica antes de iniciar outra.