Using Shopimods

Getting started

1. Install the app from Shopify. Open the Shopimods listing in the Shopify App Store (or the install link we sent you) while logged in to your store, and click Install.
2. Approve access. Shopify shows the permissions Shopimods needs (reading orders and fulfilling them). Approve to continue.
3. You're signed in automatically. If your store's owner email is new to Shopimods, we create your account and organization and take you straight to the dashboard. We also email you a link to set a password, so you can sign in later at app.shopimods.com.
4. If you already have a Shopimods account with the same email, the store is added to your existing organization; sign in as usual.

Stores can only be added by installing the app from Shopify. You never need to type in a store address.

Stores

The Stores page lists every Shopify store connected to your organization.

• Auto Sync: when on, new orders from that store are sent to its order actions automatically. When off, orders are still imported into Shopimods but not forwarded.
• Test Connection checks that Shopimods can still reach the store.
• Connect to Shopify appears if a store has lost its connection (for example, after the app was uninstalled). Click it to approve access again.
• To add another store, install the app on that store from Shopify.

Order actions

Order actions decide where a store's orders go. Open a store and add an action under Order actions, choosing when it runs with its event:

• created: runs automatically for every new order created in Shopify, as long as the store's Auto Sync is on.
• sync: runs when you select orders on the Orders page and click Sync, for example to send past orders or retry after fixing a problem.

Two types of action are available:

Send webhook

Shopimods sends each new order to a URL you choose, as a JSON POST.

• The URL must start with https:// and be publicly reachable. Private network addresses aren't accepted.
• Authentication: none, Basic (we send Authorization: Basic <value>) or Bearer (Authorization: Bearer <value>).
• Your endpoint should reply with a 2xx status. Redirects aren't followed.
• Every attempt and its response is recorded in the order's action log.

Example request body (shortened):

{
  "event": "created",
  "id": 42,
  "store_id": 3,
  "shopify_order_id": "5550001",
  "status": 1,
  "tracking_number": null,
  "payload_shopify": {
    "id": 5550001,
    "name": "#1042",
    "email": "buyer@example.com",
    "total_price": "99.50",
    "currency": "GBP",
    "financial_status": "paid",
    "shipping_address": { "name": "Ada Lovelace", "address1": "1 Main St", "zip": "N1 1AA", "country_code": "GB" },
    "line_items": [ { "sku": "SKU-1", "name": "Widget - Blue", "quantity": 2, "price": "45.00" } ]
  },
  "order_items": [
    { "sku": "SKU-1", "name": "Widget - Blue", "quantity": 2, "is_export": 1 }
  ]
}

payload_shopify contains the Shopify order, including the customer's contact details and shipping address. order_items are the line items as stored in Shopimods.

GSIT delivery

Creates a delivery order in your GSIT portal for each new order.

• Subdomain: your GSIT portal's host name, for example yourcompany.example.com (no https:// or path).
• API key: provided by GSIT. It's stored securely and never shown in logs.
• Line items are sent with their SKU, description and quantity, along with the customer's name, address, postcode and email.
• When GSIT returns a tracking (carrier) reference, Shopimods saves it on the order and marks the order as fulfilled in Shopify with that tracking number.

Orders

The Orders page shows orders from all your stores, with the customer, totals, payment and fulfillment status, and which actions have run. Use the filters to narrow by store, date range or search text.

• Orders arrive within seconds through Shopify notifications, and a background sync regularly picks up anything that was missed.
• Open an order to see its details and the action log: every webhook or GSIT attempt and its result.
• Select orders and click Sync to send them to the store's actions with the sync event.

Stock and bundles

The Stock page holds your SKUs: name, description, quantity, weight, dimensions (length, width, height) and volume (CBM). Order line items are matched to your stock by SKU.

A bundle is a SKU made of other SKUs, for example a gift set. Add components to a bundle with the quantity of each.

Importing stock

Go to Stock → Imports and upload a .csv, .xlsx or .xls file. The first row must contain these column names (only sku and name are required). Existing SKUs are updated, new ones are created. A sample CSV is available on the import page.

Rows with a missing SKU or name are skipped and listed in the import result.

Alerts

The bell icon shows an alert whenever an order action fails, for example when GSIT or your webhook returns an error. Open an alert to see the details and mark it as read.

Account and password

• Change your password and organization name under Account.
• Forgot your password? Use Forgot password? on the sign-in page to get a reset link by email. Links expire after 60 minutes.
• Changing or resetting your password signs out your other sessions.

Removing a store

• Delete it in Shopimods (Stores page): the store is removed from your organization and the app is uninstalled from that shop in Shopify.
• Uninstall it in Shopify (Settings → Apps): Shopimods stops accessing the store straight away and shows it as disconnected. Reinstall at any time to reconnect.

See our privacy policy for how store data is deleted afterwards.

Troubleshooting

New orders aren't showing

• Check the store shows as connected on the Stores page; if not, click Connect to Shopify.
• Wait a minute or two: the background sync catches orders that a notification missed.
• Make sure you're viewing the right organization and that no filters are hiding the order.

Orders show but aren't sent to GSIT or my webhook

• Turn on Auto Sync for the store; actions only run for new orders while it's on.
• Open the order's action log to see the response from GSIT or your endpoint.
• After fixing the problem, select the order and click Sync to send it again (this needs an action with the sync event).

My webhook URL is rejected

It must use https://, be reachable from the internet, and not contain a username or password.

Still stuck? Email info@shopimods.com with your store address and, if relevant, the order number.