Jump to

• Request
• Response

Update Workstation Devices

post

/config/sim/v2/devices/workstations/updateDevices

Updates a Workstation Device record for the current organization.

Request

Supported Media Types

• application/json
• multipart/form-data

Header Parameters

• Simphony-AuditTrailRef: string
  Detail that identifies, who made the change.

Body ()

A request body

Root Schema : schema

Type: object

Show Source

• baudRate: integer
  Baud Rate of the device. Allowed values - 1200, 2400, 4800, 9600, 19200, 38400. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.

  Example: 9600
• clientCertCommonName: string
  Client certificate common name of the payment interface

  Example: Certificate
• clientCertEffectiveDt: string
  Client Certificate effective date of the payment interface

  Example: 2020-10-11
• clientCertExpDt: string
  Expiration date of the client certificate of the payment interface

  Example: 2020-10-11
• clientCertificate: string
  Client Certificate object. Applicable only for type=20 and SPI

  Example: Cert
• clientCertPassword: string
  Client Certificate password

  Example: password
• comPort: integer
  COM Port of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.

  Example: 1
• configuration: string
  Configuration parameters of the custom peripheral device

  Example: config
• customDevice: integer
  Device type of the custom peripheral device

  Example: 1
• customDeviceSettingsConfig: string
  Configuration parameters of the peripheral device

  Example: Custom Settings
• dataBits: integer
  Data bits of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.

  Example: 1
• deleteCertificate: boolean
  A flag indicating if the certificates need to be deleted. Applicable for type=20 and for SPI only.

  Example: false
• deviceNum(required): integer
  Sequence number of the device

  Example: 1
• deviceType(required): integer
  Type of the peripheral device

  Example: 1
• hierUnitId(required): integer
  Unique hierarchy unit value of the property

  Example: 1
• hostTimeoutInSecs: integer
  Timeout in seconds if request is abandoned. This is a required field for device type 20.

  Example: 180
• objectNum(required): integer
  Object number of the workstation

  Example: 1
• parity: string
  Parity of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.

  Example: N
• primaryHost: string
  URL of the endpoint. Format http(s)://host:port number. This is a required field for device type 20.

  Example: http://url.domain.com:443
• progId(required): string
  Prog Id of the custom peripheral device

  Example: Micros.Devices.BarCodeReader.RS232
• securitySettings: integer
  Security settings for the interface. This is a required field for device type 20.

  Example: 1
• serverCertCommonName: string
  Common name of the Server Certificate

  Example: cert
• serverCertEffectiveDt: string
  Effective date of the server certificate

  Example: 2020-10-11
• serverCertExpDt: string
  Expiration date of the server certificate

  Example: 2020-10-11
• serverCertificate: string
  Server certificate object

  Example: cert
• stopBits: integer
  Stop Bits of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.

  Example: 1
• validateXMLAgainstSchema: boolean
  A Boolean flag indicating if xml message is validated against schema and log errors. Applicable only for type=20 and SPI.

  Example: false

{
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum",
        "deviceNum",
        "deviceType",
        "progId"
    ],
    "properties":{
        "hierUnitId":{
            "description":"Unique hierarchy unit value of the property",
            "type":"integer",
            "example":1
        },
        "objectNum":{
            "description":"Object number of the workstation",
            "type":"integer",
            "example":1
        },
        "deviceNum":{
            "description":"Sequence number of the device",
            "type":"integer",
            "example":1
        },
        "deviceType":{
            "description":"Type of the peripheral device",
            "type":"integer",
            "example":1
        },
        "comPort":{
            "description":"COM Port of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.",
            "type":"integer",
            "example":1
        },
        "baudRate":{
            "description":"Baud Rate of the device. Allowed values - 1200, 2400, 4800, 9600, 19200, 38400. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.",
            "type":"integer",
            "example":9600
        },
        "parity":{
            "description":"Parity of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.",
            "type":"string",
            "example":"N"
        },
        "dataBits":{
            "description":"Data bits of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.",
            "type":"integer",
            "example":1
        },
        "stopBits":{
            "description":"Stop Bits of the device. This is a required field for the following device types - 1, 2, 3, 5, 8, 10, 12, 13, 14, 15(progId - Micros.Devices.FingerPrintReader.Opos), 16 and 17.",
            "type":"integer",
            "example":1
        },
        "customDeviceSettingsConfig":{
            "description":"Configuration parameters of the peripheral device",
            "type":"string",
            "example":"Custom Settings"
        },
        "customDevice":{
            "description":"Device type of the custom peripheral device",
            "type":"integer",
            "example":1
        },
        "progId":{
            "description":"Prog Id of the custom peripheral device",
            "type":"string",
            "example":"Micros.Devices.BarCodeReader.RS232"
        },
        "configuration":{
            "description":"Configuration parameters of the custom peripheral device",
            "type":"string",
            "example":"config"
        },
        "clientCertCommonName":{
            "description":"Client certificate common name of the payment interface",
            "type":"string",
            "example":"Certificate"
        },
        "clientCertEffectiveDt":{
            "description":"Client Certificate effective date of the payment interface",
            "type":"string",
            "example":"2020-10-11"
        },
        "clientCertExpDt":{
            "description":"Expiration date of the client certificate of the payment interface",
            "type":"string",
            "example":"2020-10-11"
        },
        "clientCertPassword":{
            "description":"Client Certificate password",
            "type":"string",
            "example":"password"
        },
        "deleteCertificate":{
            "description":"A flag indicating if the certificates need to be deleted. Applicable for type=20 and for SPI only.",
            "type":"boolean",
            "example":false
        },
        "hostTimeoutInSecs":{
            "description":"Timeout in seconds if request is abandoned. This is a required field for device type 20.",
            "type":"integer",
            "example":180
        },
        "clientCertificate":{
            "description":"Client Certificate object. Applicable only for type=20 and SPI",
            "type":"string",
            "example":"Cert"
        },
        "serverCertificate":{
            "description":"Server certificate object",
            "type":"string",
            "example":"cert"
        },
        "primaryHost":{
            "description":"URL of the endpoint. Format http(s)://host:port number. This is a required field for device type 20.",
            "type":"string",
            "example":"http://url.domain.com:443"
        },
        "securitySettings":{
            "description":"Security settings for the interface. This is a required field for device type 20.",
            "type":"integer",
            "example":1
        },
        "serverCertCommonName":{
            "description":"Common name of the Server Certificate",
            "type":"string",
            "example":"cert"
        },
        "serverCertEffectiveDt":{
            "description":"Effective date of the server certificate",
            "type":"string",
            "example":"2020-10-11"
        },
        "serverCertExpDt":{
            "description":"Expiration date of the server certificate",
            "type":"string",
            "example":"2020-10-11"
        },
        "validateXMLAgainstSchema":{
            "description":"A Boolean flag indicating if xml message is validated against schema and log errors. Applicable only for type=20 and SPI.",
            "type":"boolean",
            "example":false
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Workstation Device Updated .

Body ()

Root Schema : schema

Type: object

Show Source

• deviceNum: integer
  The sequence number of the device

  Example: 1
• hierUnitId: integer
  Unique hierarchy unit value of the property

  Example: 1
• objectNum: integer
  Object number of the workstation

  Example: 1

{
    "type":"object",
    "properties":{
        "hierUnitId":{
            "description":"Unique hierarchy unit value of the property",
            "type":"integer",
            "example":1
        },
        "objectNum":{
            "description":"Object number of the workstation",
            "type":"integer",
            "example":1
        },
        "deviceNum":{
            "description":"The sequence number of the device",
            "type":"integer",
            "example":1
        }
    }
}

Back to Top