--- title: "Tutorial: Setting up a transfer configuration" slug: "tutorial-setting-up-a-transfer-configuration" tags: ["dellivery", "Easypost", "Associate App", "integration", "shipping", "transfer", "international shipping", "platform", "stock on hand", "inventory", "onboarding", "store fulfillment", "fulfillment", "routing", "tutorial", "api"] updated: 2026-04-15T15:13:06Z published: 2026-04-15T15:13:06Z canonical: "docs.newstore.com/tutorial-setting-up-a-transfer-configuration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.newstore.com/llms.txt > Use this file to discover all available pages before exploring further. # Tutorial: Setting up a transfer configuration The aim of this tutorial is to set up a transfer configuration, based on the fulfillment configuration and strategy for a business created as part of the [fulfillment config tutorial](/v1/docs/tutorial-setting-up-a-fulfillment-configuration-legacy-method#tutorial_fulfillment-config). A transfer configuration allows you to transfer inventory from a **store** (not a DC) to another location. See the [general explanation](/v1/docs/about-shipping#shipping-transfer-orders) , or how the [integration is done](/v1/docs/integrating-a-fulfillment-provider#shipping-transfer-orders). > [!NOTE] > Important > > The transfer configuration is related to the fulfillment configuration. The service levels you use in the transfer configuration: > > - Must be present in your fulfillment configuration. > - Have the **same** service level priority as in the fulfillment configuration. ## Defining the strategy We have set up a business with one DC and one store. See the [strategy](/v1/docs/tutorial-setting-up-a-fulfillment-configuration-legacy-method#setting-up-the-strategy) we created for the [fulfillment configuration](/v1/docs/tutorial-setting-up-a-fulfillment-configuration-legacy-method#tutorial_fulfillment-config) earlier. In our case, we can only: - Enable transfers from our unique store to our unique DC. - Offer traditional delivery for the transferred inventory from the store to the DC. The updated strategy for transfers from our store is defined below: | Country | Zip code | Fulfillment node id | Supported shipping options for transfers | | --- | --- | --- | --- | | US | 10* | `store1_NYC` | Traditional | ## Creating the transfer configuration We use the [Add transfer shipping configuration](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api) method to create a transfer configuration. Because we only want to use the `TRADITIONAL` service level to transfer inventory, our payload for the transfer configuration looks as follows: ```json {    "transfer_order_configuration": [        {            "from_location_id": "store1_NYC",            "to_location_ids": ["DC01"],            "service_level_ids": ["TRADITIONAL"]        }    ] } ``` > [!TIP] > Note > > We can use `*` in `to_location_ids` to allow shipping to any location. Once we call the [Add transfer shipping configuration](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api) method, the shipping options for transfers are available in Associate App. Use the [Get transfer shipping configuration](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api) method to view the transfer config set up for your business. ### (Optional) Creating a transfer configuration without store fulfillment In some cases, you may not want to use stores to fulfill orders in your business. In our case, let's use our store (`store1_NYC`) to transfer inventory, but not fulfill orders. To do this: 1. Update the `routes` in your fulfillment configuration. - If you are using the new fulfillment configuration and **not** the legacy [fulfillment configuration API](https://docs.newstore.net/api/integration/order-management/newstore_ff_config_api) to set up the config, you can use the [Routing ruleset API](https://docs.newstore.net/api/integration/delivery/fulfillment_config_routing_ruleset_api/) to update the routes by setting the value of `zip_code_regions` to `fake-zip-code`. Based on the shipping strategy we had defined in our fulfillment configuration in the [tutorial](/v1/docs/tutorial-setting-up-a-fulfillment-configuration#tutorial_fulfillment-config-new) , the updated payload to use with the [Update routing rules method](https://docs.newstore.net/api/integration/delivery/fulfillment_config_routing_ruleset_api/#tag/routing-ruleset/operation/updateRoutingRuleset) looks like this: ```json {    "routes": [        {            "fulfilled_by": {                "TRADITIONAL": ["Store Group 0"]            },            "destination_region": {                "country": "US",                "zip_code_region": "All"            }        }    ],    "sl_levels_priority": ["TRADITIONAL"],    "location_groups": {        "Store Group 0": ["store1_NYC"]    },    "zip_code_regions": {        "All": ["fake-zip-code"]    } } ``` - However, if you are still using **only** the [legacy fulfillment configuration API](https://docs.newstore.net/api/integration/order-management/newstore_ff_config_api) to set up your fulfillment configuration, update the routes in our fulfillment configuration using the [Update fulfillment configuration](https://docs.newstore.net/api/integration/order-management/newstore_ff_config_api#operation/add-or-update-fulfillment-configuration) method, and set the value of `zip_codes` for the store to `fake-zip-code`. The updated routes are as follows: ```json {    "fulfillment_config": {        "routes": [            {                "fulfilled_by": {                    "SAME_DAY_DELIVERY": [                        {                            "provider_rate": "UPS_SAME_DAY_RATE",                            "fulfillment_node_id": "store1_NYC"                        }                    ],                    "TRADITIONAL": [                        {                            "provider_rate": "UPS_TRADITIONAL_RATE",                            "fulfillment_node_id": "store1_NYC"                        }                    ]                },                "destination_region": {                    "countries": ["US"],                    "zip_codes": ["fake-zip-code"]                }            },            {                "fulfilled_by": {                    "TRADITIONAL": [                        {                            "provider_rate": "UPS_TRADITIONAL_RATE",                            "fulfillment_node_id": "DC01"                        }                    ]                },                "destination_region": {                    "countries": ["US"],                    "zip_codes": ["*"]                }            }        ]    } } ``` The final updated payload for our fulfillment configuration with the [legacy fulfillment configuration API](https://docs.newstore.net/api/integration/order-management/newstore_ff_config_api) looks as follows: ```json {    "fulfillment_config": {        "routes": [            {                "fulfilled_by": {                    "SAME_DAY_DELIVERY": [                        {                            "provider_rate": "UPS_SAME_DAY_RATE",                            "fulfillment_node_id": "store1_NYC"                        }                    ],                    "TRADITIONAL": [                        {                            "provider_rate": "UPS_TRADITIONAL_RATE",                            "fulfillment_node_id": "store1_NYC"                        }                    ]                },                "destination_region": {                    "countries": ["US"],                    "zip_codes": ["fake-zip-code"]                }            },            {                "fulfilled_by": {                    "TRADITIONAL": [                        {                            "provider_rate": "UPS_TRADITIONAL_RATE",                            "fulfillment_node_id": "DC01"                        }                    ]                },                "destination_region": {                    "countries": ["US"],                    "zip_codes": ["*"]                }            }        ],        "provider_rates": {            "UPS_SAME_DAY_RATE": {                "service_level": "SAME_DAY_DELIVERY",                "shipping_type": "same_day_delivery",                "return_provider_rate": "",                "shipping_carrier_name": "UPS",                "use_as_customer_facing_cost": false            },            "UPS_TRADITIONAL_RATE": {                "service_level": "TRADITIONAL",                "shipping_type": "same_day_delivery",                "return_provider_rate": "",                "shipping_carrier_name": "UPS",                "use_as_customer_facing_cost": false            }        },        "service_levels": {            "SAME_DAY_DELIVERY": {                "price": 15,                "tax_code": "",                "display_name": "Same day delivery",                "currency_code": "USD",                "delivery_time": "Place order by 2pm.",                "remorse_period": 120,                "delivery_time_after_cutoff_hour": "Place order by 2pm."            },            "TRADITIONAL": {                "price": 0,                "tax_code": "",                "display_name": "Traditional delivery",                "currency_code": "USD",                "delivery_time": "3-7 business days",                "delivery_time_after_cutoff_hour": ""            }        },        "sl_levels_priority": ["SAME_DAY_DELIVERY", "TRADITIONAL"]    } } ``` The updated fulfillment configuration ensures that no orders are routed to the store for fulfillment. Only the DC (`DC01`) can now fulfill orders. 2. [Create the transfer configuration](/v1/docs/tutorial-setting-up-a-transfer-configuration#creating-the-transfer-configuration) to transfer inventory from your store. **Related topics** - [Tutorial: Setting up a fulfillment configuration (Legacy method)](/v1/docs/tutorial-setting-up-a-fulfillment-configuration-legacy-method#tutorial_fulfillment-config) - [Tutorial: Setting up a store](/v1/docs/tutorial-setting-up-a-store#tuto-create-store) - [Tutorial: Setting up an in-store pickup configuration](/v1/docs/tutorial-setting-up-an-in-store-pickup-configuration#tuto-instorepickup) - [Shipping transfer orders](/v1/docs/integrating-a-fulfillment-provider#shipping-transfer-orders)