Forta-bogen skubber én hændelse med hulfri seq (faktura, kreditnota, betaling eller rest)
PUT /source/fortabog/events/{seq}
🔴 Ikke slået til: ruten svarer 404. Kræver en nøgle med scope source (gives kun alene og kun til én kreditor); kreditoren er nøglens, aldrig stiens eller kroppens. seq er hulfri pr. kreditor og tildeles i kildens outbox i samme transaktion som udstedelsen, kreditnotaen, betalingen eller restændringen. 201 ny hændelse (markøren flyttet i samme transaktion) · 200 samme seq og samme krop: det gemte svar igen, uden sideeffekt. En ugyldig hændelse gemmes ikke og flytter ikke markøren — ret den og send samme seq. En gyldig hændelse om noget Forta Pay ikke kender (kreditnota før faktura, rest eller betaling på et ukendt nummer) modtages som quarantined: den er set, men rød. number er det trykte nummer uden præfiks; det bliver fakturaens external_ref. En negativ balance er et tilgodehavende og modtages, og resten må stige. En betaling eller restændring med origin: pay stammer fra Forta Pays egne bilag, bogført hos kilden, og modtages som echo: den bliver aldrig til en ny betaling. Intet oprettes som faktura, debitor eller betaling ved modtagelsen.
Parametre
seqpath · integer · påkrævet
Idempotency-Keyheader · string (uuid) · påkrævet
Obligatorisk på alle POST/PATCH/DELETE. Lever 24 timer.
Krop · SourceEventPut
event_idstring · påkrævet
Hændelsens stabile id i kildens outbox
typestring · påkrævet
invoice · credit_note · payment · balance
documentSourceDocument · valgfri
paymentSourcePayment · valgfri
balanceSourceBalance · valgfri
Svar
200Allerede modtaget med samme krop · SourceEventReceipt
201Modtaget · SourceEventReceipt
403`insufficient_scope` · `fortabog_key_not_bound` · Problem
404Fejl (RFC 9457) · Problem
409`fortabog_seq_gap` (med `expected_seq`) · `fortabog_seq_conflict` · `fortabog_event_id_reused` · `fortabog_document_changed` · Problem
422`validation_failed` · `fortabog_number_below_first` · `fortabog_number_taken` · `fortabog_pdf_invalid` · `fortabog_pdf_mismatch` · Problem
curl -X PUT https://api.fortapay.dk/v1/source/fortabog/events/{seq} \
-H "Authorization: Bearer $FP_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d @- <<'JSON'
{
"event_id": "…",
"type": "invoice"
}
JSON