moco-ruby 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a32219e92cf0b5cc11f885486ec9a0afce63d39d2a2de95f3d5225b5521020e5
-  data.tar.gz: fa20563a9ff63d9b412540b99beecdab249ee7dca31608d23a47a82926062f27
+  metadata.gz: 05ee5448c599c6d3aa08e1b3ee7f39937fdd83504e1448058101442f2ea0b9f8
+  data.tar.gz: 66fef5ab73ebc81eaa8a8559ec4fd492fccf75e301ff8e0c7de7e3f0a1442caa
 SHA512:
-  metadata.gz: 63995cff5c2e36f43619a43e04208460d8aa3a899f06a8b4e0acc673655af550ac40f472519096a8da21d73d850705a4d4a10d788287eb6cac1a461d614c4139
-  data.tar.gz: 7be74a0104d6bfffd3d3bb93f6658db539ec1727e108795f69a63c1b38447d0876eb21187c0557936fa0b70d7457a4150bccd9eed3ba04e8df6f3d32c59179ef
+  metadata.gz: 693ac37ba7c053009c6c86e390e34acc76a63c4f0bf63e26c42da9045b26447a8c032753dc86c21f324ac49fbe9f8fa387d65aa2d0093dd5335b268510d976e0
+  data.tar.gz: 8f6fe03c4d08fe908ea307c5ca00133b033ebb532100b2e40974a39ec64b2b29ebea3ce2f6ad2cc1836444fa82b4607944203cc63e5e53f03f8a673963496910

data/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-10-06
+
+### Added
+- Offer confirmations with CRUD and PDF downloads; revenue categories with CRUD.
+- Planned purchases, invoice/purchase approvals, absence requests, and read-only to-dos.
+- Company archive/unarchive, recurring expense execution, purchase draft PDF downloads,
+  purchase budget annual targets, catalog service item operations, and offer customer approval helpers.
+- Planned-versus-tracked report and optional Bearer authentication (`auth_scheme: :bearer`).
+- Mocked regression tests for API resources, actions, fields, and filters; `rake test` runs the mocked suite.
+
+### Fixed
+- Entity updates accept fields absent from the response; saved and reloaded entities expose response attributes.
+- Nested entities use their parent collection for save, reload, and deletion.
+- Account-level nested resources use their parent's API path.
+
+### Documentation
+- Document offer editing/deletion, draft creation/deletion, writable budgets and revenue
+  categories, and additional API fields and filters from the current OpenAPI reference.
+
 ## [1.3.0] - 2026-05-23
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    moco-ruby (1.3.0)
+    moco-ruby (1.4.0)
       activesupport (>= 7.0)
       faraday (>= 2.0)
       fuzzy_match (~> 2.1.0)

data/README.md

@@ -217,6 +217,95 @@ moco.offers.find(123).attachments.create(
 )
 ```
 
+### API Resources and Actions (2025–2026)
+
+The [OpenAPI reference](https://docs.mocoapp.com/api/docs/v1) defines supported
+operations, required fields, permissions, and filters. Collections accept API fields
+unchanged through `create`, `update`, and `where`; response fields are available as
+entity attributes. Only call operations documented for that resource (for example,
+`todos` is read-only, and invoices do not have a general update endpoint).
+
+```ruby
+# Offer confirmations: list, find, create, update, delete, and PDF download
+confirmation = moco.offer_confirmations.create(offer_id: 123, title: "Order confirmation")
+confirmation.update(footer_raw: "<p>Thank you!</p>")
+confirmation.pdf(letter_paper_id: 42)
+moco.offers.find(123).confirmations.all
+
+# Offers support full updates and deletion
+moco.offers.update(123, title: "Website proposal", items: [...])
+moco.offers.delete(123)
+
+# Revenue categories: list, find, create, update, and delete
+moco.revenue_categories.where(term: "Consulting").all
+moco.revenue_categories.create(name: "Consulting", assignment_kind: "tasks_and_expenses")
+
+# Purchase drafts: list, find, create, delete, and PDF download
+moco.purchase_drafts.create(
+  title: "Supplier invoice",
+  file: { filename: "invoice.pdf", base64: Base64.strict_encode64(File.binread("invoice.pdf")) }
+)
+
+# Company archiving and early execution of recurring additional services
+moco.companies.find(123).archive
+moco.companies.find(123).unarchive
+moco.projects.find(123).recurring_expenses.find(456).recur
+
+# Purchase budgets support creation, updates, deletion, and annual targets
+moco.purchase_budgets.where(year: 2026).all
+budget = moco.purchase_budgets.create(title: "Infrastructure")
+budget.update_target(target_amount: 12_000, year: 2026)
+
+# Planned purchases support list, find, create, update, and delete
+moco.planned_purchases.create(
+  date: "2026-08-01", title: "Hosting", net_total: 100, currency: "EUR", user_id: 123
+)
+
+# Invoice/purchase approvals: list, find, create, delete, approve, and deny
+approval = moco.approvals.create(target_type: "purchase", target_id: 123, approver_id: 456)
+approval.approve
+# Or: approval.deny(note: "Please check the amount")
+
+# Absence requests: list, find, create, and delete
+moco.absence_requests.where(user_id: 123).all
+moco.absence_requests.find(456).destroy(comment: "Cancelled")
+
+# To-dos are read-only
+moco.todos.where(completed: false).all
+moco.todos.find(123)
+
+# Catalog items are listed in the parent; individual items support CRUD
+service = moco.catalog_services.find(123)
+service.items.all
+service.items.create(type: "item", title: "Consulting", quantity: 1, unit: "h", unit_price: 150)
+service.items.find(456).update(unit_cost: 75)
+
+# Online customer approval for offers
+moco.offers.find(123).activate_customer_approval
+moco.offers.find(123).customer_approval
+moco.offers.find(123).deactivate_customer_approval
+```
+
+New fields need no schema configuration. Examples include `skip_favorite` on projects,
+`task_id` on planning entries, `invoice_format`, `default_payment_means`,
+`customer_vat_code_id`, `supplier_vat_code_id`, `bank_owner`, and `bank_bic` on companies,
+`welcome_email` on users, and `created_at` on comments. User creation does not require
+`password`. Filter users by `email` and schedules by `absence_request_id`.
+
+Use `vat_code_id` on invoices and purchase items rather than the deprecated `tax`
+value. Offer/invoice items accept `revenue_category_id`; offer items also accept
+`unit_cost`. Project expenses accept `revenue_category_id`, `service_period_from`,
+`service_period_to`, `planned_purchase_date`, and `cost_total_planned`.
+Response fields such as activity `worked_seconds`, reminder `status` / `file_url`,
+invoice `creditor_reference`, comment `impersonating_user`, and draft `net_total` /
+`gross_total` are exposed automatically.
+
+Bearer authentication is optional; Token authentication is the default:
+
+```ruby
+moco = MOCO::Client.new(subdomain: "your-subdomain", api_key: "your-api-key", auth_scheme: :bearer)
+```
+
 ### Reports
 
 Access read-only report endpoints:
@@ -231,6 +320,11 @@ utilization = moco.reports.utilization(from: "2024-01-01", to: "2024-12-31")
 # Financial reports
 cashflow = moco.reports.cashflow(from: "2024-01-01", to: "2024-03-31")
 finance = moco.reports.finance(from: "2024-01-01", to: "2024-03-31")
+
+# Planned versus tracked hours (optional date range and filters)
+planned_vs_tracked = moco.reports.planned_vs_tracked(
+  from: "2026-01-01", to: "2026-01-31", user_ids: "123,456", project_id: 789
+)
 ```
 
 ### Supported Entities
@@ -241,19 +335,19 @@ The gem supports all MOCO API entities with a Ruby-esque interface:
 `Project`, `Activity`, `User`, `Company`, `Task`, `Invoice`, `Deal`, `Expense`, `WebHook`, `Schedule`, `Presence`, `Holiday`, `PlanningEntry`
 
 **Business:**
-`Contact`, `Offer`, `Purchase`, `Receipt`, `Comment`, `Tag`, `Tagging`, `DealCategory`, `ProjectGroup`, `Unit`
+`Contact`, `Offer`, `OfferConfirmation`, `Purchase`, `PlannedPurchase`, `Receipt`, `Comment`, `Tag`, `Tagging`, `DealCategory`, `ProjectGroup`, `Unit`, `Approval`, `AbsenceRequest`, `Todo` (read-only)
 
 **Account Settings:**
 `CatalogService`, `CustomProperty`, `ExpenseTemplate`, `FixedCost`, `HourlyRate`, `InternalHourlyRate`, `TaskTemplate`, `UserRole`
 
 **Financial:**
-`VatCodeSale`, `VatCodePurchase`, `PurchaseCategory`, `PurchaseDraft`, `PurchaseBudget`, `PurchasePayment`
+`VatCodeSale`, `VatCodePurchase`, `RevenueCategory`, `PurchaseCategory`, `PurchaseDraft`, `PurchaseBudget`, `PurchasePayment`
 
 **Bookkeeping:**
 `InvoiceBookkeepingExport`, `PurchaseBookkeepingExport`
 
 **Nested Resources:**
-`Employment`, `WorkTimeAdjustment`, `ProjectContract`, `PaymentSchedule`, `RecurringExpense`, `InvoicePayment`, `InvoiceReminder`, `OfferApproval`, `InvoiceAttachment`, `OfferAttachment`
+`Employment`, `WorkTimeAdjustment`, `ProjectContract`, `PaymentSchedule`, `RecurringExpense`, `InvoicePayment`, `InvoiceReminder`, `OfferApproval`, `InvoiceAttachment`, `OfferAttachment`, `CatalogServiceItem`
 
 **Misc:**
 `LetterPaper` (read-only), `Session` (for API key exchange/verification)
@@ -323,6 +417,8 @@ The gem includes unit tests (mocked) and integration tests (live API):
 
 ```bash
 # Unit tests (mocked, fast)
+bundle exec rake test
+bundle exec ruby -Ilib -Itest test/test_api_updates.rb
 bundle exec ruby -Ilib -Itest test/test_v2_api.rb
 bundle exec ruby -Ilib -Itest test/test_new_entities.rb
 

data/Rakefile

@@ -2,6 +2,12 @@
 
 require "bundler/gem_tasks"
 require "rubocop/rake_task"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |task|
+  task.libs << "lib" << "test"
+  task.test_files = FileList["test/test_v2_api.rb", "test/test_new_entities.rb", "test/test_api_updates.rb"]
+end
 
 RuboCop::RakeTask.new
 

data/lib/moco/client.rb

@@ -6,8 +6,8 @@ module MOCO
   class Client
     attr_reader :connection
 
-    def initialize(subdomain:, api_key:, debug: false)
-      @connection = Connection.new(self, subdomain, api_key, debug: debug)
+    def initialize(subdomain:, api_key:, debug: false, auth_scheme: :token)
+      @connection = Connection.new(self, subdomain, api_key, debug: debug, auth_scheme: auth_scheme)
       @collections = {}
     end
 
@@ -102,6 +102,10 @@ module MOCO
       @client.get("report/finance", params)
     end
 
+    def planned_vs_tracked(from: nil, to: nil, **filters)
+      @client.get("report/planned_vs_tracked", { from:, to: }.merge(filters).compact)
+    end
+
     # Get utilization report
     # @param from [String] start date (YYYY-MM-DD) - required
     # @param to [String] end date (YYYY-MM-DD) - required

data/lib/moco/collection_proxy.rb

@@ -112,18 +112,18 @@ module MOCO
       klass = entity_class
       return nil unless klass && klass <= MOCO::BaseEntity
 
-      klass.new(client, client.post(@base_path, attributes))
+      build_entity(client.post(@base_path, attributes))
     end
 
     def update(id, attributes)
       klass = entity_class
       return nil unless klass && klass <= MOCO::BaseEntity
 
-      klass.new(client, client.put("#{@base_path}/#{id}", attributes))
+      build_entity(client.put("#{@base_path}/#{id}", attributes))
     end
 
-    def delete(id)
-      client.delete("#{@base_path}/#{id}")
+    def delete(id, params = {})
+      client.delete("#{@base_path}/#{id}", params)
     end
 
     # --- Internal Methods ---
@@ -178,6 +178,12 @@ module MOCO
 
     private
 
+    def build_entity(data)
+      entity = entity_class.new(client, data)
+      entity.collection = self
+      entity
+    end
+
     # Wraps the raw API response (Hash or Array of Hashes) into entity objects.
     def wrap_response(response_body)
       klass = entity_class
@@ -186,10 +192,10 @@ module MOCO
 
       if response_body.is_a?(Array)
         # Convert array of hashes to array of entity objects
-        response_body.map { |item_hash| klass.new(client, item_hash) if item_hash.is_a?(Hash) }.compact
+        response_body.map { |item_hash| build_entity(item_hash) if item_hash.is_a?(Hash) }.compact
       elsif response_body.is_a?(Hash)
         # Wrap single hash response in an array for consistency internally
-        [klass.new(client, response_body)]
+        [build_entity(response_body)]
       else
         # Handle unexpected response types (like the String error we saw)
         warn "Warning: Unexpected API response type received in wrap_response: #{response_body.class}. Expected Hash or Array."

data/lib/moco/connection.rb

@@ -9,7 +9,9 @@ module MOCO
   class Connection
     attr_reader :client, :subdomain, :api_key, :debug
 
-    def initialize(client, subdomain, api_key, debug: false)
+    def initialize(client, subdomain, api_key, debug: false, auth_scheme: :token)
+      raise ArgumentError, "auth_scheme must be :token or :bearer" unless %i[token bearer].include?(auth_scheme)
+
       @client = client
       @subdomain = subdomain
       @api_key = api_key
@@ -17,7 +19,11 @@ module MOCO
       @conn = Faraday.new do |f|
         f.request :json
         f.response :json
-        f.request :authorization, "Token", "token=#{@api_key}"
+        if auth_scheme == :bearer
+          f.request :authorization, "Bearer", @api_key
+        else
+          f.request :authorization, "Token", "token=#{@api_key}"
+        end
         f.url_prefix = "https://#{@subdomain}.mocoapp.com/api/v1"
       end
     end

data/lib/moco/entities/absence_request.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Staff absence request for vacation, sickness, or other absences.
+  class AbsenceRequest < BaseEntity
+    def self.entity_path
+      "users/absence_requests"
+    end
+  end
+end

data/lib/moco/entities/approval.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Approval request for an invoice or purchase.
+  class Approval < BaseEntity
+    def approve
+      self.class.new(client, client.post("approvals/#{id}/approve"))
+    end
+
+    def deny(note: nil)
+      self.class.new(client, client.post("approvals/#{id}/deny", { note: }.compact))
+    end
+  end
+end

data/lib/moco/entities/base_entity.rb

@@ -6,6 +6,7 @@ module MOCO
   # Base class for all MOCO API entities
   class BaseEntity
     attr_reader :client, :attributes
+    attr_writer :collection
 
     # Initializes an entity instance from raw API response data (Hash).
     # Recursively processes nested hashes and arrays, converting known
@@ -76,10 +77,11 @@ module MOCO
       # Check if the client responds to the collection method
       if client.respond_to?(collection_name)
         # Use the collection proxy to update the entity
-        updated_data = client.send(collection_name).update(id, attributes)
+        updated_data = (@collection || client.send(collection_name)).update(id, to_h)
 
         # Update local attributes with the response data
         @attributes = updated_data.attributes if updated_data
+        define_attribute_methods
       else
         warn "Warning: Client does not respond to collection '#{collection_name}' for saving entity."
       end
@@ -92,8 +94,9 @@ module MOCO
     def update(new_attributes)
       # Update attributes
       new_attributes.each do |key, value|
-        send("#{key}=", value) if respond_to?("#{key}=")
+        attributes[key.to_sym] = process_value(value, key.to_sym)
       end
+      define_attribute_methods
 
       # Save changes
       save
@@ -101,7 +104,7 @@ module MOCO
 
     # Deletes the entity from the API.
     # Returns true on success, false on failure.
-    def destroy
+    def destroy(**params)
       return false if id.nil? # Can't destroy without an ID
 
       # Determine the collection name from the class name
@@ -110,7 +113,8 @@ module MOCO
       # Check if the client responds to the collection method
       if client.respond_to?(collection_name)
         # Use the collection proxy to delete the entity
-        client.send(collection_name).delete(id)
+        collection = @collection || client.send(collection_name)
+        params.empty? ? collection.delete(id) : collection.delete(id, params.compact)
         true
       else
         warn "Warning: Client does not respond to collection '#{collection_name}' for destroying entity."
@@ -129,10 +133,11 @@ module MOCO
       # Check if the client responds to the collection method
       if client.respond_to?(collection_name)
         # Use the collection proxy to find the entity
-        reloaded = client.send(collection_name).find(id)
+        reloaded = (@collection || client.send(collection_name)).find(id)
 
         # Update attributes with the reloaded data
         @attributes = reloaded.attributes if reloaded
+        define_attribute_methods
       else
         warn "Warning: Client does not respond to collection '#{collection_name}' for reloading entity."
       end

data/lib/moco/entities/catalog_service.rb

@@ -47,8 +47,21 @@ module MOCO
       "account/catalog_services"
     end
 
+    def items
+      CatalogServiceItemsProxy.new(client, self, :items, "CatalogServiceItem")
+    end
+
     def to_s
       name.to_s
     end
   end
+
+  # Catalog items are listed inside the parent, not at a collection endpoint.
+  class CatalogServiceItemsProxy < NestedCollectionProxy
+    def load_records
+      @records = wrap_response(parent.attributes.fetch(:items, []).map { |item| item.is_a?(BaseEntity) ? item.to_h : item })
+      @loaded = true
+      @records
+    end
+  end
 end

data/lib/moco/entities/catalog_service_item.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Line item within an account catalog service.
+  class CatalogServiceItem < BaseEntity
+  end
+end

data/lib/moco/entities/company.rb

@@ -59,6 +59,16 @@ module MOCO
   #   )
   #
   class Company < BaseEntity
+    def archive
+      client.put("companies/#{id}/archive")
+      self
+    end
+
+    def unarchive
+      client.put("companies/#{id}/unarchive")
+      self
+    end
+
     # Associations
     def projects
       has_many(:projects)

data/lib/moco/entities/invoice.rb

@@ -9,7 +9,7 @@ module MOCO
   #   date              - String, "YYYY-MM-DD" invoice date
   #   due_date          - String, "YYYY-MM-DD" payment due date
   #   title             - String, invoice title (e.g., "Invoice")
-  #   tax               - Float, tax rate percentage (e.g., 19.0)
+  #   vat_code_id       - Integer, sales VAT code ID (tax percentage is deprecated)
   #   currency          - String, 3-letter code (e.g., "EUR")
   #   items             - Array of Hashes, invoice line items (see below)
   #
@@ -47,7 +47,7 @@ module MOCO
   #     date: "2024-01-15",
   #     due_date: "2024-02-15",
   #     title: "Invoice",
-  #     tax: 19.0,
+  #     vat_code_id: 123,
   #     currency: "EUR",
   #     items: [
   #       { type: "title", title: "Services January 2024" },

data/lib/moco/entities/offer.rb

@@ -91,6 +91,23 @@ module MOCO
       MOCO::NestedCollectionProxy.new(client, self, :attachments, "OfferAttachment")
     end
 
+    def confirmations
+      CollectionProxy.new(client, "offer_confirmations", "OfferConfirmation").where(offer_id: id)
+    end
+
+    def customer_approval
+      OfferApproval.new(client, client.get("offers/#{id}/customer_approval"))
+    end
+
+    def activate_customer_approval
+      OfferApproval.new(client, client.post("offers/#{id}/customer_approval/activate"))
+    end
+
+    def deactivate_customer_approval
+      client.post("offers/#{id}/customer_approval/deactivate")
+      self
+    end
+
     # Associations
     def company
       association(:customer, "Company")

data/lib/moco/entities/offer_approval.rb

@@ -23,7 +23,7 @@ module MOCO
   #   approval = moco.get("offers/123/customer_approval")
   #
   #   # Deactivate (revoke access)
-  #   moco.put("offers/123/customer_approval/deactivate")
+  #   moco.post("offers/123/customer_approval/deactivate")
   #
   # == Note:
   #   Check signed_at to determine if the customer has signed.

data/lib/moco/entities/offer_confirmation.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Confirmation document for an accepted offer.
+  class OfferConfirmation < BaseEntity
+    def pdf(letter_paper_id: nil)
+      client.get("offer_confirmations/#{id}.pdf", { letter_paper_id: }.compact)
+    end
+
+    def offer
+      association(:offer)
+    end
+
+    def user
+      association(:user)
+    end
+  end
+end

data/lib/moco/entities/planned_purchase.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Planned outgoing expense, optionally recurring.
+  class PlannedPurchase < BaseEntity
+    def company
+      association(:company)
+    end
+
+    def user
+      association(:user)
+    end
+
+    def purchase_budget
+      association(:purchase_budget)
+    end
+  end
+end

data/lib/moco/entities/purchase.rb

@@ -10,7 +10,7 @@ module MOCO
   #                    "bank_transfer", "direct_debit", "credit_card",
   #                    "paypal", "cash", "bank_transfer_swiss_qr_esr"
   #   items          - Array of item hashes (at least one required):
-  #                    { title: "Item", total: 100.0, tax: 7.7, tax_included: true }
+  #                    { title: "Item", total: 100.0, vat_code_id: 123, tax_included: true }
   #
   # == Optional attributes:
   #   title              - String, purchase title (auto-generated from items if omitted)
@@ -31,7 +31,7 @@ module MOCO
   # == Item attributes:
   #   title        - String, item description
   #   total        - Float, item total amount
-  #   tax          - Float, tax percentage (e.g., 7.7)
+  #   vat_code_id  - Integer, purchase VAT code ID (tax percentage is deprecated)
   #   tax_included - Boolean, whether total includes tax
   #   category_id  - Integer, purchase category ID
   #
@@ -47,7 +47,7 @@ module MOCO
   #     payment_method: "bank_transfer",
   #     company_id: 456,
   #     items: [
-  #       { title: "Office supplies", total: 119.0, tax: 19.0, tax_included: true }
+  #       { title: "Office supplies", total: 119.0, vat_code_id: 123, tax_included: true }
   #     ],
   #     tags: ["Office"]
   #   )

data/lib/moco/entities/purchase_budget.rb

@@ -2,7 +2,7 @@
 
 module MOCO
   # Represents a MOCO purchase budget (Ausgaben – Budgets)
-  # Read-only budget tracking for expense categories
+  # Budget tracking for expense categories
   #
   # == Read-only attributes:
   #   id, title, year, target, exhausted, remaining,
@@ -19,8 +19,7 @@ module MOCO
   #   end
   #
   # == Note:
-  #   Purchase budgets are configured in MOCO's admin interface.
-  #   This endpoint provides read-only access for tracking.
+  #   Purchase budgets support create, update, delete, and annual target amounts.
   #
   class PurchaseBudget < BaseEntity
     # Custom path since it's nested under purchases
@@ -28,6 +27,10 @@ module MOCO
       "purchases/budgets"
     end
 
+    def update_target(target_amount:, year: nil)
+      self.class.new(client, client.put("purchases/budgets/#{id}/target", { target_amount:, year: }.compact))
+    end
+
     def to_s
       "PurchaseBudget #{id}: #{title} (#{year})"
     end

data/lib/moco/entities/purchase_draft.rb

@@ -2,15 +2,18 @@
 
 module MOCO
   # Represents a MOCO purchase draft
-  # Auto-created draft purchases from document scanning
+  # Create drafts with a base64-encoded file; convert them in the MOCO interface.
   #
-  # == Read-only attributes:
+  # == Create attributes:
+  #   title - String, required
+  #   file  - Optional Hash, { filename: "invoice.pdf", base64: "..." }
+  #
+  # == Response attributes:
   #   id, title, date, company (Hash), file_url,
   #   items (Array), created_at, updated_at
   #
   # == Note:
-  #   Purchase drafts are created automatically when documents
-  #   are uploaded/scanned in MOCO's inbox.
+  #   Purchase drafts can be created through the API or MOCO's inbox.
   #   Convert to actual purchases via the MOCO interface.
   #
   class PurchaseDraft < BaseEntity
@@ -18,6 +21,10 @@ module MOCO
       "purchases/drafts"
     end
 
+    def pdf
+      client.get("purchases/drafts/#{id}.pdf")
+    end
+
     def to_s
       "Draft ##{id}"
     end

data/lib/moco/entities/recurring_expense.rb

@@ -43,6 +43,14 @@ module MOCO
   #   start_date and period cannot be modified after creation.
   #
   class RecurringExpense < BaseEntity
+    def recur(project_id: nil)
+      project_id ||= @collection.parent.id if @collection.is_a?(NestedCollectionProxy)
+      project_id ||= attributes[:project_id] || project&.id
+      raise ArgumentError, "project_id is required" unless project_id
+
+      client.post("projects/#{project_id}/recurring_expenses/#{id}/recur")
+    end
+
     # Associations
     def project
       association(:project)

data/lib/moco/entities/revenue_category.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Revenue account category for tasks and additional services.
+  class RevenueCategory < BaseEntity
+    def to_s
+      name
+    end
+  end
+end

data/lib/moco/entities/todo.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module MOCO
+  # Read-only to-do entry.
+  class Todo < BaseEntity
+  end
+end

data/lib/moco/nested_collection_proxy.rb

@@ -17,7 +17,8 @@ module MOCO
       parent_type = ActiveSupport::Inflector.underscore(parent.class.name.split("::").last)
       # Use simple tableized name, not entity_path (which might include 'projects/' prefix)
       nested_path = ActiveSupport::Inflector.tableize(path_or_entity_name.to_s)
-      "#{parent_type.pluralize}/#{parent.id}/#{nested_path}"
+      parent_path = parent.class.respond_to?(:entity_path) ? parent.class.entity_path : parent_type.pluralize
+      "#{parent_path}/#{parent.id}/#{nested_path}"
     end
 
     # Create a new entity in this nested collection
@@ -25,7 +26,7 @@ module MOCO
       klass = entity_class
       return nil unless klass && klass <= MOCO::BaseEntity
 
-      klass.new(client, client.post(@base_path, attributes))
+      build_entity(client.post(@base_path, attributes))
     end
 
     # Delete all entities in this nested collection

data/lib/moco/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MOCO
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 end

data/lib/moco.rb

@@ -41,9 +41,16 @@ require_relative "moco/entities/tagging"
 require_relative "moco/entities/deal_category"
 require_relative "moco/entities/project_group"
 require_relative "moco/entities/profile"
+require_relative "moco/entities/offer_confirmation"
+require_relative "moco/entities/revenue_category"
+require_relative "moco/entities/planned_purchase"
+require_relative "moco/entities/todo"
+require_relative "moco/entities/absence_request"
+require_relative "moco/entities/approval"
 
 # Account-level entities
 require_relative "moco/entities/catalog_service"
+require_relative "moco/entities/catalog_service_item"
 require_relative "moco/entities/custom_property"
 require_relative "moco/entities/expense_template"
 require_relative "moco/entities/fixed_cost"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moco-ruby
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Teal Bauer
@@ -78,9 +78,12 @@ files:
 - lib/moco/collection_proxy.rb
 - lib/moco/connection.rb
 - lib/moco/entities.rb
+- lib/moco/entities/absence_request.rb
 - lib/moco/entities/activity.rb
+- lib/moco/entities/approval.rb
 - lib/moco/entities/base_entity.rb
 - lib/moco/entities/catalog_service.rb
+- lib/moco/entities/catalog_service_item.rb
 - lib/moco/entities/comment.rb
 - lib/moco/entities/company.rb
 - lib/moco/entities/contact.rb
@@ -103,7 +106,9 @@ files:
 - lib/moco/entities/offer.rb
 - lib/moco/entities/offer_approval.rb
 - lib/moco/entities/offer_attachment.rb
+- lib/moco/entities/offer_confirmation.rb
 - lib/moco/entities/payment_schedule.rb
+- lib/moco/entities/planned_purchase.rb
 - lib/moco/entities/planning_entry.rb
 - lib/moco/entities/presence.rb
 - lib/moco/entities/profile.rb
@@ -122,12 +127,14 @@ files:
 - lib/moco/entities/reports/cashflow.rb
 - lib/moco/entities/reports/finance.rb
 - lib/moco/entities/reports/utilization.rb
+- lib/moco/entities/revenue_category.rb
 - lib/moco/entities/schedule.rb
 - lib/moco/entities/session.rb
 - lib/moco/entities/tag.rb
 - lib/moco/entities/tagging.rb
 - lib/moco/entities/task.rb
 - lib/moco/entities/task_template.rb
+- lib/moco/entities/todo.rb
 - lib/moco/entities/unit.rb
 - lib/moco/entities/user.rb
 - lib/moco/entities/user_role.rb
@@ -165,7 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.20
 specification_version: 4
 summary: A Ruby Gem to interact with the MOCO API.
 test_files: []