Virksomhedsdokumenter
/api/v1/kyc/cases/:case_key/documents/:document_key
Uploader et virksomhedsdokument på sagen, eller erstatter det, der ligger. Kaldet kan gentages sikkert.
Scope: kyc:documents · Brugerrettighed: kyc_cases_edit
Dokumentnøgle
| Form | Bruges til |
|---|---|
kind:{document_kind} | Et navngivet dokument, som sagen har ét af: memorandum, articles, shareholders_register, shareholders_agreement, corporate_structure_chart, organizational_chart, business_registration, board_rules eller partnership_agreement |
ref:{external_reference} | Et "øvrigt" dokument med jeres eget id (1–255 tegn). Sagen kan have flere. kind:other bruges ikke |
Request body
Samme multipart/form-data-felter som legitimation på person, dog uden krav om expiry_date, plus:
| Felt | Type | Beskrivelse |
|---|---|---|
description | string | Påkrævet for ref: og afvist for kind:. Højst 255 tegn. Vises for revisoren som dokumentets navn og må ikke indeholde "på vegne af" |
Hvad sker der
kind:En ny fil erstatter alle aktive filer af typen på sagen — også filer, kunden eller revisoren har lagt op i Auditply.ref:En ny fil erstatter den fil, der har referencen. Samme fil med samme beskrivelse ændrer intet; en ny beskrivelse giver en ny fil.
Svaret er som ved legitimation på person: 201 eller 200 med document_id og replaced_document_ids, og samme fejlkoder (uden PERSON_NOT_FOUND).
Eksempel
curl -X PUT "https://auditply.dk/api/v1/kyc/cases/cvr:12345678/documents/ref:aarsrapport-2025" \
-H "X-API-Key: ap_live_..." \
-H "X-On-Behalf-Of-User: 42" \
-F "file=@aarsrapport.pdf;type=application/pdf" \
-F "description=Årsrapport 2025"