Skip to main content

Revalue FIFO Layer

POST 
/api/cogs-revaluation/:id/revalue

Revalues a single FIFO layer to a new unit cost, creating an InventoryRevaluation record.

Required scope: inventory:write

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

Authentication: Requires Bearer token.

Fields (CreateInventoryRevaluationData):

  • cogs_source (required, CogsSourceEnum): the source for the new cost (e.g., purchase_order)
  • new_unit_cost (required, float): the new per-unit cost
  • reason (optional, InventoryRevaluationReasonEnum): reason for revaluation
  • reason_notes (optional, string): free-text notes
  • effective_at (optional, date-only YYYY-MM-DD or ISO 8601 datetime): date the cost change takes effect; drives the point-in-time valuation overlay and the GL revaluation period. Defaults to now(). If it falls inside a locked accounting period it is moved forward to the first open day.
  • posted_at (optional, date-only YYYY-MM-DD or ISO 8601 datetime): GL posting timestamp. Defaults to now().
  • old_unit_cost (optional, float): explicit prior per-unit cost; defaults to the layer's current average cost.
  • old_total_cost (optional, float): explicit prior total cost for the layer.
  • new_total_cost (optional, float): explicit new total cost for the layer.

Request​

Responses​

OK

Response Headers
    Content-Type