POST/api/v1/s2s/partners/pharmacies

Register a partner pharmacy

Freigegebener Partner-Endpunkt aus dem stabilen OpenAPI-1.0.0-Vertrag.

Übersicht

Nutzen Sie den Endpunkt ausschließlich mit einem Partner-API-Schlüssel. Die Codebeispiele verwenden Platzhalter und die öffentliche Sandbox-Adresse.

Methode
POST
Endpunkt
/api/v1/s2s/partners/pharmacies
Authentifizierung
X-API-Key

Anfrage

Parameter

X-Correlation-IDstringheader
Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.
Beispiel: 33333333-3333-4333-8333-333333333333

Request-Body

Erforderlich
acceptedDataProcessingbooleanErforderlich
Must be true: the partner confirms the pharmacy accepted the data processing terms.
Beispiel: true
partnerstringErforderlich
Partner channel identifier.
Beispiel: gedisa
partnerOrgIdstringErforderlich
Partner-controlled pharmacy identifier in the partner namespace. Registrations are idempotent per (partner, partnerOrgId).
Beispiel: pharmacy-4711
pharmacyobjectErforderlich
Pharmacy master data. All fields are required (AF-189) so the tenant is fully usable without manual follow-up.
pharmacy.addressobjectErforderlich
Pharmacy address.
pharmacy.address.citystringErforderlich
City.
Beispiel: Hamburg
pharmacy.address.postalCodestringErforderlich
Postal code.
Beispiel: 20457
pharmacy.address.streetstringErforderlich
Street and number.
Beispiel: Musterstr. 1
pharmacy.desiredSlugstringErforderlich
Desired tenant slug.
Beispiel: beispiel-apotheke-4711
pharmacy.organizationDisplayNamestringErforderlich
Pharmacy display name.
Beispiel: Beispiel Apotheke
pharmacy.organizationLegalNamestringErforderlich
Legal name of the pharmacy.
Beispiel: Beispiel Apotheke e.K.
pharmacy.primaryContactEmailstring (email)Erforderlich
Owner contact email.
Beispiel: kontakt@example.test
pharmacy.primaryContactNamestringErforderlich
Owner contact of the pharmacy.
Beispiel: Synthetischer Kontakt
pharmacy.primaryContactPhonestringErforderlich
Owner contact phone.
Beispiel: +49 40 123456

Vertrag

Der versionierte OpenAPI-Vertrag ist die verbindliche Quelle für Parameter, Request-Body und Response-Schemas.

Version

1.0.0

Erwartete Antwort

201 Created

OpenAPI 1.0.0 herunterladen