Lista de procesos de mi grupo

Última revisión: 18 Abril 2024

Podrás listar los procesos asociados a tu grupo de trabajo a partir de los distintos estados en los que se encuentren, a través del siguiente servicio.

Descripción
SERVICIO GET MESSAGES BY GROUP AND STATUS
URL /v3/messages/{status}/group/{groupCode}/{index}/{page_size}/
SEGURIDAD
METHOD GET
CONTENT/APPLICATION URL PARAM
PARAMS status: estado por el que se filtrarán los procesos consultados, por ejemplo, “EXPIRED, RESPONSED, ERROR, REJECTED, WAITING, etc”.
groupCode: código del grupo al que pertenecen los procesos consultados.
index: corresponde al índice del listado desde donde quieres que te devuelva el objeto.
page_size: corresponde número de peticiones que quieres que te devuelva. Si se define como valor 0, se devolverán 10 peticiones como máximo.
RESPONSE 200: HTTP status code 200/OK

Response body:

    {
      "total": "int",
      "elements": [
        {
          "messageCode": "string",
          "status": "string",
          "userCode": "string",
          "groupCode": "string",
          "templateCode": "string",
          "creationDate": timestamp,
          "setCode": "string",
          "title": "string",
          "description": "string"
        }
      ]
    }

Ejemplo:

    {
      "total": 0,
      "elements": [
        {
          "messageCode": "0Z8P1565351269642R875",
          "status": "RESPONSED",
          "userCode": "null",
          "groupCode": "apisample",
          "templateCode": "apisample_template_01",
          "creationDate": 1565351270000,
          "setCode": "MTB41713267133111T095",
          "title": "Contrato",
          "description": "Documento a firmar"
        }
      ]
    }

Params de la respuesta:

  • total: el número de total de elementos deja de informarse en la versión 3.7.101, siempre tendrá el valor 0
  • elements: lista con los datos de los diferentes procesos de firma.
  • messageCode: código del proceso de firma para el MESSAGE.
  • status: estado actual del proceso, por ejemplo “WAITING”.
  • userCode: username del usuario que solicitó el proceso de firma. Si el proceso fue solicitado a través de API el userCode será igual a nulL...
  • groupCode: código del grupo al que pertenece el proceso de firma.
  • templateCode: código de la plantilla asociada al proceso; en caso de no haber usado código de plantilla templateCode valdrá null.
  • creationDate: fecha de creación del proceso expresada en milisegundos.
  • setCode: código del proceso de firma para el SET.
  • title: título para el proceso de firma.
  • description: descripción para el proceso de firma.

Respuestas alternativas en caso de fallo: se devolverán HTTP status codes distintos de 200/OK. En ese caso siempre se devolverá un JSON que describe el problema:

    {
      "code": "string",
      "type": "string",
      "message": "string",
      "trace" : "string"
    }

results matching ""

    No results matching ""