conexa 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f797946a06e5b411bab47be327b805494a3baae97afb9faa629d0f5b45318a6
-  data.tar.gz: a4433c392325e634d6ded5996a809dc124a2e1d75c3239af8050fbf8f3402c47
+  metadata.gz: '050626980d9f896ca2c70ed30a27c1cfda7d0d30c89e25c90e86422d122fb1af'
+  data.tar.gz: 43134221ca4dd8f38bc3f8a62bfffe2807d1565e949e2adf72d446fa14db01cf
 SHA512:
-  metadata.gz: 780a9f5f20b67d1b8a0917b41ff82e06536a79e9f23c29125c7627f2f84efd084e24d6d435d49603b7d3a1df65a5dd3880dea2c3168af653b71ae75800089fda
-  data.tar.gz: 86bf266d620205ca7d52416775feec983f4d197ade8c241f4812d443b6776c850a12ac66ca3fb517a768f6caa60957843f5bebdb1653e17e590fc40c6338f482
+  metadata.gz: 298ef626afb7783dff6d66161e20ff4b28b30b0d81761ce3f5debf187f1d60e0d01814004d3372ad6531b5e40e22e110af471522bbc577e3c0baac63dfb17014
+  data.tar.gz: 768fbc470c103074ff5b768bf78ba6ed47385c4d06a7cadba7aed395947da92c73756c8f72c06e66be15520974c7f0c2e8438dfc567181cc83357416cad251d5

data/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.8] - 2026-02-19
+
+### Fixed
+- `Auth.login` usava `Request.post` (inclui header Authorization) ao invés de `Request.auth`
+- `Model#primary_key_name` retornava nomes incorretos para classes compostas (ex: `creditcard_id` ao invés de `credit_card_id`)
+- `Model.destroy(id)` falhava para resources com `primary_key_attribute` definido
+- `Model#destroy` retornava Hash interno ao invés de `self`
+- `Person` tinha `find`, `all` e `find_by` desnecessariamente desabilitados (a API suporta todos os endpoints CRUD)
+
+### Added
+- Testes de autenticação com cassettes VCR (13 specs)
+- Testes de integração WebMock para Sale, RecurringSale, Plan, Product, Bill, Supplier, Company, CreditCard, Person e InvoicingMethod
+- Total de testes: 407 specs
+
+### Changed
+- `REFERENCE.md` reescrito com documentação completa de todos os endpoints baseada na collection Postman
+- nokogiri atualizado para 1.19.1
+
 ## [0.0.7] - 2026-02-12
 
 ### Added
@@ -43,7 +61,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.7...HEAD
+[Unreleased]: https://github.com/guilhermegazzinelli/conexa-ruby/compare/v0.0.8...HEAD
+[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
 [0.0.5]: https://github.com/guilhermegazzinelli/conexa-ruby/releases/tag/v0.0.5

data/Gemfile

@@ -11,8 +11,6 @@ gem "rspec", "~> 3.0"
 
 gem "rubocop", "~> 1.21"
 
-gem "solargraph"
-
 gem "standard"
 
 gem "debug"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    conexa (0.0.6)
+    conexa (0.0.8)
       jwt
       multi_json
       rest-client
@@ -23,9 +23,7 @@ GEM
     addressable (2.8.7)
       public_suffix (>= 2.0.2, < 7.0)
     ast (2.4.2)
-    backport (1.2.0)
     base64 (0.2.0)
-    benchmark (0.3.0)
     bigdecimal (3.1.8)
     byebug (11.1.3)
     concurrent-ruby (1.3.4)
@@ -39,7 +37,6 @@ GEM
     diff-lcs (1.5.1)
     domain_name (0.6.20240107)
     drb (2.2.1)
-    e2mmap (0.1.0)
     factory_bot (6.5.0)
       activesupport (>= 5.0.0)
     faker (3.5.1)
@@ -54,14 +51,9 @@ GEM
     irb (1.14.1)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    jaro_winkler (1.6.0)
     json (2.7.2)
     jwt (3.1.2)
       base64
-    kramdown (2.4.0)
-      rexml
-    kramdown-parser-gfm (1.1.0)
-      kramdown (~> 2.0)
     language_server-protocol (3.17.0.3)
     lint_roller (1.1.0)
     logger (1.6.1)
@@ -72,8 +64,6 @@ GEM
     minitest (5.25.1)
     multi_json (1.19.1)
     netrc (0.11.0)
-    nokogiri (1.16.7-x86_64-linux)
-      racc (~> 1.4)
     parallel (1.26.3)
     parser (3.3.5.0)
       ast (~> 2.4.1)
@@ -84,7 +74,6 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.2.1)
-    rbs (2.8.4)
     rdoc (6.7.0)
       psych (>= 4.0.0)
     regexp_parser (2.9.2)
@@ -95,8 +84,6 @@ GEM
       http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
-    reverse_markdown (2.1.1)
-      nokogiri
     rexml (3.3.8)
     rspec (3.13.0)
       rspec-core (~> 3.13.0)
@@ -128,22 +115,6 @@ GEM
       rubocop-ast (>= 1.31.1, < 2.0)
     ruby-progressbar (1.13.0)
     securerandom (0.3.1)
-    solargraph (0.50.0)
-      backport (~> 1.2)
-      benchmark
-      bundler (~> 2.0)
-      diff-lcs (~> 1.4)
-      e2mmap
-      jaro_winkler (~> 1.5)
-      kramdown (~> 2.3)
-      kramdown-parser-gfm (~> 1.1)
-      parser (~> 3.0)
-      rbs (~> 2.0)
-      reverse_markdown (~> 2.0)
-      rubocop (~> 1.38)
-      thor (~> 1.0)
-      tilt (~> 2.0)
-      yard (~> 0.9, >= 0.9.24)
     standard (1.41.1)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
@@ -157,8 +128,6 @@ GEM
       lint_roller (~> 1.1)
       rubocop-performance (~> 1.22.0)
     stringio (3.1.1)
-    thor (1.3.2)
-    tilt (2.4.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.6.0)
@@ -168,10 +137,10 @@ GEM
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.37)
 
 PLATFORMS
-  x86_64-linux
+  ruby
+  x86_64-linux-gnu
 
 DEPENDENCIES
   byebug
@@ -182,7 +151,6 @@ DEPENDENCIES
   rake (~> 13.0)
   rspec (~> 3.0)
   rubocop (~> 1.21)
-  solargraph
   standard
   vcr
   webmock

data/REFERENCE.md

@@ -7,19 +7,24 @@
 Conexa is a Brazilian SaaS platform for **recurring billing**, **subscription management**, and **financial operations**. This gem provides a Ruby interface to their REST API v2.
 
 **Key concepts:**
+- **Auth** - Username/password authentication (JWT)
 - **Customer** - Client (PF or PJ) who receives invoices
 - **Contract** - Recurring billing agreement with a plan
 - **Charge** - Individual invoice/boleto generated for payment
 - **Sale** - One-time sale (not recurring)
 - **RecurringSale** - Recurring sale item within a contract
-- **Plan** - Predefined pricing plan with products
+- **Plan** - Pricing plan with products and periodicities
 - **Product** - Billable item/service
+- **InvoicingMethod** - Payment method configuration (boleto, PIX, credit card)
+- **Person** - Requester (solicitante) linked to a customer
+- **Bill** - Financial bill (conta a pagar)
+- **Supplier** - Supplier with PF/PJ data
 
 ## Installation
 
 ```ruby
 # Gemfile
-gem 'conexa', '~> 0.0.6'
+gem 'conexa', '~> 0.0.7'
 
 # Or install directly
 gem install conexa
@@ -43,13 +48,13 @@ rails generate conexa:install
 This gem follows Ruby/Rails conventions. Use **snake_case** for all parameters - the gem automatically converts to camelCase for the API.
 
 ```ruby
-# ✅ Correct - snake_case
+# Correct - snake_case
 Conexa::Customer.create(
   company_id: 3,
   legal_person: { cnpj: '99.557.155/0001-90' }
 )
 
-# ❌ Avoid - camelCase (works but not idiomatic)
+# Avoid - camelCase (works but not idiomatic)
 Conexa::Customer.create(
   companyId: 3,
   legalPerson: { cnpj: '99.557.155/0001-90' }
@@ -67,25 +72,111 @@ customer.legal_person     # => { cnpj: '...' }
 
 ## Resources
 
+### Auth
+
+Authenticates with username/password and returns a JWT token. Does not require a pre-configured `api_token`.
+
+```ruby
+# Authenticate
+auth = Conexa::Auth.login(username: 'admin', password: 'secret')
+# or
+auth = Conexa::Auth.authenticate(username: 'admin', password: 'secret')
+
+auth.access_token  # => "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
+auth.token_type    # => "Bearer"
+auth.expires_in    # => 28800 (8 hours in seconds)
+auth.user.id       # => 1
+auth.user.type     # => "admin" or "employee"
+auth.user.name     # => "Luke Skywalker"
+
+# Use the token for subsequent requests
+Conexa.configure { |c| c.api_token = auth.access_token }
+```
+
+**API endpoint:** `POST /auth`
+
+**Request body:**
+- `username` - Login username (admin login or employee email)
+- `password` - Password
+
+**Response attributes:**
+- `user` - User object with `id`, `type`, `name`
+- `token_type` - Always "Bearer"
+- `access_token` - JWT token for subsequent requests
+- `expires_in` - Token expiration in seconds (28800 = 8 hours)
+
+**Errors:**
+- `Conexa::ResponseError` - Invalid credentials (401), validation errors (400)
+
+---
+
 ### Customer
 
-Manages clients (pessoas físicas ou jurídicas).
+Manages clients (pessoas fisicas ou juridicas).
 
 ```ruby
-# Create customer (Pessoa Jurídica)
+# Create customer (Pessoa Juridica)
 customer = Conexa::Customer.create(
   company_id: 3,
   name: 'Empresa ABC Ltda',
-  legal_person: { cnpj: '99.557.155/0001-90' },
+  trade_name: 'ABC',
+  field_of_activity: 'Tecnologia',
+  notes: 'Cliente VIP',
+  cell_number: '31999998888',
+  phones: ['3133334444', '3144445555'],
+  website: 'https://www.abc.com.br',
+  has_login_access: true,
+  login: 'empresa@abc.com.br',
+  password: 'SecurePass123',
+  legal_person: {
+    cnpj: '99.557.155/0001-90',
+    foundation_date: '2020-01-15',
+    state_inscription: '123456789',
+    municipal_inscription: '98765432'
+  },
+  address: {
+    zip_code: '30130000',
+    state: 'MG',
+    city: 'Belo Horizonte',
+    street: 'Av. Afonso Pena',
+    number: '1000',
+    neighborhood: 'Centro',
+    additional_details: 'Sala 501'
+  },
   emails_message: ['contato@abc.com.br'],
-  phones: ['31999998888']
+  emails_financial_messages: ['financeiro@abc.com.br'],
+  default_due_day: 10,
+  tax_deductions: {
+    iss: 0, ir: 0, pis: 0, inss: 0, csll: 0, cofins: 0
+  },
+  extra_fields: [
+    { id: 1, value: 'Valor 1' }
+  ]
+)
+
+# Create customer (Pessoa Fisica)
+customer = Conexa::Customer.create(
+  company_id: 3,
+  name: 'Joao Silva',
+  natural_person: {
+    cpf: '123.456.789-00',
+    rg: '123456789',
+    birth_date: '1990-05-15',
+    issuing_authority: 'SSP/MG',
+    profession: 'Desenvolvedor',
+    marital_status: 'single'  # single, married, divorced, widowed, not informed
+  }
 )
 
-# Create customer (Pessoa Física)
+# Create customer (Estrangeiro)
 customer = Conexa::Customer.create(
   company_id: 3,
-  name: 'João Silva',
-  natural_person: { cpf: '123.456.789-00' }
+  name: 'John Smith',
+  foreign: {
+    document: 'ABC123456',
+    birth_date: '1985-03-20',
+    profession: 'Engineer'
+  }
 )
 
 # Find by ID
@@ -111,25 +202,49 @@ customer.save
 customer.destroy
 # or
 Conexa::Customer.destroy(127)
+
+# Sub-resources
+Conexa::Customer.persons(127)    # List persons for customer
+Conexa::Customer.contracts(127)  # List contracts for customer
+Conexa::Customer.charges(127)    # List charges for customer
 ```
 
-**Customer attributes:**
-- `customer_id` - ID
-- `company_id` - Unit/company ID
-- `name` - Full name
+**API endpoints:** `POST /customer`, `GET /customer/:id`, `PATCH /customer/:id`, `DELETE /customer/:id`, `GET /customers`
+
+**Create/update attributes:**
+- `company_id` - Unit/company ID (required on create)
+- `name` - Full name (required on create)
 - `trade_name` - Trade name (optional)
-- `has_login_access` - Has portal access
+- `pronunciation` - Name pronunciation (optional)
+- `field_of_activity` - Field of activity
+- `notes` - General notes
+- `cell_number` - Cell phone number
+- `phones` - Array of phone numbers
+- `website` - Website URL
+- `has_login_access` - Has portal access (boolean)
+- `login` - Login email (when has_login_access is true)
+- `password` - Login password (when has_login_access is true)
+- `legal_person` - PJ data: `cnpj`, `foundation_date`, `state_inscription`, `municipal_inscription`
+- `natural_person` - PF data: `cpf`, `rg`, `birth_date`, `issuing_authority`, `profession`, `marital_status`
+- `foreign` - Foreign data: `document`, `birth_date`, `profession`
+- `address` - Address: `zip_code`, `state`, `city`, `street`, `number`, `neighborhood`, `additional_details`
+- `mailing_address` - Mailing address (same structure as address)
+- `emails_message` - Array of general emails
+- `emails_financial_messages` - Array of financial emails
+- `tags_id` - Array of tag IDs
+- `default_due_day` - Default due day for charges
+- `tax_deductions` - Tax deductions: `iss`, `ir`, `pis`, `inss`, `csll`, `cofins`
+- `extra_fields` - Array of `{ id, value }` for custom fields
+- `automatically_issue_nfse` - Auto-generate NFSe (boolean)
+- `notes_nfse` - NFSe notes
+- `extension_numbers` - Extension numbers
+
+**Read-only attributes:**
+- `customer_id` - ID
 - `is_active` - Active status
 - `is_blocked` - Blocked status
 - `is_juridical_person` - Is PJ (legal person)
 - `is_foreign` - Is foreigner
-- `address` - Address object
-- `legal_person` - PJ data (cnpj, etc)
-- `natural_person` - PF data (cpf, etc)
-- `phones` - Array of phones
-- `emails_message` - General emails
-- `emails_financial_messages` - Financial emails
-- `tags_id` - Tag IDs
 - `created_at` - Creation timestamp
 
 ---
@@ -139,13 +254,34 @@ Conexa::Customer.destroy(127)
 Manages recurring billing contracts.
 
 ```ruby
-# Create contract
+# Create contract with plan
 contract = Conexa::Contract.create(
   customer_id: 127,
   plan_id: 5,
   start_date: '2024-01-01',
-  payment_day: 10,
-  invoicing_method_id: 1
+  due_day: 10,
+  payment_frequency: 'monthly',
+  amount: 500.00,
+  seller_id: 1,
+  contract_summary: 'Contrato mensal',
+  notes: 'Observacoes',
+  membership_fee: 100.00,
+  generate_sales: true,
+  prorata_type: 'proportional',
+  nfse_description: 'Servicos de coworking',
+  refund: {
+    amount: 1000.00,
+    date_limit: '2025-01-01',
+    is_to_generate_refund_billet: false
+  },
+  complementary_services: [
+    { product_or_service_id: 100, quantity: 1, amount: 50.00, notes: 'Servico extra' }
+  ],
+  service_correspondence_quotas: {
+    limited: true,
+    messages_limit: 100,
+    price_additional_message: 2.50
+  }
 )
 
 # Create with custom products (no plan)
@@ -162,8 +298,8 @@ contract = Conexa::Contract.create_with_products(
 # Find contract
 contract = Conexa::Contract.find(456)
 contract.status       # => "active"
-contract.plan_id      # => 5
-contract.payment_day  # => 10
+contract.active?      # => true
+contract.ended?       # => false
 
 # List contracts
 contracts = Conexa::Contract.all(
@@ -172,36 +308,81 @@ contracts = Conexa::Contract.all(
 )
 
 # End/terminate contract
-contract.end_contract(end_date: '2024-12-31', reason: 'Cliente solicitou')
+contract.end_contract(date: '2024-12-31', reason_id: 1, unlink_customer: false)
 # or
-Conexa::Contract.end_contract(456, end_date: '2024-12-31')
+Conexa::Contract.end_contract(456, date: '2024-12-31')
 
 # Update
-contract.payment_day = 15
+contract.due_day = 15
 contract.save
+
+# Delete
+contract.destroy
 ```
 
-**Contract attributes:**
-- `contract_id` - ID
-- `customer_id` - Customer ID
-- `plan_id` - Plan ID (optional)
-- `status` - Status (active, ended, cancelled)
+**API endpoints:** `POST /contract`, `GET /contract/:id`, `PATCH /contract/:id`, `DELETE /contract/:id`, `PATCH /contract/end/:id`, `GET /contracts`
+
+**Create attributes:**
+- `customer_id` - Customer ID (required)
+- `plan_id` - Plan ID (optional, alternative to items)
+- `payment_frequency` - monthly, bimonthly, quarterly, semester, yearly
 - `start_date` - Start date
-- `end_date` - End date (if terminated)
-- `payment_day` - Day of month for billing (1-28)
+- `end_date` - End date (optional)
+- `due_day` - Day of month for billing (1-28)
+- `fidelity_date` - Fidelity end date
+- `amount` - Contract value
+- `discount_value` - Discount value
+- `seller_id` - Seller user ID
+- `contract_summary` - Summary text
+- `notes` - Notes
+- `membership_fee` - Membership fee
+- `generate_sales` - Auto-generate sales (boolean)
+- `prorata_type` - Prorata type
+- `nfse_description` - NFSe description
+- `discount_on_rooms` - Room discount percentage
+- `discount_on_workstation` - Workstation discount percentage
+- `private_space_id` - Private space ID
+- `is_sms_enabled` - SMS notifications (boolean)
+- `refund` - Refund config: `amount`, `date_limit`, `is_to_generate_refund_billet`
+- `complementary_services` - Array of: `product_or_service_id`, `quantity`, `amount`, `notes`
+- `service_correspondence_quotas` - Quotas: `limited`, `messages_limit`, `price_additional_message`
+
+**End contract params:**
+- `date` - End date
+- `reason_id` - Reason ID
+- `unlink_customer` - Unlink customer (boolean)
+
+**Read-only attributes:**
+- `contract_id` - ID
+- `status` - active, ended, cancelled
+
+**Helper methods:**
+- `active?` - Check if active
+- `ended?` - Check if ended or cancelled
 
 ---
 
 ### Charge
 
-Manages invoices/boletos.
+Manages invoices/boletos. Charges are created from sales.
 
 ```ruby
+# Create charge from sales
+charge = Conexa::Charge.create(
+  sales_ids: [1234, 1235],
+  invoicing_method_id: 1,
+  due_date: '2024-02-10',
+  notes: 'Cobranca mensal'
+)
+
 # Find charge
 charge = Conexa::Charge.find(789)
 charge.status      # => "pending"
 charge.amount      # => 199.90
 charge.due_date    # => "2024-02-10"
+charge.paid?       # => false
+charge.pending?    # => true
+charge.overdue?    # => false
 
 # List charges
 charges = Conexa::Charge.all(
@@ -212,14 +393,20 @@ charges = Conexa::Charge.all(
 )
 
 # Settle (mark as paid)
-charge.settle(payment_date: '2024-02-05', payment_value: 199.90)
+charge.settle(
+  settlement_date: '2024-02-05',
+  paid_amount: 199.90,
+  account_id: 1,
+  send_email: true,
+  receiving_method: { id: 1, installments_quantity: 1 }
+)
 # or
-Conexa::Charge.settle(789, payment_date: '2024-02-05')
+Conexa::Charge.settle(789, settlement_date: '2024-02-05')
 
 # Get PIX QR Code
 pix = charge.pix
-pix.qr_code        # => "00020126..."
-pix.qr_code_image  # => Base64 image
+# or
+pix = Conexa::Charge.pix(789)
 
 # Send email notification
 charge.send_email
@@ -232,18 +419,39 @@ charge.cancel
 Conexa::Charge.cancel(789)
 ```
 
-**Charge attributes:**
+**API endpoints:** `POST /charge`, `GET /charge/:id`, `GET /charges`, `PATCH /charge/settle/:id`, `GET /charge/pix/:id`
+
+**Create attributes:**
+- `sales_ids` - Array of sale IDs to include in charge
+- `invoicing_method_id` - Payment method ID
+- `due_date` - Due date
+- `notes` - Notes
+
+**Settle attributes:**
+- `settlement_date` - Payment date
+- `paid_amount` - Amount paid
+- `account_id` - Bank account ID
+- `send_email` - Send confirmation email (boolean)
+- `receiving_method` - Payment method: `id`, `installments_quantity`
+
+**Read-only attributes:**
 - `charge_id` - ID
 - `customer_id` - Customer ID
-- `status` - Status (pending, paid, overdue, cancelled)
+- `status` - pending, paid, overdue, cancelled
 - `amount` - Amount due
 - `due_date` - Due date
+- `paid_at` - Payment date
+
+**Helper methods:**
+- `paid?` - Check if paid
+- `pending?` - Check if pending
+- `overdue?` - Check if overdue
 
-**Methods:**
-- `settle(params)` - Mark as paid
-- `pix` - Get PIX payment data
-- `send_email` - Send notification
-- `cancel` - Cancel charge
+**Special methods:**
+- `settle(params)` / `Charge.settle(id, params)` - Mark as paid
+- `pix` / `Charge.pix(id)` - Get PIX payment data
+- `send_email` / `Charge.send_email(id)` - Send notification
+- `cancel` / `Charge.cancel(id)` - Cancel charge
 
 ---
 
@@ -256,6 +464,8 @@ Manages one-time sales.
 sale = Conexa::Sale.create(
   customer_id: 450,
   product_id: 2521,
+  requester_id: 10,
+  seller_id: 1,
   quantity: 1,
   amount: 80.99,
   reference_date: '2024-01-15',
@@ -264,8 +474,11 @@ sale = Conexa::Sale.create(
 
 # Find sale
 sale = Conexa::Sale.find(1234)
-sale.status   # => "notBilled"
-sale.amount   # => 80.99
+sale.status      # => "notBilled"
+sale.amount      # => 80.99
+sale.editable?   # => true
+sale.billed?     # => false
+sale.paid?       # => false
 
 # List sales
 sales = Conexa::Sale.all(
@@ -283,6 +496,26 @@ sale.save
 sale.destroy
 ```
 
+**API endpoints:** `POST /sale`, `GET /sale/:id`, `PATCH /sale/:id`, `DELETE /sale/:id`, `GET /sales`
+
+**Create/update attributes:**
+- `customer_id` - Customer ID (required)
+- `product_id` - Product ID (required)
+- `requester_id` - Requester (person) ID
+- `seller_id` - Seller (user) ID
+- `quantity` - Quantity (required)
+- `amount` - Amount (required)
+- `reference_date` - Reference date
+- `notes` - Notes
+
+**Read-only attributes:**
+- `sale_id` - ID
+- `status` - Status string
+- `original_amount` - Original amount before discount
+- `discount_value` - Discount value
+- `created_at` - Creation timestamp
+- `updated_at` - Update timestamp
+
 **Sale statuses:**
 - `notBilled` - Not yet billed (editable)
 - `billed` - Included in a charge
@@ -293,6 +526,11 @@ sale.destroy
 - `billedNegociated` - Negotiated
 - `partiallyPaid` - Partially paid
 
+**Helper methods:**
+- `editable?` - Check if status is notBilled
+- `billed?` - Check if billed
+- `paid?` - Check if paid
+
 ---
 
 ### RecurringSale
@@ -300,6 +538,22 @@ sale.destroy
 Manages recurring items within contracts.
 
 ```ruby
+# Create recurring sale
+rs = Conexa::RecurringSale.create(
+  customer_id: 127,
+  type: 'product',           # 'package' or 'product'
+  reference_id: 100,         # product or package ID
+  requester_id: 10,
+  seller_id: 1,
+  is_repeat: true,
+  occurrence_quantity: 12,
+  frequency: 'monthly',
+  start_date: '2024-01-01',
+  quantity: 1,
+  amount: 99.90,
+  notes: 'Venda recorrente'
+)
+
 # Find recurring sale
 rs = Conexa::RecurringSale.find(555)
 
@@ -309,29 +563,124 @@ recurring = Conexa::RecurringSale.all(
   status: 'active'
 )
 
+# Update
+rs.amount = 109.90
+rs.save
+
 # End recurring sale
-rs.end_recurring_sale(end_date: '2024-12-31')
+rs.end_recurring_sale(date: '2024-12-31')
 # or
-Conexa::RecurringSale.end_recurring_sale(555, end_date: '2024-12-31')
+Conexa::RecurringSale.end_recurring_sale(555, date: '2024-12-31')
+
+# Delete
+rs.destroy
 ```
 
+**API endpoints:** `POST /recurringSale`, `GET /recurringSale/:id`, `PATCH /recurringSale/:id`, `DELETE /recurringSale/:id`, `PATCH /recurringSale/end/:id`, `GET /recurringSales`
+
+**Create attributes:**
+- `customer_id` - Customer ID
+- `type` - 'package' or 'product'
+- `reference_id` - Product or package ID
+- `requester_id` - Requester ID
+- `seller_id` - Seller ID
+- `is_repeat` - Is repeating (boolean)
+- `occurrence_quantity` - Number of occurrences
+- `frequency` - Frequency string
+- `start_date` - Start date
+- `last_adjustment_date` - Last price adjustment date
+- `quantity` - Quantity
+- `amount` - Amount
+- `notes` - Notes
+- `is_discount_previous_reservations` - Discount previous reservations (boolean)
+- `is_calculate_pro_rata` - Calculate pro rata (boolean)
+
+**Update attributes:**
+- `requester_id`, `amount`, `quantity`, `last_adjustment_date`, `notes`
+
 ---
 
 ### Plan
 
-Read-only resource for pricing plans.
+Pricing plans with products and periodicities.
 
 ```ruby
+# Create plan
+plan = Conexa::Plan.create(
+  company_id: 1,
+  name: 'Plano Basico',
+  service_category_id: 1,
+  cost_center_id: 10,
+  description: 'Plano com todos os recursos',
+  membership_fee: 200.00,
+  refund_value: 1500.00,
+  fidelity_months: 12,
+  due_day: 10,
+  nfse_description: 'Servicos de coworking',
+  receipt_description: 'Recibo mensal',
+  discount_on_rooms: 15.5,
+  discount_on_workstation: 10.0,
+  is_sms_enabled: true,
+  payment_periodicities: [
+    { periodicity: 'monthly', amount: 500.00 },
+    { periodicity: 'quarterly', amount: 1400.00 },
+    { periodicity: 'yearly', amount: 5000.00 }
+  ],
+  product_quotas: [
+    { product_id: 100, quantity: 10 },
+    { product_id: 101, quantity: 5 }
+  ],
+  service_correspondence_quotas: {
+    limited: true,
+    messages_limit: 100,
+    price_additional_message: 2.50
+  },
+  booking_models: [
+    { id: 1, stations: 2 }
+  ],
+  private_space_ids: [10, 11, 12],
+  hour_quotas: [
+    { hours: 10, periodicity: 'daily', space_id: 5 },
+    { hours: 40, periodicity: 'weekly', group_id: 3 }
+  ]
+)
+
 # Find plan
 plan = Conexa::Plan.find(5)
-plan.name   # => "Plano Básico"
-plan.amount # => 99.90
+plan.name   # => "Plano Basico"
 
 # List plans
 plans = Conexa::Plan.all(company_id: [3])
+
+# Delete
+plan.destroy
 ```
 
-**Note:** Plans cannot be created/updated via API. Use Conexa dashboard.
+**API endpoints:** `POST /plan`, `GET /plan/:id`, `PATCH /plan/:id`, `DELETE /plan/:id`, `GET /plans`
+
+**Note:** `save` (update) raises `NoMethodError` in the gem. Use `Conexa::Request` directly if needed.
+
+**Create attributes:**
+- `company_id` - Company ID (required)
+- `name` - Plan name (required, must be unique)
+- `service_category_id` - Service category ID (required)
+- `cost_center_id` - Cost center ID
+- `description` - Description
+- `membership_fee` - Membership fee
+- `refund_value` - Refund value
+- `fidelity_months` - Fidelity period in months
+- `due_day` - Default due day
+- `nfse_description` - NFSe description
+- `receipt_description` - Receipt description
+- `discount_on_rooms` - Room discount percentage
+- `discount_on_workstation` - Workstation discount percentage
+- `is_sms_enabled` - SMS enabled (boolean)
+- `payment_periodicities` - Array of: `periodicity` (monthly, bimonthly, quarterly, semester, yearly), `amount`
+- `product_quotas` - Array of: `product_id`, `quantity`
+- `service_correspondence_quotas` - `limited`, `messages_limit`, `price_additional_message`
+- `booking_models` - Array of: `id`, `stations`
+- `private_space_ids` - Array of space IDs
+- `hour_quotas` - Array of: `hours`, `periodicity`, `group_id`, `space_id`
 
 ---
 
@@ -348,15 +697,64 @@ product.name  # => "Mensalidade"
 products = Conexa::Product.all(company_id: [3])
 ```
 
-**Note:** Products cannot be created/updated via API. Use Conexa dashboard.
+**API endpoints:** `GET /product/:id`, `GET /products`
+
+**Note:** Products cannot be created/updated via this gem. `save` raises `NoMethodError`.
+
+---
+
+### InvoicingMethod
+
+Manages payment method configurations (boleto, PIX, credit card, etc.).
+
+```ruby
+# Find invoicing method
+method = Conexa::InvoicingMethod.find(1)
+method.invoicing_method_id  # => 1
+
+# List invoicing methods
+methods = Conexa::InvoicingMethod.all
+
+# Create
+method = Conexa::InvoicingMethod.create(
+  name: 'Boleto Bancario'
+)
+
+# Update
+method.save
+
+# Delete
+method.destroy
+```
+
+**API endpoints:** `GET /invoicingMethod/:id`, `GET /invoicingMethods`, `POST /invoicingMethod`, `PATCH /invoicingMethod/:id`, `DELETE /invoicingMethod/:id`
 
 ---
 
 ### Bill
 
-Read-only resource for financial bills (contas a pagar).
+Financial bills (contas a pagar).
 
 ```ruby
+# Create bill
+bill = Conexa::Bill.create(
+  company_id: 1,
+  due_date: '2024-03-15',
+  amount: 500.00,
+  subcategory_id: 1,
+  supplier_id: 50,
+  description: 'Aluguel escritorio',
+  account_id: 1,
+  document_date: '2024-03-01',
+  competence_date: '2024-03-01',
+  document_number: 'NF-001',
+  digitable_line: '23793.38128 60000.000003 00000.000400 1 84340000050000',
+  cost_centers: [
+    { id: 1, percentage: 100 }
+  ],
+  cac: { is_included: true, percentage: 5.0 }
+)
+
 # Find bill
 bill = Conexa::Bill.find(321)
 
@@ -364,6 +762,25 @@ bill = Conexa::Bill.find(321)
 bills = Conexa::Bill.all(company_id: [3])
 ```
 
+**API endpoints:** `POST /bill`, `GET /bill/:id`, `GET /bills`
+
+**Note:** `save` (update) raises `NoMethodError` in the gem.
+
+**Create attributes:**
+- `company_id` - Company ID
+- `due_date` - Due date
+- `amount` - Amount
+- `subcategory_id` - Subcategory ID
+- `supplier_id` - Supplier ID
+- `description` - Description
+- `account_id` - Bank account ID
+- `document_date` - Document date
+- `competence_date` - Competence date
+- `document_number` - Document number
+- `digitable_line` - Barcode digitable line
+- `cost_centers` - Array of: `id`, `percentage`
+- `cac` - CAC config: `is_included`, `percentage`
+
 ---
 
 ### Company
@@ -378,26 +795,81 @@ company = Conexa::Company.find(3)
 companies = Conexa::Company.all
 ```
 
+**API endpoints:** `GET /company/:id`, `GET /companies`
+
 ---
 
 ### Supplier
 
-Manages suppliers (fornecedores).
+Manages suppliers (fornecedores) with PF/PJ data.
 
 ```ruby
+# Create supplier (PJ)
+supplier = Conexa::Supplier.create(
+  name: 'Fornecedor XYZ Ltda',
+  field_of_activity: 'Servicos',
+  notes: 'Fornecedor principal',
+  cell_number: '31999998888',
+  phones: ['3133334444'],
+  emails: ['contato@xyz.com.br'],
+  website: 'https://www.xyz.com.br',
+  contact_person_names: ['Joao', 'Maria'],
+  legal_person: {
+    legal_name: 'Fornecedor XYZ Servicos Ltda',
+    cnpj: '12.345.678/0001-90',
+    state_inscription: '123456789',
+    municipal_inscription: '98765432'
+  },
+  address: {
+    zip_code: '30130000',
+    state: 'MG',
+    city: 'Belo Horizonte',
+    street: 'Rua da Bahia',
+    number: '500',
+    neighborhood: 'Centro',
+    additional_details: 'Sala 10'
+  }
+)
+
+# Create supplier (PF)
+supplier = Conexa::Supplier.create(
+  name: 'Joao Fornecedor',
+  natural_person: {
+    cpf: '123.456.789-00',
+    rg: '123456789',
+    issuing_authority: 'SSP/MG'
+  }
+)
+
 # Find supplier
 supplier = Conexa::Supplier.find(50)
 
 # List suppliers
 suppliers = Conexa::Supplier.all(company_id: [3])
 
-# Create supplier
-supplier = Conexa::Supplier.create(
-  company_id: 3,
-  name: 'Fornecedor XYZ'
-)
+# Update
+supplier.name = 'Novo Nome'
+supplier.save
+
+# Delete
+supplier.destroy
 ```
 
+**API endpoints:** `POST /supplier`, `GET /supplier/:id`, `PATCH /supplier/:id`, `DELETE /supplier/:id`, `GET /supplier` (list)
+
+**Create attributes:**
+- `name` - Supplier name (required)
+- `field_of_activity` - Field of activity
+- `notes` - Notes
+- `cell_number` - Cell phone
+- `phones` - Array of phones
+- `emails` - Array of emails
+- `website` - Website URL
+- `contact_person_names` - Array of contact names
+- `legal_person` - PJ data: `legal_name`, `cnpj`, `state_inscription`, `municipal_inscription`
+- `natural_person` - PF data: `cpf`, `rg`, `issuing_authority`
+- `address` - Address: `zip_code`, `state`, `city`, `street`, `number`, `neighborhood`, `additional_details`
+
 ---
 
 ### CreditCard
@@ -405,31 +877,143 @@ supplier = Conexa::Supplier.create(
 Manages customer credit cards.
 
 ```ruby
-# Find credit card
-card = Conexa::CreditCard.find(99)
-
-# Create (tokenized)
+# Create credit card
 card = Conexa::CreditCard.create(
   customer_id: 127,
-  token: 'card_token_from_gateway'
+  number: '4111111111111111',
+  name: 'JOAO DA SILVA',
+  expiration_date: '12/2026',
+  cvc: '123',
+  brand: 'visa',
+  default: true,
+  enable_recurring: true
 )
+
+# Find credit card
+card = Conexa::CreditCard.find(99)
+
+# Update
+card.default = true
+card.save
+
+# Delete
+card.destroy
 ```
 
+**API endpoints:** `POST /creditCard`, `GET /creditCard/:id`, `PATCH /creditCard/:id`, `DELETE /creditCard/:id`
+
+**Note:** `all` (listing) is not available for credit cards.
+
+**Create attributes:**
+- `customer_id` - Customer ID (required)
+- `number` - Card number
+- `name` - Cardholder name
+- `expiration_date` - Expiration date (MM/YYYY)
+- `cvc` - CVC code
+- `brand` - Card brand
+- `default` - Set as default (boolean)
+- `enable_recurring` - Enable for recurring charges (boolean)
+
 ---
 
 ### Person
 
-Manages requesters (solicitantes) for a customer. Limited API access.
+Manages requesters (solicitantes) linked to a customer. The API supports full CRUD.
 
 ```ruby
 # Create person for customer
 person = Conexa::Person.create(
   customer_id: 127,
   name: 'Maria Solicitante',
-  email: 'maria@empresa.com'
+  nationality: 'Brasileira',
+  place_of_birth: 'Belo Horizonte',
+  marital_status: 'single',
+  is_foreign: false,
+  is_company_partner: true,
+  is_guarantor: false,
+  cpf: '123.456.789-00',
+  rg: '123456789',
+  issuing_authority: 'SSP/MG',
+  birth_date: '1990-05-15',
+  cell_number: '31999998888',
+  phones: ['3133334444'],
+  emails: ['maria@empresa.com'],
+  sex: 'female',
+  job_title: 'Gerente',
+  profession: 'Administradora',
+  resume: 'Profissional experiente',
+  notes: 'Contato principal',
+  address: {
+    zip_code: '30130000',
+    state: 'MG',
+    city: 'Belo Horizonte',
+    street: 'Av. Afonso Pena',
+    number: '1000',
+    neighborhood: 'Centro',
+    additional_details: 'Sala 501'
+  },
+  devices: [
+    { nickname: 'Notebook', mac_address: 'AA:BB:CC:DD:EE:FF' }
+  ],
+  has_login_access: true,
+  login: 'maria@empresa.com',
+  password: 'SecurePass123',
+  permissions: ['finance', 'orders', 'rooms'],
+  can_receive_mail: true,
+  color: '#FF5733',
+  url_linkedin: 'https://linkedin.com/in/maria',
+  url_instagram: '@maria',
+  url_facebook: 'maria.fb',
+  url_twitter: '@maria'
 )
+
+# Update
+person.name = 'Maria Silva'
+person.save
+
+# Delete
+person.destroy
 ```
 
+**API endpoints:** `POST /person`, `GET /person/:id`, `PATCH /person/:id`, `DELETE /person/:id`, `GET /persons`
+
+**Note:** In the gem, `find`, `all`, and `find_by` raise `NoMethodError`. Use `Conexa::Request` directly if you need to retrieve or list persons.
+
+**Create/update attributes:**
+- `customer_id` - Customer ID (required)
+- `name` - Full name (required)
+- `nationality` - Nationality
+- `place_of_birth` - Place of birth
+- `marital_status` - Marital status
+- `is_foreign` - Is foreigner (boolean)
+- `foreign_data` - Foreign data object
+- `is_company_partner` - Is company partner (boolean)
+- `is_guarantor` - Is guarantor (boolean)
+- `cpf` - CPF number
+- `rg` - RG number
+- `issuing_authority` - RG issuing authority
+- `birth_date` - Birth date
+- `cell_number` - Cell phone
+- `phones` - Array of phones
+- `emails` - Array of emails
+- `sex` - Gender (male, female)
+- `job_title` - Job title
+- `profession` - Profession
+- `resume` - Resume/bio
+- `notes` - Notes
+- `address` - Address object
+- `devices` - Array of: `nickname`, `mac_address`
+- `has_login_access` - Has portal access (boolean)
+- `login` - Login email
+- `password` - Login password
+- `permissions` - Array of: finance, orders, rooms, shared_spaces, assistance, correspondences, printing
+- `access_id` - Access ID
+- `can_receive_mail` - Can receive mail (boolean)
+- `color` - Color code
+- `print_fee_id` - Print fee ID
+- `extension_numbers` - Extension numbers
+- `url_linkedin`, `url_instagram`, `url_facebook`, `url_twitter` - Social URLs
+
 ---
 
 ## Common Patterns
@@ -451,7 +1035,7 @@ page = 1
 loop do
   result = Conexa::Customer.all(page: page, size: 100)
   break if result.empty?
-  
+
   result.each { |customer| process(customer) }
   page += 1
 end
@@ -489,10 +1073,10 @@ end
 
 **Error classes:**
 - `Conexa::NotFound` - Resource not found (404)
-- `Conexa::ValidationError` - Validation failed (422)
+- `Conexa::ValidationError` - Validation failed (response without `message` key)
+- `Conexa::ResponseError` - API error with `message` key (400, 401, 422, 500)
 - `Conexa::ConnectionError` - Network error
-- `Conexa::ResponseError` - Generic API error
-- `Conexa::RequestError` - Invalid request parameters
+- `Conexa::RequestError` - Invalid request parameters (e.g., nil ID)
 - `Conexa::MissingCredentialsError` - Token not configured
 
 ### Filters
@@ -523,29 +1107,41 @@ Conexa::Charge.all(
 )
 ```
 
+### Rate Limiting
+
+The API enforces a limit of 100 requests per minute. Response headers:
+- `X-Rate-Limit-Limit` - Maximum requests per minute
+- `X-Rate-Limit-Remaining` - Remaining requests
+- `X-Rate-Limit-Reset` - Seconds until limit resets
+
 ---
 
 ## Model Methods Summary
 
 | Resource | find | all | create | save | destroy | Special Methods |
 |----------|------|-----|--------|------|---------|-----------------|
-| Customer | ✅ | ✅ | ✅ | ✅ | ✅ | - |
-| Contract | ✅ | ✅ | ✅ | ✅ | ✅ | end_contract |
-| Charge | ✅ | ✅ | ❌ | ❌ | ❌ | settle, pix, cancel, send_email |
-| Sale | ✅ | ✅ | ✅ | ✅ | ✅ | - |
-| RecurringSale | ✅ | ✅ | ✅ | ✅ | ✅ | end_recurring_sale |
-| Plan | ✅ | ✅ | ❌ | ❌ | ❌ | - |
-| Product | ✅ | ✅ | ❌ | ❌ | ❌ | - |
-| Bill | ✅ | ✅ | ❌ | ❌ | ❌ | - |
-| Company | ✅ | ✅ | ✅ | ✅ | ✅ | - |
-| Supplier | ✅ | ✅ | ✅ | ✅ | ✅ | - |
-| CreditCard | ✅ | ❌ | ✅ | ✅ | ✅ | - |
-| Person | ❌ | ❌ | ✅ | ✅ | ✅ | - |
+| Auth | - | - | - | - | - | login, authenticate |
+| Customer | yes | yes | yes | yes | yes | persons, contracts, charges |
+| Contract | yes | yes | yes | yes | yes | end_contract, create_with_products |
+| Charge | yes | yes | yes | - | - | settle, pix, cancel, send_email |
+| 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 | - | - | - | - |
+| InvoicingMethod | yes | yes | yes | 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 | - |
+
+**Legend:** `yes` = available, `-` = not available (raises NoMethodError or not implemented)
 
 ---
 
 ## Version History
 
+- **v0.0.7** - Add Auth resource, fix Auth.login, add test suite with VCR
 - **v0.0.6** - Fix nil guard in camelize_hash, fix Result#empty? delegation
 - **v0.0.5** - Initial public release
 

data/lib/conexa/model.rb

@@ -77,7 +77,7 @@ module Conexa
     end
 
     def primary_key_name
-      class_name.downcase + "_id"
+      Util.to_snake_case(class_name) + "_id"
     end
 
     def class_name
@@ -87,6 +87,7 @@ module Conexa
     def destroy
       raise RequestError.new('Invalid ID') unless id.present?
       update Conexa::Request.delete( self.class.show_url(primary_key) ).call(class_name)
+      self
     end
 
     class << self
@@ -116,7 +117,9 @@ module Conexa
       alias :where :all
 
       def destroy id
-        self.new(id: id).destroy
+        instance = self.new
+        instance.set_primary_key(id)
+        instance.destroy
       end
 
       def url(*params)

data/lib/conexa/resources/auth.rb

@@ -23,12 +23,10 @@ module Conexa
       #   # Use the token for subsequent requests
       #   Conexa.configure { |c| c.api_token = auth.access_token }
       def login(username:, password:)
-        response = Conexa::Request.post('/auth', params: {
+        Conexa::Request.auth('/auth', params: {
           username: username,
           password: password
         }).call('auth')
-        
-        new(response.to_h)
       end
 
       alias_method :authenticate, :login

data/lib/conexa/resources/person.rb

@@ -1,18 +1,4 @@
 module Conexa
   class Person < Model
-    class << self
-      def all(*args, **params)
-        raise NoMethodError
-      end
-
-      def find_by_id(id, **options)
-        raise NoMethodError
-      end
-
-
-      def find_by(params = Hash.new, page = nil, size = nil)
-        raise NoMethodError
-      end
-    end
   end
 end

data/lib/conexa/version.rb

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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: conexa
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Guilherme Gazzinelli
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -185,7 +184,6 @@ metadata:
   homepage_uri: https://github.com/guilhermegazzinelli/conexa-ruby
   source_code_uri: https://github.com/guilhermegazzinelli/conexa-ruby
   changelog_uri: https://github.com/guilhermegazzinelli/conexa-ruby/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -200,8 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Gem para integração com a Api da Conexa
 test_files: []