---
title: "Create a list of purchase details"
method: POST
path: "/v1/"
tags: ["Create purchase details"]
---

# Create a list of purchase details

`POST /v1/`

This operation will save the list of purchase details

## Query parameters

- `auditUser` string, required

## Request body

- object[]
  - `amount` Money — Amount including currency
    - `amount` number
    - `currency` string — A valid ISO 4217 currency code
  - `code` string — Issuer defined code for purchase detail. Code can e.g. represent a product category like “newspapers”. Code is utilised if item is processed through repricing.
  - `description` string — Issuer defined description of purchase detail. The description is set when creating purchase details and is available when fetching purchase details via API and in the invoicing file.
  - `externalId` string — Issuer defined external id. Issuer can store an external id to each purchase detail as a common key between Enfuce and issuer systems.
  - `matchingAttributes` KeyValuePair[] — Attributes that enable Enfuce to link purchase detail to a financial transaction. The most suitable matching attributes are agreed with issuer during implementation.
    - `key` string, required
    - `value` string, required
  - `promptedData` KeyValuePair[] — Prompted data linked to the purchase detail
    - `key` string, required
    - `value` string, required
  - `quantity` number — The quantity purchased. This can be a number or in combination with unit define e.g. how many liters or kilograms have been purchased.
  - `transactionId` string — Id of the financial transaction the purchase detail is linked to. The transactionId is updated by Enfuce after a match is found between financial transaction and purchase detail.
  - `type` 'FUEL' | 'OTHER' — The type of item
  - `unitPrice` number — Price per unit
  - `VAT` VATValues
    - `percentage` number
    - `amount` Money — Amount including currency
      - `amount` number
      - `currency` string — A valid ISO 4217 currency code
  - `unit` 'KG' | 'KWH' | 'LITRE' | 'GALLON' — Unit of measurement of quantity. Obsolete in cases where the purchase detail represents one item or a number of the same items.

## Response `201`

Successfully saved

- AddPurchaseDetailsResponse
  - `description` string — Short description of the result of the action
  - `ids` object[], required — Ids of the purchase details that has been created or updated.
    - `externalId` string, required
    - `id` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/revisions/dc4a41118f80/schema)