@open-mercato/core 0.6.7 → 0.6.8-develop.6875.1.871a4afc94

package/src/modules/sales/components/documents/SalesDocumentForm.tsx

@@ -59,6 +59,7 @@ import {
 import { AddressEditor, type AddressEditorDraft } from '@open-mercato/core/modules/customers/components/AddressEditor'
 import { useSalesChannelsEnabled } from '../useSalesChannelsEnabled'
 import { createLogger } from '@open-mercato/shared/lib/logger'
+import { SalesOrderDraftLines, createSalesOrderLineDraft, type SalesOrderLineDraft } from './SalesOrderDraftLines'
 
 const logger = createLogger('sales')
 
@@ -102,6 +103,7 @@ export type SalesDocumentFormValues = {
   shippingAddressDraft?: AddressDraft
   billingAddressDraft?: AddressDraft
   comments?: string | null
+  lines?: SalesOrderLineDraft[]
 } & Record<string, unknown>
 
 type InboxPreFill = {
@@ -805,6 +807,7 @@ function CustomerGroupComponent({ values, setValue, t, customers, setCustomers,
 
 export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind, inboxPreFill }: SalesDocumentFormProps) {
   const t = useT()
+  const { organizationId, tenantId } = useOrganizationScopeDetail()
   const { enabled: channelsEnabled } = useSalesChannelsEnabled()
   const [customers, setCustomers] = React.useState<CustomerOption[]>([])
   const [customerLoading, setCustomerLoading] = React.useState(false)
@@ -1305,14 +1308,19 @@ export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind
       type: 'textarea',
     },
     {
-      id: 'infoNote',
+      id: 'lines',
       label: '',
       type: 'custom',
-      component: () => (
-        <div className="rounded-lg border bg-muted/50 p-3 text-sm text-muted-foreground">
-          {t('sales.documents.form.nextStep', 'After creation you will add items, prices, and fulfillment details.')}
-        </div>
-      ),
+      component: ({ value, error, values, setValue }) => values?.documentKind === 'order' ? (
+        <SalesOrderDraftLines
+          currencyCode={typeof values.currencyCode === 'string' ? values.currencyCode : defaultCurrency}
+          organizationId={organizationId ?? null}
+          tenantId={tenantId ?? null}
+          lines={Array.isArray(value) ? value as SalesOrderLineDraft[] : []}
+          error={error}
+          onChange={(lines) => setValue(lines)}
+        />
+      ) : null,
     },
   ], [
     addressFormat,
@@ -1321,6 +1329,9 @@ export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind
     addressesLoading,
     channelsEnabled,
     currencyLabels,
+    defaultCurrency,
+    organizationId,
+    tenantId,
     fetchCurrencyOptions,
     loadAddresses,
     loadChannels,
@@ -1340,6 +1351,7 @@ export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind
     },
     { id: 'channels-comments', title: '', column: 1, fields: channelsEnabled ? ['channelId', 'comments'] : ['comments'] },
     { id: 'currency', title: '', column: 2, fields: ['currencyCode'] },
+    { id: 'lines', title: '', column: 1, fields: ['lines'] },
     { id: 'shipping', title: '', column: 2, fields: ['shippingAddressSection'] },
     { id: 'billing', title: '', column: 2, fields: ['billingAddressSection'] },
     { id: 'custom', title: t('sales.documents.form.customFields', 'Custom fields'), column: 2, kind: 'customFields' },
@@ -1361,6 +1373,21 @@ export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind
       channelId: inboxPreFill?.channelId || undefined,
       customerEntityId: inboxPreFill?.customerEntityId || undefined,
       comments: inboxPreFill?.comments || undefined,
+      lines: (inboxPreFill?.lineItems ?? []).map((item, index) => {
+        const unitPrice = Number(item.unitPrice ?? item.unitPriceGross ?? item.unitPriceNet ?? 0)
+        const quantity = Number(item.quantity ?? 1)
+        return createSalesOrderLineDraft({
+          kind: item.kind || (item.productId ? 'product' : 'service'),
+          productId: typeof item.productId === 'string' ? item.productId : undefined,
+          productVariantId: typeof item.productVariantId === 'string' ? item.productVariantId : undefined,
+          name: item.productName || item.name || `Line ${index + 1}`,
+          quantity: Number.isFinite(quantity) ? quantity : 1,
+          currencyCode: inboxPreFill?.currencyCode || defaultCurrency,
+          unitPriceNet: Number.isFinite(unitPrice) ? unitPrice : 0,
+          unitPriceGross: Number.isFinite(unitPrice) ? unitPrice : 0,
+          metadata: item.productId ? undefined : { customLine: true, lineMode: 'custom' },
+        })
+      }),
       useCustomShipping: false,
       useCustomBilling: false,
       sameAsShipping: true,
@@ -1398,6 +1425,21 @@ export function SalesDocumentForm({ onCreated, isSubmitting = false, initialKind
       }
       if (documentKind === 'order') {
         payload.orderNumber = documentNumber
+        const lines = Array.isArray(base.lines) ? base.lines : []
+        if (lines.length === 0) {
+          const message = t('sales.orders.linesRequired', 'Add at least one line item before creating the order.')
+          throw createCrudFormError(message, { lines: message })
+        }
+        payload.lines = lines.map((line) => {
+          const {
+            orderId: _orderId,
+            quoteId: _quoteId,
+            organizationId: _organizationId,
+            tenantId: _tenantId,
+            ...linePayload
+          } = line.payload
+          return { ...linePayload, currencyCode: linePayload.currencyCode || payload.currencyCode }
+        })
       } else {
         payload.quoteNumber = documentNumber
       }

package/src/modules/sales/components/documents/SalesDocumentsTable.tsx

@@ -1,6 +1,7 @@
 "use client"
 
 import * as React from 'react'
+import { extensionPoints } from '@open-mercato/core/modules/sales/extension-points'
 import Link from 'next/link'
 import { useRouter } from 'next/navigation'
 import type { ColumnDef, SortingState } from '@tanstack/react-table'
@@ -738,7 +739,11 @@ export function SalesDocumentsTable({ kind }: { kind: SalesDocumentKind }) {
               ]}
             />
           )}
-          perspective={{ tableId: kind === 'order' ? 'sales.orders' : 'sales.quotes' }}
+          perspective={{
+            tableId: kind === 'order'
+              ? extensionPoints.hosts.ordersTable.tableId
+              : extensionPoints.hosts.quotesTable.tableId,
+          }}
           onRowClick={handleRowClick}
           emptyState={
             <div className="py-10 text-center text-sm text-muted-foreground">

package/src/modules/sales/components/documents/SalesOrderDraftLines.tsx

@@ -0,0 +1,198 @@
+"use client"
+
+import * as React from 'react'
+import type { ColumnDef } from '@tanstack/react-table'
+import { Plus } from 'lucide-react'
+import { DataTable } from '@open-mercato/ui/backend/DataTable'
+import { RowActions } from '@open-mercato/ui/backend/RowActions'
+import { EmptyState } from '@open-mercato/ui/primitives/empty-state'
+import { Button } from '@open-mercato/ui/primitives/button'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import { LineItemDialog } from './LineItemDialog'
+import type { SalesLineRecord } from './lineItemTypes'
+import { formatMoney, normalizeNumber } from './lineItemUtils'
+
+export type SalesOrderLineDraft = {
+  id: string
+  payload: Record<string, unknown>
+  record: SalesLineRecord
+}
+
+type SalesOrderDraftLinesProps = {
+  currencyCode: string | null | undefined
+  organizationId: string | null
+  tenantId: string | null
+  lines: SalesOrderLineDraft[]
+  error?: string | null
+  onChange: (lines: SalesOrderLineDraft[]) => void
+}
+
+function draftId(): string {
+  return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
+    ? crypto.randomUUID()
+    : `draft-${Date.now()}-${Math.round(performance.now())}`
+}
+
+export function createSalesOrderLineDraft(
+  payload: Record<string, unknown>,
+  id = draftId(),
+): SalesOrderLineDraft {
+  const quantity = normalizeNumber(payload.quantity, 0)
+  const unitPriceNet = normalizeNumber(payload.unitPriceNet, 0)
+  const unitPriceGross = normalizeNumber(payload.unitPriceGross, unitPriceNet)
+  const taxRate = normalizeNumber(payload.taxRate, 0)
+  const totalNet = normalizeNumber(payload.totalNetAmount, unitPriceNet * quantity)
+  const totalGross = normalizeNumber(payload.totalGrossAmount, unitPriceGross * quantity)
+  const metadata = payload.metadata && typeof payload.metadata === 'object'
+    ? payload.metadata as Record<string, unknown>
+    : null
+  const catalogSnapshot = payload.catalogSnapshot && typeof payload.catalogSnapshot === 'object'
+    ? payload.catalogSnapshot as Record<string, unknown>
+    : null
+
+  return {
+    id,
+    payload: { ...payload },
+    record: {
+      id,
+      name: typeof payload.name === 'string' ? payload.name : null,
+      productId: typeof payload.productId === 'string' ? payload.productId : null,
+      productVariantId: typeof payload.productVariantId === 'string' ? payload.productVariantId : null,
+      quantity,
+      quantityUnit: typeof payload.quantityUnit === 'string' ? payload.quantityUnit : null,
+      normalizedQuantity: normalizeNumber(payload.normalizedQuantity, quantity),
+      normalizedUnit: typeof payload.normalizedUnit === 'string' ? payload.normalizedUnit : null,
+      currencyCode: typeof payload.currencyCode === 'string' ? payload.currencyCode : null,
+      unitPriceNet,
+      unitPriceGross,
+      taxRate,
+      totalNet,
+      totalGross,
+      priceMode: payload.priceMode === 'net' ? 'net' : 'gross',
+      uomSnapshot: null,
+      metadata,
+      catalogSnapshot,
+      customFieldSetId: typeof payload.customFieldSetId === 'string' ? payload.customFieldSetId : null,
+      customFields: payload.customFields && typeof payload.customFields === 'object'
+        ? payload.customFields as Record<string, unknown>
+        : null,
+      status: null,
+      statusEntryId: typeof payload.statusEntryId === 'string' ? payload.statusEntryId : null,
+    },
+  }
+}
+
+export function SalesOrderDraftLines({
+  currencyCode,
+  organizationId,
+  tenantId,
+  lines,
+  error,
+  onChange,
+}: SalesOrderDraftLinesProps) {
+  const t = useT()
+  const [dialogOpen, setDialogOpen] = React.useState(false)
+  const [editing, setEditing] = React.useState<SalesOrderLineDraft | null>(null)
+
+  const columns = React.useMemo<ColumnDef<SalesOrderLineDraft>[]>(() => [
+    {
+      id: 'name',
+      header: t('sales.documents.items.table.product', 'Product'),
+      cell: ({ row }) => row.original.record.name ?? t('sales.documents.items.untitled', 'Untitled'),
+    },
+    {
+      id: 'quantity',
+      header: t('sales.documents.items.table.quantity', 'Qty'),
+      cell: ({ row }) => row.original.record.quantityUnit
+        ? `${row.original.record.quantity} ${row.original.record.quantityUnit}`
+        : row.original.record.quantity,
+    },
+    {
+      id: 'unitPrice',
+      header: t('sales.documents.items.table.unit', 'Unit price'),
+      cell: ({ row }) => formatMoney(row.original.record.unitPriceGross, row.original.record.currencyCode ?? currencyCode ?? undefined),
+    },
+    {
+      id: 'total',
+      header: t('sales.documents.items.table.total', 'Total'),
+      cell: ({ row }) => formatMoney(row.original.record.totalGross, row.original.record.currencyCode ?? currencyCode ?? undefined),
+    },
+  ], [currencyCode, t])
+
+  const openCreate = React.useCallback(() => {
+    setEditing(null)
+    setDialogOpen(true)
+  }, [])
+
+  const rowActions = React.useCallback((line: SalesOrderLineDraft) => (
+    <RowActions
+      items={[
+        {
+          id: 'edit',
+          label: t('ui.actions.edit', 'Edit'),
+          onSelect: () => {
+            setEditing(line)
+            setDialogOpen(true)
+          },
+        },
+        {
+          id: 'delete',
+          label: t('ui.actions.delete', 'Delete'),
+          destructive: true,
+          onSelect: () => onChange(lines.filter((candidate) => candidate.id !== line.id)),
+        },
+      ]}
+    />
+  ), [lines, onChange, t])
+
+  return (
+    <div className="space-y-3">
+      <div className="flex items-center justify-between gap-4">
+        <div>
+          <h3 className="text-sm font-medium">{t('sales.orders.form.lines', 'Line Items')}</h3>
+          <p className="text-sm text-muted-foreground">
+            {t('sales.orders.linesRequired', 'Add at least one line item before creating the order.')}
+          </p>
+        </div>
+        <Button type="button" variant="outline" onClick={openCreate}>
+          <Plus className="h-4 w-4" aria-hidden="true" />
+          {t('sales.documents.items.add', 'Add item')}
+        </Button>
+      </div>
+      {error ? <p className="text-sm text-destructive" role="alert">{error}</p> : null}
+      <DataTable
+        columns={columns}
+        data={lines}
+        embedded
+        disableRowClick
+        rowActions={rowActions}
+        emptyState={(
+          <EmptyState
+            size="sm"
+            title={t('sales.documents.items.empty', 'No items yet.')}
+            description={t('sales.orders.linesRequired', 'Add at least one line item before creating the order.')}
+            actions={<Button type="button" variant="outline" size="sm" onClick={openCreate}>{t('sales.documents.items.add', 'Add item')}</Button>}
+          />
+        )}
+      />
+      <LineItemDialog
+        open={dialogOpen}
+        onOpenChange={(open) => {
+          setDialogOpen(open)
+          if (!open) setEditing(null)
+        }}
+        kind="order"
+        currencyCode={currencyCode}
+        organizationId={organizationId}
+        tenantId={tenantId}
+        initialLine={editing?.record ?? null}
+        onDraftSaved={(payload, lineId) => {
+          const draft = createSalesOrderLineDraft(payload, lineId ?? undefined)
+          onChange(lineId
+            ? lines.map((line) => line.id === lineId ? draft : line)
+            : [...lines, draft])
+        }}
+      />
+    </div>
+  )
+}

package/src/modules/sales/components/documents/lineItemTypes.ts

@@ -3,6 +3,7 @@ import type { SalesLineUomSnapshot } from '../../lib/types'
 export type SalesLineRecord = {
   id: string
   name: string | null
+  description?: string | null
   productId: string | null
   productVariantId: string | null
   quantity: number

package/src/modules/sales/components/useSalesChannelsEnabled.ts

@@ -1,59 +1,13 @@
 "use client"
 
-import * as React from 'react'
-import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import { useFeatureFlagBoolean } from '@open-mercato/core/modules/feature_toggles/components/hooks/useFeatureFlagBoolean'
 import { SALES_CHANNELS_TOGGLE_ID } from '../lib/salesChannelsToggleId'
 
 export { SALES_CHANNELS_TOGGLE_ID }
 
-const CACHE_TTL_MS = 60_000
-
-type FeatureToggleCheckResponse = {
-  ok?: boolean
-  value?: unknown
-}
-
 // Fails open: channels stay visible unless the toggle explicitly resolves to
 // false. A missing toggle definition (404) or an absent feature_toggles module
 // must not hide sales channel UI.
-async function fetchSalesChannelsEnabled(): Promise<boolean> {
-  try {
-    const call = await apiCall<FeatureToggleCheckResponse>(
-      `/api/feature_toggles/check/boolean?identifier=${SALES_CHANNELS_TOGGLE_ID}`,
-    )
-    if (!call.ok) return true
-    return !(call.result?.ok === true && call.result.value === false)
-  } catch {
-    return true
-  }
-}
-
-let cache: { value: Promise<boolean>; at: number } | null = null
-
-function getSalesChannelsEnabled(): Promise<boolean> {
-  const now = Date.now()
-  if (!cache || now - cache.at > CACHE_TTL_MS) {
-    cache = { value: fetchSalesChannelsEnabled(), at: now }
-  }
-  return cache.value
-}
-
 export function useSalesChannelsEnabled(): { enabled: boolean; isLoading: boolean } {
-  const [resolved, setResolved] = React.useState<boolean | null>(null)
-
-  React.useEffect(() => {
-    let active = true
-    getSalesChannelsEnabled()
-      .then((value) => {
-        if (active) setResolved(value)
-      })
-      .catch(() => {
-        if (active) setResolved(true)
-      })
-    return () => {
-      active = false
-    }
-  }, [])
-
-  return { enabled: resolved !== false, isLoading: resolved === null }
+  return useFeatureFlagBoolean({ id: SALES_CHANNELS_TOGGLE_ID, defaultValue: true })
 }

package/src/modules/sales/data/validators.ts

@@ -624,6 +624,38 @@ export const quoteAdjustmentUpdateSchema = z
   })
   .merge(quoteAdjustmentCreateSchema.partial())
 
+export const ORDER_PAYMENT_LEDGER_FIELDS = [
+  'paidTotalAmount',
+  'refundedTotalAmount',
+  'outstandingAmount',
+] as const
+
+export type OrderPaymentLedgerField = (typeof ORDER_PAYMENT_LEDGER_FIELDS)[number]
+
+export const ORDER_PAYMENT_LEDGER_WARNING_CODE =
+  'sales.order.payment_ledger_input_deprecated' as const
+
+export type OrderPaymentLedgerWarning = {
+  code: typeof ORDER_PAYMENT_LEDGER_WARNING_CODE
+  fields: OrderPaymentLedgerField[]
+}
+
+export function resolveSuppliedOrderPaymentLedgerFields(value: unknown): OrderPaymentLedgerField[] {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return []
+  return ORDER_PAYMENT_LEDGER_FIELDS.filter((field) =>
+    Object.prototype.hasOwnProperty.call(value, field),
+  )
+}
+
+const orderPaymentLedgerShape = {
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  paidTotalAmount: decimal({ min: 0 }).optional(),
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  refundedTotalAmount: decimal({ min: 0 }).optional(),
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  outstandingAmount: decimal().optional(),
+}
+
 const orderTotalsSchema = z.object({
   subtotalNetAmount: decimal({ min: 0 }).optional(),
   subtotalGrossAmount: decimal({ min: 0 }).optional(),
@@ -634,9 +666,6 @@ const orderTotalsSchema = z.object({
   surchargeTotalAmount: decimal({ min: 0 }).optional(),
   grandTotalNetAmount: decimal({ min: 0 }).optional(),
   grandTotalGrossAmount: decimal({ min: 0 }).optional(),
-  paidTotalAmount: decimal({ min: 0 }).optional(),
-  refundedTotalAmount: decimal({ min: 0 }).optional(),
-  outstandingAmount: decimal().optional(),
   lineItemCount: z.coerce.number().int().min(0).optional(),
 })
 
@@ -650,6 +679,8 @@ const quoteTotalsSchema = z.object({
   lineItemCount: z.coerce.number().int().min(0).optional(),
 })
 
+export const SALES_ORDER_LINES_REQUIRED_MESSAGE_KEY = 'sales.orders.linesRequired'
+
 export const orderCreateSchema = scoped.extend({
   orderNumber: z.string().trim().min(1).max(191).optional(),
   externalReference: z.string().trim().max(191).optional(),
@@ -686,10 +717,16 @@ export const orderCreateSchema = scoped.extend({
   paymentMethodSnapshot: jsonRecord.optional(),
   metadata,
   customFieldSetId: uuid().optional(),
-  lines: z.array(orderLineCreateSchema.omit({ organizationId: true, tenantId: true, orderId: true })).optional(),
+  customFields: z.record(z.string(), z.unknown()).optional(),
+  lines: z
+    .array(orderLineCreateSchema.omit({ organizationId: true, tenantId: true, orderId: true }), {
+      error: SALES_ORDER_LINES_REQUIRED_MESSAGE_KEY,
+    })
+    .min(1, SALES_ORDER_LINES_REQUIRED_MESSAGE_KEY),
   adjustments: z.array(orderAdjustmentCreateSchema.omit({ organizationId: true, tenantId: true, orderId: true })).optional(),
   tags: z.array(uuid()).optional(),
   ...orderTotalsSchema.shape,
+  ...orderPaymentLedgerShape,
 })
 
 export const orderUpdateSchema = z
@@ -725,6 +762,7 @@ export const quoteCreateSchema = scoped.extend({
   paymentMethodSnapshot: jsonRecord.optional(),
   metadata,
   customFieldSetId: uuid().optional(),
+  customFields: z.record(z.string(), z.unknown()).optional(),
   lines: z
     .array(quoteLineCreateSchema.omit({ organizationId: true, tenantId: true, quoteId: true }))
     .optional(),
@@ -1046,8 +1084,23 @@ export type PaymentMethodCreateInput = z.infer<typeof paymentMethodCreateSchema>
 export type PaymentMethodUpdateInput = z.infer<typeof paymentMethodUpdateSchema>
 export type TaxRateCreateInput = z.infer<typeof taxRateCreateSchema>
 export type TaxRateUpdateInput = z.infer<typeof taxRateUpdateSchema>
-export type OrderCreateInput = z.infer<typeof orderCreateSchema>
-export type OrderUpdateInput = z.infer<typeof orderUpdateSchema>
+export type DeprecatedOrderPaymentLedgerInput = {
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  paidTotalAmount?: number
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  refundedTotalAmount?: number
+  /** @deprecated Derived from recorded payments. Use sales.payments.create or POST /api/sales/payments. */
+  outstandingAmount?: number
+}
+
+export type OrderCreateInput = Omit<
+  z.infer<typeof orderCreateSchema>,
+  OrderPaymentLedgerField
+> & DeprecatedOrderPaymentLedgerInput
+export type OrderUpdateInput = Omit<
+  z.infer<typeof orderUpdateSchema>,
+  OrderPaymentLedgerField
+> & DeprecatedOrderPaymentLedgerInput
 export type OrderLineCreateInput = z.infer<typeof orderLineCreateSchema>
 export type OrderLineUpdateInput = z.infer<typeof orderLineUpdateSchema>
 export type OrderAdjustmentCreateInput = z.infer<typeof orderAdjustmentCreateSchema>

package/src/modules/sales/di.ts

@@ -8,6 +8,7 @@ import { DefaultSalesCalculationService } from './services/salesCalculationServi
 import { DefaultTaxCalculationService } from './services/taxCalculationService'
 import { SalesDocumentNumberGenerator } from './services/salesDocumentNumberGenerator'
 import { DefaultSalesOrderService } from './services/salesOrderService'
+import { createSalesPaymentOrderTotalResolver } from './services/paymentOrderTotalResolver'
 import {
   SalesOrder,
   SalesOrderLine,
@@ -150,6 +151,14 @@ export function register(container: AppContainer) {
     })
       .singleton()
       .proxy(),
+    // Authoritative amount-due lookup consumed by `payment_gateways` when it
+    // reconciles a caller-supplied payment-session amount (#4488). Registering
+    // it here keeps the gateway module free of any dependency on sales.
+    paymentOrderTotalResolver: asFunction(({ em }: AppCradle) => {
+      return createSalesPaymentOrderTotalResolver({ em })
+    })
+      .scoped()
+      .proxy(),
     SalesOrder: asValue(SalesOrder),
     SalesOrderLine: asValue(SalesOrderLine),
     SalesOrderAdjustment: asValue(SalesOrderAdjustment),

package/src/modules/sales/events.ts

@@ -17,6 +17,7 @@ const events = [
   { id: 'sales.quote.created', label: 'Quote Created', entity: 'quote', category: 'crud' },
   { id: 'sales.quote.updated', label: 'Quote Updated', entity: 'quote', category: 'crud' },
   { id: 'sales.quote.deleted', label: 'Quote Deleted', entity: 'quote', category: 'crud' },
+  { id: 'sales.quote.expiring', label: 'Quote Expiring', entity: 'quote', category: 'lifecycle' },
 
   // Invoices
   { id: 'sales.invoice.created', label: 'Invoice Created', entity: 'invoice', category: 'crud' },

package/src/modules/sales/extension-points.ts

@@ -0,0 +1,33 @@
+import { dataTableExtensionHost, defineModuleExtensionPoints, injectionExtensionHost } from '@open-mercato/shared/modules/widgets/extension-points'
+
+export const extensionPoints = defineModuleExtensionPoints({
+  moduleId: 'sales',
+  hosts: {
+    ordersTable: dataTableExtensionHost({ tableId: 'sales.orders', source: 'components/documents/SalesDocumentsTable.tsx' }),
+    quotesTable: dataTableExtensionHost({ tableId: 'sales.quotes', source: 'components/documents/SalesDocumentsTable.tsx' }),
+    orderItemColumns: injectionExtensionHost({
+      family: 'detail',
+      spotId: 'data-table:sales.order.items:columns',
+      supported: ['column-widget'],
+      source: 'components/documents/ItemsSection.tsx',
+    }),
+    orderShipping: injectionExtensionHost({
+      family: 'detail',
+      spotId: 'detail:sales.order:shipping',
+      supported: ['render-widget'],
+      source: 'backend/sales/documents/[id]/page.tsx',
+    }),
+    documentDetail: injectionExtensionHost({
+      family: 'detail',
+      pattern: 'sales.document.detail.{kind}:{surface}',
+      parameters: {
+        kind: { source: 'SalesDocumentKind', pattern: '^(order|quote)$' },
+        surface: { source: 'host declaration', pattern: '^(tabs|details)$' },
+      },
+      supported: ['render-widget'],
+      source: 'backend/sales/documents/[id]/page.tsx',
+    }),
+  },
+})
+
+export default extensionPoints

package/src/modules/sales/i18n/de.json

@@ -927,8 +927,27 @@
   "sales.documents.form.submit": "Erstellen",
   "sales.documents.form.success": "Verkaufsdokument erstellt.",
   "sales.documents.form.title": "Verkaufsdokument erstellen",
+  "sales.documents.history.actor.system": "System",
+  "sales.documents.history.changedFields": "Geänderte Felder: {fields}",
   "sales.documents.history.empty": "Noch keine Verlaufseinträge.",
   "sales.documents.history.error": "Verlauf konnte nicht geladen werden.",
+  "sales.documents.history.fields.comment": "Kommentar",
+  "sales.documents.history.fields.configuration": "Konfiguration",
+  "sales.documents.history.fields.currency": "Währung",
+  "sales.documents.history.fields.customFields": "Benutzerdefinierte Felder",
+  "sales.documents.history.fields.description": "Beschreibung",
+  "sales.documents.history.fields.discountAmount": "Rabattbetrag",
+  "sales.documents.history.fields.discountPercent": "Rabattprozentsatz",
+  "sales.documents.history.fields.name": "Name",
+  "sales.documents.history.fields.product": "Produkt",
+  "sales.documents.history.fields.promotionCode": "Aktionscode",
+  "sales.documents.history.fields.quantity": "Menge",
+  "sales.documents.history.fields.quantityUnit": "Mengeneinheit",
+  "sales.documents.history.fields.status": "Status",
+  "sales.documents.history.fields.taxRate": "Steuerklasse",
+  "sales.documents.history.fields.unitPriceGross": "Bruttostückpreis",
+  "sales.documents.history.fields.unitPriceNet": "Nettostückpreis",
+  "sales.documents.history.fields.variant": "Variante",
   "sales.documents.history.filter.actions": "Aktionen",
   "sales.documents.history.filter.all": "Alle",
   "sales.documents.history.filter.comments": "Kommentare",
@@ -948,8 +967,10 @@
   "sales.documents.items.deletedCatalogReference.title": "Dieses Katalogprodukt wurde gelöscht",
   "sales.documents.items.editTitle": "Position bearbeiten",
   "sales.documents.items.empty": "Noch keine Positionen.",
+  "sales.documents.items.errorAddToFulfilled": "Zu einem erfüllten Auftrag kann keine neue Position hinzugefügt werden. Ändere zuerst den Auftragsstatus.",
   "sales.documents.items.errorCurrency": "Währung ist erforderlich.",
   "sales.documents.items.errorDelete": "Position konnte nicht gelöscht werden.",
+  "sales.documents.items.errorDeleteLast": "Eine Bestellung muss mindestens eine Position enthalten.",
   "sales.documents.items.errorDeleteShipped": "Positionen mit versandten Artikeln können nicht gelöscht werden.",
   "sales.documents.items.errorLoad": "Positionen konnten nicht geladen werden.",
   "sales.documents.items.errorNameRequired": "Name ist für benutzerdefinierte Positionen erforderlich.",
@@ -1226,6 +1247,7 @@
   "sales.orders.form.shipments": "Sendungen",
   "sales.orders.lines.delete": "Bestellposition löschen",
   "sales.orders.lines.upsert": "Bestellposition aktualisieren",
+  "sales.orders.linesRequired": "Fügen Sie vor dem Erstellen der Bestellung mindestens eine Position hinzu.",
   "sales.orders.list.title": "Aufträge",
   "sales.orders.status_change.actor_api_key": "API-Schlüssel {name}",
   "sales.orders.status_change.actor_unknown": "Unbekannter Benutzer",