csv upload user manual (1)cca and ncs csv manual | version 1.0 6 general csv file requirements csv...

CSV USER MANUAL California Cannabis Authority NCS Analytics WWW.CCA.CA.GOV WWW.NCSANALYTICS.COM

1100 K Street, STE 101 Sacramento, CA 95814

916-526-7082

[email protected]

CCA and NCS CSV MANUAL | Version 1.0 2

Disclaimer USE OF THIS DOCUMENT ACKNOWLEDGES AN UNDERSTANDING AND AGREEMENT THAT NCS ANALYTICS IS NOT PROVIDING LEGAL SERVICES NOR IS ACTING AS YOUR LEGAL COUNSEL. INFORMATION PROVIDED IS INTENDED TO ASSIST WITH JURISDICTIONAL COMPLIANCE, SHOULD YOU DECIDE TO USE COMMA SEPARATED VARIABLE (CSV) FILES FOR JURISDICTIONAL COMPLIANCE. JURISDICTIONAL LAWS AND RULES DIFFER TREMENDOUSLY FROM JURISDICTION TO JURISDICTION. WE CANNOT OFFER OPINIONS, RECOMMENDATIONS OR ADVICE REGARDING YOUR COMPLIANCE, OBLIGATIONS, NOR REMEDIES. NCS ANALYTICS DOES NOT APPLY THE LAW TO THE FACTS AND CIRCUMSTANCES OF YOUR PARTICULAR LICENSE. INFORMATION PROVIDED TO NCS ANALYTICS IS NOT PRIVILEGED AND WILL BE DISCLOSED TO YOUR CONTRACTING AGENCY. NCS VALUES AND MAINTAINS PRIVACY, BUT THIS SHOULD NOT BE INTERPRETED TO ESTABLISH CONFIDENTIALITY BETWEEN NCS AND THE CONTRACTING AGENCY. RECOMMENDATIONS ARE NOT JURISDICTION-SPECIFIC. THE CONTENT CONTAINED WITHIN THIS DOCUMENT DISCUSSES GENERAL PRINCIPLES, LAWS, AND PROCEDURES. THE INFORMATION IS NOT SPECIFIC TO ANY PARTICULAR STATE, JURISDICTION OR FINANCIAL INSTITUTION. THE PRINCIPLES, LAWS, AND PROCEDURES MAY BE SIMILAR, SLIGHTLY DIFFERENT, OR DIFFER SIGNIFICANTLY FROM THE INFORMATION PROVIDED BY NCS ANALYTICS. BY CHOOSING TO SEND DATA THROUGH NCS ANALYTICS CSV FILES, IT IS YOUR RESPONSIBILITY TO READ THE LAWS, REGULATIONS AND RULES OF YOUR STATE, JURISDICTION AND/OR FINANCIAL INSTITUTION. EXAMPLES ARE ONLY EXAMPLES. IF AN EXAMPLE IS PORTRAYED, PLEASE NOTE THAT THE RESULTS DESCRIBED ARE DEPENDENT ON THE FACTS OF THE SPECIFIC EXAMPLE AND RESULTS WILL DIFFER IF BASED ON DIFFERENT FACTS. THIS MANUAL OFFERS NO GUARANTEES OF ACCURACY OR COMPLETENESS. INFORMATION PROVIDED IS FOR ASSISTANCE IN PREPARATION OF DATA SUBMISSIONS TO YOUR STATE, JURISDICTION AND/OR FINANCIAL INSTITUTION. LAWS, REGULATIONS, RULES, PROCEDURES, AND CASE DECISIONS ARE SUBJECT TO REVISION, INTERPRETATION, OR EVEN NULLIFICATION BY COURTS AND LEGISLATIVE BODIES AT ANY TIME. INFORMATION PROVIDED IN THIS DOCUMENT MAY NOT REFLECT THE MOST CURRENT VERSION OF THESE MATERIALS. DO NOT RELY ON ANY INFORMATION PROVIDED BY NCS ANALYTICS WITHOUT FIRST DOING YOUR OWN RESEARCH AND INVESTIGATION. YOU AGREE THAT YOU ARE USING THIS INFORMATION PROVIDED BY NCS ANALYTICS AT YOUR OWN RISK. NCS ASSUMES NO LIABILITY AND IS NOT RESPONSIBLE FOR INJURY, LOSS, OR DAMAGE, UNDER ANY TORT OR CONTRACT THEORY RELATED TO YOUR USE OF THIS DOCUMENT AND THE CONTENT PROVIDED HEREIN.


Table of Contents

INTRODUCTION ............................................................................................................................ 5

VERSION TABLE ............................................................................................................................. 5

GENERAL CSV FILE REQUIREMENTS ............................................................................................ 6

CULTIVATION ................................................................................................................................ 7

ID .................................................................................................................................................... 7 TOTALWEIGHT_WEIGHT_GRAMS ........................................................................................................... 7 FLOWER_GRAMS ............................................................................................................................... 8 OPM_GRAMS .................................................................................................................................... 8 WASTE_GRAMS ................................................................................................................................. 9 FRESHPLANT_GRAMS .......................................................................................................................... 9 STRAIN_NAME ................................................................................................................................. 10 HARVESTPLANT_QUANTITY ................................................................................................................ 10 PLANTED_DATE ................................................................................................................................ 10 HARVEST_START_DATE ...................................................................................................................... 11 HARVEST_FINISHED_DATE ................................................................................................................. 11 LICENSEE_STATE .............................................................................................................................. 12 LICENSEE_ZIPCODE .......................................................................................................................... 12 COUNTY_LICENSE_NUMBER .............................................................................................................. 12 STATELICENSE_NUMBER .................................................................................................................... 13

CULTIVATION TRANSFER ............................................................................................................ 13

ID .................................................................................................................................................. 13 FINALPRODUCT_TYPE ....................................................................................................................... 14 RECIPIENT_FACILITY_NAME ............................................................................................................... 15 RECIPIENT_FACILITY_LICENSE_NUMBER ............................................................................................... 15 TRANSFEROUT_QUANTITY .................................................................................................................. 15 EACH_OR_GRAMS .......................................................................................................................... 16 TRANSFERTOTAL_PRICE ..................................................................................................................... 16 HARVEST_DATE ................................................................................................................................ 17 DATE_SHIPPED ................................................................................................................................. 17 ESTIMATED_DATERECEIVED ................................................................................................................ 17 LICENSEE_STATE .............................................................................................................................. 18 LICENSEE_ZIPCODE .......................................................................................................................... 18 COUNTY_LICENSE_NUMBER .............................................................................................................. 19 STATELICENSE_NUMBER .................................................................................................................... 19 TAG_NUMBER ................................................................................................................................. 19


MANUFACTURING ...................................................................................................................... 20

ID .................................................................................................................................................. 20 FINALPRODUCT_TYPE ....................................................................................................................... 21 FINALPRODUCT_WEIGHT ................................................................................................................... 22 FINALPRODUCT_EACH ...................................................................................................................... 22 INTERMEDIARY*_PRODUCT (*1-3) ..................................................................................................... 23 INTERMEDIARY*_WEIGHT (*1-3) ........................................................................................................ 23 MANUFACTURE_STARTDATE ............................................................................................................... 24 MANUFACTURE_ENDDATE ................................................................................................................. 24 LICENSEE_STATE .............................................................................................................................. 24 LICENSEE_ZIPCODE .......................................................................................................................... 25 COUNTY_LICENSE_NUMBER .............................................................................................................. 25 STATELICENSE_NUMBER .................................................................................................................... 26

MANUFACTURING TRANSFER .................................................................................................... 26

ID .................................................................................................................................................. 26 FINALPRODUCT_TYPE ....................................................................................................................... 27 RECIPIENT_FACILITY_NAME ............................................................................................................... 28 RECIPIENT_FACILITY_LICENSE_NUMBER ............................................................................................... 28 TRANSFEROUT_QUANTITY .................................................................................................................. 28 EACH_OR_GRAMS .......................................................................................................................... 29 TRANSFERTOTAL_PRICE ..................................................................................................................... 29 DATE_SHIPPED ................................................................................................................................. 30 ESTIMATED_DATERECEIVED ................................................................................................................ 30 LICENSEE_STATE .............................................................................................................................. 30 LICENSEE_ZIPCODE .......................................................................................................................... 31 COUNTY_LICENSE_NUMBER .............................................................................................................. 31 STATELICENSE_NUMBER .................................................................................................................... 32 TAG_NUMBER ................................................................................................................................. 32

RETAIL .......................................................................................................................................... 33

ID .................................................................................................................................................. 33 PRODUCT_TYPE ............................................................................................................................... 33 SALES_QUANTITY ............................................................................................................................. 34 EACH_OR_GRAMS .......................................................................................................................... 34 SALETOTAL_PRICE ............................................................................................................................ 35 START_DATE .................................................................................................................................... 35 END_DATE ...................................................................................................................................... 36 LICENSEE_STATE .............................................................................................................................. 36 LICENSEE_ZIPCODE .......................................................................................................................... 37 COUNTY_LICENSE_NUMBER .............................................................................................................. 37 STATELICENSE_NUMBER .................................................................................................................... 37


Introduction NCS Analytics provides data aggregation and analysis services to state and local government agencies that rely on collecting data from multiple sources including their licensees. Data can be provided either manually via a file template provided by the agency or programmatically via a point-of-sale (POS) software system. Most cannabis licensees choose an automated, or programmatic method, through their approved POS provider and most jurisdictions require an automated process unless exceptions are granted. Licensees with a granted exception can use the comma separated variable (CSV) file templates described in this document. Column-by-column instructions are provided below to explain the data that is required to populate the templates. For additional information, please contact your local reporting agency.

Version Table Version 1.0 Released April 2019


General CSV File Requirements CSV files can be generated with applications such as Microsoft Excel, Google Sheets, and text programs such as Notepad, to name a few. There are a few general requirements that hold true across all CSV file formats.

• All files must be saved in a CSV format o Sometimes referred to as CSV UTF-8 o Must be comma delimited

§ There are several ways to delimit values (comma, space, semicolon, quotations, etc.)

§ Example of comma delimited: 1480000000001001,1480000000018025,2,STRAINNAME1,ETC

§ This is often a setting in your spreadsheet application • All files need to have headers on the top row that exactly match the templates

provided by your jurisdiction • All rows need to have an identification number (id)

o Identification numbers need to be whole-digit integers o Identification numbers can only have numbers

§ No letters § No symbols or special characters like #, _ , “”, . , - , etc.

• Certain fields require certain data types o Much like identification numbers needing to be whole-digit integers, other

fields have specific formats o Example of this is when asking for a state, it is assumed to be a two-letter

postal code like CA, MI, CO, etc. whereas zip code fields require five-digit numbers

o Note that if a number starts with a zero, and you are using a spread-sheet application like Microsoft Excel or Google Sheets, applying an apostrophe in front of the zero will retain the value

• Formatting, such as bolding, colors, are not retained in a CSV file • A CSV is a single worksheet or spreadsheet. Separated tabs within a spreadsheet

are not saved when CSV file is created • Files must be submitted each week

o Cultivators: it is required that a blank form is sent until a harvest is complete. You will include license, state(s) and zip code(s) on the blank form.


Cultivation This form is used to provide information about the harvest process. It is intended to be filled out at the end of the harvest (at the time of “packaging” for transfer out). Your jurisdiction requires that you to submit a Cultivation form on a weekly basis, in which case you will submit a blank form with each of your licenses, state(s) and zip code(s) on it until a harvest is finished. Once a harvest is finished, you will send a completed form. NCS recommends beginning this sheet at the time when you first start the growing process. That way, you can start recording the number of plants being planted, then harvested, and their initial wet-weight. id

• Explanation: An id is a way to identify the row number. • Format: Whole-digit integer • Unit of Measurement: N/A • Examples:

o 1,2,3,4,99,10001 • Restrictions: Must be unique within the file, so you can’t repeat numbers

(example, you can’t have multiple ids be 1). • Recommendations: The easiest way to accomplish unique rows is to increase

each row in value. • Example:

o 1,2,3,4 • Unacceptable formats:

o Lot#123-456 o 100.1 o A1200 o 500-321 o Id1 o <null> or blank

totalweight_weight_grams

• Explanation: This is the first weight measurement of the harvest. Some systems call this measurement “wet weight.” As soon as the plant(s) get cut from their roots, this measurement would be recorded.

• Format: Float • Unit of Measurement: Grams • Examples:

o 1 o 100.1584 o 6.5 o 10000.4514156

• Restrictions: Must be greater than zero. Can’t be zero.


• Recommendations: Weigh and record at the time the plant is cut from the roots. • Unacceptable formats:

o 0 o 0.000 o -12.15 o 15 grams o <null> or blank

flower_grams

• Explanation: This is one of the final weight measurements of the harvest. When the harvest is ready for packaging, record the flower (bud) output packaged or ready to package for transfer. This is the dry product.


o 1 o 100.1584 o 6.5 o 10000.451

• Restrictions: At least one of flower_grams, opm_grams, waste_grams or freshplant_grams need to be recorded.

• Recommendations: Weigh and record at the time the product is ready to be packaged for transfer.

• Unacceptable formats: o 0 o 0.000 o -12.15 o 15 grams

opm_grams

• Explanation: This is one of the final weight measurements of the harvest. When the harvest is ready for packaging, record the other plant material (OPM) output packaged or ready to package for transfer. OPM would contain materials like leaf, stems, kief, trimmings, etc. Only include OPM generated during harvest.


o 1 o 100.1584 o 6.5 o 10000.451


• Recommendations: Weigh and record at the time the product is packaged or ready to be packaged for transfer.

• Unacceptable formats:


o 0 o 0.000 o -12.15 o 15 grams

waste_grams

• Explanation: This is one of the final weight measurements of the harvest. When the harvest is ready for packaging, record the waste destroyed or ready for destruction. Only include waste generated during harvest.

• Format: float • Unit of Measurement: Grams • Examples:

o 1 o 100.1584 o 6.5 o 10000.451


• Recommendations: Weigh and record continuously throughout the harvest process. The amount that should recorded is the aggregated amount throughout the harvest.


freshplant_grams

• Explanation: This type of measurement is used when harvests are “flash cured.” This should only be used when, after cutting the plant from its roots, the freshly cut plant is transferred or packaged for transfer immediately.


o 1 o 100.1584 o 6.5 o 10000.451


• Recommendations: Weigh and record when the product is packaged or ready to be packaged for transfer.



strain_name

• Explanation: This is your internally named strain. • Format: String • Examples:

o Bubba Kush o Sour Diesel o Strain #1 o Batch Tags 1000.23141 – 23414.123

• Restrictions: This is a required field. • Recommendations: This field is used to help keep your records for each strain of

plants separate. • Unacceptable formats:

o <null> or blank harvestplant_quantity

• Explanation: This is the number of plants in the harvest by strain. This is the recording of the number of plants cut from their roots.

• Format: Integer • Unit of Measurement: Each • Examples:

o 1 o 2 o 3 o 500

• Restrictions: This is a required field and can only be a number. • Recommendations: Record the number of plants at the time the plants are cut

from the roots. • Unacceptable formats:

o -23 o 6.5 o 7 plants o <null> or blank

planted_date

• Explanation: This identifies when the plants were planted either by seed or by clone.

• Format: Date (mm/dd/yyyy) • Unit of Measurement: N/A • Examples:

o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The planted_date must occur before the harvest_started_date and the harvest_finished_date.

• Recommendations: Record the date the seeds or clones are planted.


• Unacceptable formats: o 13/6/1900 o Jan-7 o January 21, 2019 o <null> or blank

harvest_start_date

• Explanation: This is the date the plants were cut from the roots. It’s officially the start of the harvest period.


o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The harvest_start_date must occur before the harvest_finished_date and after the planted_date.

• Recommendations: Best practice would be to record this date in the form on the day you harvest as you will not submit it until later.


harvest_finished_date

• Explanation: This is the date the harvest is completed. Harvest completion for this purpose would be defined as when the product is either packaged for transfer or when it is ready to be packaged for transfer.


o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The harvest_finished_date must occur after the planted_date and harvest_start_date.

• Recommendations: Best practice would be to record this date in the form on the day you finish your curing process. You will have collected all the necessary dates and be prepared to submit the form.



licensee_state • Explanation: This is the state in which your license is held. • Format: Two letters • Unit of Measurement: N/A • Examples:

o CA o MI o RI o DC

• Restrictions: These are restricted to the US Postal Service two-letter state postal codes. It must match your license information on file with the reporting jurisdiction.

• Recommendations: N/A • Unacceptable formats:

o California o 01 o Tex o D.C. o N.Y. o <null> or blank

licensee_zipcode

• Explanation: This is the zip code where your license is held • Format: five-digit integer • Unit of Measurement: N/A • Examples:

o 80202 o 01701 o 95116

• Restrictions: This must be a five-digit integer. It must match your license information on file with the reporting jurisdiction.

• Recommendations: If the leading digit of your zip code is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘01701).

• Unacceptable formats: o 54731-1234 o 4321 o <null> or blank

county_license_number

• Explanation: This is your county assigned license number. • Format: String • Unit of Measurement: N/A • Examples:

o TEMP-1651841 o 1354.845


o Wc4tve6745 o 00324.12

• Restrictions: Either county_license_number or statelicense_number is required. The license number must identically match the records of the jurisdiction. If you do not have your County License number or do not know it, please submit with only your state license number.

• Recommendations: We have found that statelicense_number tends to be easier to use for consistency. If the leading digit of your county_license_number is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘001100.12). It is recommended that you reach out to the licensing jurisdiction to get the appropriate license number and corresponding format.

• Unacceptable formats: N/A statelicense_number

• Explanation: This is your state assigned license number. • Format: String • Unit of Measurement: N/A • Examples:

o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12

• Recommendations: We have found that statelicense_number tends to be easier to use for consistency-sake. If the leading digit of your statelicense_number is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘001100.12). It is recommended that you reach out to the licensing jurisdiction to get the appropriate license number and corresponding format.

• Unacceptable formats: N/A

Cultivation Transfer Once a harvest is completed, it is often transferred to a different licensee for sale. These transfers can be internal (vertically-integrated) or external. This form is not a replacement for your jurisdiction’s requirements for manifests, but it serves a similar purpose. id



o 1 o 2 o 3 o 4 o 99 o 100001

• Restrictions: Must be unique within the file, so you can’t repeat numbers (example, you can’t have multiple ids be 1).

• Recommendations: The easiest way to accomplish unique rows is to increase each row in value.

• Examples: o 1 o 2 o 3 o 4

• Unacceptable formats: o Lot#123-456 o 100.1 o A1200 o 500-321 o Id1 o <null> or blank

finalproduct_type

• Explanation: This is a pre-defined list of items that can be transferred out of your licensed facility. The list is mandated by the jurisdiction.

• Format: String • Unit of Measurement: N/A • Examples: See restrictions for validated list. • Restrictions: Only the following list are acceptable inputs for this field:

o flower o fresh_cannabis_plant o immature_plant o kief o leaf o other

• Recommendations: The following ‘definitions’ are intended to be recommendations and do not supersede legal definitions:

o flower – dry cannabis product. This is also known as ‘bud’. o fresh_cannabis_plant –the wet plant that was cut from the roots and

immediately packaged for transfer o immature_plant – clones o kief –the crystals that cover the cannabis flower o leaf –the leaf, stems or other plant materials (OPM) that are often used in

manufacturing product o other –the catch-all for product not previously mentioned in the above list

• Unacceptable formats:


o Flowers o Clones o Stems o OPM o Waste o <null> or blank

recipient_facility_name

• Explanation: This is the name of the recipient who you are transferring product to. This can be company name or specific location name.

• Format: String • Unit of Measurement: N/A • Examples:

o Joes Company o 123 Main Street LLC o Distributor X o Jimmy Manufacturing facility 1 – East Side

• Restrictions: None • Recommendations: This should match the location listed on your manifests. • Unacceptable formats:

o <null> or blank

recipient_facility_license_number • Explanation: This is the state license number of the recipient who you are

transferring product to. • Format: String • Unit of Measurement: N/A • Examples:

o TEMP16-242525 o 125-1erg-regtbf-MGA o CDHPE-GF953453-345523.2432

• Restrictions: None • Recommendations: This should match the license number listed on your

manifests. • Unacceptable formats:

o <null> or blank transferout_quantity

• Explanation: This is the amount of product that is being transferred • Format: Float • Unit of Measurement: N/A – described in next section • Examples:

o 1231.1584 o 6 o 14621.15684

• Restrictions: This must be greater than zero. • Recommendations: This should match the quantities on your manifests.


• Unacceptable formats: o 100 grams o Six o 0 o <null> or blank

each_or_grams

• Explanation: This identifies the unit of measurement for the transferout_quantity • Format: string • Unit of Measurement: each or grams • Examples:

o each o Each o Grams o grams

• Restrictions: The only accepted inputs are ‘each’ or ‘grams’. • Recommendations: Depending on the product, there should be logical inputs for

this field. It would be expected that: o flower – grams o fresh_cannabis_plant – grams o immature_plant – each o kief – grams o leaf – each o other – varies

• Unacceptable formats: o ea o gr o oz o Ounces o Ml o <null> or blank

transfertotal_price

• Explanation: This is the amount to be billed to the recipient for the product being transferred excluding taxes.

• Format: float • Unit of Measurement: Dollars • Examples:

o 0 o .01 o 213.21 o $55

• Restrictions: Must be greater than zero. • Recommendations: Submit the file only when a final transfer price is known. • Unacceptable formats:

o -500 o –


harvest_date

• Explanation: This is intended to be the harvest’s ending date. Harvest end date tends to be the date of packaging or when the product is ready to package.


o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The harvest_date must occur before the date_shipped and the estimated_datereceived.

• Recommendations: Best practice would be to record this as the packaged date. • Unacceptable formats:

o 13/6/1900 o Jan-7 o January 21, 2019 o <null> or blank

date_shipped

• Explanation: This is the ‘transfer out’ date when the product leaves your facility or transfers to a different licensee.


o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The date_shipped must occur on or before the estimated_datereceived and on or after harvest_date.

• Recommendations: Best practice would be to match this to the shipping manifest.


estimated_datereceived

• Explanation: This is the expected date of receipt by the licensee accepting your product.


o 01/16/2018 o 1/9/2019 o 1/9/19


• Restrictions: The estimated_datereceived must occur on or after the date_shipped and the harvest_date.

• Recommendations: Best practice would be to match this to the shipping manifest.


licensee_state

• Explanation: This is the state in which your license is held. • Format: Two letters • Unit of Measurement: N/A • Examples:

o CA o MI o RI o DC




licensee_zipcode

• Explanation: This is the zip code where your license is held. • Format: five-digit integer • Unit of Measurement: N/A • Examples:

o 80202 o 01701 o 95116



• Unacceptable formats: o 54731-1234


o 4321 o <null> or blank



o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12





o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12

• Restrictions: Either county_license_number or statelicense_number is required. The license number must identically match the records of the jurisdiction.

• Recommendations: We have found that statelicense_number tends to be easier to use for consistency. If the leading digit of your statelicense_number is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘001100.12). It is recommended that you reach out to the licensing jurisdiction to get the appropriate license number and corresponding format.

• Unacceptable formats: N/A tag_number

• Explanation: Any tag(s) you assign to the transferred package.



o Wef-sdf23-232-fs o 1354.845 o Wc4tve6745 o 00324.12

• Restrictions: None • Recommendations: Usually a Metrc tag or some other tracking tag. • Unacceptable formats: N/A

Manufacturing This form should be used to provide data about the manufacturing process. It is intended to be filled out at the end of the manufacturing process, at the time of “packaging” for transfer out. For the purposes of this form, the manufacturing process is defined as converting a cannabis product to a new product or packaging a cannabis product for distribution or retail sale. Examples of manufactured products would be:

• Flower -> extracted to oil -> packaged as a vape cartridge • Leaf -> extracted to oil -> infused in to an edible • Fresh cannabis plant material -> extracted to oil -> infused into a topical

Manufactured products have an ingredient or ingredients as inputs that turn into a final product. At the end of the manufacturing process, final products are generally transferred from the manufacturing licensee to a distributor or retail establishment for sale to the consumer. This step uses the Manufacturing Transfer CSV template form, which is explained in the next section. id


o 1 o 2 o 3 o 4 o 99 o 100001




• Example: o 1 o 2 o 3 o 4


finalproduct_type

• Explanation: This is the final manufactured product. • Format: String • Unit of Measurement: N/A • Examples: See restrictions • Restrictions: Manufactured final products are defined by the jurisdiction. The

current list of acceptable final products: o capsule_tablet o concentrate_liquid o concentrate_solid o edibles o extract_liquid o extract_solid o flower o fresh_cannabis_plant o immature_plant o kief

o leaf o liquid o preroll_flower o preroll_leaf o suppository o tincture o topical o vape_oil o other

• Recommendations: Best judgement should be used in deciding the final product type. If in doubt, please contact your regulatory jurisdiction. Please also note that if a final product type is packaged as a weight-based product and a count-based product, then the final product type should be listed on two separate lines (one for weight-based and one for count-based). An example of this would be edibles, say popcorn. You can pre-package popcorn in a bag as an each. However, you can also sell a bulk bag of popcorn which would be sold by weight. Either way is acceptable.

• Unacceptable formats: o edibles o flowers o buds o preroll joints o clones o concentrate


o preroll flower o <null> or blank

finalproduct_weight

• Explanation: This should be used for any weight-based products. It is the weight of the final product.


o 1 o 100.1584 o 6.5 o 10000.451

• Restrictions: Only one between finalproduct_weight or finalproduct_each needs to be recorded.

• Recommendations: Products that are typically weight-based are listed below, but there can be exceptions:

o concentrate_liquid o concentrate_solid o extract_liquid o extract_solid o flower o fresh_cannabis_plant

o kief o leaf o liquid o vape_oil o other

• Unacceptable formats: o 0 o 0.000 o -12.15 o 15 grams o 10 ml

finalproduct_each

• Explanation: This should be used for any quantity-based products. It is the ‘each’ count of the final product.

• Format: Integer • Unit of Measurement: Each • Examples:

o 1 o 100 o 7

• Restrictions: Only one between finalproduct_weight or finalproduct_each needs to be recorded.

• Recommendations: Products that are typically quantity-based are listed below, but there can be exceptions:

o capsule_tablet o concentrate_liquid o concentrate_solid

o edibles o extract_liquid o extract_solid


o immature_plant o liquid o preroll_flower o preroll_leaf o suppository

o tincture o topical o vape_oil o other

• Unacceptable formats: o 1.5 o 0.000 o -12.15 o 15 cartridges o 6-pack

intermediary*_product (*1-3)

• Explanation: These are the ingredients referenced above that go in to the final product. These are cannabis products only.

• Format: String • Unit of Measurement: N/A • Examples: See restriction list • Restrictions: For every finalproduct_type, at least one intermediary is required.

Only items on this list can be accepted: o capsule_tablet o concentrate_liquid o concentrate_solid o edibles o extract_liquid o extract_solid o flower o fresh_cannabis_plant o immature_plant o kief


• Recommendations: Best judgement should be used in listing an ingredient. • Unacceptable formats: Anything not on the restricted list.

intermediary*_weight (*1-3)

• Explanation: This is the amount of intermediary product used in the manufacturing process


o 1 o 100.1584 o 6.5 o 10000.451

• Restrictions: Every finalproduct_type requires at least one intermediary product. For every intermediary product, a weight is required.

• Recommendations: • Unacceptable formats:


o 0 o 0.000 o -12.15 o 15 grams

manufacture_startdate

• Explanation: This identifies when the manufacturing process started. • Format: Date (mm/dd/yyyy) • Unit of Measurement: N/A • Examples:

o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The manufacture_startdate must occur before the manufacture_enddate.

• Recommendations: For purposes of this CSV submittal, manufacture_startdate is the first date the conversions are taking place. Planning and preparing for manufacturing conversions would not be included.


manufacture_enddate

• Explanation: This is the date the manufacturing process is completed. • Format: Date (mm/dd/yyyy) • Unit of Measurement: N/A • Examples:

o 01/16/2018 o 1/9/2019 o 1/9/19

• Restrictions: The manufacture_startdate must occur before the manufacture_enddate.

• Recommendations: For purposes of this CSV submittal, manufacture_enddate is the date the conversions are complete. Best judgement and consistency should be used when determining whether packaging should be included within the manufacture date range.


licensee_state

• Explanation: This is the state in which your license is held.


• Format: Two letters • Unit of Measurement: N/A • Examples:

o CA o MI o RI




licensee_zipcode


o 80202 o 01701 o 95116






o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12






o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12




Manufacturing Transfer Generally, once the manufacturing process is completed, manufactured product is often transferred to a different licensee for sale. These transfers can be internal (vertically-integrated) or external. This form is not a replacement for your jurisdiction’s requirements for manifests, but it serves a similar purpose. id

• Explanation: An id is a way to identify the row number. • Format: Whole-digit integer • Unit of Measurement: N/A


• Examples: o 1 o 2 o 3 o 4 o 99 o 100001





finalproduct_type

• Explanation: This is the final manufactured product that is being transferred out. • Format: String • Unit of Measurement: N/A • Examples: See restrictions • Restrictions: Manufactured final products are defined by the jurisdiction. The

current list of acceptable final products: o capsule_tablet o concentrate_liquid o concentrate_solid o edibles o extract_liquid o extract_solid o flower o fresh_cannabis_plant o immature_plant o kief


• Recommendations: Best judgement should be used in deciding the final product type. If in doubt, please contact your regulatory jurisdiction.

• Unacceptable formats: o edibles o flowers o buds


o preroll joints o clones o concentrate o preroll flower o <null> or blank

recipient_facility_name

• Explanation: This is the name of the recipient of the product being transferred. This can be company name or specific location name.


o Joes Company o 123 Main Street LLC o Distributor X o Jimmys Manufacturing facility 1 – East Side

• Restrictions: None • Recommendations: This should match the location listed on your manifests. • Unacceptable formats:

o <null> or blank recipient_facility_license_number

• Explanation: This is the state license number of the recipient of the product. • Format: String • Unit of Measurement: N/A • Examples:

o TEMP16-242525 o 125-1erg-regtbf-MGA o CDHPE-GF953453-345523.2432

• Restrictions: None • Recommendations: This should match the license number listed on your

manifests. • Unacceptable formats:

o <null> or blank

transferout_quantity

• Explanation: This is the amount of product that is being transferred. • Format: Float • Unit of Measurement: N/A – described in next section • Examples:

o 1231.1584 o 6 o 14621.15684

• Restrictions: This must be greater than zero. • Recommendations: This should match the quantities on your manifests. • Unacceptable formats:


o 100 grams o Six o 0 o <null> or blank

each_or_grams

• Explanation: This identifies the unit of measurement for the transferout_quantity. • Format: string • Unit of Measurement: each or grams • Examples:


• Restrictions: The only accepted inputs are ‘each’ or ‘grams’. • Recommendations: Depending on the product, there should be logical inputs for

this field. It would be expected that: o capsule_tablet - each o flower – grams o fresh_cannabis_plant – grams o immature_plant – each o preroll_flower – each o preroll_leaf – each o suppository - each o kief – grams o leaf – each o other – varies


transfertotal_price

• Explanation: This is the amount to be billed to the recipient of the product. • Format: float • Unit of Measurement: Dollars • Examples:

o 0 o .01 o 213.21 o 100,000.00 o $55

• Restrictions: Must be greater than zero. • Recommendations: Submit the file only when a final transfer price is known.


• Unacceptable formats: o -500 o –

date_shipped

• Explanation: This is the ‘transfer out’ date when the product leaves your facility or transfers to a different licensee.


o 01/16/2018 o 1/9/2019 o 1/4/19

• Restrictions: The date_shipped must occur on or before the estimated_datereceived.

• Recommendations: Best practice is matching this date to the shipping manifest. • Unacceptable formats:


estimated_datereceived

• Explanation: This is the expected date of receipt by the licensee accepting your product.


o 01/16/2018 o 1/9/2019 o 1/4/19

• Restrictions: The estimated_datereceived must occur on or after the date_shipped.

• Recommendations: Best practice is matching this date to the shipping manifest. • Unacceptable formats:


licensee_state


o CA o MI


o RI o DC




licensee_zipcode


o 80202 o 01701 o 95116






o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12






o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12



• Unacceptable formats: N/A tag_number

• Explanation: This would be any tag(s) you assign to the transferred package. • Format: String • Unit of Measurement: N/A • Examples:

o Wef-sdf23-232-fs o 1354.845 o Wc4tve6745 o 00324.12

• Restrictions: None • Recommendations: This is usually a Metrc tag or some other tracking tag. • Unacceptable formats: N/A


Retail This is the process of selling the cannabis products to the consumer. Your weekly transactions are expected to be recorded. Most retail establishments sell a variety of products. The reporting jurisdiction is only interested in cannabis and cannabis-infused-products being sold. Most jurisdictions ask for weekly submittals. In this case, you would total the amount sold over the course of the week. id


o 1 o 2 o 3 o 4 o 99 o 100001





product_type

• Explanation: This is the product being sold. • Format: String • Unit of Measurement: N/A • Examples: See restrictions • Restrictions: This list is defined by the jurisdiction. The current list of acceptable

retail products: o capsule_tablet o concentrate_liquid

o concentrate_solid o edibles


o extract_liquid o extract_solid o flower o fresh_cannabis_plant o immature_plant o kief o leaf o liquid

o preroll_flower o preroll_leaf o suppository o tincture o topical o vape_oil o other

• Recommendations: Best judgement should be used in deciding what your final product type is. If in doubt, please contact your regulatory jurisdiction. A reminder that only cannabis products need to be listed.

• Unacceptable formats: o edibles o flowers o buds o preroll joints o clones o concentrate o preroll flower o <null> or blank

sales_quantity

• Explanation: This is the amount of product that was dispensed. • Format: Float • Unit of Measurement: N/A – described in next section (each_or_grams) • Examples:

o 1231.1584 o 6 o 14621.15684

• Restrictions: This must be greater than zero. • Recommendations: This should match the quantities on your receipts. • Unacceptable formats:

o 100 grams o Six o 0 o <null> or blank

each_or_grams

• Explanation: This identifies the unit of measurement for the sales_quantity. • Format: string • Unit of Measurement: each or grams • Examples:


• Restrictions: The only accepted inputs are ‘each’ or ‘grams’.


• Recommendations: Depending on the product, there should be logical inputs for this field. It would be expected that:

o capsule_tablet - each o flower – grams o fresh_cannabis_plant – grams o immature_plant – each o preroll_flower – each o preroll_leaf – each o suppository - each o kief – grams o leaf – each o other – varies


saletotal_price

• Explanation: This is the amount collected for the sale of the goods. • Format: float • Unit of Measurement: Dollars • Examples:

o 0 o .01 o 213.21 o 100,000.00 o $55

• Restrictions: Must be greater than zero. • Recommendations: None • Unacceptable formats:

o -500 o – o <null> or Blank

start_date

• Explanation: This identifies when the sales period starts. • Format: Date (mm/dd/yyyy) • Unit of Measurement: N/A • Examples:

o 01/16/2018 o 1/9/2019 o 1/4/19

• Restrictions: The start_date must occur before the end_date.


• Recommendations: If a jurisdiction is requesting you report on a weekly basis, then this would be the start of the week.


end_date

• Explanation: This identifies when the sales period ends. • Format: Date (mm/dd/yyyy) • Unit of Measurement: N/A • Examples:

o 01/16/2018 o 1/9/2019 o 1/4/19

• Restrictions: The end_date must occur after the start_date. • Recommendations: If a jurisdiction is requesting you report on a weekly basis,

then this would be the end of the week. • Unacceptable formats:


licensee_state


o CA o MI o RI o DC





licensee_zipcode • Explanation: This is the zip code where your license is held. • Format: five-digit integer • Unit of Measurement: N/A • Examples:

o 80202 o 01701 o 95116






o TEMP-1651841 o 1354.845 o Wc4tve6745 o 00324.12


• Recommendations: We have found that statelicense_number tends to be easier to use for consistency-sake. If the leading digit of your county_license_number is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘001100.12). It is recommended that you reach out to the licensing jurisdiction to get the appropriate license number and corresponding format.



o TEMP-1651841


o 1354.845 o Wc4tve6745 o 00324.12


• Recommendations: We have found that statelicense_number tends to be easier to use for consistency-sake. If the leading digit of your statelicense_number is a zero, oftentimes spreadsheet software such as Microsoft Excel will omit the zero. To ensure the zero is retained in spreadsheets, an apostrophe should be placed before the first zero (‘001100.12). It is recommended that you reach out to the licensing jurisdiction to get the appropriate license number and corresponding format.


csv upload user manual (1)cca and ncs csv manual | version 1.0 6 general csv file requirements csv...

Documents