> ## 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.

# Integración de factoring Saint Johns Capital

> Conecte Saint Johns Capital (SJC) a Alvys mediante una API bidireccional para enviar lotes de facturas para factoring y ejecutar verificaciones de crédito de corredores automáticas en tiempo real.

<Note>
  **Se aplica a:** Admins · Partner Admins · personal de Support

  **Módulo:** Management > Integrations · Management > Company Profile · Accounting > Factoring Upload

  **Proveedor:** Saint Johns Capital · **Tipo de integración:** API bidireccional · **Dirección de sincronización:** Alvys envía lotes de facturas a Saint Johns Capital; Saint Johns Capital devuelve resultados de verificación de crédito a Alvys

  Saint Johns Capital se conecta a Alvys mediante una API bidireccional para automatizar el envío de facturas y las verificaciones de crédito de corredores para clientes de factoring. Sinónimos: Saint John Capital, SJC, factoring Saint Johns.
</Note>

## ¿Qué hace esta integración?

Saint Johns Capital se conecta a Alvys mediante una API bidireccional. Cuando se envía un lote, Alvys envía datos de factura a Saint Johns Capital directamente. Saint Johns Capital también realiza verificaciones de crédito de corredores automáticas y manuales, devolviendo resultados a Alvys en tiempo real.

## Requisitos previos

* Cuenta activa con Saint Johns Capital
* Client ID proporcionado por Saint Johns Capital
* Texto Notice of Assignment proporcionado por Saint Johns Capital
* Acceso Admin, Partner Admin o Support para configurar la integración
* Permiso **"Billing"** para enviar lotes
* Número MC configurado en cada cliente/corredor que se incluirá en un lote

## Conectar / autenticar

Nota: Esta integración usa una conexión API.

### Parte 1: Configurar su Notice of Assignment

* Vaya a Management > Company Profile.
* En la pestaña **General Info**, localice la sección **Important Information**. Haga clic en el botón **(+)**. Se abre la ventana emergente Manage Important Info.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/3ff870e47314.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=5c16d4b596d6d45ce7381a49eae0b2f0" alt="Pestaña General Info de Company Profile que muestra la sección Important Information con el botón (+)" width="2000" height="954" data-path="images/help/3ff870e47314.png" />

  * Pestaña General Info de Company Profile que muestra la sección Important Information con el botón (+)\*
</Note>

* En el menú desplegable, seleccione **Notice of Assignment**. Copie y pegue el texto Notice of Assignment proporcionado por 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="Ventana emergente Manage Important Info con Notice of Assignment seleccionado y texto pegado" width="960" height="738" data-path="images/help/125de0485637.png" />

  \*Ventana emergente Manage Important Info con Notice of Assignment seleccionado y texto pegado \*
</Note>

* Haga clic en **Save**.

### Parte 2: Configurar la integración Saint Johns Capital

* Vaya a Management > Integrations.
* Seleccione la subsidiaria que desea configurar. Expanda la sección **Factoring**. Haga clic en el botón "**Inactive**" de **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="Página Integrations que muestra la sección Factoring expandida con el botón &#x22;Inactive&#x22; de Saint John Capital visible" width="402" height="130" data-path="images/help/179803ccfb38.png" />

  *Página Integrations que muestra la sección Factoring expandida con el botón "**Inactive**" de Saint John Capital visible*
</Note>

* Introduzca su **Client ID** proporcionado por 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="Diálogo Add Integration con el campo Client ID" width="790" height="434" data-path="images/help/d10ff1ce6c80.png" />

  *Diálogo Add Integration con el campo Client ID*
</Note>

* Haga clic en el botón azul **Save**.

Si tiene varias subsidiarias con cuentas Saint Johns Capital, repita las cuatro acciones de configuración anteriores para cada subsidiaria.

## Field & Data Mapping

Alvys envía datos de factura a Saint Johns Capital, incluidos número de carga, información del deudor, importe de factura y número MC. Alvys también envía tres documentos de respaldo para cada factura: el Bill of Lading (o Rate Confirmation si no hay Bill of Lading), el Rate Confirmation como hoja de tarifas separada y el Receipt. Cada tipo de documento se envía en un campo separado. El número MC del cliente debe configurarse en Alvys antes de que una carga pueda incluirse en un lote.

## Comportamiento de sincronización

Los resultados de verificación de crédito se sincronizan automáticamente de Saint Johns Capital a Alvys. Los datos del lote de facturas fluyen de Alvys a Saint Johns Capital en el momento del envío. No hay sincronización automática nocturna de lotes; las actualizaciones de estado de carga dependen del envío de lotes.

## Enviar un lote

* Vaya a **Accounting > Factoring Upload**. Todas las cargas deben tener estado **Queued** con método de facturación configurado en factoring.
* Seleccione la subsidiaria correcta.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/1bd279dde7e7.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=476ca1f0764140ce541a98c4417edec0" alt="Selector de subsidiaria en la página Factoring Upload" width="2000" height="880" data-path="images/help/1bd279dde7e7.png" />

  *Selector de subsidiaria en la página Factoring Upload*
</Note>

* Seleccione las facturas que desea incluir en el lote. Asegúrese de que el número MC esté configurado para cada cliente.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/fd69e49577d8.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=8b6b8328a322f61c821fc5cb66a50e74" alt="Lista de cargas con casillas en la página Factoring Upload" width="2000" height="813" data-path="images/help/fd69e49577d8.png" />

  *Lista de cargas con casillas en la página Factoring Upload*
</Note>

* Haga clic en **Submit Batch**. Aparece una ventana emergente.

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

  * Botón Submit Batch en la página Factoring Upload\*
</Note>

* En la ventana emergente, seleccione el **Funding Method**: Wire, ACH, Fuel Card o Visa. Seleccione la **Payment Date** usando el calendario.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/2fc65dfba571.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=7fef205a1194adebf7348f39dde28822" alt="Ventana emergente de envío de lote que muestra el selector Funding Method y el calendario Payment Date" width="950" height="463" data-path="images/help/2fc65dfba571.png" />

  *Ventana emergente de envío de lote que muestra el selector Funding Method y el calendario Payment Date*
</Note>

* Confirme el envío. Espere hasta que se complete el proceso. No cierre esta página ni navegue fuera; hacerlo puede interrumpir el envío.

## Verificaciones de crédito de corredores

Saint Johns Capital realiza verificaciones de crédito de corredores para evaluar si un corredor es elegible para factoring. Los resultados de verificación de crédito aparecen como iconos de colores junto al nombre del cliente/corredor:

* Verde: Approved
* Rojo: Declined
* Gris: Unknown (aún no se ha realizado ninguna verificación de crédito)

### Verificaciones de crédito automáticas

Alvys activa automáticamente una verificación de crédito en dos situaciones:

* Cuando se crea una carga: si la última verificación de crédito para ese corredor se realizó hace más de 24 horas
* Cuando una carga alcanza estado **Queued**: si la última verificación de crédito fue hace más de 24 horas

### Activar manualmente una verificación de crédito desde un perfil de cliente/corredor

* Vaya al perfil del cliente o corredor.
* Agregue un método de facturación de factoring a la subsidiaria donde se agregó la integración Saint Johns Capital, luego guarde. Este paso es necesario antes de que el icono de actualización (↻) sea visible.
* Haga clic en el icono de actualización **(↻)** junto al nombre del cliente o corredor para activar una verificación de crédito. El icono de resultado de verificación de crédito se actualiza junto al nombre del cliente/corredor.

<Note>
  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/ad4ace4caa56.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=0000c87d93db30be556431a4ae1db94c" alt="Iconos de estado de verificación de crédito: verde (Approved)" width="770" height="129" data-path="images/help/ad4ace4caa56.png" />

  *Iconos de estado de verificación de crédito: verde (Approved)*

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/412a81267bbb.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=a53c8e584c6e9e6f122a1de3317600af" alt="Iconos de estado de verificación de crédito: rojo (Declined)" width="580" height="163" data-path="images/help/412a81267bbb.png" />

  *Iconos de estado de verificación de crédito: rojo (Declined)*

  <img src="https://mintcdn.com/alvys/NbezcQvwUCJbTEUv/images/help/740e3691534a.png?fit=max&auto=format&n=NbezcQvwUCJbTEUv&q=85&s=461834491a8d2324eb5bb0797af8bf13" alt="Iconos de estado de verificación de crédito: gris (Unknown)" width="910" height="119" data-path="images/help/740e3691534a.png" />

  * Iconos de estado de verificación de crédito: gris (Unknown)\*
</Note>

### Activar manualmente una verificación de crédito desde una página de detalles de carga

* Abra o cree una carga. Confirme que el cliente tiene una subsidiaria con el método de facturación de factoring asignado.
* En la página de detalles de la carga, haga clic en el icono de actualización **(↻)** para activar una verificación de crédito.

<Note>
  Página de detalles de carga que muestra el icono de actualización (↻)

  <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>

### Enviar una carga según el estado de verificación de crédito

1. Seleccione o cree una carga con un cliente asignado a la subsidiaria que usa el método de facturación de factoring.
2. Avance la carga al estado **Released**.
3. Haga clic en **Invoice Load** para generar la factura.
4. Combine los documentos requeridos: Customer Rate Confirmation, Proof of Delivery (POD) y la factura. La carga pasa al estado **Queued**.
5. Vaya a **Accounting > Factoring Upload**. Seleccione la carga y envíe el lote.

<Note>
  Página Factoring Upload con la carga seleccionada para envío de lote

  <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>

## ¿Verificar que funciona?

Después de enviar un lote, confirme que las cargas seleccionadas han pasado del estado **Queued** al estado **Invoiced**. Los resultados de verificación de crédito deberían aparecer como iconos de colores junto a los nombres de cliente/corredor en unos segundos después de activar una verificación.

## Solución de problemas

### ¿El envío del lote falla?

1. Confirme que el número MC del cliente está configurado. Vaya al perfil del cliente/corredor y verifique que el campo MC number esté completado. Una carga no puede enviarse sin él.
2. Confirme que la subsidiaria tiene un Client ID válido configurado en Management > Integrations.
3. Contacte con el soporte de Alvys si el lote sigue fallando después de confirmar lo anterior.

### ¿El icono de verificación de crédito no aparece?

1. Confirme que el cliente tiene un método de facturación de factoring asignado a la subsidiaria donde está configurada la integración Saint Johns Capital.
2. Confirme que la integración está activa en Management > Integrations.
3. Active la verificación de crédito manualmente usando el icono de actualización (↻). Si el icono no aparece después de confirmar ambos pasos, contacte con el soporte de Alvys.

## Límites / no admitido

Cada subsidiaria debe tener su propio Client ID configurado por separado. Un solo Client ID no puede aplicarse a varias subsidiarias.

## Preguntas frecuentes

**P: ¿Qué estados de verificación de crédito devuelve Saint Johns Capital?**

**R:** Saint Johns Capital devuelve tres estados: verde (Approved), rojo (Declined) y gris (Unknown). No hay un estado adicional para esta integración.

**P: ¿Qué es el Notice of Assignment y de dónde proviene el texto?**

**R:** El Notice of Assignment es un documento que informa a los clientes que sus cuentas por cobrar han sido cedidas a una empresa de factoring. Saint Johns Capital proporciona el texto cuando configura su cuenta con ellos.

**P: ¿Puedo enviar una carga aunque el estado de verificación de crédito sea gris o rojo?**

**R:** Sí. El estado de verificación de crédito es informativo. Puede enviar una carga independientemente del resultado. Contacte directamente con Saint Johns Capital si tiene preguntas sobre la elegibilidad de un corredor específico.
