Conoce paso a paso como integrar Trackline con Oracle ERP Cloud

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 Oracle ERP Cloud para recuperar documentos y datos de procesos, sigue estos pasos utilizando autenticación con Token JWT.

Paso 1: Obtener el token de autenticación

Oracle ERP Cloud 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 Oracle ERP Cloud (HTTP Request)

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

{
    "email": "oracle_integration_user",
    "password": "oracle_secure_password"
}

Respuesta esperada

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

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

El valor del token deberá almacenarse en Oracle ERP Cloud 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 Oracle ERP Cloud

Consultar datos adicionales de un proceso

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

Petición desde Oracle ERP Cloud

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

Respuesta esperada

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

Oracle ERP Cloud puede utilizar esta información para gestionar procesos y documentos de manera automatizada.

Descargar un archivo adjunto

Una vez obtenidos los metadatos, Oracle ERP Cloud puede descargar un archivo adjunto por su attachment_id.

Petición desde Oracle ERP Cloud

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

Respuesta esperada (Archivo)

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

Integración en Oracle ERP Cloud (Ejemplo en PL/SQL)

Si se necesita integrar esta funcionalidad en Oracle ERP Cloud usando PL/SQL, se puede utilizar el siguiente código:

sql
DECLARE
  v_url         VARCHAR2(4000);
  v_token       VARCHAR2(4000);
  v_response    CLOB;
  v_http_req    UTL_HTTP.REQ;
  v_http_resp   UTL_HTTP.RESP;
  v_buffer      VARCHAR2(32767);
BEGIN
  -- Paso 1: Obtener el Token JWT
  v_url := 'https://api.codecontractplattform.com/api/login';

  v_http_req := UTL_HTTP.BEGIN_REQUEST(v_url, 'POST', 'HTTP/1.1');
  UTL_HTTP.SET_HEADER(v_http_req, 'Content-Type', 'application/json');
  UTL_HTTP.WRITE_TEXT(v_http_req, '{"email": "oracle_integration_user", "password": "oracle_secure_password"}');

  v_http_resp := UTL_HTTP.GET_RESPONSE(v_http_req);
  LOOP
    UTL_HTTP.READ_LINE(v_http_resp, v_buffer);
    v_response := v_response || v_buffer;
  END LOOP;
  UTL_HTTP.END_RESPONSE(v_http_resp);

  -- Extraer Token (Ejemplo básico)
  v_token := 'extraer_token_de_v_response';

  -- Paso 2: Consultar Metadatos del Proceso en Trackline
  v_url := 'https://api.codecontractplattform.com/api/track-line/ext/track-path/metadata?process_id=12345';

  v_http_req := UTL_HTTP.BEGIN_REQUEST(v_url, 'GET', 'HTTP/1.1');
  UTL_HTTP.SET_HEADER(v_http_req, 'Authorization', 'Bearer ' || v_token);

  v_http_resp := UTL_HTTP.GET_RESPONSE(v_http_req);
  v_response := NULL;
  
  LOOP
    UTL_HTTP.READ_LINE(v_http_resp, v_buffer);
    v_response := v_response || v_buffer;
  END LOOP;
  UTL_HTTP.END_RESPONSE(v_http_resp);

  DBMS_OUTPUT.PUT_LINE('Respuesta: ' || v_response);

END;
/

Resumen

✔️ Paso 1: Oracle ERP Cloud obtiene el Token JWT mediante autenticación.
✔️ Paso 2: Oracle ERP Cloud consulta metadatos de procesos con process_id.
✔️ Paso 3: Oracle ERP Cloud descarga archivos adjuntos mediante attachment_id.
✔️ Paso 4: Oracle ERP Cloud puede automatizar estos procesos usando PL/SQL o un conector de API.

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