Hop til hovedindhold

Virksomhedsdokumenter

PUT /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​

FormBruges 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:

FeltTypeBeskrivelse
descriptionstringPå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"