Advisor Authority Extracts
Tax-authority data delivered for an advisor firm's clients, through a connection the firm holds.
Submit authority extract data for an advisor firm's clients
Credential: an advisor firm's OAuth token (advisor-* scopes).
Accepts a batch of authority-data extracts about the firm's clients. Each item names the client it is about by cvr. Items are stored as received, and the response lists the CVRs that are not among the firm's clients.
The batch is stored atomically: on any failure nothing is stored, and the whole request should be retried. Sending batchId plus an x-api-idempotency-key makes retries safe — a completed batch replays its original response, and a key reused across a different batch is refused with 422.
Required Scope
advisor-authority-extracts-write, on a connection an advisor firm holds
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Submit authority extract data for an advisor firm's clients › Request Body
The extract items — one object per extract (momsindberetning, erhvervsselvangivelse, udbytteindberetning, e-indkomst, skattekonto, lønsum, …). Each item is stored as received.
senderThe delivering system, e.g. 'revibot'.
batchIdThe sender's own id for this batch. Folded into the idempotency claim, so an x-api-idempotency-key reused across two DIFFERENT batches is refused (422) instead of silently replaying the first batch's response.
Submit authority extract data for an advisor firm's clients › Responses
totalCreatedNumber of extract items stored.
unmatchedCvrsDistinct CVRs in this batch that are not clients of the firm, as digits only. Their items are stored all the same; a CVR listed here usually means the firm's client list is missing that client.
itemsWithoutCvrItems whose cvr was missing or not a registration number. They are stored without a subject.