# FFL Scope

{% hint style="info" %}
If you do not already have a FFL Scope account please sign up before proceeding.
{% endhint %}

#### Plugin Activation <a href="#fflscope-pluginactivation" id="fflscope-pluginactivation"></a>

* Navigate to Admin → Plugins → Data Sources
* Click on the FFL Scope tile and click the green “Activate” button
* Enter **username** and **password** from your FFL Scope account
* Once both values are entered, click the green “Connect” button to complete the Plugin Activation

<figure><img src="/files/L7sGrt0KtKU7WTIEJmWL" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QHnjicFM2hPovLlJNMa9" alt=""><figcaption></figcaption></figure>

#### Regions and Products <a href="#fflscope-regionsandproducts" id="fflscope-regionsandproducts"></a>

Edit the plugin. There is a Region Routing panel available to select geographic regions and products for which to require FFL selection. Press the **+Route** button to enter a product tag and region. Do this as many times as needed to fully define the requirements of your sales geography.

<figure><img src="/files/UMmUfxSP5d95rAxjk9JY" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FcbSKvdKmscKdxZd0GiR" alt=""><figcaption></figcaption></figure>

#### FlxPoint fulfillment <a href="#fflscope-flxpointfulfillment" id="fflscope-flxpointfulfillment"></a>

FlxPoint is the only fulfillment house with a tight integration to FFL Scope. FLL Number is automatically sent to FlxPoint with each order, if available.

For any other uses, FFL Number is included on the Order Details Report csv export and the Order Query API response, if **includeCustomFields** is passed in the request.

#### Checkout Champ Pages <a href="#fflscope-checkoutchamppages" id="fflscope-checkoutchamppages"></a>

Checkout Champ Checkout and Upsell pages automatically require FFL selection if FFL Scope is enabled and the shipping address and any products in the cart match a region defined on the plugin.

* The FFL selection window will automatically display if the page is submitted with a FFL item (based on shipping address and product tags) and the FFL selection is not already complete.
* If FFL is selected on the Checkout page then it will not be requested again on Upsell pages on the same order.
* A button may be placed on the page for the consumer to launch the FFL selection window. Create a div with class ffl-number. Inside that div place any elements you wish to display when an FFL item is in the cart. If there is a FFL item in the cart then the div will be visible. If there are no FFL items in the cart then the div will the hidden. Any buttons or links inside the div will automatically be set to display the FFL selection window.
* When FFL products and non-FFL products are on the same order it is possible to split the order shipments through FlxPoint so the FFL items go to the dealer and the non-FFL items go to the order shipping address. Place a hidden form checkbox on the page and give it name = fflSplit. Uncheck it by default. If this is not present on the page then all items are shipped to the FFL selection.
* FFL dealers can be searched by zip code, number, or name.

<figure><img src="/files/uQcKEArX0fFI8PJStBHx" alt=""><figcaption></figcaption></figure>

#### Non-Checkout Champ Pages <a href="#fflscope-non-checkoutchamppages" id="fflscope-non-checkoutchamppages"></a>

Please contact your Account Manager if you need to offer FFL selection on your hosted site.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.checkoutchamp.com/crm/plugins/data-sources/ffl-scope.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.