---
title: "POST /companies/{companySlug}/purchases/drafts"
method: POST
path: "/companies/{companySlug}/purchases/drafts"
tags: ["purchases"]
---

# POST /companies/{companySlug}/purchases/drafts

`POST /companies/{companySlug}/purchases/drafts`

## Request

- Base URL: `https://api.fiken.no/api/v2`
- URL: `https://api.fiken.no/api/v2/companies/{companySlug}/purchases/drafts`
- Auth: OAuth 2
  - Authorization code: `https://fiken.no/oauth/authorize`
  - Token URL: `https://fiken.no/oauth/token`

Creates a purchase draft.

## Request body

- DraftRequest
  - `invoiceIssueDate` string, date: Issue date of the draft, format yyyy-mm-dd
  - `dueDate` string, date: Due date of draft, format yyyy-mm-dd
  - `invoiceNumber` string: If invoice associated with draft, this is the invoice number (not to be confused with the invoiceId of an invoice issued from Fiken)
  - `contactId` integer: Contact Id
  - `projectId` integer: Project ID if only 1 project associated with entire draft. It is also possible to specify the project on individual draft lines
  - `cash` boolean, required: If a cash sale/purchase (true) or otherwise (false)
  - `currency` string: ISO 4217 currency code
  - `kid` string: Norwegian KID number. Number from 2 to 25 digits long.
  - `paid` boolean, required: Whether the sale/purchase has been paid (true) or not (false)
  - `payments` Payment[]
    - `paymentId` integer: Id of given payment.
    - `date` string, date, required: Payment date, format yyyy-mm-dd
    - `account` string, required: Account associated with payment.
    - `amount` integer, required: Amount paid in the specified currency. If no currency is provided then currency defaults to "NOK". Formatted in cents (34000 = 340.00)
    - `amountInNok` integer: Attribute of a foreign payment only. Is required if amount is provided in currency other than NOK and should be the actual amount that was received in the bank account. Fiken calculates the value based on the exchange rate for the given date if no amountInNok is sent. Formatted in cents (500000 = 5000.00)
    - `currency` string: Only specify the currency if other than "NOK", otherwise default currency is "NOK". ISO 4217 currency code
    - `fee` integer: Any fees additional to the amount paid in the specified currency. This is always a "NOK" amount even if the sale currency is a different currency.
  - `lines` DraftLineRequest[], required
    - `text` string, required: Description of the sale/purchase line.
    - `vatType` string, required: Vat Types for SALES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, EXEMPT_IMPORT_EXPORT, EXEMPT, OUTSIDE, EXEMPT_REVERSE] Vat Types for PURCHASES: [NONE, HIGH, MEDIUM, RAW_FISH, LOW, HIGH_DIRECT, HIGH_BASIS, MEDIUM_DIRECT, MEDIUM_BASIS, NONE_IMPORT_BASIS, HIGH_FOREIGN_SERVICE_DEDUCTIBLE, HIGH_FOREIGN_SERVICE_NONDEDUCTIBLE, LOW_FOREIGN_SERVICE_DEDUCTIBLE, LOW_FOREIGN_SERVICE_NONDEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_DEDUCTIBLE, HIGH_PURCHASE_OF_EMISSIONSTRADING_OR_GOLD_NONDEDUCTIBLE]
    - `incomeAccount` string, required: Field is similar to vatType, it defaults to the product's income account. Either the line or the product needs to have an income account set.
    - `net` integer, required: Net amount (in creditNote currency) in cents.
    - `gross` integer, required: Gross amount (= net+VAT) (in creditNote currency) in cents.
    - `projectId` integer

## Response `201`

Created

## Changes

- **2026-03-28** `dff97b55851e`: 1 breaking, 2 info
  - the request property `paid` became required
  - the request optional property `payments/items/amountInNok` became not read-only
  - the `invoiceNumber` request property format was generalized from `int64` to no format
- **2021-12-08** `4813e5666340`: 1 info
  - the endpoint scheme security `fiken_api_oauth` was removed from the API

[Operation history](https://skmtc.dev/fiken/apis/fiken-api/changes/companies/:companySlug/purchases/drafts/post.md)

---

[API](https://skmtc.dev/fiken/apis/fiken-api.md) - [All operations](https://skmtc.dev/fiken/apis/fiken-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiken/apis/fiken-api/revisions/29111da67f94?raw)