Saltar al contenido principal
​
2.0
Notas de la versión

​
Cambios

✓ Se cambió el nombre de public-schema.json a schema-vantage-transactions-api.json para aclarar su propósito (úselo con la acción Parse JSON).✓ Se cambió el nombre de ABBYY-Vantage.swagger.json a ABBYY-Vantage-ProcessingAPI.swagger.json para aclarar que es para la API de procesamiento.✓ Se eliminaron ejemplos de flujos desactualizados y se agregó un ejemplo actualizado del flujo de Invoice.✓ Se eliminaron la guía en PDF y las notas de la versión, y se trasladaron a este sitio de documentación.✓ Se agregó el logotipo de Vantage Vantage-Square-icon.png para usarlo opcionalmente como icono del conector.

​
Actualización de la versión 1.3 a la 2.0

  1. Busque el conector en Custom Connectors. Haga clic en el menú … y luego elija Update from OpenAPI file.
  2. Realice las siguientes actualizaciones en la configuración del conector: Pestaña General:
    • [Opcional] Cargue un icono del conector usando el icono de Vantage incluido recientemente.
    • Verifique que el Host coincida con su región de Vantage.
    Pestaña Security:
    • Client Id y Client Secret: Power Automate requiere que vuelva a introducir estos valores. Para obtenerlos, abra su tenant de Vantage y vaya a su cliente de API pública. Si ya no tiene el secreto de cliente, genere uno nuevo.
    • Authorization URL, Token URL y Refresh URL: Se recomienda actualizar estos valores para incluir el ID de su tenant de Vantage. Esto reduce los problemas de conexión al migrar de Vantage 2.7 a 3.0 y versiones posteriores. Un ejemplo de URL es: https://vantage-us.abbyy.com/auth2/c5a3cc2f-853e-43f5-890c-b5ab2024e7b8/connect/authorize.
    • Scope: Asegúrese de que esté configurado como openid permissions global.wildcard offline_access. El valor anterior, publicapi:all, ya no es válido.
Guarde los cambios haciendo clic en Update connector en la parte superior de la página.
  1. En la pestaña Test, use la conexión anterior o elija New connection y vuelva a autenticar su cuenta. Seleccione la operación ListAllAvailableSkills y haga clic en Test operation. Si la respuesta muestra Status (200), ya está todo listo.
  2. Revise y pruebe sus flujos de Power Automate para asegurarse de que funcionen correctamente.
​
1.3
Notas de la versión

​
Información sobre esta versión

Esta versión añade compatibilidad con el refresh token de Vantage Public API, lo que permite que la conexión permanezca activa hasta 30 días.
Después de 30 días, el cliente debe volver a autenticarse. Esta es una limitación conocida.

​
Procedimiento de actualización

  1. En Power Automate, vaya a Data > Custom connectors y edite su conector personalizado de ABBYY Vantage.
  2. En el editor del conector, vaya a la pestaña Security y haga clic en Edit. Pestaña Security del editor del conector que muestra el botón Edit en el tipo de autenticación OAuth 2.0
  3. Rellene los campos que se borran al entrar en el modo de edición:
    • Client ID: ABBYY.PowerAutomate
    • secreto de cliente: Vezu_jgEw8kFi1ugXb66s2buh6ZC1M-Uf9
    • Refresh URL: el mismo endpoint que Token URL — https://<vantage_server_address>/auth2/connect/token
  4. Añada offline_access al campo Scope para que quede así: openid permissions publicapi:all offline_access Configuración de seguridad de OAuth 2.0 con los campos Client ID, secreto de cliente, Authorization URL, Token URL, Refresh URL y Scope rellenados
  5. Haga clic en Update connector. Toolbar del editor del conector con el botón Update connector resaltado
  6. Vaya a Data > Connections y haga clic en Fix connection para corregir la conexión que no funciona. Lista de Connections que muestra la conexión de ABBYY Vantage con un enlace Fix connection Como alternativa, haga clic en Switch account en el menú contextual de la conexión y vuelva a iniciar sesión. Menú contextual de Connections que muestra la opción Switch account
Después de completar estos pasos, los flujos dejarán de fallar por un token vencido.

​
Correcciones de errores

✓ Power Automate Connector cierra la sesión después de 24 horas. (CONN-3066)

​
Problemas conocidos

  • CONN-2402: Agregar métodos adicionales de Vantage API a la descripción de Swagger.
  • CONN-2691: Error “The image file format has not been recognized” al cargar documentos en un flujo de Power Automate (flujos de prueba específicos).
  • CONN-3058: Ampliar los flujos de ejemplo del conector para incluir más escenarios de uso de Vantage API.
  • CONN-3090: El token de autenticación vence después de 30 días, incluso cuando se usa un refresh token.