Receipt

Receipt

Search for order receipts in all stores on tenant

post
/tenants/{tenantUid}/receipts/search

Optionally narrow down the search to order in given stores and organizatons.

The field orderStatuses can not be used in combination with the fields orderStates, settleStates or deliveryStates.

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Body

Search for order receipts in all stores on tenant.

An empty string will be ignored, and handled as if the key did not exist in the payload.

Fuzzy search means that it will try to find words that contains the query string that is supplied. The search is case-insensitive. Example: If you search for "Ol" you will get "Olsen", "Olstad", "Bolset", "Ormebol", [email protected], etc ..

storeUidsstring[]Optional
organizationUidsstring[]Optional
customerQuerystringOptional

Search for orders containting this customer. The customer can be specific by firstname, lastname, phonenumber or email. This is a fuzzy search.

customerUidsstring[]Optional
settledAtFromstring · date-timeOptional
orderNumberstringOptional

Search for an order receipt on an order with a specific ordernumber. This is an exact lookup

voucherNumberstringOptionalDeprecated

Deprecated: Use voucherNumbers instead.

voucherNumbersstring[]Optional

Search for multiple order receipts by voucher numbers. This is an exact lookup

productSkusstring[]Optional

Search for order receipts containing the products. These must be SKUs and is an exact lookup.

tenantPaymentMethodUidsstring[]Optional

Search for order receipts containing one of the specified payment methods.

settledAtTostring · date-timeOptional
tenantUserUidsstring[]Optional
querystringOptional

General fuzzy search.

productUidsstring[]Optional
hasUnpaidInvoicesbooleanOptional

When this is set to true, only unpaid receipts/invoices will be in the response.

Responses
200

Example response

application/json
post
/tenants/{tenantUid}/receipts/search
200

Example response

Create new receipt on order

post
/tenants/{tenantUid}/stores/{storeUid}/receipts

Create new receipt on order

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
Body
orderItemUidsstring[]Optional
settlementUidsstring[]Optional
orderReceiptUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/receipts
201

Example response

Get Receipt Details

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}

Get Receipt Details

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}
200

Example response

Update a receipt

put
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}

Update a receipt

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Body
externalVoucherNumberstringOptional
Responses
put
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}
201

Example response

Delete a receipt

delete
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}

Delete a receipt

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Responses
delete
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}
204

No Content

No content

List settlements for a receipt

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements

List settlements for a receipt

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional
ENUM Description
ASC Sort in ascending order
DESC Sort in descending order
Possible values:
Responses
200

Example response

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements
200

Example response

Create new settlement

post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements

Create new settlement

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Body

Create a new settlement

amountintegerRequired

in cents, e.g. 1,50 as 150

externalIdstringOptional

External reference for the settlement

settlementCodestringRequired
settlementUidstringOptionalPattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements
201

Example response

Print receipt

post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/print

Print receipt

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Body
typestring · enum · min: 1Required
ENUM Description
RECEIPT Print sales receipt
EXCHANGENOTE Print exchange note
GIFTCARD Print giftcard barcode
PICKUP Print a pickup label/note
Possible values:
printerUidstringOptional

The printer to send the print to

Pattern: ^[A-Za-z0-9-_]+
orderItemUidsstring[]Optional
exchangenoteValidUntilstring · dateOptional

Only valid for type EXCHANGENOTE. Sets a date that the exchange note is valid until. If not set, exchangeNoteValidUntil is calculated from the store's exchangeNoteValidDays setting. Stored on all orderItemUids in request, usually only one item.

Responses
post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/print
204

No Content

No content

Get settlement details

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}

Get settlement details

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
checkStatusbooleanOptional

Check external payment gateways and fetch status

includeDisplayMessagesbooleanOptional

Include display messages in the response

Responses
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}
200

Example response

Delete a settlement

delete
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}

Delete a settlement

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
settlementUidstringRequired

Reference to a settlement on an order.

Pattern: ^[A-Za-z0-9-_]+
Query parameters
forceDeletebooleanOptional

Force Delete on a settlement

Responses
delete
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/settlements/{settlementUid}
204

No Content

No content

Get EHF invoice status

get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/ehf

Check the status for an EHF invoice.

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Responses
200

Example response

application/json
get
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/ehf
200

Example response

Send EHF invoice

post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/ehf

An EHF invoice is normally sent automatically upon order settlement completion, but here you can try an send it again if it failed the first time. If sending succeeds, the status is also checked.

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/ehf
201

Example response

Send receipt by email

post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/email

Send receipt by email

Authorizations
AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters
tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+
storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+
receiptUidstringRequired

Reference to a Receipt.

Pattern: ^[A-Za-z0-9-_]+
Body

ReceiptEmailSchema

typestring · enum · min: 1Required
ENUM Description
RECEIPT Send sales receipt as email
Possible values:
emailstringRequired
Responses
post
/tenants/{tenantUid}/stores/{storeUid}/receipts/{receiptUid}/email
204

No Content

No content

Last updated