---
title: "Create Sales Day"
method: POST
path: "/inventory/sales/days"
tags: ["Sales & COGS"]
---

# Create Sales Day

`POST /inventory/sales/days`

Record daily sales for a branch and automatically:
- Consume stock based on recipes (SALE_ISSUE moves from branch location)
- Compute COGS and gross profit per item + per day

Assumptions:
- Each sold item has a recipe in recipes/recipe_lines.
- Branch (location_id) holds stock of the recipe components.

## Request body

- SalesDayCreate
  - `location_id` integer, required
  - `sale_date` string, nullable — ISO date (or datetime). Defaults to today if missing.
  - `source` string, nullable — e.g. 'POS', 'Delivery', 'Zomato', etc.
  - `reference` string, nullable — Optional POS batch reference / Z-report number
  - `created_by` string, nullable
  - `lines` SalesLineIn[], required
    - `item_id` integer, required
    - `qty_sold` number, required — Total quantity sold of this menu item
    - `net_revenue` number, required — Total net sales amount for this item (after discounts)

## Response `200`

Successful Response

- SalesDayOut
  - `id` integer, required
  - `number` string, required
  - `location_id` integer, required
  - `location_code` string, required
  - `location_name` string, required
  - `sale_date` string, required
  - `source` string, nullable, required
  - `reference` string, nullable, required
  - `total_net_revenue` number, required
  - `total_cogs` number, required
  - `gross_profit` number, required
  - `created_by` string, nullable, required
  - `created_at` string, required
  - `lines` SalesLineOut[], required
    - `id` integer, required
    - `item_id` integer, required
    - `item_code` string, required
    - `item_name` string, required
    - `qty_sold` number, required
    - `net_revenue` number, required
    - `cogs_value` number, required
    - `gross_profit` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/bamboome/apis/contact-sync-api.md) · [All operations](https://skmtc.dev/bamboome/apis/contact-sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bamboome/contact-sync-api/revisions/56beadb81ad2/schema)