Opret eller opdatér person

PUT /api/v1/kyc/cases/:case_key/persons/:person_key

Opretter en person på sagen eller opdaterer en eksisterende — typisk en reel ejer, som Auditply allerede har hentet fra CVR. Kaldet kan gentages sikkert: samme kald to gange ændrer intet anden gang.

Scope: kyc:write · Brugerrettighed: kyc_cases_edit

:case_key har samme former som ved opret eller opdatér KYC-sag.

Personnøgle

Form	Eksempel	Bruges til
{person_id}	77	En person på sagen (person_id fra status-objektet)
unit:{enhedsnummer}	unit:4000123456	En person fra CVR-registret. Foranstillede nuller ignoreres
ref:{external_reference}	ref:person-84a1	Jeres eget person-id (1–255 tegn)

Nøglen er aldrig navn, e-mail eller fødselsdato. Når en ny reference oprettes, kan den dog overtage en eksisterende person med samme rolle og navn uden reference, se Hvad sker der.

Request body

Felt	Type	Beskrivelse
external_reference	string	Valgfri. Jeres person-id. Med en ref:-nøgle skal det, hvis det sendes, være det samme som i nøglen
role	beneficial_owner | owner	Påkrævet ved oprettelse, og når personen har flere roller på sagen, uden at en af dem er reel ejer (fx både direktion og bestyrelse). owner er personkundens egen person og kan kun bruges på en personkundes sag
name	string	Påkrævet ved oprettelse. Ignoreres på en eksisterende person — navnet ejes af Auditply/CVR
unit_number	string	Valgfri. Enhedsnummer i CVR (1–15 cifre). Kan ikke sættes på en person med rollen "anden"
email	string | null	Valgfri. Højst 255 tegn
date_of_birth	YYYY-MM-DD | null	Valgfri
pep_declaration	objekt	Valgfri. Se nedenfor

address, mobile, cpr og ownership_share afvises, ligesom andre ukendte felter.

Hvad sker der

• Personen findes: Felterne i bodyen opdateres, og referencen gemmes. Svaret er 200.
• Personen findes ikke: Personen oprettes som reel ejer (eller som personkundens egen person). Svaret er 201. Står en person med samme rolle og navn allerede på sagen uden nogen reference — fx indtastet af revisoren — overtages den i stedet for at blive oprettet to gange. Navnene sammenlignes uden forskel på store og små bogstaver og ekstra mellemrum, og en person med et andet enhedsnummer end det, I sender, overtages ikke.
• Anden rolle: Peger nøglen på en person, der kun står med en anden rolle (fx direktion), og sendes role: beneficial_owner, oprettes personen også som reel ejer. Referencen flytter med til den række, der skrives.

Svaret er personen, som den står i status-objektets persons[], inkl. dens missing_inputs.

PEP-erklæring

{
  "pep_declaration": {
    "pep_status": "yes",
    "pep_type": "family_member",
    "pep_answered_at": "2026-09-21T10:00:00Z"
  }
}

Felt	Værdier
pep_status	yes | no
pep_type	pep, family_member eller close_associate. Påkrævet ved yes, udelades ved no
pep_answered_at	Tidspunkt for kundens svar (ISO 8601 med tidszone)

Auditply danner en PEP-erklæring som PDF på personen, markeret "modtaget via integration". Et identisk svar (samme status, type og tidspunkt) ændrer intet. Et nyt svar erstatter den forrige erklæring, der kom via API'et for personen — også hvis den blev sendt til personen under en anden rolle; erklæringer, kunden selv har afgivet via Auditply, røres ikke. Er erklæringen slettet i Auditply, dannes den igen.

Hvornår kan sagen ændres

Personer kan ændres, når sagen er DRAFT, IN_PROGRESS eller PENDING_DOCUMENTS og ikke er deaktiveret. Ellers svares 409 CASE_NOT_EDITABLE — undtagen når kaldet ikke ændrer noget; så svares 200.

Kendte begrænsninger

• To personer med præcis samme navn på samme sag deler dokumenter, PEP-erklæring og mangler i Auditply.
• Har en revisor personlisten åben i Auditply, mens en person tilføjes via API'et, kan revisorens næste gemning fjerne personen igen eller overskrive en e-mail, API'et har sat. Sendes personen igen, genoprettes den.

Fejl

Kode	HTTP	Årsag
PERSON_NOT_FOUND	404	Et person_id findes ikke på sagen
CASE_NOT_FOUND	404	Sagen findes ikke
CASE_NOT_EDITABLE	409	Sagen er låst (review, afsluttet, arkiveret eller deaktiveret)
EXTERNAL_REFERENCE_CONFLICT	409	Personen har allerede en anden reference, eller referencen bruges af en anden person på sagen
VALIDATION_ERROR	400	Ugyldig nøgle eller body, fx manglende role/name ved oprettelse eller unit_number, der ikke passer til personen

Eksempel

curl -X PUT https://auditply.dk/api/v1/kyc/cases/cvr:12345678/persons/unit:4000123456 \
  -H "X-API-Key: ap_live_..." \
  -H "X-On-Behalf-Of-User: 42" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reference": "person-84a1",
    "email": "jens@example.dk",
    "pep_declaration": { "pep_status": "no", "pep_answered_at": "2026-09-21T10:00:00Z" }
  }'