Dato: 12. august 2026
Berørt service: NHR API
Testmiljø (ny udgave): https://api-demo.nemhandel.dk/nemhandel-api/swagger-ui/index.html
Vi har opdateret NHR API.
Den nye udgave kan allerede afprøves i demo-miljøet (se link ovenfor).
Oversigt over ændringer:
| # | Ændring | Type | Kræver handling |
| 1 | Felter i `profile`-objektet omdøbt til PascalCase + omdøbte flag | Brydende | Ja |
| 2 | Felter i `role`-objektet omdøbt til PascalCase | Brydende | Ja |
| 3 | Nye felter på `participant`: `ActiveInDkSml`, `ActiveInEuSml` | Tilføjelse | Nej (anbefales) |
| 4 | Nyt felt `CertificateBindings` på modtager-service (+ nyt objekt `CertificateBinding`) | Tilføjelse | Nej (anbefales) |
| 5 | Nye felter på `profile`: `DocumentStandardId`, `NetworkTypeId | Tilføjelse | Nej |
| 6 | Tidsstempel dokumenteres nu som `lastModifiedString` | Dokumentation | Anbefales |
Detaljerede ændringer
1. `profile`-objektet (brydende)
Feltnavne er ændret fra camelCase til PascalCase, og to flag er omdøbt:
| Gammelt feltnavn | Nyt feltnavn |
| `id` | `Id` |
| `name` | `Name` |
| `description` | `Description` |
| `profileId` | `ProfileId` |
| `profileGroup` | `ProfileGroup` |
| `profileGroupId` | `ProfileGroupId` |
| `nemhandelAs4Enabled` | `IsNhAs4Enabled` |
| `peppolEnabled` | `IsPeppolEnabled` |
Bemærk: I den gamle udgave fandtes både `peppolEnabled` og `IsPeppolEnabled`.
Fremover findes kun `IsPeppolEnabled`. Desuden er felterne `DocumentStandardId` og `NetworkTypeId` tilføjet (se punkt 5).
2. `role`-objektet (brydende)
| Gammelt feltnavn | Nyt feltnavn |
| `id` | `Id` |
| `name` | `Name` |
| `roleId` | `RoleId` |
3. Nye felter på `participant` (tilføjelse)
To nye boolske felter angiver, hvor deltageren er registreret:
- `ActiveInDkSml` – `true` hvis deltageren er registreret i NHR og DK SML (grøn), `false` hvis registreret i NHR, men ikke i DK SML (rød).
- `ActiveInEuSml` – tilsvarende for EU SML.
4. Nyt felt `CertificateBindings` på modtager-service (tilføjelse)
Modtager-services (`ReceiverService`) indeholder nu en liste `CertificateBindings`.
Hver binding kæder en modtager-service sammen med et certifikat for en given periode og gør det muligt at "planlægge" certifikatskift via aktiverings-/udløbsdatoer.
Nyt objekt `CertificateBinding` indeholder: `Id`, `CertificateId`, `ReceiverServiceId`, `ActivationDate`, `ExpirationDate`, `lastModifiedString`.
5. Nye felter på `profile` (tilføjelse)
- `DocumentStandardId` – id på dokumentstandarden.
- `NetworkTypeId` – id på netværkstypen.
6. Tidsstempel for sidste ændring
Tidsstemplet for sidste ændring leveres i feltet **`lastModifiedString`**. Vi anbefaler, at integrationer anvender dette felt fremover.
Hvad skal I gøre?
- Opdater jeres JSON-parsning af `profile`- og `role`-objekterne til de nye PascalCase-feltnavne (punkt 1–2). Dette er den eneste brydende ændring, der kræver kodeændringer.
- Skift fra `peppolEnabled`/`nemhandelAs4Enabled` til `IsPeppolEnabled`/`IsNhAs4Enabled`.
- Brug `lastModifiedString` som tidsstempel for sidste ændring.
- Test mod demo-miljøet og verificér jeres integration inden produktionssætning.
- (Valgfrit) Udnyt de nye felter `ActiveInDkSml`/`ActiveInEuSml` og `CertificateBindings`, hvis de er relevante for jer.
Tidsplan
- Demo/test er tilgængelig nu, på `api-demo.nemhandel.dk`
- Produktionssætning: 12. august 2026
Ved Spørgsmål kan Nemhandel Support kontaktes på support@nemhandel.dk.
Med venlig hilsen
Team Nemhandel