Skip to main content

Import Cost Entry Allocations

POST 

/api/cost-entries/:costEntry/allocations/import

Creates the given allocations on the cost entry, all or nothing, and recalculates the entry's status. Refused with 422 (nothing created) when they add up to more than the entry has left to allocate, or when a target no longer exists.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body: allocations (required, 1–5000), each with type (product, brand, supplier, channel), allocatable_id (integer), amount (> 0, entry currency), and optional allocation_date, period_start + period_end (both or neither; end on or after start). Use the allocatable.id values returned by Validate Cost Entry Allocation Import.

Authentication: Requires Bearer token (scope purchase-orders:write).

Request​

Responses​

Created

Response Headers
    Content-Type