tsh-pricing
TSH定价逻辑与Zoho Inventory价格册。使用时:(1) 在任何页面上显示产品价格,(2) 处理不同价格清单(消费者、批发、技术、零售),(3) 为公共用户和认证用户实施价格显示,(4) 调试"请联系获取价格"问题,(5) 向新组件添加定价功能,(6) 理解客户价格清单分配
📖 中文导读:TSH定价逻辑与Zoho Inventory价格册。使用时:(1) 在任何页面上显示产品价格,(2) 处理不同价格清单(消费者、批发、技术、零售),(3) 为公共用户和认证用户实施价格显示,(4) 调试"请联系获取价格"问题,(5) 向新组件添加定价功能,(6) 理解客户价格清单分配 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: tsh-pricing description: | TSH pricing logic with Zoho Inventory pricebooks. Use when: (1) Displaying product prices on any page (2) Working with different price lists (Consumer, Wholesale, Technical, Retail) (3) Implementing price display for public vs authenticated users (4) Debugging "Contact for price" issues (5) Adding pricing to new components (6) Understanding customer price list assignment
TSH Pricing Rules
Golden Rule
NEVER display item.rate (base sell price from Zoho)
ALWAYS fetch price from the appropriate pricebook
If item NOT in pricebook → show "Contact for price"
Price List IDs (MEMORIZE)
| ID | Name | Currency | Use Case |
|---|---|---|---|
2646610000049149103 |
Consumer | IQD | Public visitors (DEFAULT) |
2646610000004453985 |
Retailor | USD | Retail shops |
2646610000057419683 |
Technical IQD | IQD | Technicians (IQD) |
2646610000045742089 |
Technical USD | USD | Technicians (USD) |
2646610000004152175 |
Wholesale A | USD | Cash wholesale (نقدي) |
2646610000004453961 |
Wholesale B | USD | Credit wholesale (اجل) |
Code Constants
// src/lib/zoho/price-lists.ts
import { PRICE_LIST_IDS, PRICE_LIST_INFO } from '@/lib/zoho/price-lists';
PRICE_LIST_IDS.CONSUMER // '2646610000049149103'
PRICE_LIST_IDS.RETAILOR // '2646610000004453985'
PRICE_LIST_IDS.TECHNICAL_IQD // '2646610000057419683'
PRICE_LIST_IDS.TECHNICAL_USD // '2646610000045742089'
PRICE_LIST_IDS.WHOLESALE_A // '2646610000004152175'
PRICE_LIST_IDS.WHOLESALE_B // '2646610000004453961'
Price Selection Logic
Public Visitors (Not Logged In)
const priceListId = PRICE_LIST_IDS.CONSUMER; // Always IQD
Authenticated Users
import { getZohoCustomerByEmail } from '@/lib/zoho/customers';
const customer = await getZohoCustomerByEmail(session.user.email);
const priceListId = customer?.price_list_id || PRICE_LIST_IDS.CONSUMER;
Fetching Prices
Get Full Pricebook
import { getPriceList } from '@/lib/zoho/price-lists';
const pricebook = await getPriceList(PRICE_LIST_IDS.CONSUMER);
// Returns: { pricebook_id, name, currency_code, pricebook_items: [...] }
Get Price for Single Item
import { getPriceForItem } from '@/lib/zoho/price-lists';
const { price, currency, inPriceList } = await getPriceForItem(
itemId,
PRICE_LIST_IDS.CONSUMER
);
if (!inPriceList) {
// Show "Contact for price"
}
Display Component
'use client';
import { useTranslations } from 'next-intl';
interface PriceDisplayProps {
price: number;
currency: string;
inPriceList: boolean;
}
export function PriceDisplay({ price, currency, inPriceList }: PriceDisplayProps) {
const t = useTranslations('products');
if (!inPriceList) {
return (
<span className="text-muted-foreground">
{t('contactForPrice')}
</span>
);
}
return (
<span className="text-lg font-bold">
{price.toLocaleString()} {currency}
</span>
);
}
Product Card with Pricing
interface Product {
id: string;
name: string;
price: number;
currency: string;
inPriceList: boolean;
}
export function ProductCard({ product }: { product: Product }) {
const t = useTranslations('products');
return (
<Card>
<CardContent>
<h3>{product.name}</h3>
{product.inPriceList ? (
<span className="text-lg font-bold">
{product.price.toLocaleString()} {product.currency}
</span>
) : (
<span className="text-muted-foreground">
{t('contactForPrice')}
</span>
)}
</CardContent>
</Card>
);
}
Shop Page Pattern
// src/app/[locale]/(public)/shop/page.tsx
import { PRICE_LIST_IDS, getPriceList } from '@/lib/zoho/price-lists';
import { getAllProductsComplete } from '@/lib/zoho/products';
export default async function ShopPage() {
const [products, pricebook] = await Promise.all([
getAllProductsComplete(),
getPriceList(PRICE_LIST_IDS.CONSUMER),
]);
// Create price lookup map
const priceMap = new Map();
pricebook.pricebook_items?.forEach((item: any) => {
priceMap.set(item.item_id, {
price: item.pricebook_rate,
currency: pricebook.currency_code,
});
});
// Enrich products
const productsWithPrices = products.map(p => ({
...p,
price: priceMap.get(p.item_id)?.price || 0,
currency: priceMap.get(p.item_id)?.currency || 'IQD',
inPriceList: priceMap.has(p.item_id),
}));
return <ProductsContent products={productsWithPrices} />;
}
Troubleshooting
| Issue | Cause | Fix |
|---|---|---|
| All "Contact for price" | Token rate limited | Check Upstash Redis env vars |
| Wrong prices | Wrong pricebook ID | Verify priceListId |
| Missing items | Not in pricebook | Add in Zoho Inventory |
| Wrong currency | Wrong pricebook | Check PRICE_LIST_IDS |
Debug Commands
# Check if prices fetch correctly
curl "https://www.tsh.sale/api/debug/prices"
# Revalidate price cache
curl "https://www.tsh.sale/api/revalidate?tag=price-lists&secret=tsh-revalidate-2024"
Checklist for Pricing Features
- Import
PRICE_LIST_IDSfrom@/lib/zoho/price-lists - Determine correct price list (public vs authenticated)
- Fetch pricebook with
getPriceList() - Handle
inPriceList: falsecase - Display "Contact for price" translation
- Show correct currency (IQD or USD)