Vai al contenuto

Dettagli anagrafici del singolo firmatario


Per ottenere dettagli anagrafici su un firmatario specifico di una procedura basta effettuare una chiamata alla seguente api passando come parametri i dati "taxCode" e "procedureId".

GET/api/v2/procedures/lastProcedure

Richiede autenticazione (token Bearer).

Parametri

Nome Posizione Tipo Obbligatorio Descrizione
taxCode query string No
procedureId query integer (int32) No
isBank query boolean No

Risposte

Codice Descrizione
200 Success
401 Unauthorized
403 Forbidden
Risposta 200 · LastProcedureOLsWebResponse
{
  "error": {
    "httpStatusCode": 100,
    "level": 0,
    "levelName": "string",
    "message": "string",
    "stackTrace": "string",
    "exceptionMessage": "string"
  },
  "response": {
    "level": 0,
    "levelName": "string",
    "message": "string",
    "data": {
      "user": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "surname": "string",
        "taxCode": "string",
        "email": "string",
        "phoneNumber": "string",
        "province": "string",
        "location": "string",
        "birthProvince": "string",
        "birthPlace": "string",
        "birthDate": "2024-01-01T00:00:00Z",
        "gender": 0,
        "citizenship": "string",
        "editable": true
      },
      "identityDocuments": [
        {
          "id": 0,
          "docType": 1,
          "number": "string",
          "releaseDate": "2024-01-01T00:00:00Z",
          "firstReleaseDate": "2024-01-01T00:00:00Z",
          "releaseCity": "string",
          "releaseProvince": "string",
          "expiryDate": "2024-01-01T00:00:00Z",
          "releasedBy": 0,
          "icaoCode": "string",
          "polygraphicProgressiveNumber": "string",
          "flagNoExpiryDate": true,
          "order": 0,
          "frontId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "backId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "realFilenameFront": "string",
          "realFilenameBack": "string",
          "filenameFront": "string",
          "filenameBack": "string"
        }
      ],
      "selfieGuid": "string"
    }
  }
}

Specifica OpenAPI completa


In fase di identificazione per un firmatario, un possibile passaggio è quello di allegare fronte e retro del proprio documento di identità (o riconoscimento). Se l'utente completa questa operazione, dalla chiamata precedente si ottengono gli identificativi utili al recupero dei file allegati dal firmatario.
Questi dati sono:

  • guidFront: identificativo assegnato al documento FRONTE
  • guidBack: identificativo assegnato al documento RETRO

Occorrerà passare singolarmente uno dei due per ottenere quello desiderato dalla seguente API:

GET/api/v2/file/identityDocument

Permette di scaricare i documenti di identità

Richiede autenticazione (token Bearer).

Parametri

Nome Posizione Tipo Obbligatorio Descrizione
guid query string No

Risposte

Codice Descrizione
200 Success
401 Unauthorized
403 Forbidden
Risposta 200 · FileOLsWebResponse
{
  "error": {
    "httpStatusCode": 100,
    "level": 0,
    "levelName": "string",
    "message": "string",
    "stackTrace": "string",
    "exceptionMessage": "string"
  },
  "response": {
    "level": 0,
    "levelName": "string",
    "message": "string",
    "data": {
      "content": "<base64>",
      "filename": "string",
      "mimeType": "string"
    }
  }
}

Specifica OpenAPI completa


Inoltre, sempre in fase di identificazione, un altro possibile passaggio che può essere richiesto al firmatario è lo scatto del Selfie. Se l'utente completa questa operazione, dalla chiamata precedente si ottiene l'identificativo del Selfie scattato nel campo "SelfieGuid" file allegati dal firmatario.
L' API per ottenere il selfie invece è:

GET/api/v2/file/selfie

Permette di scaricare i selfie caricati dai clienti

Richiede autenticazione (token Bearer).

Parametri

Nome Posizione Tipo Obbligatorio Descrizione
guid query string No

Risposte

Codice Descrizione
200 Success
401 Unauthorized
403 Forbidden
Risposta 200 · FileOLsWebResponse
{
  "error": {
    "httpStatusCode": 100,
    "level": 0,
    "levelName": "string",
    "message": "string",
    "stackTrace": "string",
    "exceptionMessage": "string"
  },
  "response": {
    "level": 0,
    "levelName": "string",
    "message": "string",
    "data": {
      "content": "<base64>",
      "filename": "string",
      "mimeType": "string"
    }
  }
}

Specifica OpenAPI completa