Conoce paso a paso como integrar Trackline con SAP

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 SAP para recuperar documentos y datos de procesos, puedes seguir estos pasos utilizando autenticación con Token JWT.

Paso 1: Obtener el token de autenticación

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

Petición desde SAP (HTTP Request)

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

{
    "email": "sap_integration_user",
    "password": "sap_secure_password"
}

Respuesta esperada

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

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

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

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

Consultar datos adicionales de un Proceso

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

Petición desde SAP

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

Respuesta esperada

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

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

Descargar un archivo adjunto

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

Petición desde SAP

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

Respuesta esperada (Archivo)

El servidor responderá con un archivo PDF, XML o el formato correspondiente, el cual SAP podrá almacenar o procesar.

Integración en SAP (Código de Ejemplo en ABAP)

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

abap
DATA: lv_url TYPE string,
      lv_token TYPE string,
      lo_http_client TYPE REF TO if_http_client,
      lv_response TYPE string.

* 1. Obtener el token de autenticación
lv_url = 'https://api.codecontractplattform.com/api/login'.
CALL METHOD cl_http_client=>create_by_url
  EXPORTING
    url    = lv_url
  IMPORTING
    client = lo_http_client.

lo_http_client->request->set_header_field( name = 'Content-Type' value = 'application/json' ).
lo_http_client->request->set_cdata( '{"email": "sap_integration_user", "password": "sap_secure_password"}' ).

CALL METHOD lo_http_client->send.
CALL METHOD lo_http_client->receive.

lv_response = lo_http_client->response->get_cdata( ).

* Extraer token de respuesta (ejemplo simple)
lv_token = 'extraer_token_de_lv_response'.

* 2. Consultar datos adicionales del proceso en Trackline
CLEAR: lv_url.
lv_url = 'https://api.codecontractplattform.com/api/track-line/ext/track-path/metadata?process_id=12345'.

CALL METHOD cl_http_client=>create_by_url
  EXPORTING
    url    = lv_url
  IMPORTING
    client = lo_http_client.

lo_http_client->request->set_header_field( name = 'Authorization' value = |Bearer { lv_token }| ).

CALL METHOD lo_http_client->send.
CALL METHOD lo_http_client->receive.

lv_response = lo_http_client->response->get_cdata( ).

WRITE: / 'Respuesta:', lv_response.

Resumen

✔️ Paso 1: SAP obtiene el Token JWT mediante autenticación.
✔️ Paso 2: SAP consulta metadatos de procesos con process_id.
✔️ Paso 3: SAP descarga archivos adjuntos mediante attachment_id.
✔️ Paso 4: SAP puede automatizar estos procesos usando ABAP u otra tecnología.

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