Class: MOCO::Receipt

Inherits:
BaseEntity show all
Defined in:
lib/moco/entities/receipt.rb

Overview

Represents a MOCO receipt/expense claim (Spesen)

Required attributes for create:

date     - String, "YYYY-MM-DD" format
title    - String, receipt description (e.g., "Team lunch")
currency - String, valid currency code (e.g., "EUR", "CHF")
items    - Array of item hashes (at least one required):
           { vat_code_id: 186, gross_total: 99.90 }

Optional attributes:

project_id - Integer, project to associate with
info       - String, additional notes
billable   - Boolean, whether expense is billable to customer
attachment - Hash, { filename: "receipt.pdf", base64: "..." }

Item attributes:

vat_code_id          - Integer, VAT code ID (required)
gross_total          - Float, total amount including tax (required)
purchase_category_id - Integer, expense category

Read-only attributes:

id, pending, user (Hash), project (Hash), refund_request (Hash),
attachment_url, created_at, updated_at

Example:

moco.receipts.create(
  date: "2024-01-15",
  title: "Client lunch",
  currency: "EUR",
  project_id: 123,
  billable: true,
  items: [
    { vat_code_id: 186, gross_total: 85.50 }
  ]
)

Filtering:

moco.receipts.where(from: "2024-01-01", to: "2024-01-31")
moco.receipts.where(project_id: 123)
moco.receipts.where(user_id: 456)

Instance Attribute Summary

Attributes inherited from BaseEntity

#attributes, #client

Instance Method Summary collapse

Methods inherited from BaseEntity

#==, #association, #destroy, #eql?, #has_many, #hash, #id, #initialize, #inspect, #reload, #save, #to_h, #to_json, #update

Constructor Details

This class inherits a constructor from MOCO::BaseEntity

Instance Method Details

#to_s ⇒ Object 



51
52
53
 
# File 'lib/moco/entities/receipt.rb', line 51

def to_s
  "#{title} (#{date})"
end

#user ⇒ Object

Associations



47
48
49
 
# File 'lib/moco/entities/receipt.rb', line 47

def user
  association(:user)
end