Integrity Check

Integrity Checks record individual verification requests where a product code is assessed for authenticity and other fraud conditions. They are typically triggered automatically when a consumer scans a QR code, or manually created by an inspector on a mobile phone with a login in TrackVision. Rules are configurable. We typically look for the following conditions:

• unrecognized where we don't recognize a serial that has been scanned
• unactivated where a serial has not been properly activated/commissioned in an authorized factory
• duplicated where a unique code appeared more than once in physically impossible way
• diverted where a serial is in a market it shouldn't be in

The integrity_check Object

Field Name	Type	Description
id	uuid	Primary key for the integrity check.
user_created	object	User who created the record. Read-only.
date_created	datetime	Timestamp in ISO 8601 when the record was created. Read-only.
user_updated	object	User who last updated the record. Read-only.
date_updated	datetime	Timestamp in ISO 8601 when the record was last updated. Read-only.
check_mode	string	How the code was submitted for checking. One of: scan_code, type_code_manually.
qr_code	string	The QR code or Digital Link value that was subject to the integrity check.
code	string	Internal code reference associated with this check.
address	string	Address or location context at the time of the check.
notes	string	Free-text notes or observations recorded against this check.
result	object	The Integrity Check Result associated with this check.

---

Sub-Objects

User Object (user_created, user_updated)

See Users for the full schema.

Integrity Check Result Object (result)

See Integrity Check Result for the full schema.

---

List Integrity Checks

REST

GET /items/integrity_check

GraphQL

query {
  integrity_check {
    id
    date_created
    check_mode
    qr_code
    result {
      id
      result
      check_source
    }
  }
}

Query Parameters

Supports all global query parameters.

Returns

An array of up to limit integrity check objects. If no items are available, data will be an empty array.

---

Retrieve an Integrity Check

REST

GET /items/integrity_check/:id

GraphQL

query {
  integrity_check_by_id(id: "integrity_check_id") {
    id
    date_created
    check_mode
    qr_code
    code
    address
    notes
    result {
      id
      result
      check_source
      reason
      product {
        id
        product_name
      }
    }
    user_created {
      id
      first_name
      last_name
    }
    user_updated {
      id
      first_name
      last_name
    }
    date_updated
  }
}

Returns

Returns an integrity check object if a valid primary key was provided.

---

Create an Integrity Check

REST

POST /items/integrity_check

{
  "check_mode": "automatic",
  "qr_code": "https://id.gs1.org/01/09521234543217/21/12345678",
  "notes": "Flagged for duplicate scan activity"
}

GraphQL

mutation {
  create_integrity_check_item(data: {
    check_mode: "automatic"
    qr_code: "https://id.gs1.org/01/09521234543217/21/12345678"
    notes: "Flagged for duplicate scan activity"
  }) {
    id
    check_mode
    qr_code
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial integrity check object.

Returns

Returns the integrity check object for the created record.

---

Update an Integrity Check

REST

PATCH /items/integrity_check/:id

{
  "notes": "Reviewed — confirmed suspicious scan pattern"
}

GraphQL

mutation {
  update_integrity_check_item(id: "integrity_check_id", data: {
    notes: "Reviewed — confirmed suspicious scan pattern"
  }) {
    id
    notes
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial integrity check object.

Returns

Returns the integrity check object for the updated record.

---

Delete an Integrity Check

REST

DELETE /items/integrity_check/:id

GraphQL

mutation {
  delete_integrity_check_item(id: "integrity_check_id") {
    id
  }
}

Returns

Empty body.