Simphony Transaction Services Gen2 API Guide

Get the discount collection

get

/api/v1/discounts/collection

{basePath}/discounts/collection?orgShortName=tfoinc&locRef=fdmnh144&rvcRef=42

The discount collection is a list of discounts that can be used when interacting with the checks endpoint. The API returns a collection of discounts that can be used at the specified revenue center.

Request

Supported Media Types

application/json

Query Parameters

LocRef(required): string

The location identifier. Will be forced to lower-case.
OrgShortName(required): string

The organization identifier. Will be forced to lower-case.
RvcRef(required): string

The revenue center identifier.

Header Parameters

If-Modified-Since: string

If-Modified-Since HTTP header
If-None-Match: string

If-None-Match HTTP header

Response

Supported Media Types

application/json

200 Response

A collection of discounts

Headers

ETag: string

The current entity-tag for the selected representation. See RFC 7232 Section 2.3
Last-Modified: string

A timestamp indicating the date and time at which the origin server believes the selected representation was last modified. See RFC 7232 Section 2.2

Root Schema : DiscountCollection

Type: object

Definition of a discount that can be applied to a transaction.

Show Source

items: array items
OrgLocRvcProperties: object OrgLocRvcProperties

A collection of properties for orgShortName, locRef and rvcRef

{
    "description":"Definition of a discount that can be applied to a transaction.\n",
    "type":"object",
    "properties":{
        "OrgLocRvcProperties":{
            "$ref":"#/definitions/OrgLocRvcProperties"
        },
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DiscountItem"
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

Array of: object DiscountItem

Definition of a discount that can be applied to a transaction.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DiscountItem"
    }
}

Nested Schema : OrgLocRvcProperties

Type: object

A collection of properties for orgShortName, locRef and rvcRef

Show Source

locRef(required): string

Location identifier

Example: store66
orgShortName(required): string

Organization identifier

Example: mymeal
rvcRef(required): integer

Revenue Center identifier

Example: 2

{
    "description":"A collection of properties for orgShortName, locRef and rvcRef\n",
    "type":"object",
    "required":[
        "orgShortName",
        "locRef",
        "rvcRef"
    ],
    "properties":{
        "orgShortName":{
            "description":"Organization identifier",
            "type":"string",
            "example":"mymeal"
        },
        "locRef":{
            "description":"Location identifier",
            "type":"string",
            "example":"store66"
        },
        "rvcRef":{
            "description":"Revenue Center identifier",
            "type":"integer",
            "example":2
        }
    }
}

Nested Schema : DiscountItem

Type: object

Definition of a discount that can be applied to a transaction.

Show Source

ConsumerContentProperties: object ConsumerContentProperties

A collection of consumer based content
discountId(required): integer

Discount identifier

Example: 13
extensions: object ExtensionData

Additional Properties Allowed: additionalProperties

Container for extension data
name: object TranslatedString

Additional Properties Allowed: additionalProperties

A string that contains translations into multiple languages **Example** `{ "en-US": "coffee", "de-DE": "kaffee", "ar-AR": "????????" }`
type(required): string

Allowed Values: [ "amount", "percentage" ]

Discount type

Example: amount
value: number

The amount or percentage of the discount. If value is not present or is zero, then the value must be provided when the discount is added to a check.

Example: 5

{
    "description":"Definition of a discount that can be applied to a transaction.\n",
    "type":"object",
    "required":[
        "discountId",
        "type"
    ],
    "properties":{
        "discountId":{
            "description":"Discount identifier",
            "type":"integer",
            "example":13
        },
        "name":{
            "$ref":"#/definitions/TranslatedString"
        },
        "type":{
            "description":"Discount type",
            "type":"string",
            "enum":[
                "amount",
                "percentage"
            ],
            "example":"amount"
        },
        "value":{
            "description":"The amount or percentage of the discount. If value is not present or is zero, then the value must be provided when the discount is added to a check.\n",
            "type":"number",
            "example":5
        },
        "ConsumerContentProperties":{
            "$ref":"#/definitions/ConsumerContentProperties"
        },
        "extensions":{
            "$ref":"#/definitions/ExtensionData"
        }
    }
}

Nested Schema : ConsumerContentProperties

Type: object

A collection of consumer based content

Show Source

consumerDescription: object TranslatedString

Additional Properties Allowed: additionalProperties

A string that contains translations into multiple languages **Example** `{ "en-US": "coffee", "de-DE": "kaffee", "ar-AR": "????????" }`
consumerName: object TranslatedString

Additional Properties Allowed: additionalProperties

A string that contains translations into multiple languages **Example** `{ "en-US": "coffee", "de-DE": "kaffee", "ar-AR": "????????" }`
images: array images

{
    "description":"A collection of consumer based content\n",
    "type":"object",
    "properties":{
        "consumerName":{
            "$ref":"#/definitions/TranslatedString"
        },
        "consumerDescription":{
            "$ref":"#/definitions/TranslatedString"
        },
        "images":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/ImageLink"
            }
        }
    }
}

Nested Schema : ExtensionData

Type: object

Additional Properties Allowed

Show Source

string

{
    "description":"Container for extension data",
    "additionalProperties":{
        "type":"string"
    }
}

Container for extension data

Nested Schema : TranslatedString

Type: object

Additional Properties Allowed

Show Source

string

{
    "description":"A string that contains translations into multiple languages\n\n**Example**\n`{ \"en-US\": \"coffee\", \"de-DE\": \"kaffee\", \"ar-AR\": \"????????\" }`\n",
    "type":"object",
    "example":{
        "en-US":"Coffee",
        "de-DE":"Kaffee",
        "ar-AR":"????????"
    },
    "additionalProperties":{
        "type":"string"
    }
}

A string that contains translations into multiple languages **Example** `{ "en-US": "coffee", "de-DE": "kaffee", "ar-AR": "????????" }`

Example:

{
    "en-US":"Coffee",
    "de-DE":"Kaffee",
    "ar-AR":"????????"
}

Nested Schema : images

Type: array

Show Source

Array of: object ImageLink

Represents a link to an image

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/ImageLink"
    }
}

Nested Schema : ImageLink

Type: object

Represents a link to an image

Show Source

altText: string

Alt text for the image

Example: pizza
description: string

Description text for the image
index: string

Unique identifier for the image
isCloudImage: boolean
size: string

Image size
url(required): string

URL for the image.

Example: https://oracleObjectStore.com/images/coffee822815.jpg

{
    "description":"Represents a link to an image",
    "type":"object",
    "required":[
        "url",
        "tags"
    ],
    "properties":{
        "index":{
            "description":"Unique identifier for the image",
            "type":"string"
        },
        "url":{
            "description":"URL for the image.",
            "type":"string",
            "example":"https://oracleObjectStore.com/images/coffee822815.jpg"
        },
        "altText":{
            "description":"Alt text for the image",
            "type":"string",
            "example":"pizza"
        },
        "description":{
            "description":"Description text for the image",
            "type":"string"
        },
        "isCloudImage":{
            "type":"boolean"
        },
        "size":{
            "description":"Image size",
            "type":"string"
        }
    }
}

304 Response

304 Not Modified

Headers

ETag: string

The current entity-tag for the selected representation. See RFC 7232 Section 2.3
Last-Modified: string

A timestamp indicating the date and time at which the origin server believes the selected representation was last modified. See RFC 7232 Section 2.2

400 Response

400 Bad Request

Root Schema : ConfigurationApiProblemDetails

Type: object

Problem details is used as standard model for reporting details when HTTP error status code is returned. This definition is defined by [RFC7807](https://tools.ietf.org/html/rfc7807). The content type for this response is `application/problem+json`

Show Source

details: string

A human-readable explanation specific to this occurrence of the problem.

Example: The OrgShortName value is required.
instance: string

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example: required_value_missing
title: string

A short, human-readable summary of the problem type.

Example: Required value not specified.
type: string

A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".

Example: error:validation

{
    "description":"Problem details is used as standard model for reporting details when HTTP error status code is returned. This definition is defined by [RFC7807](https://tools.ietf.org/html/rfc7807).\n\nThe content type for this response is `application/problem+json`\n",
    "type":"object",
    "properties":{
        "type":{
            "description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".",
            "type":"string",
            "example":"error:validation"
        },
        "title":{
            "description":"A short, human-readable summary of the problem type.",
            "type":"string",
            "example":"Required value not specified."
        },
        "details":{
            "description":"A human-readable explanation specific to this occurrence of the problem.",
            "type":"string",
            "example":"The OrgShortName value is required."
        },
        "instance":{
            "description":"A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.",
            "type":"string",
            "example":"required_value_missing"
        }
    }
}

Examples

Example Request Body

Not applicable for this endpoint.

Example Response Body

The following example shows the contents of the response body in JSON format:


{
  "orgShortName": "mymeal",
  "locRef": "store66",
  "rvcRef": 2,
  "items": [
    {
      "discountId": 13,
      "name": {
        "en-US": "Coffee",
        "de-DE": "Kaffee",
        "ar-AR": "قهوة"
      },
      "type": "amount",
      "value": 5,
      "consumerName": {
        "en-US": "Coffee",
        "de-DE": "Kaffee",
        "ar-AR": "قهوة"
      },
      "consumerDescription": {
        "en-US": "Coffee",
        "de-DE": "Kaffee",
        "ar-AR": "قهوة"
      },
      "images": [
        {
          "index": "string",
          "url": "https://oracleObjectStore.com/images/coffee822815.jpg",
          "altText": "pizza",
          "description": "string",
          "isCloudImage": true,
          "size": "string"
        }
      ],
      "extensions": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ]
}
}