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

# Configuración de Vantage Mobile Input

> Configure los enlaces de carga de Vantage Mobile Input: personalice los tipos de documento, las páginas, el URI de redirección, el idioma, el tema y otros parámetros del flujo de captura.

export const VantageRegion = ({children}) => {
  const STORAGE_KEY = "abbyy.vantage.region";
  const REGIONS = [{
    code: "eu",
    label: "Europe"
  }, {
    code: "us",
    label: "North America"
  }, {
    code: "au",
    label: "Australia / Asia-Pacific"
  }];
  const [region, setRegion] = useState("eu");
  const [open, setOpen] = useState(false);
  const containerRef = useRef(null);
  const dropdownRef = useRef(null);
  function safeGetSavedRegion() {
    try {
      const saved = typeof window !== "undefined" ? window.localStorage.getItem(STORAGE_KEY) : null;
      const valid = new Set(REGIONS.map(r => r.code));
      return saved && valid.has(saved) ? saved : "eu";
    } catch {
      return "eu";
    }
  }
  function safeSetSavedRegion(code) {
    try {
      if (typeof window !== "undefined") {
        window.localStorage.setItem(STORAGE_KEY, code);
      }
    } catch {}
  }
  function dispatchRegionChanged(code) {
    try {
      if (typeof window !== "undefined") {
        window.dispatchEvent(new CustomEvent("abbyy:region-changed", {
          detail: {
            code
          }
        }));
      }
    } catch {}
  }
  function replaceRegionInString(text, currentRegion) {
    if (typeof text !== "string") return text;
    const hostRegex = /https:\/\/vantage-(eu|us|au)\.abbyy\.com/gi;
    const tokenRegex = /https:\/\/vantage-\[region\]\.abbyy\.com/gi;
    const bareHostRegex = /vantage-(eu|us|au)\.abbyy\.com/gi;
    const bareTokenRegex = /vantage-\[region\]\.abbyy\.com/gi;
    return text.replace(hostRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(tokenRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(bareHostRegex, `vantage-${currentRegion}.abbyy.com`).replace(bareTokenRegex, `vantage-${currentRegion}.abbyy.com`);
  }
  useEffect(() => {
    setRegion(safeGetSavedRegion());
  }, []);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      const href = a.getAttribute("href");
      if (href) {
        const next = replaceRegionInString(href, region);
        if (next !== href) {
          a.setAttribute("href", next);
        }
      }
    });
    const walker = typeof document !== "undefined" ? document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null) : null;
    if (walker) {
      const toUpdate = [];
      let node = walker.nextNode();
      while (node) {
        const updated = replaceRegionInString(node.nodeValue, region);
        if (updated !== node.nodeValue) {
          toUpdate.push([node, updated]);
        }
        node = walker.nextNode();
      }
      toUpdate.forEach(([textNode, value]) => {
        textNode.nodeValue = value;
      });
    }
  }, [region, children]);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      a.style.fontWeight = "600";
      a.style.textDecoration = "underline";
      a.style.textUnderlineOffset = "2px";
    });
  }, [region, children]);
  useEffect(() => {
    const onRegionChanged = evt => {
      const code = evt && evt.detail && evt.detail.code;
      if (!code || code === region) return;
      setRegion(code);
    };
    if (typeof window !== "undefined") {
      window.addEventListener("abbyy:region-changed", onRegionChanged);
    }
    return () => {
      if (typeof window !== "undefined") {
        window.removeEventListener("abbyy:region-changed", onRegionChanged);
      }
    };
  }, [region]);
  useEffect(() => {
    const onClickAway = e => {
      if (!dropdownRef.current) return;
      if (!dropdownRef.current.contains(e.target)) {
        setOpen(false);
      }
    };
    document.addEventListener("click", onClickAway, true);
    return () => document.removeEventListener("click", onClickAway, true);
  }, []);
  const onSelect = code => {
    setRegion(code);
    safeSetSavedRegion(code);
    dispatchRegionChanged(code);
    setOpen(false);
  };
  const current = REGIONS.find(r => r.code === region) || REGIONS[0];
  return <div className="not-prose">
      <div className="mb-4 inline-flex items-center gap-2" ref={dropdownRef}>
        <span className="text-sm text-zinc-950/80 dark:text-white/80">Tenant Region:</span>
        <div className="relative">
          <button type="button" aria-haspopup="listbox" aria-expanded={open ? "true" : "false"} onClick={() => setOpen(v => !v)} className="h-8 px-3 rounded-md bg-zinc-900/5 dark:bg-white/5 border border-zinc-950/20 dark:border-white/20 text-sm inline-flex items-center gap-2">
            <span className="text-zinc-950 dark:text-white">{current.label}</span>
            <svg width="8" height="24" viewBox="0 -9 3 24" className="transition-transform text-gray-400 overflow-visible dark:text-gray-600 ml-auto" style={{
    transform: open ? "rotate(270deg)" : "rotate(90deg)"
  }}>
              <path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"></path>
            </svg>
          </button>
          {open ? <div role="listbox" className="absolute z-50 left-full top-0 ml-2 w-56 rounded-xl border border-zinc-950/20 dark:border-white/20 bg-white dark:bg-zinc-900 shadow-lg p-2">
              {REGIONS.map(r => {
    const selected = r.code === region;
    return <button key={r.code} type="button" role="option" aria-selected={selected ? "true" : "false"} onClick={() => onSelect(r.code)} className={"w-full flex items-center justify-between px-3 py-2 rounded-lg text-sm hover:bg-zinc-950/5 dark:hover:bg-white/10 text-zinc-950 dark:text-white" + (selected ? " font-medium" : "")}>
                    <span style={selected ? {
      color: "#ff2038"
    } : undefined}>{r.label}</span>
                    <span className={selected ? "ml-3" : "ml-3 invisible"} style={selected ? {
      color: "#ff2038"
    } : undefined}>✓</span>
                  </button>;
  })}
            </div> : null}
        </div>
      </div>
      <div ref={containerRef} className="prose dark:prose-invert max-w-none">{children}</div>
    </div>;
};

Puede configurar la función de carga desde dispositivos móviles utilizando los siguientes parámetros adicionales:

* [El Parameter md](#the-md-parameter) personaliza el número y los nombres de los documentos, junto con las páginas de cada documento que se capturarán en una única transacción.
* [El Parameter dt](#the-dt-parameter) personaliza la carga desde dispositivos móviles para capturar un único tipo de documento.
* [El Parameter redirect\_uri](#the-redirect-uri-parameter) personaliza un enlace web que se abrirá una vez finalizada la carga desde dispositivos móviles.
* [El Parameter ma](#the-ma-parameter) habilita el uso de microaplicaciones para entornos locales (on‑premises).

<div id="the-md-parameter">
  ## El Parameter md
</div>

Puede especificar la estructura de los documentos, incluyendo el número, tipos y nombres de los documentos que deben procesarse en una misma transacción, utilizando el Parameter `md`. Vantage Mobile Input guiará a los usuarios sobre cómo capturar con precisión los documentos especificados para su posterior procesamiento.

De forma predeterminada, el Parameter `md` está presente en el enlace de carga móvil con un valor de 0 o 1, según la skill seleccionada. Puede especificar uno de los siguientes valores:

| Valor                                                                      | Descripción                                                                                                                                        |
| :------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0`                                                                        | Captura un documento con cualquier número de páginas.                                                                                              |
| `1`                                                                        | Captura cualquier número de documentos con cualquier número de páginas.                                                                            |
| [Encoded URL to JSON file](/es/vantage/developer/mobile-upload/json-input) | Captura un número específico de documentos con nombres personalizados, junto con el número y los nombres definidos de páginas para cada documento. |
| [Encoded JSON file](/es/vantage/developer/mobile-upload/json-input)        | Captura un número específico de documentos con nombres personalizados, junto con el número y los nombres definidos de páginas para cada documento. |

<Info>
  El **archivo JSON** para el Parameter `md` solo está disponible para la carga móvil desde microaplicaciones.
</Info>

Ejemplo de uso de una URL codificada a un archivo JSON para el Parameter `md`:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=https%3A%2F%2Fdomain.tld%2Fstructure.json&token=<token>&v=<2.4>
  ```
</VantageRegion>

Ejemplo de cómo usar el archivo JSON codificado para el Parameter `md`:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=<encoded_json_structure>&token=<token>&v=<2.4>
  ```
</VantageRegion>

<Info>
  Si se usa el [Parameter dt](#the-dt-parameter) en el enlace de carga móvil, se ignorará el valor del `md` Parameter.
</Info>

<div id="the-dt-parameter">
  ## El Parameter dt
</div>

Para personalizar la carga móvil y capturar un único tipo de documento, usa el Parameter `dt`:

1. Añade el Parameter `dt` al enlace de carga móvil.
2. Especifica uno de los siguientes valores:

| Valor      | Descripción                                                           |
| :--------- | :-------------------------------------------------------------------- |
| `idcard`   | Captura ambos lados (anverso y reverso) de un documento de identidad. |
| `passport` | Captura la primera página de un pasaporte.                            |
| `document` | Captura cualquier otro documento.                                     |

<Info>
  El Parameter **dt** es opcional y no tiene un valor predeterminado.
</Info>

El uso del Parameter **dt** ajustará la cámara en la microaplicación para que los documentos de identidad se capturen automáticamente.

Ejemplo de uso del Parameter `dt` para capturar tarjetas de identidad:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&dt=idcard
  ```
</VantageRegion>

Ejemplo de uso del Parameter `dt` para capturar una página de pasaporte:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&dt=passport
  ```
</VantageRegion>

<Warning>
  Cuando se utiliza el Parameter **dt** en el enlace de carga móvil, solo se puede cargar un documento en una única transacción, independientemente de la skill seleccionada.
</Warning>

<div id="the-redirect_uri-parameter">
  ## El Parameter redirect\_uri
</div>

Puede personalizar un enlace de sitio web que se abrirá una vez que se haya completado la carga móvil y la transacción haya comenzado a procesarse. Esto le permite gestionar el flujo de trabajo del usuario después de que se complete la carga móvil. Para ello, añada el Parameter `redirect_uri` al enlace de carga móvil.

Ejemplo de uso del Parameter `redirect_uri`:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&redirect_uri=https%3A%2F%2Fyourwebsite.com
  ```
</VantageRegion>

<Warning>
  Cuando utilice el Parameter `redirect_uri`, asegúrese de añadir la URL base (por ejemplo, `https://www.example.com`) del sitio web que se abrirá en **Allowed redirect URLs** del cliente de API pública utilizado. Consulte [Configuring a Public API Client](/es/vantage/documentation/tenant-admin/tenant-management/configure-client#configuring-a-public-api-client) para obtener más información.
</Warning>

<div id="the-ma-parameter">
  ## El Parameter ma
</div>

De forma predeterminada, la carga móvil en entornos on-premises solo es posible mediante un navegador web. Para habilitar el uso de microaplicaciones en entornos on-premises, use el Parameter `ma`:

1. Agregue el Parameter `ma` al enlace de carga móvil.
2. Especifique uno de los entornos en la nube de ABBYY Vantage.

En este caso, la carga móvil se redirigirá a uno de los entornos en la nube de ABBYY Vantage para iniciar una microaplicación en el dispositivo móvil del usuario. Todos los documentos se cargarán directamente en la instalación on-premises de ABBYY Vantage.

Ejemplos de uso del Parameter `ma`:

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&ma=<https%3A%2F%2Fvantage-eu.abbyy.com>
  ```
</VantageRegion>

(ubicado en Europa occidental),

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&ma=<https%3A%2F%2Fvantage-us.abbyy.com>
  ```
</VantageRegion>

(ubicado en Norteamérica),

<VantageRegion>
  ```
  https://vantage-us.abbyy.com/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&token=<token>&v=<2.4>&ma=<https%3A%2F%2Fvantage-au.abbyy.com>
  ```
</VantageRegion>

(ubicado en Australia).