Mit dem SNC-Release vom 26.09.2025 werden diverse Anpassungen am Webservice (API) vorgenommen. Bitte lesen Sie folgende Informationen aufmerksam durch. Es sind eventuell Anpassungen auf Ihrer Seite notwendig.

Beachten Sie für eine Feasibility-Beurteilung ebenfalls die 2025-09-26: Release Notes (SNC) – ZSR Webservice: API Change Matrix.

Inhalt


Beschreibung

Betroffene Objekte/Element/Werte

1. Anpassungen Bankdaten aufgrund SIX-Version v3

Mit dem Wechsel der SIX auf die neue Version v3 werden uns die Bankinformationen anders geliefert bzw. nicht mehr geliefert. Dies führt zu rechts angezeigten Anpassungen der Bankdaten in unserem Webservice.


Webservice ZSRv2.1 SIXv3 SIXnullableVorgehen
clearingNumber.account.bank.bankGroupgroupfehlendneinNeu wird fix das bereits existierende Enum "RESERVE" geliefert.
clearingNumber.account.bank.branchIdbranchIdfehlendjaNeu wird fix 0000 geliefert.
clearingNumber.account.bank.shortNameshortNamefehlendjaNeu wird fix "UNKNOWN" geliefert.
clearingNumber.account.bank.contact.languagelanguagefehlendneinNeu wird fix "DE" geliefert.
clearingNumber.account.bank.contact.mainPhoneNumberphonefehlendjaWird neu nicht mehr geliefert.
clearingNumber.account.bank.contact.faxNumberfaxfehlendjaWird neu nicht mehr geliefert.

2. Neue Information "Spartenanerkennung"

Im Zusammenhang mit der Einführung des TARDOC per 01.01.2026 wird die Spartenanerkennung als neue Eigenschaft auf der ZSR-Nummer unter clearingNumber.functionalUnits ausgeliefert. Es handelt sich um folgende Spartenanerkennungen:

  • Nichtärztliche ambulante Leistungen in der Psychiatrie
    key: a322b1ae-a2ef-4812-8e6a-9fbf821788eb
  • Nichtärztliches Chronic Care Management bei Asthma oder COPD
    key: f60ab454-ae27-4a6d-95d3-118747f3e7b3
  • Nichtärztliches Chronic Care Management bei Diabetes mellitus
    key: d9dcb0ee-acd6-4a16-a035-76976a4eb6e0
  • Nichtärztliches Chronic Care Management bei Herzinsuffizienz oder koronaren Herzkrankheiten
    key: 0472987c-40b3-47cf-b8be-e08df2dc9257
  • Nichtärztliches Chronic Care Management Rheuma
    key: 98bb661a-423a-444d-b114-46b5310b13c4

Diese Informationen werden geliefert mit startDate und endDate.

Zuweisung der neuen Eigenschaft unter clearingNumber.functionalUnits

Test-ZSR-Nummer

A766203 steht auf der Testplattform INT zur Verfügung.


Stammdatenwert unter dem Endpoint FuncitionalUnits

3. Neue Partnerart-Obergruppe (PaOG) für "Medizinische Praxiskoordinatoren und Praxiskoordinatorinnen" (MPK)

Bei der PaOG Ärzte und Ärztinnen werden im Zusammenhang mit der Sparte für Chronic Care Management die angestellten MPK mit deren Qualifikationen erhoben. Die neue PaOG für die MPK wird ausschliesslich bei K-Nummern verwendet.

Neue PaOG für K-Nummern

  • Bezeichnung: Medizinische Praxiskoordinatoren und Praxiskoordinatorinnen
  • Zuweisung PaOG auf K-Nummer unter employeeNumber.businessScope mit key: 
    c65c1657-0bde-4bae-b688-2668d8256006
  • paOgId/paUgId-key-Mapping unter Endpoint BusinessScopes:
    • paOgId 61
    • paUgId 0

Neue Qualifikationen für K-Nummern MPK

Es werden folgende mögliche Qualifikationen der angestellten Personen geliefert:

  • Eidg. Fachausweis Medizinische Praxiskoordinatoren und Praxiskoordinatorinnen
    key: 786453d6-8668-49c8-aa9a-8083dc553113
  • Modul Beratung von Langzeitpatienten - Atemwegserkrankungen
    key: 10843cf9-f0cc-4b02-980a-702d89ff50d5
  • Modul Beratung von Langzeitpatienten - Diabetes
    key: 8b611c5d-bc63-40fb-bbbd-c08af8ad043c
  • Modul Beratung von Langzeitpatienten - Herzkrankheit/Herzinsuffizienz
    key: 0c08738c-02f3-42f6-9723-4ab9729cc9b4 
  • Modul Beratung von Langzeitpatienten - Rheuma
    key: b09386ae-0163-4a56-957c-d735da48a29e 

Zuweisung der neuen PaOG unter employeeNumber.businessScope

Zuweisung der neuen Qualifikationen unter employeeNumber.careProvider.qualifications

Test-K-Nummer

038991K steht auf der Testplattform INT zur Verfügung.



4. Neuer Vertragsbeitritt "LOA V"

Der neue Vertrag "LOA V" wird geliefert unter clearingNumber.careProviderBusinesses.affiliations.

key: 2c4a8636-b912-4a15-9156-d11deaf1ffd9


Zuweisung des neuen Vertragsbeitrittes unter clearingNumber.careProviderBusinesses.affiliations

              "affiliation": {
                "key": "2c4a8636-b912-4a15-9156-d11deaf1ffd9",
               "nameTranslations": {
                "de": "LOA V",
               "fr": "RBP V",
               "it": "RBP V"
                },
                "id": 60004
              },
              "startDate": "0001-01-01",
              "endDate": "9999-12-31",
              "isValid": true,
              "id": 752729
             

Test-ZSR-Nummer

N610623 steht auf der Testplattform INT zur Verfügung.

5. Bestehender Vertragsbeitritt "LOA IV/1"

Im Sinn einer einheitlichen Datenhaltung wird der bestehende Vertrag "LOA IV/1" neu ebenfalls unter clearingNumber.careProviderBusinesses.affiliations geliefert. 

Aus Gründen der Rückwärtskompatiblität bleibt "LOA IV/1" jedoch bis auf weiteres unter clearingNumber.tariffSystems bestehen. Die Entfernung erfolgt zu einem späteren Zeitpunkt mit einem EAC-Release. 

TariffSystem ist neu als deprecated markiert. 

Zuweisung des bestehenden Vertragsbeitrittes neu unter clearingNumber.careProviderBusinesses.affiliations

              "affiliation": {
                "key": "b2cfc2ef-28a3-4439-b847-8c13517ae422",
                "nameTranslations": {
                  "de": "LOA IV/1",
                  "fr": "RBP IV/1",
                  "it": "RBP IV/1"
                },
                "id": 60005
              },
              "startDate": "0001-01-01",
              "endDate": "9999-12-31",
              "isValid": true,
              "id": 789882


Zuweisung des bestehenden Vertragsbeitrittes wie bisher unter clearingNumber.tariffSystems

"tariffSystems": [
        {
          "tariffSystem": {
            "key": "b9e8c935-d598-41a9-bb3a-d8b79c36d65d",
            "tariffSystemType": "LOA",
            "tariffSystemTypeTranslations": {
              "de": "LOA",
              "fr": "RBP",
              "it": "RBP"
            },
            "nameTranslations": {
              "de": "LOA IV/1",
              "fr": "RBP IV/1",
              "it": "RBP IV/1"
            },
            "id": 4
          },
          "startDate": "0001-01-01",
          "endDate": "9999-12-31",
          "isValid": true,
          "id": 1116
        }
      ],

Test-ZSR-Nummer

N610623 steht auf der Testplattform INT zur Verfügung.

6. Neuer Vertragsbeitritt "TARDOC und amb. Pauschalen"

Der neue Tarifstrukturvertrag "TARDOC und amb. Pauschalen" wird geliefert unter clearingNumber.careProviderBusinesses.affiliations.

key: c7b2794a-2f6e-4840-98a8-c65c5e306197


Zuweisung des neuen Vertragsbeitrittes unter clearingNumber.careProviderBusinesses.affiliations

"affiliations": [
            {
              "affiliation": {
                 "key": "c7b2794a-2f6e-4840-98a8-c65c5e306197",
                "nameTranslations": {
                 "de": "Tarifstrukturvertrag TARDOC und amb. Pauschalen",
                 "fr": "Convention de structure tarifaire TARDOC et forfaits amb.",
                 "it": "Convenzione sulla struttura tariffale TARDOC e forfettarie amb."
                },
                "id": 60003
              },
              "startDate": "0001-01-01",
              "endDate": "9999-12-31",
              "isValid": true,
              "id": 752728
            },

Test-ZSR-Nummer

N681311 steht auf der Testplattform INT zur Verfügung.

7. Betäubungsmittel und Selbstdispensation bei Organisationen nicht mehr geliefert

Die Berechtigungen zur Selbstdispensation sowie für den Bezug von Betäubungsmittel wird bei Organisationen von Ärzten und Ärztinnen nicht mehr geliefert.

Grund: Die Berechtigungen werden durch die kantonalen Behörden ausschliesslich für natürliche Personen, keine Organisationen erteilt. 

Die Information wird weiterhin für natürliche Personen der PaOG Ärzte und Ärztinnen geliefert. 

Entfallende Informationen bei Ärzte-Organisationen

Bewilligung zur Selbstdispensation: clearingNumber.facilities.facility

Berechtigung zum Bezug von Betäubungsmittel: clearingNumber.licenses.hasNarcoticSelfDispensation

Test-ZSR-Nummer

N681311 steht auf der Testplattform INT zur Verfügung.

8. Anpassung der Bezeichnung "Gelistetes Spital"

Die Bezeichnung "Gelistetes Spital" unter clearingNumber.careProviderBusinesses.facilities.facility wird umbenannt auf die branchenübliche Bezeichnung "Listenspital".

 Bisherige Bezeichnung unter clearingNumber.careProviderBusinesses.facilities.facility

              "facility": {
                "key": "a4084161-1f80-43d1-bcb7-22b7acf78283",
                "facilityType": "HOSPITAL_FACILITY",
                "facilityTypeTranslations": {
                  "de": "Einrichtung Spital",
                  "fr": "Institution Hôpital",
                  "it": "Istituto ospedale"
                },
                "nameTranslations": {
                  "de": "Gelistetes Spital",
                  "fr": "Sur la liste des hôpitaux",
                  "it": "Ospedale che figura nella lista ospedaliera"
                },
                "id": 50020
              },

Neue Bezeichnung unter clearingNumber.careProviderBusinesses.facilities.facility

"facility": {
                "key": "a4084161-1f80-43d1-bcb7-22b7acf78283",
                "facilityType": "HOSPITAL_FACILITY",
                "facilityTypeTranslations": {
                  "de": "Einrichtung Spital",
                  "fr": "Institution Hôpital",
                  "it": "Istituto ospedale"
                },
                "nameTranslations": {
                  "de": "Listenspital",
                  "fr": "Hôpital répertorié",
                  "it": "Ospedale figurante nell'elenco"
                },
                "id": 50020
              }, 

Test-ZSR-Nummer

E739501 steht auf der Testplattform INT zur Verfügung.

9. Bereinigung Korrespondenz- und Begünstigtenadressen

Bisher: Es wurden Korrespondenz- und Begünstigtenadressen übermittelt, welche sowohl eine Strasse als auch ein Postfach enthielten. 

Neu: Korrespondenz- und Begünstigtenadressen enthalten immer entweder eine Strasse oder ein Postfach und sind somit für die Postzustellung eindeutig.  

Betrifft: clearingNumber.account.beneficiary.contact.postalAddress

Betrifft: clearingNumber.correspondenceParty.contact.postalAddress

10. Bereinigung Standortadressen

Bisher: Es wurden Standortadressen mit Postfach geliefert.

Neu: Standortadressen sind nie Postfachadressen. 

Betrifft: clearingNumber.careProviderBusinesses.careProviderBusinessParties.party.contact.postalAddress

11. PaOG/PaUG: Mapping des Identifikations-"key" mit der Legacy-ID

In den File- und EDI-Abos wurden die PaOG und PaUG mit einer ein- bis zweistelligen ID geliefert. Im Webservice werden diese Stammdaten über einen neuen key identifiziert.

Auf Wunsch der Versicherer wird das Mapping der früheren ID's mit den neuen keys unter den Endpoints BusinessScopes und BusinessActivities ausgewiesen. 

Endpoint BusinessScopes: Enthält das Mapping sämtlicher PaOG's mit Ausnahme der Ärzte und Ärztinnen.












Endpoint BusinessActivities: Enthält das Mapping der PaOG Ärzte und Ärztinnen. 










Die Zuweisung der Eigenschaft auf eine ZSR-Nummer bzw. K-Nummer erfolgt ausschliesslich mittels key. Den erwähnten Endpoints kann das Mapping der keys mit den Legacy-ID's entnommen werden. 

Endpoint BusinessScopes

 

Endpoint BusinessActivities

12. Erhöhte Anzahl Mutationen

Die Anpassungen führen zu einer erhöhten Anzahl Mutationen.

 



  • No labels