API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · wholesale_pricings

Wholesale Pricing Schema

Schema-ID
wholesale_pricing
Collection
wholesale_pricings
Permissions
  • Lesenwholesale_pricing_view
  • Anlegenwholesale_pricing_create
  • Ändernwholesale_pricing_edit
  • Löschenwholesale_pricing_delete

Felder

Wholesale Pricing Schema

wholesale_pricings4 Permissions

MSP resell-pricing config for wholesale customer-tenants. One default per MSP (customerTenantId=null) plus optional per-customer overrides.

customerTenantIdstringoptional

Customer tenant this pricing applies to. null = default config for all wholesale customers of the MSP.

PatternDefault: nullnullable
defaultMarkupPercentnumberoptional

Markup applied on top of Codemeta wholesale price (e.g. 50 = +50%). Used for any module without an explicit override.

0 – 1000Default: nullnullable
moduleOverridesobjectoptional

Per-module explicit unit-price overrides in EUR cents. Keyed by module id (e.g. "ticketing").

Default: {}
tierOverridesobjectoptional

Per-tier explicit unit-price overrides in EUR cents. Used when the customer-tenant subscription holds a `tier` instead of (or in addition to) `enabledModules`. Free tier is intentionally excluded.

Default: {}
essentialintegeroptional
≥ 0
prointegeroptional
≥ 0
premiumintegeroptional
≥ 0
tierMarkupPercentnumberoptional

Markup applied on top of the Codemeta wholesale tier price (TIER_WHOLESALE_PRICING). Falls back to defaultMarkupPercent when null. Keep separate from defaultMarkupPercent so MSPs can mark up bundles differently from individual modules.

0 – 1000Default: nullnullable
vatRatestringoptional

VAT rate (percent string) applied to generated wholesale invoices. Set to "0" together with reverseCharge=true for cross-border EU B2B (recipient owes the VAT).

Default: "19"
reverseChargebooleanoptional

EU B2B reverse-charge mechanism. When true, vatAmount is forced to 0 and a "Reverse Charge — recipient liable for VAT (§13b UStG / Art. 196 MwStSystRL)" notice is appended to the invoice closingText.

Default: false
currencystringoptional

ISO 4217 currency code for invoices generated from this config (e.g. EUR, CHF, GBP). Must match the currency of the configured Stripe wholesale prices for the same MSP.

max 3 ZeichenDefault: "EUR"
paymentTermsDaysintegeroptional

Default payment terms (days) for generated wholesale invoices.

0 – 365Default: 14
introTextstringoptional

Optional intro text written above invoice positions.

max 2000 ZeichenDefault: nullnullable
closingTextstringoptional

Optional closing text written below invoice positions.

max 2000 ZeichenDefault: nullnullable
notesstringoptional
max 2000 ZeichenDefault: nullnullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/wholesale_pricings — Liste, paginiert + filterbar
  • GET /api/v1/wholesale_pricings/<id> — Einzelne Entity
  • POST /api/v1/wholesale_pricings — Anlegen
  • PATCH /api/v1/wholesale_pricings/<id> — Teil-Update
  • DELETE /api/v1/wholesale_pricings/<id> — Soft-Delete
  • GET /api/v1/wholesale_pricings/<id>/timeline — Audit + Aktivitäten

Suche