# How to connect your BurgerShop store to BurgerPrints

### **Overview**

This guide walks you through how to connect your BurgerShop store to BurgerPrints so that all orders from your online store can be automatically synced, fulfilled, and tracked using BurgerPrints’ production system.

By following this guide, you will be able to streamline your workflow, reduce manual work, and ensure that your orders move into production smoothly.

### **Purpose**

Connecting BurgerShop to BurgerPrints enables you to:

* Sync orders automatically from BurgerShop to BurgerPrints
* Manage the entire fulfillment workflow inside the BurgerPrints dashboard
* Process payments for production directly on BurgerPrints
* Automatically sync tracking numbers from BurgerPrints to BurgerShop
* Reduce manual errors when handling large order volumes

### How to connect your BurgerShop store to BurgerPrints

#### **A. Create a BurgerPrints Fulfillment Store**

1. Log in to the BurgerPrints Dashboard.
2. Navigate to **Stores** and click **Add New Store**.

<figure><img src="/files/ZXGspEaHfLR96huTMZEq" alt=""><figcaption></figcaption></figure>

3. Enter a name for your fulfillment store, then click **Create store**

<figure><img src="/files/n88hY1B4lOOFK4K0zVyo" alt=""><figcaption></figcaption></figure>

**Recommendation**: Use the same name as your BurgerShop domain for easier order management when you have multiple stores.

4. Your newly created store will be displayed on the store list screen.

<figure><img src="/files/OYUYGDR8YEegfm4bfpeU" alt=""><figcaption></figcaption></figure>

#### B. Get API Key from BGP

1. Click "**Get API key**" for the store you want to connect

<figure><img src="/files/4OS9qbCUbTQCsz1aMfoO" alt=""><figcaption></figcaption></figure>

2. Copy the key and use it to activate BurgerPrints Fulfillment app in BurgerShop

<figure><img src="/files/4FL4GfsS2VxuM1R3tdBq" alt=""><figcaption></figcaption></figure>

#### **C. Activate BurgerPrints Fulfillment app in BurgerShop**

1. Log in to the BurgerShop Dashboard.
2. Navigate to Apps and turn on **BurgerPrints Fulfillment**.

   <figure><img src="/files/IwaObnhVAoNz6B72fXwJ" alt=""><figcaption></figcaption></figure>
3. Paste the API key you copied from BurgerPrints

<figure><img src="/files/et8qrT6hLWZFsDLsG0Ur" alt=""><figcaption></figcaption></figure>

4. Select **Connect Now** to complete the setup

<figure><img src="/files/3pCmW2S8QiRaVKqxLnFV" alt=""><figcaption></figcaption></figure>

### How Order Sync and Fulfillment Work

Once your BurgerShop store is successfully connected to BurgerPrints, all new qualified orders from BurgerShop will automatically sync to the Orders page in your BurgerPrints dashboard. During the syncing process, BurgerPrints reads the product information, variants, customer details, and shipping data to prepare the order for fulfillment.

For repeat orders, BurgerPrints can also use Auto Mapping to apply previously used SKU data and, depending on your store setting, the design file when valid mapping history exists.

To learn how this feature works and how to configure design mapping for your store, see [Understanding BurgerPrints' auto mapping feature.](/integrations-and-store-connections/store-connections/understanding-burgerprints-auto-mapping-feature.md)

#### A. Order Sync Conditions

An order is eligible to sync to BurgerPrints when:

* The order status in BurgerShop is Paid
* The BurgerPrints Fulfillment app has been successfully activated

You can change the order status from Unpaid to Paid in BurgerShop by clicking the **Mark as Paid** button on the order details page.

<figure><img src="/files/XP0jfk8c6TA5DNQQfaxH" alt=""><figcaption></figcaption></figure>

#### B. Order Status After Syncing

When an order syncs from BurgerShop (BGS) to BurgerPrints (BGP), it will appear with one of two initial statuses:

* Unpaid: An order will be synced with the Unpaid status when all required order information is available and all products in the order have valid SKUs that are mapped to products in BurgerPrints.
* Incompleted:

An order will appear as Incompleted if:

* Required order information is missing
* The order contains products with SKUs that are not mapped to BurgerPrints

In this case, you must update or correct the missing information so the order can move from **Incompleted** to **Unpaid**.

The following order statuses will occur after the order has been successfully paid:

* Paid: The order has been successfully paid
* Processed: The order has entered production
* Shipped: The order has been dispatched to the customer

#### C. Updating Order Information

**Before the seller pays the fulfillment fee in BGP, certain updates are allowed:**

* Shipping info
* Products
* Production service
* Shipping service

**After the seller has paid the fulfillment cost in BurgerPrints and the order enters production:**

* Once the seller has paid the fulfillment cost in BurgerPrints and the order enters production, the order can no longer be edited.
* To correct any critical issue after payment, the seller must follow the BurgerPrints support flow
* Updates made on BurgerPrints do not sync back to BurgerShop, except tracking information. This connection allows tracking to sync automatically, so you don’t need to update it manually.

### Tips & Best Practices

* Keep two tabs open (BurgerShop + BurgerPrints) to set up faster.
* Use the same name for your store on both platforms to avoid confusion.
* Sync a test order to ensure integration is working properly.
* Check the Available Store list carefully before connecting.
* Regularly monitor the order status to promptly address any issues that may arise
* The order ID in BGS is used as the Reference Order in BGP, allowing you to search for it easily.

### Frequently Asked Questions

1. **How long does it take for my order to sync from BGS to BGP?**\
   Order syncing usually happens within a few minutes as long as the order is in Paid status and your store is properly connected.
2. **Why hasn’t my order synced to BGP yet?**\
   This may happen because the order is still Unpaid or your store connection is not active. Make sure the order is Paid and the store is successfully linked.
3. **Can I change the shipping address after syncing?**\
   Yes, but with conditions. If the order is still Incomplete or Unpaid, you can edit it directly. After the order has been Paid, changes require confirmation from the production team. In this case, you must create a support ticket to submit your request. The request may be approved or rejected depending on the order’s production and shipping status.
4. **Why did one BurgerShop order move to Unpaid automatically while another stayed Incompleted?** \
   Repeat orders with valid paid mapping history can be auto-mapped. Orders without mapping history, with invalid design files, or with out-of-stock mapped SKUs still require manual updates.
5. **Does Auto Mapping apply to my first BurgerShop order for a product?** \
   No. The first order usually requires manual mapping. After that order is paid successfully, it can become mapping history for future repeat orders.
6. **Should I enable design mapping for BurgerShop orders?** \
   Enable it if repeat orders usually use the same design file. Disable it if your store sells personalized products with different names, photos, or custom artwork for each customer.
7. **Can I edit an auto-mapped order before payment?** \
   Yes. Auto-mapped orders can still be reviewed and edited before payment. This is especially important for personalized products.

### Related articles

* [How to connect your Shopify store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-shopify-store-to-burgerprints.md)
* [How to connect your TikTok Shop to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-tiktok-shop-us-to-burgerprints.md)
* [How to connect your WooCommerce store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-woocommerce-store-to-burgerprints.md)
* [How to connect your Walmart store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-walmart-store-to-burgerprints.md)
* [How to connect your Etsy store to BurgerPrints](/integrations-and-store-connections/store-connections/how-to-connect-your-etsy-store-to-burgerprints.md)
* [How to integrate Order Desk with BurgerPrints](/integrations-and-store-connections/store-connections/how-to-integrate-order-desk-with-burgerprints.md)
* [Understanding BurgerPrints' auto mapping feature](/integrations-and-store-connections/store-connections/understanding-burgerprints-auto-mapping-feature.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.burgerprints.com/integrations-and-store-connections/store-connections/how-to-connect-your-burgershop-store-to-burgerprints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
