Trackline es una funcionalidad de la plataforma Code Contract que permite poder automatizar la recogida de información de principio a fin, sin cambiar la manera de trabajar y sin necesidad de registros.

Si deseas integrar Trackline con Salesforce para recuperar documentos y datos de procesos, puedes seguir estos pasos utilizando autenticación con Token JWT o API Key.

Paso 1: Obtener el token de autenticación o API Key

Salesforce debe autenticarse en la API de Trackline para poder realizar peticiones. Esto se puede hacer de dos formas:

Opción A: Autenticación con Token JWT

Salesforce puede autenticarse mediante una solicitud POST para obtener un token JWT. Este token será utilizado en las siguientes peticiones.

Petición desde Salesforce (HTTP Request):

http
CopyEditPOST /login HTTP/1.1  
Host: api.codecontractplattform.com  
Content-Type: application/json  

{
    "email": "sf_integration_user",
    "password": "salesforce_secure_password"
}

Respuesta esperada:

http
CopyEditHTTP/1.1 200 OK  
Content-Type: application/json  

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

El valor de token deberá almacenarse en Salesforce y enviarse en cada petición como Bearer Token en la cabecera de autorización.

Opción B: Autenticación con API Key

Desde el gestor de Code Contract, puedes generar una API Key para tu entorno. Esta clave puede utilizarse en lugar del token, añadiéndola en cada petición como cabecera personalizada.

Ejemplo de cabecera:

makefile
CopyEditx-api-key: TU_API_KEY_GENERADA

Paso 2: Consultar datos adicionales y archivos en Trackline desde Salesforce

Consultar datos adicionales de un Proceso

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

Petición desde Salesforce:

h
CopyEditGET /track-line/ext/track-path/metadata?process_id=12345 HTTP/1.1  
Host: eapi.codecontractplattform.com  
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcmV...

O bien usando API Key:

makefile
CopyEditx-api-key: TU_API_KEY_GENERADA

Respuesta esperada:

json
CopyEdit{
    "process_id": "12345",
    "name": "Proceso de Alta de Cliente",
    "status": "En Proceso",
    "created_at": "2025-04-01T09:30:00Z",
    "documents": [
        {
            "doc_id": "abc987",
            "doc_name": "Contrato_Alta_Cliente.pdf",
            "doc_type": "Contrato"
        }
    ]
}

Salesforce puede utilizar esta información para gestionar procesos y documentos de manera automatizada.

Descargar un archivo adjunto

Una vez obtenidos los metadatos, Salesforce puede descargar un archivo adjunto por su attachment_id.

Petición desde Salesforce:

http
CopyEditGET /track-line/ext/attachment/file?attachment_id=abc987 HTTP/1.1  
Host: eapi.codecontractplattform.com  
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJmcmV...

O bien usando API Key:

makefile
CopyEditx-api-key: TU_API_KEY_GENERADA

Respuesta esperada (Archivo):
El servidor responderá con un archivo PDF, XML u otro formato correspondiente, que Salesforce podrá almacenar o procesar.

Integración en Salesforce (Código de ejemplo en Apex)

Si se necesita integrar esta funcionalidad en Salesforce, se puede utilizar el siguiente código en Apex:

apex
CopyEdit// 1. Obtener el token de autenticación
HttpRequest req = new HttpRequest();
req.setEndpoint('https://api.codecontractplattform.com/api/login');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setBody('{"email": "sf_integration_user", "password": "salesforce_secure_password"}');

Http http = new Http();
HttpResponse res = http.send(req);

// Extraer token de respuesta
String token = (String) JSON.deserializeUntyped(res.getBody()).get('token');

// 2. Consultar datos adicionales del proceso en Trackline
HttpRequest metaReq = new HttpRequest();
metaReq.setEndpoint('https://api.codecontractplattform.com/api/track-line/ext/track-path/metadata?process_id=12345');
metaReq.setMethod('GET');
metaReq.setHeader('Authorization', 'Bearer ' + token);

// Si usas API Key, sustituye la línea anterior por:
// metaReq.setHeader('x-api-key', 'TU_API_KEY_GENERADA');

HttpResponse metaRes = http.send(metaReq);
System.debug('Respuesta: ' + metaRes.getBody());

Resumen

✔️ Paso 1: Salesforce obtiene el Token JWT mediante autenticación o usa una API Key
✔️ Paso 2: Salesforce consulta metadatos de procesos con process_id
✔️ Paso 3: Salesforce descarga archivos adjuntos mediante attachment_id
✔️ Paso 4: Salesforce puede automatizar estos procesos usando Apex u otras herramientas.

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