Parameters Explained

Distributor Endpoint - Body Parameters

Data PointDescriptionExample/Options
id

An unique ID that is assigned to a distributor upon creation. This value will not change.

When updating a distributor you'll need to include the ID in the body of the request.

12846edd-a097-491a-a61e-f369e589dc0c
typeThis field lists the type of relationship the distributor has with the client. This field impacts tax calculations for inventoryAccepted Values:
NON_ARMS_LENGTH
ARMS_LENGTH
companyThe name of the distributor company.JIMMY'S DISTRIBUTION
doing_business_asOptional field for entering distributor DBAJ's DISTRO
addressAddress that is associated with the distributor profile.999 Broadway STREET, CA
phonePhone that is associated with the distributor profile.5109876543
emailEmail associated with distributor.[email protected]
default_payment_termdefault payment termPIA
Net 30
lead_timeThe lead time to receiving a delivery from a distributor.10
delivery_daysThis field lists the preferred day of delivery for a distributor.Accepted Values:
MON
TUE
WED
THU
FRI
SAT
SUN
preferred_payment_methodPreferred payment method for the distributorACH
CASH
activeCurrent status of the distributor.true
false
available_creditThe credit that is available for the store for with the distributor.100.00000
licensesArray containing license information for a distributor.
idUnique ID associated with the license of the distributor.84162573-9938-4170-b116-65ef71224774
labelType of licenseDISTRIBUTOR
typeThis field indicates the type of inventory the license can sell.ALL
license_numberLicense number for distributors license.Cl-23413254123
expiration_dateExpiration date associated to the distributor license.2024-09-28T00:00:00.000-07:00
statusThe current status of theactive
inactive

Location Endpoint - Body Parameter

Data PointDescriptionExample/Options
idUnique ID associated to an inventory location.03b2249e-e70a-4ab9-80b8-25bb8c804a81
activeCurrent status of the location and if it is available for use.true
false
inventory_typeThis field lists the inventory types that can be stored at a particular location.ALL
MEDICAL
ADULT
nameName assigned to a particular location.DOWNTOWN-VEHICLE-1
parent_location_idList of parent locations fordee203b0-6ff7-11e9-b685-0280fd4571a6
sellableThis field indicates whether inventory can be sold from this location.true
false

Payment Term Endpoint - Body Parameter

Data PointDescriptionExamples/Options
idA unique ID assigned to the payment term. This value will not change once assigned to a term.636bc474-49b4-11e9-8035-774805423a5c
labelShort name of payment terms.COD
PIA
EOM
payment_dueLong name of payment terms.Cash on Delivery
Pay in Advance
End of Month

Invoice Endpoint - Body Parameter

Data PointDescriptionExamples/Options
id

ID associated to the invoice upon creation. This value will not change once assigned to an invoice.

When updating a invoice you'll need to include the ID in the body of the request.

7edd5430-2ae0-4cb8-91a5-c594bb297a25
visible_idClient facing invoice number.703
total_cost

Read only

This field shows the calculated total cost of the entire invoice.

1080.63
distributor_idID associated to the distributor4fd8c626-b568-4c94-93b5-207470c74978
inventory_locationThe inventory locations that were assigned to the invoice was originally added to Treez. This field is case sensitiveBACK OF HOUSE
inventory_typeMedical: inventory that can only be sold as Medical
Recreational: inventory that can only be sold as Recreational
Custom: Non-cannabis inventory like Merch that can be sold to Medical and Recreational customers
MEDICAL
RECREATIONAL
CUSTOM
external_invoice_idInvoice number from the original vendor invoice. Can be used optionally in addition to the Treez auto-generated invoice number.TF1721827
statusThe current status of the invoice.DRAFT
ACCEPTED
noteNotes associated with an invoice.Example note for an invoice
payment_termsPayment Term Label. Valid payment terms are set to the Delivery Payment Terms Config Page. Use Payment Terms API to retrieve list.COD
created_dateThe inventory locations that have been setup with the Treez instance. Case sensitive2022-10-06T17:59:49.000-07:00
last_updated_dateDate and time the invoice was last updated.2022-10-06T18:18:16.000-07:00
accepted_dateTime and Date of when an invoice was accepted2022-10-06T18:18:16.000-07:00
due_dateDate the invoice is due to the vendor.2022-10-21T00:00:00.000-07:00
discountsInvoice level discount array.
idUnique ID associated with the invoice level discount.4236675d-064c-4254-9b3c-48650aeabb89
labelName of the invoice level discount.Loyal Shop Discount
discount_typeType of invoice level discount.DOLLAR
PERCENTAGE
discount_amountNumber value of the discount.10
feesInvoice level fee array.
idUnique ID associated with the fee level discount.eacfc5c7-9dff-406c-9f98-a95668608c91
labelName of the fee level discount.delivery
fee_typeType of invoice level discount.DOLLAR
fee_amountNumber value of the fee.10
invoice_line_listArray containing the invoice line details
idID for the invoice line level. This ID will not change once assigned to a line item.53a3bcc6-7d95-4cee-9b50-d8a17cdb2513
product_idID of the product that is assigned to the invoice line. You can use the product API to get the details of the product.83ee87ce-dff1-46a8-af39-1ee62dc50e91
quantitytotal weight or units being received for an invoice line item.100.000000
base_cost_unitCost per unit excluding excise tax including fees and discounts.10.000000
excise_tax_unitExcise tax per unit (CALIFORNIA ONLY).1.706250
true_cost_unit

Read only

This field shows the calculated cost per unit excluding excise including discounts

9.100000
total_cost

Read only

This field shows the calculated Total Cost for the invoice line (includes excise)

1080.625000
manifest_numberIncoming Manifest Number00000001x
dispensary_licenseLicense of dispensary receiving the invoice.C23423-LIC
harvest_dateHarvest date of the invoice line item.2022-06-23
received_dateReceived date of the invoice line item.2022-10-06
expiration_dateExpiration date of the invoice line item.2022-10-22
external_batch_idBatch tracking or state compliance tracking ID such as Metrc Package number.180234714793847
barcodeList of scannable barcodes for an invoice line itembgr
discountInvoice line level discount array.
idUnique ID associated with the invoice line level discount.c0f616f2-9ff0-4623-a473-c85a0cf2f8a8
labelName of the invoice line level discount.Invoice Line 5% Discount
discount_typeType of invoice line level discount.DISCOUNT
PERCENTAGE
discount_amountNumber value of the fee.-5
feesInvoice line level fee array.
idUnique ID associated with the invoice line level fee.5a8ae23f-1a2e-4a47-a605-67c01f26c26a
labelName of the invoice line level fee.Invoice Line 25 Fee
fee_typeType of invoice line level fee.DISCOUNT
PERCENTAGE
fee_amountNumber value of the fee.25
open_label_field_1Open field for label maker for an invoice line itemnull
open_label_field_2Open field for label maker for an invoice line itemPREROLL
open_label_field_3Open field for label maker for an invoice line itemnull