What a configuration could hand over
Variants and surcharge parameters cover a limited set of choices in Shoptet, not a dimension to the centimetre. The configurator can calculate the price itself and pass a finished line item with its specification to the order. API access belongs to an addon, and the private interface to the Premium plan, so the scope is checked against your shop.
Order via API
The configuration can create an order through the Shoptet API with the line item, price and an external code, much as Shoptet accepts orders from other sales channels.
Order status
The order could get a status of its own, such as Awaiting site survey, if you have one set up in Shoptet, so it does not mix with ordinary purchases.
Billing details
The contact details and billing address from the configurator can be part of the order itself, so the merchant does not have to retype them.
order:create webhook
Webhooks for order creation and changes can notify production or the CRM without constantly polling the API.
What we need to connect it
On the Premium plan you generate a private API token in the admin and pass it to us; otherwise the connection would run as an addon installed into your shop through OAuth.
With an addon, the permanent installation token is exchanged for an API token valid for 30 minutes, and both stay on our server only.
Together we prepare the order statuses, shipping and payment methods that an order from the configurator is assigned to.
The first orders would be created with a test status or on a test shop, so they do not mix with real ones.
Worth deciding up front
- Shoptet describes order creation through the API mainly as a way to bring in orders from other systems, so the design checks how such an order behaves with payment and documents in your setup.
- A webhook is registered separately for each shop, with one address per event and only on ports 80, 443, 8080 or 8443.
- Which text fields of the order accept the dimensions and the 3D preview link is checked against the current API documentation and your shop.
Questions about this connection
Do we need the Premium plan?
For the private API, yes. Without it, the route is an addon installed into the shop. Which suits you better depends on your plan and the scope of the connection.
Will we see the configuration in the Shoptet admin?
You can, if the design stores it in the line item name or the order note. The 3D preview link can sit next to it, so the merchant opens it in one click.
Other integrations
Put Shoptet to work in your sales.
Tell us what you sell and how an enquiry is handled today. On the demo you will see the configurator, and we will go through which data could flow from it into your system.