Trackline es una funcionalidad de la plataforma Code Contract que permite automatizar la recopilación de información sin modificar los procesos de trabajo y sin necesidad de registros manuales.

Si deseas integrar Trackline con Excel para recuperar documentos y datos de procesos, sigue estos pasos utilizando autenticación con Token JWT.

Paso 1: Obtener el token de autenticación

Excel debe autenticarse en la API de Trackline mediante una solicitud POST para obtener un token JWT. Este token será utilizado en las siguientes peticiones para autenticar las consultas.

Petición desde excel con power query (M Language)

let
    url = "https://api.codecontractplattform.com/api/login",
    body = "{""email"": ""myusername"", ""password"": ""mypassword""}",
    headers = [#"Content-Type"="application/json"],
    response = Json.Document(Web.Contents(url, [Content=Text.ToBinary(body), Headers=headers, ManualStatusHandling={400,404,500}])),
    token = response[token]
in
    token

Respuesta esperada

json
{
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcmV..."
}

El valor del token deberá almacenarse en Excel y utilizarse en cada consulta, enviándolo en la cabecera de autorización como Bearer Token.

Paso 2: Consultar metadatos de un proceso en Trackline desde Excel

Consultar información de un proceso

Excel puede obtener información sobre un proceso específico utilizando el process_id o process_name.

Petición desde excel con power query

let
    token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcmV...", // Reemplazar con token dinámico si se obtiene desde otra consulta
    url = "https://api.codecontractplattform.com/api/track-line/ext/track-path/metadata?process_id=12345",
    headers = [Authorization="Bearer " & token],
    response = Json.Document(Web.Contents(url, [Headers=headers]))
in
    response

Respuesta esperada (Formato JSON)

json
{
    "process_id": "12345",
    "name": "Proceso de Facturación",
    "status": "En Proceso",
    "created_at": "2024-02-09T10:30:00Z",
    "documents": [
        {
            "doc_id": "98765",
            "doc_name": "Factura_001.pdf",
            "doc_type": "Factura"
        }
    ]
}

Esta información se importará directamente a Excel, permitiendo gestionar los datos del proceso de forma automática.

Paso 3: Descargar un archivo adjunto en Trackline desde Excel

Una vez obtenidos los metadatos del proceso, Excel puede descargar un archivo adjunto mediante su attachment_id.

Petición desde Excel con Power Query

let
    token = "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcmV...", // Reemplazar con token dinámico
    attachment_id = "98765",
    url = "https://api.codecontractplattform.com/api/track-line/ext/attachment/file?attachment_id=" & attachment_id,
    headers = [Authorization="Bearer " & token],
    response = Web.Contents(url, [Headers=headers])
in
    response

Respuesta esperada

El servidor responderá con un archivo PDF, XML u otro formato, que Excel podrá descargar o abrir directamente.

Cómo guardar el archivo en Excel:

1. La consulta traerá el archivo como un binario.
2. Para guardarlo, usa Power Query con la opción Transformar → Cargar en y selecciona Tabla o Archivo.

Resumen de la Integración

✔️ Paso 1: Excel obtiene el Token JWT mediante autenticación en Trackline.
✔️ Paso 2: Excel consulta metadatos de procesos utilizando process_id o process_name.
✔️ Paso 3: Excel descarga archivos adjuntos mediante attachment_id.
✔️ Paso 4: Excel puede automatizar estos procesos usando Power Query, sin necesidad de VBA.

Si necesitas más información o soporte, contacta con el equipo de Code Contract. 🚀