eCommerce
Boutique en ligne
À quoi elle sert
Store the data of an online shop: listings, shipping methods, discount codes and web orders with a fulfilment flow. Refunds need a manager and an approval. A storefront or other client reads and writes this data through the API.
Ce que fait et ne fait pas le paquet
An online shop: categories, product listings with translations, shipping methods, discount codes, web orders with lines and a fulfilment flow of pending, paid, shipped, delivered, cancelled and refunded. When the instance runs with the public site enabled, visitors browse the published listings and place orders without an account; the server prices every order from the published listing and never trusts the browser. There is no payment provider: an order starts as pending and the shop contacts the buyer. Refunds need a human approval from a manager; agents may only propose them. Customer name, email and addresses are personal data and are never public. Needs the Products package.
Modèles
ecommerce_category
A group of listings shown together in the shop
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
name | text | none | non | ecommerce.user | en clair | Category name shown in the shop |
slug | text | none | non | ecommerce.user | en clair | URL part of the category, lowercase with dashes |
description | text | none | non | ecommerce.user | en clair | Short text about the category |
sequence | number | none | non | ecommerce.user | en clair | Order among categories, lowest first |
published | bool | none | non | ecommerce.user | en clair | Whether the category is visible to shoppers |
ecommerce_listing
A product as it appears in the online shop
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
product_id | ref → product | none | non | ecommerce.user | en clair | The product being sold online |
title | text | none | non | ecommerce.user | en clair | Title shown in the shop |
slug | text | none | non | ecommerce.user | en clair | URL part of the product page, lowercase with dashes |
summary | text | none | non | ecommerce.user | en clair | One or two sentences shown on product cards |
description | longtext | none | non | ecommerce.user | en clair | Description shown on the product page, in Markdown |
category_id | ref → ecommerce_category | none | non | ecommerce.user | en clair | The category the listing is shown under |
price | money | none | non | ecommerce.user | en clair | Shop price including tax (minor currency units, e.g. cents) |
compare_at_price | money | none | non | ecommerce.user | en clair | Previous price shown crossed out (minor currency units) |
currency | text | none | non | ecommerce.user | en clair | ISO 4217 currency code of the prices, for example EUR; empty means the shop currency from the instance settings |
sku | text | none | non | ecommerce.user | en clair | Stock keeping unit shown on the product page |
stock_policy | select (always_available, block_when_out, allow_backorder) | none | non | ecommerce.user | en clair | What happens when stock runs out: always_available, block_when_out, allow_backorder |
stock_quantity | number | none | non | ecommerce.user | en clair | Units on hand, used with the stock policy. Orders do not reduce it: adjust it by hand |
published | bool | none | non | ecommerce.user | en clair | Whether the listing is visible to shoppers |
ecommerce_listing_translation
A listing translated into another language
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
listing_id | ref → ecommerce_listing | none | non | ecommerce.user | en clair | The listing this translates |
lang | select (en, de, fr, pl, fi, sv, es) | none | non | ecommerce.user | en clair | Language of the translation: en, de, fr, pl, fi, sv or es |
title | text | none | non | ecommerce.user | en clair | Translated title |
summary | text | none | non | ecommerce.user | en clair | Translated card text |
description | longtext | none | non | ecommerce.user | en clair | Translated description in Markdown |
published | bool | none | non | ecommerce.user | en clair | Whether the translation is shown; it is only reachable while its listing is published |
ecommerce_shipping_method
A way of delivering orders with its price
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
name | text | none | non | ecommerce.user | en clair | Name shown at checkout, for example Standard delivery |
carrier | text | none | non | ecommerce.user | en clair | Carrier that delivers, for example DHL |
price | money | none | non | ecommerce.user | en clair | Delivery price (minor currency units) |
free_over | money | none | non | ecommerce.user | en clair | Order total above which delivery is free (minor currency units); empty means never |
delivery_days | number | none | non | ecommerce.user | en clair | Usual number of days until delivery |
active | bool | none | non | ecommerce.user | en clair | Whether shoppers can choose it |
ecommerce_discount_code
A code a shopper enters at checkout for a reduction
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
code | text | none | non | ecommerce.user | en clair | The code shoppers type, for example SPRING10 |
kind | select (percent, fixed) | none | non | ecommerce.user | en clair | Type of reduction: percent or fixed |
value | number | none | non | ecommerce.user | en clair | Reduction: basis points for percent (1000 is 10.00 percent), minor currency units for fixed |
starts_on | date | none | non | ecommerce.user | en clair | First day the code works (YYYY-MM-DD) |
ends_on | date | none | non | ecommerce.user | en clair | Last day the code works (YYYY-MM-DD) |
max_uses | number | none | non | ecommerce.user | en clair | How many times the code may be used in total; empty means unlimited |
used_count | number | none | non | ecommerce.user | en clair | How many times it has been used (kept up to date by hand) |
minimum_order | money | none | non | ecommerce.user | en clair | Smallest order total the code applies to (minor currency units) |
active | bool | none | non | ecommerce.user | en clair | Whether the code can be used |
ecommerce_order
An order placed online
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
number | text | none | non | ecommerce.user | en clair | Order number shown to the shopper. Free text: packages cannot generate sequences; the public checkout makes a random one |
customer_email | text | internal | oui | ecommerce.user | masqué | Email address of the shopper |
customer_name | text | internal | oui | ecommerce.user | masqué | Name of the shopper |
customer_id | ref → party | none | non | ecommerce.user | en clair | The matching contact, once the shopper is known |
shipping_address | longtext | internal | oui | ecommerce.user | masqué | Delivery address |
billing_address | longtext | internal | oui | ecommerce.user | masqué | Billing address when different from delivery |
shipping_method_id | ref → ecommerce_shipping_method | none | non | ecommerce.user | en clair | The chosen way of delivery |
discount_code_id | ref → ecommerce_discount_code | none | non | ecommerce.user | en clair | The discount code used, if any |
placed_on | date | none | non | ecommerce.user | en clair | Day the order was placed (YYYY-MM-DD) |
currency | text | none | non | ecommerce.user | en clair | ISO 4217 currency code, for example EUR |
subtotal | money | none | non | ecommerce.user | en clair | Sum of the lines (minor currency units, entered not computed) |
discount_total | money | none | non | ecommerce.user | en clair | Reduction from the discount code (minor currency units) |
shipping_total | money | none | non | ecommerce.user | en clair | Delivery charge (minor currency units) |
tax_total | money | none | non | ecommerce.user | en clair | Tax included in the total (minor currency units) |
total | money | none | non | ecommerce.user | en clair | Amount the shopper pays (minor currency units) |
payment_reference | text | financial | oui | ecommerce.user | non communiqué | Reference from the payment provider; never a card number |
tracking_reference | text | none | non | ecommerce.user | en clair | Carrier tracking number |
access_token | text | secret | non | ecommerce.user | non communiqué | Secret link token that lets the shopper who placed a public order see its confirmation page. Nobody can read it back |
state | select (pending, paid, shipped, delivered, cancelled, refunded) | none | non | ecommerce.user | en clair | Fulfilment status: pending, paid, shipped, delivered, cancelled, refunded |
ecommerce_order_line
One product line of a web order
Groupe de lecture: ecommerce.user. Groupe d'écriture: ecommerce.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
order_id | ref → ecommerce_order | none | non | ecommerce.user | en clair | The order the line belongs to |
product_id | ref → product | none | non | ecommerce.user | en clair | The product ordered |
listing_id | ref → ecommerce_listing | none | non | ecommerce.user | en clair | The shop listing the line was ordered from |
description | text | none | non | ecommerce.user | en clair | Product text as it was when ordered |
quantity | number | none | non | ecommerce.user | en clair | Units ordered |
unit_price | money | none | non | ecommerce.user | en clair | Price per unit including tax (minor currency units) |
subtotal | money | none | non | ecommerce.user | en clair | Line total (minor currency units, entered not computed) |
Flux de travail
ecommerce_order
| Action | Transition | Qui peut l'exécuter | Approbation |
|---|---|---|---|
ecommerce_order.mark_paid | state: pending → paid | ecommerce.user | non |
ecommerce_order.ship | state: paid → shipped | ecommerce.user | non |
ecommerce_order.deliver | state: shipped → delivered | ecommerce.user | non |
ecommerce_order.cancel | state: pending → cancelled | ecommerce.user | non |
ecommerce_order.refund | state: paid → refunded | ecommerce.manager | oui |
ecommerce_order.refund_delivered | state: delivered → refunded | ecommerce.manager | oui |
Groupes de permissions
Groupes utilisés par cette application :
ecommerce.managerecommerce.user
Étapes d'approbation
Étapes qu'un agent ne peut que proposer :
ecommerce_order.refundecommerce_order.refund_delivered
Ce que les agents peuvent et ne peuvent pas faire
Un agent peut lire, rechercher, créer et modifier les enregistrements de cette application, et exécuter les actions qui ne requièrent pas d'approbation, dans les limites des groupes de permissions de son jeton.
Il ne peut que proposer ces étapes, qu'une personne doit approuver : ecommerce_order.refund, ecommerce_order.refund_delivered, ecommerce_category.delete, ecommerce_listing.delete, ecommerce_listing_translation.delete, ecommerce_shipping_method.delete, ecommerce_discount_code.delete, ecommerce_order.delete, ecommerce_order_line.delete.
Les données personnelles sont masquées sous forme de jetons de substitution : ecommerce_order.customer_email, ecommerce_order.customer_name, ecommerce_order.shipping_address, ecommerce_order.billing_address.
Ces champs ne sont pas communiqués aux agents : ecommerce_order.payment_reference, ecommerce_order.access_token.
Dépendances
baseproduct
Installation
Installez-la depuis l'application Customize (Place de marché), ou en ligne de commande :
obop modules install-from ecommerceNécessite une base de données et des droits d'administrateur.
Créer la vôtre
Le guide des modules montre comment sont écrites les applications de ce type