Skip to content
Vektorprogrammet

Receipts

Receipt owner lifecycle and scoped approval operations.

List receipts for approval

GET/api/receipt-approval-queue

Lists receipts in the caller's approval scope.

Query Parameters

cursor
string·min 1
status
string
Values
PendingApprovedRejectedWithdrawn

Responses

Read receipt file for approval

GET/api/receipt-approval-queue/{receiptId}/file

Downloads verified private bytes for the current scoped approver.

Path Parameters

receiptIdRequired
string·min 1

Responses

List receipts for settlement

GET/api/receipt-settlement-queue

Lists approved, unsettled receipts visible to the current settlement grant.

Query Parameters

cursor
string·min 1

Responses

Read receipt settlement for finance

GET/api/receipt-settlement-queue/{receiptId}

Reads immutable settlement evidence visible to the current settlement grant.

Path Parameters

receiptIdRequired
string·min 1

Responses

List owned receipts

GET/api/receipts

Lists receipts owned by the current person.

Query Parameters

cursor
string·min 1
status

Responses

Submit receipt

POST/api/receipts

Stages a receipt file and submits an idempotent command.

Query Parameters

departmentId
string

Header Parameters

idempotency-keyRequired
string

Request Body

multipart/form-data
amountOreRequired
string
descriptionRequired
string
fileRequired
string <binary>
receiptDateRequired
string

Responses

Revise receipt

PATCH/api/receipts/{receiptId}

Revises a pending owned receipt and optional file.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

multipart/form-data
amountOre
string
description
string
file
string <binary>
receiptDate
string

Responses

Approve receipt

POST/api/receipts/{receiptId}:approve

Approves a pending receipt.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Reject receipt

POST/api/receipts/{receiptId}:reject

Rejects a pending receipt.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Reopen rejected receipt

POST/api/receipts/{receiptId}:reopen

Reopens a rejected receipt for owner correction.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Record receipt settlement

POST/api/receipts/{receiptId}:settle

Records immutable evidence for an externally settled approved receipt.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json
expectedRevisionRequired
integer·min 0
externalAuthorityRequired
string
externalReferenceRequired
string
settledAtRequired
string

Responses

Withdraw receipt

POST/api/receipts/{receiptId}:withdraw

Withdraws a pending receipt owned by the current person.

Path Parameters

receiptIdRequired
string·min 1

Header Parameters

idempotency-keyRequired
string
if-matchRequired
string

Request Body

application/json

Responses

Read owned receipt file

GET/api/receipts/{receiptId}/file

Downloads verified private bytes for the canonical owner.

Path Parameters

receiptIdRequired
string·min 1

Responses