> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Saint Johns Capital Factoring Integration

> Connect Saint Johns Capital (SJC) to Alvys via a two-way API to submit invoice batches for factoring and run automatic broker credit checks in real time.

<Note>
  Saint Johns Capital connects to Alvys via a two-way API to automate invoice submission and broker credit checks for factoring clients. Synonyms: Saint John Capital, SJC, Saint Johns factoring.
</Note>

## What This Integration Does?

Saint Johns Capital connects to Alvys through a two-way API. When a batch is submitted, Alvys sends invoice data to Saint Johns Capital directly. Saint Johns Capital also performs automatic and manual broker credit checks, returning results to Alvys in real time.

## Prerequisites

* Active account with Saint Johns Capital
* Client ID provided by Saint Johns Capital
* Notice of Assignment text provided by Saint Johns Capital
* Admin, Partner Admin, or Support access to configure the integration
* **"Billing"** permission to submit batches
* MC number set on each customer/broker that will be included in a batch

## Connect / Authenticate

Note: This integration uses an API connection.

### Part 1: Configure Your Notice of Assignment

* Navigate to Management > Company Profile.
* In the **General Info** tab, locate the **Important Information** section. Click the **(+)** button. The Manage Important Info pop-up opens.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/3ff870e47314.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=5c16d4b596d6d45ce7381a49eae0b2f0" alt="Company Profile General Info tab showing Important Information section with (+) button" width="2000" height="954" data-path="images/help/3ff870e47314.png" />

  * Company Profile General Info tab showing Important Information section with (+) button\*
</Note>

* In the drop-down menu, select **Notice of Assignment**. Copy and paste the Notice of Assignment text provided by Saint Johns Capital.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/125de0485637.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=2e4f2f71cbe3ceeef14616db3d2a0634" alt="Manage Important Info pop-up with Notice of Assignment selected and text pasted" width="960" height="738" data-path="images/help/125de0485637.png" />

  \*Manage Important Info pop-up with Notice of Assignment selected and text pasted \*
</Note>

* Click **Save**.

### Part 2: Configure the Saint Johns Capital Integration

* Navigate to Management > Integrations.
* Select the subsidiary you want to configure. Expand the **Factoring** section. Click the “I**nactive**” button to **Saint John Capital**.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/179803ccfb38.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=2f5ac22f947fc0c2a8e8bceb78954371" alt="Integrations page showing Factoring section expanded with Saint John Capital “Inactive” button visible" width="402" height="130" data-path="images/help/179803ccfb38.png" />

  *Integrations page showing Factoring section expanded with Saint John Capital “**Inactive**” button visible*
</Note>

* Enter your **Client ID** provided by Saint Johns Capital.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/d10ff1ce6c80.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=7abfdd408c6b5e34639449ffc43fe4db" alt="Add Integration dialog with Client ID field" width="790" height="434" data-path="images/help/d10ff1ce6c80.png" />

  *Add Integration dialog with Client ID field*
</Note>

* Click the blue **Save** button.

If you have multiple subsidiaries with Saint Johns Capital accounts, repeat the four configuration actions above for each subsidiary.

## Field & Data Mapping

Alvys sends invoice data to Saint Johns Capital, including load number, debtor information, invoice amount, and MC number. Alvys also sends three supporting documents for each invoice: the Bill of Lading (or Rate Confirmation if no Bill of Lading is present), the Rate Confirmation as a separate rate sheet, and the Receipt. Each document type is submitted in a separate field. The customer's MC number must be set in Alvys before a load can be included in a batch.

## Sync Behavior

Credit check results sync automatically from Saint Johns Capital to Alvys. Invoice batch data flows from Alvys to Saint Johns Capital at submission. There is no automated nightly batch sync; load status updates depend on batch submission.

## Submit a Batch

* Navigate to **Accounting > Factoring Upload**. All loads must have a **Queued** status with invoicing method set to factoring.
* Select the correct subsidiary.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/1bd279dde7e7.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=476ca1f0764140ce541a98c4417edec0" alt="Subsidiary selector on Factoring Upload page" width="2000" height="880" data-path="images/help/1bd279dde7e7.png" />

  *Subsidiary selector on Factoring Upload page*
</Note>

* Select the invoices to include in the batch. Ensure the MC number is set for each customer.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/fd69e49577d8.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=8b6b8328a322f61c821fc5cb66a50e74" alt="Load list with checkboxes on Factoring Upload page" width="2000" height="813" data-path="images/help/fd69e49577d8.png" />

  *Load list with checkboxes on Factoring Upload page*
</Note>

* Click **Submit Batch**. A pop-up appears.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/f1c914f83d84.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=b8c222bc25513bd629ca662fb7ac2825" alt="Submit Batch button on Factoring Upload page" width="380" height="136" data-path="images/help/f1c914f83d84.png" />

  * Submit Batch button on Factoring Upload page\*
</Note>

* In the pop-up, select the **Funding Method**: Wire, ACH, Fuel Card, or Visa. Select the **Payment Date** using the calendar.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/2fc65dfba571.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=7fef205a1194adebf7348f39dde28822" alt="Batch submission pop-up showing Funding Method selector and Payment Date calendar" width="950" height="463" data-path="images/help/2fc65dfba571.png" />

  *Batch submission pop-up showing Funding Method selector and Payment Date calendar*
</Note>

* Confirm the submission. Wait until the process is complete. Do not close this page or navigate away; doing so may disrupt the submission.

## Broker Credit Checks

Saint Johns Capital performs broker credit checks to assess whether a broker is eligible for factoring. Credit check results appear as colored icons next to the customer/broker name:

* Green: Approved
* Red: Declined
* Grey: Unknown (no credit check has been performed yet)

### Automatic Credit Checks

Alvys automatically triggers a credit check in two situations:

* When a load is created: if the last credit check for that broker was performed more than 24 hours ago
* When a load reaches **Queued** status: if the last credit check was more than 24 hours ago

### Manually Trigger a Credit Check from a Customer/Broker Profile

* Navigate to the customer or broker profile.
* Add a factoring invoicing method to the subsidiary where the Saint Johns Capital integration was added, then save. This step is required before the refresh icon (↻) becomes visible.
* Click the refresh icon **(↻)** next to the customer or broker name to trigger a credit check. The credit check result icon updates next to the customer/broker name.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/ad4ace4caa56.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=0000c87d93db30be556431a4ae1db94c" alt="Credit check status icons: green (Approved)" width="770" height="129" data-path="images/help/ad4ace4caa56.png" />

  *Credit check status icons: green (Approved)*

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/412a81267bbb.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a53c8e584c6e9e6f122a1de3317600af" alt="Credit check status icons: red (Declined)" width="580" height="163" data-path="images/help/412a81267bbb.png" />

  *Credit check status icons: red (Declined)*

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/740e3691534a.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=461834491a8d2324eb5bb0797af8bf13" alt="Credit check status icons: grey (Unknown)" width="910" height="119" data-path="images/help/740e3691534a.png" />

  * Credit check status icons: grey (Unknown)\*
</Note>

### Manually Trigger a Credit Check from a Load Details Page

* Open or create a load. Confirm the customer has a subsidiary with the factoring invoicing method assigned.
* On the load details page, click the refresh icon **(↻)** to trigger a credit check.

<Note>
  Load details page showing refresh icon (↻)

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/151f3f42c5f4.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=fbe6a25add4019552059337c5303f156" alt="Notion Image" width="1120" height="623" data-path="images/help/151f3f42c5f4.png" />
</Note>

### Submit a Load Based on Credit Check Status

1. Select or create a load with a customer assigned to the subsidiary using the factoring invoicing method.
2. Advance the load to **Released** status.
3. Click **Invoice Load** to generate the invoice.
4. Merge the required documents: Customer Rate Confirmation, Proof of Delivery (POD), and the invoice. The load moves to **Queued** status.
5. Navigate to **Accounting > Factoring Upload**. Select the load and submit the batch.

<Note>
  Factoring Upload page with the load selected for batch submission

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/986417c9443e.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=08bcd7fe4014559fe022ada210a49673" alt="Notion Image" width="2000" height="32" data-path="images/help/986417c9443e.png" />
</Note>

## Verify It's Working?

After submitting a batch, confirm that the selected loads have moved from **Queued** status to **Invoiced** status. Credit check results should appear as colored icons next to customer/broker names within a few seconds of triggering a check.

## Troubleshooting

### Batch submission fails?

1. Confirm the customer's MC number is set. Navigate to the customer/broker profile and verify the MC number field is populated. A load cannot be submitted without it.
2. Confirm the subsidiary has a valid Client ID configured in Management > Integrations.
3. Contact Alvys support if the batch continues to fail after confirming the above.

### Credit check icon does not appear?

1. Confirm the customer has a factoring invoicing method assigned to the subsidiary where the Saint Johns Capital integration is configured.
2. Confirm the integration is active in Management > Integrations.
3. Trigger the credit check manually using the refresh icon (↻). If the icon does not appear after confirming both steps above, contact Alvys support.

## Limits / Unsupported

Each subsidiary must have its own Client ID configured separately. A single Client ID cannot apply across multiple subsidiaries.

## FAQs

**Q: What credit check statuses does Saint Johns Capital return?**

**A:** Saint Johns Capital returns three statuses: green (Approved), red (Declined), and grey (Unknown). There is no additional status for this integration.

**Q: What is the Notice of Assignment and where does the text come from?**

**A:** The Notice of Assignment is a document that informs customers that their receivables have been assigned to a factoring company. Saint Johns Capital provides the text when you set up your account with them.

**Q: Can I submit a load even if the credit check status is grey or red?**

**A:** Yes. The credit check status is informational. You can submit a load regardless of the result. Contact Saint Johns Capital directly if you have questions about a specific broker's eligibility.
