bling_api 1.0.3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f58164e91badf85963b7bbf81e5274b61617e204697c7b1a4e718486789df5ef
-  data.tar.gz: 7c774ce59034b265e4da0272e2991df3bc1cd131d88eae34a3fc3c61d03c3975
+  metadata.gz: 8c36554ff0861c3cd2467333b5085abf0c3a8ab06a720dd6e184e7aaf107843d
+  data.tar.gz: b1cf370a7297d9fd8cb6b93c33c959a299c6850c545e501f6622715e9fd4a003
 SHA512:
-  metadata.gz: 7226d6c04e21c636984e5bfe83b6e26bbba52c34c02ad515253aaa4fd10d6a249d8fd29ef02673bdd6322946e2b0671345ee7bcdc3351b3447fca192d1775e11
-  data.tar.gz: 2b431d57a85d4013a7451742656491a1a0aec2618dd673c5b5518bbc4e8a7ce27712f229571011d712e899ff35c4028d3283fcb2b890a1eceb1189ace1065621
+  metadata.gz: 36d40b1644b4bc370673a66b90018a10593d8481787fa7458c301d72ef0609df5996c47b144561b3d21d4984017413d901d6199f441c8e21c2b5c973e27b8b54
+  data.tar.gz: 34171555cd7c7a60e54e4013b8b27195aebc932ef91441cb6f482129a805916015c551b743cd367e53cbbc9f42eabd3bb71348883f2350adb106b0a48578d97e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bling_api (1.0.3)
+    bling_api (2.0.0)
       ac
       base64
 

data/lib/bling_api/client.rb

@@ -3,71 +3,298 @@ module BlingApi
     BASE_URL = "https://www.bling.com.br/Api/v3"
     SAVE_RESPONSES = true
 
-    attr_reader :access_token
-    def initialize(access_token = nil)
-      @headers = {
-        "Content-Type": "application/json"
+    def initialize(client_id:, client_secret:, refresh_token: nil, access_token: nil, token_expires_at: nil)
+      @client_id = client_id
+      @client_secret = client_secret
+      @refresh_token = refresh_token
+      @access_token = access_token
+      @token_expires_at = token_expires_at
+    end
+
+    def refresh_token
+      headers = {
+        "Content-Type" => "application/x-www-form-urlencoded",
+        "Authorization" => "Basic #{Base64.strict_encode64("#{@client_id}:#{@client_secret}")}"
       }
-      super(access_token)
+      body = "grant_type=refresh_token&refresh_token=#{@refresh_token}"
+      response = post("/oauth/token", body:, headers:, skip_authentication: true)
+      @access_token = response.access_token
+      @refresh_token = response.refresh_token
+      @token_expires_at = Time.now + response.expires_in
     end
 
-    def update_contact(contact_id, body)
-      put("/contatos/#{contact_id}", body: body, headers: @headers) { |response| validate_response(response, "") }
+    def authorize(code:)
+      headers = {
+        "Content-Type" => "application/x-www-form-urlencoded",
+        "Authorization" => "Basic #{Base64.strict_encode64("#{@client_id}:#{@client_secret}")}"
+      }
+      body = "grant_type=authorization_code&code=#{code}"
+      response = post("/oauth/token", body:, headers:, skip_authentication: true)
+      @access_token = response.access_token
+      @refresh_token = response.refresh_token
+      @token_expires_at = Time.now + response.expires_in
     end
 
-    def get_order(order_id)
-      response = get("/pedidos/vendas/#{order_id}") { |response| validate_response(response, "data") }
-      response.json["data"]
+    def get_refresh_token
+      @refresh_token
     end
 
-    def get_contact(contact_id)
-      response = get("/contatos/#{contact_id}") { |response| validate_response(response, "data") }
-      response.json["data"]
+    def update_contact(
+      id:,
+      nome: nil,
+      pessoa_juridica: nil,
+      numero_documento: nil,
+      situacao: nil,
+      codigo: nil,
+      rg: nil,
+      orgao_emissor: nil,
+      telefone: nil,
+      celular: nil,
+      email: nil,
+      endereco: nil,
+      endereco_cep: nil,
+      endereco_bairro: nil,
+      endereco_municipio: nil,
+      endereco_uf: nil,
+      endereco_numero: nil,
+      endereco_complemento: nil,
+      endereco_cob: nil,
+      endereco_cob_cep: nil,
+      endereco_cob_bairro: nil,
+      endereco_cob_municipio: nil,
+      endereco_cob_uf: nil,
+      endereco_cob_numero: nil,
+      endereco_cob_complemento: nil,
+      cod_contribuinte: nil,
+      ie: nil,
+      fantasia: nil,
+      limite_credito: nil,
+      condicao_pagamento: nil,
+      financeiro_categoria_id: nil,
+      pais: nil,
+      tipos_contato: nil,
+      pessoas_contato: nil,
+      id_vendedor: nil,
+      dados_adicionais: nil
+    )
+      contact = get_contact(id).data
+      body = {
+        nome: nome || contact.nome,
+        telefone: telefone ? telefone.gsub(/^\+55/, "") : contact.telefone,
+        celular: celular ? celular.gsub(/^\+55/, "") : contact.celular,
+        codigo: codigo || contact.codigo,
+        tipo: pessoa_juridica ? pessoa_juridica ? "J" : "F" : contact.tipo,
+        indicadorIe: cod_contribuinte || contact.indicadorIe,
+        ie: ie || contact.ie,
+        numeroDocumento: numero_documento || contact.numeroDocumento,
+        orgaoEmissor: orgao_emissor || contact.orgaoEmissor,
+        rg: rg || contact.rg,
+        fantasia: fantasia || contact.fantasia,
+        email: email || contact.email,
+        situacao: situacao || contact.situacao,
+        vendedor: {
+          id: id_vendedor || contact.vendedor.id,
+        },
+        dadosAdicionais: dados_adicionais || contact.dadosAdicionais,
+        pais: pais || contact.pais,
+        tiposContato: tipos_contato || contact.tiposContato,
+        pessoasContato: pessoas_contato || contact.pessoasContato,
+        financeiro: {
+          limite_credito: limite_credito || contact.financeiro.limiteCredito,
+          condicao_pagamento: condicao_pagamento || contact.financeiro.condicaoPagamento,
+          categoria: {
+            id: financeiro_categoria_id || contact.financeiro.categoria.id
+          }
+        },
+        endereco: {
+          geral: {
+            endereco: endereco || contact.endereco.geral.endereco,
+            cep: endereco_cep || contact.endereco.geral.cep,
+            bairro: endereco_bairro || contact.endereco.geral.bairro,
+            municipio: endereco_municipio || contact.endereco.geral.municipio,
+            uf: endereco_uf || contact.endereco.geral.uf,
+            numero: endereco_numero || contact.endereco.geral.numero,
+            complemento: endereco_complemento || contact.endereco.geral.complemento
+          },
+          cobranca: {
+            endereco: endereco_cob || contact.endereco.geral.endereco,
+            cep: endereco_cob_cep || contact.endereco.geral.cep,
+            bairro: endereco_cob_bairro || contact.endereco.geral.bairro,
+            municipio: endereco_cob_municipio || contact.endereco.geral.municipio,
+            uf: endereco_cob_uf || contact.endereco.geral.uf,
+            numero: endereco_cob_numero || contact.endereco.geral.numero,
+            complemento: endereco_cob_complemento || contact.endereco.geral.complemento
+          }
+        }
+      }
+      put("/contatos/#{id}", body: body)
     end
 
-    def get_seller(seller_id)
-      response = get("/vendedores/#{seller_id}") { |response| validate_response(response, "data") }
-      response.json["data"]
+    def get_order(id)
+      get("/pedidos/vendas/#{id}") { _1.data }
     end
 
-    def get_sellers(page, limit, situation)
-      response = get("/vendedores?pagina=#{page}&limite=#{limit}&situacaoContato=#{situation}") { |response| validate_response(response, "data") }
-      response.json["data"]
+    def get_contact(id)
+      get("/contatos/#{id}") { _1.data }
     end
 
-    def find_contact_by_document_number(document_number)
-      response = get("/contatos?numeroDocumento=#{document_number.gsub(/\D/, "")}") { |response| validate_response(response, "data") }
-      response.json["data"].first
+    def get_seller(id)
+      get("/vendedores/#{id}") { _1.data }
     end
 
-    def find_product_by_sku(sku)
-      response = get("/produtos?codigo=#{sku}") { |response| validate_response(response, "data") }
-      response.json["data"].first
+    def get_sellers(page, limit, situation)
+      get("/vendedores?pagina=#{page}&limite=#{limit}&situacaoContato=#{situation}") { _1.data }
     end
 
-    def create_contact(body)
-      response = post("/contatos", body: body, headers: @headers) { |response| validate_response(response, "data") }
-      response.json["data"]
+    def find_contact_by_document_number(document_number)
+      get("/contatos?numeroDocumento=#{document_number.gsub(/\D/, "")}") { _1.data }
     end
 
-    def create_order(body)
-      response = post("/pedidos/vendas", body: body, headers: @headers) { |response| validate_response(response, "data") }
-      response.json["data"]
+    def find_product_by_sku(sku)
+      get("/produtos?codigo=#{sku}") { _1.data }
     end
 
-    def refresh_token(client_id:, client_secret:, refresh_token:)
-      headers = {
-        "Content-Type": "application/x-www-form-urlencoded",
-        Authorization: "Basic #{Base64.strict_encode64("#{client_id}:#{client_secret}")}"
+    def create_contact(
+      nome:,
+      pessoa_juridica:,
+      numero_documento:,
+      situacao:,
+      codigo: nil,
+      rg: nil,
+      orgao_emissor: nil,
+      id: nil,
+      telefone: nil,
+      celular: "",
+      email: "",
+      endereco: nil,
+      endereco_cep: nil,
+      endereco_bairro: nil,
+      endereco_municipio: nil,
+      endereco_uf: nil,
+      endereco_numero: nil,
+      endereco_complemento: nil,
+      endereco_cob: nil,
+      endereco_cob_cep: nil,
+      endereco_cob_bairro: nil,
+      endereco_cob_municipio: nil,
+      endereco_cob_uf: nil,
+      endereco_cob_numero: nil,
+      endereco_cob_complemento: nil,
+      cod_contribuinte: nil,
+      ie: nil,
+      fantasia: nil,
+      limite_credito: nil,
+      condicao_pagamento: nil,
+      financeiro_categoria_id: nil,
+      pais: nil,
+      tipos_contato: nil,
+      pessoas_contato: nil,
+      vendedor: nil,
+      dados_adicionais: nil
+    )
+      body = {
+        nome: nome,
+        tipo: pessoa_juridica ? "J" : "F",
+        numeroDocumento: numero_documento,
+        situacao: situacao,
+        codigo: codigo,
+        telefone: telefone.gsub(/^\+55/, ""),
+        celular: celular.gsub(/^\+55/, ""),
+        indicadorIe: cod_contribuinte,
+        ie: ie,
+        orgaoEmissor: orgao_emissor,
+        rg: rg,
+        fantasia: fantasia,
+        email: email,
+        vendedor: vendedor,
+        dadosAdicionais: dados_adicionais,
+        pais: pais,
+        tiposContato: tipos_contato,
+        pessoasContato: pessoas_contato,
+        financeiro: {
+          limite_credito: limite_credito,
+          condicao_pagamento: condicao_pagamento,
+          categoria: {
+            id: financeiro_categoria_id
+          }
+        },
+        endereco: {
+          geral: {
+            endereco: endereco,
+            cep: endereco_cep,
+            bairro: endereco_bairro,
+            municipio: endereco_municipio,
+            uf: endereco_uf,
+            numero: endereco_numero,
+            complemento: endereco_complemento
+          },
+          cobranca: {
+            endereco: endereco_cob,
+            cep: endereco_cob_cep,
+            bairro: endereco_cob_bairro,
+            municipio: endereco_cob_municipio,
+            uf: endereco_cob_uf,
+            numero: endereco_cob_numero,
+            complemento: endereco_cob_complemento
+          }
+        }
       }
-      body = "grant_type=refresh_token&refresh_token=#{refresh_token}"
-      response = post("/oauth/token", body: body, headers: headers) { |response| validate_response(response, "refresh_token") }
-      response.json
+      post("/contatos", body: body) { _1.data }
     end
 
-    def validate_response(response, required_response_key)
-      puts response.json unless response.success?
-      ![500, 429].include?(response.code) || response.json.dig(*required_response_key)
+     # @param itens [Array<BlingApi::Item>] Array de objetos Item contendo codigo, id_produto, quantidade, valor, unidade, desconto, aliquota_ipi, descricao, descricao_detalhada, comissao_base, comissao_aliquota, comissao_valor
+     # @param parcelas [Array<BlingApi::Installment>] Array de objetos Installment contendo id_forma_pagamento, valor, data_vencimento, observacoes, id
+     # @param transporte [<BlingApi::Shipment>] Objeto Shipment contendo valor_frete, frete_por_conta, quantidade_volumes, nome_transportadora, nome_etiqueta, endereco, numero, complemento, municipio, uf, bairro, cep, pais, nome_servico, codigo_rastreio
+     # @param numero_venda É o número do pedido de venda no Bling
+     # @param numero_pedido É o número do pedido na loja virtual ou marketplace, exemplo: R123456
+    def create_order(
+      data:,
+      id_contato:,
+      itens:,
+      numero_venda: nil,
+      numero_pedido: nil,
+      id_loja: nil,
+      id_vendedor: nil,
+      pessoa_juridica: nil,
+      numero_documento: nil,
+      parcelas: [],
+      id_categoria_receita: nil,
+      observacoes: "",
+      observacoes_internas: "",
+      valor_desconto: 0,
+      numero_pedido_compra: nil,
+      transporte: nil
+    )
+      body = {
+        numero: numero_venda,
+        numeroLoja: numero_pedido,
+        data: data,
+        loja: {
+          id: id_loja
+        },
+        contato: {
+          id: id_contato,
+          tipoPessoa: pessoa_juridica ? "J" : "F",
+          numeroDocumento: numero_documento
+        },
+        itens: itens.map(&:to_api_hash),
+        vendedor: {
+          id: id_vendedor
+        },
+        categoria: {
+          id: id_categoria_receita
+        },
+        parcelas: parcelas.map(&:to_api_hash),
+        transporte: transporte&.to_api_hash,
+        desconto: {
+          valor: valor_desconto,
+          unidade: "REAL"
+        },
+        observacoes: observacoes,
+        observacoesInternas: observacoes_internas,
+        numeroPedidoCompra: numero_pedido_compra
+      }
+      post("/pedidos/vendas", body: body) { _1.data }
     end
   end
 end

data/lib/bling_api/installment.rb

@@ -0,0 +1,25 @@
+module BlingApi
+  class Installment
+    
+    attr_reader :id_forma_pagamento, :valor, :data_vencimento, :observacoes, :id
+    def initialize(id_forma_pagamento:, valor:, data_vencimento:, observacoes: "", id: nil)
+      @id_forma_pagamento = id_forma_pagamento
+      @valor = valor
+      @data_vencimento = data_vencimento
+      @observacoes = observacoes
+      @id = id
+    end
+
+    def to_api_hash
+      {
+        id: id,
+        dataVencimento: data_vencimento,
+        valor: valor,
+        observacoes: observacoes,
+        formaPagamento: {
+          id: id_forma_pagamento
+        }
+      }
+    end
+  end
+end

data/lib/bling_api/item.rb

@@ -0,0 +1,41 @@
+module BlingApi
+  class Item
+    
+    attr_reader :codigo, :id_produto, :quantidade, :valor, :unidade, :desconto, :aliquota_ipi, :descricao, :descricao_detalhada, :comissao_base, :comissao_aliquota, :comissao_valor
+    def initialize(id_produto:, codigo:, quantidade:, valor:, unidade: nil, desconto: nil, aliquota_ipi: nil, descricao: nil, descricao_detalhada: nil, comissao_base: nil, comissao_aliquota: nil, comissao_valor: nil)
+      @codigo = codigo
+      @id_produto = id_produto
+      @quantidade = quantidade
+      @valor = valor
+      @unidade = unidade
+      @desconto = desconto
+      @aliquota_ipi = aliquota_ipi
+      @descricao = descricao
+      @descricao_detalhada = descricao_detalhada
+      @comissao_base = comissao_base
+      @comissao_aliquota = comissao_aliquota
+      @comissao_valor = comissao_valor
+    end
+
+    def to_api_hash
+      {
+        codigo: codigo,
+        unidade: unidade,
+        quantidade: quantidade,
+        desconto: desconto,
+        valor: valor,
+        aliquotaIPI: aliquota_ipi,
+        descricao: descricao,
+        descricao_detalhada: descricao_detalhada,
+        produto: {
+          id: id_produto
+        },
+        comissao: {
+          base: comissao_base,
+          aliquota: comissao_aliquota,
+          valor: comissao_valor
+        }
+      }
+    end
+  end
+end

data/lib/bling_api/shipment.rb

@@ -0,0 +1,52 @@
+module BlingApi
+  class Shipment
+    attr_reader :valor_frete, :frete_por_conta, :quantidade_volumes, :peso_bruto_kg, :nome_transportadora, :nome_etiqueta, :endereco, :numero, :complemento, :municipio, :uf, :bairro, :cep, :pais, :nome_servico, :codigo_rastreio
+    def initialize(valor_frete:, nome_transportadora:, frete_por_conta: nil, quantidade_volumes: nil, peso_bruto_kg: nil, nome_etiqueta: nil, endereco: nil, numero: nil, complemento: nil, municipio: nil, uf: nil, bairro: nil, cep: nil, pais: nil, nome_servico: nil, codigo_rastreio: nil)
+      @valor_frete = valor_frete
+      @frete_por_conta = frete_por_conta
+      @quantidade_volumes = quantidade_volumes
+      @peso_bruto_kg = peso_bruto_kg
+      @nome_transportadora = nome_transportadora
+      @nome_etiqueta = nome_etiqueta
+      @endereco = endereco
+      @numero = numero
+      @complemento = complemento
+      @municipio = municipio
+      @uf = uf
+      @bairro = bairro
+      @cep = cep
+      @pais = pais
+      @nome_servico = nome_servico
+      @codigo_rastreio = codigo_rastreio
+    end
+
+    def to_api_hash
+      {
+        fretePorConta: frete_por_conta,
+        frete: valor_frete,
+        quantidadeVolumes: quantidade_volumes,
+        pesoBruto: peso_bruto_kg,
+        contato: {
+          nome: nome_transportadora
+        },
+        etiqueta: {
+          nome: nome_etiqueta,
+          endereco: endereco,
+          numero: numero,
+          complemento: complemento,
+          municipio: municipio,
+          uf: uf,
+          bairro: bairro,
+          cep: cep,
+          nomePais: pais
+        },
+        volumes: [
+          {
+            servico: nome_servico,
+            codigoRastreamento: codigo_rastreio
+          }
+        ]
+      }
+    end
+  end
+end

data/lib/bling_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BlingApi
-  VERSION = "1.0.3"
+  VERSION = "2.0.0"
 end

data/lib/bling_api.rb

@@ -5,10 +5,13 @@ require "base64"
 require "active_support/core_ext/hash/indifferent_access"
 require_relative "bling_api/version"
 require_relative "bling_api/client"
-require_relative "bling_api/customer"
-require_relative "bling_api/order"
-require_relative "bling_api/product"
-require_relative "bling_api/seller"
+# require_relative "bling_api/customer" # Deixamos de usar
+# require_relative "bling_api/order" # Deixamos de usar
+# require_relative "bling_api/product" # Deixamos de usar
+# require_relative "bling_api/seller" # Deixamos de usar
+require_relative "bling_api/item"
+require_relative "bling_api/installment"
+require_relative "bling_api/shipment"
 
 module BlingApi
   class Error < StandardError; end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bling_api
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 2.0.0
 platform: ruby
 authors:
 - caio
 bindir: exe
 cert_chain: []
-date: 2025-06-04 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -51,9 +51,12 @@ files:
 - lib/bling_api.rb
 - lib/bling_api/client.rb
 - lib/bling_api/customer.rb
+- lib/bling_api/installment.rb
+- lib/bling_api/item.rb
 - lib/bling_api/order.rb
 - lib/bling_api/product.rb
 - lib/bling_api/seller.rb
+- lib/bling_api/shipment.rb
 - lib/bling_api/version.rb
 - lib/generators/bling_api/install/install_generator.rb
 - lib/generators/bling_api/install/templates/initializer.rb
@@ -77,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: ''
 test_files: []