Skip to main content

Order

The Order entity is the heart of your store's accounting and customer purchase history. It represents the formalization of a commercial transaction, recording the financial, logistical, and personal details involved at the exact moment of the sale.

Every order is inextricably linked to a Customer (who must be registered in the system before the order is created) and contains the fundamental data for billing and delivery.

Anatomy of an Order​

An order in Webround Commerce aggregates several critical pieces of information:

  • Financial Data: The grand total (amount), shipping costs, and the currency used.
  • Logistics: Shipping and billing addresses, shipping status, and the tracking URL for the customer.
  • Payment Status: Monitoring the transaction lifecycle (created, paid, failed, refunded, etc.).
  • Stripe Integration: Dedicated fields to map Stripe checkout session IDs, payment intents, subscriptions, and generated invoices.
  • Post-Sale Management: Tracking of refunds and disputes.

Order Items​

An order is more than just a financial total; it contains the details of the items purchased through Order Items. Each order line specifies:

  • The SKU purchased.
  • The Quantity.
  • The Unit Net Price and the VAT rate applied at the time of sale.
  • The Delivery method chosen for that specific item.

Management Modes​

Webround Commerce offers two distinct approaches to order management, adapting to both fully automated workflows and manual/custom needs.

1. Automatic Mode (Managed by Stripe)​

In this mode, Webround acts as an intelligent bridge to Stripe. The system creates the order the moment a user starts a checkout session.

  • Workflow: Webround receives real-time events from Stripe (via webhooks) and updates the order accordingly. You will know if the payment was successful, blocked by anti-fraud systems, or failed due to insufficient funds.
  • Data Integrity: Since the transaction is certified by Stripe, you cannot manually modify totals, quantities, or Order Items. This data is "locked" to reflect the actual movement of money.
  • What you can manage: You have full control over the logistical side, specifically updating the Shipping Status and entering the Tracking URL.

2. Manual Mode (Total Flexibility)​

This mode transforms Webround into a powerful management tool free from automation constraints. It is ideal for tracking sales made in your physical store, phone orders, or bulk imports via API from external systems.

  • Autonomy: Stripe does not intervene. You can define prices, items, and statuses as you prefer.
  • Modifiability: There are no blocks on changes. You can update any field of the order at any time to reflect manual operations or offline corrections.
Checkout Workflow

Remember that in automatic mode, the creation of an order does not necessarily coincide with a successful payment. The order is born when the user shows the intention to purchase (opening the checkout). This allows you to monitor initiated carts and analyze potential bottlenecks in the conversion process.