---
title: "Create a supplier invoice"
method: POST
path: "/companies/{companyId}/supplier-invoices"
tags: ["supplier-invoices"]
---

# Create a supplier invoice

`POST /companies/{companyId}/supplier-invoices`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/supplier-invoices`
- Auth: HTTP bearer

Creates a new supplier invoice for the company.

**Scope:** `supplier-invoices:write`

## Request body

- SupplierInvoiceCreate
  - `supplierRef` object, required
    - `id` string, uuid, required
  - `invoiceNumber` string
  - `invoiceDate` string, date, required
  - `dueDate` string, date, required
  - `totalAmount` number, double, required
  - `uploadRef` UploadRef
    - `id` string, uuid: Unique identifier of an existing upload
  - `lineItems` SupplierInvoiceLineItem[]: Line items for the supplier invoice. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
    - `id` string, uuid: Server-generated identifier. On update, include `id` to match an existing line item; omit it to add a new line item.
    - `description` string, required
    - `quantity` number, double
    - `unitPrice` number, double, required
    - `unitType` string
    - `taxRate` number, double, nullable
    - `projectRef` ProjectRef, nullable: Reference to a project. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
      - `id` string, uuid, nullable
      - `projectName` string
      - `projectNumber` string
    - `costCenterRef` CostCenterRef, nullable: Reference to a cost center tag value. Should be a valid dimension 1 tag value. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
      - `tagId` string, uuid, nullable
      - `tagName` string

## Response `200`

Supplier invoice created

- SupplierInvoiceGet
  - `id` string, uuid
  - `supplierRef` object, required
    - `id` string, uuid, required
    - `name` string
  - `invoiceNumber` string
  - `invoiceDate` string, date, required
  - `dueDate` string, date, required
  - `totalAmount` number, double, required
  - `remainingAmount` number, double
  - `currency` string
  - `currencyRate` number, double
  - `journalEntryRef` object, nullable
    - `id` string, uuid
  - `lineItems` SupplierInvoiceLineItem[]: Line items for the supplier invoice. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
    - `id` string, uuid: Server-generated identifier. On update, include `id` to match an existing line item; omit it to add a new line item.
    - `description` string, required
    - `quantity` number, double
    - `unitPrice` number, double, required
    - `unitType` string
    - `taxRate` number, double, nullable
    - `projectRef` ProjectRef, nullable: Reference to a project. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
      - `id` string, uuid, nullable
      - `projectName` string
      - `projectNumber` string
    - `costCenterRef` CostCenterRef, nullable: Reference to a cost center tag value. Should be a valid dimension 1 tag value. **Preview:** This field is in preview and may change or be removed before general availability. [Read the full preview policy](/reference/versioning#preview)
      - `tagId` string, uuid, nullable
      - `tagName` string
  - `uploadRefs` UploadRef[]
    - `id` string, uuid: Unique identifier of an existing upload

## Other responses

- `400`: Validation or operation error
- `404`: Supplier invoice or upload not found

## Changes

- **2026-11-03** `9395020f3da2`: 2 info
  - added the new optional request property `lineItems`
  - added the optional property `lineItems` to the response with the `200` status

[Operation history](https://skmtc.dev/bokio/apis/company-api/changes/companies/:companyId/supplier-invoices/post.md)

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)