Help CenterGitHub
Shopware
Integration Guide

Shopware 6 + atoship

Compare live carrier rates and buy shipping labels right inside the Shopware order screen — a native Shopware 6 app, powered by atoship. Tracking is written straight back onto the order.

How it works

atoship is a native Shopware 6 app — it mounts a shipping panel directly under the Orders menu in your Shopware admin. No storefront changes, no code. Install the app, open an order, compare carrier rates, and buy a label; the tracking number and carrier are pushed back onto the Shopware order automatically.

1

Install the app

Upload the atoship app in your Shopware admin

2

Panel appears under Orders

A secure handshake links the shop to your atoship account

3

Buy label, tracking synced

Tracking + status written back onto the order

Installing the app

Two ways to install. On a self-hosted (on-premise) Shopware 6 store you can install the app package directly today. Listing in the official Shopware Store is in progress; once live, Shopware Cloud stores can install it in one click from the store.

Option A — Upload the app (available now)

  1. Get the atoship for Shopware app package (a .zip) from atoship — see the sidebar or ask your account manager.
  2. In your Shopware 6 admin, open Extensions → My extensions.
  3. Click Upload extension and select the AtoshipShipping.zip file.
  4. Click Install, then Activate the app.
  5. On first activation, Shopware performs a signed registration handshake with atoship — this links your shop to your atoship organization. No password is stored.

Option B — Shopware Store (coming soon)

Once atoship is listed in the Shopware Store, install it in one click from your admin's Extensions → Store tab — the same registration handshake runs automatically. Shopware Cloud (SaaS) stores can only install from the Store, so this is the path for Cloud merchants.

How the connection is secured

Shopware signs every request to atoship with an app secret and a shopware-shop-signature. atoship verifies the signature (HMAC-SHA256) before trusting any shop data, and every order fetch uses a short-lived, revocable shop token — never your Shopware password.

Where to find it

After activation, a new atoship Shipping panel appears under the Ordersmenu in your Shopware admin. That's your shipping workbench — everything happens there, without leaving Shopware.

Buying labels from Shopware

The atoship panel lists your Shopware orders. For any order you can:

Compare live rates

Pick a ship-from address, adjust weight and dimensions, and see live carrier rates side by side — cheapest first.

Signature & insurance

Optionally require a delivery signature or add shipment insurancefor a declared value — priced and applied at purchase.

Buy one or in batch

Ship a single order, or select several and buy all their labels in one batch. Print or download all labels together.

Tracking written back

When a label is bought, atoship writes the tracking number and carrier onto the Shopware order and advances its status — so your team and customer see it natively.

What gets synced

Shopware → atoship

  • Order number & date
  • Shipping & billing address
  • Line items (SKU, quantity)
  • Customer name & email
  • Currency & order totals
  • Delivery / fulfillment state

atoship → Shopware

  • Tracking number & carrier
  • Order delivery marked shipped
  • Order status advanced (open → in progress)

atoship reads orders through the Shopware Admin API and writes tracking onto the order delivery using the app's order_delivery update permission.

Permissions the app requests

Declared in the app manifest and shown to you at install time. atoship only reads shipping-relevant order data and only writes the delivery/tracking back:

read: orderOrder header + totals
read: order_addressShip-to / bill-to addresses
read: order_deliveryDelivery / shipping method
read: order_line_itemItems on the order
read: order_customerCustomer name & email
read: country / country_stateAddress normalization
read: currencyOrder currency
update: order_deliveryWrite tracking + mark shipped

Requirements

  • Shopware 6 (Shopware App System)
  • Self-hosted / on-premise: install the app package directly today
  • Shopware Cloud (SaaS): install from the Shopware Store (listing in progress)
  • An admin user with permission to install apps
  • An atoship account (the app links your shop to it on first launch)

Troubleshooting

The "atoship Shipping" panel doesn't appear under Orders

Make sure the app is both installed and activatedin Extensions → My extensions, and that the registration handshake succeeded (the app needs to reach atoship over HTTPS during activation). Reload the admin after activating.

No rates show up for an order

Check that the order has a complete shipping address and that a ship-from address + package weight are set in the panel. Rates are pulled live, so a missing ZIP/postal code or a zero weight will return nothing.

Tracking isn't showing on the Shopware order

Tracking is written back only after a label is successfully purchased. If a buy failed (e.g. insufficient wallet balance), no tracking is written — top up and retry from the panel.

Installing on Shopware Cloud

Shopware Cloud (SaaS) stores can only install apps from the Shopware Store — the upload path is for self-hosted stores. Our Store listing is in progress; contact us to be notified when it's live.

At a glance
PlatformShopware 6
TypeNative app
AuthSigned handshake (HMAC)
Buy fromOrder screen
Setup time~5 minutes
Shopware Store
Coming soon
Want the app package?
Self-hosted Shopware 6 store? Get the atoship app zip and install it today.
atoship © 2026