Vai al contenuto principale
PATCH
Python

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

sessionId
string<uuid>
obbligatorio

UUID della sessione di Verifica aziendale (KYB). Deve appartenere all'applicazione della chiave API.

Esempio:

"33333333-4444-5555-6666-777777777777"

draftId
string<uuid>
obbligatorio

UUID della bozza della controparte (draft_id restituito al momento della creazione).

Esempio:

"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d"

Parametri della query

node_id
string

Nodo del workflow del passaggio KYB. Necessario solo quando il workflow contiene più di un nodo KYB; per impostazione predefinita Didit utilizza il nodo della sessione stessa.

Corpo

application/json

Qualsiasi sottoinsieme dei campi della parte. La modifica viene unita alla bozza memorizzata e la parte risultante dall'unione viene convalidata nel suo complesso; pertanto, una bozza che poteva essere inviata prima di una modifica può ancora essere inviata dopo di essa.

entity_type
enum<string>

Indica se la parte è una persona fisica o un'azienda.

Opzioni disponibili:
person,
company
full_name
string

Nome completo di una persona. Invia questo, oppure first_name e last_name.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

Ruolo ricoperto dalla parte. Intercambiabile con roles; quando vengono inviati entrambi, vengono uniti.

Opzioni disponibili:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

Ogni ruolo ricoperto dal soggetto. Una persona deve avere almeno un ruolo (qui o in role).

Opzioni disponibili:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

Qualifica professionale di una persona.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

Nome di una parte aziendale. Obbligatorio quando entity_type è company.

Maximum string length: 255
registration_number
string

Numero di registrazione di un soggetto aziendale.

Maximum string length: 100
email
string<email>

Dove viene inviato il link di verifica. Obbligatorio quando la parte deve completare la verifica, il che dipende dalle impostazioni del ruolo e dalle soglie dell'assetto proprietario del workflow.

ownership_percent
number | null

Quota dell'azienda posseduta dal soggetto.

nationality
string

Nazionalità di una persona fisica o paese di costituzione di un'azienda. Obbligatorio per ogni parte.

Maximum string length: 100
phone_number
string
Maximum string length: 32
custom_fields
object

Campi aggiuntivi definiti dal workflow.

skip_verification
boolean
predefinito:false

Richiedi di saltare la verifica di questa parte. Applicato solo se il ruolo della parte consente di saltarla nelle impostazioni di Persone chiave del workflow.

Risposta

Bozza aggiornata.

draft_id
string<uuid>
obbligatorio
created_at
string<date-time>
obbligatorio
updated_at
string<date-time>
obbligatorio
party
object
obbligatorio
Ultima modifica il 7 novembre 2026