Order
The Order object represents a finalized purchase within webround.com. It contains the economic summary, payment status, logistics information, and a detailed list of purchased items.
Order Definition
| Property | Type | Description |
|---|---|---|
| id | string (UUID) | Unique identifier for the order. |
| storeId | string (UUID) | ID of the store where the purchase was made. |
| customerId | string (UUID) | ID of the user who placed the order. |
| amount | string (Decimal) | Total order amount (gross). |
| currencyCode | string | Currency code (e.g., EUR). |
| paymentStatus | string | Payment status (e.g., paid, pending, failed). |
| shippingStatus | string | Shipping status (e.g., unassigned, shipped, delivered). |
| stripeInvoiceUrl | string (URL) | Direct link to the invoice generated on Stripe. |
| shippingTrackingUrl | string | null |
| items | OrderItem[] | Array containing the individual items included in the order. |
| createdAt | string (ISO 8601) | Order creation date. |
| updatedAt | string (ISO 8601) | Last record update date. |
OrderItem
Represents a single line item (product/variant) within an order, including tax details and unit prices.
| Property | Type | Description |
|---|---|---|
| productId | string (UUID) | ID of the main product. |
| variantId | string (UUID) | ID of the specific variant. |
| skuId | string (UUID) | Unique SKU ID for the item. |
| variantName | string | Descriptive name of the purchased variant (e.g., "Black Cap"). |
| coverUrl | string (URL) | URL of the product's cover image. |
| quantity | number | Quantity purchased for this line item. |
| deliveryMethod | DeliveryMethod | Delivery method chosen for the item. |
| appliedTaxRate | number | Applied VAT rate (e.g., 22). |
| unitNet | string (Decimal) | Unit price excluding taxes. |
| unitGross | string (Decimal) | Gross unit price. |
| totalNet | string (Decimal) | Total net line amount (unitNet * quantity). |
| totalGross | string (Decimal) | Total gross line amount (unitGross * quantity). |
Note on Decimals
Economic values (amount, unitNet, etc.) are returned as string to preserve decimal precision during financial operations, avoiding the rounding errors typical of the float type in JavaScript.