Before Getting Started

Fixably needs to enable the GSPN integration in your tenant. Please reach out to your account manager for more details if you are looking to use this integration. 

Overview

Once the integration is enabled, you can add your Samsung account details and choose how the integration behaves. 

Setup takes five steps:

1. Add your SoldTo account.
2. Add a ShipTo account for each service location.
3. Link each Fixably location to its ShipTo.
4. Choose your general settings.
5. Check the connection.

   1. Add your SoldTo account
      Your business: ASC code, user ID, password
                 |
                 v
   2. Add ShipTo accounts
      One per service location, under the SoldTo
                 |
                 v
   3. Link locations
      System Settings > Locations > Ship-To
                 |
                 v
   4. General settings
      Service types, cancel reasons, ack list, parts options
                 |
                 v
   5. Check the connection
      Verify IGSPN setup

Before you begin

• You need an active Samsung ASC agreement with GSPN access.
• Samsung only accepts connections from approved addresses. Your account manager arranges this approval with Samsung when the integration is enabled.
• For your SoldTo account and for each ShipTo account, have these details from Samsung ready:
  • the ASC code, with its leading zeroes (for example, 12345678 is entered as 0012345678),
  • the GSPN user ID and password.
• You need the permission to manage IGSPN system settings. Without it, the IGSPN pages do not appear under Integrations.

Setup steps

GSPN accounts follow Samsung's own structure:

• A SoldTo account is your business. It is the main account that Samsung contracts with.
• A ShipTo account is one of your service locations. Each ShipTo belongs to a SoldTo.

If you have only one service location, your SoldTo may be all you need. Ask Samsung if you are not sure which ASC codes you have.

Step 1: Add your SoldTo account

1. Open System Settings from the menu in the top right, then Integrations, then IGSPN.
2. Under Admin operations, click Add new IGSPN soldto account. A panel opens on the right.
3. Fill in the fields:

4. Click Save.

You do not enter a Samsung company code or country. Fixably sets both from your account's country.

The account now appears in the Integrations menu as IGSPN followed by its name.

When you save your first SoldTo account, Fixably also sets you up to start working straight away. It adds default GSPN settings, GSPN check-in and check-out macros, the GSPN tasks, and the Samsung device brand if you do not have it yet.

Step 2: Add a ShipTo account for each service location

1. In the Integrations menu, open your SoldTo account (IGSPN followed by its name).
2. Under Shipto Accounts, click Add new shipto account. A panel opens on the right.
3. Fill in the fields:

4. Click Save.

A ShipTo takes its B2B setting, company code and country from its SoldTo, so you do not set them again.

Each ShipTo is listed under Shipto Accounts on the SoldTo page. To change one, click Edit next to it.

Step 3: Link each Fixably location to its ShipTo

Fixably uses the location of an order to decide which Samsung account a repair belongs to. Link each location to its ShipTo:

1. Open System Settings, then Locations, and open the location.
2. Click Advanced Settings, and find the section named after your SoldTo account.
3. In Ship-To, enter the location's ShipTo ASC code, with leading zeroes. You can also enter the SoldTo ASC code if the location works directly under the SoldTo.
4. Save the location.

Repeat this for each location. If you leave Ship-To empty, the location uses the default shown in the field.

When you move an order to another location, Fixably moves its Samsung repair to that location's account too.

Step 4: Choose your general settings

Go back to System Settings > Integrations > IGSPN. The settings at the top of the page, under IGSPN General settings, control how the integration behaves. Each one is described below.

Click Save settings when you are done.

A few technical options, such as the Samsung environment and how Samsung statuses map to your Fixably statuses, are set up by Fixably for you. Ask your account manager if you want to change them.

User permissions control who can create, update, cancel and close Samsung repairs, order parts and handle part returns. Set them on your user roles.

Step 5: Check the connection

On the IGSPN page, under Admin operations, click Verify IGSPN setup. This checks that Fixably can reach GSPN with the details you entered.

If the check fails, look again at the ASC code, user ID and password on the account, then try again. If it still fails, contact Fixably support.

Under Admin operations you also find two import tools:

• Import repairs brings existing GSPN service orders into Fixably from a spreadsheet. This helps when you start using Fixably with jobs already open in GSPN.
• Import models adds Samsung device models from an .xlsx or .csv file.

Fetch data from IGSPN

Fixably copies Samsung's reference data, such as codes and models, on a schedule. The buttons under Fetch data from IGSPN, on the IGSPN page, fetch it at once. They are useful right after setup, or when Samsung has just added something you need. Updating the codes may take some time.

Work codes and flat rates

Work codes are the labor and freight products Fixably adds to Samsung repairs automatically. Flat rates are fixed-price labor products. Each SoldTo account has its own prices.

To manage them, open the SoldTo account in the Integrations menu and use the buttons under Actions:

• Work code products import uploads your Samsung work code price list as an .xlsx file. It sets the labor and freight prices for in-warranty and out-of-warranty repairs. You can add a customer column for customer-specific prices.
• Download work code prices downloads your current work code prices, for all customers or for one customer.
• Flat rate products import uploads your flat rate prices by model, as an .xlsx or .csv file.