Create Coupon
BetaCreates a new coupon.
Path parameters
tenant
Your Entra Tenant ID. More details.
environment
Your Business Central Environment. More details.
company
Your Business Central Company. More details.
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
x-api-version
Used for API versioning. More details.
Request
This endpoint expects an object.
requestId
A unique identifier for the request to ensure idempotency.
couponType
The type of coupon, which links to a template defining its behavior.
description
A short description for the coupon.
discountType
The type of discount the coupon provides.
Allowed values:
barcode
The barcode or external reference number. If omitted, a number may be generated from a number series.
discountAmount
The fixed discount amount. Required if discountType is 'AMOUNT'.
discountPercent
The discount percentage. Required if discountType is 'PERCENTAGE'.
maxDiscountAmount
The maximum discount amount that can be applied from this coupon.
customerNo
Optionally assign the coupon to a specific customer.
expiresAt
The date and time when the coupon expires. If omitted, the expiration is determined by the coupon type settings.
Response
This endpoint returns an object.
id
The unique system identifier for the coupon.
number
The internal coupon number from the number series.
type
The type of voucher, which carries the setup in NP Retail.
description
A short description of the coupon.
barcode
A unique, human-readable reference number, often used for barcodes.
status
The current status of the coupon.
Allowed values:
discountType
The type of discount the coupon provides.
Allowed values:
validFrom
The date and time from which the coupon is valid.
maxUsesPerSale
The maximum number of times this coupon can be used in a single sale.
issueDate
The date the coupon was first issued.
discountAmount
The fixed discount amount, if applicable.
discountPercent
The discount as a percentage, if applicable.
maxDiscountAmount
The maximum discount amount that can be applied.
validUntil
The date and time when the coupon expires.
customerNo
The customer number this coupon is assigned to, if any.
remainingQuantity
The remaining times the coupon can be used, if applicable.