Spring til indhold
Forta Pay
English Log ind Book en samtale

Reference

Integrationer

Forta Pay API v1

10 operationer

Kreditorens e-conomic-kobling (B8 + B9) — grant-tokenet vises aldrig

GET /creditors/{creditorId}/integrations/economic

Parametre

creditorId

path · string · påkrævet

Svar

200

OK · EconomicConnection

404

Fejl (RFC 9457) · Problem

curl
curl -X GET https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/economic \
  -H "Authorization: Bearer $FP_KEY"

Kobl kreditoren til sin EGEN e-conomic (scope admin). Grant-tokenet krypteres pr. tenant og vises aldrig igen

POST /creditors/{creditorId}/integrations/economic

TILFØJET af pay-integration 11-09 (fase 2A, B9). Afregnede indbetalinger lægges i kreditors EGEN kassekladde som ét bilag pr. betalingstype pr. betalingsdag, præcis som bogholderen kender dem fra en kassekladde (docs/E-CONOMIC-KASSEKLADDE-FORMAT.md). mode=manual: kun kladde — bogholderen godkender og bogfører i e-conomic. mode=auto: Forta Pay bogfører og udligner straks. Skift med PATCH uden migrering; bilagene ser ens ud i begge tilstande. Én e-conomic-aftale kan kun kobles til én kreditor i hele Forta Pay (409 economic_agreement_in_use).

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · EconomicConnectionCreate

agreement_number

integer · påkrævet

e-conomics aftalenummer — GET /self skal give det samme

grant_token

string · påkrævet

X-AgreementGrantToken fra kreditors installation af Forta Pay-appen. Krypteres pr. tenant; vises aldrig igen

journal_number

integer · påkrævet

Kassekladden (fx en kladde ved navn «Forta Pay»)

bank_ledger_account

integer · påkrævet

Kreditors bankkonto i SIN kontoplan — Finansbilag-modposten

unidentified_ledger_account

integer · påkrævet

Konto for uidentificerede indbetalinger («Ukendt. ‹ref›»)

voucher_number_next

integer · påkrævet

Første bilagsnummer i Forta Pays serie i kladden — markøren der gør bogføringen idempotent

mode

string · valgfri

manual = kun kassekladde (bogholderen bogfører); auto = bogfør + udlign

manual · auto

booking_from

string (date) · valgfri

Første betalingsdag der bogføres (skiftedagen

booking_enabled

boolean · valgfri

B9: bogføringen UD er slået FRA til den slås til. Slået fra dannes ingen bilag, og eksisterende bilag føres ikke frem (intet kald til e-conomic)

ingest_mode

string · valgfri

INDLÆSNINGEN IND (modsat bogføringen ud). invoices = bogførte fakturaer og kunder hentes fra e-conomic og bliver til fordringer i Forta Pay. Standard off, så en kobling der er sat op for at bogføre UD ikke pludselig trækker en kundes fakturahistorik ind — at den er slået fra, ses i sources på GET /invoices

off · invoices

ingest_from

string (date) · valgfri

Første fakturaDATO der hentes ind. Standard er booking_from (skiftedagen

account_map

EconomicAccountMap · valgfri

Kontokortet: metodenøgle → konto i kreditorens kontoplan (modposten på indbetalingsbilaget). Erstattes som helhed ved PATCH. TOMT = alle metoder på bankkontoen (standard). Opslaget går fra den præcise nøgle (card:dankort) til røret (card) og derfra til bankkontoen. Står der kortgrupper men ikke card, holdes en kortbetaling uden kendt kortgruppe tilbage (method_unresolved). Ét bilag pr. (dag, betalingstype, konto).

dunning_fee_ledger_account

integer | null · valgfri

Rykkergebyr-andelen af en betaling (Pay's gebyrer, som e-conomic-fakturaen ikke kender). Ikke sat = en betaling med en gebyrandel holdes tilbage (account_missing) — aldrig en kreditsaldo på debitor

interest_ledger_account

integer | null · valgfri

Renteandelen af en betaling. Samme regel som dunning_fee_ledger_account

rounding_ledger_account

integer | null · valgfri

Øreafrunding. Kræves når rounding_tolerance_oere > 0

rounding_tolerance_oere

integer · valgfri

Afviger kundeindbetalingen fra e-conomic-fakturaens restbeløb med højst så mange øre, udlignes restbeløbet og forskellen står på afrundingskontoen. 0 = slået fra

provider_fee_ledger_account

integer | null · valgfri

pay-udbetaling: udbyderens (indløserens) gebyr på udbetalingsbilaget. Kun brugt når en metode har sin egen konto i account_map; ikke sat = en afregning med gebyr holdes (account_missing)

credit_note_ledger_account

integer | null · valgfri

pay-kreditnota: kreditnotaens beløb ekskl. moms (fx salgskontoen). Ikke sat = kreditnotaen bogføres ikke (holdes)

credit_note_vat_ledger_account

integer | null · valgfri

pay-kreditnota: kreditnotaens moms (udgående moms). Kræves når kreditnotaen har moms

Svar

201

Oprettet · EconomicConnection

409

Fejl (RFC 9457) · Problem

422

Fejl (RFC 9457) · Problem

curl
curl -X POST https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/economic \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "agreement_number": 0,
  "grant_token": "…",
  "journal_number": 0,
  "bank_ledger_account": 0,
  "unidentified_ledger_account": 0,
  "voucher_number_next": 0
}
JSON

Ret koblingen — fx skift mellem manual og auto (scope admin). Et nyt grant-token bevises mod aftalen igen

PATCH /creditors/{creditorId}/integrations/economic

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · EconomicConnectionUpdate

grant_token

string · valgfri

journal_number

integer · valgfri

bank_ledger_account

integer · valgfri

unidentified_ledger_account

integer · valgfri

voucher_number_next

integer · valgfri

Må ikke genbruge et allerede brugt bilagsnummer (422)

mode

string · valgfri

manual · auto

booking_from

string (date) · valgfri

booking_enabled

boolean · valgfri

ingest_mode

string · valgfri

Slås indlæsningen til på en kobling uden ingest_from, kræves ingest_from med (422)

off · invoices

ingest_from

string (date) · valgfri

account_map

EconomicAccountMap · valgfri

Kontokortet: metodenøgle → konto i kreditorens kontoplan (modposten på indbetalingsbilaget). Erstattes som helhed ved PATCH. TOMT = alle metoder på bankkontoen (standard). Opslaget går fra den præcise nøgle (card:dankort) til røret (card) og derfra til bankkontoen. Står der kortgrupper men ikke card, holdes en kortbetaling uden kendt kortgruppe tilbage (method_unresolved). Ét bilag pr. (dag, betalingstype, konto).

dunning_fee_ledger_account

integer | null · valgfri

null nulstiller

interest_ledger_account

integer | null · valgfri

null nulstiller

rounding_ledger_account

integer | null · valgfri

null nulstiller

rounding_tolerance_oere

integer · valgfri

provider_fee_ledger_account

integer | null · valgfri

null nulstiller

credit_note_ledger_account

integer | null · valgfri

null nulstiller

credit_note_vat_ledger_account

integer | null · valgfri

null nulstiller

Svar

200

OK · EconomicConnection

404

Fejl (RFC 9457) · Problem

422

Fejl (RFC 9457) · Problem

curl
curl -X PATCH https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/economic \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{}
JSON

Bilag Forta Pay har lagt i kreditors kassekladde, med status og præcis de sendte kladdeposter

GET /creditors/{creditorId}/integrations/economic/vouchers

Parametre

creditorId

path · string · påkrævet

cursor

query · string · valgfri

limit

query · integer · valgfri

updated_after

query · string (date-time) · valgfri

K5: alle lister har updated_after

status

query · string · valgfri

Svar

200

OK · Page

404

Fejl (RFC 9457) · Problem

curl
curl -X GET https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/economic/vouchers \
  -H "Authorization: Bearer $FP_KEY"

Kreditorens Uniconta-forbindelse (B3) — adgangskoden og webhook-nøglen vises aldrig

GET /creditors/{creditorId}/integrations/uniconta

Parametre

creditorId

path · string · påkrævet

Svar

200

OK · UnicontaConnection

404

Fejl (RFC 9457) · Problem

curl
curl -X GET https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta \
  -H "Authorization: Bearer $FP_KEY"

Forbind kreditoren til sit EGET Uniconta-regnskab via en dedikeret serverbruger (scope admin)

POST /creditors/{creditorId}/integrations/uniconta

TILFØJET af pay-uniconta 01-10-2026 (B3). Uniconta Web API (api.uniconta.com): serverbrugerens brugernavn og adgangskode giver et Bearer-token, og virksomheden (company_id) vælges pr. session. Adgangskoden krypteres pr. tenant og vises aldrig igen. Indlæsning, bogføring og PDF er SLUKKET ved oprettelsen og kan først tændes efter POST …/verify. Ét Uniconta-regnskab kan kun forbindes til én kreditor pr. miljø (409 uniconta_company_in_use).

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · UnicontaConnectionCreate

company_id

integer · påkrævet

username

string · påkrævet

password

string · påkrævet

journal

string · påkrævet

bank_account

string · påkrævet

unidentified_account

string · påkrævet

fee_account

string | null · valgfri

on_account_allowed

boolean · valgfri

booking_mode

string · valgfri

manual · auto

Svar

201

Oprettet · UnicontaConnection

409

Fejl (RFC 9457) · Problem

422

Fejl (RFC 9457) · Problem

curl
curl -X POST https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "company_id": 0,
  "username": "…",
  "password": "…",
  "journal": "…",
  "bank_account": "…",
  "unidentified_account": "…"
}
JSON

Ret forbindelsen og tænd/sluk indlæsning, bogføring og PDF (scope admin). Ny adgangskode skal verificeres igen

PATCH /creditors/{creditorId}/integrations/uniconta

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Krop · UnicontaConnectionUpdate

username

string · valgfri

password

string · valgfri

journal

string · valgfri

bank_account

string · valgfri

unidentified_account

string · valgfri

fee_account

string | null · valgfri

on_account_allowed

boolean · valgfri

booking_mode

string · valgfri

manual · auto

ingest_enabled

boolean · valgfri

booking_enabled

boolean · valgfri

pdf_enabled

boolean · valgfri

ingest_from

string (date) · valgfri

booking_from

string (date) · valgfri

Svar

200

OK · UnicontaConnection

404

Fejl (RFC 9457) · Problem

422

Fejl (RFC 9457) · Problem

curl
curl -X PATCH https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{}
JSON

Bevis serverbrugeren og regnskabet mod Uniconta (login + ChangeCompany); navnet tages fra Uniconta's svar

POST /creditors/{creditorId}/integrations/uniconta/verify

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Svar

200

OK · UnicontaConnection

404

Fejl (RFC 9457) · Problem

409

Fejl (RFC 9457) · Problem

curl
curl -X POST https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta/verify \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Ny hemmelig «Ændrings-URL» til Uniconta — vises KUN i dette svar; den gamle holder op med at virke

POST /creditors/{creditorId}/integrations/uniconta/webhook

Parametre

creditorId

path · string · påkrævet

Idempotency-Key

header · string (uuid) · påkrævet

Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.

Svar

201

Oprettet · UnicontaWebhookUrl

404

Fejl (RFC 9457) · Problem

curl
curl -X POST https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta/webhook \
  -H "Authorization: Bearer $FP_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Kreditorens EGEN faktura-PDF fra Uniconta — kun når PDF er slået til og fakturaen er set i skyggen

GET /creditors/{creditorId}/integrations/uniconta/invoices/{account}/{invoiceNumber}/pdf

Parametre

creditorId

path · string · påkrævet

account

path · string · påkrævet

invoiceNumber

path · string · påkrævet

Svar

200

PDF · string (binary)

404

Fejl (RFC 9457) · Problem

409

Fejl (RFC 9457) · Problem

502

Fejl (RFC 9457) · Problem

curl
curl -X GET https://api.fortapay.dk/v1/creditors/{creditorId}/integrations/uniconta/invoices/{account}/{invoiceNumber}/pdf \
  -H "Authorization: Bearer $FP_KEY"