Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/tenders/{tender_id}/invitations
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

company_idsarray<string>

Die einzuladenden Verkäuferunternehmen (1 bis 200)

Items1 <= items <= 200

Response 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"
}