Create a lookup value | Distru Documentation

Adds a value to one of your named lists, such as a product tag, category, group or payment method. Only a payment method reaches QuickBooks.

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
type	enum `PRODUCT_SUBCATEGORYCOMPANY_GROUPRELATIONSHIP_TYPEPRODUCT_TAGPRODUCT_GROUPPRODUCT_CATEGORYPAYMENT_METHOD`	Yes
name	string	Yes	Up to 255 characters (31 for PAYMENT_METHOD). Unique within the type and company (within the category for PRODUCT_SUBCATEGORY); case is ignored except for RELATIONSHIP_TYPE and COMPANY_GROUP, where "flower" and "Flower" can both exist.
paymentMethodType	enum `BANK_REMITTANCEBANK_TRANSFERCASHCHECKCREDIT_CARD`	No	PAYMENT_METHOD only. Required.
officialProductCategoryId	enum `CAPSULESCLONESCONCENTRATESEDIBLESFLOWERMERCHOTHERPREROLLSTINCTURESTOPICALSVAPES`	No	PRODUCT_CATEGORY only. Required.
productCategoryId	string	No	PRODUCT_SUBCATEGORY only. Required. Resolve via distru-search-lookups (type PRODUCT_CATEGORY).

Output

This tool returns one of 7 shapes, depending on its inputs.

Presence on a nested field assumes its parent exists.

Result with tag

Field	Type	Presence
tag	object	Always
tag.id	string	Always
tag.name	string	Always

Result with productGroup

Field	Type	Presence
productGroup	object	Always
productGroup.id	string	Always
productGroup.name	string	Always

Result with paymentMethod

Field	Type	Presence
paymentMethod	object	Always
paymentMethod.id	string	Always
paymentMethod.name	string	Always
paymentMethod.type	enum `BANK_REMITTANCEBANK_TRANSFERCASHCHECKCREDIT_CARD`	Can be null

Result with relationshipType

Field	Type	Presence
relationshipType	object	Always
relationshipType.id	string	Always
relationshipType.name	string	Always

Result with productCategory

Field	Type	Presence
productCategory	object	Always
productCategory.id	string	Always
productCategory.name	string	Always
productCategory.officialProductCategoryId	string	Can be null

Result with productSubcategory

Field	Type	Presence
productSubcategory	object	Always
productSubcategory.id	string	Always
productSubcategory.name	string	Always
productSubcategory.category	object	Always
productSubcategory.category.id	string	Always

Result with companyGroup

Field	Type	Presence
companyGroup	object	Always
companyGroup.id	string	Always
companyGroup.name	string	Always

What the AI reads

Creates one of the company’s named lists other records point at, picked by type: PRODUCT_TAG, PRODUCT_GROUP, PAYMENT_METHOD, RELATIONSHIP_TYPE, PRODUCT_CATEGORY, PRODUCT_SUBCATEGORY, COMPANY_GROUP. Use distru-search-lookups first to avoid creating a duplicate. Each type only takes its own extra fields (see each field’s description); others are rejected. Unit types are not created here; resolve an existing one with distru-search-lookups (type UNIT_TYPE).