Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

    English (US)
    HR Croatian
    PL Polish
    DE German
    US English (US)
    ES Spanish
    MX Spanish (Mexico)
    • Home
    • Integrations
    • Samsung GSPN

    Creating a Samsung GSPN service order

    How to create a Samsung GSPN service order with the create.device.gspn and gspn.repair.create macro steps, the manual form, or by attaching an existing one.

    Written by Annukka Matilainen

    Updated at November 2nd, 2026

    Contact Us

    If you still have questions or prefer to get help directly from an agent, please submit a request.
    We’ll get back to you as soon as possible.

    Please fill out the contact form below and we will reply as soon as possible.

    • Release Notes
      2026 Releases 2025 Releases 2024 Releases
    • Getting Started
      Configuring Your Environment
    • Order Management
      Orders How-To Guides Batch Edit Order Lists Using Files Cost Estimates Appointment Booking Customer Portal Insurance Handling
    • Stock Management
      Products and pricing Troubleshooting Part Requests Managing Inventory Purchasing and receiving Returns
    • Invoicing
    • Reporting
      Report Builder
    • Integrations
      Shipping and Transportation Finance Single Sign-on (SSO) Payment Integrations Fixably API Blackbelt360 Xero Accounting WhatsApp Business Apple GSX Samsung GSPN
    • Service Contracts
    • Settings & Configuration
      Roles & Permissions Automations Custom Fields Employee Management Customer Management System Settings Email and SMS Setup Importing Data Security
    • Shipping & Logistics
      Manifests
    + More

    Table of Contents

    Overview Before you begin Create a service order with macro steps Step 1: Create the device with create.device.gspn Step 2: Create the service order with gspn.repair.create What happens after the service order is created Changing how the steps work Create a service order manually Attach an existing service order Troubleshooting "Order already has a repair" "A phone number is required for serviceorder creation" "No customer or end customer set" "Order needs to be open", "Order must contain a device" or "Order must have a location" A required task is missing "Service type not chosen" In home is missing from the service types

    Overview

    A GSPN service order (SO) is Samsung's record of a repair. You need one before Samsung will supply warranty parts or pay a warranty claim. Fixably creates the service order in GSPN for you and links it to the Fixably order.

    There are three ways to get a service order onto an order:

    Way When to use it
    Macro steps (create.device.gspn, then gspn.repair.create) The usual way. Your check-in macro creates the device and the service order in one flow.
    Manual form from the device menu When you are not using a macro, or need to fill in GSPN fields by hand.
    Attach an existing service order When the service order already exists in GSPN, for example one created in Samsung's portal.

    Jobs that Samsung creates for you, such as Accidental Damage jobs, arrive by themselves through the ack list. You do not create those. See Samsung GSPN integration overview.

     

    Before you begin

    • The Samsung GSPN integration must be set up, with your SoldTo and ShipTo accounts. See Getting started with Samsung GSPN.
    • The order must be open, and have a customer, a device and a service location.
    • The customer, or the order's contact, needs a phone number. Samsung requires one.
    • Fill in any tasks the order's queue requires. Fixably checks them before it creates the service order.
    • If the service location has its own Ship-To in System Settings > Locations, the service order is created under that ShipTo. Otherwise it is created under the GSPN account you choose.
    • Write the customer's description of the fault as an issue note on the order. Fixably sends it to Samsung as the customer comment. Any diagnosis notes are sent as the defect description.
    • To create a service order from the manual form, you need the Create GSPN repair permission.

     

    Create a service order with macro steps

    Most service centers create the device and the service order in their check-in macro, with two steps.

     

    Step 1: Create the device with create.device.gspn

    The create.device.gspn step adds the Samsung device to the order. If a Samsung device with the same IMEI or serial number already exists, Fixably uses that one.

    1. Enter the IMEI (phones only) or the Serial. If you have neither yet, leave them empty. Fixably uses Samsung's placeholder serial M000, and you can add the real serial later.
    2. Enter the Short Model code or, after ticking Use full model code, the Full Model code. A model code is required.
    3. If Fixably recognizes the model, it fills in the product category for you. If not, choose a Category and Sub-category yourself. These decide which symptom codes you can pick later.
    4. Choose the Warranty: In Warranty or Out of Warranty.
    5. If the step asks for it, describe the issue.
    6. Continue the macro.

    Samsung sends back the full device details, such as the model name and warranty terms, after the service order is created.

     

    Step 2: Create the service order with gspn.repair.create

    The gspn.repair.create step creates the service order in GSPN. Before it opens, Fixably checks the order and shows a message for anything that is missing, such as a phone number or a required task.

    Fill in the step:

    Field What to do
    GSPN account The Samsung account to create the service order under. It is pre-selected when the order already has one.
    Service location Where the repair is done. If the location has its own Ship-To, the service order is created under that ShipTo. Changing the location here needs the permission to edit an order's location.
    Symptom code combination shortcuts Optional. Pick a shortcut to fill in all three symptom codes at once. Only shown if shortcuts are set up. See Samsung GSPN symptom code shortcuts.
    Symptom code 1, 2 and 3 The fault, from general to specific. Codes chosen earlier with gspn.symptom_codes are already filled in. See Samsung GSPN symptom codes.
    reqRefNo Your reference for the job. It is pre-filled with the Fixably order number. Required when the customer is a company.
    Service type Carry in, Pick up service or In home. See the note below.
    Sub service type Only shown for Pick up service. Choose how the device is collected.

    The service types you can choose depend on the account and the warranty:

    • On a business (B2B) account: Pick up service and In home.
    • On a consumer account: Carry in and Pick up service, plus In home when the device is Out of Warranty.

    Continue the macro. Fixably creates the service order in GSPN and links it to the order. If Samsung rejects it, the reason shows as an error message at the top of the screen. Fix the problem, then run the step again.

     

    What happens after the service order is created

    • The GSPN service order number shows on the order's repair.
    • Fixably fills in the device model, product details and warranty terms from Samsung's reply.
    • If the order's handler has a GSPN engineer code, it is sent with the service order. Engineer codes are entered on each user's profile.
    • If Update status after repair creation is ticked in the IGSPN settings, Fixably moves the service order on to Waiting for product or Product received, depending on whether the device has arrived.

     

    Changing how the steps work

    Fixably support sets up and changes your macros. Contact them if you want, for example, to:

    • pre-select a service type or sub service type,
    • show Cancel IGSPN repair after the check-in process, which cancels the service order in GSPN after check-in,
    • show or require an issue box when the device is created,
    • limit the device categories your team can choose,
    • add gspn.symptom_codes to your check-in macro.

     

    Create a service order manually

    Use this when you are not running a macro.

    1. Open the order. Make sure it has a Samsung device, a customer and a service location.
    2. Open the device menu on the order.
    3. Under GSPN repairs, click the service type:
      • Carry In,
      • Pick up service,
      • In home (OOW),
      • Other service types, for any other Samsung service type.
    4. A form opens on the right, in four parts: Customer info, Product info, Job info and Job date info. Fixably fills in what it already knows from the order.
    5. Check the details, choose the symptom codes under Job info, and submit the form.

    Only the service types your administrator turned on in Select service types used are listed. The options disappear once the order has a repair.

     

    Attach an existing service order

    If the service order already exists in GSPN:

    1. Open the device menu on the order.
    2. Under GSPN repairs, click Attach to order ....
    3. In Shipto, choose the Samsung account the service order belongs to.
    4. In SvcOrderNo, enter the GSPN service order number.
    5. Click Add this repair to the order.

    You can also do this from the device search, with Fetch with existing IGSPN service order.

    Fixably fetches the service order from GSPN and fills in the device and repair details from it.

     

    Troubleshooting

    "Order already has a repair"

    The order already has an open repair, so you cannot create a second one. Use the repair that is there, or close or cancel it first.

    "A phone number is required for serviceorder creation"

    Add a phone number to the customer, or to the order's contact, and run the step again.

    "No customer or end customer set"

    Add a customer to the order, then run the step again.

    "Order needs to be open", "Order must contain a device" or "Order must have a location"

    The order is closed, or has no device or service location. Reopen the order, or add the device or location, then run the step again.

    A required task is missing

    The order's queue has tasks that must be filled in before a service order can be created. Fill them in on the order, then run the step again.

    "Service type not chosen"

    Choose a Service type in the step. Fixably support can also set your macro to pre-select one.

    In home is missing from the service types

    On a consumer account, In home is only offered when the device is Out of Warranty. Check the Warranty chosen in create.device.gspn.

    samsung service order

    Was this article helpful?

    Yes
    No
    Give feedback about this article

    Related Articles

    • Samsung GSPN integration overview
    • Getting started with Samsung GSPN
    • Samsung GSPN FAQ
    • Samsung GSPN symptom codes
    • Samsung GSPN symptom code shortcuts
    Get started today and start fixing hardware with software
    Thank you! We will contact you shortly.
    Oops! Something went wrong while submitting the form.
    ProductsFixably RepairFixably Depot
    SolutionsAASPsEnterprise ServiceRefurbishersMulti-Brand Repairs
    ResourcesAll ResourcesCustomer StoriesBlog
    CompanyAbout UsCareers
    Follow UsFacebookInstagramTwitterLinkedIn

    Contact Us

    sales@fixably.comsupport@fixably.com
    Fixably RepairRepair ManagementGSX IntegrationInventory & StockCustomer ExperienceReporting & DataPoint of SaleFixably Paperless

    North America  Sales

    +1 888 3600 63920289 Stevens Creek Blvd #1070
    Cupertino, CA 95014
    United States

    Europe  Sales

    +358 45 4900 549Kansakoulukatu 3
    00100 Helsinki
    Finland

    Contact Us

    sales@fixably.comsupport@fixably.com
    Copyright © Fixably Ltd.Privacy PolicyTerms of ServiceData Processing Agreement

    Copyright 2026 – Fixably.

    Knowledge Base Software powered by Helpjuice

    Expand