conexa 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '050626980d9f896ca2c70ed30a27c1cfda7d0d30c89e25c90e86422d122fb1af'
-  data.tar.gz: 43134221ca4dd8f38bc3f8a62bfffe2807d1565e949e2adf72d446fa14db01cf
+  metadata.gz: b1dba13ee9b0dc841e758d5cb0b9c468a480ca564129666814c0e25892ea4cff
+  data.tar.gz: 732eebd11f3ec3b5ee727f030ac51493fbce0e6212fb510dfcf5ba476d6424c4
 SHA512:
-  metadata.gz: 298ef626afb7783dff6d66161e20ff4b28b30b0d81761ce3f5debf187f1d60e0d01814004d3372ad6531b5e40e22e110af471522bbc577e3c0baac63dfb17014
-  data.tar.gz: 768fbc470c103074ff5b768bf78ba6ed47385c4d06a7cadba7aed395947da92c73756c8f72c06e66be15520974c7f0c2e8438dfc567181cc83357416cad251d5
+  metadata.gz: c45016bd74d1e830ae18915be67be0f5a5e5dfc87581a9fe6685775b83c0aa08a4b8a10389d1ae9c92bfbffbf1b1b076b244c736c74002688f6be84e4115f02e
+  data.tar.gz: ff7831e660833da76d85325532889590d27f60451747980427ce7e2d8f7f5e48ec02960d5fdad5bfb5ea7abadab9fdec19e6e30c5bb2adbc0be2e9527680ec3b

data/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.9] - 2026-03-30
+
+### Added
+- **New pagination model**: `limit`/`offset`/`hasNext` — more efficient, avoids calculating total records
+  - Pass `limit:` to any `.all` or `.find_by` to use the new pagination
+  - Old `page`/`size` pagination emits deprecation warning (deadline: 2026-08-01)
+- **New resources:**
+  - `Conexa::ReceivingMethod` — Meios de Recebimento (`/receivingMethods`, `/receivingMethod/:id`)
+  - `Conexa::PaymentMethod` — Meios de Pagamento (`/paymentMethods`, `/paymentMethod/:id`)
+  - `Conexa::BillCategory` — Categorias de Despesa (`/billCategories`, `/billCategory/:id`)
+  - `Conexa::BillSubcategory` — Subcategorias de Despesa (`/billSubcategories`, `/billSubcategory/:id`)
+  - `Conexa::CostCenter` — Centros de Custo (`/costCenters`, `/costCenter/:id`)
+  - `Conexa::Account` — Contas Bancárias (`/accounts`, `/account/:id`)
+  - `Conexa::ServiceCategory` — Categorias de Serviço (`/serviceCategories`, `/serviceCategory/:id`)
+  - `Conexa::RoomBooking` — Reservas de Sala (`/room/bookings`, `/room/booking`) with cancel, checkout, checkin
+- `Product` now supports full CRUD (POST `/product`, DELETE `/product/:id`) per API v2 update
+
+### Changed
+- `Model#extract_page_size_or_params` rewritten to support dual pagination modes
+- `Customer.persons`, `Customer.contracts`, `Customer.charges` migrated to `limit: 100`
+
+### Fixed
+- `Supplier` list URL corrected from `/supplier` to `/suppliers`
+- `Supplier` now has `primary_key_attribute :supplier_id`
+- `Product` now has `primary_key_attribute :product_id`
+
 ## [0.0.8] - 2026-02-19
 
 ### Fixed
@@ -61,7 +87,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Charge with settle and PIX methods
 - Pagination support
 
-[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.8...HEAD
+[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.9...HEAD
+[0.0.9]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.8...v0.0.9
 [0.0.8]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.7...v0.0.8
 [0.0.7]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.6...v0.0.7
 [0.0.6]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.5...v0.0.6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    conexa (0.0.8)
+    conexa (0.0.9)
       jwt
       multi_json
       rest-client

data/README.md

@@ -120,12 +120,11 @@ customer.legal_person['cnpj']  # => "99.557.155/0001-90"
 # Update customer
 Conexa::Customer.update(127, name: 'New Name', cell_number: '11888887777')
 
-# List customers with filters
+# List customers with filters (new pagination)
 customers = Conexa::Customer.list(
   company_id: [3],
   is_active: true,
-  page: 1,
-  size: 20
+  limit: 20
 )
 ```
 
@@ -266,10 +265,75 @@ plan.price  # => 99.90
 
 ```ruby
 # List products
-products = Conexa::Product.list(company_id: [3])
+products = Conexa::Product.list(company_id: [3], limit: 50)
 
 # Retrieve product
 product = Conexa::Product.retrieve(101)
+
+# Create product
+product = Conexa::Product.create(name: 'Novo Produto', company_id: 3)
+
+# Delete product
+Conexa::Product.delete(101)
+```
+
+### Receiving Method
+
+```ruby
+methods = Conexa::ReceivingMethod.list(limit: 50)
+method = Conexa::ReceivingMethod.retrieve(11)
+method.name  # => "Cartão de Crédito"
+```
+
+### Payment Method
+
+```ruby
+methods = Conexa::PaymentMethod.list(limit: 50)
+method = Conexa::PaymentMethod.retrieve(2)
+```
+
+### Bill Category / Subcategory
+
+```ruby
+categories = Conexa::BillCategory.list(limit: 50)
+subcategories = Conexa::BillSubcategory.list(limit: 50)
+```
+
+### Cost Center
+
+```ruby
+centers = Conexa::CostCenter.list(limit: 50)
+center = Conexa::CostCenter.retrieve(11)
+```
+
+### Account
+
+```ruby
+accounts = Conexa::Account.list(limit: 50)
+account = Conexa::Account.retrieve(23)
+```
+
+### Service Category
+
+```ruby
+categories = Conexa::ServiceCategory.list(limit: 50)
+category = Conexa::ServiceCategory.retrieve(1)
+```
+
+### Room Booking
+
+```ruby
+# List bookings
+bookings = Conexa::RoomBooking.list(limit: 20)
+
+# Create booking
+booking = Conexa::RoomBooking.create(room_id: 5, customer_id: 127)
+
+# Cancel booking
+Conexa::RoomBooking.cancel(143063)
+
+# Checkin
+Conexa::RoomBooking.checkin(room_id: 5, customer_id: 127)
 ```
 
 ### Credit Card
@@ -306,25 +370,110 @@ company.document  # => "12.345.678/0001-90"
 
 ## Pagination
 
-All list endpoints return paginated results:
+### New Pagination (recommended) — `limit`/`offset`/`hasNext`
 
 ```ruby
-result = Conexa::Customer.list(page: 1, size: 20)
+result = Conexa::Customer.list(limit: 50)
 
-result.data                       # Array of customers
+result.data                    # Array of customers
+result.pagination.limit        # => 50
+result.pagination.offset       # => 0
+result.pagination.has_next     # => true/false
+
+# Iterate through all pages
+offset = 0
+loop do
+  result = Conexa::Customer.list(limit: 50, offset: offset)
+  result.data.each { |customer| process(customer) }
+  break unless result.pagination.has_next
+  offset += 50
+end
+```
+
+### Legacy Pagination (deprecated — will be removed 2026-08-01)
+
+```ruby
+# Still works but emits a deprecation warning
+result = Conexa::Customer.list(page: 1, size: 20)
 result.pagination.current_page    # => 1
 result.pagination.total_pages     # => 10
-result.pagination.total_items     # => 195
-result.pagination.item_per_page   # => 20
+```
+
+### Migration Guide: Legacy → New Pagination
+
+The legacy `page`/`size` pagination is deprecated and will be removed on **2026-08-01**. Follow these steps to migrate:
+
+#### 1. Replace `page`/`size` with `limit`/`offset`
+
+```ruby
+# BEFORE (legacy — deprecated)
+result = Conexa::Customer.list(page: 1, size: 50)
+result = Conexa::Customer.list(page: 2, size: 50)
+
+# AFTER (new)
+result = Conexa::Customer.list(limit: 50)               # offset defaults to 0
+result = Conexa::Customer.list(limit: 50, offset: 50)   # second page
+```
+
+**Conversion formula:** `offset = (page - 1) * size`
 
-# Iterate through pages
+#### 2. Update pagination metadata access
+
+```ruby
+# BEFORE (legacy)
+result.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
+total_pages = (result.pagination["total"].to_f / size).ceil
+
+# AFTER (new)
+result.pagination.limit      # => 50
+result.pagination.offset     # => 0
+result.pagination.has_next   # => true/false
+```
+
+#### 3. Update iteration loops
+
+```ruby
+# BEFORE (legacy)
+page = 1
 loop do
-  result.data.each { |customer| process(customer) }
-  break if result.pagination.current_page >= result.pagination.total_pages
-  result = Conexa::Customer.list(page: result.pagination.current_page + 1)
+  result = Conexa::Customer.list(page: page, size: 100)
+  break if result.empty?
+  result.data.each { |c| process(c) }
+  page += 1
 end
+
+# AFTER (new)
+offset = 0
+loop do
+  result = Conexa::Customer.list(limit: 100, offset: offset)
+  result.data.each { |c| process(c) }
+  break unless result.pagination.has_next
+  offset += 100
+end
+```
+
+#### 4. Remove positional arguments
+
+```ruby
+# BEFORE (legacy positional args)
+Conexa::Customer.all(2, 50)           # page 2, size 50
+Conexa::Customer.find_by({}, 1, 20)   # page 1, size 20
+
+# AFTER (new keyword args)
+Conexa::Customer.all(limit: 50, offset: 50)
+Conexa::Customer.find_by(limit: 20)
 ```
 
+#### Quick reference
+
+| Legacy | New |
+|---|---|
+| `page: 1, size: 50` | `limit: 50` (offset defaults to 0) |
+| `page: N, size: S` | `limit: S, offset: (N-1)*S` |
+| `pagination["total"]` | `pagination.has_next` |
+| `pagination["page"]` | `pagination.offset` |
+| Positional `(page, size)` | Keyword `limit:`, `offset:` |
+
 ## Error Handling
 
 ```ruby
@@ -360,7 +509,7 @@ end
 
 ## Rate Limiting
 
-The Conexa API has a limit of **100 requests per minute**. Response headers include:
+The Conexa API has a limit of **100 requests per minute** (changing to **60 requests per minute** on 2026-04-27). Response headers include:
 
 - `X-Rate-Limit-Limit`: Maximum requests in 60s
 - `X-Rate-Limit-Remaining`: Remaining requests in 60s

data/README_pt-BR.md

@@ -281,7 +281,7 @@ paginacao = pagina1.pagination
 # paginacao contém total de registros, total de páginas, etc.
 ```
 
-#### Iterando Por Todas as Páginas
+#### Iterando Por Todas as Páginas (legado — depreciado)
 
 ```ruby
 pagina = 1
@@ -301,6 +301,101 @@ loop do
 end
 ```
 
+### Nova Paginação (recomendada) — `limit`/`offset`/`hasNext`
+
+```ruby
+resultado = Conexa::Customer.all(limit: 50)
+
+resultado.data                    # Array de clientes
+resultado.pagination.limit        # => 50
+resultado.pagination.offset       # => 0
+resultado.pagination.has_next     # => true/false
+
+# Iterar por todas as páginas
+offset = 0
+loop do
+  resultado = Conexa::Customer.all(limit: 50, offset: offset)
+  resultado.data.each { |cliente| processa(cliente) }
+  break unless resultado.pagination.has_next
+  offset += 50
+end
+```
+
+### Guia de Migração: Paginação Legada → Nova
+
+A paginação legada `page`/`size` está depreciada e será removida em **01/08/2026**. Siga estes passos para migrar:
+
+#### 1. Substitua `page`/`size` por `limit`/`offset`
+
+```ruby
+# ANTES (legado — depreciado)
+resultado = Conexa::Customer.all(page: 1, size: 50)
+resultado = Conexa::Customer.all(page: 2, size: 50)
+
+# DEPOIS (novo)
+resultado = Conexa::Customer.all(limit: 50)               # offset padrão 0
+resultado = Conexa::Customer.all(limit: 50, offset: 50)   # segunda página
+```
+
+**Fórmula de conversão:** `offset = (page - 1) * size`
+
+#### 2. Atualize o acesso aos metadados de paginação
+
+```ruby
+# ANTES (legado)
+resultado.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
+total_paginas = (resultado.pagination["total"].to_f / tamanho).ceil
+
+# DEPOIS (novo)
+resultado.pagination.limit      # => 50
+resultado.pagination.offset     # => 0
+resultado.pagination.has_next   # => true/false
+```
+
+#### 3. Atualize os loops de iteração
+
+```ruby
+# ANTES (legado)
+pagina = 1
+loop do
+  resultado = Conexa::Customer.all(page: pagina, size: 100)
+  break if resultado.empty?
+  resultado.data.each { |c| processa(c) }
+  pagina += 1
+end
+
+# DEPOIS (novo)
+offset = 0
+loop do
+  resultado = Conexa::Customer.all(limit: 100, offset: offset)
+  resultado.data.each { |c| processa(c) }
+  break unless resultado.pagination.has_next
+  offset += 100
+end
+```
+
+#### 4. Remova argumentos posicionais
+
+```ruby
+# ANTES (argumentos posicionais legados)
+Conexa::Customer.all(2, 50)           # página 2, tamanho 50
+Conexa::Customer.find_by({}, 1, 20)   # página 1, tamanho 20
+
+# DEPOIS (argumentos nomeados)
+Conexa::Customer.all(limit: 50, offset: 50)
+Conexa::Customer.find_by(limit: 20)
+```
+
+#### Referência rápida
+
+| Legado | Novo |
+|---|---|
+| `page: 1, size: 50` | `limit: 50` (offset padrão 0) |
+| `page: N, size: S` | `limit: S, offset: (N-1)*S` |
+| `pagination["total"]` | `pagination.has_next` |
+| `pagination["page"]` | `pagination.offset` |
+| Posicional `(page, size)` | Nomeado `limit:`, `offset:` |
+
 ### Exemplos
 
 #### Clientes (Customers)

data/REFERENCE.md

@@ -14,17 +14,25 @@ Conexa is a Brazilian SaaS platform for **recurring billing**, **subscription ma
 - **Sale** - One-time sale (not recurring)
 - **RecurringSale** - Recurring sale item within a contract
 - **Plan** - Pricing plan with products and periodicities
-- **Product** - Billable item/service
+- **Product** - Billable item/service (now supports full CRUD)
 - **InvoicingMethod** - Payment method configuration (boleto, PIX, credit card)
+- **ReceivingMethod** - Receiving method configuration (cash, transfer, card machine)
+- **PaymentMethod** - Payment method type (boleto, PIX, cartão)
+- **BillCategory** - Bill expense category
+- **BillSubcategory** - Bill expense subcategory
+- **CostCenter** - Cost center for expense allocation
+- **Account** - Bank account
+- **ServiceCategory** - Service category for plans
 - **Person** - Requester (solicitante) linked to a customer
 - **Bill** - Financial bill (conta a pagar)
 - **Supplier** - Supplier with PF/PJ data
+- **RoomBooking** - Room booking with checkin/checkout (Conexa Coworking)
 
 ## Installation
 
 ```ruby
 # Gemfile
-gem 'conexa', '~> 0.0.7'
+gem 'conexa', '~> 0.0.9'
 
 # Or install directly
 gem install conexa
@@ -694,12 +702,16 @@ product = Conexa::Product.find(100)
 product.name  # => "Mensalidade"
 
 # List products
-products = Conexa::Product.all(company_id: [3])
-```
+products = Conexa::Product.all(company_id: [3], limit: 50)
+
+# Create product
+product = Conexa::Product.create(name: 'Novo Produto', company_id: 3)
 
-**API endpoints:** `GET /product/:id`, `GET /products`
+# Delete product
+Conexa::Product.destroy(100)
+```
 
-**Note:** Products cannot be created/updated via this gem. `save` raises `NoMethodError`.
+**API endpoints:** `GET /product/:id`, `GET /products`, `POST /product`, `DELETE /product/:id`
 
 ---
 
@@ -855,7 +867,7 @@ supplier.save
 supplier.destroy
 ```
 
-**API endpoints:** `POST /supplier`, `GET /supplier/:id`, `PATCH /supplier/:id`, `DELETE /supplier/:id`, `GET /supplier` (list)
+**API endpoints:** `POST /supplier`, `GET /supplier/:id`, `PATCH /supplier/:id`, `DELETE /supplier/:id`, `GET /suppliers`
 
 **Create attributes:**
 - `name` - Supplier name (required)
@@ -1020,27 +1032,121 @@ person.destroy
 
 ### Pagination
 
-All `#all` and `#find_by` methods support pagination:
+#### New Pagination (recommended) — `limit`/`offset`/`hasNext`
+
+All `#all` and `#find_by` methods support the new pagination when `limit:` is passed:
+
+```ruby
+# Page 1, 50 items
+result = Conexa::Customer.all(limit: 50)
+
+result.data           # => Array of customers
+result.pagination.limit    # => 50
+result.pagination.offset   # => 0
+result.pagination.has_next # => true/false
+result.empty?         # => false
+
+# Iterate all pages
+offset = 0
+loop do
+  result = Conexa::Customer.all(limit: 100, offset: offset)
+  break if result.empty?
+
+  result.each { |customer| process(customer) }
+  break unless result.pagination.has_next
+  offset += 100
+end
+```
+
+#### Legacy Pagination (deprecated — removed 2026-08-01)
+
+If `limit:` is NOT passed, the gem falls back to the old `page`/`size` model
+(emitting a deprecation warning):
 
 ```ruby
-# Page 1, 50 items per page
+# Emits: DEPRECATION WARNING: O modelo antigo de paginação...
 result = Conexa::Customer.all(page: 1, size: 50)
 
 result.data        # => Array of customers
 result.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
 result.empty?      # => false
+```
 
-# Iterate all pages
+#### Migration Guide: Legacy → New Pagination
+
+The legacy `page`/`size` pagination is deprecated and will be removed on **2026-08-01**. Follow these steps to migrate:
+
+**Step 1 — Replace `page`/`size` with `limit`/`offset`:**
+
+```ruby
+# BEFORE (legacy)
+result = Conexa::Customer.all(page: 1, size: 50)
+result = Conexa::Customer.all(page: 2, size: 50)
+
+# AFTER (new)
+result = Conexa::Customer.all(limit: 50)               # offset defaults to 0
+result = Conexa::Customer.all(limit: 50, offset: 50)   # second page
+```
+
+Conversion formula: `offset = (page - 1) * size`
+
+**Step 2 — Update pagination metadata access:**
+
+```ruby
+# BEFORE
+result.pagination  # => { "page" => 1, "size" => 50, "total" => 150 }
+total_pages = (result.pagination["total"].to_f / size).ceil
+
+# AFTER
+result.pagination.limit      # => 50
+result.pagination.offset     # => 0
+result.pagination.has_next   # => true/false
+```
+
+**Step 3 — Update iteration loops:**
+
+```ruby
+# BEFORE
 page = 1
 loop do
   result = Conexa::Customer.all(page: page, size: 100)
   break if result.empty?
-
-  result.each { |customer| process(customer) }
+  result.each { |c| process(c) }
   page += 1
 end
+
+# AFTER
+offset = 0
+loop do
+  result = Conexa::Customer.all(limit: 100, offset: offset)
+  result.each { |c| process(c) }
+  break unless result.pagination.has_next
+  offset += 100
+end
+```
+
+**Step 4 — Remove positional arguments:**
+
+```ruby
+# BEFORE
+Conexa::Customer.all(2, 50)           # page 2, size 50
+Conexa::Customer.find_by({}, 1, 20)   # page 1, size 20
+
+# AFTER
+Conexa::Customer.all(limit: 50, offset: 50)
+Conexa::Customer.find_by(limit: 20)
 ```
 
+**Quick reference:**
+
+| Legacy | New |
+|---|---|
+| `page: 1, size: 50` | `limit: 50` (offset defaults to 0) |
+| `page: N, size: S` | `limit: S, offset: (N-1)*S` |
+| `pagination["total"]` | `pagination.has_next` |
+| `pagination["page"]` | `pagination.offset` |
+| Positional `(page, size)` | Keyword `limit:`, `offset:` |
+
 ### Result Object
 
 API calls return `Conexa::Result` objects:
@@ -1109,7 +1215,7 @@ Conexa::Charge.all(
 
 ### Rate Limiting
 
-The API enforces a limit of 100 requests per minute. Response headers:
+The API enforces a limit of 100 requests per minute (changing to **60 requests per minute** on 2026-04-27). Response headers:
 - `X-Rate-Limit-Limit` - Maximum requests per minute
 - `X-Rate-Limit-Remaining` - Remaining requests
 - `X-Rate-Limit-Reset` - Seconds until limit resets
@@ -1127,13 +1233,21 @@ The API enforces a limit of 100 requests per minute. Response headers:
 | Sale | yes | yes | yes | yes | yes | billed?, paid?, editable? |
 | RecurringSale | yes | yes | yes | yes | yes | end_recurring_sale |
 | Plan | yes | yes | yes | - | yes | - |
-| Product | yes | yes | - | - | - | - |
+| Product | yes | yes | yes | - | yes | - |
 | InvoicingMethod | yes | yes | yes | yes | yes | - |
+| ReceivingMethod | yes | yes | - | - | - | - |
+| PaymentMethod | yes | yes | - | - | - | - |
+| BillCategory | yes | yes | - | - | - | - |
+| BillSubcategory | yes | yes | - | - | - | - |
+| CostCenter | yes | yes | - | - | - | - |
+| Account | yes | yes | - | - | - | - |
+| ServiceCategory | yes | yes | - | - | - | - |
 | Bill | yes | yes | yes | - | - | - |
 | Company | yes | yes | yes | yes | yes | - |
 | Supplier | yes | yes | yes | yes | yes | - |
 | CreditCard | yes | - | yes | yes | yes | - |
 | Person | - | - | yes | yes | yes | - |
+| RoomBooking | yes | yes | yes | - | - | cancel, checkout, checkin |
 
 **Legend:** `yes` = available, `-` = not available (raises NoMethodError or not implemented)
 

data/lib/conexa/model.rb

@@ -104,7 +104,7 @@ module Conexa
 
       def find_by(params = Hash.new, page = nil, size = nil)
         params = extract_page_size_or_params(page, size, **params)
-        raise RequestError.new('Invalid page size') if params[:page] < 1 or params[:size] < 1
+        raise RequestError.new('Invalid page size') if (!params.key?(:limit)) && (params[:page] < 1 or params[:size] < 1)
 
         Conexa::Request.get(url, params: params).call underscored_class_name
       end
@@ -139,8 +139,28 @@ module Conexa
       end
 
       def extract_page_size_or_params(*args, **params)
-        params[:page]  ||= args[0] || 1
-        params[:size] ||= args[1] || 100
+        if args[0].is_a?(Hash)
+          params = args[0].merge(params)
+          page_val = nil
+        else
+          page_val = args[0]
+        end
+        size_val = args[1]
+
+        if params.key?(:limit)
+          params[:offset] ||= size_val if size_val.is_a?(Integer)
+          params[:offset] ||= 0
+          params.delete(:page) # Fix to ensure the api doesn't get confused
+          params.delete(:size)
+          return params
+        end
+
+        if params.key?(:page) || params.key?(:size) || page_val.is_a?(Integer)
+          warn "DEPRECATION WARNING: O modelo antigo de paginação (page/size) será removido em 01 de agosto de 2026. Utilize limit e offset."
+        end
+
+        params[:page] ||= page_val || 1
+        params[:size] ||= size_val || 100
         params
       end
     end

data/lib/conexa/object.rb

@@ -111,7 +111,12 @@ module Conexa
         end
 
         if args.size == 0
-          return self[name] || self[name.to_sym]
+          if @attributes.key?(name)
+            return @attributes[name]
+          elsif @attributes.key?(name.to_sym)
+            return @attributes[name.to_sym]
+          end
+          return nil
         end
       end
 

data/lib/conexa/resources/account.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Conexa
+  # Account resource (Conta Bancária)
+  #
+  # @example Find an account
+  #   account = Conexa::Account.find(23)
+  #   account.name  # => "Banco do Brasil"
+  #
+  # @example List accounts
+  #   accounts = Conexa::Account.all(limit: 50)
+  #
+  # @!attribute [r] account_id
+  #   @return [Integer] Account ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Account name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the account is active
+  #
+  class Account < Model
+    primary_key_attribute :account_id
+
+    class << self
+      def url(*params)
+        ["/accounts", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/account", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/bill_category.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Conexa
+  # BillCategory resource (Categoria de Despesa)
+  #
+  # @example Find a bill category
+  #   category = Conexa::BillCategory.find(4)
+  #   category.name  # => "Impostos"
+  #
+  # @example List bill categories
+  #   categories = Conexa::BillCategory.all(limit: 50)
+  #
+  # @!attribute [r] bill_category_id
+  #   @return [Integer] Bill category ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Category name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the category is active
+  #
+  class BillCategory < Model
+    primary_key_attribute :bill_category_id
+
+    class << self
+      def url(*params)
+        ["/billCategories", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/billCategory", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/bill_subcategory.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Conexa
+  # BillSubcategory resource (Subcategoria de Despesa)
+  #
+  # @example Find a bill subcategory
+  #   subcategory = Conexa::BillSubcategory.find(29)
+  #   subcategory.name  # => "Taxa de Cartão"
+  #
+  # @example List bill subcategories
+  #   subcategories = Conexa::BillSubcategory.all(limit: 50)
+  #
+  # @!attribute [r] bill_subcategory_id
+  #   @return [Integer] Bill subcategory ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Subcategory name
+  # @!attribute [r] bill_category_id
+  #   @return [Integer] Parent bill category ID
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the subcategory is active
+  #
+  class BillSubcategory < Model
+    primary_key_attribute :bill_subcategory_id
+
+    class << self
+      def url(*params)
+        ["/billSubcategories", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/billSubcategory", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/charge.rb

@@ -8,7 +8,7 @@ module Conexa
   #   charge.status  # => "pending"
   #
   # @example List charges
-  #   charges = Conexa::Charge.all(customer_id: [127], status: 'pending')
+  #   charges = Conexa::Charge.all(customer_id: [127], status: 'pending', limit: 50)
   #
   # @example Settle (pay) a charge
   #   Conexa::Charge.settle(789)

data/lib/conexa/resources/cost_center.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Conexa
+  # CostCenter resource (Centro de Custo)
+  #
+  # @example Find a cost center
+  #   center = Conexa::CostCenter.find(11)
+  #   center.name  # => "Marketing"
+  #
+  # @example List cost centers
+  #   centers = Conexa::CostCenter.all(limit: 50)
+  #
+  # @!attribute [r] cost_center_id
+  #   @return [Integer] Cost center ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Cost center name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the cost center is active
+  #
+  class CostCenter < Model
+    primary_key_attribute :cost_center_id
+
+    class << self
+      def url(*params)
+        ["/costCenters", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/costCenter", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/customer.rb

@@ -76,21 +76,21 @@ module Conexa
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of persons
       def persons(customer_id)
-        Conexa::Person.all(customer_id: customer_id)
+        Conexa::Person.all(customer_id: customer_id, limit: 100)
       end
 
       # List contracts for a customer
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of contracts
       def contracts(customer_id)
-        Conexa::Contract.all(customer_id: [customer_id])
+        Conexa::Contract.all(customer_id: [customer_id], limit: 100)
       end
 
       # List charges for a customer
       # @param customer_id [Integer] Customer ID
       # @return [Result] List of charges
       def charges(customer_id)
-        Conexa::Charge.all(customer_id: [customer_id])
+        Conexa::Charge.all(customer_id: [customer_id], limit: 100)
       end
     end
   end

data/lib/conexa/resources/payment_method.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Conexa
+  # PaymentMethod resource (Meio de Pagamento)
+  #
+  # @example Find a payment method
+  #   method = Conexa::PaymentMethod.find(2)
+  #   method.name  # => "Boleto"
+  #
+  # @example List payment methods
+  #   methods = Conexa::PaymentMethod.all(limit: 50)
+  #
+  # @!attribute [r] payment_method_id
+  #   @return [Integer] Payment method ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the payment method is active
+  #
+  class PaymentMethod < Model
+    primary_key_attribute :payment_method_id
+
+    class << self
+      def url(*params)
+        ["/paymentMethods", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/paymentMethod", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/product.rb

@@ -1,7 +1,29 @@
 module Conexa
-  class Product  < Model
-    def save
-      raise NoMethodError
-    end
+  # Product resource (read-only for listing/retrieving)
+  #
+  # The new API v2 also supports POST /product and DELETE /product/:id.
+  #
+  # @example Find a product
+  #   product = Conexa::Product.find(100)
+  #   product.name  # => "Mensalidade"
+  #
+  # @example List products
+  #   products = Conexa::Product.all(company_id: [3], limit: 50)
+  #
+  # @example Create a product
+  #   product = Conexa::Product.create(name: 'Novo Produto', company_id: 3)
+  #
+  # @example Delete a product
+  #   Conexa::Product.destroy(100)
+  #
+  # @!attribute [r] product_id
+  #   @return [Integer] Product ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Product name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the product is active
+  #
+  class Product < Model
+    primary_key_attribute :product_id
   end
 end

data/lib/conexa/resources/receiving_method.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Conexa
+  # ReceivingMethod resource (Meio de Recebimento)
+  #
+  # @example Find a receiving method
+  #   method = Conexa::ReceivingMethod.find(11)
+  #   method.name  # => "Cartão de Crédito"
+  #
+  # @example List receiving methods
+  #   methods = Conexa::ReceivingMethod.all(limit: 50)
+  #
+  # @!attribute [r] receiving_method_id
+  #   @return [Integer] Receiving method ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Name
+  # @!attribute [r] max_installments
+  #   @return [Integer] Maximum number of installments
+  # @!attribute [r] credit_days
+  #   @return [Integer] Days until credit
+  # @!attribute [r] is_installment_fee
+  #   @return [Boolean] Whether fee is per installment
+  # @!attribute [r] transaction_fee
+  #   @return [Float] Fee per transaction
+  # @!attribute [r] transaction_rate
+  #   @return [Float] Rate percentage per transaction
+  # @!attribute [r] account_id
+  #   @return [Integer, nil] Associated account ID
+  # @!attribute [r] cost_center_id
+  #   @return [Integer, nil] Cost center ID
+  # @!attribute [r] bill_category_id
+  #   @return [Integer, nil] Bill category ID
+  # @!attribute [r] bill_subcategory_id
+  #   @return [Integer, nil] Bill subcategory ID
+  # @!attribute [r] payment_method_id
+  #   @return [Integer, nil] Payment method ID
+  # @!attribute [r] supplier_id
+  #   @return [Integer, nil] Supplier ID
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the receiving method is active
+  #
+  class ReceivingMethod < Model
+    primary_key_attribute :receiving_method_id
+
+    class << self
+      def url(*params)
+        ["/receivingMethods", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/receivingMethod", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/room_booking.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Conexa
+  # RoomBooking resource (Reserva de Sala)
+  #
+  # @example Create a room booking
+  #   booking = Conexa::RoomBooking.create(
+  #     room_id: 5,
+  #     customer_id: 127,
+  #     start_date: '2026-04-01T10:00:00-03:00',
+  #     end_date: '2026-04-01T12:00:00-03:00'
+  #   )
+  #
+  # @example Find a room booking
+  #   booking = Conexa::RoomBooking.find(143063)
+  #
+  # @example List room bookings
+  #   bookings = Conexa::RoomBooking.all(limit: 50)
+  #
+  # @example Cancel a booking
+  #   Conexa::RoomBooking.cancel(143063)
+  #
+  # @!attribute [r] booking_id
+  #   @return [Integer] Booking ID (also accessible as #id)
+  # @!attribute [r] room_id
+  #   @return [Integer] Room ID
+  # @!attribute [r] customer_id
+  #   @return [Integer] Customer ID
+  # @!attribute [r] status
+  #   @return [String] Booking status
+  #
+  class RoomBooking < Model
+    primary_key_attribute :booking_id
+
+    # Cancel this booking
+    # @return [self]
+    def cancel
+      Conexa::Request.patch(self.class.show_url(primary_key, "cancel")).call(class_name)
+      self
+    end
+
+    # Checkout this booking
+    # @return [self]
+    def checkout
+      Conexa::Request.post(self.class.show_url(primary_key, "checkout")).call(class_name)
+      self
+    end
+
+    class << self
+      def url(*params)
+        ["/room/bookings", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/room/booking", *params].join '/'
+      end
+
+      # Cancel a booking by ID
+      # @param id [Integer, String] booking ID
+      # @return [RoomBooking]
+      def cancel(id)
+        find(id).cancel
+      end
+
+      # Checkout a booking by ID
+      # @param id [Integer, String] booking ID
+      # @return [RoomBooking]
+      def checkout(id)
+        find(id).checkout
+      end
+
+      # Perform a checkin
+      # @param params [Hash] checkin parameters
+      # @return [ConexaObject]
+      def checkin(params = {})
+        Conexa::Request.post("/checkin", params: params).call("room_booking")
+      end
+
+      # Perform a checkout (standalone)
+      # @param params [Hash] checkout parameters
+      # @return [ConexaObject]
+      def standalone_checkout(params = {})
+        Conexa::Request.post("/checkout", params: params).call("room_booking")
+      end
+    end
+  end
+end

data/lib/conexa/resources/sale.rb

@@ -12,7 +12,7 @@ module Conexa
   #   )
   #
   # @example List sales
-  #   sales = Conexa::Sale.all(customer_id: [450], status: 'notBilled')
+  #   sales = Conexa::Sale.all(customer_id: [450], status: 'notBilled', limit: 50)
   #
   # @!attribute [r] sale_id
   #   @return [Integer] Sale ID (also accessible as #id)

data/lib/conexa/resources/service_category.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Conexa
+  # ServiceCategory resource (Categoria de Serviço)
+  #
+  # @example Find a service category
+  #   category = Conexa::ServiceCategory.find(1)
+  #   category.name  # => "Consultoria"
+  #
+  # @example List service categories
+  #   categories = Conexa::ServiceCategory.all(limit: 50)
+  #
+  # @!attribute [r] service_category_id
+  #   @return [Integer] Service category ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Category name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the category is active
+  #
+  class ServiceCategory < Model
+    primary_key_attribute :service_category_id
+
+    class << self
+      def url(*params)
+        ["/serviceCategories", *params].join '/'
+      end
+
+      def show_url(*params)
+        ["/serviceCategory", *params].join '/'
+      end
+    end
+  end
+end

data/lib/conexa/resources/supplier.rb

@@ -1,8 +1,31 @@
+# frozen_string_literal: true
+
 module Conexa
+  # Supplier resource (Fornecedor)
+  #
+  # @example Create a supplier
+  #   supplier = Conexa::Supplier.create(name: 'Fornecedor ABC')
+  #
+  # @example Find a supplier
+  #   supplier = Conexa::Supplier.find(10)
+  #   supplier.name  # => "Fornecedor ABC"
+  #
+  # @example List suppliers
+  #   suppliers = Conexa::Supplier.all(limit: 50)
+  #
+  # @!attribute [r] supplier_id
+  #   @return [Integer] Supplier ID (also accessible as #id)
+  # @!attribute [r] name
+  #   @return [String] Supplier name
+  # @!attribute [r] is_active
+  #   @return [Boolean] Whether the supplier is active
+  #
   class Supplier < Model
+    primary_key_attribute :supplier_id
+
     class << self
       def url(*params)
-        ["/supplier", *params].join '/'
+        ["/suppliers", *params].join '/'
       end
 
       def show_url(*params)

data/lib/conexa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Conexa
-  VERSION = "0.0.8"
+  VERSION = "0.0.9"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: conexa
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Guilherme Gazzinelli
@@ -155,23 +155,31 @@ files:
 - lib/conexa/object.rb
 - lib/conexa/order_commom.rb
 - lib/conexa/request.rb
+- lib/conexa/resources/account.rb
 - lib/conexa/resources/address.rb
 - lib/conexa/resources/auth.rb
 - lib/conexa/resources/bill.rb
+- lib/conexa/resources/bill_category.rb
+- lib/conexa/resources/bill_subcategory.rb
 - lib/conexa/resources/charge.rb
 - lib/conexa/resources/company.rb
 - lib/conexa/resources/contract.rb
+- lib/conexa/resources/cost_center.rb
 - lib/conexa/resources/credit_card.rb
 - lib/conexa/resources/customer.rb
 - lib/conexa/resources/invoicing_method.rb
 - lib/conexa/resources/legal_person.rb
 - lib/conexa/resources/pagination.rb
+- lib/conexa/resources/payment_method.rb
 - lib/conexa/resources/person.rb
 - lib/conexa/resources/plan.rb
 - lib/conexa/resources/product.rb
+- lib/conexa/resources/receiving_method.rb
 - lib/conexa/resources/recurring_sale.rb
 - lib/conexa/resources/result.rb
+- lib/conexa/resources/room_booking.rb
 - lib/conexa/resources/sale.rb
+- lib/conexa/resources/service_category.rb
 - lib/conexa/resources/supplier.rb
 - lib/conexa/token_manager.rb
 - lib/conexa/util.rb