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

# Update a a list of purchase details

`PATCH /v1/`

Update the purchase detail(s). Any field present in the body will be updated

## Query parameters

- `auditUser` string, required

## Request body

- union[]
  - union
    - 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.
      - `id` string — Unique id that represents this purchase detail
    - 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.
      - `id` string — Unique id that represents this purchase detail

## Response `200`

Successfully updated

- 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

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `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)