bling_api 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7660ede0b54064fd04c509c67fd578f9366b0f72d4a27b367b89738725234b3
-  data.tar.gz: eaac49092264042c1f125973c75faa62e1b7b9f9df95cede03d22c87c68cc526
+  metadata.gz: 735aea047eb407f37c037ab030f21ab13eec0f874c0060c1f5a13de14d122358
+  data.tar.gz: 161cc0f05caaeb6e076f4e6a927960f17e8082d36cdace8de3ea4416bdc7af4e
 SHA512:
-  metadata.gz: e4487f802f3fb8d64cd73545964007f2df58aa7f830fb712ca3ee462c9ab3413e5e6eeaac6d5c25a8b6c661c840ab294068349ad062e7934ed64a94b9d71bb07
-  data.tar.gz: 0ce79f0fcb362ad8b93092801e268ddf210efec6fe08dce520a24fdf3d8f76090dfd8b5718e5111783d299a2dbd61e6d5cb4a3695e676c58f9f10df598b0377e
+  metadata.gz: bdebc58ab7ace6955a016f8bdd19f4080b44cc39fd5db06b194bed2cc271b5dc3cebdf9d6d7547858ac0219935a6a9cf7ac48f8a2bb48f19e2004a86ff4a792c
+  data.tar.gz: 969908c5a187bca1e628f6fa7c8d296cf359ab9533181f2bce56dba7a40c9f3ff7fdcd5625a8bc84703aa0f2ad5bd0af2ce08d397e806ad602c18da01f336bcb

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    bling_api (0.2.0)
+    bling_api (1.0.2)
       ac
       base64
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ac (0.1.1)
+    ac (0.2.0)
       typhoeus
     attr_extras (7.1.0)
     base64 (0.2.0)
@@ -33,6 +33,7 @@ GEM
 
 PLATFORMS
   arm64-darwin-22
+  arm64-darwin-23
   x86_64-linux
 
 DEPENDENCIES

data/README.md

@@ -1,37 +1,120 @@
 # BlingApi
 
-TODO: Delete this and the text below, and describe your gem
+Wrapper de integração com a API v3 do ERP Bling!.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/bling_api`. To experiment with that code, run `bin/console` for an interactive prompt.
+[Documentação API v3 Bling!](https://developer.bling.com.br/bling-api)
 
-## Installation
+### Funcionalidades:
+- Clientes: create, update, find_by_id, find_by_tax_id (CPF/CNPJ)
+- Pedido de venda: create, find_by_id
+- Produtos: find_by_sku
+- Vendedores: get_sellers (listagem), find_by_id
 
-Add bling_api to your Gemfile:
+## Instalação
+
+Adicionar bling_api no Gemfile:
 
 ```ruby
 gem 'bling_api'
 ```
+ou
+```shell
+bundle add bling_api
+```
 
-Bundle your dependencies and run the installation generator:
+Instalar a gem:
 
 ```shell
 bin/rails generate bling_api:install
 ```
 
-## Usage
-
-TODO: Write usage instructions here
+## Uso
 
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
+Configurar access_token no initializer ou direto no código:
+```ruby
+BlingApi.configure do |config|
+  config.access_token = "ACCESS_TOKEN"
+end
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/bling_api.
+### Exemplos
 
-## License
+#### Token
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+```ruby
+api_client = BlingApi::Client.new.refresh_token(client_id: "123456", client_secret: "101112131415", refresh_token: "abcde12345")
+#retorna o JSON da resposta
+puts api_client["access_token"] # "a1b2c3d4e5"
+puts api_client["expires_in"] # 21600
+```
+#### Produto
+```ruby
+# Encontrar um produto a partir do SKU
+product = BlingApi::Product.find_by_sku("123456")
+puts product.sku # "123456"
+```
+#### Pedido de venda
+```ruby
+# Instancia o objeto
+order = BlingApi::Order.new(
+  id_contato: 16693257776,
+  items: [{
+    id: 16219735350,
+    quantidade: 1,
+    valor: 20.25,
+    produto: {
+      id: 16219735350
+    }
+  }],
+  parcelas: [{
+    dataVencimento: "2024-06-06",
+    valor: 20.25,
+    formaPagamento: {
+      id: 4776248
+    }
+  }],
+  numero_loja: "ABC-123",
+  data: "2024-06-06",
+  total_produtos: 20.25,
+  total: 20.25,
+  id_loja: 204683421,
+  numero_pedido_compra: "ABC-123",
+  observacoes: "Observação",
+  observacoes_internas: "Obervação interna",
+  valor_desconto: 0.00,
+  id_categoria: 14653794318,
+  transporte: {
+    fretePorConta: 1,
+    frete: 0.00,
+    quantidadeVolumes: 1,
+    contato: {
+      nome: "LOGISTICA S.A"
+    },
+    etiqueta: {
+      nome: "João da Silva",
+      endereco: "Rua da Saudade",
+      numero: "120",
+      complemento: "",
+      municipio: "São Paulo",
+      uf: "SP",
+      bairro: "Centro",
+      cep: "01002010",
+      nomePais: "Brasil"
+    },
+    volumes: [
+      {
+        servico: "SEDEX",
+        codigoRastreamento: ""
+      }
+    ]
+  },
+  id_vendedor: 15596298834,
+  pessoa_juridica: false, 
+  numero_documento: "123.123.123-87"
+)
+
+# Cria o pedido de venda
+created_order = order.create
+
+puts created_order.numero # 102030
+```

data/lib/bling_api/client.rb

@@ -1,6 +1,8 @@
 module BlingApi
   class Client < Ac::Base
     BASE_URL = "https://www.bling.com.br/Api/v3"
+    SAVE_RESPONSES = true
+
     attr_reader :access_token
     def initialize(access_token = nil)
       @headers = {
@@ -10,46 +12,46 @@ module BlingApi
     end
 
     def update_contact(contact_id, body)
-      response = put("/contatos/#{contact_id}", body: body, headers: @headers) { _1.code == 204 }
+      put("/contatos/#{contact_id}", body: body, headers: @headers) { |response| validate_response(response, "") }
     end
 
     def get_order(order_id)
-      response = get("/pedidos/vendas/#{order_id}") { _1.json["data"] }
+      response = get("/pedidos/vendas/#{order_id}") { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
     def get_contact(contact_id)
-      response = get("/contatos/#{contact_id}") { _1.json["data"] }
+      response = get("/contatos/#{contact_id}") { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
     def get_seller(seller_id)
-      response = get("/vendedores/#{seller_id}") { _1.json["data"] }
+      response = get("/vendedores/#{seller_id}") { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
     def get_sellers(page, limit, situation)
-      response = get("/vendedores?pagina=#{page}&limite=#{limit}&situacaoContato=#{situation}") { _1.json["data"] }
+      response = get("/vendedores?pagina=#{page}&limite=#{limit}&situacaoContato=#{situation}") { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
     def find_contact_by_document_number(document_number)
-      response = get("/contatos?numeroDocumento=#{document_number.gsub(/\D/, "")}") { _1.json["data"] }
+      response = get("/contatos?numeroDocumento=#{document_number.gsub(/\D/, "")}") { |response| validate_response(response, "data") }
       response.json["data"].first
     end
 
     def find_product_by_sku(sku)
-      response = get("/produtos?codigo=#{sku}") { _1.json["data"] }
+      response = get("/produtos?codigo=#{sku}") { |response| validate_response(response, "data") }
       response.json["data"].first
     end
 
     def create_contact(body)
-      response = post("/contatos", body: body, headers: @headers) { _1.json["data"] }
+      response = post("/contatos", body: body, headers: @headers) { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
     def create_order(body)
-      response = post("/pedidos/vendas", body: body, headers: @headers) { _1.json["data"] }
+      response = post("/pedidos/vendas", body: body, headers: @headers) { |response| validate_response(response, "data") }
       response.json["data"]
     end
 
@@ -59,8 +61,13 @@ module BlingApi
         Authorization: "Basic #{Base64.strict_encode64("#{client_id}:#{client_secret}")}"
       }
       body = "grant_type=refresh_token&refresh_token=#{refresh_token}"
-      response = post("/oauth/token", body: body, headers: headers) { _1.json["refresh_token"] }
+      response = post("/oauth/token", body: body, headers: headers) { |response| validate_response(response, "refresh_token") }
       response.json
     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)
+    end
   end
 end

data/lib/bling_api/customer.rb

@@ -102,8 +102,6 @@ module BlingApi
       self.class.find_by_id(response["id"])
     end
 
-    private
-
     def self.build_hash json_response
       {
         id: json_response["id"],

data/lib/bling_api/order.rb

@@ -65,8 +65,6 @@ module BlingApi
       self.class.find_by_id(response["id"])
     end
 
-    private
-
     def self.build_hash json_response
       {
         id: json_response["id"],

data/lib/bling_api/product.rb

@@ -14,8 +14,6 @@ module BlingApi
       @sku = sku
     end
 
-    private
-
     def self.build_hash json_response
       {
         id: json_response["id"],

data/lib/bling_api/seller.rb

@@ -27,8 +27,6 @@ module BlingApi
       @situacao = situacao
     end
 
-    private
-
     def self.build_hash json_response
       {
         id: json_response.dig("id"),

data/lib/bling_api/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bling_api
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - caio
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-16 00:00:00.000000000 Z
+date: 2024-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.10
 signing_key:
 specification_version: 4
 summary: ''