Operatore¶
Warning
Solo un'utenza Master può effettuare questa chiamata includendo come singolo firmatario nell'array dei signers il codice fiscale dell'operatore censito senza incorrere in errori
Questa procedura è finalizzata all'identificazione di un cliente ed emettendo un certificato di firma consentirgli di firmare un set documentale.
POST
/api/v2/procedures/sign/operatorRichiede autenticazione (token Bearer).
Corpo della richiesta¶
Content-Type: application/json · Schema: CreateSignOperatorProcedureI
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
procedureEventSubscribers |
array[ProcedureEventSubscriberI] · nullable | No | |
procedureTags |
array[ProcedureTagI] · nullable | No | |
categoryId |
integer (int32) | No | |
productId |
integer (int32) | No | |
subProductId |
integer (int32) | No | |
signers |
array[SignerI] · nullable | No | |
templateDocs |
array[ToBeSignedTemplateDocI] · nullable | No | |
spotDocs |
array[ToBeSignedSpotDocI] · nullable | No |
Esempio di richiesta
{
"procedureEventSubscribers": [
{
"displayName": "string",
"recipient": "string",
"channel": 0
}
],
"procedureTags": [
{
"procedureId": 0,
"tagKey": "string",
"tagValue": "string"
}
],
"categoryId": 0,
"productId": 0,
"subProductId": 0,
"signers": [
{
"name": "string",
"surname": "string",
"taxCode": "string",
"email": "string",
"phoneNumber": "string",
"sendByEmail": true,
"sendBySms": true,
"birthPlace": "string",
"birthProvince": "string",
"birthDate": "2024-01-01T00:00:00Z",
"gender": 0,
"citizenship": "string",
"signerOrder": 0,
"forceQrCode": true,
"identityDocuments": [
{
"data": {
"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
},
"front": {
"content": "<base64>",
"filename": "string",
"mimeType": "string"
},
"back": {
"content": "<base64>",
"filename": "string",
"mimeType": "string"
}
}
]
}
],
"templateDocs": [
{
"id": "string",
"doc": {
"content": "<base64>",
"filename": "string",
"mimeType": "string"
},
"isVisibleToAllSigners": true,
"toCompile": true
}
],
"spotDocs": [
{
"id": "string",
"doc": {
"content": "<base64>",
"filename": "string",
"mimeType": "string"
},
"isVisibleToAllSigners": true,
"toCompile": true,
"coordinates": [
{
"x": 0.0,
"y": 0.0,
"page": 0,
"order": 0,
"signerType": 1,
"signerOrder": 0
}
]
}
]
}
Risposte¶
| Codice | Descrizione |
|---|---|
200 |
Success |
401 |
Unauthorized |
403 |
Forbidden |
Risposta 200 · ProcedureOLsWebResponse
Parametri¶
| Parametro | Tipo | Descrizione |
|---|---|---|
| categoryId | int | Identificativo della categoria. Maggiori info. |
| productId | int | Identificativo del prodotto. Maggiori info. |
| subProductId | int | Identificativo del sotto prodotto. Maggiori info. |
| signers | array | Indica una lista di firmatari facenti parte della procedura che si vuole creare. Qui potrai trovare i campi che compongono questo modello. |
| templateDocs | array | Indica una lista di documenti già censiti all'interno del nostro sistema per i quali le posizioni di firma sono note. Qui potrai trovare i campi che compongono questo modello. |
| spotDocs | array | Indica una lista di documenti non conosciuti dal nostro sistema per cui è possibile indicare delle posizioni di firma. Qui potrai trovare i campi che compongono questo modello. |
| procedureEventSubscribers | array | ( Opzionale ) Indica una lista di "contatti" che verranno associati alla procedura e che potranno ottenere una notifica ( per ora solo mail ) automatica al momento della creazione della procedura oppure manualmente tramite apposita API |
| procedureTags | array | ( Opzionale ) Campi personalizzati per associare una "Tag" alla procedura che si va a creare ( possibile filtro nell'api di storico ) |