Spring til indhold
Forta Pay

Reference

Udsendelser

Forta Pay API v1

2 operationer

Leveringssporet på tværs af fakturaer — fanerne Fejlet · Returneret · Ikke leveret · Ikke åbnet · Leveret

GET /deliveries

⑤ «Leveret» og «returneret» havde vi. «Læst» havde vi ikke. opened er nu en status i svaret — men ikke en værdi i databasens deliveries.status, og det er målt, ikke en smagssag: den kolonne bruges tre steder som BEVIS for at noget blev afsendt (§ 10-påkravets afsendelsesbevis, H9). En åbning der flyttede status, ville betyde at en debitor der åbner sit påkrav, sletter beviset for at det blev leveret — tavst. delivery_status bærer derfor rækkens egen status ved siden af.

🔴 Filteret matcher det der meldes: en række der er delivered OG åbnet, melder opened og findes under status=opened, ikke under status=delivered. Ellers ville fanetallet og listen sige hver sit om samme række (design §7.5).

⚠️ Hvad «åbnet» IKKE er. Målingen er en sporingspixel: den måler at et billede blev hentet, ikke at et menneske læste. Et fravær betyder intet — de fleste klienter blokerer fjernbilleder, og Apple Mail Privacy Protection henter dem proaktivt. Derfor svarer fladen opened som et positivt signal og aldrig «ikke læst» som en påstand. Målingen er en kreditorindstilling (standard TIL, ⚠️ VALGT og ikke målt); er den slået fra, dannes der ingen HTML-del og ingen pixel — ikke en pixel der kaldes og kasseres.

Parametre

cursor

query · string · valgfri

limit

query · integer · valgfri

creditor_id

query · string · valgfri

invoice_id

query · string · valgfri

subject_id

query · string · valgfri

Faktura- eller rykker-id

subject_type

query · string · valgfri

channel

query · string · valgfri

status

query · string · valgfri

opened

query · boolean · valgfri

false = fanen «Ikke åbnet»

created_after

query · string (date-time) · valgfri

updated_after

query · string (date-time) · valgfri

K5: alle lister har updated_after

Svar

200

OK · Page

curl
curl -X GET https://api.fortapay.dk/v1/deliveries \
  -H "Authorization: Bearer $FP_KEY"

Én udsendelse med afsendelsesbevis og evt. åbning

GET /deliveries/{deliveryId}

Parametre

deliveryId

path · string · påkrævet

Svar

200

OK · Delivery

curl
curl -X GET https://api.fortapay.dk/v1/deliveries/{deliveryId} \
  -H "Authorization: Bearer $FP_KEY"