---
title: "Create Invoice"
method: POST
path: "/invoices"
---

# Create Invoice

`POST /invoices`

Create a new invoice.

## Request body

- object
  - `issue_date` string — Invoice issue date (example: "2025-10-29")
  - `due_date` string — Invoice due date (example: "2025-10-29")
  - `client_id` number, required — Client (Person / Organization) ID
  - `payer_id` number — Payer (Person / Organization) ID
  - `payment_method` 'cash' | 'cashless' | 'credit_card', required
  - `legal_entity_id` number — Legal Entity ID
  - `manager_id` number — Employee ID
  - `comment` string — Comment text
  - `items` object[] — List of invoice items (associated with Catalog listings)
    - `entity_id` number, required — Product or Service ID
    - `quantity` number, required — Quantity
    - `price` number, required — Price per unit
    - `discount` object — Discount object
      - `type` 'percentage' | 'value', required — Discount type. "percentage" — percent, "value" — absolute value.
      - `percentage` number, required — Percentage value
      - `amount` number, required — Amount value
      - `sponsor` 'staff' | 'company', required — "staff" — Employee wages calculation is based on the amount after discount. This way the company discount decreases the piecework employee wages. "company" — Employee commissions will be calculated from amount before discount. This way the company discount won't affect the employee commissions.
    - `warranty` object — Warranty object
      - `period` number, required — Warranty period
      - `unit` 'days' | 'months', required — Warranty unit of measure
    - `tax_ids` number[] — List of tax IDs
    - `comment` string — Comment text
    - `comment_visibility` 'public' | 'private' — Comment visibility
  - `items_custom` object[] — List of invoice items (one-time products and services)
    - `entity` object, required — Custom product or service object
      - `type` 'product' | 'service', required — Product or service
      - `title` string, required
      - `description` string
      - `uom_id` number, required — Unit of measure ID
    - `quantity` number, required — Quantity
    - `price` number, required — Price per unit
    - `comment` string — Comment text
    - `comment_visibility` 'private' | 'public' — Comment visibility
    - `discount` object — Discount object
      - `type` 'percentage' | 'value', required — Discount type. "percentage" — percent, "value" — absolute value.
      - `percentage` number, required — Percentage value
      - `amount` number, required — Amount value
      - `sponsor` 'staff' | 'company', required — "staff" — Employee wages calculation is based on the amount after discount. This way the company discount decreases the piecework employee wages. "company" — Employee commissions will be calculated from amount before discount. This way the company discount won't affect the employee commissions.
    - `warranty` object — Warranty object
      - `period` number, required — Warranty period
      - `unit` 'days' | 'months', required — Warranty unit of measure
    - `tax_ids` number[] — List of tax IDs

## Response `200`

---

[API](https://skmtc.net/roapp/apis/ro-app-public-api-v2.md) · [All operations](https://skmtc.net/roapp/apis/ro-app-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roapp/ro-app-public-api-v2/revisions/85de4353ed28/schema)