¿Como obtener el enlace publico de una factura desde la API de Alegra?

Alegra API
, , , ,
1

¡Hola comunidad!

Estoy trabajando en una integración con Alegra y quería consultar sobre la funcionalidad para compartir facturas mediante un enlace público.

He visto que desde el portal de Alegra, cada factura puede compartirse a través de un enlace similar a este:

https://portal.alegra.com/new-statement/c325t03ff0720a0aef3qad00a2300610cqea4884?redirect=https://portal.alegra.com/document/invoice/ID/id/50

https://portal.alegra.com/new-statement/c325t03ff0720a0aef3qad00a2300610cqea4884?redirect=https://portal.alegra.com/document/invoice/ID/id/52

https://portal.alegra.com/new-statement/c325t03ff0720a0aef3qad00a2300610cqea4884?redirect=https://portal.alegra.com/document/invoice/ID/id/53

Mi consulta es la siguiente:

1 ¿Alguien sabe si existe alguna forma de obtener este enlace público directamente desde la API? Y si es así, ¿cuál sería el método o endpoint a utilizar?

2 En caso de que no sea posible obtener el link completo, ¿alguien conoce si hay forma de obtener ese hash que aparece después de new-statement/ (por ejemplo: c325t03ff0720a0aef3qad00a2300610cqea4884) mediante la API o algún otro mecanismo?

La idea es poder generar facturas vía API y luego incluir este enlace público en los recibos que se muestran en nuestro sitio web, para que los clientes puedan acceder fácilmente a su factura oficial.

¡Agradezco cualquier experiencia, sugerencia o dato técnico que puedan compartir!

2

¡Hola @CanguroHosting! :wave:

Para este proceso puedes realizarlo de la siguiente manera :arrow_down:

  1. Para generar el link de acceso al portal del cliente Alegra podrías utilizar el endpoint para obtener detalle de un contacto GET https://api.alegra.com/api/v1/contacts{id}?fields=statementLink. Agregando el parámetro fields=statementLink, el sistema devuelve la URL para acceder al portal del cliente para ese contacto en particular. Sin embargo, no redirige a la factura específica, sino que el usuario verá su estado de cuenta completo de ese cliente en particular. Acá la documentación :point_left:

  2. También, puedes enviar el Estado de cuenta, si tienes activadas estas opciones en el menú Configuración > Facturación > Datos generales: - Incluir estado de cuenta cliente en facturas - Envío automático de documentos electrónicos.
    Teniendo estas activadas, cada vez que se emita una factura se enviará un correo automático al correo que tenga registrado el contacto, con la Factura en formato PDF y un link para acceder al Portal de clientes.