Generated Dictionary File (1.0.0)

Download OpenAPI specification:Download

Sorted file for browsing the dictionary with swagger-ui or similar tools.

Elements

accountIDElement definition

Request Body schema: application/json

details for accountIDElement

accountID
required
string (accountIDType) [ 1 .. 40 ] characters

The identification of the account related to the tender type.

Responses

200
get/accountIDElement
/accountIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "accountID": "string"
}

accountNameElement definition

Request Body schema: application/json

details for accountNameElement

accountName
required
string (accountNameType) <= 40 characters

The name of the account related to the tender type.

Responses

200
get/accountNameElement
/accountNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "accountName": "string"
}

ageElement definition

Request Body schema: application/json

details for ageElement

age
required
integer (ageType) [ 0 .. 199 ]

age in years of a human system participant.

Responses

200
get/ageElement
/ageElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "age": 0
}

alarmDurationElement definition

Request Body schema: application/json

details for alarmDurationElement

alarmDuration
required
string (alarmDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

The number of seconds that the drawer alarm sounded in a Drawer Alarm event. Since the designation is in seconds, the duration should be limited to expressing seconds, i.e. PxS, where 'x' is the number of seconds.

Responses

200
get/alarmDurationElement
/alarmDurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "alarmDuration": "string"
}

approvalCodeElement definition

Request Body schema: application/json

details for approvalCodeElement

approvalCode
required
string (approvalCodeType) [ 1 .. 40 ] characters

Common approval code for payment or other POS operations.

Responses

200
get/approvalCodeElement
/approvalCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "approvalCode": "string"
}

approvalReferenceCodeElement definition

Request Body schema: application/json

details for approvalReferenceCodeElement

approvalReferenceCode
required
string (approvalCodeType) [ 1 .. 40 ] characters

Common approval code for payment or other POS operations.

Responses

200
get/approvalReferenceCodeElement
/approvalReferenceCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "approvalReferenceCode": "string"
}

approverIDElement definition

Request Body schema: application/json

details for approverIDElement

approverID
required
string (approverIDType) [ 1 .. 40 ] characters

An identifier for the cashier or manager that approved the SaleEvent, RefundEvent, VoidEvent or TransactionLine.

Responses

200
get/approverIDElement
/approverIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "approverID": "string"
}

authorizationApprovalDescriptionElement definition

Request Body schema: application/json

details for authorizationApprovalDescriptionElement

authorizationApprovalDescription
required
string (authorizationApprovalDescriptionType) <= 40 characters

A description of the authorization approval.

Responses

200
get/authorizationApprovalDescriptionElement
/authorizationApprovalDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizationApprovalDescription": "string"
}

authorizationCodeElement definition

Request Body schema: application/json

details for authorizationCodeElement

authorizationCode
required
string (authorizationCodeType) <= 40 characters

The authorization code received from the processing host.

Responses

200
get/authorizationCodeElement
/authorizationCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizationCode": "string"
}

authorizationResponseCodeElement definition

Request Body schema: application/json

details for authorizationResponseCodeElement

authorizationResponseCode
required
string (authorizationResponseCodeType) <= 40 characters

A description of the authorization response received.

Responses

200
get/authorizationResponseCodeElement
/authorizationResponseCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizationResponseCode": "string"
}

authorizationResponseDescriptionElement definition

Request Body schema: application/json

details for authorizationResponseDescriptionElement

authorizationResponseDescription
required
string (authorizationResponseDescriptionType) <= 40 characters

A description of the authorization response received.

Responses

200
get/authorizationResponseDescriptionElement
/authorizationResponseDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizationResponseDescription": "string"
}

authorizingCashierIDElement definition

Request Body schema: application/json

details for authorizingCashierIDElement

authorizingCashierID
required
string (authorizingCashierIDType) [ 1 .. 40 ] characters

The cashier authorizing the drive off or pump test

Responses

200
get/authorizingCashierIDElement
/authorizingCashierIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizingCashierID": "string"
}

authorizingHostIDElement definition

Request Body schema: application/json

details for authorizingHostIDElement

authorizingHostID
required
string (authorizingHostIDType) [ 1 .. 16 ] characters

The identification of the POS or Credit Card Authorizing Host related to the specific authorization

Responses

200
get/authorizingHostIDElement
/authorizingHostIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizingHostID": "string"
}

authorizingTerminalIDElement definition

Request Body schema: application/json

details for authorizingTerminalIDElement

authorizingTerminalID
required
string (authorizingTerminalIDType) [ 1 .. 16 ] characters

The identification of the POS or Credit Card Authorizing terminal related to the specific authorization

Responses

200
get/authorizingTerminalIDElement
/authorizingTerminalIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "authorizingTerminalID": "string"
}

automaticDiscountIDElement definition

Request Body schema: application/json

details for automaticDiscountIDElement

automaticDiscountID
required
integer (automaticDiscountIDType) [ 0 .. 10000000000000000 ]

AutomaticDiscountID is a pointer to a discount in a discount table to be applied to an item any time it is sold

Responses

200
get/automaticDiscountIDElement
/automaticDiscountIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "automaticDiscountID": 0
}

bankAccountNumberElement definition

Request Body schema: application/json

details for bankAccountNumberElement

bankAccountNumber
required
integer (bankAccountNumberType) [ 0 .. 10000000000000000 ]

The bank account number of the check being processed.

Responses

200
get/bankAccountNumberElement
/bankAccountNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "bankAccountNumber": 0
}

bankIDElement definition

Request Body schema: application/json

details for bankIDElement

bankID
required
integer (bankIDType) [ 0 .. 10000000000000000 ]

The identification of the bank for the check being processed.

Responses

200
get/bankIDElement
/bankIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "bankID": 0
}

batchNumberElement definition

Request Body schema: application/json

details for batchNumberElement

batchNumber
required
integer (batchNumberType) [ 0 .. 10000000000000000 ]

A unique identifier for the batch that has been created.

Responses

200
get/batchNumberElement
/batchNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "batchNumber": 0
}

batchSequenceNumberElement definition

Request Body schema: application/json

details for batchSequenceNumberElement

batchSequenceNumber
string (batchSequenceNumberType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

Short batch sequence number.

Responses

200
get/batchSequenceNumberElement
/batchSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "batchSequenceNumber": "stri"
}

biometricIdentifierElement definition

Request Body schema: application/json

details for biometricIdentifierElement

biometricIdentifier
required
string (biometricIdentifierType) <= 40 characters

Free-form text from a reading device.

Responses

200
get/biometricIdentifierElement
/biometricIdentifierElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "biometricIdentifier": "string"
}

breakDurationElement definition

Request Body schema: application/json

details for breakDurationElement

breakDuration
required
string (breakDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

The duration of a break, expressed in minutes and seconds. PxMyS is the normal expression, where x = minutes and y = seconds

Responses

200
get/breakDurationElement
/breakDurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "breakDuration": "string"
}

businessDateElement definition

Request Body schema: application/json

details for businessDateElement

businessDate
required
string <date> (dateType) <= 10 characters

ISO 8601 Date Type to align with XML Schema.

Responses

200
get/businessDateElement
/businessDateElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "businessDate": "2020-06-23"
}

cardCategoryElement definition

Request Body schema: application/json

details for cardCategoryElement

cardCategory
required
string (cardCategoryType) [ 1 .. 2 ] characters

Short card category

Responses

200
get/cardCategoryElement
/cardCategoryElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "cardCategory": "st"
}

cardCircuitElement definition

Request Body schema: application/json

details for cardCircuitElement

cardCircuit
required
string (cardCircuitType) [ 1 .. 20 ] characters

The CardCircuit dentifies the card type. This element is intended to align with the requirements of the EPS 2.7 (and later) standard

Responses

200
get/cardCircuitElement
/cardCircuitElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "cardCircuit": "string"
}

cardDescriptionElement definition

Request Body schema: application/json

details for cardDescriptionElement

cardDescription
required
string (cardDescriptionType) <= 40 characters

Description of card

Responses

200
get/cardDescriptionElement
/cardDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "cardDescription": "string"
}

cardTypeIDElement definition

Request Body schema: application/json

details for cardTypeIDElement

cardTypeID
required
string (cardTypeIDType) [ 1 .. 16 ] characters

Card identifier

Responses

200
get/cardTypeIDElement
/cardTypeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "cardTypeID": "string"
}

cashierIDElement definition

Request Body schema: application/json

details for cashierIDElement

cashierID
required
string (cashierIDType) [ 1 .. 40 ] characters

Identifies the cashier conducting the transaction(s) in the reporting period

Responses

200
get/cashierIDElement
/cashierIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "cashierID": "string"
}

checkNumberElement definition

Request Body schema: application/json

details for checkNumberElement

checkNumber
required
integer (checkNumberType) [ 0 .. 10000000000000000 ]

The sequential number assigned to the check, which is generally pre-printed in the upper right hand corner of the check

Responses

200
get/checkNumberElement
/checkNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "checkNumber": 0
}

cityElement definition

Request Body schema: application/json

details for cityElement

city
required
string (cityType) <= 40 characters

The city portion of the address

Responses

200
get/cityElement
/cityElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "city": "string"
}

comboDescriptionElement definition

Request Body schema: application/json

details for comboDescriptionElement

comboDescription
required
string (comboDescriptionType) <= 40 characters

A free form description of the combination offered for sale - "combo", i.e., "Manager's Special", "Sandwich Combo", etc.

Responses

200
get/comboDescriptionElement
/comboDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "comboDescription": "string"
}

commissionRateElement definition

Request Body schema: application/json

details for commissionRateElement

commissionRate
required
string (commissionRateType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

Rate paid for commission, expressed as a decimal number (left of decimal).

Responses

200
get/commissionRateElement
/commissionRateElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "commissionRate": "string"
}

conceptIDElement definition

Request Body schema: application/json

details for conceptIDElement

conceptID
required
string (conceptIDType) [ 1 .. 40 ] characters

This identifies a particular branding within a RevenueCenterID. For example, Subway within a QSR RevenueCenterID.

Responses

200
get/conceptIDElement
/conceptIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "conceptID": "string"
}

condimentIDElement definition

Request Body schema: application/json

details for condimentIDElement

condimentID
required
object (condimentIDObject)

Responses

200
get/condimentIDElement
/condimentIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "condimentID":
    {
    }
}

condimentNameElement definition

Request Body schema: application/json

details for condimentNameElement

condimentName
required
string (condimentNameType) <= 40 characters

The name of the item that is being sold as optional extra alongside some other item.

Responses

200
get/condimentNameElement
/condimentNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "condimentName": "string"
}

countElement definition

Request Body schema: application/json

details for countElement

count
required
integer (countType) [ 0 .. 9999999999 ]

A 'number of times' or 'number of objects'.

Responses

200
get/countElement
/countElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "count": 0
}

countrySettingsElement definition

Request Body schema: application/json

details for countrySettingsElement

countrySettings
object (countrySettingsObject)

Responses

200
get/countrySettingsElement
/countrySettingsElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "countrySettings":
    {
    }
}

couponRedeemedElement definition

Request Body schema: application/json

details for couponRedeemedElement

couponRedeemed
object (couponRedeemedObject)

Responses

200
get/couponRedeemedElement
/couponRedeemedElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "couponRedeemed":
    {
    }
}

currencyExchangeRateElement definition

Request Body schema: application/json

details for currencyExchangeRateElement

currencyExchangeRate
required
number (currencyExchangeRateType) [ 0 .. 999999999999 ]

For currency exchange, 6,6 decimal.

Responses

200
get/currencyExchangeRateElement
/currencyExchangeRateElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currencyExchangeRate": 0
}

customerPONumberElement definition

Request Body schema: application/json

details for customerPONumberElement

customerPONumber
required
string (customerPONumberType) [ 1 .. 16 ] characters

PO number

Responses

200
get/customerPONumberElement
/customerPONumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customerPONumber": "string"
}

descriptionIDElement definition

Request Body schema: application/json

details for descriptionIDElement

descriptionID
required
string (descriptionIDType) [ 1 .. 8 ] characters

A reference string for description lookup.

Responses

200
get/descriptionIDElement
/descriptionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "descriptionID": "string"
}

deviceIDElement definition

Request Body schema: application/json

details for deviceIDElement

deviceID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/deviceIDElement
/deviceIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "deviceID": "string"
}

discountElement definition

Request Body schema: application/json

details for discountElement

discount
required
object (discountObject)

Responses

200
get/discountElement
/discountElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "discount":
    {
    }
}

discountIDElement definition

Request Body schema: application/json

details for discountIDElement

discountID
required
string (discountIDType) [ 1 .. 40 ] characters

A reference string for identifying a discount.

Responses

200
get/discountIDElement
/discountIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "discountID": "string"
}

discountReasonElement definition

Request Body schema: application/json

details for discountReasonElement

discountReason
required
string or string (discountReasonEENUMType)

A reason code indicating why the item/merchandise was discounted defined by Conexxus (base type).

Responses

200
get/discountReasonElement
/discountReasonElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "discountReason": "storeCouponOffer"
}

dispenserIDElement definition

Request Body schema: application/json

details for dispenserIDElement

dispenserID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/dispenserIDElement
/dispenserIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "dispenserID": "string"
}

dispensersConfigurationElement definition

Request Body schema: application/json

details for dispensersConfigurationElement

dispensersConfiguration
Array of objects (dispenserConfigurationObject) <= 20 items

dispensers configuration is the array which includes the dispenser configuration definition

Responses

200
get/dispensersConfigurationElement
/dispensersConfigurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "dispensersConfiguration":
    [
    ]
}

driverIDElement definition

Request Body schema: application/json

details for driverIDElement

driverID
required
string (driverIDType) [ 1 .. 40 ] characters

The type of identification used to verify the identification of the driver.

Responses

200
get/driverIDElement
/driverIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "driverID": "string"
}

dropNumberElement definition

Request Body schema: application/json

details for dropNumberElement

dropNumber
required
string (dropNumberType) [ 1 .. 8 ] characters

A unique identifer for the safe drop that was performed.

Responses

200
get/dropNumberElement
/dropNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "dropNumber": "string"
}

electronicSignatureElement definition

Request Body schema: application/json

details for electronicSignatureElement

electronicSignature
required
string (electronicSignatureType) <= 40 characters

Used to give the electronic signature value where signature capture device is present for additional verification.

Responses

200
get/electronicSignatureElement
/electronicSignatureElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "electronicSignature": "string"
}

emailAddressElement definition

Request Body schema: application/json

details for emailAddressElement

emailAddress
required
string (emailAddressType) <= 320 characters

email address (valid according RFC 3696).

Responses

200
get/emailAddressElement
/emailAddressElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "emailAddress": "string"
}

employeeIDElement definition

Request Body schema: application/json

details for employeeIDElement

employeeID
required
string (employeeIDType) [ 1 .. 16 ] characters

Identifier for an employee. Use caution not to disclose PII.

Responses

200
get/employeeIDElement
/employeeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "employeeID": "string"
}

employeeNumberElement definition

Request Body schema: application/json

details for employeeNumberElement

employeeNumber
required
string (employeeNumberType) [ 1 .. 16 ] characters

A unique identifer for the employee that is referred to in a TimeClock event.

Responses

200
get/employeeNumberElement
/employeeNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "employeeNumber": "string"
}

employeeRoleElement definition

Request Body schema: application/json

details for employeeRoleElement

employeeRole
required
string (employeeRoleType) <= 40 characters

Role of the employee for a given task.

Responses

200
get/employeeRoleElement
/employeeRoleElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "employeeRole": "string"
}

envelopeIDElement definition

Request Body schema: application/json

details for envelopeIDElement

envelopeID
required
string (envelopeIDType) [ 1 .. 40 ] characters

The unique identifier that was on the envelope, that the money was placed in during the safe drop event.

Responses

200
get/envelopeIDElement
/envelopeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "envelopeID": "string"
}

epsNameElement definition

Request Body schema: application/json

details for epsNameElement

epsName
required
string (epsNameType) <= 40 characters

Unique name of the EPS with in a given site. A site can have one or more EPS.

Responses

200
get/epsNameElement
/epsNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "epsName": "string"
}

eventIDElement definition

Request Body schema: application/json

details for eventIDElement

eventID
required
string (eventIDType) [ 1 .. 40 ] characters

The identification of a specific event responsible for the reward.

Responses

200
get/eventIDElement
/eventIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "eventID": "string"
}

eventSequenceIDElement definition

Request Body schema: application/json

details for eventSequenceIDElement

eventSequenceID
required
integer (eventSequenceIDType) [ 0 .. 10000000000000000 ]

A unique identifer for the FinancialEvent.

Responses

200
get/eventSequenceIDElement
/eventSequenceIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "eventSequenceID": 0
}

feeIDElement definition

Request Body schema: application/json

details for feeIDElement

feeID
required
string (feeIDType) [ 1 .. 16 ] characters

An ID for a fee applied to a transaction.

Responses

200
get/feeIDElement
/feeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "feeID": "string"
}

fieldNameElement definition

Request Body schema: application/json

details for fieldNameElement

fieldName
required
string (fieldNameType) <= 16 characters

For audit events, what table/field changed?

Responses

200
get/fieldNameElement
/fieldNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fieldName": "string"
}

fuelGradeIDElement definition

Request Body schema: application/json

details for fuelGradeIDElement

fuelGradeID
required
object (fuelGradeIDObject)

Responses

200
get/fuelGradeIDElement
/fuelGradeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelGradeID":
    {
    }
}

fuelGradeSequenceIDElement definition

Request Body schema: application/json

details for fuelGradeSequenceIDElement

fuelGradeID
integer (fuelGradeSequenceIDType) [ 0 .. 9999 ]

The sequence number to which the FuelGradeID is assigned. Normally hose ID.

Responses

200
get/fuelGradeSequenceIDElement
/fuelGradeSequenceIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelGradeID": 0
}

fuelModesElement definition

Request Body schema: application/json

details for fuelModesElement

fuelModes
Array of objects (fuelModesObject) <= 100 items

fuelModes is the array which includes the modes definition

Responses

200
get/fuelModesElement
/fuelModesElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelModes":
    [
    ]
}

fuelPositionIDElement definition

Request Body schema: application/json

details for fuelPositionIDElement

fuelPositionID
required
integer (fuelPositionIDType) [ 0 .. 9999 ]

ID for Fuel Position.

Responses

200
get/fuelPositionIDElement
/fuelPositionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelPositionID": 0
}

fuelPositionStatusElement definition

Request Body schema: application/json

details for fuelPositionStatusElement

fuelPositionStatus
required
string (fuelPositionStatusType) <= 16 characters

The status of a fuel position that causes a PumpStatus event to occur.

Responses

200
get/fuelPositionStatusElement
/fuelPositionStatusElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelPositionStatus": "string"
}

fuelPriceChangeIDElement definition

Request Body schema: application/json

details for fuelPriceChangeIDElement

fuelPriceChangeID
required
string (fuelPriceChangeIDType) [ 1 .. 40 ] characters

The system dependent identifier for a fuel price change event.

Responses

200
get/fuelPriceChangeIDElement
/fuelPriceChangeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelPriceChangeID": "string"
}

fuelProductBlendPercentElement definition

Request Body schema: application/json

details for fuelProductBlendPercentElement

fuelProductBlendPercent
required
string (fuelProductBlendPercentType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

This is the percentage of FuelProductID used in a blending of two fuel products to create a fuel grade. The blend percentage of FuelProductIDHigh is 100 less FuelProductBlendPercent. If not a blended fuel grade then put 100 as the FuelProductBlendPercent.

Responses

200
get/fuelProductBlendPercentElement
/fuelProductBlendPercentElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelProductBlendPercent": "string"
}

fuelProductElement definition

Request Body schema: application/json

details for fuelProductElement

fuelProducts
Array of objects (fuelProductObject) <= 1000 items

fuel product is the array which includes the fuel product definition

Responses

200
get/fuelProductElement
/fuelProductElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelProducts":
    [
    ]
}

fuelProductStatusElement definition

Request Body schema: application/json

details for fuelProductStatusElement

fuelProductStatus
required
string (fuelProductStatusType) <= 16 characters

The status of the fuel product at the time of the tank reading.

Responses

200
get/fuelProductStatusElement
/fuelProductStatusElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelProductStatus": "string"
}

fuelingPointIDElement definition

Request Body schema: application/json

details for fuelingPointIDElement

fuelingPointID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/fuelingPointIDElement
/fuelingPointIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string"
}

ipv4AddressElement definition

Request Body schema: application/json

details for ipv4AddressElement

ipv4Address
string <= 100 characters ((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)

Internet Protocol version 4 (IPv4) is the fourth version of the Internet Protocol (IP)

Responses

200
get/ipv4AddressElement
/ipv4AddressElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipv4Address": "string"
}

ipv6AddressElement definition

Request Body schema: application/json

details for ipv6AddressElement

ipv6Address
string <= 100 characters '((([0-9A-Fa-f]{1,4}:){7}([0-9A-Fa-f]{1,4}|:))|(([0-9A-Fa-f]{1,4}:){6}(:[0-9A-Fa-f]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d) (\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d) (\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4}) ?:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}) {1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:) {2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)) {3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d) (\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d) (\.(25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}))|:)))(%.+)?\s*'

Internet Protocol version 6 (IPv6) is a new version of the Internet Protocol (IP)

Responses

200
get/ipv6AddressElement
/ipv6AddressElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipv6Address": "string"
}

itemCodeElement definition

Request Body schema: application/json

details for itemCodeElement

itemCode
required
object (itemCodeObject)

Responses

200
get/itemCodeElement
/itemCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "itemCode":
    {
    }
}

itemIDElement definition

Request Body schema: application/json

details for itemIDElement

itemID
required
string (itemIDType) [ 1 .. 40 ] characters

Generic ID for items and links to them.

Responses

200
get/itemIDElement
/itemIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "itemID": "string"
}

itemListIDElement definition

Request Body schema: application/json

details for itemListIDElement

itemListID
required
string (itemListIDType) [ 1 .. 40 ] characters

A pointer to the Item List look-up table. A "null" or "no value" for ItemListIDType may be allowed.

Responses

200
get/itemListIDElement
/itemListIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "itemListID": "string"
}

jobCodeElement definition

Request Body schema: application/json

details for jobCodeElement

jobCode
required
string (jobCodeType) [ 1 .. 40 ] characters

A code denoting the job that the employee was linked to during a TimeClock event.

Responses

200
get/jobCodeElement
/jobCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "jobCode": "string"
}

jobIDElement definition

Request Body schema: application/json

details for jobIDElement

jobID
required
string (jobIDType) [ 1 .. 40 ] characters

The identification of the job associated with the fleet card purchase.

Responses

200
get/jobIDElement
/jobIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "jobID": "string"
}

keyboardElement definition

Request Body schema: application/json

details for keyboardElement

keyboard
required
string (keyboardType) <= 40 characters

Type of keyboard involved in the transaction.

Responses

200
get/keyboardElement
/keyboardElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "keyboard": "string"
}

levelElement definition

Request Body schema: application/json

details for levelElement

level
integer (levelType) [ 0 .. 99999999 ]

level value as used for level readings by tank level gauges. Level is an unsigned integer from "0" to "99999999"

Responses

200
get/levelElement
/levelElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "level": 0
}

licenseNumberElement definition

Request Body schema: application/json

details for licenseNumberElement

licenseNumber
required
string (licenseNumberType) <= 16 characters

The license number of the vehicle that drove off.

Responses

200
get/licenseNumberElement
/licenseNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "licenseNumber": "string"
}

licensePlateIDElement definition

Request Body schema: application/json

details for licensePlateIDElement

licensePlateID
required
string (licensePlateIDType) <= 16 characters

The license plate number of the vehicle recorded in a DriveOff event.

Responses

200
get/licensePlateIDElement
/licensePlateIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "licensePlateID": "string"
}

limitElement definition

Request Body schema: application/json

details for limitElement

limit
Array of objects (limitObject) <= 8 items

limit is the array which includes the limit definition

Responses

200
get/limitElement
/limitElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "limit":
    [
    ]
}

lineSequenceNumberElement definition

Request Body schema: application/json

details for lineSequenceNumberElement

lineSequenceNumber
required
integer (lineSequenceNumberType) [ 0 .. 10000000000000000 ]

A unique sequence number for the subItemLine within the ItemLine it is attached to.

Responses

200
get/lineSequenceNumberElement
/lineSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "lineSequenceNumber": 0
}

linkedItemListIDElement definition

Request Body schema: application/json

details for linkedItemListIDElement

linkedItemListID
required
string (linkedItemListIDType) [ 1 .. 40 ] characters

A pointer to the Item List look-up table. A 'null' or 'no value' for ItemListIDType may be allowed.

Responses

200
get/linkedItemListIDElement
/linkedItemListIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "linkedItemListID": "string"
}

loyaltyProgramNameElement definition

Request Body schema: application/json

details for loyaltyProgramNameElement

loyaltyProgramName
required
string (loyaltyProgramNameType) <= 40 characters

The name of the loyalty program to which the reduction is attributed.

Responses

200
get/loyaltyProgramNameElement
/loyaltyProgramNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "loyaltyProgramName": "string"
}

loyaltyTransactionIDElement definition

Request Body schema: application/json

details for loyaltyTransactionIDElement

loyaltyTransactionID
required
string (loyaltyTransactionIDType) [ 1 .. 40 ] characters

The ID of the loyalty program to which the reduction is attributed.

Responses

200
get/loyaltyTransactionIDElement
/loyaltyTransactionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "loyaltyTransactionID": "string"
}

macAddressElement definition

Request Body schema: application/json

details for macAddressElement

macAddress
string <= 100 characters [0-9a-fA-F]{2}-[0-9a-fA-F]{2}-[0-9a-fA-F]{2}-[0-9a-fA-F]{2}-[0-9a-fA-F]{2}-[0-9a-fA-F]{2}

A media access control address (MAC address) of a device is a unique identifier assigned to a network interface controller (NIC)

Responses

200
get/macAddressElement
/macAddressElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "macAddress": "string"
}

managerIDElement definition

Request Body schema: application/json

details for managerIDElement

managerID
required
string (managerIDType) [ 1 .. 8 ] characters

Identifier for a manager, unique to a given site.

Responses

200
get/managerIDElement
/managerIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "managerID": "string"
}

manualActionIDElement definition

Request Body schema: application/json

details for manualActionIDElement

manualActionID
required
string (manualActionIDType) [ 1 .. 40 ] characters

The identification of the action used to trigger the promotion.

Responses

200
get/manualActionIDElement
/manualActionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "manualActionID": "string"
}

manufacturerCouponElement definition

Request Body schema: application/json

details for manufacturerCouponElement

manufacturerCoupon
required
object (manufacturerCouponObject)

Responses

200
get/manufacturerCouponElement
/manufacturerCouponElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "manufacturerCoupon":
    {
    }
}

massUNElement definition

Request Body schema: application/json

details for massUNElement

mass
required
object (massUNObject)

Responses

200
get/massUNElement
/massUNElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mass":
    {
    }
}

memoDetailElement definition

Request Body schema: application/json

details for memoDetailElement

memoDetail
required
string (memoDetailType) <= 40 characters

A descriptive piece of text that is placed into the journal as a Memo event.

Responses

200
get/memoDetailElement
/memoDetailElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "memoDetail": "string"
}

merchandiseCodeDescriptionElement definition

Request Body schema: application/json

details for merchandiseCodeDescriptionElement

merchandiseCodeDescription
required
string (merchandiseCodeDescriptionType) <= 40 characters

Native language description of the merchandise code normally printed on the register tape.

Responses

200
get/merchandiseCodeDescriptionElement
/merchandiseCodeDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "merchandiseCodeDescription": "string"
}

merchandiseCodeElement definition

Request Body schema: application/json

details for merchandiseCodeElement

merchandiseCode
required
object (merchandiseCodeObject)

Responses

200
get/merchandiseCodeElement
/merchandiseCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "merchandiseCode":
    {
    }
}

mimeTypeElement definition

Request Body schema: application/json

details for mimeTypeElement

mimeType
required
string (mimeTypeType) [ 1 .. 40 ] characters

MIME type for binary data.

Responses

200
get/mimeTypeElement
/mimeTypeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mimeType": "string"
}

miscellaneousSummaryCodeElement definition

Request Body schema: application/json

details for miscellaneousSummaryCodeElement

miscellaneousSummaryCode
required
string or string (miscellaneousSummaryCodeEENUMType)

MiscellaneousSummaryCodes defined by Conexxus (base type).

Responses

200
get/miscellaneousSummaryCodeElement
/miscellaneousSummaryCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "miscellaneousSummaryCode": "safeDrop"
}

miscellaneousSummarySubCodeElement definition

Request Body schema: application/json

details for miscellaneousSummarySubCodeElement

miscellaneousSummarySubCode
required
string or string (miscellaneousSummarySubCodeEENUMType)

MiscellaneousSummarySubCodes defined by Conexxus (base type).

Responses

200
get/miscellaneousSummarySubCodeElement
/miscellaneousSummarySubCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "miscellaneousSummarySubCode": "total"
}

mixMatchCodeElement definition

Request Body schema: application/json

details for mixMatchCodeElement

mixMatchCode
required
string (mixMatchCodeType) [ 1 .. 8 ] characters

A code identifying the MixMatch.

Responses

200
get/mixMatchCodeElement
/mixMatchCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mixMatchCode": "string"
}

modeNoElement definition

Request Body schema: application/json

details for modeNoElement

modeNo
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

Responses

200
get/modeNoElement
/modeNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "modeNo": 0
}

moneyOrderNumberElement definition

Request Body schema: application/json

details for moneyOrderNumberElement

moneyOrderNumber
required
string (moneyOrderNumberType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

The sequential number issued by the money order company to the individual money order being sold.

Responses

200
get/moneyOrderNumberElement
/moneyOrderNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "moneyOrderNumber": "string"
}

moneyOrderTypeIndicatorElement definition

Request Body schema: application/json

details for moneyOrderTypeIndicatorElement

moneyOrderTypeIndicator
required
string (moneyOrderTypeIndicatorType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

An indicator as to the type of money order, I.e., vendor payment, payroll, customer, etc.

Responses

200
get/moneyOrderTypeIndicatorElement
/moneyOrderTypeIndicatorElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "moneyOrderTypeIndicator": "stri"
}

networkIDElement definition

Request Body schema: application/json

details for networkIDElement

networkID
required
string (networkIDType) [ 1 .. 16 ] characters

An identifier for the batch on the network.

Responses

200
get/networkIDElement
/networkIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "networkID": "string"
}

networkProductCodeElement definition

Request Body schema: application/json

details for networkProductCodeElement

networkProductCode
required
string (networkProductCodeType) [ 1 .. 4 ] characters

A code reported to the credit card processing host, to indicate types of products being sold in the transaction. Provided for use of non-Conexxus codes if needed.

Responses

200
get/networkProductCodeElement
/networkProductCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "networkProductCode": "stri"
}

newSecurityIDElement definition

Request Body schema: application/json

details for newSecurityIDElement

newSecurityID
required
string (newSecurityIDType) [ 1 .. 16 ] characters

A code denoting the new security that was in place after the security bypass event was performed.

Responses

200
get/newSecurityIDElement
/newSecurityIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "newSecurityID": "string"
}

newValueElement definition

Request Body schema: application/json

details for newValueElement

newValue
required
string (newValueType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

For use in NAXML-POSJournal (mainly) in MaintenanceAuditEvent to declare a new (audited) value

Responses

200
get/newValueElement
/newValueElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "newValue": "string"
}

nozzleNoElement definition

Request Body schema: application/json

details for nozzleNoElement

nozzleNo
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

Responses

200
get/nozzleNoElement
/nozzleNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "nozzleNo": 0
}

odometerReadingElement definition

Request Body schema: application/json

details for odometerReadingElement

odometerReading
required
integer (odometerReadingType) [ 0 .. 10000000000000000 ]

The odometer reading of the vehicle being filled.

Responses

200
get/odometerReadingElement
/odometerReadingElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "odometerReading": 0
}

oldSecurityLevelElement definition

Request Body schema: application/json

details for oldSecurityLevelElement

oldSecurityLevel
required
string (oldSecurityLevelType) [ 1 .. 16 ] characters

A code denoting the security level that was in place before the security bypass event was performed.

Responses

200
get/oldSecurityLevelElement
/oldSecurityLevelElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oldSecurityLevel": "string"
}

oldValueElement definition

Request Body schema: application/json

details for oldValueElement

oldValue
required
string (oldValueType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

For use in NAXML-POSJournal (mainly) in MaintenanceAuditEvent to declare an old (unaudited) value.

Responses

200
get/oldValueElement
/oldValueElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oldValue": "string"
}

overridingCashierIDElement definition

Request Body schema: application/json

details for overridingCashierIDElement

overridingCashierID
required
string (overridingCashierIDType) [ 1 .. 40 ] characters

A unique identifier for the cashier or manager that performed the security override event.

Responses

200
get/overridingCashierIDElement
/overridingCashierIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "overridingCashierID": "string"
}

partDescriptionElement definition

Request Body schema: application/json

details for partDescriptionElement

partDescription
required
string (partDescriptionType) <= 40 characters

A long and complex description for a vehicle part number that is being sold.

Responses

200
get/partDescriptionElement
/partDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "partDescription": "string"
}

passwordElement definition

Request Body schema: application/json

details for passwordElement

password
required
string (passwordType) <= 40 characters

Security password

Responses

200
get/passwordElement
/passwordElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "password": "string"
}

paymentSystemsProductCodeElement definition

Request Body schema: application/json

details for paymentSystemsProductCodeElement

paymentSystemsProductCode
required
string (paymentSystemsProductCodeType) [ 2 .. 5 ] characters ^[0-9]{2,5}$

Conexxus Payment System Product Codes and/or the underlying standard (X9.104) for which Conexxus is the Registration Authority, published by ACS X9, Inc.

Responses

200
get/paymentSystemsProductCodeElement
/paymentSystemsProductCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "paymentSystemsProductCode": "strin"
}

percentageElement definition

Request Body schema: application/json

details for percentageElement

percentage
required
number (percentageType) <= 999999

3,3 decimal valid percentage, may range over 100 (i.e. 300% increase, etc.)

Responses

200
get/percentageElement
/percentageElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "percentage": 0
}

phoneNumberStringElement definition

Request Body schema: application/json

details for phoneNumberStringElement

phoneNumberString
required
string (phoneNumberStringType) <= 14 characters ^[0-9\-\(\)\B]{,14}$

String roughly constrained to handle phone numbers and common delimiting characters.

Responses

200
get/phoneNumberStringElement
/phoneNumberStringElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "phoneNumberString": "string"
}

posCodeElement definition

Request Body schema: application/json

details for posCodeElement

posCode
required
string (posCodeType) <= 24 characters ^[0-9]{1,24}$

Responses

200
get/posCodeElement
/posCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "posCode": "string"
}

posCodeFormatElement definition

Request Body schema: application/json

details for posCodeFormatElement

posCodeFormat
required
object (posCodeFormatObject)

Responses

200
get/posCodeFormatElement
/posCodeFormatElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "posCodeFormat":
    {
    }
}

posCodeModiferElement definition

Request Body schema: application/json

details for posCodeModiferElement

posCodeModifier
required
object (posCodeModifierObject)

Responses

200
get/posCodeModiferElement
/posCodeModiferElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "posCodeModifier":
    {
    }
}

postalCodeElement definition

Request Body schema: application/json

details for postalCodeElement

postalCode
required
string (postalCodeType) <= 16 characters

The postal code in the address (zip code in the US).

Responses

200
get/postalCodeElement
/postalCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "postalCode": "string"
}

preAuthorizationElement definition

Request Body schema: application/json

details for preAuthorizationElement

preAuthorization
required
integer (preAuthorizationType) [ 0 .. 9999 ]

Indicates pre-authorization was obtained

Responses

200
get/preAuthorizationElement
/preAuthorizationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "preAuthorization": 0
}

preparationModElement definition

Request Body schema: application/json

details for preparationModElement

preparationMod
required
string (preparationModType) <= 40 characters

Description of a preparation modification that must occur when the item is sold as a component within another item

Responses

200
get/preparationModElement
/preparationModElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "preparationMod": "string"
}

priceOverrideApproverIDElement definition

Request Body schema: application/json

details for priceOverrideApproverIDElement

priceOverrideApproverID
required
string (priceOverrideApproverIDType) [ 1 .. 40 ] characters

Identifies the individual athorizing the price overrider.

Responses

200
get/priceOverrideApproverIDElement
/priceOverrideApproverIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "priceOverrideApproverID": "string"
}

priceOverrideElement definition

Request Body schema: application/json

details for priceOverrideElement

priceOverride
required
object (priceOverrideObject)

Responses

200
get/priceOverrideElement
/priceOverrideElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "priceOverride":
    {
    }
}

pricePoleConfigurationElement definition

Request Body schema: application/json

details for pricePoleConfigurationElement

pricePoleConfiguration
object (pricePoleConfigurationObject)

Responses

200
get/pricePoleConfigurationElement
/pricePoleConfigurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pricePoleConfiguration":
    {
    }
}

pricePoleIDElement definition

Request Body schema: application/json

details for pricePoleIDElement

pricePoleID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/pricePoleIDElement
/pricePoleIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pricePoleID": "string"
}

pricePolePointIDElement definition

Request Body schema: application/json

details for pricePolePointIDElement

pricePolePointID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/pricePolePointIDElement
/pricePolePointIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pricePolePointID": "string"
}

priceTierCodeElement definition

Request Body schema: application/json

details for priceTierCodeElement

priceTierCode
required
string (priceTierCodeType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

A pointer to the Price Tier Table. The values indicate the type of pricing level by which the customer purchased or may purchase the fuel grade. This is typically used for cash/credit pricing.

Responses

200
get/priceTierCodeElement
/priceTierCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "priceTierCode": "stri"
}

productCategoryElement definition

Request Body schema: application/json

details for productCategoryElement

productCategory
integer (productCategoryType) [ 0 .. 99999999 ]

the product category value determine how the POS treats the data coming from the dispenser

Responses

200
get/productCategoryElement
/productCategoryElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productCategory": 0
}

productCodeElement definition

Request Body schema: application/json

details for productCodeElement

productCode
integer (productCodeType) [ 0 .. 99999999 ]

product code provides a classification of the fuel product

Responses

200
get/productCodeElement
/productCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productCode": 0
}

productNameElement definition

Request Body schema: application/json

details for productNameElement

productName
string (productNameType) <= 16 characters

fuel product name is the unique identification of fuel sold at Service stations and C-Stores

Responses

200
get/productNameElement
/productNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productName": "string"
}

productNoElement definition

Request Body schema: application/json

details for productNoElement

productNo
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

Responses

200
get/productNoElement
/productNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productNo": 0
}

promotionElement definition

Request Body schema: application/json

details for promotionElement

promotion
required
object (promotionObject)

Responses

200
get/promotionElement
/promotionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "promotion":
    {
    }
}

pumpNoElement definition

Request Body schema: application/json

details for pumpNoElement

pumpNo
integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

Responses

200
get/pumpNoElement
/pumpNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pumpNo": 0
}

pumpTestReasonElement definition

Request Body schema: application/json

details for pumpTestReasonElement

pumpTestReason
required
string (pumpTestReasonType) [ 1 .. 16 ] characters

A reason code for the pump test defined by Conexxus (base type).

Responses

200
get/pumpTestReasonElement
/pumpTestReasonElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pumpTestReason": "string"
}

pumpTesterIDElement definition

Request Body schema: application/json

details for pumpTesterIDElement

pumpTesterID
required
string (pumpTesterIDType) [ 1 .. 40 ] characters

A unique identifer for the person (or organization) that conducted the pump test.

Responses

200
get/pumpTesterIDElement
/pumpTesterIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pumpTesterID": "string"
}

quantityUNElement definition

Request Body schema: application/json

details for quantityUNElement

quantity
required
object (quantityUNObject)

Responses

200
get/quantityUNElement
/quantityUNElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "quantity":
    {
    }
}

redeemedCouponIDElement definition

Request Body schema: application/json

details for redeemedCouponIDElement

redeemedCouponID
required
string (redeemedCouponIDType) [ 1 .. 80 ] characters

The identification of the redeemed coupon.

Responses

200
get/redeemedCouponIDElement
/redeemedCouponIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "redeemedCouponID": "string"
}

redeemedPointsTypeIDElement definition

Request Body schema: application/json

details for redeemedPointsTypeIDElement

redeemedPointsTypeID
required
string (redeemedPointsTypeIDType) [ 1 .. 40 ] characters

The identification of the type of points redeemed.

Responses

200
get/redeemedPointsTypeIDElement
/redeemedPointsTypeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "redeemedPointsTypeID": "string"
}

refundReasonElement definition

Request Body schema: application/json

details for refundReasonElement

refundReason
required
string or string (refundReasonEENUMType)

A reason code indicating why the item/merchandise was refunded defined by Conexxus (base type).

Responses

200
get/refundReasonElement
/refundReasonElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "refundReason": "damaged"
}

registerIDElement definition

Request Body schema: application/json

details for registerIDElement

registerID
required
string (registerIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

The identification of the register that finalized the sales being reported. This is typically the register number.

Responses

200
get/registerIDElement
/registerIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "registerID": "stri"
}

reportPeriodElement definition

Request Body schema: application/json

details for reportPeriodElement

reportPeriod
required
object (reportPeriodObject)

Responses

200
get/reportPeriodElement
/reportPeriodElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "reportPeriod":
    {
    }
}

reportSequenceNumberElement definition

Request Body schema: application/json

details for reportSequenceNumberElement

reportSequenceNumber
required
integer (reportSequenceNumberType) [ 0 .. 99999999 ]

A unique sequential report control number

Responses

200
get/reportSequenceNumberElement
/reportSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "reportSequenceNumber": 0
}

revenueCenterIDElement definition

Request Body schema: application/json

details for revenueCenterIDElement

revenueCenterID
required
string (revenueCenterIDType) [ 1 .. 40 ] characters

The identification of the revenue or profit center within the store.

Responses

200
get/revenueCenterIDElement
/revenueCenterIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "revenueCenterID": "string"
}

safeLoanReasonElement definition

Request Body schema: application/json

details for safeLoanReasonElement

safeLoanReason
required
string (safeLoanReasonType) [ 1 .. 16 ] characters

Safe loan reasons defined by Conexxus (base type).

Responses

200
get/safeLoanReasonElement
/safeLoanReasonElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "safeLoanReason": "string"
}

salesRestrictCodeElement definition

Request Body schema: application/json

details for salesRestrictCodeElement

salesRestrictCode
required
string or string (salesRestrictCodeEENUMType)

A pointer to a value in the SalesRestrict table. The values indicate the restrictions that apply to the item/merchandise code. defined by Conexxus (base type).

Responses

200
get/salesRestrictCodeElement
/salesRestrictCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "salesRestrictCode": "allowWIC"
}

securityLevelElement definition

Request Body schema: application/json

details for securityLevelElement

securityLevel
required
integer (securityLevelType) [ 0 .. 9999 ]

Four digit security level designation.

Responses

200
get/securityLevelElement
/securityLevelElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "securityLevel": 0
}

segmentNoElement definition

Request Body schema: application/json

details for segmentNoElement

segmentNo
integer (segmentNoType) [ 0 .. 9999 ]

segment No is the unique identification of a segment within a price pole

Responses

200
get/segmentNoElement
/segmentNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "segmentNo": 0
}

serialNumberElement definition

Request Body schema: application/json

details for serialNumberElement

serialNumber
required
string (serialNumberType) <= 40 characters

The serial number

Responses

200
get/serialNumberElement
/serialNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serialNumber": "string"
}

severityIndicatorElement definition

Request Body schema: application/json

details for severityIndicatorElement

severityIndicator
required
string (severityIndicatorType) [ 1 .. 16 ] characters

The severity of an alert event that has been raised.

Responses

200
get/severityIndicatorElement
/severityIndicatorElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "severityIndicator": "string"
}

shiftIDElement definition

Request Body schema: application/json

details for shiftIDElement

shiftID
required
string (shiftIDType) [ 1 .. 4 ] characters

For use in task scheduling, along with TaskID, description, begin time, etc.

Responses

200
get/shiftIDElement
/shiftIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "shiftID": "stri"
}

siteIDElement definition

Request Body schema: application/json

details for siteIDElement

siteID
required
string (siteIDType) [ 1 .. 40 ] characters

An alphanumeric value by which the site is identified, assumed to be unique across an organization.

Responses

200
get/siteIDElement
/siteIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "siteID": "string"
}

siteTraitElement definition

Request Body schema: application/json

details for siteTraitElement

siteTrait
required
object (siteTraitObject)

Responses

200
get/siteTraitElement
/siteTraitElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "siteTrait":
    {
    }
}

softwareComponentElement definition

Request Body schema: application/json

details for softwareComponentElement

softwareComponent
object (softwareComponentObject)

Responses

200
get/softwareComponentElement
/softwareComponentElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "softwareComponent":
    {
    }
}

stanElement definition

Request Body schema: application/json

details for stanElement

stan
required
string (stanType) <= 40 characters

System Trace Audit Number (STAN) is a unique identifier generated by the FEP when a transaction is processed. It is unique to the FEP.

Responses

200
get/stanElement
/stanElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "stan": "string"
}

stateOrProvinceElement definition

Request Body schema: application/json

details for stateOrProvinceElement

stateOrProvince
required
provinceCAENUMType (string) or stateUSENUMType (string) (stateOrProvinceENUMType)

Combination of US States and Canadian Provinces for convenience.

Responses

200
get/stateOrProvinceElement
/stateOrProvinceElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "stateOrProvince": "AB"
}

storeConceptIDElement definition

Request Body schema: application/json

details for storeConceptIDElement

storeConceptID
required
string (storeConceptIDType) [ 1 .. 40 ] characters

The identification of the concept within the RevenueCenterID, I.e. Subway within a QSR RevenueCenterID.

Responses

200
get/storeConceptIDElement
/storeConceptIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "storeConceptID": "string"
}

storeHierarchyIDElement definition

Request Body schema: application/json

details for storeHierarchyIDElement

storeHierarchyID
required
string (storeHierarchyIDType) [ 1 .. 40 ] characters

The lowest level of the store structure where the item was sold from

Responses

200
get/storeHierarchyIDElement
/storeHierarchyIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "storeHierarchyID": "string"
}

storeLocationIDElement definition

Request Body schema: application/json

details for storeLocationIDElement

storeLocationID
required
string (storeLocationIDType) [ 1 .. 40 ] characters

The store/location/site identifier assigned by the company to this physical location. It is typically the store number.

Responses

200
get/storeLocationIDElement
/storeLocationIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "storeLocationID": "string"
}

tableNameElement definition

Request Body schema: application/json

details for tableNameElement

tableName
required
string (tableNameType) <= 40 characters

For audit events, what table/field changed?

Responses

200
get/tableNameElement
/tableNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tableName": "string"
}

tankChartIDElement definition

Request Body schema: application/json

details for tankChartIDElement

tankChartID
required
string (tankChartIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

A pointer to a tank capacity chart not defined in this document.

Responses

200
get/tankChartIDElement
/tankChartIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankChartID": "stri"
}

tankGroupNoElement definition

Request Body schema: application/json

details for tankGroupNoElement

tankGroupNo
integer (tankGroupNoType) [ 0 .. 9999 ]

tank group number is the unique identifier of the tank group on a retail store

Responses

200
get/tankGroupNoElement
/tankGroupNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankGroupNo": 0
}

tankIDElement definition

Request Body schema: application/json

details for tankIDElement

tankID
required
string (tankIDType) [ 1 .. 40 ] characters

The assigned identification for a fuel product tank.

Responses

200
get/tankIDElement
/tankIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankID": "string"
}

tankLevelGaugeConfigurationElement definition

Request Body schema: application/json

details for tankLevelGaugeConfigurationElement

tankLevelGaugesConfiguration
Array of objects (tankLevelGaugeConfigurationObject) <= 100 items

tankLevelGaugeConfiguration is the array which includes the tankLevelGaugeConfiguration definition

Responses

200
get/tankLevelGaugeConfigurationElement
/tankLevelGaugeConfigurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankLevelGaugesConfiguration":
    [
    ]
}

tankLevelGaugeIDElement definition

Request Body schema: application/json

details for tankLevelGaugeIDElement

tankLevelGaugeID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/tankLevelGaugeIDElement
/tankLevelGaugeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankLevelGaugeID": "string"
}

tankManifoldIDElement definition

Request Body schema: application/json

details for tankManifoldIDElement

tankManifoldID
required
string (tankManifoldIDType) [ 1 .. 40 ] characters

The identification of the fuel product tank manifold. Usage is implementation specific.

Responses

200
get/tankManifoldIDElement
/tankManifoldIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankManifoldID": "string"
}

tankManufacturerElement definition

Request Body schema: application/json

details for tankManufacturerElement

tankManufacturer
required
string (tankManufacturerType) <= 40 characters

The name of the manufacturer of the fuel product tank.

Responses

200
get/tankManufacturerElement
/tankManufacturerElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankManufacturer": "string"
}

tankModelNumberElement definition

Request Body schema: application/json

details for tankModelNumberElement

tankModelNumber
required
string (tankModelNumberType) <= 40 characters

The model number of the fuel product tank.

Responses

200
get/tankModelNumberElement
/tankModelNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankModelNumber": "string"
}

tankNoElement definition

Request Body schema: application/json

details for tankNoElement

tankNo
integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

Responses

200
get/tankNoElement
/tankNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankNo": 0
}

tankProbeIDElement definition

Request Body schema: application/json

details for tankProbeIDElement

tankProbeID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/tankProbeIDElement
/tankProbeIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankProbeID": "string"
}

tankSerialNumberElement definition

Request Body schema: application/json

details for tankSerialNumberElement

tankSerialNumber
required
string (tankSerialNumberType) <= 40 characters

A description of the serial number of the fuel product tank.

Responses

200
get/tankSerialNumberElement
/tankSerialNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankSerialNumber": "string"
}

taskDurationElement definition

Request Body schema: application/json

details for taskDurationElement

taskDuration
required
string (taskDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

Length of time allocated to a task. Duration expression should be limited to hours, minutes, and seconds, i.e. PxHyMzS, where x = hours, y = minutes, and z = seconds

Responses

200
get/taskDurationElement
/taskDurationElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taskDuration": "string"
}

taskIDElement definition

Request Body schema: application/json

details for taskIDElement

taskID
required
string (taskIDType) [ 1 .. 4 ] characters

An ID for the task to which the timeclock event applies.

Responses

200
get/taskIDElement
/taskIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taskID": "stri"
}

taxElement definition

Request Body schema: application/json

details for taxElement

tax
required
object (taxObject)

Responses

200
get/taxElement
/taxElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tax":
    {
    }
}

taxExemptCertificateIDElement definition

Request Body schema: application/json

details for taxExemptCertificateIDElement

taxExemptCertificateID
required
string (taxExemptCertificateIDType) [ 1 .. 40 ] characters

The tax exempt number issued by the tax authority to the customer who is tax exempt.

Responses

200
get/taxExemptCertificateIDElement
/taxExemptCertificateIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxExemptCertificateID": "string"
}

taxLevelIDElement definition

Request Body schema: application/json

details for taxLevelIDElement

taxLevelID
required
string (taxLevelIDType) [ 1 .. 4 ] characters

A pointer to the Tax Level Table or Rate. The values of the table specify the tax level being reported. It usually defines a tax rate or table.

Responses

200
get/taxLevelIDElement
/taxLevelIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxLevelID": "stri"
}

taxPayerIDElement definition

Request Body schema: application/json

details for taxPayerIDElement

taxPayerID
required
string (taxPayerIDType) [ 1 .. 40 ] characters

Identifier assigned to the payer by the tax authority.

Responses

200
get/taxPayerIDElement
/taxPayerIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxPayerID": "string"
}

taxRateElement definition

Request Body schema: application/json

details for taxRateElement

taxRate
required
number (taxRateType) <= 999999

Percentage applicable to the ActualSellPrice of an item unless breakpoint matrix is used.

Responses

200
get/taxRateElement
/taxRateElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxRate": 0
}

taxReceiptDescriptionElement definition

Request Body schema: application/json

details for taxReceiptDescriptionElement

taxReceiptDescription
required
string (taxReceiptDescriptionType) <= 16 characters

Describes the tax authority in an abbreviated format.

Responses

200
get/taxReceiptDescriptionElement
/taxReceiptDescriptionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxReceiptDescription": "string"
}

taxRegistrationNumberElement definition

Request Body schema: application/json

details for taxRegistrationNumberElement

taxRegistrationNumber
required
integer (taxRegistrationNumberType) [ 0 .. 10000000000000000 ]

Number assigned by taxing authority that must appear on the register receipt or reports.

Responses

200
get/taxRegistrationNumberElement
/taxRegistrationNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxRegistrationNumber": 0
}

taxSequenceNumberElement definition

Request Body schema: application/json

details for taxSequenceNumberElement

taxSequenceNumber
required
integer (taxSequenceNumberType) [ 0 .. 9999 ]

Identifies the sequence that the included TaxLevelId should be followed to calculate the TaxLevelIDs taxes.

Responses

200
get/taxSequenceNumberElement
/taxSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxSequenceNumber": 0
}

taxStrategyIDElement definition

Request Body schema: application/json

details for taxStrategyIDElement

taxStrategyID
required
string (taxStrategyIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

It is a pointer to the Tax Strategy Maintenance Table that includes sufficient methods and/or algorithms to compute the tax relative to or required by that item/department. A TaxStrategyID = 0 indicates the item is non-taxable.

Responses

200
get/taxStrategyIDElement
/taxStrategyIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxStrategyID": "stri"
}

taxSymbolElement definition

Request Body schema: application/json

details for taxSymbolElement

taxSymbolNumber
required
string (taxSymbolType) <= 4 characters

Single or dual character that prints on the register receipt to indicate the TaxLevelID.

Responses

200
get/taxSymbolElement
/taxSymbolElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxSymbolNumber": "stri"
}

taxTableIDElement definition

Request Body schema: application/json

details for taxTableIDElement

taxTableID
required
string (taxTableIDType) [ 1 .. 4 ] characters

A pointer to a matrix of tax breakpoints for taxes that are not a straight percentage.

Responses

200
get/taxTableIDElement
/taxTableIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxTableID": "stri"
}

temperatureUNElement definition

Request Body schema: application/json

details for temperatureUNElement

temperature
required
object (temperatureUNObject)

Responses

200
get/temperatureUNElement
/temperatureUNElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "temperature":
    {
    }
}

tenderIDElement definition

Request Body schema: application/json

details for tenderIDElement

tenderID
required
object (tenderIDObject)

Responses

200
get/tenderIDElement
/tenderIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tenderID":
    {
    }
}

tentIDElement definition

Request Body schema: application/json

details for tentIDElement

tentID
required
string (tentIDType) [ 1 .. 8 ] characters

The number on the little tent given to the customer in a food service environment. The customer places the tent on their table, and the staff uses it to locate the correct table to delivery the food to after preparation

Responses

200
get/tentIDElement
/tentIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tentID": "string"
}

terminalStatusCodeElement definition

Request Body schema: application/json

details for terminalStatusCodeElement

terminalStatusCode
required
string or string (terminalStatusCodeEENUMType)

terminalStatusCode values defined by Conexxus (base type)

Responses

200
get/terminalStatusCodeElement
/terminalStatusCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "terminalStatusCode": "startup"
}

tillIDElement definition

Request Body schema: application/json

details for tillIDElement

tillID
required
string (tillIDType) [ 1 .. 4 ] characters

Identifies the till in a multiple till per register scenario.

Responses

200
get/tillIDElement
/tillIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tillID": "stri"
}

timeClockSequenceNumberElement definition

Request Body schema: application/json

details for timeClockSequenceNumberElement

timeClockSequenceNumber
required
integer (timeClockSequenceNumberType) [ 0 .. 99999999 ]

Identifier for a TimeClockDetail entry.

Responses

200
get/timeClockSequenceNumberElement
/timeClockSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeClockSequenceNumber": 0
}

timeElement definition

Request Body schema: application/json

details for timeElement

time
required
string <time> (timeType) [ 8 .. 14 ] characters

ISO 8601 time designation aligning with XML Schema.

Responses

200
get/timeElement
/timeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "time": "stringst"
}

timeTierCodeElement definition

Request Body schema: application/json

details for timeTierCodeElement

timeTierCode
required
string (timeTierCodeType) [ 1 .. 16 ] characters

A pointer to the Time Tier Table. The values indicate the type of time tier by which the customer purchased or may purchase a fuel grade. This is typically used for day segment pricing.

Responses

200
get/timeTierCodeElement
/timeTierCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeTierCode": "string"
}

timeUNUOMElement definition

Request Body schema: application/json

details for timeUNUOMElement

timeUOM
required
string (timeUNUOMENUMType) <= 3 characters
Enum: "SEC" "MIN" "HUR" "DAY" "WEE" "MON" "ANN"

Common time units of measure

Responses

200
get/timeUNUOMElement
/timeUNUOMElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeUOM": "SEC"
}

timeZoneElement definition

Request Body schema: application/json

details for timeZoneElement

timeZone
required
string (timeZoneType) <= 24 characters

24 character timezone description.

Responses

200
get/timeZoneElement
/timeZoneElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "string"
}

timestampElement definition

Request Body schema: application/json

details for timestampElement

timestamp
string <date-time> (dateTimeType) [ 10 .. 30 ] characters

Responses

200
get/timestampElement
/timestampElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timestamp": "2020-06-23T16:37:36Z"
}

transactionIDElement definition

Request Body schema: application/json

details for transactionIDElement

transactionID
required
string (transactionIDType) [ 1 .. 16 ] characters

Identifier for the transaction within a given period.

Responses

200
get/transactionIDElement
/transactionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionID": "string"
}

transactionLineSequenceNumberElement definition

Request Body schema: application/json

details for transactionLineSequenceNumberElement

transactionLineSequenceNumber
required
integer (transactionLineSequenceNumberType) [ 0 .. 99999999 ]

The sequence number assigned to the transaction line by the register.

Responses

200
get/transactionLineSequenceNumberElement
/transactionLineSequenceNumberElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionLineSequenceNumber": 0
}

transactionSeqNoElement definition

Request Body schema: application/json

details for transactionSeqNoElement

transactionSeqNo
integer (transactionSeqNoType) [ 0 .. 99999999 ]

transactionSeqNo is the unique identifier of a transaction

Responses

200
get/transactionSeqNoElement
/transactionSeqNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionSeqNo": 0
}

transmissionIDElement definition

Request Body schema: application/json

details for transmissionIDElement

transmissionID
required
integer (transmissionIDType) [ 0 .. 99999999 ]

An unique identifier for a particular report.

Responses

200
get/transmissionIDElement
/transmissionIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transmissionID": 0
}

transponderIDElement definition

Request Body schema: application/json

details for transponderIDElement

transponderID
required
string (transponderIDType) [ 1 .. 40 ] characters

Electronic ID of the transponder.

Responses

200
get/transponderIDElement
/transponderIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transponderID": "string"
}

trayIDElement definition

Request Body schema: application/json

details for trayIDElement

trayID
required
string (trayIDType) [ 1 .. 16 ] characters

A unique identifier denoting the tray that was used within a food service environment.

Responses

200
get/trayIDElement
/trayIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "trayID": "string"
}

userIDElement definition

Request Body schema: application/json

details for userIDElement

userID
string (userIDType) <= 16 characters

userID is used to identify the ID of the user who performs certain operation

Responses

200
get/userIDElement
/userIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userID": "string"
}

userNameElement definition

Request Body schema: application/json

details for userNameElement

userName
string (userNameType) <= 40 characters

userName is used to identify the name of the user who performs certain operation

Responses

200
get/userNameElement
/userNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userName": "string"
}

uuidElement definition

Request Body schema: application/json

details for uuidElement

uuid
required
string (uuidType) [ 1 .. 40 ] characters

A unique identifier.

Responses

200
get/uuidElement
/uuidElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "uuid": "string"
}

vehicleColorElement definition

Request Body schema: application/json

details for vehicleColorElement

vehicleColor
required
string (vehicleColorType) <= 24 characters

The color of the vehicle.

Responses

200
get/vehicleColorElement
/vehicleColorElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "vehicleColor": "string"
}

vehicleIDElement definition

Request Body schema: application/json

details for vehicleIDElement

vehicleID
required
string (vehicleIDType) [ 1 .. 40 ] characters

The identification of the vehicle in the fleet card purchase.

Responses

200
get/vehicleIDElement
/vehicleIDElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "vehicleID": "string"
}

vehicleTypeElement definition

Request Body schema: application/json

details for vehicleTypeElement

vehicleType
required
string (vehicleTypeType) <= 24 characters

Type of vehicle.

Responses

200
get/vehicleTypeElement
/vehicleTypeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "vehicleType": "string"
}

vendorModelVersionElement definition

Request Body schema: application/json

details for vendorModelVersionElement

vendorModelVersion
required
string (vendorModelVersionType) <= 40 characters

A description of the POS or Back Office model/version. The use of this element is an implementation choice. Some may prefer to set up a general table containing this information

Responses

200
get/vendorModelVersionElement
/vendorModelVersionElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "vendorModelVersion": "string"
}

vendorNameElement definition

Request Body schema: application/json

details for vendorNameElement

vendorName
required
string (vendorNameType) <= 40 characters

The POS or Back Office vendor name. The use of this element is an implementation choice. Some may prefer to set up a general table containing this information

Responses

200
get/vendorNameElement
/vendorNameElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "vendorName": "string"
}

voidReasonElement definition

Request Body schema: application/json

details for voidReasonElement

voidReason
required
string (voidReasonType) [ 1 .. 16 ] characters

A reason code indicating why the item/merchandise was voided defined by Conexxus (base type).

Responses

200
get/voidReasonElement
/voidReasonElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "voidReason": "string"
}

volumeUNElement definition

Request Body schema: application/json

details for volumeUNElement

volume
required
object (volumeUNObject)

Responses

200
get/volumeUNElement
/volumeUNElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "volume":
    {
    }
}

washCodeElement definition

Request Body schema: application/json

details for washCodeElement

washCode
required
integer (washCodeType) [ 0 .. 10000000000000000 ]

The code assigned to the purchased wash, needed for redemption at the pedestal.

Responses

200
get/washCodeElement
/washCodeElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "washCode": 0
}

yesNoElement definition

Request Body schema: application/json

details for yesNoElement

yesNo
required
string (yesNoENUMType) <= 4 characters
Enum: "yes" "no"

Yes or no value, used as a more flexible option to true/false.

Responses

200
get/yesNoElement
/yesNoElement

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "yesNo": "yes"
}

DataTypes

accountIDType definition

Request Body schema: application/json

details for accountIDType

string (accountIDType) [ 1 .. 40 ] characters

The identification of the account related to the tender type.

Responses

200
get/accountIDType
/accountIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

accountNameType definition

Request Body schema: application/json

details for accountNameType

string (accountNameType) <= 40 characters

The name of the account related to the tender type.

Responses

200
get/accountNameType
/accountNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

ageType definition

Request Body schema: application/json

details for ageType

integer (ageType) [ 0 .. 199 ]

age in years of a human system participant.

Responses

200
get/ageType
/ageType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

alarmDurationType definition

Request Body schema: application/json

details for alarmDurationType

string (alarmDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

The number of seconds that the drawer alarm sounded in a Drawer Alarm event. Since the designation is in seconds, the duration should be limited to expressing seconds, i.e. PxS, where 'x' is the number of seconds.

Responses

200
get/alarmDurationType
/alarmDurationType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

approvalCodeType definition

Request Body schema: application/json

details for approvalCodeType

string (approvalCodeType) [ 1 .. 40 ] characters

Common approval code for payment or other POS operations.

Responses

200
get/approvalCodeType
/approvalCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

approvalReferenceCodeType definition

Request Body schema: application/json

details for approvalReferenceCodeType

string (approvalReferenceCodeType) [ 1 .. 40 ] characters

The code given by the authorizing host.

Responses

200
get/approvalReferenceCodeType
/approvalReferenceCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

approverIDType definition

Request Body schema: application/json

details for approverIDType

string (approverIDType) [ 1 .. 40 ] characters

An identifier for the cashier or manager that approved the SaleEvent, RefundEvent, VoidEvent or TransactionLine.

Responses

200
get/approverIDType
/approverIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

auditStatusENUMType definition

Request Body schema: application/json

details for auditStatusENUMType

string (auditStatusENUMType) <= 16 characters
Enum: "open" "close" "audit" "closeAudit"

Status of a till or a period for an audit record (ne).

Responses

200
get/auditStatusENUMType
/auditStatusENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"open"

authorizationApprovalDescriptionType definition

Request Body schema: application/json

details for authorizationApprovalDescriptionType

string (authorizationApprovalDescriptionType) <= 40 characters

A description of the authorization approval.

Responses

200
get/authorizationApprovalDescriptionType
/authorizationApprovalDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizationCodeType definition

Request Body schema: application/json

details for authorizationCodeType

string (authorizationCodeType) <= 40 characters

The authorization code received from the processing host.

Responses

200
get/authorizationCodeType
/authorizationCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizationResponseCodeType definition

Request Body schema: application/json

details for authorizationResponseCodeType

string (authorizationResponseCodeType) <= 40 characters

A description of the authorization response received.

Responses

200
get/authorizationResponseCodeType
/authorizationResponseCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizationResponseDescriptionType definition

Request Body schema: application/json

details for authorizationResponseDescriptionType

string (authorizationResponseDescriptionType) <= 40 characters

A description of the authorization response received.

Responses

200
get/authorizationResponseDescriptionType
/authorizationResponseDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizationTransactionENUMType definition

Request Body schema: application/json

details for authorizationTransactionENUMType

string (authorizationTransactionENUMType) <= 40 characters
Enum: "auth" "batchClose" "batchDetailList" "batchInquiry" "batchResend" "batchSummary" "blackList" "block" "capture" "config" "deviceRequest" "enroll" "epsCommand" "fileTransfer" "force" "itemLevelData" "loyalty" "loyaltyAuth" "loyaltyAward" "loyaltyCapture" "loyaltyInquiry" "loyaltyRedemption" "mail" "manualVerify" "networkTest" "other" "parent" "payment" "pinchange" "posComplete" "posData" "preActivate" "prepayRefund" "protStatus" "receiptReprint" "redemptionRefund" "refund" "replace" "report" "requestKeyDef" "requestNewKey" "reversal" "sale" "svcactivate" "svcBalance" "svcDeactivate" "svcHistory" "svcMerge" "validate" "value" "void" "zeroout"

The kind of authorization transaction.

Responses

200
get/authorizationTransactionENUMType
/authorizationTransactionENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"auth"

authorizingCashierIDType definition

Request Body schema: application/json

details for authorizingCashierIDType

string (authorizingCashierIDType) [ 1 .. 40 ] characters

The cashier authorizing the drive off or pump test

Responses

200
get/authorizingCashierIDType
/authorizingCashierIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizingHostIDType definition

Request Body schema: application/json

details for authorizingHostIDType

string (authorizingHostIDType) [ 1 .. 16 ] characters

The identification of the POS or Credit Card Authorizing Host related to the specific authorization

Responses

200
get/authorizingHostIDType
/authorizingHostIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

authorizingTerminalIDType definition

Request Body schema: application/json

details for authorizingTerminalIDType

string (authorizingTerminalIDType) [ 1 .. 16 ] characters

The identification of the POS or Credit Card Authorizing terminal related to the specific authorization

Responses

200
get/authorizingTerminalIDType
/authorizingTerminalIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

automaticDiscountIDType definition

Request Body schema: application/json

details for automaticDiscountIDType

integer (automaticDiscountIDType) [ 0 .. 10000000000000000 ]

AutomaticDiscountID is a pointer to a discount in a discount table to be applied to an item any time it is sold

Responses

200
get/automaticDiscountIDType
/automaticDiscountIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

bankAccountNumberType definition

Request Body schema: application/json

details for bankAccountNumberType

integer (bankAccountNumberType) [ 0 .. 10000000000000000 ]

The bank account number of the check being processed.

Responses

200
get/bankAccountNumberType
/bankAccountNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

bankIDType definition

Request Body schema: application/json

details for bankIDType

integer (bankIDType) [ 0 .. 10000000000000000 ]

The identification of the bank for the check being processed.

Responses

200
get/bankIDType
/bankIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

batchCloseReasonEENUMType definition

Request Body schema: application/json

details for batchCloseReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "shift" "day" "full" "timeout"

Reason for Batch Close.

Responses

200
get/batchCloseReasonEENUMType
/batchCloseReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

batchEENUMType definition

Request Body schema: application/json

details for batchEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "debit" "credit"

Indicates batch type.

Responses

200
get/batchEENUMType
/batchEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

batchNumberType definition

Request Body schema: application/json

details for batchNumberType

integer (batchNumberType) [ 0 .. 10000000000000000 ]

A unique identifier for the batch that has been created.

Responses

200
get/batchNumberType
/batchNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

batchSequenceNumberType definition

Request Body schema: application/json

details for batchSequenceNumberType

string (batchSequenceNumberType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

Short batch sequence number.

Responses

200
get/batchSequenceNumberType
/batchSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

batchStatusEENUMType definition

Request Body schema: application/json

details for batchStatusEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "closed" "open" "approved"

Indicates batch status

Responses

200
get/batchStatusEENUMType
/batchStatusEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

biometricIdentifierType definition

Request Body schema: application/json

details for biometricIdentifierType

string (biometricIdentifierType) <= 40 characters

Free-form text from a reading device.

Responses

200
get/biometricIdentifierType
/biometricIdentifierType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

breakDurationType definition

Request Body schema: application/json

details for breakDurationType

string (breakDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

The duration of a break, expressed in minutes and seconds. PxMyS is the normal expression, where x = minutes and y = seconds

Responses

200
get/breakDurationType
/breakDurationType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

calculationENUMType definition

Request Body schema: application/json

details for calculationENUMType

string (calculationENUMType) <= 16 characters
Enum: "actual" "calculated"

Indicates whether a value was read (actual) or calculated somehow

Responses

200
get/calculationENUMType
/calculationENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"actual"

cardCategoryType definition

Request Body schema: application/json

details for cardCategoryType

string (cardCategoryType) [ 1 .. 2 ] characters

Short card category

Responses

200
get/cardCategoryType
/cardCategoryType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"st"

cardCircuitType definition

Request Body schema: application/json

details for cardCircuitType

string (cardCircuitType) [ 1 .. 20 ] characters

The CardCircuit dentifies the card type. This element is intended to align with the requirements of the EPS 2.7 (and later) standard

Responses

200
get/cardCircuitType
/cardCircuitType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

cardDescriptionType definition

Request Body schema: application/json

details for cardDescriptionType

string (cardDescriptionType) <= 40 characters

Description of card

Responses

200
get/cardDescriptionType
/cardDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

cardTypeIDType definition

Request Body schema: application/json

details for cardTypeIDType

string (cardTypeIDType) [ 1 .. 16 ] characters

Card identifier

Responses

200
get/cardTypeIDType
/cardTypeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

cashierIDType definition

Request Body schema: application/json

details for cashierIDType

string (cashierIDType) [ 1 .. 40 ] characters

Identifies the cashier conducting the transaction(s) in the reporting period

Responses

200
get/cashierIDType
/cashierIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

checkNumberType definition

Request Body schema: application/json

details for checkNumberType

integer (checkNumberType) [ 0 .. 10000000000000000 ]

The sequential number assigned to the check, which is generally pre-printed in the upper right hand corner of the check

Responses

200
get/checkNumberType
/checkNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

cityType definition

Request Body schema: application/json

details for cityType

string (cityType) <= 40 characters

The city portion of the address

Responses

200
get/cityType
/cityType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

clockEntryEENUMType definition

Request Body schema: application/json

details for clockEntryEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "manual" "automatic"

Entry method for time-clock events.

Responses

200
get/clockEntryEENUMType
/clockEntryEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

comboDescriptionType definition

Request Body schema: application/json

details for comboDescriptionType

string (comboDescriptionType) <= 40 characters

A free form description of the combination offered for sale - "combo", i.e., "Manager's Special", "Sandwich Combo", etc.

Responses

200
get/comboDescriptionType
/comboDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

commissionRateType definition

Request Body schema: application/json

details for commissionRateType

string (commissionRateType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

Rate paid for commission, expressed as a decimal number (left of decimal).

Responses

200
get/commissionRateType
/commissionRateType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

componentActionENUMType definition

Request Body schema: application/json

details for componentActionENUMType

string (componentActionENUMType) <= 16 characters
Enum: "isMemberOf" "isAddedTo" "isRemovedFrom"

An identifer for how the component item is attached to the main item in the sale

Responses

200
get/componentActionENUMType
/componentActionENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"isMemberOf"

conceptIDType definition

Request Body schema: application/json

details for conceptIDType

string (conceptIDType) [ 1 .. 40 ] characters

This identifies a particular branding within a RevenueCenterID. For example, Subway within a QSR RevenueCenterID.

Responses

200
get/conceptIDType
/conceptIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

condimentNameType definition

Request Body schema: application/json

details for condimentNameType

string (condimentNameType) <= 40 characters

The name of the item that is being sold as optional extra alongside some other item.

Responses

200
get/condimentNameType
/condimentNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

countType definition

Request Body schema: application/json

details for countType

integer (countType) [ 0 .. 9999999999 ]

A 'number of times' or 'number of objects'.

Responses

200
get/countType
/countType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

countryEENUMType definition

Request Body schema: application/json

details for countryEENUMType

Any of
  • string
  • string
string <= 2 characters ^[A-Z][A-Z]
Enum: "AF" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "KH" "CM" "CA" "CV" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "CI" "HR" "CU" "CY" "CZ" "DK" "DJ" "DM" "DO" "TP" "EC" "EG" "SV" "GQ" "ER" "EE" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IL" "IT" "JM" "JP" "JO" "KZ" "KE" "KI" "KP" "KR" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MK" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "AN" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "MP" "NO" "OM" "PK" "PW" "PS" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "SH" "KN" "LC" "PM" "VC" "WS" "SM" "ST" "SA" "SN" "SC" "SL" "SG" "SK" "SI" "SB" "SO" "ZA" "GS" "ES" "LK" "SD" "SR" "SJ" "SZ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "US" "UM" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "YU" "ZM" "ZW"

ISO-3166 / UN/ECE REC 09 Codes

Responses

200
get/countryEENUMType
/countryEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"st"

currencyEENUMType definition

Request Body schema: application/json

details for currencyEENUMType

Any of
  • string
  • string
string <= 3 characters
Enum: "AED" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHC" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SIT" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "USS" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XYER" "ZAR" "ZMW" "ZWL"

ISO-4217 / UN/ECE REC 09 Codes

Responses

200
get/currencyEENUMType
/currencyEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"str"

currencyExchangeRateType definition

Request Body schema: application/json

details for currencyExchangeRateType

number (currencyExchangeRateType) [ 0 .. 999999999999 ]

For currency exchange, 6,6 decimal.

Responses

200
get/currencyExchangeRateType
/currencyExchangeRateType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

customerPONumberType definition

Request Body schema: application/json

details for customerPONumberType

string (customerPONumberType) [ 1 .. 16 ] characters

PO number

Responses

200
get/customerPONumberType
/customerPONumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

dataReadEventTypeCodeENUMType definition

Request Body schema: application/json

details for dataReadEventTypeCodeENUMType

string (dataReadEventTypeCodeENUMType)
Enum: "periodClose" "delivery" "fuelPriceChange" "returnToService"

Indicates why a value (usually a fuel meter) was read.

Responses

200
get/dataReadEventTypeCodeENUMType
/dataReadEventTypeCodeENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"periodClose"

dateTimeType definition

Request Body schema: application/json

details for dateTimeType

string <date-time> (dateTimeType) [ 10 .. 30 ] characters

Responses

200
get/dateTimeType
/dateTimeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"2020-06-23T16:37:36Z"

dateType definition

Request Body schema: application/json

details for dateType

string <date> (dateType) <= 10 characters

ISO 8601 Date Type to align with XML Schema.

Responses

200
get/dateType
/dateType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"2020-06-23"

dayOfWeekENUMType definition

Request Body schema: application/json

details for dayOfWeekENUMType

string (dayOfWeekENUMType) <= 16 characters
Enum: "Sunday" "Monday" "Tuesday" "Wednesday" "Thursday" "Friday" "Saturday"

Day of the week.

Responses

200
get/dayOfWeekENUMType
/dayOfWeekENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"Sunday"

deliveryReasonEENUMType definition

Request Body schema: application/json

details for deliveryReasonEENUMType

Any of
  • string
  • string
string [ 5 .. 15 ] characters ^[A-Z][A-Za-z]{4,14}
Enum: "Delivery" "TestTransfer" "WaterUplift" "ProductUplift" "TankToTank" "Empty"

the reason for the tank movement

Responses

200
get/deliveryReasonEENUMType
/deliveryReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

deliveryTypeENUMType definition

Request Body schema: application/json

details for deliveryTypeENUMType

string (deliveryTypeENUMType) <= 6 characters ^[A-Z][a-z]{3,5}
Enum: "Fill" "Remove"

delivery type identifies whether the movement adds or removes product from the tank contents

Responses

200
get/deliveryTypeENUMType
/deliveryTypeENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"Fill"

descriptionIDType definition

Request Body schema: application/json

details for descriptionIDType

string (descriptionIDType) [ 1 .. 8 ] characters

A reference string for description lookup.

Responses

200
get/descriptionIDType
/descriptionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

deviceIDType definition

Request Body schema: application/json

details for deviceIDType

string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

Responses

200
get/deviceIDType
/deviceIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

discountIDType definition

Request Body schema: application/json

details for discountIDType

string (discountIDType) [ 1 .. 40 ] characters

A reference string for identifying a discount.

Responses

200
get/discountIDType
/discountIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

discountReasonEENUMType definition

Request Body schema: application/json

details for discountReasonEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "storeCouponOffer" "freeCarWashOffer" "technicianTestCW" "employeeDiscount" "servicesDiscount" "seniorsDiscount" "close2ExpiryDate" "reducedQuickSale" "loyaltyDiscount" "manufCouponNoTax" "managersGoodwill" "managerPromotion" "regPriceChange" "preferredTender"

A reason code indicating why the item/merchandise was discounted defined by Conexxus (base type).

Responses

200
get/discountReasonEENUMType
/discountReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

dispPromptMethodEENUMType definition

Request Body schema: application/json

details for dispPromptMethodEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "display" "prompt" "visualAlarm" "audibleAlarm" "none"

display or prompt (base type)

Responses

200
get/dispPromptMethodEENUMType
/dispPromptMethodEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

displayType definition

Request Body schema: application/json

details for displayType

string (displayType) [ 1 .. 40 ] characters

Open reference to a display device, used for things like how to present help, etc.

Responses

200
get/displayType
/displayType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

driverIDType definition

Request Body schema: application/json

details for driverIDType

string (driverIDType) [ 1 .. 40 ] characters

The type of identification used to verify the identification of the driver.

Responses

200
get/driverIDType
/driverIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

dropNumberType definition

Request Body schema: application/json

details for dropNumberType

string (dropNumberType) [ 1 .. 8 ] characters

A unique identifer for the safe drop that was performed.

Responses

200
get/dropNumberType
/dropNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

earlyPunchType definition

Request Body schema: application/json

details for earlyPunchType

string (earlyPunchType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

How early is the employee allowed to punch. Duration expression should be limited to hours, minutes, and seconds, i.e. PxHyMzS, where x = hours, y = minutes, and z = seconds.

Responses

200
get/earlyPunchType
/earlyPunchType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

electronicSignatureType definition

Request Body schema: application/json

details for electronicSignatureType

string (electronicSignatureType) <= 40 characters

Used to give the electronic signature value where signature capture device is present for additional verification.

Responses

200
get/electronicSignatureType
/electronicSignatureType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

emailAddressType definition

Request Body schema: application/json

details for emailAddressType

string (emailAddressType) <= 320 characters

email address (valid according RFC 3696).

Responses

200
get/emailAddressType
/emailAddressType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

employeeIDType definition

Request Body schema: application/json

details for employeeIDType

string (employeeIDType) [ 1 .. 16 ] characters

Identifier for an employee. Use caution not to disclose PII.

Responses

200
get/employeeIDType
/employeeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

employeeNumberType definition

Request Body schema: application/json

details for employeeNumberType

string (employeeNumberType) [ 1 .. 16 ] characters

A unique identifer for the employee that is referred to in a TimeClock event.

Responses

200
get/employeeNumberType
/employeeNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

employeeRoleType definition

Request Body schema: application/json

details for employeeRoleType

string (employeeRoleType) <= 40 characters

Role of the employee for a given task.

Responses

200
get/employeeRoleType
/employeeRoleType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

entryMethodENUMType definition

Request Body schema: application/json

details for entryMethodENUMType

string (entryMethodENUMType) <= 24 characters
Enum: "scan" "manual" "manual-EMVfallback" "plu" "biometric" "rfid" "nfc" "nfc-MSD" "nfc-EMV" "chip" "chip-EMV" "button" "swipe" "swipe-EMVfallback" "cloud" "SMS" "other"

Entry method use for the associated data value.

Responses

200
get/entryMethodENUMType
/entryMethodENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"scan"

envelopeIDType definition

Request Body schema: application/json

details for envelopeIDType

string (envelopeIDType) [ 1 .. 40 ] characters

The unique identifier that was on the envelope, that the money was placed in during the safe drop event.

Responses

200
get/envelopeIDType
/envelopeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

epsNameType definition

Request Body schema: application/json

details for epsNameType

string (epsNameType) <= 40 characters

Unique name of the EPS with in a given site. A site can have one or more EPS.

Responses

200
get/epsNameType
/epsNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

eventIDType definition

Request Body schema: application/json

details for eventIDType

string (eventIDType) [ 1 .. 40 ] characters

The identification of a specific event responsible for the reward.

Responses

200
get/eventIDType
/eventIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

eventSequenceIDType definition

Request Body schema: application/json

details for eventSequenceIDType

integer (eventSequenceIDType) [ 0 .. 10000000000000000 ]

A unique identifer for the FinancialEvent.

Responses

200
get/eventSequenceIDType
/eventSequenceIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

eventTypeType definition

Request Body schema: application/json

details for eventTypeType

string (eventTypeType) <= 40 characters

Used mainly in MaintenanceAuditEvent (Journal) to designate the type of event that triggered the audit.

Responses

200
get/eventTypeType
/eventTypeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

expDateDateType definition

Request Body schema: application/json

details for expDateDateType

integer (expDateDateType) [ 1 .. 31 ]

Expiration day of month.

Responses

200
get/expDateDateType
/expDateDateType

Request samples

Content type
application/json
Copy
Expand all Collapse all
1

expDateMonthType definition

Request Body schema: application/json

details for expDateMonthType

integer (expDateMonthType) [ 1 .. 12 ]

Expiration month.

Responses

200
get/expDateMonthType
/expDateMonthType

Request samples

Content type
application/json
Copy
Expand all Collapse all
1

expDateYearType definition

Request Body schema: application/json

details for expDateYearType

integer (expDateYearType) [ 1500 .. 3000 ]

Expiration year.

Responses

200
get/expDateYearType
/expDateYearType

Request samples

Content type
application/json
Copy
Expand all Collapse all
1500

extendedLabelIDType definition

Request Body schema: application/json

details for extendedLabelIDType

string (extendedLabelIDType) [ 1 .. 16 ] characters ^[0-9]{1,16}$

An extra label from a coupon.

Responses

200
get/extendedLabelIDType
/extendedLabelIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

familyCodeType definition

Request Body schema: application/json

details for familyCodeType

string (familyCodeType) [ 1 .. 3 ] characters ^[0-9]{1,3}$

That portion of a U.P.C. on a manufacturer's coupon used to identify an item's grouping for discount purposes.

Responses

200
get/familyCodeType
/familyCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"str"

feeIDType definition

Request Body schema: application/json

details for feeIDType

string (feeIDType) [ 1 .. 16 ] characters

An ID for a fee applied to a transaction.

Responses

200
get/feeIDType
/feeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fieldNameType definition

Request Body schema: application/json

details for fieldNameType

string (fieldNameType) <= 16 characters

For audit events, what table/field changed?

Responses

200
get/fieldNameType
/fieldNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fuelEventENUMType definition

Request Body schema: application/json

details for fuelEventENUMType

string (fuelEventENUMType)
Enum: "periodClose" "delivery" "fuelPriceChange" "returnToService"

Indicates the reason for the fuel reading

Responses

200
get/fuelEventENUMType
/fuelEventENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"periodClose"

fuelGradeSequenceIDType definition

Request Body schema: application/json

details for fuelGradeSequenceIDType

integer (fuelGradeSequenceIDType) [ 0 .. 9999 ]

The sequence number to which the FuelGradeID is assigned. Normally hose ID.

Responses

200
get/fuelGradeSequenceIDType
/fuelGradeSequenceIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

fuelPositionIDType definition

Request Body schema: application/json

details for fuelPositionIDType

integer (fuelPositionIDType) [ 0 .. 9999 ]

ID for Fuel Position.

Responses

200
get/fuelPositionIDType
/fuelPositionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

fuelPositionStatusType definition

Request Body schema: application/json

details for fuelPositionStatusType

string (fuelPositionStatusType) <= 16 characters

The status of a fuel position that causes a PumpStatus event to occur.

Responses

200
get/fuelPositionStatusType
/fuelPositionStatusType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fuelPriceChangeIDType definition

Request Body schema: application/json

details for fuelPriceChangeIDType

string (fuelPriceChangeIDType) [ 1 .. 40 ] characters

The system dependent identifier for a fuel price change event.

Responses

200
get/fuelPriceChangeIDType
/fuelPriceChangeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fuelProductBlendPercentType definition

Request Body schema: application/json

details for fuelProductBlendPercentType

string (fuelProductBlendPercentType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

This is the percentage of FuelProductID used in a blending of two fuel products to create a fuel grade. The blend percentage of FuelProductIDHigh is 100 less FuelProductBlendPercent. If not a blended fuel grade then put 100 as the FuelProductBlendPercent.

Responses

200
get/fuelProductBlendPercentType
/fuelProductBlendPercentType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fuelProductStatusType definition

Request Body schema: application/json

details for fuelProductStatusType

string (fuelProductStatusType) <= 16 characters

The status of the fuel product at the time of the tank reading.

Responses

200
get/fuelProductStatusType
/fuelProductStatusType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

fuelingPointStateEENUMType definition

Request Body schema: application/json

details for fuelingPointStateEENUMType

Any of
  • string
  • string
string <= 25 characters ^[A-Z_]{5,25}
Enum: "CONFIGURE" "DISABLED" "ERRORSTATE" "FUELLING" "SUSPENDED_FUELLING" "INVALIDSTATE" "OFFLINE" "OUTOFORDER" "READY" "REQUESTED" "STARTED" "SUSPENDED_STARTED" "CALLING" "CLOSED" "AUTHORISED"

fueling point state is a string of characters used to identify the state of a fueling point

Responses

200
get/fuelingPointStateEENUMType
/fuelingPointStateEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

giskeAlgorithmEENUMType definition

Request Body schema: application/json

details for giskeAlgorithmEENUMType

Any of
  • string
  • string
string
Enum: "3des" "aes" "des" "dsa" "ellipticCurve" "rsa" "unknownOrUnspecified"

GISKE Specification 2.3a - Key Block header byte 7

Responses

200
get/giskeAlgorithmEENUMType
/giskeAlgorithmEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

giskeExportabilityEENUMType definition

Request Body schema: application/json

details for giskeExportabilityEENUMType

Any of
  • string
  • string
string
Enum: "sensitive" "exportable" "nonExportable"

GISKE Specification 2.3a - Key Block header byte 27. Exportability refers to transfer outside the system in which the key is found. Secure backup of a key may be allowed, depending on local rules. Flags in this field indicate special types of keys that require unusual handling. Any key that does not follow normal security assumptions should have a notation in this field. This may mean that the key should be less trusted, like a CAPI key, or that the key assumes a high degree of trust, such as a CA key. In general, a letter in this column means that future developers should check the definition of this type of key carefully.

Responses

200
get/giskeExportabilityEENUMType
/giskeExportabilityEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

giskeKeyUsageEENUMType definition

Request Body schema: application/json

details for giskeKeyUsageEENUMType

Any of
  • string
  • string
string <= 25 characters
Enum: "dataEncryption" "controlVector" "keyEncryptionOrWrapping" "macGeneration" "macVerification" "pinEncryption" "pinVerification" "cardVerificationKey" "keyComponent" "baseDerivationKey" "iso-9791-1-mac1-56" "iso-9791-1-mac1-112" "iso-9791-1-mac2-112" "iso-9791-1-mac3-112" "iso-9791-1-mac4-112" "iso-9791-1-mac5-56" "iso-9791-1-mac5-112"

GISKE Specification 2.3a - Key Block header bytes 5 and 6. Note that these usages may work for both symmetric and asymmetric keys. This list of usages is not intended to be exhaustive. Future versions may include other key usages types.

Responses

200
get/giskeKeyUsageEENUMType
/giskeKeyUsageEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

giskeModeOfUseEENUMType definition

Request Body schema: application/json

details for giskeModeOfUseEENUMType

Any of
  • string
  • string
string
Enum: "noSpecialRestrictions" "encryptOnly" "decryptOnly" "signatureOnly" "macGenerate" "macVerify" "macCalculate" "iv"

GISKE Specification 2.3a - Key Block header byte 8

Responses

200
get/giskeModeOfUseEENUMType
/giskeModeOfUseEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

gtinType definition

Request Body schema: application/json

details for gtinType

string (gtinType) ^(01)[0-9]{14}(21([\x21-\x22\x25-\x2F\x30-\x39\x3A-\x3F\x41-\x5A\x5F\x61-\x7A]{0,20}))?$

AI for GTIN-14 is '01', GTIN is 14 digits, optional AI for serial number is '21', followed by 0-20 characters as defined.

Responses

200
get/gtinType
/gtinType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

idEENUMType definition

Request Body schema: application/json

details for idEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "driversLicense" "socialSecurityNm" "passport" "birthCertificate"

Identification types (driver's license, social security number, etc.) defined by Conexxus.

Responses

200
get/idEENUMType
/idEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

intervalENUMType definition

Request Body schema: application/json

details for intervalENUMType

string (intervalENUMType) <= 16 characters
Enum: "cashier" "day" "week" "month" "year" "daypart" "shift" "transaction" "sBatch" "hostBatch" "other"

Sometimes refered to as 'day part' values, refers to the scoped period of a report.

Responses

200
get/intervalENUMType
/intervalENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"cashier"

itemIDType definition

Request Body schema: application/json

details for itemIDType

string (itemIDType) [ 1 .. 40 ] characters

Generic ID for items and links to them.

Responses

200
get/itemIDType
/itemIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

itemListIDType definition

Request Body schema: application/json

details for itemListIDType

string (itemListIDType) [ 1 .. 40 ] characters

A pointer to the Item List look-up table. A "null" or "no value" for ItemListIDType may be allowed.

Responses

200
get/itemListIDType
/itemListIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

itemTypeCodeEENUMType definition

Request Body schema: application/json

details for itemTypeCodeEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "carwash" "fees" "fuel" "gift" "license" "lottery" "lotto" "misc" "moneyOrder" "mdse" "phone" "post" "qsr" "serv" "video" "bottleDeposit" "prepaidCards" "couponMerch" "couponMfg" "containerDeposit" "containerRedemp"

A pointer to the Item Type Look-up table. A "null" or "no value" for ItemTypeCode should be allowed.

Responses

200
get/itemTypeCodeEENUMType
/itemTypeCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

jobCodeType definition

Request Body schema: application/json

details for jobCodeType

string (jobCodeType) [ 1 .. 40 ] characters

A code denoting the job that the employee was linked to during a TimeClock event.

Responses

200
get/jobCodeType
/jobCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

jobIDType definition

Request Body schema: application/json

details for jobIDType

string (jobIDType) [ 1 .. 40 ] characters

The identification of the job associated with the fleet card purchase.

Responses

200
get/jobIDType
/jobIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

keyboardType definition

Request Body schema: application/json

details for keyboardType

string (keyboardType) <= 40 characters

Type of keyboard involved in the transaction.

Responses

200
get/keyboardType
/keyboardType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

languageENUMType definition

Request Body schema: application/json

details for languageENUMType

string (languageENUMType) <= 8 characters
Enum: "abk" "ace" "ach" "ada" "aar" "afh" "afr" "afa" "aka" "akk" "alb/sqi" "ale" "alg" "tut" "amh" "apa" "ara" "arc" "arp" "arn" "arw" "arm/hye" "art" "asm" "ath" "map" "ava" "ave" "awa" "aym" "aze" "nah" "ban" "bat" "bal" "bam" "bai" "bad" "bnt" "bas" "bak" "baq/eus" "bej" "bem" "ben" "ber" "bho" "bih" "bik" "bin" "bis" "bra" "bre" "bug" "bul" "bua" "bur/mya" "bel" "cad" "car" "cat" "cau" "ceb" "cel" "cai" "chg" "cha" "che" "chr" "chy" "chb" "chi/zho" "chn" "cho" "chu" "chv" "cop" "cor" "cos" "cre" "mus" "crp" "cpe" "cpf" "cpp" "cus" "ces/cze" "dak" "dan" "del" "din" "div" "doi" "dra" "dua" "dut/nla" "dum" "dyu" "dzo" "efi" "egy" "eka" "elx" "eng" "enm" "ang" "esk" "epo" "est" "ewe" "ewo" "fan" "fat" "fao" "fij" "fin" "fiu" "fon" "fra/f" "frm" "fro" "fry" "ful" "gaa" "gae/gdh" "glg" "lug" "gay" "gez" "geo/kat" "deu/ger" "gmh" "goh" "gem" "gil" "gon" "got" "grb" "grc" "ell/gre" "kal" "grn" "guj" "hai" "hau" "haw" "heb" "her" "hil" "him" "hin" "hmo" "hun" "hup" "iba" "ice/isl" "ibo" "ijo" "ilo" "inc" "ine" "ind" "ina" "iku" "ipk" "ira" "gai/iri" "sga" "mga" "iro" "ita" "jpn" "jav/jaw" "jrb" "jpr" "kab" "kac" "kam" "kan" "kau" "kaa" "kar" "kas" "kaw" "kaz" "kha" "khm" "khi" "kho" "kik" "kin" "kir" "kom" "kon" "kok" "kor" "kpe" "kro" "kua" "kum" "kur" "kru" "kus" "kut" "lad" "lah" "lam" "oci" "lao" "lat" "lav" "ltz" "lez" "lin" "lit" "loz" "lub" "lui" "lun" "luo" "mac/mak" "mad" "mag" "mai" "mak" "mlg" "may/msa" "mal" "mlt" "man" "mni" "mno" "max" "mao/mri" "mar" "chm" "mah" "mwr" "mas" "myn" "men" "mic" "min" "mis" "moh" "mol" "mkh" "lol" "mon" "mos" "mul" "mun" "nau" "nav" "nde" "nbl" "ndo" "nep" "new" "nic" "ssa" "niu" "non" "nai" "nor" "nno" "nub" "nym" "nya" "nyn" "nyo" "nzi" "oji" "ori" "orm" "osa" "oss" "oto" "pal" "pau" "pli" "pam" "pag" "pan" "pap" "paa" "fas/per" "peo" "phn" "pol" "pon" "por" "pra" "pro" "pus" "que" "roh" "raj" "rar" "roa" "ron/rum" "rom" "run" "rus" "sal" "sam" "smi" "smo" "sad" "sag" "san" "srd" "sco" "sel" "sem" "scr" "srr" "shn" "sna" "sid" "bla" "snd" "sin" "sit" "sio" "sla" "ssw" "slk/slo" "slv" "sog" "som" "son" "wen" "nso" "sot" "sai" "esl/spa" "suk" "sux" "sun" "sus" "swa" "sve/swe" "syr" "tgl" "tah" "tgk" "tmh" "tam" "tat" "tel" "ter" "tha" "bod/tib" "tig" "tir" "tem" "tiv" "tli" "tog" "ton" "tru" "tsi" "tso" "tsn" "tum" "tur" "ota" "tuk" "tyv" "twi" "uga" "uig" "ukr" "umb" "und" "urd" "uzb" "vai" "ven" "vie" "vol" "vot" "wak" "wal" "war" "was" "cym/wel" "wol" "xho" "sah" "yao" "yap" "yid" "yor" "zap" "zen" "zha" "zul" "zun"

The following SGML-encoded summary of the language codes of ISO 639 was prepared by Harry Gaylord. The two-letter codes are from the present ISO 639 standard. The three letter-codes are the current proposals in ISO CD 639/2 Draft dated 10/15/92 of the working group revising 639 for TC 3 and TC 46 of ISO and may be revised, amended, or changed before the new ISO standard is issued.

Responses

200
get/languageENUMType
/languageENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"abk"

latePunchType definition

Request Body schema: application/json

details for latePunchType

string (latePunchType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

How late is the employee allowed to punch. Duration expression should be limited to hours, minutes, and seconds, i.e. PxHyMzS, where x = hours, y = minutes, and z = seconds.

Responses

200
get/latePunchType
/latePunchType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

lengthUNUOMENUMType definition

Request Body schema: application/json

details for lengthUNUOMENUMType

string (lengthUNUOMENUMType) <= 3 characters
Enum: "MMT" "CMT" "MTR" "KMT" "INH" "FOT" "YRD" "SMI"

uom designation for lengths (widths, depths, etc.).

Responses

200
get/lengthUNUOMENUMType
/lengthUNUOMENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"MMT"

levelType definition

Request Body schema: application/json

details for levelType

integer (levelType) [ 0 .. 99999999 ]

level value as used for level readings by tank level gauges. Level is an unsigned integer from "0" to "99999999"

Responses

200
get/levelType
/levelType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

licenseNumberType definition

Request Body schema: application/json

details for licenseNumberType

string (licenseNumberType) <= 16 characters

The license number of the vehicle that drove off.

Responses

200
get/licenseNumberType
/licenseNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

licensePlateIDType definition

Request Body schema: application/json

details for licensePlateIDType

string (licensePlateIDType) <= 16 characters

The license plate number of the vehicle recorded in a DriveOff event.

Responses

200
get/licensePlateIDType
/licensePlateIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

lineSequenceNumberType definition

Request Body schema: application/json

details for lineSequenceNumberType

integer (lineSequenceNumberType) [ 0 .. 10000000000000000 ]

A unique sequence number for the subItemLine within the ItemLine it is attached to.

Responses

200
get/lineSequenceNumberType
/lineSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

linkCodeEENUMType definition

Request Body schema: application/json

details for linkCodeEENUMType

Any of
  • string
  • posCodeFormatEENUMType
string <= 16 characters
Enum: "item" "itemList"

Specific additions to posCodeFormat required for linkCode, OR the type of coding scheme used in POSCode.

Responses

200
get/linkCodeEENUMType
/linkCodeEENUMType

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
"item"

linkedItemListIDType definition

Request Body schema: application/json

details for linkedItemListIDType

string (linkedItemListIDType) [ 1 .. 40 ] characters

A pointer to the Item List look-up table. A 'null' or 'no value' for ItemListIDType may be allowed.

Responses

200
get/linkedItemListIDType
/linkedItemListIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

loanTypeENUMType definition

Request Body schema: application/json

details for loanTypeENUMType

string (loanTypeENUMType) <= 4 characters
Enum: "in" "out"

An identifer for the type of DrawerLoan event that was performed.

Responses

200
get/loanTypeENUMType
/loanTypeENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"in"

loyaltyProgramNameType definition

Request Body schema: application/json

details for loyaltyProgramNameType

string (loyaltyProgramNameType) <= 40 characters

The name of the loyalty program to which the reduction is attributed.

Responses

200
get/loyaltyProgramNameType
/loyaltyProgramNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

loyaltyTransactionIDType definition

Request Body schema: application/json

details for loyaltyTransactionIDType

string (loyaltyTransactionIDType) [ 1 .. 40 ] characters

The ID of the loyalty program to which the reduction is attributed.

Responses

200
get/loyaltyTransactionIDType
/loyaltyTransactionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

managerIDType definition

Request Body schema: application/json

details for managerIDType

string (managerIDType) [ 1 .. 8 ] characters

Identifier for a manager, unique to a given site.

Responses

200
get/managerIDType
/managerIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

manualActionIDType definition

Request Body schema: application/json

details for manualActionIDType

string (manualActionIDType) [ 1 .. 40 ] characters

The identification of the action used to trigger the promotion.

Responses

200
get/manualActionIDType
/manualActionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

manufacturerIDType definition

Request Body schema: application/json

details for manufacturerIDType

string (manufacturerIDType) [ 1 .. 8 ] characters

An identifier for the manufacturer that issued the coupon.

Responses

200
get/manufacturerIDType
/manufacturerIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

massUNUOMENUMType definition

Request Body schema: application/json

details for massUNUOMENUMType

string (massUNUOMENUMType) <= 3 characters
Enum: "GRM" "KGM" "ONZ" "LBR"

Unit of measure indicating weight (mass).

Responses

200
get/massUNUOMENUMType
/massUNUOMENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"GRM"

memoDetailType definition

Request Body schema: application/json

details for memoDetailType

string (memoDetailType) <= 40 characters

A descriptive piece of text that is placed into the journal as a Memo event.

Responses

200
get/memoDetailType
/memoDetailType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

merchandiseCodeDescriptionType definition

Request Body schema: application/json

details for merchandiseCodeDescriptionType

string (merchandiseCodeDescriptionType) <= 40 characters

Native language description of the merchandise code normally printed on the register tape.

Responses

200
get/merchandiseCodeDescriptionType
/merchandiseCodeDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

merchandiseCodeType definition

Request Body schema: application/json

details for merchandiseCodeType

string (merchandiseCodeType) <= 40 characters ^([0-9]{1,16}(\.[0-9]{1,16}){0,6})$

Enhanced MerchandiseCode type to support hierarchical MerchandiseCodes.

Responses

200
get/merchandiseCodeType
/merchandiseCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

meterENUMType definition

Request Body schema: application/json

details for meterENUMType

string (meterENUMType) <= 16 characters
Enum: "mechanical" "electronic"

Indicates whether the meter is mechanical or electronic.

Responses

200
get/meterENUMType
/meterENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"mechanical"

mimeTypeType definition

Request Body schema: application/json

details for mimeTypeType

string (mimeTypeType) [ 1 .. 40 ] characters

MIME type for binary data.

Responses

200
get/mimeTypeType
/mimeTypeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

miscellaneousSummaryCodeEENUMType definition

Request Body schema: application/json

details for miscellaneousSummaryCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "safeDrop" "safeLoan" "refunds" "payouts" "payins" "totalizers" "statistics" "discount" "summaryTotals" "sales" "openingBalance" "closingBalance" "balanceOnHand" "balanceForward" "tillLoanIn" "tillLoanOut" "taxTable" "fuelSalesByGrade" "methodOfPaymentTotals" "creditNetworkTotals" "hourlyTotals" "creditBatchTotals"

MiscellaneousSummaryCodes defined by Conexxus (base type).

Responses

200
get/miscellaneousSummaryCodeEENUMType
/miscellaneousSummaryCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

miscellaneousSummarySubCodeEENUMType definition

Request Body schema: application/json

details for miscellaneousSummarySubCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "total" "envelope" "generalLedger" "houseAccount" "lotteryScratch" "lottoOnline" "vendorPay" "utilityPayment" "glAccount" "returnedCheckFee" "beginningGrand" "beginningSales" "endingGrand" "endingSales" "moneyOrderBegin" "moneyOrderEnd" "carWashBegin" "carWashEnd" "correction" "discounts" "itemsSold" "noSales" "suspends" "suspendsVoids" "transactions" "voidTransactions" "postVoids" "taxCodeChanges" "driveoffs" "foodstampWicStatusChanges" "changeOnChecks" "refunds" "misc" "promotional" "amountFixed" "amountPercentage" "mixMatchAllItems" "mixMatchOneOrMore" "fuel" "coupon" "seniorCitizen" "employee" "police" "allSales" "nonTaxableSales" "nonTaxableSalesRefunded" "storeCoupons" "washPackage" "cardReaderCashAcceptor" "nonFuelVoidItems" "sales" "taxes" "overShort" "batchID"

MiscellaneousSummarySubCodes defined by Conexxus (base type).

Responses

200
get/miscellaneousSummarySubCodeEENUMType
/miscellaneousSummarySubCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

mixMatchCodeType definition

Request Body schema: application/json

details for mixMatchCodeType

string (mixMatchCodeType) [ 1 .. 8 ] characters

A code identifying the MixMatch.

Responses

200
get/mixMatchCodeType
/mixMatchCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

modeNoType definition

Request Body schema: application/json

details for modeNoType

integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

Responses

200
get/modeNoType
/modeNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

moneyOrderNumberType definition

Request Body schema: application/json

details for moneyOrderNumberType

string (moneyOrderNumberType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

The sequential number issued by the money order company to the individual money order being sold.

Responses

200
get/moneyOrderNumberType
/moneyOrderNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

moneyOrderTypeIndicatorType definition

Request Body schema: application/json

details for moneyOrderTypeIndicatorType

string (moneyOrderTypeIndicatorType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

An indicator as to the type of money order, I.e., vendor payment, payroll, customer, etc.

Responses

200
get/moneyOrderTypeIndicatorType
/moneyOrderTypeIndicatorType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

networkIDType definition

Request Body schema: application/json

details for networkIDType

string (networkIDType) [ 1 .. 16 ] characters

An identifier for the batch on the network.

Responses

200
get/networkIDType
/networkIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

networkProductCodeType definition

Request Body schema: application/json

details for networkProductCodeType

string (networkProductCodeType) [ 1 .. 4 ] characters

A code reported to the credit card processing host, to indicate types of products being sold in the transaction. Provided for use of non-Conexxus codes if needed.

Responses

200
get/networkProductCodeType
/networkProductCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

newSecurityIDType definition

Request Body schema: application/json

details for newSecurityIDType

string (newSecurityIDType) [ 1 .. 16 ] characters

A code denoting the new security that was in place after the security bypass event was performed.

Responses

200
get/newSecurityIDType
/newSecurityIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

newValueType definition

Request Body schema: application/json

details for newValueType

string (newValueType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

For use in NAXML-POSJournal (mainly) in MaintenanceAuditEvent to declare a new (audited) value

Responses

200
get/newValueType
/newValueType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

nozzleNoType definition

Request Body schema: application/json

details for nozzleNoType

integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

Responses

200
get/nozzleNoType
/nozzleNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

odometerReadingType definition

Request Body schema: application/json

details for odometerReadingType

integer (odometerReadingType) [ 0 .. 10000000000000000 ]

The odometer reading of the vehicle being filled.

Responses

200
get/odometerReadingType
/odometerReadingType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

offerCodeType definition

Request Body schema: application/json

details for offerCodeType

integer (offerCodeType) [ 0 .. 10000000000000000 ]

Offer code for a coupon, should be a GS1 'GCN' - 13 digits.

Responses

200
get/offerCodeType
/offerCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

oldSecurityLevelType definition

Request Body schema: application/json

details for oldSecurityLevelType

string (oldSecurityLevelType) [ 1 .. 16 ] characters

A code denoting the security level that was in place before the security bypass event was performed.

Responses

200
get/oldSecurityLevelType
/oldSecurityLevelType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

oldValueType definition

Request Body schema: application/json

details for oldValueType

string (oldValueType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

For use in NAXML-POSJournal (mainly) in MaintenanceAuditEvent to declare an old (unaudited) value.

Responses

200
get/oldValueType
/oldValueType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

originalTransactionENUMType definition

Request Body schema: application/json

details for originalTransactionENUMType

string (originalTransactionENUMType) <= 16 characters
Enum: "sale" "refund"

Identifies whether a transaction was a sale or refund for reference.

Responses

200
get/originalTransactionENUMType
/originalTransactionENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"sale"

outdoorPaymentTerminalStateEENUMType definition

Request Body schema: application/json

details for outdoorPaymentTerminalStateEENUMType

Any of
  • string
  • string
string <= 25 characters ^[A-Z_]{5,25}
Enum: "CONFIGURE" "DISABLED" "ERRORSTATE" "INVALIDSTATE" "OFFLINE" "OUTOFORDER" "READY" "REQUESTED" "STARTED" "SUSPENDED_STARTED" "CALLING" "CLOSED"

outdoor payment terminal state is a string of characters used to identify the state of an outdoor payment terminal

Responses

200
get/outdoorPaymentTerminalStateEENUMType
/outdoorPaymentTerminalStateEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

overridingCashierIDType definition

Request Body schema: application/json

details for overridingCashierIDType

string (overridingCashierIDType) [ 1 .. 40 ] characters

A unique identifier for the cashier or manager that performed the security override event.

Responses

200
get/overridingCashierIDType
/overridingCashierIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

partDescriptionType definition

Request Body schema: application/json

details for partDescriptionType

string (partDescriptionType) <= 40 characters

A long and complex description for a vehicle part number that is being sold.

Responses

200
get/partDescriptionType
/partDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

passwordType definition

Request Body schema: application/json

details for passwordType

string (passwordType) <= 40 characters

Security password

Responses

200
get/passwordType
/passwordType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

payInReasonType definition

Request Body schema: application/json

details for payInReasonType

string (payInReasonType) [ 1 .. 16 ] characters

Pay in reason value defined by Conexxus (base type)

Responses

200
get/payInReasonType
/payInReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

payOutReasonType definition

Request Body schema: application/json

details for payOutReasonType

string (payOutReasonType) [ 1 .. 16 ] characters

Pay out reason value defined by Conexxus (base type)

Responses

200
get/payOutReasonType
/payOutReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

paymentMethodEENUMType definition

Request Body schema: application/json

details for paymentMethodEENUMType

Any of
  • string
  • string
string <= 16 characters ^[A-Za-z]{2,16}
Enum: "debit" "credit" "prePaid" "activation" "recharge" "NA" "loyalty" "EBT" "cash" "cheque" "other" "cashChange" "EBT_FS"

payment method is an string with a list of possible enum values; this list is same as IFSF_BasicTypesCards from EPS

Responses

200
get/paymentMethodEENUMType
/paymentMethodEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

paymentSystemsProductCodeType definition

Request Body schema: application/json

details for paymentSystemsProductCodeType

string (paymentSystemsProductCodeType) [ 2 .. 5 ] characters ^[0-9]{2,5}$

Conexxus Payment System Product Codes and/or the underlying standard (X9.104) for which Conexxus is the Registration Authority, published by ACS X9, Inc.

Responses

200
get/paymentSystemsProductCodeType
/paymentSystemsProductCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"strin"

percentageType definition

Request Body schema: application/json

details for percentageType

number (percentageType) <= 999999

3,3 decimal valid percentage, may range over 100 (i.e. 300% increase, etc.)

Responses

200
get/percentageType
/percentageType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

phoneLineTypeEENUMType definition

Request Body schema: application/json

details for phoneLineTypeEENUMType

Any of
  • string
  • string
string
Enum: "mobile" "work" "home" "main" "fax" "pager" "other"

The type of phone line (extendable).

Responses

200
get/phoneLineTypeEENUMType
/phoneLineTypeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

phoneNumberStringType definition

Request Body schema: application/json

details for phoneNumberStringType

string (phoneNumberStringType) <= 14 characters ^[0-9\-\(\)\B]{,14}$

String roughly constrained to handle phone numbers and common delimiting characters.

Responses

200
get/phoneNumberStringType
/phoneNumberStringType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

posCodeFormatEENUMType definition

Request Body schema: application/json

details for posCodeFormatEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "upcA" "upcE" "ean8" "ean13" "plu" "gtin" "rss14" "none"

Responses

200
get/posCodeFormatEENUMType
/posCodeFormatEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

posCodeType definition

Request Body schema: application/json

details for posCodeType

string (posCodeType) <= 24 characters ^[0-9]{1,24}$

Responses

200
get/posCodeType
/posCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

postalCodeType definition

Request Body schema: application/json

details for postalCodeType

string (postalCodeType) <= 16 characters

The postal code in the address (zip code in the US).

Responses

200
get/postalCodeType
/postalCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

preAuthorizationType definition

Request Body schema: application/json

details for preAuthorizationType

integer (preAuthorizationType) [ 0 .. 9999 ]

Indicates pre-authorization was obtained

Responses

200
get/preAuthorizationType
/preAuthorizationType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

preparationModType definition

Request Body schema: application/json

details for preparationModType

string (preparationModType) <= 40 characters

Description of a preparation modification that must occur when the item is sold as a component within another item

Responses

200
get/preparationModType
/preparationModType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

priceOverrideApproverIDType definition

Request Body schema: application/json

details for priceOverrideApproverIDType

string (priceOverrideApproverIDType) [ 1 .. 40 ] characters

Identifies the individual athorizing the price overrider.

Responses

200
get/priceOverrideApproverIDType
/priceOverrideApproverIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

priceOverrideReasonEENUMType definition

Request Body schema: application/json

details for priceOverrideReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "emp" "exp" "fcw" "frs" "fsh" "gow" "mgr" "pol" "rpc" "scd" "tpc" "moneyOrderAdjust" "prepaidCardsLoad" "competPriceMatch" "fuelsDiscCarWash" "freeCarWashOffer" "damagedNonReturn" "close2ExpiryDate" "reducedQuickSale" "managersGoodwill" "managerPromotion" "shelfMismatchPOS"

A reason code indicating why the item/merchandise code/fuel grade was sold at a price different from the RegularSellPrice. Values - ( EMP | EXP | FCW | FRS | FSH | GOW | MGR | POL | RPC | SCD | TPC ) defined by Conexxus (base type).

Responses

200
get/priceOverrideReasonEENUMType
/priceOverrideReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

pricePoleStateEENUMType definition

Request Body schema: application/json

details for pricePoleStateEENUMType

Any of
  • string
  • string
string <= 25 characters ^[A-Z_]{5,25}
Enum: "CONFIGURE" "DISABLED" "ERRORSTATE" "INVALIDSTATE" "OFFLINE" "OUTOFORDER" "READY" "CLOSED"

price pole state is a string of characters used to identify the state of a price pole

Responses

200
get/pricePoleStateEENUMType
/pricePoleStateEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

priceTierCodeType definition

Request Body schema: application/json

details for priceTierCodeType

string (priceTierCodeType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

A pointer to the Price Tier Table. The values indicate the type of pricing level by which the customer purchased or may purchase the fuel grade. This is typically used for cash/credit pricing.

Responses

200
get/priceTierCodeType
/priceTierCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

priceTierEENUMType definition

Request Body schema: application/json

details for priceTierEENUMType

Any of
  • string
  • string
string <= 1 characters ^[a-z]{4,15}
Enum: "cash" "credit" "debit" "storedValue" "fleet" "proprietary" "loyalty"

price tier is a string of characters used to identify the payment method

Responses

200
get/priceTierEENUMType
/priceTierEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"s"

primaryCompanyPrefixType definition

Request Body schema: application/json

details for primaryCompanyPrefixType

string (primaryCompanyPrefixType) <= 40 characters

Prefix for identifying Coupons, variable portion (6-12 digits) of the GS1 'GLN' - 13 digits including check digit.

Responses

200
get/primaryCompanyPrefixType
/primaryCompanyPrefixType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

primaryLabelIDType definition

Request Body schema: application/json

details for primaryLabelIDType

string (primaryLabelIDType) [ 1 .. 16 ] characters ^[0-9]{1,16}$

The primary label from a coupon.

Responses

200
get/primaryLabelIDType
/primaryLabelIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

priorityEENUMType definition

Request Body schema: application/json

details for priorityEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "lowest" "low" "medium" "high" "highest"

The priority of an alert event that has been raised.

Responses

200
get/priorityEENUMType
/priorityEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

productCategoryType definition

Request Body schema: application/json

details for productCategoryType

integer (productCategoryType) [ 0 .. 99999999 ]

the product category value determine how the POS treats the data coming from the dispenser

Responses

200
get/productCategoryType
/productCategoryType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

productCodeType definition

Request Body schema: application/json

details for productCodeType

integer (productCodeType) [ 0 .. 99999999 ]

product code provides a classification of the fuel product

Responses

200
get/productCodeType
/productCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

productNameType definition

Request Body schema: application/json

details for productNameType

string (productNameType) <= 16 characters

fuel product name is the unique identification of fuel sold at Service stations and C-Stores

Responses

200
get/productNameType
/productNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

productNoType definition

Request Body schema: application/json

details for productNoType

integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

Responses

200
get/productNoType
/productNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

promotionCodeType definition

Request Body schema: application/json

details for promotionCodeType

string (promotionCodeType) [ 1 .. 8 ] characters

The kind of promotion the coupon is part of.

Responses

200
get/promotionCodeType
/promotionCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

promotionIDType definition

Request Body schema: application/json

details for promotionIDType

string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

Responses

200
get/promotionIDType
/promotionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

promotionReasonEENUMType definition

Request Body schema: application/json

details for promotionReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "combinationOffer" "fuelsDiscCarWash" "mixAndMatchOffer" "tempPriceChange"

A reason code indicating why the item/merchandise was promo'ed defined by Conexxus (base type).

Responses

200
get/promotionReasonEENUMType
/promotionReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

providerIDType definition

Request Body schema: application/json

details for providerIDType

string (providerIDType) [ 1 .. 40 ] characters

Identifies the authorizing agency, bank or clearinghouse.

Responses

200
get/providerIDType
/providerIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

provinceCAENUMType definition

Request Body schema: application/json

details for provinceCAENUMType

string (provinceCAENUMType) <= 3 characters
Enum: "AB" "BC" "MB" "NB" "NL" "NS" "ON" "PE" "QC" "SK" "NT" "NU" "YT"

Responses

200
get/provinceCAENUMType
/provinceCAENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"AB"

pumpNoType definition

Request Body schema: application/json

details for pumpNoType

integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

Responses

200
get/pumpNoType
/pumpNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

pumpTestReasonType definition

Request Body schema: application/json

details for pumpTestReasonType

string (pumpTestReasonType) [ 1 .. 16 ] characters

A reason code for the pump test defined by Conexxus (base type).

Responses

200
get/pumpTestReasonType
/pumpTestReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

pumpTesterIDType definition

Request Body schema: application/json

details for pumpTesterIDType

string (pumpTesterIDType) [ 1 .. 40 ] characters

A unique identifer for the person (or organization) that conducted the pump test.

Responses

200
get/pumpTesterIDType
/pumpTesterIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

punchEENUMType definition

Request Body schema: application/json

details for punchEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "register" "clock" "manual"

Source of punch in/out entry.

Responses

200
get/punchEENUMType
/punchEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

punchModReasonType definition

Request Body schema: application/json

details for punchModReasonType

string (punchModReasonType) [ 1 .. 16 ] characters

Punch modification reason value defined by Conexxus (base type).

Responses

200
get/punchModReasonType
/punchModReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

punchReasonEENUMType definition

Request Body schema: application/json

details for punchReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "clockIn" "clockOut" "startMeal" "endMeal" "startBreak" "endBreak"

Punch reason value defined by Conexxus (base type).

Responses

200
get/punchReasonEENUMType
/punchReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

quantityUNUOMEENUMType definition

Request Body schema: application/json

details for quantityUNUOMEENUMType

Any of
  • massUNUOMENUMType
  • volumeUNUOMENUMType
  • lengthUNUOMENUMType
  • string
  • string
string (massUNUOMENUMType) <= 3 characters
Enum: "GRM" "KGM" "ONZ" "LBR"

Unit of measure indicating weight (mass).

Responses

200
get/quantityUNUOMEENUMType
/quantityUNUOMEENUMType

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
"GRM"

readingTypeEENUMType definition

Request Body schema: application/json

details for readingTypeEENUMType

Any of
  • string
  • string
string <= 15 characters ^[A-Z][A-Za-z]{2,14}
Enum: "Auto" "Book" "Calculated" "Default" "Dip" "Error" "Manual" "MonthEndBook" "Order" "Pump" "Sales" "Ticket" "TruckMeter"

reading type is an string of characters used to indicate how the reading of a tank was obtained

Responses

200
get/readingTypeEENUMType
/readingTypeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

reasonCodeEENUMType definition

Request Body schema: application/json

details for reasonCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "batchClose" "cbm" "discount" "driveOff" "fgm" "fuelGradeTest" "ism" "payIn" "payOut" "punch" "punchMod" "promotion" "pumpTest" "refund" "reprice" "safeLoan" "taxExempt" "taxForgiven" "transactionLink" "void"

Identifier for the type of reason code; this enumeration is not extendable

Responses

200
get/reasonCodeEENUMType
/reasonCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

redeemedCouponIDType definition

Request Body schema: application/json

details for redeemedCouponIDType

string (redeemedCouponIDType) [ 1 .. 80 ] characters

The identification of the redeemed coupon.

Responses

200
get/redeemedCouponIDType
/redeemedCouponIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

redeemedPointsTypeIDType definition

Request Body schema: application/json

details for redeemedPointsTypeIDType

string (redeemedPointsTypeIDType) [ 1 .. 40 ] characters

The identification of the type of points redeemed.

Responses

200
get/redeemedPointsTypeIDType
/redeemedPointsTypeIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

refundReasonEENUMType definition

Request Body schema: application/json

details for refundReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "damaged" "spoiled"

A reason code indicating why the item/merchandise was refunded defined by Conexxus (base type).

Responses

200
get/refundReasonEENUMType
/refundReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

registerIDType definition

Request Body schema: application/json

details for registerIDType

string (registerIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

The identification of the register that finalized the sales being reported. This is typically the register number.

Responses

200
get/registerIDType
/registerIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

reportPeriodType definition

Request Body schema: application/json

details for reportPeriodType

Any of
  • dateType
  • dateTimeType
  • string
string <date> (dateType) <= 10 characters

ISO 8601 Date Type to align with XML Schema.

Responses

200
get/reportPeriodType
/reportPeriodType

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
"2020-06-23"

reportRangeENUMType definition

Request Body schema: application/json

details for reportRangeENUMType

string (reportRangeENUMType) <= 16 characters
Enum: "cumulative" "incremental" "closed"

Range of the values represented in the report.

Responses

200
get/reportRangeENUMType
/reportRangeENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"cumulative"

reportSequenceNumberType definition

Request Body schema: application/json

details for reportSequenceNumberType

integer (reportSequenceNumberType) [ 0 .. 99999999 ]

A unique sequential report control number

Responses

200
get/reportSequenceNumberType
/reportSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

repriceReasonCodeEENUMType definition

Request Body schema: application/json

details for repriceReasonCodeEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "emp" "exp" "fcw" "frs" "fsh" "gow" "mgr" "pol" "rpc" "scd" "tpc" "moneyOrderAdjust" "prepaidCardsLoad" "competPriceMatch" "fuelsDiscCarWash" "freeCarWashOffer" "damagedNonReturn" "close2ExpiryDate" "reducedQuickSale" "managersGoodwill" "managerPromotion" "shelfMismatchPOS"

(remove?)

Responses

200
get/repriceReasonCodeEENUMType
/repriceReasonCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

repriceReasonEENUMType definition

Request Body schema: application/json

details for repriceReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "emp" "exp" "fcw" "frs" "fsh" "gow" "mgr" "pol" "rpc" "scd" "tpc" "moneyOrderAdjust" "prepaidCardsLoad" "competPriceMatch" "fuelsDiscCarWash" "freeCarWashOffer" "damagedNonReturn" "close2ExpiryDate" "reducedQuickSale" "managersGoodwill" "managerPromotion" "shelfMismatchPOS"

(remove?)

Responses

200
get/repriceReasonEENUMType
/repriceReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

revenueCenterIDType definition

Request Body schema: application/json

details for revenueCenterIDType

string (revenueCenterIDType) [ 1 .. 40 ] characters

The identification of the revenue or profit center within the store.

Responses

200
get/revenueCenterIDType
/revenueCenterIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

safeLoanReasonType definition

Request Body schema: application/json

details for safeLoanReasonType

string (safeLoanReasonType) [ 1 .. 16 ] characters

Safe loan reasons defined by Conexxus (base type).

Responses

200
get/safeLoanReasonType
/safeLoanReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

salesRestrictCodeEENUMType definition

Request Body schema: application/json

details for salesRestrictCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "allowWIC" "controlledSubstance" "forceWeight" "forceQuantity" "prohibitFoodStamp" "prohibitPriceLookup" "prohibitPriceOverride" "prohibitTaxModification" "allowFractionalQuantity" "prohibitRefund" "prohibitReturn" "prohibitAllDiscounts" "requirePermit" "prohibitEBT" "allowQuantity" "forcePriceEntry" "other"

A pointer to a value in the SalesRestrict table. The values indicate the restrictions that apply to the item/merchandise code. defined by Conexxus (base type).

Responses

200
get/salesRestrictCodeEENUMType
/salesRestrictCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

securityLevelType definition

Request Body schema: application/json

details for securityLevelType

integer (securityLevelType) [ 0 .. 9999 ]

Four digit security level designation.

Responses

200
get/securityLevelType
/securityLevelType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

segmentNoType definition

Request Body schema: application/json

details for segmentNoType

integer (segmentNoType) [ 0 .. 9999 ]

segment No is the unique identification of a segment within a price pole

Responses

200
get/segmentNoType
/segmentNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

serialNumberType definition

Request Body schema: application/json

details for serialNumberType

string (serialNumberType) <= 40 characters

The serial number

Responses

200
get/serialNumberType
/serialNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

serviceLevelCodeEENUMType definition

Request Body schema: application/json

details for serviceLevelCodeEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "full" "self" "mini"

Fuel selling service levels defined by Conexxus (base type).

Responses

200
get/serviceLevelCodeEENUMType
/serviceLevelCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

severityEENUMType definition

Request Body schema: application/json

details for severityEENUMType

Any of
  • string
  • string
string <= 15 characters ^[a-z]{3,15}
Enum: "emerg" "alert" "err" "warning" "notice" "info" "debug"

severity is the standard for message logging criticality levels

Responses

200
get/severityEENUMType
/severityEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

severityIndicatorType definition

Request Body schema: application/json

details for severityIndicatorType

string (severityIndicatorType) [ 1 .. 16 ] characters

The severity of an alert event that has been raised.

Responses

200
get/severityIndicatorType
/severityIndicatorType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

shiftIDType definition

Request Body schema: application/json

details for shiftIDType

string (shiftIDType) [ 1 .. 4 ] characters

For use in task scheduling, along with TaskID, description, begin time, etc.

Responses

200
get/shiftIDType
/shiftIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

siteIDType definition

Request Body schema: application/json

details for siteIDType

string (siteIDType) [ 1 .. 40 ] characters

An alphanumeric value by which the site is identified, assumed to be unique across an organization.

Responses

200
get/siteIDType
/siteIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

socialSecurityNumberType definition

Request Body schema: application/json

details for socialSecurityNumberType

integer (socialSecurityNumberType) [ 0 .. 999999999 ]

The social security number. Use of this type is not recommended.

Responses

200
get/socialSecurityNumberType
/socialSecurityNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

stanType definition

Request Body schema: application/json

details for stanType

string (stanType) <= 40 characters

System Trace Audit Number (STAN) is a unique identifier generated by the FEP when a transaction is processed. It is unique to the FEP.

Responses

200
get/stanType
/stanType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

stateOrProvinceENUMType definition

Request Body schema: application/json

details for stateOrProvinceENUMType

Any of
  • provinceCAENUMType
  • stateUSENUMType
string (provinceCAENUMType) <= 3 characters
Enum: "AB" "BC" "MB" "NB" "NL" "NS" "ON" "PE" "QC" "SK" "NT" "NU" "YT"

Responses

200
get/stateOrProvinceENUMType
/stateOrProvinceENUMType

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
"AB"

stateUSENUMType definition

Request Body schema: application/json

details for stateUSENUMType

string (stateUSENUMType) <= 3 characters
Enum: "AL" "AR" "AK" "AZ" "CA" "CO" "CT" "DE" "FL" "GA" "HI" "IA" "ID" "IL" "IN" "KS" "KY" "LA" "MA" "MD" "ME" "MI" "MN" "MO" "MS" "MT" "NC" "ND" "NE" "NH" "NJ" "NM" "NV" "NY" "OH" "OK" "OR" "PA" "RI" "SC" "SD" "TN" "TX" "UT" "VA" "VT" "WA" "WI" "WV" "WY"

States of the US.

Responses

200
get/stateUSENUMType
/stateUSENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"AL"

storeConceptIDType definition

Request Body schema: application/json

details for storeConceptIDType

string (storeConceptIDType) [ 1 .. 40 ] characters

The identification of the concept within the RevenueCenterID, I.e. Subway within a QSR RevenueCenterID.

Responses

200
get/storeConceptIDType
/storeConceptIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

storeHierarchyIDType definition

Request Body schema: application/json

details for storeHierarchyIDType

string (storeHierarchyIDType) [ 1 .. 40 ] characters

The lowest level of the store structure where the item was sold from

Responses

200
get/storeHierarchyIDType
/storeHierarchyIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

storeLocationIDType definition

Request Body schema: application/json

details for storeLocationIDType

string (storeLocationIDType) [ 1 .. 40 ] characters

The store/location/site identifier assigned by the company to this physical location. It is typically the store number.

Responses

200
get/storeLocationIDType
/storeLocationIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

systemOfMeasurementENUMType definition

Request Body schema: application/json

details for systemOfMeasurementENUMType

string (systemOfMeasurementENUMType) <= 8 characters ^[a-z]{6,8}
Enum: "metric" "imperial" "american"

enum values excerpted from IFSF TG Standard

Responses

200
get/systemOfMeasurementENUMType
/systemOfMeasurementENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"metric"

tableNameType definition

Request Body schema: application/json

details for tableNameType

string (tableNameType) <= 40 characters

For audit events, what table/field changed?

Responses

200
get/tableNameType
/tableNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankChartIDType definition

Request Body schema: application/json

details for tankChartIDType

string (tankChartIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

A pointer to a tank capacity chart not defined in this document.

Responses

200
get/tankChartIDType
/tankChartIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

tankGroupNoType definition

Request Body schema: application/json

details for tankGroupNoType

integer (tankGroupNoType) [ 0 .. 9999 ]

tank group number is the unique identifier of the tank group on a retail store

Responses

200
get/tankGroupNoType
/tankGroupNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

tankGroupTypeENUMType definition

Request Body schema: application/json

details for tankGroupTypeENUMType

string (tankGroupTypeENUMType) <= 10 characters ^[A-Z][A-Za-z]{6,9}
Enum: "TankSyphon" "LineSyphon" "Unknown"

The tank group type

Responses

200
get/tankGroupTypeENUMType
/tankGroupTypeENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"TankSyphon"

tankIDType definition

Request Body schema: application/json

details for tankIDType

string (tankIDType) [ 1 .. 40 ] characters

The assigned identification for a fuel product tank.

Responses

200
get/tankIDType
/tankIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankLogicalStateENUMType definition

Request Body schema: application/json

details for tankLogicalStateENUMType

string (tankLogicalStateENUMType) <= 8 characters ^[a-z]{6,8}
Enum: "locked" "unlocked"

A LogicalState which can be locked or unlocked

Responses

200
get/tankLogicalStateENUMType
/tankLogicalStateENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"locked"

tankManifoldIDType definition

Request Body schema: application/json

details for tankManifoldIDType

string (tankManifoldIDType) [ 1 .. 40 ] characters

The identification of the fuel product tank manifold. Usage is implementation specific.

Responses

200
get/tankManifoldIDType
/tankManifoldIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankManufacturerType definition

Request Body schema: application/json

details for tankManufacturerType

string (tankManufacturerType) <= 40 characters

The name of the manufacturer of the fuel product tank.

Responses

200
get/tankManufacturerType
/tankManufacturerType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankModelNumberType definition

Request Body schema: application/json

details for tankModelNumberType

string (tankModelNumberType) <= 40 characters

The model number of the fuel product tank.

Responses

200
get/tankModelNumberType
/tankModelNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankNoType definition

Request Body schema: application/json

details for tankNoType

integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

Responses

200
get/tankNoType
/tankNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

tankProbeStateEENUMType definition

Request Body schema: application/json

details for tankProbeStateEENUMType

Any of
  • string
  • string
string <= 25 characters ^[A-Z_]{5,25}
Enum: "CONFIGURE" "DISABLED" "ERRORSTATE" "INVALIDSTATE" "OFFLINE" "OUTOFORDER" "READY" "CLOSED"

tankProbeState is a string of characters used to identify the state of a tank probe

Responses

200
get/tankProbeStateEENUMType
/tankProbeStateEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tankSerialNumberType definition

Request Body schema: application/json

details for tankSerialNumberType

string (tankSerialNumberType) <= 40 characters

A description of the serial number of the fuel product tank.

Responses

200
get/tankSerialNumberType
/tankSerialNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taskDurationType definition

Request Body schema: application/json

details for taskDurationType

string (taskDurationType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

Length of time allocated to a task. Duration expression should be limited to hours, minutes, and seconds, i.e. PxHyMzS, where x = hours, y = minutes, and z = seconds

Responses

200
get/taskDurationType
/taskDurationType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taskIDType definition

Request Body schema: application/json

details for taskIDType

string (taskIDType) [ 1 .. 4 ] characters

An ID for the task to which the timeclock event applies.

Responses

200
get/taskIDType
/taskIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

taxExemptCertificateIDType definition

Request Body schema: application/json

details for taxExemptCertificateIDType

string (taxExemptCertificateIDType) [ 1 .. 40 ] characters

The tax exempt number issued by the tax authority to the customer who is tax exempt.

Responses

200
get/taxExemptCertificateIDType
/taxExemptCertificateIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taxExemptReasonEENUMType definition

Request Body schema: application/json

details for taxExemptReasonEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "forResale" "forTaxExemptOrg" "other"

Tax exemption reasons defined by Conexxus (base type).

Responses

200
get/taxExemptReasonEENUMType
/taxExemptReasonEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taxForgivenReasonType definition

Request Body schema: application/json

details for taxForgivenReasonType

string (taxForgivenReasonType) [ 1 .. 16 ] characters

Tax forgiven (normally for payment with government benefits) reasons defined by Conexxus (base type).

Responses

200
get/taxForgivenReasonType
/taxForgivenReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taxLevelIDType definition

Request Body schema: application/json

details for taxLevelIDType

string (taxLevelIDType) [ 1 .. 4 ] characters

A pointer to the Tax Level Table or Rate. The values of the table specify the tax level being reported. It usually defines a tax rate or table.

Responses

200
get/taxLevelIDType
/taxLevelIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

taxPayerIDType definition

Request Body schema: application/json

details for taxPayerIDType

string (taxPayerIDType) [ 1 .. 40 ] characters

Identifier assigned to the payer by the tax authority.

Responses

200
get/taxPayerIDType
/taxPayerIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taxRateType definition

Request Body schema: application/json

details for taxRateType

number (taxRateType) <= 999999

Percentage applicable to the ActualSellPrice of an item unless breakpoint matrix is used.

Responses

200
get/taxRateType
/taxRateType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

taxReceiptDescriptionType definition

Request Body schema: application/json

details for taxReceiptDescriptionType

string (taxReceiptDescriptionType) <= 16 characters

Describes the tax authority in an abbreviated format.

Responses

200
get/taxReceiptDescriptionType
/taxReceiptDescriptionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

taxRegistrationNumberType definition

Request Body schema: application/json

details for taxRegistrationNumberType

integer (taxRegistrationNumberType) [ 0 .. 10000000000000000 ]

Number assigned by taxing authority that must appear on the register receipt or reports.

Responses

200
get/taxRegistrationNumberType
/taxRegistrationNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

taxSequenceNumberType definition

Request Body schema: application/json

details for taxSequenceNumberType

integer (taxSequenceNumberType) [ 0 .. 9999 ]

Identifies the sequence that the included TaxLevelId should be followed to calculate the TaxLevelIDs taxes.

Responses

200
get/taxSequenceNumberType
/taxSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

taxStrategyIDType definition

Request Body schema: application/json

details for taxStrategyIDType

string (taxStrategyIDType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

It is a pointer to the Tax Strategy Maintenance Table that includes sufficient methods and/or algorithms to compute the tax relative to or required by that item/department. A TaxStrategyID = 0 indicates the item is non-taxable.

Responses

200
get/taxStrategyIDType
/taxStrategyIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

taxSymbolType definition

Request Body schema: application/json

details for taxSymbolType

string (taxSymbolType) <= 4 characters

Single or dual character that prints on the register receipt to indicate the TaxLevelID.

Responses

200
get/taxSymbolType
/taxSymbolType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

taxTableIDType definition

Request Body schema: application/json

details for taxTableIDType

string (taxTableIDType) [ 1 .. 4 ] characters

A pointer to a matrix of tax breakpoints for taxes that are not a straight percentage.

Responses

200
get/taxTableIDType
/taxTableIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

temperatureUNUOMENUMType definition

Request Body schema: application/json

details for temperatureUNUOMENUMType

string (temperatureUNUOMENUMType) <= 3 characters
Enum: "CEL" "FAH"

Temperature units of measure, following UN/ECE Rec 20.

Responses

200
get/temperatureUNUOMENUMType
/temperatureUNUOMENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"CEL"

temperatureValueType definition

Request Body schema: application/json

details for temperatureValueType

number (temperatureValueType) [ -9999 .. 9999 ]

A numeric value that ranges over the common temperature scales.

Responses

200
get/temperatureValueType
/temperatureValueType

Request samples

Content type
application/json
Copy
Expand all Collapse all
-9999

tenderCodeEENUMType definition

Request Body schema: application/json

details for tenderCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "cash" "check" "moneyOrder" "foodStamps" "ebt" "giftCertificates" "creditCards" "fleetCards" "debitCards" "radioFrequency" "prepaidCards" "smartCards" "houseCharges" "driveOff" "lotteryWinningTicket" "lottoWinningTicket" "coupons" "wicPayment" "pumpForTest" "userDefinedTenderTypes" "generic"

TenderCodes defined by Conexxus (base type).

Responses

200
get/tenderCodeEENUMType
/tenderCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tenderSubCodeEENUMType definition

Request Body schema: application/json

details for tenderSubCodeEENUMType

Any of
  • string
  • string
string <= 40 characters
Enum: "cash" "commercialCheck" "employeeCheck" "governmentCheck" "ebtFoodStamp" "cashBack" "americanExpress" "visa" "masterCard" "oilCompany" "proprietary" "manufacturer" "store" "generic"

TenderSubCodes defined by Conexxus (base type).

Responses

200
get/tenderSubCodeEENUMType
/tenderSubCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tentIDType definition

Request Body schema: application/json

details for tentIDType

string (tentIDType) [ 1 .. 8 ] characters

The number on the little tent given to the customer in a food service environment. The customer places the tent on their table, and the staff uses it to locate the correct table to delivery the food to after preparation

Responses

200
get/tentIDType
/tentIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

terminalStatusCodeEENUMType definition

Request Body schema: application/json

details for terminalStatusCodeEENUMType

Any of
  • string
  • string
string <= 16 characters
Enum: "startup" "shutdown"

terminalStatusCode values defined by Conexxus (base type)

Responses

200
get/terminalStatusCodeEENUMType
/terminalStatusCodeEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

tillIDType definition

Request Body schema: application/json

details for tillIDType

string (tillIDType) [ 1 .. 4 ] characters

Identifies the till in a multiple till per register scenario.

Responses

200
get/tillIDType
/tillIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

timeClockSequenceNumberType definition

Request Body schema: application/json

details for timeClockSequenceNumberType

integer (timeClockSequenceNumberType) [ 0 .. 99999999 ]

Identifier for a TimeClockDetail entry.

Responses

200
get/timeClockSequenceNumberType
/timeClockSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

timeTierCodeType definition

Request Body schema: application/json

details for timeTierCodeType

string (timeTierCodeType) [ 1 .. 16 ] characters

A pointer to the Time Tier Table. The values indicate the type of time tier by which the customer purchased or may purchase a fuel grade. This is typically used for day segment pricing.

Responses

200
get/timeTierCodeType
/timeTierCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

timeType definition

Request Body schema: application/json

details for timeType

string <time> (timeType) [ 8 .. 14 ] characters

ISO 8601 time designation aligning with XML Schema.

Responses

200
get/timeType
/timeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stringst"

timeUNUOMENUMType definition

Request Body schema: application/json

details for timeUNUOMENUMType

string (timeUNUOMENUMType) <= 3 characters
Enum: "SEC" "MIN" "HUR" "DAY" "WEE" "MON" "ANN"

Common time units of measure

Responses

200
get/timeUNUOMENUMType
/timeUNUOMENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"SEC"

timeZoneType definition

Request Body schema: application/json

details for timeZoneType

string (timeZoneType) <= 24 characters

24 character timezone description.

Responses

200
get/timeZoneType
/timeZoneType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

transactionAvailableStateENUMType definition

Request Body schema: application/json

details for transactionAvailableStateENUMType

string (transactionAvailableStateENUMType) <= 7 characters ^[a-z]{6,7}
Enum: "locked" "payable" "cleared"

transactionAvailableState is used in fdc to identify the different states of an available transaction

Responses

200
get/transactionAvailableStateENUMType
/transactionAvailableStateENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"locked"

transactionIDType definition

Request Body schema: application/json

details for transactionIDType

string (transactionIDType) [ 1 .. 16 ] characters

Identifier for the transaction within a given period.

Responses

200
get/transactionIDType
/transactionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

transactionLineSequenceNumberType definition

Request Body schema: application/json

details for transactionLineSequenceNumberType

integer (transactionLineSequenceNumberType) [ 0 .. 99999999 ]

The sequence number assigned to the transaction line by the register.

Responses

200
get/transactionLineSequenceNumberType
/transactionLineSequenceNumberType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

transactionLineStatusENUMType definition

Request Body schema: application/json

details for transactionLineStatusENUMType

string (transactionLineStatusENUMType) <= 16 characters
Enum: "normal" "cancel" "return" "other" "void" "voidReturn" "sale" "voidSale"

Normal indicates anormally completed, unmodified transaction line. Cancel indicatges a transaction line that was rung and then reversed, and is therfore not included in the transation total and does not impact store inventory. Return indicate a transaction line for a product returned by the customer for credit as part of a sale transaction. Refund transactions would not use this status. This status could also be used to record foodservice orders that were cancelled after the order was prepared. Return aquantity is assumed to be a positive number. Retun is not applicable to Tender, PromotionTrigger, PromotionReward, TransactionTax, or CustomerID transaction lines. Other indicates transaction line whose status is user-defined and qulified by the element TransactionLineStatusDescription.

Responses

200
get/transactionLineStatusENUMType
/transactionLineStatusENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"normal"

transactionLinkReasonType definition

Request Body schema: application/json

details for transactionLinkReasonType

string (transactionLinkReasonType) [ 1 .. 16 ] characters

A reason code indicating why the item/merchandise was linked defined by Conexxus (base type).

Responses

200
get/transactionLinkReasonType
/transactionLinkReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

transactionSeqNoType definition

Request Body schema: application/json

details for transactionSeqNoType

integer (transactionSeqNoType) [ 0 .. 99999999 ]

transactionSeqNo is the unique identifier of a transaction

Responses

200
get/transactionSeqNoType
/transactionSeqNoType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

transactionStatusEENUMType definition

Request Body schema: application/json

details for transactionStatusEENUMType

Any of
  • string
  • string
string <= 25 characters ^[a-z][A-Za-z]{5,24}
Enum: "created" "pumpReserveRequested" "pumpReserved" "authorized" "beginFueling" "finalized" "cancelRequest" "canceled" "closed"

transactionStatus is a string of characters used to identify the state of a transaction

Responses

200
get/transactionStatusEENUMType
/transactionStatusEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

transmissionIDType definition

Request Body schema: application/json

details for transmissionIDType

integer (transmissionIDType) [ 0 .. 99999999 ]

An unique identifier for a particular report.

Responses

200
get/transmissionIDType
/transmissionIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

transponderIDType definition

Request Body schema: application/json

details for transponderIDType

string (transponderIDType) [ 1 .. 40 ] characters

Electronic ID of the transponder.

Responses

200
get/transponderIDType
/transponderIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

trayIDType definition

Request Body schema: application/json

details for trayIDType

string (trayIDType) [ 1 .. 16 ] characters

A unique identifier denoting the tray that was used within a food service environment.

Responses

200
get/trayIDType
/trayIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

unitOfMeasurementEENUMType definition

Request Body schema: application/json

details for unitOfMeasurementEENUMType

Any of
  • string
  • string
string <= 3 characters ^[A-Z]{2,3}|([A-Z]{1}[0-9]{1,2})$

enum values excerpted from IFSF Engineering Bulletin 14 (UN/ECE Rec 20)

Responses

200
get/unitOfMeasurementEENUMType
/unitOfMeasurementEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"ANN"

upcFamilyCodeType definition

Request Body schema: application/json

details for upcFamilyCodeType

string (upcFamilyCodeType) [ 1 .. 3 ] characters ^[0-9]{1,3}$

(remove?)

Responses

200
get/upcFamilyCodeType
/upcFamilyCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"str"

userIDType definition

Request Body schema: application/json

details for userIDType

string (userIDType) <= 16 characters

userID is used to identify the ID of the user who performs certain operation

Responses

200
get/userIDType
/userIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

userNameType definition

Request Body schema: application/json

details for userNameType

string (userNameType) <= 40 characters

userName is used to identify the name of the user who performs certain operation

Responses

200
get/userNameType
/userNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

uuidType definition

Request Body schema: application/json

details for uuidType

string (uuidType) [ 1 .. 40 ] characters

A unique identifier.

Responses

200
get/uuidType
/uuidType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

vehicleColorType definition

Request Body schema: application/json

details for vehicleColorType

string (vehicleColorType) <= 24 characters

The color of the vehicle.

Responses

200
get/vehicleColorType
/vehicleColorType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

vehicleIDType definition

Request Body schema: application/json

details for vehicleIDType

string (vehicleIDType) [ 1 .. 40 ] characters

The identification of the vehicle in the fleet card purchase.

Responses

200
get/vehicleIDType
/vehicleIDType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

vehicleTypeType definition

Request Body schema: application/json

details for vehicleTypeType

string (vehicleTypeType) <= 24 characters

Type of vehicle.

Responses

200
get/vehicleTypeType
/vehicleTypeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

vendorModelVersionType definition

Request Body schema: application/json

details for vendorModelVersionType

string (vendorModelVersionType) <= 40 characters

A description of the POS or Back Office model/version. The use of this element is an implementation choice. Some may prefer to set up a general table containing this information

Responses

200
get/vendorModelVersionType
/vendorModelVersionType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

vendorNameType definition

Request Body schema: application/json

details for vendorNameType

string (vendorNameType) <= 40 characters

The POS or Back Office vendor name. The use of this element is an implementation choice. Some may prefer to set up a general table containing this information

Responses

200
get/vendorNameType
/vendorNameType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

voidReasonType definition

Request Body schema: application/json

details for voidReasonType

string (voidReasonType) [ 1 .. 16 ] characters

A reason code indicating why the item/merchandise was voided defined by Conexxus (base type).

Responses

200
get/voidReasonType
/voidReasonType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

volumeUNUOMENUMType definition

Request Body schema: application/json

details for volumeUNUOMENUMType

string (volumeUNUOMENUMType) <= 3 characters
Enum: "MLT" "CMQ" "LTR" "OZA" "OZI" "PT" "PTI" "QT" "QTI" "GLL" "GLI"

Unit of measure indicating volume.

Responses

200
get/volumeUNUOMENUMType
/volumeUNUOMENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"MLT"

washCodeType definition

Request Body schema: application/json

details for washCodeType

integer (washCodeType) [ 0 .. 10000000000000000 ]

The code assigned to the purchased wash, needed for redemption at the pedestal.

Responses

200
get/washCodeType
/washCodeType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

yesNoEENUMType definition

Request Body schema: application/json

details for yesNoEENUMType

Any of
  • string
  • string
string <= 6 characters
Enum: "yes" "no"

boolean definition

Responses

200
get/yesNoEENUMType
/yesNoEENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

yesNoENUMType definition

Request Body schema: application/json

details for yesNoENUMType

string (yesNoENUMType) <= 4 characters
Enum: "yes" "no"

Yes or no value, used as a more flexible option to true/false.

Responses

200
get/yesNoENUMType
/yesNoENUMType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"yes"

Objects

alarmMsgObject definition

Request Body schema: application/json

details for alarmMsgObject

Array
number
required
integer (integerUnsigned2BaseType) [ 0 .. 99 ]

2 digit numeric value

text
required
string (description40BaseType) <= 40 characters

40 character description.

Responses

200
get/alarmMsgObject
/alarmMsgObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

amountObject definition

Request Body schema: application/json

details for amountObject

value
required
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

currency
string or string (currencyEENUMType)

ISO-4217 / UN/ECE REC 09 Codes

Responses

200
get/amountObject
/amountObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "currency": "AED"
}

comboDiscountAllocationObject definition

Request Body schema: application/json

details for comboDiscountAllocationObject

value
required
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

percent
required
string <= 8 characters
Enum: "percent" "amount"

ComboDiscountAllocation permits the BOS to designate how promotion discounts are to be allocated to the items in a promotion. To allocate no discount, one would use an amount or percent of zero.

Responses

200
get/comboDiscountAllocationObject
/comboDiscountAllocationObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "percent": "percent"
}

componentItemIDObject definition

Request Body schema: application/json

details for componentItemIDObject

value
required
string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

componentAction
required
string <= 16 characters
Enum: "isMemberOf" "isAddedTo" "isRemovedFrom"

A unique identifier for an item which is a component of some other item. Attributes componentAction ( isAddedTo | isMemberOf | isRemovedFrom ).

Responses

200
get/componentItemIDObject
/componentItemIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "componentAction": "isMemberOf"
}

condimentIDObject definition

Request Body schema: application/json

details for condimentIDObject

value
required
string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

componentAction
string (id16BaseType) [ 1 .. 16 ] characters

16 character ID

Responses

200
get/condimentIDObject
/condimentIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "componentAction": "string"
}

countrySettingsObject definition

Request Body schema: application/json

details for countrySettingsObject

volumeUnit
string or string (unitOfMeasurementEENUMType)

enum values excerpted from IFSF Engineering Bulletin 14 (UN/ECE Rec 20)

levelUnit
string or string (unitOfMeasurementEENUMType)

enum values excerpted from IFSF Engineering Bulletin 14 (UN/ECE Rec 20)

temperatureUnit
string or string (unitOfMeasurementEENUMType)

enum values excerpted from IFSF Engineering Bulletin 14 (UN/ECE Rec 20)

countryCode
string or string (countryEENUMType) <= 2 characters ^[A-Z][A-Z]

ISO-3166 / UN/ECE REC 09 Codes

language
string (languageENUMType) <= 8 characters
Enum: "abk" "ace" "ach" "ada" "aar" "afh" "afr" "afa" "aka" "akk" "alb/sqi" "ale" "alg" "tut" "amh" "apa" "ara" "arc" "arp" "arn" "arw" "arm/hye" "art" "asm" "ath" "map" "ava" "ave" "awa" "aym" "aze" "nah" "ban" "bat" "bal" "bam" "bai" "bad" "bnt" "bas" "bak" "baq/eus" "bej" "bem" "ben" "ber" "bho" "bih" "bik" "bin" "bis" "bra" "bre" "bug" "bul" "bua" "bur/mya" "bel" "cad" "car" "cat" "cau" "ceb" "cel" "cai" "chg" "cha" "che" "chr" "chy" "chb" "chi/zho" "chn" "cho" "chu" "chv" "cop" "cor" "cos" "cre" "mus" "crp" "cpe" "cpf" "cpp" "cus" "ces/cze" "dak" "dan" "del" "din" "div" "doi" "dra" "dua" "dut/nla" "dum" "dyu" "dzo" "efi" "egy" "eka" "elx" "eng" "enm" "ang" "esk" "epo" "est" "ewe" "ewo" "fan" "fat" "fao" "fij" "fin" "fiu" "fon" "fra/f" "frm" "fro" "fry" "ful" "gaa" "gae/gdh" "glg" "lug" "gay" "gez" "geo/kat" "deu/ger" "gmh" "goh" "gem" "gil" "gon" "got" "grb" "grc" "ell/gre" "kal" "grn" "guj" "hai" "hau" "haw" "heb" "her" "hil" "him" "hin" "hmo" "hun" "hup" "iba" "ice/isl" "ibo" "ijo" "ilo" "inc" "ine" "ind" "ina" "iku" "ipk" "ira" "gai/iri" "sga" "mga" "iro" "ita" "jpn" "jav/jaw" "jrb" "jpr" "kab" "kac" "kam" "kan" "kau" "kaa" "kar" "kas" "kaw" "kaz" "kha" "khm" "khi" "kho" "kik" "kin" "kir" "kom" "kon" "kok" "kor" "kpe" "kro" "kua" "kum" "kur" "kru" "kus" "kut" "lad" "lah" "lam" "oci" "lao" "lat" "lav" "ltz" "lez" "lin" "lit" "loz" "lub" "lui" "lun" "luo" "mac/mak" "mad" "mag" "mai" "mak" "mlg" "may/msa" "mal" "mlt" "man" "mni" "mno" "max" "mao/mri" "mar" "chm" "mah" "mwr" "mas" "myn" "men" "mic" "min" "mis" "moh" "mol" "mkh" "lol" "mon" "mos" "mul" "mun" "nau" "nav" "nde" "nbl" "ndo" "nep" "new" "nic" "ssa" "niu" "non" "nai" "nor" "nno" "nub" "nym" "nya" "nyn" "nyo" "nzi" "oji" "ori" "orm" "osa" "oss" "oto" "pal" "pau" "pli" "pam" "pag" "pan" "pap" "paa" "fas/per" "peo" "phn" "pol" "pon" "por" "pra" "pro" "pus" "que" "roh" "raj" "rar" "roa" "ron/rum" "rom" "run" "rus" "sal" "sam" "smi" "smo" "sad" "sag" "san" "srd" "sco" "sel" "sem" "scr" "srr" "shn" "sna" "sid" "bla" "snd" "sin" "sit" "sio" "sla" "ssw" "slk/slo" "slv" "sog" "som" "son" "wen" "nso" "sot" "sai" "esl/spa" "suk" "sux" "sun" "sus" "swa" "sve/swe" "syr" "tgl" "tah" "tgk" "tmh" "tam" "tat" "tel" "ter" "tha" "bod/tib" "tig" "tir" "tem" "tiv" "tli" "tog" "ton" "tru" "tsi" "tso" "tsn" "tum" "tur" "ota" "tuk" "tyv" "twi" "uga" "uig" "ukr" "umb" "und" "urd" "uzb" "vai" "ven" "vie" "vol" "vot" "wak" "wal" "war" "was" "cym/wel" "wol" "xho" "sah" "yao" "yap" "yid" "yor" "zap" "zen" "zha" "zul" "zun"

The following SGML-encoded summary of the language codes of ISO 639 was prepared by Harry Gaylord. The two-letter codes are from the present ISO 639 standard. The three letter-codes are the current proposals in ISO CD 639/2 Draft dated 10/15/92 of the working group revising 639 for TC 3 and TC 46 of ISO and may be revised, amended, or changed before the new ISO standard is issued.

localCurrencies
Array of strings or strings (local currencies array) <= 5 items

country settings includes relevant information specifically related to a country and common to all its sites

foreignCurrencies
Array of strings or strings (foreign currencies array) <= 5 items

country settings includes relevant information specifically related to a country and common to all its sites

Responses

200
get/countrySettingsObject
/countrySettingsObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "volumeUnit": "str",
  • "levelUnit": "str",
  • "temperatureUnit": "str",
  • "countryCode": "AF",
  • "language": "abk",
  • "localCurrencies":
    [
    ],
  • "foreignCurrencies":
    [
    ]
}

couponRedeemedObject definition

Request Body schema: application/json

details for couponRedeemedObject

redeemedCouponID
required
string (redeemedCouponIDType) [ 1 .. 80 ] characters

The identification of the redeemed coupon.

primaryCompanyPrefix
string (primaryCompanyPrefixType) <= 40 characters

Prefix for identifying Coupons, variable portion (6-12 digits) of the GS1 'GLN' - 13 digits including check digit.

offerCode
integer (offerCodeType) [ 0 .. 10000000000000000 ]

Offer code for a coupon, should be a GS1 'GCN' - 13 digits.

couponExpirationDate
string <date> (dateType) <= 10 characters

ISO 8601 Date Type to align with XML Schema.

Responses

200
get/couponRedeemedObject
/couponRedeemedObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "redeemedCouponID": "string",
  • "primaryCompanyPrefix": "string",
  • "offerCode": 0,
  • "couponExpirationDate": "2020-06-23"
}

depthObject definition

Request Body schema: application/json

details for depthObject

value
required
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

unit
string or string (unitOfMeasurementEENUMType)

enum values excerpted from IFSF Engineering Bulletin 14 (UN/ECE Rec 20)

Responses

200
get/depthObject
/depthObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "unit": "str"
}

discountObject definition

Request Body schema: application/json

details for discountObject

discountVolume
object (volumeUNObject)
discountQuantity
object (quantityUNObject)
discountAmount
required
object (amountObject)
discountReason
string or string (discountReasonEENUMType)

A reason code indicating why the item/merchandise was discounted defined by Conexxus (base type).

discountID
string (discountIDType) [ 1 .. 40 ] characters

A reference string for identifying a discount.

itemTaxes
Array of objects (taxObject)

Description of the specific discount recorded. Choice of DiscountVolume or DiscountQuantity.

transactionTaxes
Array of objects (taxObject)

Description of the specific discount recorded. Choice of DiscountVolume or DiscountQuantity.

Responses

200
get/discountObject
/discountObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "discountVolume":
    {
    },
  • "discountQuantity":
    {
    },
  • "discountAmount":
    {
    },
  • "discountReason": "storeCouponOffer",
  • "discountID": "string",
  • "itemTaxes":
    [
    ],
  • "transactionTaxes":
    [
    ]
}

dispenserConfigurationObject definition

Request Body schema: application/json

details for dispenserConfigurationObject

dispenserID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

fuelProducts
Array of objects (fuelProductObject) <= 8 items
limits
Array of objects (limitObject) <= 8 items
pumpTimeout
integer [ 1 .. 60 ]

Timeout for a pump auth, in seconds

fuelingPoints
Array of objects (fuelingPointConfigurationObject) <= 4 items

Responses

200
get/dispenserConfigurationObject
/dispenserConfigurationObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "dispenserID": "string",
  • "fuelProducts":
    [
    ],
  • "limits":
    [
    ],
  • "pumpTimeout": 1,
  • "fuelingPoints":
    [
    ]
}

fuelGradeIDObject definition

Request Body schema: application/json

details for fuelGradeIDObject

value
required
string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

paymentSystemsProductCode
string (paymentSystemsProductCodeType) [ 2 .. 5 ] characters ^[0-9]{2,5}$

Conexxus Payment System Product Codes and/or the underlying standard (X9.104) for which Conexxus is the Registration Authority, published by ACS X9, Inc.

Responses

200
get/fuelGradeIDObject
/fuelGradeIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "paymentSystemsProductCode": "strin"
}

fuelModesObject definition

Request Body schema: application/json

details for fuelModesObject

modeNo
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

modeName
string (description16BaseType) <= 16 characters

16 character description.

Responses

200
get/fuelModesObject
/fuelModesObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "modeNo": 0,
  • "modeName": "string"
}

fuelProductObject definition

Request Body schema: application/json

details for fuelProductObject

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productCategory
integer (productCategoryType) [ 0 .. 99999999 ]

the product category value determine how the POS treats the data coming from the dispenser

productID
object
productCode
required
integer (productCodeType) [ 0 .. 99999999 ]

product code provides a classification of the fuel product

merchandiseCode
string (description40BaseType) <= 40 characters

40 character description.

prices
Array of objects <= 100 items
taxID
string

Responses

200
get/fuelProductObject
/fuelProductObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productNo": 0,
  • "productCategory": 0,
  • "productID":
    {
    },
  • "productCode": 0,
  • "merchandiseCode": "string",
  • "prices":
    [
    ],
  • "taxID": "string"
}

fuelStockIDObject definition

Request Body schema: application/json

details for fuelStockIDObject

value
string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

paymentSystemsProductCode
string (paymentSystemsProductCodeType) [ 2 .. 5 ] characters ^[0-9]{2,5}$

Conexxus Payment System Product Codes and/or the underlying standard (X9.104) for which Conexxus is the Registration Authority, published by ACS X9, Inc.

Responses

200
get/fuelStockIDObject
/fuelStockIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "paymentSystemsProductCode": "strin"
}

fuelingPointAuthorizeObject definition

Request Body schema: application/json

details for fuelingPointAuthorizeObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

maxTrxAmount
object (monetaryAmount20Object)
maxTrxVolume
object (quantityUNObject)
modeNo
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

releasedProducts
Array of objects <= 8 items

data structure which defines the fueling point authorization request

releaseToken
string <= 8 characters

data structure which defines the fueling point authorization request

lockFuelSaleTrx
string <= 8 characters
Enum: true false

data structure which defines the fueling point authorization request

consentNeeded
string <= 5 characters
Default: "false"
Enum: true false

Responses

200
get/fuelingPointAuthorizeObject
/fuelingPointAuthorizeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "maxTrxAmount":
    {
    },
  • "maxTrxVolume":
    {
    },
  • "modeNo": 0,
  • "releasedProducts":
    [
    ],
  • "releaseToken": "string",
  • "lockFuelSaleTrx": true,
  • "consentNeeded": "false"
}

fuelingPointConfigurationObject definition

Request Body schema: application/json

details for fuelingPointConfigurationObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

pumpNo
required
integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

defaultFuelingMode
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

maxTrxAmount
object (monetaryAmount20Object)
maxTrxVolume
object (quantityUNObject)
serviceLevel
string
Enum: "F" "S"

Service Level (F or S). Full or Self

nozzles
Array of objects (nozzleObject) <= 8 items

Responses

200
get/fuelingPointConfigurationObject
/fuelingPointConfigurationObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "pumpNo": 0,
  • "defaultFuelingMode": 0,
  • "maxTrxAmount":
    {
    },
  • "maxTrxVolume":
    {
    },
  • "serviceLevel": "F",
  • "nozzles":
    [
    ]
}

fuelingPointConsentAuthorizeObject definition

Request Body schema: application/json

details for fuelingPointConsentAuthorizeObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

releasedProducts
Array of objects <= 8 items

data structure which defines the fueling point authorization request

consentGiven
string <= 5 characters
Default: "true"
Enum: true false

Responses

200
get/fuelingPointConsentAuthorizeObject
/fuelingPointConsentAuthorizeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "releasedProducts":
    [
    ],
  • "consentGiven": "true"
}

fuelingPointTotalsObject definition

Request Body schema: application/json

details for fuelingPointTotalsObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

pumpNo
required
integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

nozzleNo
required
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

amount
object (monetaryAmount20Object)
volume
object (quantityUNObject)
volumeProduct1
object (quantityUNObject)
volumeProduct2
object (quantityUNObject)
productNo1
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productNo2
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

errorCode
string or string <= 40 characters

error code is an string of characters used to identify specific errors of a transaction

Responses

200
get/fuelingPointTotalsObject
/fuelingPointTotalsObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "pumpNo": 0,
  • "nozzleNo": 0,
  • "amount":
    {
    },
  • "volume":
    {
    },
  • "volumeProduct1":
    {
    },
  • "volumeProduct2":
    {
    },
  • "productNo1": 0,
  • "productNo2": 0,
  • "errorCode": "ERRCD_OK"
}

fuelingStatusObject definition

Request Body schema: application/json

details for fuelingStatusObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

pumpNo
required
integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

transactionSeqNo
required
integer (transactionSeqNoType) [ 0 .. 99999999 ]

transactionSeqNo is the unique identifier of a transaction

currentAmount
object (monetaryAmount20Object)
currentVolume
object (quantityUNObject)
currentUnitPrice
object (price10Object)
currentNozzleNo
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

releaseToken
string <= 8 characters

It is taken from Dispenser Standard Release Token, which is Bin 8 pattern "[0-9A-F][0-9A-F]"

authorizationApplicationSender
string (description100BaseType) <= 100 characters

100 character description.

errorCode
string or string <= 40 characters

error code is an string of characters used to identify specific errors of a transaction

Responses

200
get/fuelingStatusObject
/fuelingStatusObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "pumpNo": 0,
  • "transactionSeqNo": 0,
  • "currentAmount":
    {
    },
  • "currentVolume":
    {
    },
  • "currentUnitPrice":
    {
    },
  • "currentNozzleNo": 0,
  • "releaseToken": "string",
  • "authorizationApplicationSender": "string",
  • "errorCode": "ERRCD_OK"
}

geoCoordinatesObject definition

Request Body schema: application/json

details for geoCoordinatesObject

latitude
required
number <double> [ -90 .. 90 ]

the geoCoordinates are a unique identifier of a precise geographic location on the earth

longitude
required
number <double> [ -180 .. 180 ]

the geoCoordinates are a unique identifier of a precise geographic location on the earth

angleUOM
string <= 25 characters
Enum: "radians" "decimal degrees" "decimal dd.mm.ss"

the geoCoordinates are a unique identifier of a precise geographic location on the earth

datum
string <= 8 characters

the geoCoordinates are a unique identifier of a precise geographic location on the earth

Responses

200
get/geoCoordinatesObject
/geoCoordinatesObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "latitude": -90,
  • "longitude": -180,
  • "angleUOM": "radians",
  • "datum": "string"
}

giskeKeyHeaderObject definition

Request Body schema: application/json

details for giskeKeyHeaderObject

keyUsage
required
(giskeKeyUsageEENUMType (string or string)) or string

Global Interoperable Secure Key Exchange Key Block Specification V2.3a Key Header. Before a key in the Key Block format is used in a Tamper Resistant Security Module (TRSM), the content of the header block must be validated to ensure the correct usage is enforced. The Key Usage byte is typically checked first followed by the Algorithm byte. The other header bytes may or may not be checked depending on the key usage and the algorithm used.

algorithm
required
(giskeAlgorithmEENUMType (string or string)) or string

Global Interoperable Secure Key Exchange Key Block Specification V2.3a Key Header. Before a key in the Key Block format is used in a Tamper Resistant Security Module (TRSM), the content of the header block must be validated to ensure the correct usage is enforced. The Key Usage byte is typically checked first followed by the Algorithm byte. The other header bytes may or may not be checked depending on the key usage and the algorithm used.

modeOfUse
required
(giskeModeOfUseEENUMType (string or string)) or string

Global Interoperable Secure Key Exchange Key Block Specification V2.3a Key Header. Before a key in the Key Block format is used in a Tamper Resistant Security Module (TRSM), the content of the header block must be validated to ensure the correct usage is enforced. The Key Usage byte is typically checked first followed by the Algorithm byte. The other header bytes may or may not be checked depending on the key usage and the algorithm used.

exportability
required
(giskeExportabilityEENUMType (string or string)) or string

Global Interoperable Secure Key Exchange Key Block Specification V2.3a Key Header. Before a key in the Key Block format is used in a Tamper Resistant Security Module (TRSM), the content of the header block must be validated to ensure the correct usage is enforced. The Key Usage byte is typically checked first followed by the Algorithm byte. The other header bytes may or may not be checked depending on the key usage and the algorithm used.

Responses

200
get/giskeKeyHeaderObject
/giskeKeyHeaderObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "keyUsage": "dataEncryption",
  • "algorithm": "3des",
  • "modeOfUse": "noSpecialRestrictions",
  • "exportability": "sensitive"
}

groupCodeObject definition

Request Body schema: application/json

details for groupCodeObject

value
required
string (id16BaseType) [ 1 .. 16 ] characters

16 character ID

index
string (id4BaseType) [ 1 .. 4 ] characters

4 character ID

type
string <= 8 characters
Enum: "pointer" "text"

GroupCode is a mechanism for grouping items independently of merchandise code or other hierarchy.

Responses

200
get/groupCodeObject
/groupCodeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "index": "stri",
  • "type": "pointer"
}

itemCodeObject definition

Request Body schema: application/json

details for itemCodeObject

posCodeFormat
required
object (posCodeFormatObject)
posCode
required
string (posCodeType) <= 24 characters ^[0-9]{1,24}$
posCodeModifier
required
object (posCodeModifierObject)
inventoryItemID
string (itemIDType) [ 1 .. 40 ] characters

Generic ID for items and links to them.

Responses

200
get/itemCodeObject
/itemCodeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "posCodeFormat":
    {
    },
  • "posCode": "string",
  • "posCodeModifier":
    {
    },
  • "inventoryItemID": "string"
}

lengthUNObject definition

Request Body schema: application/json

details for lengthUNObject

value
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

uom
string (lengthUNUOMENUMType) <= 3 characters
Enum: "MMT" "CMT" "MTR" "KMT" "INH" "FOT" "YRD" "SMI"

uom designation for lengths (widths, depths, etc.).

Responses

200
get/lengthUNObject
/lengthUNObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "uom": "MMT"
}

limitObject definition

Request Body schema: application/json

details for limitObject

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

modeNo
required
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

maxTrxAmount
object (monetaryAmount20Object)
maxTrxVolume
object (quantityUNObject)

Responses

200
get/limitObject
/limitObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productNo": 0,
  • "modeNo": 0,
  • "maxTrxAmount":
    {
    },
  • "maxTrxVolume":
    {
    }
}

manufacturerCouponObject definition

Request Body schema: application/json

details for manufacturerCouponObject

primaryLabelID
string (primaryLabelIDType) [ 1 .. 16 ] characters ^[0-9]{1,16}$

The primary label from a coupon.

extendedLabelID
string (extendedLabelIDType) [ 1 .. 16 ] characters ^[0-9]{1,16}$

An extra label from a coupon.

manufacturerID
required
string (manufacturerIDType) [ 1 .. 8 ] characters

An identifier for the manufacturer that issued the coupon.

familyCode
required
string (familyCodeType) [ 1 .. 3 ] characters ^[0-9]{1,3}$

That portion of a U.P.C. on a manufacturer's coupon used to identify an item's grouping for discount purposes.

couponExpirationDate
required
string <date> (dateType) <= 10 characters

ISO 8601 Date Type to align with XML Schema.

promotionCode
string (promotionCodeType) [ 1 .. 8 ] characters

The kind of promotion the coupon is part of.

Responses

200
get/manufacturerCouponObject
/manufacturerCouponObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "primaryLabelID": "string",
  • "extendedLabelID": "string",
  • "manufacturerID": "string",
  • "familyCode": "str",
  • "couponExpirationDate": "2020-06-23",
  • "promotionCode": "string"
}

massUNObject definition

Request Body schema: application/json

details for massUNObject

value
required
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

uom
string (massUNUOMENUMType) <= 3 characters
Enum: "GRM" "KGM" "ONZ" "LBR"

Unit of measure indicating weight (mass).

Responses

200
get/massUNObject
/massUNObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "uom": "GRM"
}

merchandiseCodeObject definition

Request Body schema: application/json

details for merchandiseCodeObject

level
string (id4NBaseType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

4 digit numeric ID

value
required
string (merchandiseCodeType) <= 40 characters ^([0-9]{1,16}(\.[0-9]{1,16}){0,6})$

Enhanced MerchandiseCode type to support hierarchical MerchandiseCodes.

Responses

200
get/merchandiseCodeObject
/merchandiseCodeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "level": "stri",
  • "value": "string"
}

mimeEncodedDataObject definition

Request Body schema: application/json

details for mimeEncodedDataObject

mimeType
string (mimeTypeType) [ 1 .. 40 ] characters

MIME type for binary data.

data
string $((([A-Za-z0-9+/] ?){4})*(([A-Za-z0-9+/] ?){3}[A-Za-z0-9+/]|([A-Za-z0-9+/] ?){2}[AEIMQUYcgkosw048] ?=|[A-Za-z0-9+/] ?[AQgw] ?= ?=))?

Base 64 binary encoded data (per XML Schema Part 2), with accompanying MIME-type.

Responses

200
get/mimeEncodedDataObject
/mimeEncodedDataObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mimeType": "string",
  • "data": "string"
}

monetaryAmount20Object definition

Request Body schema: application/json

details for monetaryAmount20Object

value
required
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

currency
string or string (currencyEENUMType)

ISO-4217 / UN/ECE REC 09 Codes

Responses

200
get/monetaryAmount20Object
/monetaryAmount20Object

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "currency": "AED"
}

nozzleObject definition

Request Body schema: application/json

details for nozzleObject

nozzleNo
required
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

nozzleName
string (description40BaseType) <= 40 characters

40 character description.

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

tankNo1
required
integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

tankNo2
integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

blendRatio
required
integer (integerUnsigned2BaseType) [ 0 .. 99 ]

2 digit numeric value

Responses

200
get/nozzleObject
/nozzleObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "nozzleNo": 0,
  • "nozzleName": "string",
  • "productNo": 0,
  • "tankNo1": 0,
  • "tankNo2": 0,
  • "blendRatio": 0
}

nozzleStateObject definition

Request Body schema: application/json

details for nozzleStateObject

nozzleNo
required
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

logicalNozzle
string <= 16 characters
Enum: "nozzleUp" "nozzleDown"

state of a specific nozzle to get (used in FDC to get fueling point status)

logicalState
string <= 16 characters
Enum: "locked" "unlocked"

state of a specific nozzle to get (used in FDC to get fueling point status)

tankLogicalState
string <= 16 characters
Enum: "locked" "unlocked"

state of a specific nozzle to get (used in FDC to get fueling point status)

Responses

200
get/nozzleStateObject
/nozzleStateObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "nozzleNo": 0,
  • "logicalNozzle": "nozzleUp",
  • "logicalState": "locked",
  • "tankLogicalState": "locked"
}

periodObject definition

Request Body schema: application/json

details for periodObject

type
required
string

period is used in the day end process to identify the period to be closed

id
required
integer <int64> >= 1

period is used in the day end process to identify the period to be closed

beginDateTime
required
string <date-time> (dateTimeType) [ 10 .. 30 ] characters

Responses

200
get/periodObject
/periodObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "type": "string",
  • "id": 1,
  • "beginDateTime": "2020-06-23T16:37:36Z"
}

phoneNumberObject definition

Request Body schema: application/json

details for phoneNumberObject

type
required
string or string (phoneLineTypeEENUMType)

The type of phone line (extendable).

number
required
string (phoneNumberStringType) <= 14 characters ^[0-9\-\(\)\B]{,14}$

String roughly constrained to handle phone numbers and common delimiting characters.

Responses

200
get/phoneNumberObject
/phoneNumberObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "type": "mobile",
  • "number": "string"
}

posCodeFormatObject definition

Request Body schema: application/json

details for posCodeFormatObject

format
required
string or string (posCodeFormatEENUMType)
checkDigit
string <= 10 characters
Enum: "present" "absent"

Indicates whether checkdigit is present or absent.

Responses

200
get/posCodeFormatObject
/posCodeFormatObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "format": "upcA",
  • "checkDigit": "present"
}

posCodeModifierObject definition

Request Body schema: application/json

details for posCodeModifierObject

value
required
string (id4NBaseType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

4 digit numeric ID

name
string (description16BaseType) <= 16 characters

16 character description.

Responses

200
get/posCodeModifierObject
/posCodeModifierObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "stri",
  • "name": "string"
}

posTerminalObject definition

Request Body schema: application/json

details for posTerminalObject

terminalID
required
integer (integerUnsigned2BaseType) [ 0 .. 99 ]

2 digit numeric value

terminalType
string (description24BaseType) <= 24 characters

24 character description.

description
string (description100BaseType) <= 100 characters

100 character description.

Responses

200
get/posTerminalObject
/posTerminalObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "terminalID": 0,
  • "terminalType": "string",
  • "description": "string"
}

price10Object definition

Request Body schema: application/json

details for price10Object

value
required
string <= 10 characters [0-9]*[.][0-9][0-9]*

a price is a positive decimal so its value is equivalent to a decimal type except for the sign

currency
string or string (currencyEENUMType)

ISO-4217 / UN/ECE REC 09 Codes

Responses

200
get/price10Object
/price10Object

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "currency": "AED"
}

priceOverrideObject definition

Request Body schema: application/json

details for priceOverrideObject

priceOverridePrice
required
object (amountObject)
priceOverrideApproverID
required
string (approverIDType) [ 1 .. 40 ] characters

An identifier for the cashier or manager that approved the SaleEvent, RefundEvent, VoidEvent or TransactionLine.

priceOverrideReason
required
string or string (repriceReasonEENUMType)

(remove?)

Responses

200
get/priceOverrideObject
/priceOverrideObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "priceOverridePrice":
    {
    },
  • "priceOverrideApproverID": "string",
  • "priceOverrideReason": "emp"
}

pricePoleConfigurationObject definition

Request Body schema: application/json

details for pricePoleConfigurationObject

pricePoleID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

pricePolePoint
object

Responses

200
get/pricePoleConfigurationObject
/pricePoleConfigurationObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pricePoleID": "string",
  • "pricePolePoint":
    {
    }
}

promotionObject definition

Request Body schema: application/json

details for promotionObject

promotionID
required
string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

promotionReason
string or string (promotionReasonEENUMType)

A reason code indicating why the item/merchandise was promo'ed defined by Conexxus (base type).

promotionAmount
object (amountObject)

Responses

200
get/promotionObject
/promotionObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "promotionID": "string",
  • "promotionReason": "combinationOffer",
  • "promotionAmount":
    {
    }
}

quantityUNObject definition

Request Body schema: application/json

details for quantityUNObject

value
required
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

uom
massUNUOMENUMType (string) or volumeUNUOMENUMType (string) or lengthUNUOMENUMType (string) or string or string (quantityUNUOMEENUMType)

Quanity UOM made of massUOM, volumeUOM, lengthUOM, adding 'each'.

Responses

200
get/quantityUNObject
/quantityUNObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "uom": "GRM"
}

reportPeriodObject definition

Request Body schema: application/json

details for reportPeriodObject

value
required
dateType (string) or dateTimeType (string) or string (reportPeriodType)

Label for a report, one of a date, a dateTime, or a string of 12 characters.

interval
string (intervalENUMType) <= 16 characters
Enum: "cashier" "day" "week" "month" "year" "daypart" "shift" "transaction" "sBatch" "hostBatch" "other"

Sometimes refered to as 'day part' values, refers to the scoped period of a report.

Responses

200
get/reportPeriodObject
/reportPeriodObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "2020-06-23",
  • "interval": "cashier"
}

segmentObject definition

Request Body schema: application/json

details for segmentObject

segmentNo
required
integer (segmentNoType) [ 0 .. 9999 ]

segment No is the unique identification of a segment within a price pole

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productName
required
string (productNameType) <= 16 characters

fuel product name is the unique identification of fuel sold at Service stations and C-Stores

productPrice
required
object (price10Object)
modeNo
required
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

Responses

200
get/segmentObject
/segmentObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "segmentNo": 0,
  • "productNo": 0,
  • "productName": "string",
  • "productPrice":
    {
    },
  • "modeNo": 0
}

siteIDObject definition

Request Body schema: application/json

details for siteIDObject

type
required
string (description16BaseType) <= 16 characters

16 character description.

ID
required
string (description8BaseType) <= 8 characters

8 character description.

Responses

200
get/siteIDObject
/siteIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "type": "string",
  • "ID": "string"
}

siteTraitObject definition

Request Body schema: application/json

details for siteTraitObject

value
string (description255BaseType) <= 255 characters

255 character description.

siteTraitName
string (description24BaseType) <= 24 characters

24 character description.

Responses

200
get/siteTraitObject
/siteTraitObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "siteTraitName": "string"
}

softwareComponentObject definition

Request Body schema: application/json

details for softwareComponentObject

itemID
required
string (description40BaseType) <= 40 characters

40 character description.

name
required
string (description100BaseType) <= 100 characters

100 character description.

manufacturerID
required
string (description40BaseType) <= 40 characters

40 character description.

manufacturerName
required
string (description100BaseType) <= 100 characters

100 character description.

applicationName
required
string (description100BaseType) <= 100 characters

100 character description.

applicationSoftwareVersion
required
string (description8BaseType) <= 8 characters

8 character description.

applicationType
required
string <= 5 characters
Enum: "chp" "agent"

An individual software component is a software package, a web service, a web resource, or a module that encapsulates a set of related functions (or data)

protocol
required
string (description16BaseType) <= 16 characters

16 character description.

protocolVersion
required
string (description8BaseType) <= 8 characters

8 character description.

checksum
required
string (description100BaseType) <= 100 characters

100 character description.

build
required
string (description40BaseType) <= 40 characters

40 character description.

buildDate
required
string <date-time> (dateTimeType) [ 10 .. 30 ] characters

Responses

200
get/softwareComponentObject
/softwareComponentObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "itemID": "string",
  • "name": "string",
  • "manufacturerID": "string",
  • "manufacturerName": "string",
  • "applicationName": "string",
  • "applicationSoftwareVersion": "string",
  • "applicationType": "chp",
  • "protocol": "string",
  • "protocolVersion": "string",
  • "checksum": "string",
  • "build": "string",
  • "buildDate": "2020-06-23T16:37:37Z"
}

tankLevelGaugeConfigurationObject definition

Request Body schema: application/json

details for tankLevelGaugeConfigurationObject

tankLevelGaugeID
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

tankProbes
Array of objects (tankProbeObject) <= 31 items

Responses

200
get/tankLevelGaugeConfigurationObject
/tankLevelGaugeConfigurationObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankLevelGaugeID": "string",
  • "tankProbes":
    [
    ]
}

tankObject definition

Request Body schema: application/json

details for tankObject

tankNo
required
integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

tankName
required
string (description40BaseType) <= 40 characters

40 character description.

description
string (description40BaseType) <= 40 characters

40 character description.

tankGroupNo
integer (tankGroupNoType) [ 0 .. 9999 ]

tank group number is the unique identifier of the tank group on a retail store

label
string (description40BaseType) <= 40 characters

40 character description.

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productID
required
object

Responses

200
get/tankObject
/tankObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankNo": 0,
  • "tankName": "string",
  • "description": "string",
  • "tankGroupNo": 0,
  • "label": "string",
  • "productNo": 0,
  • "productID":
    {
    }
}

tankProbeMeasurementDataObject definition

Request Body schema: application/json

details for tankProbeMeasurementDataObject

tankProbeID
required
object (tankProbeIDElement)
tank
required
object (tankObject)
timestamp
string <date-time> (dateTimeType) [ 10 .. 30 ] characters
readingType
string or string (readingTypeEENUMType) <= 15 characters ^[A-Z][A-Za-z]{2,14}

reading type is an string of characters used to indicate how the reading of a tank was obtained

deliveryInProgress
string or string (yesNoEENUMType) <= 6 characters

boolean definition

grossObservedVolumes
Array of objects (quantityUNObject) <= 10 items

data structure which describes the details of the stock within a tank

observedVolume
required
object (quantityUNObject)
productLevel
object (quantityUNObject)
averageTemp
object (temperatureUNObject)
fuelTemperatures
Array of objects <= 10 items

data structure which describes the details of the stock within a tank

ullage
object (quantityUNObject)
operatingUllage
object (quantityUNObject)
waterDepths
Array of objects (quantityUNObject) <= 10 items

data structure which describes the details of the stock within a tank

waterLevel
integer (levelType) [ 0 .. 99999999 ]

level value as used for level readings by tank level gauges. Level is an unsigned integer from "0" to "99999999"

observedDensity
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

temperatureCompensated
string (yesNoENUMType) <= 4 characters
Enum: "yes" "no"

Yes or no value, used as a more flexible option to true/false.

userID
object (userIDElement)
userName
object (userNameElement)

Responses

200
get/tankProbeMeasurementDataObject
/tankProbeMeasurementDataObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankProbeID":
    {
    },
  • "tank":
    {
    },
  • "timestamp": "2020-06-23T16:37:37Z",
  • "readingType": "Auto",
  • "deliveryInProgress": "yes",
  • "grossObservedVolumes":
    [
    ],
  • "observedVolume":
    {
    },
  • "productLevel":
    {
    },
  • "averageTemp":
    {
    },
  • "fuelTemperatures":
    [
    ],
  • "ullage":
    {
    },
  • "operatingUllage":
    {
    },
  • "waterDepths":
    [
    ],
  • "waterLevel": 0,
  • "observedDensity": "string",
  • "temperatureCompensated": "yes",
  • "userID":
    {
    },
  • "userName":
    {
    }
}

tankProbeObject definition

Request Body schema: application/json

details for tankProbeObject

tankProbeID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

tankNo
required
integer (tankNoType) [ 0 .. 9999 ]

tankNo is used to identify a fuel container at a service station. The tank number in a TP (Tank Probe) structure is used to number TPs consecutively

tankName
string (description40BaseType) <= 40 characters

40 character description.

productNo
required
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productName
required
string (productNameType) <= 16 characters

fuel product name is the unique identification of fuel sold at Service stations and C-Stores

manualMode
required
string <= 8 characters
Enum: true false

manual mode true or false

shellCapacity
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

maxSafeFillCap
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

lowCapacity
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

minOperatingCapacity
string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

tankManifoldPartners
Array of objects <= 8 items
setPoints
object

See Engineering Bulletin No 11. BCD 8

Responses

200
get/tankProbeObject
/tankProbeObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tankProbeID": "string",
  • "tankNo": 0,
  • "tankName": "string",
  • "productNo": 0,
  • "productName": "string",
  • "manualMode": true,
  • "shellCapacity": "string",
  • "maxSafeFillCap": "string",
  • "lowCapacity": "string",
  • "minOperatingCapacity": "string",
  • "tankManifoldPartners":
    [
    ],
  • "setPoints":
    {
    }
}

taxObject definition

Request Body schema: application/json

details for taxObject

taxLevelID
required
string (taxLevelIDType) [ 1 .. 4 ] characters

A pointer to the Tax Level Table or Rate. The values of the table specify the tax level being reported. It usually defines a tax rate or table.

taxableSalesAmount
required
object (amountObject)
taxCollectedAmount
required
object (amountObject)
taxableSalesRefundedAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxRefundedAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxExemptSalesAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxExemptAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxExemptSalesRefundedAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxExemptReason
any

Complete set of tax fields to describe taxes applied in a given situation.

taxForgivenSalesAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxForgivenSalesRefundedAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxForgivenAmount
any

Complete set of tax fields to describe taxes applied in a given situation.

taxForgivenReason
any

Complete set of tax fields to describe taxes applied in a given situation.

Responses

200
get/taxObject
/taxObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "taxLevelID": "stri",
  • "taxableSalesAmount":
    {
    },
  • "taxCollectedAmount":
    {
    },
  • "taxableSalesRefundedAmount": null,
  • "taxRefundedAmount": null,
  • "taxExemptSalesAmount": null,
  • "taxExemptAmount": null,
  • "taxExemptSalesRefundedAmount": null,
  • "taxExemptReason": null,
  • "taxForgivenSalesAmount": null,
  • "taxForgivenSalesRefundedAmount": null,
  • "taxForgivenAmount": null,
  • "taxForgivenReason": null
}

temperatureUNObject definition

Request Body schema: application/json

details for temperatureUNObject

value
number (temperatureValueType) [ -9999 .. 9999 ]

A numeric value that ranges over the common temperature scales.

temperatureUOM
string (temperatureUNUOMENUMType) <= 3 characters
Enum: "CEL" "FAH"

Temperature units of measure, following UN/ECE Rec 20.

Responses

200
get/temperatureUNObject
/temperatureUNObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": -9999,
  • "temperatureUOM": "CEL"
}

tenderIDObject definition

Request Body schema: application/json

details for tenderIDObject

tenderCode
string or string (tenderCodeEENUMType)

TenderCodes defined by Conexxus (base type).

tenderSubCode
string or string (tenderSubCodeEENUMType)

TenderSubCodes defined by Conexxus (base type).

Responses

200
get/tenderIDObject
/tenderIDObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "tenderCode": "cash",
  • "tenderSubCode": "cash"
}

transactionDetailsObject definition

Request Body schema: application/json

details for transactionDetailsObject

fuelingPointID
required
string (deviceIDType) [ 1 .. 16 ] characters

The identifier for a device which has raised an alert event.

pumpNo
required
integer (pumpNoType) [ 0 .. 9999 ]

pump No is the unique identifier of a pump.

nozzleNo
required
integer (nozzleNoType) [ 0 .. 99 ]

nozzle No is the unique identifier of a nozzle

transactionSeqNo
required
integer (transactionSeqNoType) [ 0 .. 99999999 ]

transactionSeqNo is the unique identifier of a transaction

transactionDate
string <date-time> (dateTimeType) [ 10 .. 30 ] characters
state
string (transactionAvailableStateENUMType) <= 7 characters ^[a-z]{6,7}
Enum: "locked" "payable" "cleared"

transactionAvailableState is used in fdc to identify the different states of an available transaction

releaseToken
string <= 8 characters

It is taken from Dispenser Standard Release Token, which is Bin 8 pattern "[0-9A-F][0-9A-F]"

modeNo
integer (modeNoType) [ 0 .. 99 ]

mode No is an unsigned integer used to identify the different modes to dispatch fuel products, like self service of full

productNo
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

amount
object (monetaryAmount20Object)
volume
object (quantityUNObject)
unitPrice
object (price10Object)
volumeProduct1
object (quantityUNObject)
volumeProduct2
object (quantityUNObject)
productNo1
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

productNo2
integer (productNoType) [ 0 .. 99999999 ]

product No is the unique identification of the product at the service station

blendRatio
integer (integerUnsigned2BaseType) [ 0 .. 99 ]

2 digit numeric value

averageTemperature
object (quantityUNObject)
lockingApplicationSender
string (description100BaseType) <= 100 characters

100 character description.

authorisationApplicationSender
string (description100BaseType) <= 100 characters

100 character description.

DSPFields
string (description100BaseType) <= 100 characters

100 character description.

CRCMode
string (description100BaseType) <= 100 characters

100 character description.

errorCode
string or string <= 40 characters

error code is an string of characters used to identify specific errors of a transaction

Responses

200
get/transactionDetailsObject
/transactionDetailsObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fuelingPointID": "string",
  • "pumpNo": 0,
  • "nozzleNo": 0,
  • "transactionSeqNo": 0,
  • "transactionDate": "2020-06-23T16:37:37Z",
  • "state": "locked",
  • "releaseToken": "string",
  • "modeNo": 0,
  • "productNo": 0,
  • "amount":
    {
    },
  • "volume":
    {
    },
  • "unitPrice":
    {
    },
  • "volumeProduct1":
    {
    },
  • "volumeProduct2":
    {
    },
  • "productNo1": 0,
  • "productNo2": 0,
  • "blendRatio": 0,
  • "averageTemperature":
    {
    },
  • "lockingApplicationSender": "string",
  • "authorisationApplicationSender": "string",
  • "DSPFields": "string",
  • "CRCMode": "string",
  • "errorCode": "ERRCD_OK"
}

volumeUNObject definition

Request Body schema: application/json

details for volumeUNObject

value
required
string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

uom
string (volumeUNUOMENUMType) <= 3 characters
Enum: "MLT" "CMQ" "LTR" "OZA" "OZI" "PT" "PTI" "QT" "QTI" "GLL" "GLI"

Unit of measure indicating volume.

Responses

200
get/volumeUNObject
/volumeUNObject

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "value": "string",
  • "uom": "MLT"
}

BaseTypes

decimal12BaseType definition

Request Body schema: application/json

details for decimal12BaseType

string (decimal12BaseType) <= 18 characters ^\-?[0-9]{0,12}(\.[0-9]{1,5})?$

12,5 decimal value

Responses

200
get/decimal12BaseType
/decimal12BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

decimal16BaseType definition

Request Body schema: application/json

details for decimal16BaseType

string (decimal16BaseType) <= 22 characters ^\-?[0-9]{0,16}(\.[0-9]{1,5})?$

16,5 decimal value

Responses

200
get/decimal16BaseType
/decimal16BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description100BaseType definition

Request Body schema: application/json

details for description100BaseType

string (description100BaseType) <= 100 characters

100 character description.

Responses

200
get/description100BaseType
/description100BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description16BaseType definition

Request Body schema: application/json

details for description16BaseType

string (description16BaseType) <= 16 characters

16 character description.

Responses

200
get/description16BaseType
/description16BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description24BaseType definition

Request Body schema: application/json

details for description24BaseType

string (description24BaseType) <= 24 characters

24 character description.

Responses

200
get/description24BaseType
/description24BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description255BaseType definition

Request Body schema: application/json

details for description255BaseType

string (description255BaseType) <= 255 characters

255 character description.

Responses

200
get/description255BaseType
/description255BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description40BaseType definition

Request Body schema: application/json

details for description40BaseType

string (description40BaseType) <= 40 characters

40 character description.

Responses

200
get/description40BaseType
/description40BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

description4BaseType definition

Request Body schema: application/json

details for description4BaseType

string (description4BaseType) <= 4 characters

4 character description.

Responses

200
get/description4BaseType
/description4BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

description8BaseType definition

Request Body schema: application/json

details for description8BaseType

string (description8BaseType) <= 8 characters

8 character description.

Responses

200
get/description8BaseType
/description8BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

durationBaseType definition

Request Body schema: application/json

details for durationBaseType

string (durationBaseType) <= 20 characters ^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+(\.[0-9]+)?S)?)?$

Responses

200
get/durationBaseType
/durationBaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id16BaseType definition

Request Body schema: application/json

details for id16BaseType

string (id16BaseType) [ 1 .. 16 ] characters

16 character ID

Responses

200
get/id16BaseType
/id16BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id16NBaseType definition

Request Body schema: application/json

details for id16NBaseType

string (id16NBaseType) [ 1 .. 16 ] characters ^[0-9]{1,16}$

16 digit numeric ID

Responses

200
get/id16NBaseType
/id16NBaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id2BaseType definition

Request Body schema: application/json

details for id2BaseType

string (id2BaseType) [ 1 .. 2 ] characters

2 character ID

Responses

200
get/id2BaseType
/id2BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"st"

id3NBaseType definition

Request Body schema: application/json

details for id3NBaseType

string (id3NBaseType) [ 1 .. 3 ] characters ^[0-9]{1,3}$

3 character numberic ID

Responses

200
get/id3NBaseType
/id3NBaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"str"

id40BaseType definition

Request Body schema: application/json

details for id40BaseType

string (id40BaseType) [ 1 .. 40 ] characters

40 character ID

Responses

200
get/id40BaseType
/id40BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id4BaseType definition

Request Body schema: application/json

details for id4BaseType

string (id4BaseType) [ 1 .. 4 ] characters

4 character ID

Responses

200
get/id4BaseType
/id4BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

id4NBaseType definition

Request Body schema: application/json

details for id4NBaseType

string (id4NBaseType) [ 1 .. 4 ] characters ^[0-9]{1,4}$

4 digit numeric ID

Responses

200
get/id4NBaseType
/id4NBaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"stri"

id80BaseType definition

Request Body schema: application/json

details for id80BaseType

string (id80BaseType) [ 1 .. 80 ] characters

80 character ID

Responses

200
get/id80BaseType
/id80BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id8BaseType definition

Request Body schema: application/json

details for id8BaseType

string (id8BaseType) [ 1 .. 8 ] characters

8 character ID

Responses

200
get/id8BaseType
/id8BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

id8NBaseType definition

Request Body schema: application/json

details for id8NBaseType

string (id8NBaseType) [ 1 .. 8 ] characters ^[0-9]{8}$

8 digit numeric ID

Responses

200
get/id8NBaseType
/id8NBaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
"string"

integerUnsigned16BaseType definition

Request Body schema: application/json

details for integerUnsigned16BaseType

integer (integerUnsigned16BaseType) [ 0 .. 10000000000000000 ]

16 digit numeric value

Responses

200
get/integerUnsigned16BaseType
/integerUnsigned16BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

integerUnsigned2BaseType definition

Request Body schema: application/json

details for integerUnsigned2BaseType

integer (integerUnsigned2BaseType) [ 0 .. 99 ]

2 digit numeric value

Responses

200
get/integerUnsigned2BaseType
/integerUnsigned2BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

integerUnsigned3BaseType definition

Request Body schema: application/json

details for integerUnsigned3BaseType

integer (integerUnsigned3BaseType) [ 0 .. 999 ]

3 digit numeric value

Responses

200
get/integerUnsigned3BaseType
/integerUnsigned3BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

integerUnsigned4BaseType definition

Request Body schema: application/json

details for integerUnsigned4BaseType

integer (integerUnsigned4BaseType) [ 0 .. 9999 ]

4 digit numeric value

Responses

200
get/integerUnsigned4BaseType
/integerUnsigned4BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0

integerUnsigned8BaseType definition

Request Body schema: application/json

details for integerUnsigned8BaseType

integer (integerUnsigned8BaseType) [ 0 .. 99999999 ]

8 digit numeric value

Responses

200
get/integerUnsigned8BaseType
/integerUnsigned8BaseType

Request samples

Content type
application/json
Copy
Expand all Collapse all
0