Samsung engineer codes
Where to save Samsung engineer codes for your technicians, and when Fixably sends them to GSPN.
Written by Annukka Matilainen
Updated at November 5th, 2026
Table of Contents
Overview
An engineer code, also called an engineer BP number, is the number Samsung gives each of your technicians. Samsung uses it to see which engineer worked on a service order. Fixably sends the code to GSPN for you, so each technician needs their code saved in Fixably.
At a glance:
- Samsung gives the same technician a different code for each SoldTo account. Save one code per SoldTo.
- Fixably sends the code of the order's handler, when the service order is created and when the handler changes.
- GSPN needs a code to move a service order to Engineer Assigned, and to complete a repair.
- Fixably does not check the code with Samsung. Samsung only rejects a wrong code when you complete the repair.
Technician's code Order handler set GSPN service order
saved in Fixably ---> or changed ---> engineer code updated,
(one per SoldTo) status Engineer Assigned
Before you begin
- The Samsung GSPN integration must be set up, with your SoldTo accounts. See Getting started with Samsung GSPN.
- Get each technician's engineer codes from Samsung, one for each SoldTo account they work under.
- To save a code on a user's profile, you must be an administrator. To save it in User Settings, you need the Manage integrations permission.
Where to enter engineer codes
You can enter a technician's engineer code in two places. Both save the same code, so use whichever suits you.
On the user's profile
- In the left menu, open Users > Employees.
- Open the technician.
- Find the Engineer Code fields. There is one for each SoldTo account, named after the account, for example IGSPN Demo Engineer Code.
- Enter the technician's code for each SoldTo they work under.
- Click Save.
The fields are only shown to administrators, and only on employees.
In User Settings
- Open the user menu at the top right and click User Settings.
- Open the Integrations tab.
- Find the section named after your SoldTo account and click Expand.
- In Engineer code, enter the code.
- Click Save Settings. Fixably shows "Settings saved".
Repeat steps 3 to 5 for each SoldTo account. Administrators can also pick another user in User Settings and save their code the same way.
When Fixably sends the engineer code
Fixably always uses the code of the order's handler, for the SoldTo account the service order belongs to.
| When | What Fixably sends to GSPN |
|---|---|
| The service order is created | If the handler has a code, it is sent with the new service order, with the engineer assigned date. |
| The order's handler changes | If the new handler has a code that is different from the one on the service order, Fixably sends it and moves the service order to Engineer Assigned. If the new handler has no code, nothing is sent. |
| An in-home appointment is created | The handler's code is sent with the appointment date and the Engineer Assigned status. See Samsung in-home repairs and appointments. |
| The service order moves to Engineer Assigned | If the service order has no code yet, Fixably uses the handler's code. |
| The repair is completed | The code on the service order is sent. If there is none, you choose one in the completion form. |
To change the engineer on an open service order, change the order's handler to a technician who has a code for that SoldTo.
Engineer code on GSPN repair forms
The Engineer code field also appears on these GSPN forms:
| Form | How the field works |
|---|---|
| Full update form on the GSPN repair | A dropdown of every technician who has a code for this SoldTo, shown as name and code. |
| Mark complete on the GSPN repair | Only shown when the service order has no engineer code yet. Choose a technician, and enter the Engineer assigned date. Both are required. |
gspn.check_out macro step |
Only shown when the service order has no engineer code yet, and the step is set up to show it. It is required to complete the repair. |
| Manual service order form, under Job info | A text field. If you enter a code, also enter the Engineer assigned date under Job date info, and the other way round. |
The engineer saved on a service order shows as Engineer on the GSPN repair.
If a technician is missing from the Engineer code dropdown, they have no code saved for the SoldTo account of this service order.
Troubleshooting
"Engineer code missing"
Fixably tried to move the service order to Engineer Assigned, but neither the service order nor the order's handler has an engineer code. Save the handler's code for this SoldTo, or set a handler who has one. Then try again.
"Engineer code is required"
You chose the Engineer Assigned status in a GSPN form, but the service order has no engineer code. Choose a technician in Engineer code.
"Failed to update engineer code to GSPN"
You changed the order's handler, but Fixably could not send the new engineer code to GSPN. Check that the code is the right one for the SoldTo account of this service order. Then set the handler again.
"Saving IGSPN engineer code failed."
Fixably could not save the code in User Settings. Try again. If it keeps failing, contact Fixably support.
GSPN rejects the repair when I complete it
Samsung only checks the engineer code when the repair is completed. A code that has the wrong format, or belongs to another SoldTo, is accepted until then. Check the technician's code with Samsung, correct it in Fixably, set the handler again, and complete the repair again. See Closing a Samsung repair.
Appointments and visits do not reach GSPN
The handler has no engineer code, so Fixably saved the appointment in Fixably only. See Samsung in-home repairs and appointments.
The Engineer Code fields are missing on the user's profile
The fields are only shown to administrators, only on employees, and only when the Samsung GSPN integration is active. Use User Settings instead, or ask an administrator.