Home > DISTRIBUTION > Orders > Importing Bandcamp orders (Merch Orders API)

Importing Bandcamp orders (Merch Orders API)

Bandcamp can send your data to details directly, so nobody has to download and type in orders or convert report files. There are two connections for this, called APIs, and each one brings in something different:

  • Your orders (Merch Orders API): each physical or merch order arrives in DISTRIBUTION / ORDERS with the buyer, the delivery address and the items ordered. You pack and ship it like any other order in details. This article covers the order import.
  • Your sales (Sales Report API): once a month, all your Bandcamp sales, digital and physical, arrive as a sales statement in DISTRIBUTION / IMPORTS. Your royalties are calculated on these statements. See Importing Bandcamp sales via API.

In short: Once the Bandcamp order import is switched on for your account, go to DISTRIBUTION / ORDERS and click Get Bandcamp Orders. Assign a catalog number to any item details can’t find, and your Bandcamp orders appear in the order list.

Requires plugin: Add Button “Get Bandcamp Orders”. Write to label_team@details.eu and we’ll switch it on for you.

► Overview

This import is meant for labels that pack and ship Bandcamp orders themselves or through their warehouse in details. You connect your Bandcamp account once and need a distribution account named Bandcamp, which details books the orders on.

Context: An order tells your warehouse what to send to whom. A sales statement tells you how many units of which release sold at what price, which is what royalties are calculated on. Many labels use both: orders for shipping and the monthly sales statement for royalties.

► Where to find this in details

  • The Bandcamp access: SETTINGS / SHARING, box API configurations.
  • The button Get Bandcamp Orders: DISTRIBUTION / ORDERS.

► Step-by-Step

Before the first import

  1. Add your Bandcamp access in SETTINGS / SHARING under API configurations. You find the Client ID and Client Secret in your Bandcamp account under Settings → API Access.
  2. Make sure you have a distribution account named Bandcamp in DISTRIBUTION / ACCOUNTS. details books the Bandcamp orders on this account.

Import your orders

  1. Go to DISTRIBUTION / ORDERS.
  2. Click Get Bandcamp Orders.
  3. details fetches the new orders. If an item can’t be linked to a product in your catalog, a window opens where you select the Catalog No for that line.
  4. The orders then appear in the order list, ready for packing and shipping.

► Tips / Notes

  • If details says “Orders cannot be imported because there is no Distribution Account = “Bandcamp””, create that account first.
  • Products you sell on Bandcamp are found most reliably when the SKU on Bandcamp matches your product in details.
  • Prices, stock and product pages are still managed on Bandcamp.
  • Questions about the setup? Write to label_team@details.eu.