POST /v1/tenders/{tender_id}/invitations
Verkäuferunternehmen auf die Ausschreibung hinweisen. Die Einladung ist ein Hinweis, keine Zulassung: Der Eingeladene erhält eine E-Mail, die den Käufer nicht nennt, sieht die Ausschreibung anonym in seiner Tender Inbox — auch bei invite_only —, fragt Zugang an, und der Käufer entscheidet. Ablehnen kann der Verkäufer eine Einladung nicht; er fragt einfach keinen Zugang an. Einladbar ist jedes verifizierte Unternehmen, das nicht auf der Ausschlussliste steht und noch keinen Zugang hat; die Antwort nennt je Unternehmen das Ergebnis. Einladen lässt sich nur bei einer aktiven, veröffentlichten Ausschreibung (TENDER_INVITATIONS_CLOSED) und bis einschließlich des Tages der Frist für indikative Angebote (TENDER_ADMISSION_DEADLINE_PASSED). Vor der Veröffentlichung dient die Einladungsliste der Ausschreibung. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Die einzuladenden Verkäuferunternehmen (1 bis 200)
1 <= items <= 200Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/invitations" \ -H "Content-Type: application/json" \ -d '{ "company_ids": [ "com_5t8v2w6y" ] }'{
"invited": [
"com_5t8v2w6y"
],
"skipped": [],
"ineligible": []
}{
"type": "https://api.otark.com/errors/tender_deadline_signing_before_offers",
"title": "Geplanter PPA-Abschluss vor der Frist für indikative Angebote",
"status": 400,
"error": "TENDER_DEADLINE_SIGNING_BEFORE_OFFERS",
"instance": "/v1/tenders/ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 401,
"error": "INSUFFICIENT_SCOPES",
"detail": "Missing scope: tenders:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/tender_not_found",
"title": "Ausschreibung nicht gefunden",
"status": 404,
"error": "TENDER_NOT_FOUND",
"instance": "/v1/tenders/ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/tender_admission_deadline_passed",
"title": "Frist für indikative Angebote abgelaufen",
"status": 409,
"error": "TENDER_ADMISSION_DEADLINE_PASSED"
}/tenders/{tender_id}/access-requests/{access_id}/respond POST
Über eine Zugangsanfrage entscheiden oder einem zugelassenen Verkäufer den Zugang entziehen, solange die Ausschreibung aktiv ist (sonst 409). approved lässt einen Verkäufer mit Status requested zu: Er sieht Name und Unternehmensdaten des Käufers, den Lastgang, die Detailbeschreibung und die Anhänge, der Nachrichtenkanal entsteht, und er kann indikative Angebote abgeben. Ein eingeladener Verkäufer muss zuerst selbst Zugang anfragen (409). denied lehnt eine Anfrage ab oder entzieht einem Verkäufer mit Status approved oder shortlisted den Zugang; seine Angebote bleiben für den Käufer sichtbar. Ein nie zugelassener Verkäufer erfährt den Namen des Käufers auch mit der Ablehnung nicht. Die freiwillige Antwort (bis zu 2.000 Zeichen) steht in der E-Mail an den Verkäufer, nicht im Nachrichtenkanal. Eine Frist für die Entscheidung gibt es nicht. Erforderlicher Scope: tenders:write
/tenders/{tender_id}/invitations/{access_id}/resend POST
Die E-Mail einer offenen Einladung (invited) erneut senden. Es gelten dieselben Bedingungen wie beim Einladen; eine Sperrfrist gibt es nicht. Erforderlicher Scope: tenders:write