Skip to content

VendorSplit Documentation

Everything you need to go from install to fully automated supplier dispatch. Most stores finish setup in under five minutes.

Step 01

Installing VendorSplit

VendorSplit is a Shopify embedded app. It runs entirely inside your Shopify Admin—there is no separate account to create and no password to manage.

1. Add the app

  1. Open the VendorSplit listing on the Shopify App Store and click Install. (The public listing goes live once Shopify App Store review is complete.)
  2. Select the store you want to connect (you must be the store owner or a staff member with permission to install apps).
  3. Review the requested access scopes. VendorSplit needs to read orders (to receive paid orders) and products (to list your catalog vendors).

2. Approve Managed App Pricing

Billing is handled by Shopify Managed App Pricing. After granting access you are taken to Shopify's hosted plan-selection page:

  1. Choose the plan that fits your monthly order volume.
  2. Click Approve. Charges appear on your regular Shopify invoice—VendorSplit never sees or stores payment details.
  3. You can upgrade, downgrade or cancel at any time from Settings → Apps and sales channels → VendorSplit.

Step 02

Creating vendor routing rules

A routing rule connects one product vendor in your catalog to one or more supplier email addresses, plus the CSV format that supplier expects.

Select a vendor from your catalog

  1. In VendorSplit, open Vendor Rules and click Add rule.
  2. Pick a vendor from the dropdown. The list is synced from the vendor field of your Shopify products, so names always match exactly.
  3. Enter the supplier's fulfillment email. Separate multiple recipients with commas.

Configure CSV columns

Add, remove and drag columns into the exact order your supplier's warehouse or ERP imports. Common fields include:

ColumnDescription
order_numberShopify order number, e.g. 1014
skuVariant SKU
productProduct title
variantVariant title (size, color…)
quantityUnits ordered for the line item
ship_name … ship_countryShipping address fields

Choose a delimiter

Select Comma (,) for most US/UK systems, or Semicolon (;) for ERPs and spreadsheet locales that use a comma as the decimal separator (common across continental Europe). Values that contain the delimiter are automatically quoted per RFC 4180.

order_1014_nike.csv — semicolon delimiter
order_number;sku;product;quantity;ship_name;ship_address;ship_city;ship_zip;ship_country
1014;NK-AMP-10;Air Max Pulse;2;Jane Doe;Torstraße 12, Apt 4;Berlin;10115;DE

Step 03

Automatic order dispatch

Once at least one rule is active, dispatch is fully automatic. Every time Shopify fires the orders/paid webhook, VendorSplit runs the following pipeline:

  1. 01

    Verify — the webhook's HMAC signature is validated before any processing.

  2. 02

    Group — line items are grouped by their product vendor.

  3. 03

    Generate — one CSV per matched vendor is built using that rule's columns and delimiter, named order_{number}_{vendor}.csv.

  4. 04

    Send — each file is emailed as an attachment from orders@velsevul.com to the supplier addresses in the rule.

Things to know

  • Only paid orders are dispatched. Pending or authorized-only orders are sent once payment is captured.
  • Line items whose vendor has no active rule are skipped and noted in the Delivery Logs.
  • Ask suppliers to add orders@velsevul.com to their allow-list so files never land in spam.

Step 04

Inspecting delivery logs

Open Delivery Logs inside VendorSplit to see every dispatch in real time: order number, vendor, recipients, item count, timestamp and status. Logs contain no customer personal data and are kept for 90 days.

Statuses & filtering

Sent

The email was accepted by the recipient's mail server.

Failed

Delivery failed. Open the entry for error diagnostics such as an invalid address or a rejected message.

Use the status filter to isolate failures, fix the routing rule (for example, a typo in the supplier email), and confirm subsequent orders show Sent.

Contacting support

Still stuck? Email support@velsevul.com with your store's .myshopify.com domain and the affected order number. We respond within 24 hours.

Ready to automate supplier orders?

VendorSplit is in Shopify App Store review. Get an email the day it launches.

Get notified at launch