Skip to content

Limited
Get packaging specifications by IDs

Request

Returns multiple packaging specifications (identity + chapter refs) in a single call. Maximum 50 IDs per request.

Security
oauth2(Required scopes: t1_api)
Bodyapplication/jsonrequired
specificationIdsArray of strings, (uuid), [ 1 .. 50 ] itemsrequired
curl -i -X POST \
  https://apis.traceone.com/spec/v2/packaging/specifications/collection \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "specificationIds": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'

Responses

Returns the requested packaging specifications

Bodyapplication/json
Array [
specificationIdstring, (uuid)read-only
namestring or null
Example:"Cardboard Box - Organic Cereal 500g"
templateIdstring, (uuid)
ownerCompanyIdstring, (uuid)read-only
ownerUserIdstring, (uuid)

The user of the owner company who owns the specification

supplierCompanyIdstring, (uuid)
languageCodestring or null
Example:"en-US"
reasonForThisVersionstring or null
statusstring(SpecificationStatus)read-only

Lifecycle status of a specification version. Draft: not yet in progress. InProgress: being filled. ValidatedBySupplier / ValidatedByRetailer: validated by that party. LockedForSupplierSignature / LockedForRetailerSignature: locked while that party signs. SignedBySupplier / SignedByRetailer: signed by that party. InRevisionBySupplier / InRevisionByRetailer: reopened for revision by that party.

Enum:"Draft""InProgress""ValidatedBySupplier""ValidatedByRetailer""LockedForSupplierSignature""LockedForRetailerSignature""SignedBySupplier""SignedByRetailer""InRevisionBySupplier""InRevisionByRetailer"
sharedWithCompanyIdsArray of strings, (uuid)read-only

Companies with access to the specification: the owner always, the supplier once the specification has been shared (POST .../share).

contactsArray of objects(SpecificationPartyContact)read-only

Contacts of both parties

versionobject(ObjectVersion)
creationDateUtcstring, (date-time)read-only
lastUpdateDateUtcstring, (date-time)read-only
signaturesobject or null(SpecificationSignatures)read-only

The signature of this specification version. Absent (null) until a signature process starts.

libraryLinkedChaptersArray of objects(LinkedChapter)read-only

Library chapters linked to the specification (empty when none)

packagingobject or null(PackagingSystemReference)read-only

The linked packaging system; null when none is linked

]
Response
[
  {
    "specificationId": "df380d59-2906-4417-bec3-4ac4567b1960",
    "name": "Cardboard Box - Organic Cereal 500g",
    "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",
    "ownerCompanyId": "10e96248-c873-4e93-b748-bc36e39510eb",
    "ownerUserId": "283eeac5-beea-465a-80a5-763009480d0f",
    "supplierCompanyId": "60e634ac-9cf5-4a73-a6b6-1e5d15116468",
    "languageCode": "en-US",
    "reasonForThisVersion": "string",
    "status": "Draft",
    "sharedWithCompanyIds": [ … ],
    "contacts": [ … ],
    "version": { … },
    "creationDateUtc": "2019-08-24T14:15:22Z",
    "lastUpdateDateUtc": "2019-08-24T14:15:22Z",
    "signatures": { … },
    "libraryLinkedChapters": [ … ],
    "packaging": { … }
  }
]