commercetools
Move commercetools orders, products and stock to the rest of your business without re-keying.
40 ways to read, 19 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with commercetools, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create category
categories.createApproval by rule - Create channel
channels.createApproval by rule - List attribute groups
attribute_groups.listRead
Example flow
- commercetools · List attribute groups
attribute_groups.listDone - commercetools · Create category
categories.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches commercetools.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to commercetools
- commercetools's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write commercetools products, variants, standalone prices, categories, inventory, channels, customers and groups; read orders, carts, discounts, stores, shipping and reference data.
commercetools GmbH API docs- Source actions
- 40
- Destination actions
- 19
- Data types
- 28
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
attribute groups1
- List attribute groupsSourceIncremental
Attribute groups in the project, optionally modified after a timestamp.
business units2
- Get business unitSource
One business unit by ID.
- List business unitsSourceIncremental
Business units in the project, optionally modified after a timestamp.
cart discounts1
- List cart discountsSourceIncremental
Cart discounts in the project, optionally modified after a timestamp.
carts2
- Get cartSource
One cart by ID.
- List cartsSourceIncremental
Carts in the project, optionally modified after a timestamp.
categories4
- Create categoryDestinationNot retried automaticallyApproval before production
Creates a category, optionally under a parent.
- Get categorySource
One category by ID.
- List categoriesSourceIncremental
Categories in the project, optionally modified after a timestamp.
- Update categoryDestinationProvider duplicate protectionApproval before production
Changes a category's name, slug, description, parent, key, order hint or external ID.
channels4
- Create channelDestinationProvider duplicate protectionApproval before production
Creates a channel such as an InventorySupply warehouse or a ProductDistribution channel.
- Get channelSource
One channel by ID.
- List channelsSourceIncremental
Channels in the project, optionally modified after a timestamp.
- Update channelDestinationProvider duplicate protectionApproval before production
Changes a channel's key, name, description, roles or address.
customer groups4
- Create customer groupDestinationProvider duplicate protectionApproval before production
Creates a customer group, for example for group pricing.
- Get customer groupSource
One customer group by ID.
- List customer groupsSourceIncremental
Customer groups in the project, optionally modified after a timestamp.
- Update customer groupDestinationProvider duplicate protectionApproval before production
Renames a customer group or sets its key.
customers4
- Create customerDestinationProvider duplicate protectionApproval before production
Creates a customer with ExternalAuth authentication (no password).
- Get customerSource
One customer by ID.
- List customersSourceIncremental
Customers in the project, optionally modified after a timestamp.
- Update customerDestinationProvider duplicate protectionApproval before production
Changes a customer's email, names, company, IDs, VAT ID, group or adds an address.
discount codes1
- List discount codesSourceIncremental
Discount codes in the project, optionally modified after a timestamp.
inventory4
- Create inventory entryDestinationNot retried automaticallyApproval before production
Tracks stock for a SKU, optionally per supply channel (warehouse).
- Get inventory entrySource
One inventory entry by ID.
- List inventory entriesSourceIncremental
Inventory entries in the project, optionally modified after a timestamp.
- Update inventory entryDestinationProvider duplicate protectionApproval before production
Sets the absolute quantity, restock days, expected delivery, supply channel or key.
order details1
- Update order detailsDestinationProvider duplicate protectionApproval before production
Sets the purchase order number, billing or shipping address, locale or parcel tracking data of an order.
orders by number1
- Get order by numberSource
One order by its order number.
orders3
- Get orderSource
One order by ID.
- List ordersSourceIncremental
Orders in the project, optionally modified after a timestamp.
- Update orderDestinationProvider duplicate protectionApproval before production
Changes order and shipment states, order numbers, customer email, shipping address, or records a delivery with tracking.
product discounts1
- List product discountsSourceIncremental
Product discounts in the project, optionally modified after a timestamp.
product projections1
- List published product projectionsSourceIncremental
Published product projections in the project, optionally modified after a timestamp.
product selections2
- Get product selectionSource
One product selection by ID.
- List product selectionsSourceIncremental
Product selections in the project, optionally modified after a timestamp.
product types2
- Get product typeSource
One product type by ID.
- List product typesSource
Product types that define variant attributes.
product variants3
- Add product variantDestinationProvider duplicate protectionApproval before production
Adds a variant with SKU, prices and attributes to an existing product (staged).
- List product variantsSourceIncremental
Product variants in the project, optionally modified after a timestamp.
- Update product variantDestinationProvider duplicate protectionApproval before production
Sets a variant's SKU, key, prices or attributes (staged).
products4
- Create productDestinationNot retried automaticallyApproval before production
Creates a product with its master variant, prices and attributes.
- Get productSource
One product by ID.
- List productsSourceIncremental
Products in the project, optionally modified after a timestamp.
- Update productDestinationProvider duplicate protectionApproval before production
Changes the name, slug, description, key, categories or tax category, and optionally publishes.
reviews1
- List reviewsSourceIncremental
Reviews in the project, optionally modified after a timestamp.
shipping methods1
- List shipping methodsSourceIncremental
Shipping methods in the project, optionally modified after a timestamp.
standalone prices4
- Create standalone priceDestinationNot retried automaticallyApproval before production
Creates a price for a SKU, optionally scoped to a country, customer group, channel and validity window.
- Get standalone priceSource
One standalone price by ID.
- List standalone pricesSourceIncremental
Standalone prices in the project, optionally modified after a timestamp.
- Update standalone priceDestinationProvider duplicate protectionApproval before production
Changes the amount, active flag or validity window of a standalone price.
states1
- List workflow statesSourceIncremental
Workflow states in the project, optionally modified after a timestamp.
stock adjustments1
- Adjust stockDestinationProvider duplicate protectionApproval before production
Adds (positive) or removes (negative) quantity on an inventory entry.
stores2
- Get storeSource
One store by ID.
- List storesSourceIncremental
Stores in the project, optionally modified after a timestamp.
tax categories2
- Get tax categorySource
One tax category by ID.
- List tax categoriesSourceIncremental
Tax categories in the project, optionally modified after a timestamp.
types1
- List custom field typesSourceIncremental
Custom field types in the project, optionally modified after a timestamp.
zones1
- List shipping zonesSourceIncremental
Shipping zones in the project, optionally modified after a timestamp.
Access and limits
- Authentication
- API client (client credentials)
- Plans and access
- All commercetools Composable Commerce projects include the HTTP API. Requests act as the API client; its scopes (view_/manage_ per resource) limit what Nexra can read and write.
- Test environment
- Use a commercetools trial project or a non-production project.
- Rate limits
- No fixed request quota is published; commercetools applies fair-use throttling and returns HTTP 429 or 503 under load. Query limit is 500 records per page.
- Pagination
- limit (max 500) and offset (max 10,000) with total; queries sort by lastModifiedAt.
- Provider events
- Subscriptions deliver messages and change notifications to queues and event buses. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Offset paging stops at 10,000 records per query; use the updatedSince filter for incremental syncs of large catalogues.
- Product and variant changes are staged; set publish on create or update to make them visible.
- Orders are read and updated (states, numbers, addresses, deliveries); creating orders from carts, payments and refunds are not automated, and Cancelled states are excluded.
- Customers are created with authenticationMode ExternalAuth so Nexra never handles customer passwords.
- commercetools has no purchase orders, suppliers or stock transfers; model warehouses as InventorySupply channels and move stock with inventory adjustments per channel.
- Deletes are not automated.
- order_details.update uses only safe update actions: setPurchaseOrderNumber, setBillingAddress, setShippingAddress, setLocale and setParcelTrackingData. It never changes order, payment or shipment states, never adds payments and never adds deliveries or returns.
- Carts, discounts, product selections, business units, shipping methods, zones, states, custom types and reviews are read only. Creating orders, carts, payments, refunds, returns, quotes and discount codes is an intentional exclusion.
- Project key and region come only from validated connection configuration; standalone prices apply only to products with priceMode Standalone.
Developer reference
- Create the commercetools GmbH credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose commercetools, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/commercetools and the Connections API.