What settings can I configure in the GSX integration?

A walkthrough of every setting on System Settings > Integrations > GSX beyond the initial connection setup, and guidance on when to use each one.

Written by Support

Updated at August 11th, 2026

+ More

Table of Contents

Overview Before you begin Reference: settings by category Purchase orders and stock Order-closing and pricing settings Compliance settings Repair types and mail-in behavior Printouts and customer paperwork Notes, notifications, and reservations Before you save

Audience: Support agents and administrators who have already completed the initial Apple GSX connection setup and want to fine-tune how GSX repairs behave in Fixably day to day.

Overview

Getting GSX connected is only the first step. The rest of the GSX settings page controls how GSX repairs behave day to day: purchase orders, order-closing rules, repair types, compliance guardrails, printouts, and reservations. This article covers every setting below the initial connection setup, grouped by what it affects.

Before you begin

Complete the initial connection setup first: Sold-To, Ship-To, the sold-to contact details, and the certificate. See “How do I configure the Apple GSX integration?” for those steps. One more field in that same group is easy to miss:

Reference: settings by category

Everything below is grouped by what it affects rather than by where it sits on the page, so the order here won't always match the order of fields on the settings page itself. Defaults reflect a fresh GSX setup.

Purchase orders and stock

These settings control how GSX-driven purchase orders and stock assignment behave:

Setting	Default	What it does
Auto-generate purchase order number	On	Generates a purchase order number from the order ID and technician reference, so nobody has to type one in manually.
Automatic purchase order creation for consignment parts	Off	Turn it on to create purchase order lines for consignment parts during GSX synchronization, which keeps the purchase order open. Leave it off to exclude consignment parts from purchase orders entirely.
Assign a stock to order lines created by repair synchronization	On	When GSX adds parts to a repair that aren't yet on the Fixably order, this assigns them to a stock (usually the location's default) so they show up correctly in inventory instead of sitting unassigned.

Order-closing and pricing settings

These settings act as guardrails around when an order can close and whether GSX can change prices your team already set:

Setting	Default	What it does
Set order status to “Awaiting parts” even if parts are available in stock	On	Forces every GSX repair to visibly pass through “Awaiting parts” once Apple releases it, even when the parts are already in stock. Useful if downstream automations, queues, or printouts key off that status.
Prevent closing orders before GSX repair is “Ready for Pickup”	Off	Blocks technicians from closing an order until Apple has marked the repair as ready for pickup.
Prevent closing an order without GSX repair	Off	Requires either a GSX Dispatch ID or a “Service Non-Repair” repair type before an order can be closed. A guardrail against orders being closed without ever going through GSX.
Prevent pricing updates on product parts	Off	Stops GSX price refreshes from overwriting the selling price you've already set on product parts.

Compliance settings

These settings help you stay within Apple's GSX guidelines and catch risky data before it reaches GSX:

Setting	Default	What it does
State used	On	Sends the customer's state, province, or region to GSX. Leave this on unless Apple has told you otherwise for your region.
Blacklisted email domains	Empty	Emails on these domains can't be used when creating a GSX repair. Useful for blocking obviously fake or test addresses from reaching Apple.
Use only “received in service location” for GSX received date	Off	When on, the GSX received date is based only on the first “received in service location” scan and ignores “received in store”. When off, whichever event happens first is used.
Enable daily/weekly device limit enforcement	Off	Shows a non-blocking confirmation, with a link to Apple's GSX guidelines, when the same customer brings in a 3rd or more Apple device the same day, or a 5th or more in the current week. It only warns — it never blocks repair creation. Applies to Apple devices only.
Warn when a part is not in the device's parts list	Off	Shows an advisory warning if a technician adds an Apple part that GSX doesn't list for that device's exact configuration. The part can still be added — this is a heads-up, not a block.

Here's how the order-closing guardrails and most of the compliance settings look together on the page (State used sits just above these, right after the connection fields):

Repair types and mail-in behavior

These settings decide which repair types your team can create and how mail-in and self-repair parts are handled:

Setting	Default	What it does
Repair types	CIN, WUMS, SVNR on	Chooses which repair types your team can create: Carry-In (CIN), Return Before Replace (CRBR), Whole Unit Mail-In (WUMS), Mail-In (MINS), Onsite Service Indirect (INON), and Service Non-Repair (SVNR). Only turn on the others if your team actually handles that workflow.
Support for GSX iPhone SUR consumables	On	Enables handling of Self Repair (SUR) consumable parts for iPhone.
Hide the Repair Vendor Quote (type DEP) line	On	Hides synchronizing DEP lines from order lines so customers and technicians don't see vendor-quote placeholders.
Hide non-billable mail-in parts added by Apple	On	Hides non-billable products that Apple automatically adds to mail-in repairs.
Update selling price when Apple substitutes a flat rate part on mail-in repairs	Off	When Apple substitutes a flat-rate part on a MINS or WUMS repair, this updates the order line's selling price to match the substitute part's GSX pricing option. Carry-in repairs and invoiced lines are never affected.
Suggest related AppleCare products	On	Prompts you to add a related AppleCare product whenever an AppleCare+ covered part is added to an order.

Here's how these settings look on the page, right down through the start of the printouts group:

Printouts and customer paperwork

These settings control what shows up on Apple's Consumer Law Claim form and other printed documents:

Setting	Default	What it does
Set the order store's name as the retailer in the CLC form	On	Prints the order's store name as the retailer on Apple's Consumer Law Claim form.
Set the order location's name as the retailer in the CLC form if the store is missing	Off	Fallback for orders that don't have a store set, so the CLC form still shows a retailer name.
Show KBB serial number on printouts	On	Adds the KBB board serial number to printed documents when it's available.
Show repair strategy full name in printouts	On	Prints the full repair-strategy name on paperwork instead of an abbreviation.

Notes, notifications, and reservations

These settings cover notes, reimbursements, and cleaning up stale Appointment Scheduler reservations:

Setting	Default	What it does
Add technician notes to order for declined repair	On	Records the technician's notes on the order when a repair is declined.
Import Apple repair notes to order	Off	Copies Apple's Repair Center, repair status, and review-result notes onto the order as internal notes every time the repair is synchronized.
Enable importing reimbursements via email	Off	Allows Apple reimbursement invoices received by email to be imported automatically. (Region Specific Feature)
Automatically close old reservations (with Automatic reservation closing limit)	On, 1 day	Automatically closes Appointment Scheduler draft orders and reservations older than the configured number of days, as long as they're have not been received to a location and have no technician assigned.

This is also where “Assign a stock to order lines” and “Show repair strategy full name in printouts” physically sit on the page, right before the Save Settings button:

Before you save

Apple also needs to whitelist Fixably's IP address for your account before the connection will work; the exact address is shown in the notice at the bottom of the settings page. After saving, use Test Connection to confirm GSX can be reached, and check the GSX Accounts tab if you need to share or manage individual GSX accounts across your team.

settings gsx