/moco-purchases | Type: Application | PCID required: Yes
Tools
moco_purchases_create_purchases
Create purchase Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bank_account_number | string | No | — | Bank Account Number |
cash_discount_rate | number | No | — | Cash Discount Rate |
cash_discount_until | string | No | — | Cash Discount Until |
company_id | integer | No | — | Company Id |
cost_center_id | integer | No | — | Cost Center Id |
currency | string | No | — | The currency value |
custom_properties | object | No | — | Custom Properties |
date | string | No | — | The date value |
due_date | string | No | — | Due Date |
file | object | No | — | The file value |
iban | string | No | — | The iban value |
inbound_email_id | integer | No | — | Inbound Email Id |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
payment_method | string | No | — | Payment Method |
purchase_draft_id | integer | No | — | Purchase Draft Id |
receipt_identifier | string | No | — | Receipt Identifier |
reference | string | No | — | The reference value |
service_period_from | string | No | — | Service Period From |
service_period_to | string | No | — | Service Period To |
tags | string[] | No | — | The tags value |
title | string | No | — | The title value |
user_id | integer | No | — | User Id |
moco_purchases_create_purchases_assign_to_project
Assign purchase item to project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
billable | boolean | No | — | The billable value |
budget_relevant | boolean | No | — | Budget Relevant |
expense_id | integer | No | — | Existing expense ID to attach to. |
item_id | integer | No | — | Single purchase item ID. |
notify_project_leader | boolean | No | — | Notify Project Leader |
project_id | integer | Yes | — | Project Id |
surcharge | number | No | — | The surcharge value |
moco_purchases_create_purchases_bookkeeping_exports
Create purchase bookkeeping export Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
archive_after_export | boolean | No | — | Archive After Export |
comment | string | No | — | The comment value |
purchase_ids | integer[] | No | — | Purchase Ids |
trigger_submission | boolean | No | — | Trigger Submission |
with_direct_online_submission | boolean | No | — | With Direct Online Submission |
moco_purchases_create_purchases_drafts
Create purchase draft Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
file | object | No | — | Optional file attachment. |
title | string | Yes | — | Title of the purchase draft. |
moco_purchases_create_purchases_payments
Create purchase payment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
currency | string | No | — | The currency value |
date | string | Yes | — | The date value |
description | string | No | — | The description value |
partially_paid | boolean | No | — | Indicates whether the purchase is partially paid. |
payment_account_id | integer | No | — | Payment Account Id |
purchase_id | integer | Yes | — | Purchase Id |
total | number | Yes | — | The total value |
moco_purchases_create_purchases_payments_bulk
Create purchase payments in bulk Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bulk_data | any[] | Yes | — | Bulk Data |
moco_purchases_create_receipts
Create receipt Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachment | object | No | — | The attachment value |
billable | boolean | No | — | The billable value |
currency | string | No | — | The currency value |
date | string | No | — | The date value |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
project_id | integer | No | — | Project Id |
title | string | No | — | The title value |
moco_purchases_delete_drafts
Delete purchase draft Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_delete_payments
Delete purchase payment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_delete_purchases
Delete purchase Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
moco_purchases_delete_receipts
Delete receipt Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
moco_purchases_get_bookkeeping_exports
Get purchase bookkeeping export Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_get_categories
Get purchase category Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_get_drafts
Download purchase draft PDF Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_get_drafts_1
Get purchase draft Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_get_payments
Get purchase payment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
moco_purchases_get_purchases
Get purchase Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
moco_purchases_get_receipts
Get receipt Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
moco_purchases_list_purchases
List purchases Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
page | integer | No | — | Page number, starting at 1. |
per_page | integer | No | — | Page size. |
id | string | No | — | Legacy alias for filtering by purchase ID (single ID or comma-separated list). |
ids | string | No | — | Comma-separated IDs. |
updated_after | string | No | — | ISO 8601 UTC timestamp (e.g. 2026-01-31T14:30:00Z). Returns entities created or updated after this timestamp and is intended for incremental synchronization. Combine with delete webhooks for full synchronization. |
custom_properties | object | No | — | Filter by custom field values. Unknown custom field names return an empty result set. For MultiSelect fields, pass multiple values using custom_properties[Field][]=A&custom_properties[Field][]=B. Boolean fields should be queried with true or false. |
category_id | integer | No | — | Category Id |
term | string | No | — | The term value |
company_id | integer | No | — | Supplier company ID. Use 0 for purchases without supplier. |
status | string | No | — | The status value |
not_booked | boolean | No | — | Not Booked |
tags | string | No | — | Comma-separated list of tag names. |
tag_ids | string | No | — | Comma-separated list of tag IDs. |
date | string | No | — | Date range, e.g. 2020-02-01:2020-02-22. |
unpaid | boolean | No | — | The unpaid value |
partially_paid | boolean | No | — | Partially Paid |
payment_method | string | No | — | Payment Method |
receipt_identifier | string | No | — | Receipt Identifier |
identifier | string | No | — | The identifier value |
moco_purchases_list_purchases_bookkeeping_exports
List purchase bookkeeping exports Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number, starting at 1. |
moco_purchases_list_purchases_budgets
List purchase budgets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
year | integer | No | — | The year value |
moco_purchases_list_purchases_categories
List purchase categories Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number, starting at 1. |
ids | string | No | — | Comma-separated IDs. |
updated_after | string | No | — | ISO 8601 UTC timestamp (e.g. 2026-01-31T14:30:00Z). Returns entities created or updated after this timestamp and is intended for incremental synchronization. Combine with delete webhooks for full synchronization. |
moco_purchases_list_purchases_drafts
List purchase drafts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number, starting at 1. |
ids | string | No | — | Comma-separated IDs. |
updated_after | string | No | — | ISO 8601 UTC timestamp (e.g. 2026-01-31T14:30:00Z). Returns entities created or updated after this timestamp and is intended for incremental synchronization. Combine with delete webhooks for full synchronization. |
moco_purchases_list_purchases_payments
List purchase payments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number, starting at 1. |
ids | string | No | — | Comma-separated IDs. |
updated_after | string | No | — | ISO 8601 UTC timestamp (e.g. 2026-01-31T14:30:00Z). Returns entities created or updated after this timestamp and is intended for incremental synchronization. Combine with delete webhooks for full synchronization. |
purchase_id | string | No | — | Single ID or comma-separated list. |
date_from | string | No | — | Payment date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). |
date_to | string | No | — | Payment date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). |
moco_purchases_list_receipts
List receipts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number, starting at 1. |
per_page | integer | No | — | Page size. |
ids | string | No | — | Comma-separated IDs. |
updated_after | string | No | — | ISO 8601 UTC timestamp (e.g. 2026-01-31T14:30:00Z). Returns entities created or updated after this timestamp and is intended for incremental synchronization. Combine with delete webhooks for full synchronization. |
user_id | integer | No | — | User Id |
project_id | integer | No | — | Project Id |
from | string | No | — | Receipt date range start. Format: YYYY-MM-DD (e.g. 2026-01-01). |
to | string | No | — | Receipt date range end. Format: YYYY-MM-DD (e.g. 2026-01-31). |
purchase_category_id | integer | No | — | Purchase Category Id |
submitted | boolean | No | — | true for submitted/closed receipts, false for pending. |
refund_request_id | string | No | — | Single ID or comma-separated list. |
moco_purchases_store_document_purchases
Store purchase document Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
file | string | No | — | The file value |
moco_purchases_update_purchases
Update purchase Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
bank_account_number | string | No | — | Bank Account Number |
cash_discount_rate | number | No | — | Cash Discount Rate |
cash_discount_until | string | No | — | Cash Discount Until |
company_id | integer | No | — | Company Id |
cost_center_id | integer | No | — | Cost Center Id |
currency | string | No | — | The currency value |
custom_properties | object | No | — | Custom Properties |
date | string | No | — | The date value |
due_date | string | No | — | Due Date |
file | object | No | — | The file value |
iban | string | No | — | The iban value |
inbound_email_id | integer | No | — | Inbound Email Id |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
payment_method | string | No | — | Payment Method |
purchase_draft_id | integer | No | — | Purchase Draft Id |
receipt_identifier | string | No | — | Receipt Identifier |
reference | string | No | — | The reference value |
service_period_from | string | No | — | Service Period From |
service_period_to | string | No | — | Service Period To |
tags | string[] | No | — | The tags value |
title | string | No | — | The title value |
user_id | integer | No | — | User Id |
moco_purchases_update_purchases_1
Update purchase Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
bank_account_number | string | No | — | Bank Account Number |
cash_discount_rate | number | No | — | Cash Discount Rate |
cash_discount_until | string | No | — | Cash Discount Until |
company_id | integer | No | — | Company Id |
cost_center_id | integer | No | — | Cost Center Id |
currency | string | No | — | The currency value |
custom_properties | object | No | — | Custom Properties |
date | string | No | — | The date value |
due_date | string | No | — | Due Date |
file | object | No | — | The file value |
iban | string | No | — | The iban value |
inbound_email_id | integer | No | — | Inbound Email Id |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
payment_method | string | No | — | Payment Method |
purchase_draft_id | integer | No | — | Purchase Draft Id |
receipt_identifier | string | No | — | Receipt Identifier |
reference | string | No | — | The reference value |
service_period_from | string | No | — | Service Period From |
service_period_to | string | No | — | Service Period To |
tags | string[] | No | — | The tags value |
title | string | No | — | The title value |
user_id | integer | No | — | User Id |
moco_purchases_update_purchases_payments
Update purchase payment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
currency | string | No | — | The currency value |
date | string | No | — | The date value |
description | string | No | — | The description value |
partially_paid | boolean | No | — | Indicates whether the purchase is partially paid. |
payment_account_id | integer | No | — | Payment Account Id |
purchase_id | integer | No | — | Purchase Id |
total | number | No | — | The total value |
moco_purchases_update_purchases_payments_1
Update purchase payment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
currency | string | No | — | The currency value |
date | string | No | — | The date value |
description | string | No | — | The description value |
partially_paid | boolean | No | — | Indicates whether the purchase is partially paid. |
payment_account_id | integer | No | — | Payment Account Id |
purchase_id | integer | No | — | Purchase Id |
total | number | No | — | The total value |
moco_purchases_update_receipts
Update receipt Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
attachment | object | No | — | The attachment value |
billable | boolean | No | — | The billable value |
currency | string | No | — | The currency value |
date | string | No | — | The date value |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
project_id | integer | No | — | Project Id |
title | string | No | — | The title value |
moco_purchases_update_receipts_1
Update receipt Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
attachment | object | No | — | The attachment value |
billable | boolean | No | — | The billable value |
currency | string | No | — | The currency value |
date | string | No | — | The date value |
info | string | No | — | The info value |
items | object[] | No | — | The items value |
project_id | integer | No | — | Project Id |
title | string | No | — | The title value |
moco_purchases_update_status_purchases
Update purchase status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Resource ID. |
X-IMPERSONATE-USER-ID | integer | No | — | Execute request on behalf of another user if allowed. |
status | string | Yes | — | Supports legacy approved (mapped to internal archived) and direct archived. |

