Discounts

Manage Discounts

Returning all discounts from the cart

get

Returns all discounts of the specified cart.

---

Required scopes

• cart.cart_manage

  Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations

OAuth2

OAuth2clientCredentialsRequired

Token URL:

Path parameters

cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Responses

200

The request was successful. Cart discounts items are returned.

application/json

Discount details.

idstringOptional

Discount's unique identifier.

yrnstring · min: 1Optional

A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant.

couponYrnstring · min: 1Optional

A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant.

codestring · max: 150Required

Discount code generated when a discount coupon is created through the Coupon Service.

amountnumber · doubleOptional

Discount expressed as fixed amount.

currencystring · min: 3 · max: 3Optional

Three-letter currency code, compliant with the ISO 4217 standard.

Pattern: [A-Z]{3}

discountRatenumber · doubleOptional

Discount expressed as a percentage of the price.

namestring · max: 150Optional

Discount's displayed name.

calculationTypestring · enum · max: 30Optional

Calculation type specifies how the discount should be calculated. Can be set to one of the following:

• ApplyDiscountBeforeTax
• ApplyDiscountAfterTax

Default: ApplyDiscountBeforeTaxPossible values:

discountCalculationTypestring · enumOptional

Determines whether the coupon is applied to the total or subtotal value of the order.

Possible values:

validbooleanOptional

Flag indicating whether the discount is valid. Invalid discounts are not taken into account when the cart is calculated.

Default: true

discountIndexintegerOptional

The index of the discount. It represents the discount position in the cart discounts array.

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

The requested resource does not exist.

application/json

500

Some server-side error occurred. Details will be provided in the response payload.

application/json

get

/cart/{tenant}/carts/{cartId}/discounts

HTTPcURLJavaScriptPython

GET /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "id": "text",
    "yrn": "text",
    "couponYrn": "text",
    "code": "text",
    "amount": 1,
    "currency": "text",
    "discountRate": 1,
    "name": "text",
    "calculationType": "ApplyDiscountBeforeTax",
    "discountCalculationType": "SUBTOTAL",
    "valid": true,
    "links": [
      {
        "rel": "validate",
        "title": "text",
        "href": "text",
        "type": "application/json"
      }
    ],
    "discountValidationDetails": {
      "message": "text",
      "details": [
        "text"
      ]
    },
    "discountIndex": 1
  }
]

Applying a discount to cart

post

Applies a discount on the specified cart. Multiple discount coupons can be applied to cart, but you need to send a separate request for each discount coupon.

---

Required scopes

• cart.cart_manage

  Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations

OAuth2CustomerAccessToken

OAuth2clientCredentialsRequired

Token URL:

Path parameters

cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Body

application/json

idstringOptional

Discount unique identifier.

couponYrnstring · min: 1Optional

A unique identifier of a global resource, which stores information about the resource, such as its type, ID or name of the tenant.

codestring · min: 1 · max: 150Required

Discount code generated when a discount coupon is created through the Coupon Service.

currencystring · min: 3 · max: 3Optional

Three-letter currency code, compliant with the ISO 4217 standard.

Pattern: [A-Z]{3}

amountnumber · doubleOptional

Discount expressed as fixed amount.

namestring · max: 150Optional

Discount displayed name.

discountRatenumber · doubleOptional

Discount expressed as a percentage of the price.

discountCalculationTypestring · enumOptional

Determines whether the coupon is applied to the total or subtotal value of the order.

Default: SUBTOTALPossible values:

calculationTypestring · enum · max: 30OptionalDeprecated

Calculation type specifies how the discount should be calculated. It can be set to one of the following:

• ApplyDiscountBeforeTax
• ApplyDiscountAfterTax

The field is deprecated and is not used in calculatedPrice fields. The calculated price takes into account site's settings where:

• includesTax=true results in ApplyDiscountAfterTax
• includesTax=false results in ApplyDiscountBeforeTax

Default: ApplyDiscountBeforeTaxPossible values:

Responses

201

The request was successful. The discount has been applied to cart.

application/json

400

The request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Given request is unauthorized - the authorization token is invalid or has expired.

Details will be provided in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

The requested resource does not exist.

application/json

409

The request could not be completed due to a conflict with the current state of the target resource.

application/json

500

Internal Server Error

application/json

post

/cart/{tenant}/carts/{cartId}/discounts

HTTPcURLJavaScriptPython

POST /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 450

{
  "code": "DEVIZU",
  "amount": 10,
  "currency": "EUR",
  "name": "Thanksgiving coupon for all orders",
  "calculationType": "ApplyDiscountBeforeTax",
  "links": [
    {
      "title": "THANKSGIVING10",
      "rel": "validate",
      "type": "application/json",
      "href": "https://api.emporix.io/couponcart/{tenant}/coupons/THANKSGIVING10"
    },
    {
      "title": "THANKSGIVING10 redeem",
      "rel": "redeem",
      "type": "application/json",
      "href": "https://api.emporix.io/couponcart/{tenant}/coupons/THANKSGIVING10/redemptions"
    }
  ]
}

Full payload exampleCoupon-code-only payload example

{
  "yrn": "{discountYrn}",
  "discountId": "1",
  "discountIndex": 0
}

Removing all discounts from cart

delete

Removes all discounts applied to the specified cart.

---

Required scopes

• cart.cart_manage

  Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations

OAuth2CustomerAccessToken

OAuth2clientCredentialsRequired

Token URL:

Path parameters

cartIdstringRequired

Cart unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Query parameters

codesstringOptional

Discount codes, listed with commas, specify the discounts slated for deletion. If no codes are provided, all discounts will be removed.

Example: code1,code2

Responses

204

The request was successful. Discounts have been removed.

400

The request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Given request is unauthorized - the authorization token is invalid or has expired.

Details will be provided in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

The requested resource does not exist.

application/json

500

Some server-side error occurred. Details will be provided in the response payload.

application/json

delete

/cart/{tenant}/carts/{cartId}/discounts

HTTPcURLJavaScriptPython

DELETE /cart/{tenant}/carts/{cartId}/discounts HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Removing a discount from cart

delete

Delete the discount in the cart by the provided discount Index.

---

Required scopes

• cart.cart_manage

  Note: This scope is only required for OAuth2 authorization method to authorize the request with the access_token.

Authorizations

OAuth2CustomerAccessToken

OAuth2clientCredentialsRequired

Token URL:

Path parameters

cartIdstringRequired

Cart’s unique identifier generated when a cart is created.

tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

discountIndexstringRequired

Responses

204

The request was successful. The discount has been removed from cart.

400

The request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Given request is unauthorized - the authorization token is invalid or has expired.

Details will be provided in the response payload.

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

The requested resource does not exist.

application/json

500

Internal server error.

application/json

delete

/cart/{tenant}/carts/{cartId}/discounts/{discountIndex}

HTTPcURLJavaScriptPython

DELETE /cart/{tenant}/carts/{cartId}/discounts/{discountIndex} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content