Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede
Note

Mit dem EAC-Release vom 28.03.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-03-28: Release Notes (EAC) – ZSR Webservice: API Change Matrix (28.03.2025).

Info
titleInhalt

Table of Contents
stylenone


BeschreibungBetroffene EndpointsBetroffene Objekte/Element/Werte

Neue Nummernkreise

Die Nummernkreise für die Kantone ZH (31) und GE (25) sind demnächst erschöpft. Es wurden neue Nummernkreise erstellt. Der Nummernkreis entspricht den letzten beiden Ziffern einer ZSR-Nummer (suffixNumber).

  • ZH (01 und 31): neu 34 
  • GE (25): neu 35

Die neuen Nummernkreise werden im Webservice (API) unter clearingNumberSuffix.suffixNumber ausgeliefert. Die alten Nummernkreisen bleiben bestehen.

ClearingNumberSuffixesclearingNumber.clearingNumberSuffix.suffixNumber

Neue Leistungserbringer-Kategorien

Die Krankenpflegeversicherungsverordnung (KVV) wird voraussichtlich im 2025 um zwei neue Leistungserbringer-Kategorien ergänzt:

  • Organisationen der Apotheker und Apothekerinnen (Art. 41 nKVV) 
  • Organisationen der Zahnärzte und Zahnärztinnen (Art. 43 nKVV)

Die neuen Leistungserbringer-Kategorien wurden integriert bzw. die bestehenden Bezeichnungen an jene der KVV angeglichen.     

Apotheken

Die vorhandene Partnerart-Obergruppe (parentBusinessScope) "Apotheken" wird in "Apotheker und Apothekerinnen" umbenannt.

Die vorhandene Partnerart-Untergruppe (businessScope) "Apotheken" wird in "Organisationen der Apotheker und Apothekerinnen" umbenannt.

Zusätzlich wir eine neue Partnerart-Untergruppe (businessScope) "Apotheker und Apothekerinnen" hinzugefügt.

Zahnärzte

Die vorhandene Partnerart-Untergruppe (businessScope) "Einrichtungen der amb. Krankenpflege durch Zahnärzte & Zahnärztinnen" wird in "Organisationen der Zahnärzte und Zahnärztinnen" umbenannt.

ClearingNumbers


Objekte: parentBusinessScope + businessScope

Attribute:

  • Apotheken (Objekt parentBusinessScope)
    Neu: Apotheker und Apothekerinnen
  • Apotheken (Objekt businessScope)
    Neu: Organisationen der Apotheker und Apothekerinnen
  • Einrichtungen der amb. Krankenpflege durch Zahnärzte & Zahnärztinnen (Objekt businessScope)
    Neu: Organisationen der Zahnärzte und Zahnärztinnen

Neue akademische Titel

Einer ZSR-Nummer können folgende akademischen Titel neu zugewiesen werden:

  • lic. phil.
  • lic. psych.
  • dipl. psych.
  • Dr. med. Dr. med. dent.

Diese neuen akademischen Titel werden als Wert unter academicTitle ausgeliefert.

ClearingNumber

Enum: academicTitle

Neue Werte:

  • lic. phil.
  • lic. psych.
  • dipl. psych.
  • Dr. med. Dr. med. dent.

Neue Haupttätigkeit "Spezialfälle" bei Partnerart-Obergruppe Ärzte und Ärztinnen

Einer ZSR-Nummer der Partnerart-Obergruppe Ärzte und Ärztinnen kann als Haupttätigkeit "Speziallfälle" zugewiesen werden. Dieser Wert wird im Webservice unter businessactivity ausgeliefert.

ClearingNumber

Enum: clearingNumber.careProviderBusinesses.businessactivity

Neuer Wert: Spezialfälle

Trägerschaft (privat/öffentlich) wird nicht mehr geliefert

Die Information "Trägerschaft" mit den Werten "öffentlich" oder "privat" bei Spitälern und Pflegeheimen wird nicht mehr erhoben.
Das Feld clearingNumber.careProvider.careProviderParties.party.organizingInstitutionType wird im Webservice entfernt. 

Bitte beachten Sie: Bisher wurde das Feld clearingNumber.careProvider.careProviderParties.party.organizingInstitutionType nicht ausgeliefert, wenn als Wert NULL definiert war. Wir gehen davon aus, dass keine Anpassungen auf Ihrer Seite notwendig sind. 

ClearingNumbersclearingNumber.careProvider.careProviderParties.party.organizingInstitutionType

Abrechnung über VESR wird nicht mehr geliefert

Die Information, ob über VESR abgerechnet werden soll, ist mit der Einführung der QR-Rechnung obsolet.
Sie wird nicht mehr erhoben und das Feld "hasPaymentOrderReferenceNumber" wird entfernt.  

Bitte beachten Sie: Bisher wurde das Feld "hasPaymentOrderReferenceNumber" nicht ausgeliefert, wenn als Wert NULL definiert war. Wir gehen davon aus, dass keine Anpassungen auf Ihrer Seite notwendig sind. 

ClearingNumber

ClearingNumber.HasPaymentOrderReferenceNumber

Anzahl Betten wird nicht mehr geliefert

Die Information "Anzahl Betten" wird zukünftig bei Spitälern und Pflegeheimen nicht mehr erhoben.
Sie entfällt unter den Enum-Werten "NursingHomeFacility" und "HospitalFacility".

Facilities

Enum: FacilityType
Enum-Werte:
NursingHomeFacility + HospitalFacility
Eigenschaft: Kategorie Anzahl Betten

HOSPITAL_LAB_INFRASTRUCTURE wurde entfernt

Der Enum-Wert HOSPITAL_LAB_INFRASTRUCTURE wurde nie verwendet und wurde somit unter facilityType entfernt.

Bitte beachten Sie: HOSPITAL_LAB_TYPE (Spitallaboratorium) mit den Werten Typ A, Typ B, Typ C und Typ O sind nicht betroffen und werden weiterhin geliefert. 

FacilitiesEnum: facilityType 
Wert: HOSPITAL_LAB_INFRASTRUCTURE

Geburtsort und Geburtsland werden nicht mehr geliefert

Die Informationen Geburtsort und Geburtsland werden nicht mehr geliefert. Die Felder clearingNumber.careProvider.careProviderParties.birthPlace und clearingNumber.careProvider.careProviderParties.birthCountry wurden entfernt.

Bitte beachten Sie: Bisher wurden die Entitäten clearingNumber.careProvider.careProviderParties.birthPlace und clearingNumber.careProvider.careProviderParties.birthCountry nicht ausgeliefert, wenn als Wert NULL definiert war. Wir gehen davon aus, dass keine Anpassungen auf Ihrer Seite notwendig sind. 

ClearingNumber

clearingNumber.careProvider.careProviderParties.birthPlace

clearingNumber.careProvider.careProviderParties.birthCountry


K-Nummern ohne Anstellungsverhältnis werden nicht mehr geliefert

K-Nummern werden nur geliefert, wenn diese über mindestens ein gültiges Anstellungsverhältnis verfügt oder in der Vergangenheit verfügte.
K-Nummern ohne Anstellungsverhältnisse werden nicht mehr geliefert. 

Numbers

numberTypes: EmployeeNumber

CareProvider-E-Mail wird nicht mehr geliefert

Wie bereits mit den den 2024-04-26: Release Notes (SNC) - ZSR Webservice (26.04.2024) angekündigt angekündigt, wird das Feld careProvider.email im Webservice entfernt.

Für die Kommunikation mit den Leistungserbringern wird die E-Mail-Adresse, falls vorhanden, pro ZSR-Nummer bei der Korrespondenzadresse unter clearingNumber.correspondenceParty.contact.email übermittelt.

ClearingNumber

EmployeeNumbers

 careProvider.email

Anpassungen Korrespondenzsprache

Wie bereits in

In den Release Notes vom 26.04.2024

unter

wurde unter Release Notes (SNC) - ZSR Webservice (26.04.2024) angekündigt,

wird die Sprache an folgenden Orten

dass folgende Sprachen nicht mehr geliefert werden, was gemäss Schema auch schon bisher möglich war:

  • clearingNumber.account.beneficiary.contact.language (wurde aus technischen Gründen nicht als "deprecated" gekennzeichnet)language 
  • clearingNumber.careProviderBusinesses.careProviderBusinessParties.party.contact.language 

Die Umsetzung wurde neu wie folgt angepasst: 

Es wird weiterhin eine Sprache geliefert. Da keine Sprache in diesen Bereichen erhoben wird, liefern wir die Sprache des CareProviders (clearingNumber.careProvider.careProviderParties.party.contact.language

(wurde aus technischen Gründen nicht als "deprecated" gekennzeichnet)

). 

Hinweise:

  • Die Korrespondenzsprache des Rechtträgers wird
weiterhin
  • unter dem CareProvider geliefert für ZSR- und K-Nummern:
    • employeeNumber.careProvider.careProviderParties.party.contact.language 
    • clearingNumber.careProvider.careProviderParties.party.contact.language 
  • Im Falle von ZSR-Nummern empfehlen wir Ihnen die Verwendung der Nummern bezogenen Korrespondenzsprache unter clearingNumber.correspondenceParty.contact.language
  • Die Korrespondenzsprache unter bank.contact
wird weiterhin geliefert und
  • weist die von SIX geführte Sprache der Bank aus. 

  • clearingNumber.account.beneficiary.contact.language
  • clearingNumber.careProviderBusinesses.careProviderBusinessParties.party.contact.language
Sv translation
languagefr
Note

Avec l’implémentation de la version EAC du 28.03.2025 le service web (API) va faire l’objet de diverses adaptations. Veuillez lire attentivement les informations suivantes. Des adaptations sont éventuellement nécessaires de votre côté.

Pour une évaluation de la faisabilité, veuillez également tenir compte de

 EAC

2025-03-28: Release Notes (EAC) – ZSR Webservice: API Change Matrix

(28.03.2025)

.

Info
titleTable des matières

Table of Contents
stylenone


DescriptionPoints de terminaison concernésObjets/élément/valeurs concernés

Nouvelles plages de numéros

Les plages de numéros pour les cantons ZH (31) et GE (25) seront bientôt épuisées. De nouvelles plages de numéros ont été créées. La plage de numéro correspond aux deux derniers chiffres du numéro RCC (suffixNumber).

  • ZH (01 et 31): dorénavant 34
  • GE (25): dorénavant 35

Les nouvelles plages de numéros seront indiquées dans le service web (API) sous clearingNumberSuffix.suffixNumber. Les  anciennes plages de numéros restent opérationnelles.

ClearingNumberSuffixesclearingNumber.clearingNumberSuffix.suffixNumber

Nouvelles catégories de fournisseurs de prestations

Il est prévu en 2025 de compléter l’Ordonnance sur l’assurance-maladie (OAMal) par deux nouvelles catégories de fournisseurs de prestations:

  • Organisations de pharmaciens  (art. 41 nOAMal) 
  • Organisations de dentistes (art. 43 nOAMal)

Les nouvelles catégories de fournisseurs de prestations ont été intégrées, resp. les dénominations employées jusqu’à présent ont été harmonisées avec celles de l’OAMal.     

2.1. Pharmacies

L’actuel groupe principal de genre de partenaire (parentBusinessScope) «Pharmacies» est renommé «Pharmaciens».

L’actuel sous-groupe de genre de partenaires (businessScope) «Pharmacies» est renommé «Organisations de pharmaciens».

En supplément, un nouveau sous-groupe (businessScope) «Pharmaciens» est ajouté.

2.2. Dentistes

L’actuel sous-groupe de genre de partenaires (businessScope) «Etablissements de soins amb. fournis par des dentistes» est renommé « Organisations de dentistes».

ClearingNumbers


Objets: parentBusinessScope + businessScope

Attributs:

  • Pharmacies (Objekt parentBusinessScope)
    Désormais: Pharmaciens
  • Pharmacies (Objet businessScope)
    Désormais: Organisations de pharmaciens
  • Etablissement de soins amb. fournis par des dentistes (Objet businessScope)
    Désormais: Organisations de dentistes

Nouveaux titres académiques

Dorénavant, il est possible d’associer en supplément à un numéro RCC les titres académiques suivants:

  • lic. phil.
  • lic. psych.
  • psych. dipl.
  • Dr méd. Dr méd. dent.

Ces nouveaux titres académiques sont indiqués sous forme de valeur comme academicTitle.

ClearingNumber

Enum: academicTitle

Nouvelles valeurs:

  • lic. phil.
  • lic. psych.
  • psych. dipl.
  • Dr méd. Dr méd. dent.

Nouvelle activité principale «cas spéciaux» dans le groupe principal de genre de partenaires Médecins

Il est possible d’associer un numéro RCC du groupe principal de genre de partenaires Médecins comme activité principale «cas spéciaux». Cette valeur est indiquée dans le service web sous businessactivity.

ClearingNumber

Enum: clearingNumber.careProviderBusinesses.businessactivity

Nouvelle valeur: cas spéciaux

Organe responsable (privé/public) n’est plus indiqué

L’information «organe responsable» avec les valeurs «public» ou «privé» n’est plus collectée pour les hôpitaux et EMS.
Le champ clearingNumber.careProvider.careProviderParties.party.organizingInstitutionType va disparaître dans le service web.

Veuillez noter l’information suivante: jusqu’à présent, le champ clearingNumber.careProvider.careProviderParties.party.organizingInstitutionType n’était pas indiqué lorsque la valeur ZÉRO était définie. Nous partons du principe qu’aucune adaptation n’est nécessaire de votre côté.

ClearingNumbersclearingNumber.careProvider.careProviderParties.party.organizingInstitutionType

Facturation par SBVR n’est plus indiquée

L’information précisant si la facturation doit s’opérer par SBVR est obsolète depuis l’introduction de la facture QR.
Elle n’est plus collectée et le champ «hasPaymentOrderReferenceNumber» disparaît.  

Veuillez noter l’information suivante: jusqu’à présent, le champ «hasPaymentOrderReferenceNumber» n’était pas indiqué lorsque la valeur ZÉRO était définie. Nous partons du principe qu’aucune adaptation n’est nécessaire de votre côté.

ClearingNumber

ClearingNumber.HasPaymentOrderReferenceNumber

Nombre de lits n’est plus indiqué

L’information «nombre de lits» ne sera plus collectée à l’avenir pour les hôpitaux et les EMS.
Elle n’est plus prévue dans les valeurs Enum «NursingHomeFacility» et «HospitalFacility».

Facilities

Enum: FacilityType
Enum-Werte:
NursingHomeFacility + HospitalFacility
Caractéristique: catégorie Nombre de lits

HOSPITAL_LAB_INFRASTRUCTURE a été supprimé

La valeur Enum HOSPITAL_LAB_INFRASTRUCTURE n’était jamais utilisée si bien qu’elle a été supprimée dans facilityType.

Veuillez noter l’information suivante: HOSPITAL_LAB_TYPE (laboratoire d’hôpital) avec les valeurs Type A, Type B, Type C et Type O ne sont pas concernés et continuent d’être indiqués. 

FacilitiesEnum: facilityType 
Valeurs: HOSPITAL_LAB_INFRASTRUCTURE

Lieu de naissance et pays de naissance ne sont plus indiqués

Les informations lieu de naissance et pays de naissance ne sont plus indiquées. Les champs clearingNumber.careProvider.careProviderParties.birthPlace et clearingNumber.careProvider.careProviderParties.birthCountry ont été supprimés.

Veuillez noter l’information suivante : Jusqu’à présent les entités clearingNumber.careProvider.careProviderParties.birthPlace et clearingNumber.careProvider.careProviderParties.birthCountry n’étaient pas indiquées lorsque la valeur ZÉRO était définie. Nous partons du principe qu’aucune adaptation n’est nécessaire de votre côté.

ClearingNumber

clearingNumber.careProvider.careProviderParties.birthPlace

clearingNumber.careProvider.careProviderParties.birthCountry


Les numéros C sans contrat de travail ne sont plus indiqués

Les numéros C ne sont indiqués que si le numéro en question dispose, ou a disposé dans le passé, d’au moins un contrat de travail valable.
Les numéros C sans contrat de travail ne sont plus indiqués. 

Numbers

numberTypes: EmployeeNumber

L’e-mail de l’établissement de soins (CareProvider) n’est plus indiqué

Comme déjà annoncé dans les les 2024-04-26: Release Notes (SNC) - ZSR Webservice (26.04.2024)_französisch, le champ careProvider.email va disparaître dans le service web.

Le champ careProvider.email est déjà répertorié comme «deprecated» dans la documentation Swagger. 
Pour la communication avec les fournisseurs de prestations, l’adresse e-mail, si elle existe, est transmise pour chaque numéro RCC avec l’adresse de correspondance dans le champ clearingNumber.correspondenceParty.contact.email.

ClearingNumber

EmployeeNumbers

 careProvider.email

Adaptations de la langue de correspondance

Comme déjà annoncé dans

Dans les Release Notes

du 26.04.2024 (voir 

du 26/04/2024, il a été annoncé, sous Release Notes (SNC) -

ZSR Webservice

Service Web RCC (26

.

/04

.

/2024),

la langue n’est plus indiquée aux endroits suivants

que les langues suivantes ne seront plus transmises, ce qui, selon le schéma, était déjà le cas auparavant:

  • clearingNumber.account.beneficiary.contact.
language (n’a pas été répertorié comme DEPRECATED pour des raisons techniques)
  • language 
  • clearingNumber.careProviderBusinesses.careProviderBusinessParties.party.contact.language 
(n’a pas été répertorié comme DEPRECATED pour des raisons techniques)
A noter

L’implémentation a été adaptée comme suit: 

Une langue continue d’être transmise. Étant donné qu’aucune langue n’est relevée dans ces domaines, nous transmettons la langue du CareProvider (clearingNumber.careProvider.careProviderParties.party.contact.language). 

Remarques:

  • La langue de correspondance de
l’établissement de soins continue d’être indiquée pour
  • la personne morale est transmise sous le CareProvider pour les numéros RCC et C:
    • employeeNumber.careProvider.careProviderParties.party.contact.
language
    • language 
    • clearingNumber.careProvider.careProviderParties.party.contact.language 
S’agissant de
  • Dans le cas des numéros RCC, nous vous recommandons d’utiliser la langue de correspondance liée
aux numéros sous clearingNumber
  • au numéro sous clearingNumber.correspondenceParty.contact.language. 
  • La langue de correspondance
pour
  • sous bank.contact
continue d’être indiquée et désigne
  • indique la langue de la banque
enregistrée dans
  • gérée par SIX. 

  • clearingNumber.account.beneficiary.contact.language
  • clearingNumber.careProviderBusinesses.careProviderBusinessParties.party.contact.language