VAT periods
Record a VAT return filed outside LedgerBee
Credential: a company's API key or OAuth token.
Records that the VAT return for a period was reported to SKAT outside LedgerBee (on skat.dk, or by an
accountant). Nothing is sent to SKAT. The figures recorded are the books as they stand now; the call
supplies only the period and the day it was reported. Once recorded, the period counts as filed
everywhere, and it can be settled with POST /api/v1/vat-periods/settle.
Refused with 400 VAT_MANUAL_FILING_PERIOD_NOT_ENDED for a period still running,
VAT_MANUAL_FILING_REPORTED_DATE_OUT_OF_RANGE for a reported date before the period end or in the
future, and VAT_MANUAL_FILING_PERIOD_ALREADY_FILED for a period overlapping a filed one. A credential
with no person behind it (an API key) is refused with 403 VAT_MANUAL_FILING_REQUIRES_USER: the record
names who filed.
Required Scope
journal-entries-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Record a VAT return filed outside LedgerBee › Request Body
startDateFirst day of the VAT period (YYYY-MM-DD).
endDateLast day of the VAT period (YYYY-MM-DD).
reportedDateThe day the return was reported to SKAT outside LedgerBee (YYYY-MM-DD): on or after the period end, and not in the future.
Record a VAT return filed outside LedgerBee › Responses
Filing recorded.
startDateFirst day of the filed period.
endDateLast day of the filed period.
reportedDateThe day the return was reported.
sourceMANUAL for a filing recorded here; APP for one sent to SKAT through LedgerBee.
hasSettleableBalancesWhether settling the period would post anything. False for a period with no VAT postings.
Preview recording a VAT return filed outside LedgerBee
Credential: a company's API key or OAuth token.
Takes the same body as POST /api/v1/vat-periods/mark-filed and raises every refusal that call would,
with the same code, without recording anything. Answers with the period and reported date otherwise.
Required Scope
journal-entries-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Preview recording a VAT return filed outside LedgerBee › Request Body
startDateFirst day of the VAT period (YYYY-MM-DD).
endDateLast day of the VAT period (YYYY-MM-DD).
reportedDateThe day the return was reported to SKAT outside LedgerBee (YYYY-MM-DD): on or after the period end, and not in the future.
Preview recording a VAT return filed outside LedgerBee › Responses
The filing would be recorded. Nothing was recorded.
startDateFirst day of the period that would be recorded as filed.
endDateLast day of the period.
reportedDateThe day the return would be recorded as reported.
Settle a filed VAT period
Credential: a company's API key or OAuth token.
Posts the VAT settlement for a filed period, dated the last day of the period: every VAT account is brought to zero, the net goes to the VAT settlement account (payable to SKAT, or a refund from SKAT), and any øre the rounded lines leave over goes to the VAT rounding account. The same entry the SKAT page posts when a period is closed.
The period must be filed — through LedgerBee, or recorded with POST /api/v1/vat-periods/mark-filed —
with exactly these dates. Refused with 400 VAT_NO_SUCCESSFUL_SUBMISSION when it is not,
VAT_PERIOD_ALREADY_SETTLED when it is already settled, VAT_OVERLAPPING_SETTLEMENT_EXISTS when a
settled period overlaps it, and VAT_NO_TRANSACTIONS_IN_PERIOD when there is nothing to settle. The
posting period of the last day must be open.
Preview the entry first with POST /api/v1/vat-periods/settle/preview.
Required Scope
journal-entries-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Settle a filed VAT period › Request Body
startDateFirst day of the VAT period (YYYY-MM-DD).
endDateLast day of the VAT period (YYYY-MM-DD).
Settle a filed VAT period › Responses
Settlement posted.
journalEntryIdThe posted settlement journal entry.
Preview a VAT period settlement
Credential: a company's API key or OAuth token.
Takes the same body as POST /api/v1/vat-periods/settle and answers with the entry that call would
post — each line with its account, side, amount and role, and the net payable or refundable — without
posting anything. Every refusal the settlement would raise is raised here too, with the same code.
Required Scope
journal-entries-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Preview a VAT period settlement › Request Body
startDateFirst day of the VAT period (YYYY-MM-DD).
endDateLast day of the VAT period (YYYY-MM-DD).
Preview a VAT period settlement › Responses
Preview produced. Nothing was posted.
startDateFirst day of the period.
endDateLast day of the period.
postingDateThe settlement posts on the last day of the period.
descriptionDescription the settlement entry would carry.
currencyThe company's base currency; every amount is in it.
settlementAmountNet VAT for the period: positive is payable to SKAT, negative is a refund from SKAT.
The lines the settlement entry would post.