POST /api/transactions
Create receipt

Creates new receipt. Also, auto-applies account rules

Params

Param name Description
draft
optional

Whether created receipt should be in draft state. If the value of this param is 1, receipt will be saved as draft and will not be validated; otherwise, it will be either in reviewing or queue state (depending on whether its user has approvers or not).

Validations:

  • Must be a Integer
transaction
required

Receipt hash

Validations:

  • Must be a Hash
transaction[description]
required

Receipt description

Validations:

  • Must be a String
transaction[participants]
optional , nil allowed

Additional description (e.g. participants). Required based on ExpenseAccount settings

Validations:

  • Must be a String
transaction[date]
required

Receipt date

Validations:

  • Must be a String
transaction[credit_account_id]
required

Validations:

  • Must be a Integer
transaction[vendor_id]
optional , nil allowed

Vendor ID (optional)

Validations:

  • Must be a Integer
transaction[printed_id]
optional , nil allowed

Printed receipt ID (optional)

Validations:

  • Must be a String
transaction[attachment_ids]
optional , nil allowed

Validations:

  • Must be an array of Integer
transaction[vat_lines_attributes]
required

VAT lines

Validations:

  • Must be an Array of nested elements
transaction[vat_lines_attributes][taxable]
required

Taxable amount, e.g. 95.5

Validations:

  • Must be a String
transaction[vat_lines_attributes][tax_percentage]
required

VAT percentage, e.g. “0.14” for 14%

Validations:

  • Must be a String
transaction[vat_lines_attributes][vat_id]
optional , nil allowed

VAT ID

Validations:

  • Must be a Integer
transaction[vat_lines_attributes][currency]
required

VAT line currency code, e.g. “EUR”

Validations:

  • Must be a String
transaction[vat_lines_attributes][expense_account_id]
required

Expense account ID per VAT line, required for the 1st line, optional for 2nd+

Validations:

  • Must be a Integer
transaction[vat_lines_attributes][cost_center_ids]
optional , nil allowed

If the values for the 2nd+ VAT line is not provided, they will be copied from the 1st line

Validations:

  • Must be an array of Integer
transaction[vat_lines_attributes][vat_code_id]
optional , nil allowed

VAT code ID (either global or company-specific).

If the value for the 2nd+ VAT line is not provided, it will be copied from the 1st line

Validations:

  • Must be a Integer