Produkter & Funktioner

Definiera vad du säljer. Skapa produkter med en eller flera varianter och koppla återanvändbara funktioner för behörighetsbaserad åtkomstkontroll.

Proyecta Commerce använder tre koncept: produkter, varianter och funktioner.

• Produkt — det du säljer (t.ex. “Pro-plan”, “T-shirt”, “Strategisamtal”)
• Variant — en prisnivå eller konfiguration av en produkt (t.ex. “Pro Månadsvis 29 $”, “Pro Årsvis 290 $”, “T-shirt – Stor”)
• Funktion — en återanvändbar behörighetsnyckel som din app kontrollerar vid körning (t.ex. pro_features, unlimited_projects, api_access)

En produkt kan ha flera varianter. En produkt har också en eller flera resurser kopplade till sig — vanligtvis funktioner — som ger tillgång när en kund prenumererar.

Två sätt att modellera vad du säljer

Commerce komponeras med resten av plattformen, så det finns två former för “något du säljer” — och Proyecta väljer rätt åt dig:

• Commerce-nativa produkter — prenumerationer, planer, engångsuppgraderingar och funktioner/behörigheter. Definieras direkt i Admin > Commerce > Products. Det här är modellen som resten av den här sidan beskriver.
• En innehållsbaserad butikskatalog — varor med foton, priser och beskrivningar som en företagsägare redigerar dagligen. Dessa finns i CMS som en säljbar samling: varje post är produkten. När en post publiceras väver Proyecta automatiskt in den i Commerce som en riktig, köpbar produkt — skapar produkten och dess prissatta variant åt dig och kopierar priset direkt från innehållsfältet. Butiken visar innehållets pris och kassan debiterar den länkade varianten, och eftersom de delar en enda källa kan de aldrig avvika från varandra. Du hanterar dessa artiklar som innehåll (i din apps Admin, i builderns eller på din publicerade webbplats), inte under Commerce > Products. Se Innehållshantering.

En vanlig katalog som inte tar kortbetalningar — en meny enbart för surfning, eller en butik vars “köp”-knapp öppnar en WhatsApp-beställningslänk — är bara vanligt innehåll — en vanlig katalogsamling utan Commerce-integrering. Kortutcheckning är det som gör en samling säljbar.

Skapa en produkt

I Admin > Commerce > Products, klicka på Create product (eller fråga AI:n: "Create a Pro plan at $29/month and a Business plan at $99/month."). Varje produkt behöver:

• Ett visningsnamn (t.ex. “Pro”)
• Minst en variant

Varianter

Varje variant har sin egen prissättning:

Fält	Anteckningar
name	Visningsetikett för varianten (“Monthly”, “Annual”, “Large”)
currency	Trebokstavlig ISO-kod — USD, EUR, GBP, JPY, BRL, MXN, INR… (130+ stöds)
unit_amount	Pris i minsta valutaenhet (ören/cent). 2900 = 29,00 $
recurring	Valfritt — { interval: 'week' | 'month' | 'year' }. Utelämna för engångspriser. Daglig fakturering stöds inte för närvarande.
is_default	Accepteras men tillämpas inte ännu — val av standardvariant är inte implementerat för närvarande.
media	Koppla bilder eller videor via CDN-fil-ID (se Filer)

Prissättning är oföränderlig. När en variant väl har skapats kan dess pris inte ändras — skapa en ny variant istället. Detta skyddar befintliga prenumeranter från oavsiktliga prisändringar.

Funktioner (behörigheter)

Funktioner är den grundläggande åtkomstkontrollprimitivet. Skapa en funktion en gång i Admin > Commerce > Products och koppla den sedan till en eller flera produkter. Varje funktion har ett namn, en valfri beskrivning och en nyckel — gemener, siffror och understreck (t.ex. pro_features) — som är det din app kontrollerar mot.

När du skapar en produkt kopplar du funktioner till den via “resurser”. Kunder som prenumererar på en produkt får tillgång till alla funktioner som är kopplade till den.

Sedan, i din app, styr åtkomsten baserat på den nyckeln:

const { hasAccess, isLoading } = useEntitlement('pro_features');

if (isLoading) return <Spinner />;
if (!hasAccess) return <UpgradePrompt />;
return <ProOnlyThing />;

Kontrollen körs på serversidan mot den inloggade sessionen och kan därför inte förfalskas från webbläsaren. Se Integrera Commerce i min app för det fullständiga mönstret.

Obs! Styr alltid åtkomsten baserat på funktionens nyckel — sluggen som härleds från funktionsnamnet (t.ex. pro_features) — inte funktionens interna id.

Det här är hur du begränsar Pro-exklusiva sidor, API-endpoints eller funktioner i din appkod.

Vanliga produktformer

SaaS-prenumerationer

Create products: Free ($0/month), Pro ($29/month, $290/year), Business ($99/month, $990/year).
Attach a 'pro_features' feature to Pro and Business so I can gate access in my code.

Fysiska varor

Create a T-shirt product with three variants: Small, Medium, Large at $25 each.

Digitala varor

Create a course product with a single one-time variant at $149.

Donationer

Create a donation product with three variants: $25, $50, $100 — all one-time.

Lagerhantering

Proyecta Commerce spårar för närvarande inte lagersaldon för fysiska produkter. Om du säljer lagerförda artiklar hanterar du lagersaldon i din apps databas och kontrollerar dem i ditt utcheckningsflöde.

Kommer snart

• Anpassning av utcheckningsfält — samla in ytterligare information från köpare
• Betala vad du vill-prissättning
• Inbyggd lagerhantering för fysiska produkter