Skip to main content

WCIA Transfer Data Schema

Version 2.1.0​

Transfer Data Schema​

Table of Contents​

  • Legend
  • Fields Guide
  • Resources

Legend​

Ln #  Schema
----  --------------------------------------
1.     {
2.       "document_name": "string",
3.       "document_schema_version": "string",
4.       "document_origin": "string",
5.       "from_license_number": "string",
6.       "from_license_name": "string",
7.       "to_license_number": "string",
8.       "to_license_name": "string",
9.       "to_license_type": "string",
10.      "transporter_name": "string",
11.      "transporter_license": "string",
12.      "manifest_type": "enum['delivery', 'pick-up', 'transporter']",
13.      "created_at": "string[ISO8601 datetime]",
14.      "updated_at": "string[ISO8601 datetime]",
15.      "transferred_at": "string[ISO8601 datetime]",
16.      "integrator_data": "string",
17.      "transfer_id": "string",
18.      "est_departed_at": "string[ISO8601 datetime]",
19.      "est_arrival_at": "string[ISO8601 datetime]",
20.      "route": "string",
21.      "inventory_transfer_items": [
22.        {
23.          "created_at": "string['ISO datetime']",
24.          "updated_at": "string['ISO datetime']",
25.          "external_id": "string",
26.          "is_sample": "bool['0', '1']",
27.          "sample_type": "enum['null', 'educational', 'qa', 'non-mandatory qa', 'vendor']",
28.          "product_name": "string",
29.          "qty": "numeric",
30.          "unit_weight": "float|decimal",
31.          "serving_weight": "float|decimal[OPTIONAL]",
32.          "line_price": "string['currency']",
33.          "uom": "enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']",
34.          "unit_weight_uom": "enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']",
35.          "inventory_id": "string",
36.          "sample_source_id": "string",
37.          "is_medical": "bool['0', '1']",
38.          "is_for_extraction": "bool['0', '1']",
39.          "lab_result_passed": "enum['null', 'pass', 'fail']",
40.          "lab_result_link": "string[URI]",
41.          "lab_result_data": {
42.            "lab_result_id": "",
43.            "lab_result_status": "enum['pass', 'fail']",
44.            "lab_result_detail": "string[URI]",
45.            "coa": "string[URI]",
46.            "lab_result_list": [
47.              {
48.                "coa": "string[URI]",
49.                "lab_result_id: "string",
50.                "lab_result_status: "pass" or "fail",
51.                "lab_result_link": "NULL | string[URI]",
52.                "coa_release_date": "string", //ISO8601 Date Only
53.                "coa_amended_date": "NULL | string", //ISO8601 Date Only
54.                "coa_expire_date": "NULL | string" //ISO8601 Date Only
55.              }
56.            ],
57.            "potency": [
58.              {
59.                "type":"string",
60.                "value": "float|decimal",
61.                "unit": "enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']"
62.              }
63.            ]
64.        },
65.        "inventory_category": "string",
66.        "inventory_type": "string",
67.        "strain_name": "string",
68.        "product_sku": "string"
69.        }
70.      ]
71.    }

Fields Guide

Document Name​

  • Field Name: document_name
  • Type: string
  • Description:
    • The "title" of the document, always displaying "WCIA Transfer Data Schema".
  • Legend: Ln 2

Document Schema Version​

  • Field Name: document_schema_version
  • Type: string
  • Description:
    • The version of WCIA Transfer Data Schema used for the object.
  • Legend: Ln 3

Document Origin​

  • Field Name: document_origin
  • Type: string
  • Description:
    • A URL referencing the document's originating source.
  • Legend: Ln 4

From License Number

  • Field Name: from_license_number
  • Type: string
  • Description:
    • License number of the entity submitting the transfer.
  • Legend: Ln 5

From License Name

  • Field Name: from_license_name
  • Type: string
  • Description:
    • Business name of the entity submitting the transfer.
  • Legend: Ln 6

To License Number

  • Field Name: to_license_number
  • Type: string
  • Description:
    • License number of the entity receiving the transfer.
  • Legend: Ln 7

To License Name

  • Field Name: to_license_name
  • Type: string
  • Description:
    • Business name of the entity receiving the transfer.
  • Legend: Ln 8

To License Type (optional)

  • Field Name: to_license_type
  • Type: string
  • Description:
    • Optional field. This could be "producer," "processor," etc.
  • Legend: Ln 9

Transporter Name

  • Field Name: transporter_name
  • Type: string
  • Description:
    • Name of the representative physically transporting the transfer's material contents.
  • Legend: Ln 10

Transporter License

  • Field Name: transporter_license
  • Type: string
  • Description:
    • State issued license number.
  • Legend: Ln 11

Manifest Type

  • Field Name: manifest_type
  • Type: enum['delivery', 'pick-up', 'transporter']
  • Description:
    • An enum field. The options are "delivery," "pick-up," or "transporter"
  • Legend: Ln 12

Created At

  • Field Name: created_at
  • Type: string[ISO8601 datetime]
  • Description:
    • An ISO8601 DateTime stamp of transfer creation.
  • Legend: Ln 13

Updated At

  • Field Name: updated_at
  • Type: string[ISO8601 datetime]
  • Description:
    • An ISO8601 DateTime stamp of transfer update.
  • Legend: Ln 14

Transferred At (optional)

  • Field Name: transferred_at
  • Type: string[ISO8601 datetime]
  • Description:
    • Optional field. An ISO8601 DateTime stamp of the actual transfer datetime.
  • Legend: Ln 15

Integrator Data

  • Field Name: integrator_data
  • Type: string
  • Description:
    • A designated string for dynamic data that is integrator specific.
  • Legend: Ln 16

Transfer ID

  • Field Name: transfer_id
  • Type: string
  • Description:
    • A sender-assigned identifier representing the transfer object.
  • Legend: Ln 17

Estimated Departed At

  • Field Name: est_departed_at
  • Type: string[ISO8601 datetime]
  • Description:
    • An ISO8601 DateTime stamp of estimated transport departure.
  • Legend: Ln 18

Estimated Arrival At

  • Field Name: est_arrival_at
  • Type: string[ISO8601 datetime]
  • Description:
    • An ISO8601 DateTime stamp of estimated transport arrival.
  • Legend: Ln 19

Route (optional)

  • Field Name: route
  • Type: string
  • Description:
    • Optional field. A text string providing basic transport route information between the sending and receving entities.
  • Legend: Ln 20

Inventory Transfer Items

  • Field Name: inventory_transfer_items
  • Type: array
  • Description:
    • An array of transfer item objects.
  • Legend:** Ln 21**

Inventory Transfer Items -> Created At​

  • Field Name: created_at
  • Type: string['ISO datetime']
  • Description:
    • An ISO8601 DateTime stamp of inventory transfer item creation.
  • Legend: Ln 23

Inventory Transfer Items -> Updated At​

  • Field Name: updated_at
  • Type: string['ISO datetime']
  • Description:
    • An ISO8601 DateTime stamp of inventory transfer item update.
  • Legend: Ln 24

Inventory Transfer Items -> External Id (optional)​

  • Field Name: external_id
  • Type: string
  • Description:
    • Optional field. A vendor system identifier.
  • Legend: Ln 25

Inventory Transfer Items -> Is Sample​

  • Field Name: is_sample
  • Type: bool['0', '1']
  • Description:
    • A boolean string: zero for false, and one for true.
  • Legend: Ln 26

Inventory Transfer Items -> Sample Type​

  • Field Name: sample_type
  • Type: enum['null', 'educational', 'qa', 'non-mandatory qa', 'vendor']
  • Description:
    • Designates the transfer item's types as informed by the WAC. The options are "null," "educational," "qa," "non-mandatory qa," and "vendor."
  • Legend: Ln 27

Inventory Transfer Items -> Product Name​

  • Field Name: product_name
  • Type: string
  • Description:
    • A licensee-assigned name for the transferring item.
  • Legend: Ln 28

Inventory Transfer Items -> Qty​

  • Field Name: qty
  • Type: string['float|decimal']
  • Description:
    • A string formatted as a float|decimal, representing the contents of a package.
  • Legend: Ln 29

Inventory Transfer Items -> Unit Weight​

  • Field Name: unit_weight
  • Type: string['float|decimal']
  • Description:
    • A string formatted as a float|decimal, representing the weight of a single unit.
  • Legend: Ln 30

Inventory Transfer Items -> Unit Weight (optional)​

  • Field Name: serving_weight
  • Type: string['float|decimal']
  • Description:
    • A string formatted as a float|decimal, representing the units per serving.
  • Legend: Ln 31

Inventory Transfer Items -> Line Price​

  • Field Name: line_price
  • Type: string['currency']
  • Description:
    • A string formatted as currency, representing the line total. This figure is calculated as quantity * unit_price
  • Legend: Ln 321

Inventory Transfer Items -> UoM​

  • Field Name: uom
  • Type: enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']
  • Description:
    • An enum field representing one of the following possible meausre abbreviations: 'ml,' 'mg,' 'g,' 'oz,' 'lb,' 'ea,' 'kg.' This value provides the standardized unit by which the item was measured.
  • Legend: Ln 33

Inventory Transfer Items -> Unit Weight UoM​

  • Field Name: unit_weight_uom
  • Type: enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']
  • Description:
    • An enum field representing one of the following possible meausre abbreviations: 'ml,' 'mg,' 'g,' 'oz,' 'lb,' 'ea,' 'kg.' This value represents the "each" version of the UoM field.
  • Legend: Ln 34

Inventory Transfer Items -> Inventory ID​

  • Field Name: inventory_id
  • Type: string
  • Description:
    • A vendor system assigned unique identifier representing the inventory from which the items were sampled.
  • Legend: Ln 35

Inventory Transfer Items -> Sample Source ID​

  • Field Name: sample_source_id
  • Type: string
  • Description:
    • A vendor system assigned unique identifier representing the source inventory from which the items were sampled.
  • Legend: Ln 36

Inventory Transfer Items -> Is Medical​

  • Field Name: is_medical
  • Type: bool['0', '1']
  • Description:
    • A boolean string: zero for false, and one for true. This field flags a transfer item as having medical requirements.
  • Legend: Ln 37

Inventory Transfer Items -> Is for Extraction​

  • Field Name: is_for_extraction
  • Type: bool['0', '1']
  • Description:
    • A boolean string: zero for false, and one for true. This field flags a transfer item as designated for extraction.
  • Legend: Ln 38

Inventory Transfer Items -> Lab Result Passed​

  • Field Name: lab_result_passed
  • Type: enum['null', 'pass', 'fail']
  • Description:
    • An enum field representing the pass/fail status of the lab result for this item. Options are null, "pass," and "fail."
  • Legend: Ln 39

Inventory Transfer Items -> Lab Result Link​

  • Field Name: lab_result_link
  • Type: string[URI]
  • Description:
    • A link to the laboratory Certificate of Analysis.
  • Legend: Ln 40

Inventory Transfer Items -> Lab Result Data​

  • Field Name: lab_result_data
  • Type: object['nullable']
  • Description: *
  • Legend: Ln 41

Inventory Transfer Items -> Lab Result Data -> Lab Result ID​

  • Field Name: Lab_result_id
  • Type: ****
  • Description:
    • The result ID assigned by the laboratory.
  • Legend: Ln 42

Inventory Transfer Items -> Lab Result Data -> Lab Result Status​

  • Field Name: Lab_result_status
  • Type: enum['null', 'pass', 'fail']
  • Description:
    • An enum field representing the pass/fail status of the lab result for this item. Options are null, "pass," and "fail."
  • Legend: Ln 43

Inventory Transfer Items -> Lab Result Data -> Lab_result_detail​

  • Field Name: Lab_result_detail
  • Type: string['URI']
  • Description:
    • A URL to the WCIA Lab Result Link.
  • Legend: Ln 44

Inventory Transfer Items -> Lab Result Data -> CoA​

  • Field Name: Coa
  • Type: string['URI']
  • Description:
    • A URL to the Lab result Certificate of Analysis.
  • Legend: Ln 45

Inventory Transfer Items -> Lab Result Data -> Lab Result List​

  • Field Name: lab_result_list
  • Type: array['metric object']
  • Description:
    • An array of objects containing coa objects.
  • Legend: Ln 46

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> CoA​

  • Field Name: Coa
  • Type: string['URI']
  • Description:
    • A URL to the Lab result Certificate of Analysis.
  • Legend: Ln 48

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> Lab Result ID​

  • Field Name: lab_result_id
  • Type: string[URI]
  • Description:
    • Lab issued sample ID.
  • Legend: Ln 49

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> Lab Result Status​

  • Field Name: lab_result_status
  • Type: string[URI]
  • Description:
    • A "pass" or "fail" string field provided by the Lab.
  • Legend: Ln 50

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> Lab Result Detail​

  • Field Name: lab_result_detail
  • Type: string[URI]
  • Description:
    • A URL to the WCIA Lab Result Link.
  • Legend: Ln 51

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> Lab Result Link​

  • Field Name: lab_result_link
  • Type: string[URI]
  • Description:
    • A link to the lab results WCIA json object.
  • Legend: Ln 51

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> CoA Release Date​

  • Field Name: coa_release_date
  • Type: NULL | string
  • Description:
    • An ISO8601 Date String (e.g. 2022-01-01) representing the date the Lab released results.
  • Legend: Ln 52

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> CoA Amended Date​

  • Field Name: coa_amended_date
  • Type: NULL | string
  • Description:
    • An ISO8601 Date String (e.g. 2022-01-01) representing the date the Lab released Amended results.
  • Legend: Ln 53

Inventory Transfer Items -> Lab Result Data -> Lab Result List -> CoA Expire Date​

  • Field Name: coa_expire_date
  • Type: NULL | string
  • Description:
    • An ISO8601 Date String (e.g. 2022-01-01) representing the date the Lab rresults expire.
  • Legend: Ln 54

Inventory Transfer Items -> Lab Result Data -> Potency​

  • Field Name: Potency
  • Type: array['metric object']
  • Description:
    • An array of metric objects. Specifically, cannabinoid analytes required for compliance testing in WA state.
  • Legend: Ln 57

Inventory Transfer Items -> Lab Result Data -> Potency -> Type​

  • Field Name: type
  • Type: string
  • Description:
    • The name of the cannabinoid analyzed. For example, "cbda," "thca," and "total-cannabinoids."
  • Legend: Ln 59

Inventory Transfer Items -> Lab Result Data -> Potency -> Value​

  • Field Name: value
  • Type: float|decimal
  • Description:
    • A float|decimal value representing the quantity of the analyte reported.
  • Legend: Ln 60

Inventory Transfer Items -> Lab Result Data -> Potency -> Unit​

  • Field Name: unit

  • Type: enum['ml', 'mg', 'g', 'oz', 'lb', 'ea', 'kg']

  • Description:

    • An enum field representing one of the following possible meausre abbreviations: 'ml,' 'mg,' 'g,' 'oz,' 'lb,' 'ea,' 'kg.'

  • Legend: Ln 61

Inventory Transfer Items -> Inventory Category​

  • Field Name: inventory_category
  • Type: string
  • Description:
    • For purposes of Washington State, this is most commonly the State-assigned types such as "EndProduct."
  • Legend: Ln 65

Inventory Transfer Items -> Inventory Type​

  • Field Name: inventory_type
  • Type: string
  • Description:
    • For purposes of Washington State, this is most commonly the State-assigned types such as "Flower Lot."
  • Legend: Ln 66

Inventory Transfer Items -> Strain Name​

  • Field Name: strain_name
  • Type: string
  • Description:
    • The licensee-assigned name of the plant material being transferred.
  • Legend: Ln 67

Inventory Transfer Items -> Product SKU (optional)​

  • Field Name: product_sku
  • Type: string
  • Description:
    • A sender-assigned product SKU code in string format.
  • Legend: Ln 68

Resources​