Type Alias: SubmitCart()

SubmitCart = (cartId, submitData) => Promise<CartSubmitResult>

Function

Finalizes and submits a cart for processing.

This method completes the checkout process by submitting the cart with all required customer information. It transforms the cart into an order that can be processed through subsequent fulfillment workflows. Once submitted, the cart is typically locked and cannot be modified further.

The submission process:

1. Validates all required fields are present and properly formatted
2. Finalizes pricing calculations and applies any last-minute price modifiers
3. Generates a unique reference code for tracking the submitted order
4. Changes the cart status to prevent further modifications
5. Triggers any configured notifications (e.g., email confirmations)

This is typically the final step in the purchasing process within the configurator.

Parameters

cartId

string

The unique identifier for the cart to submit

submitData

BasketSubmissionData

Complete customer information and submission details

Returns

Promise<CartSubmitResult>

A promise that resolves to a result containing the order reference code

Example

// Submit a cart with complete customer information
const customerInfo = {
  fullName: 'John Doe',
  email: '[email protected]',
  phone: '+1 555-123-4567',
  companyName: 'Acme Corporation',
  address: '123 Main St, Anytown, USA',
  language: 'en',
  submittedAt: Date.now(),
  notes: 'Please deliver to loading dock B',
  // Any custom fields collected during checkout
  customFields: {
    deliveryPreference: 'morning',
    specialInstructions: true
  },
  parameters: []  // Processed custom fields
};

const result = await window.mimeeqApp.actions.submitCart('cart_123456', customerInfo);

// Show confirmation with reference code
showOrderConfirmation(result.referenceCode);

Throws

Will throw an error if submission fails due to missing information or system issues

Emits

mimeeq-basket-submitted When the cart is successfully submitted, providing the reference code