--- swagger: "2.0" info: x-ibm-name: dbe-core-procurement-supplier-api title: DBE Core Procurement SUPPLIER API version: 1.0.0 description: DBE Core API for procurement process that supplier offers to enable digitalized communications with DBE Core Buyer. contact: name: Kari Korpela email: kari.korpela@lut.fi url: https://dbecore.com schemes: - https basePath: /dbecore/procurement/supplier/V1 consumes: - application/json produces: - application/json securityDefinitions: clientIdHeader: type: apiKey in: header name: X-IBM-Client-Id description: Platform managed client token unique for API consumer application. Automatically provided from API Portal as part of the registration process. security: - clientIdHeader: [] x-ibm-configuration: testable: true enforced: true phase: realized paths: /requests/quotations: post: responses: 200: description: 200 OK parameters: - name: QuotationRequest required: true in: body schema: $ref: '#/definitions/RequestForQuation' summary: Used to receive quotations from buyers. DBE Core Supplier needs to provide this API operation in order to receive requests for quotation from DBE Core Buyers. tags: - order - mandatory /orders/{ID}: get: responses: 200: description: 200 OK schema: $ref: '#/definitions/Order' 401: description: 401 Unauthorized schema: type: string tags: - order - optional summary: Can be used to query spefic order information by order ID. Returns current order information. OPTIONAL to provide for DBE Core Supplier. description: Returns Order object (JSON). parameters: - name: ID type: string required: true in: path description: Order ID delete: responses: 200: description: 200 OK 404: description: 404 Not found tags: - order - optional summary: Deletes an existing order by order id. OPTIONAL to provide for DBE Core Supplier. parameters: - name: ID type: string required: true in: path description: OrderID description: Used to delete an order. put: responses: 200: description: 200 OK 404: description: 404 Not found schema: type: string tags: - order - optional summary: Can be used to update an existing order by order ID. OPTIONAL to provide for DBE Core Supplier. parameters: - name: ID type: string required: true in: path description: OrderID - name: OrderChange required: true in: body schema: $ref: '#/definitions/OrderChange' description: Order change description: Updates an existing order. /orders: post: responses: 200: description: 200 OK tags: - order - mandatory summary: Used to submit a new order to supplier. DBE Core Supplier needs to implement this API operation to receive orders from DBE Core Buyer. description: Used to create a new order. parameters: - name: Order required: true in: body schema: $ref: '#/definitions/Order' description: DBE Core Order JSON object definitions: Item: properties: Description: type: string AdditionalItemIdentification: type: string ItemSpecificationDocumentReference: $ref: '#/definitions/Attachement' additionalProperties: false Attachement: properties: uri: type: string description: Web link additionalProperties: false RequestForQuation: properties: CustomizationID: type: string ID: type: string IssueDate: type: string format: date IssueTime: type: string format: date-time NoteType: type: string BuyerCustomerParty: $ref: '#/definitions/BuyerCustomerParty' SellerSupplierParty: $ref: '#/definitions/SellerSupplierParty' Delivery: $ref: '#/definitions/Delivery' OrderLine: $ref: '#/definitions/OrderLine' SubmissionDueDate: type: string format: date RequestedValidityPeriod: type: string additionalProperties: false RequestedDeliveryPeriod: properties: StartDate: type: string format: date EndDate: type: string format: date additionalProperties: false OrderChange: properties: CustomizationID: type: string ID: type: string IssueDate: type: string format: date IssueTime: type: string format: date-time NoteType: type: string BuyerCustomerParty: $ref: '#/definitions/BuyerCustomerParty' SellerSupplierParty: $ref: '#/definitions/SellerSupplierParty' Delivery: $ref: '#/definitions/Delivery' OrderLine: $ref: '#/definitions/OrderLine' SalesOrderID: type: string OrderReference: type: string SequenceNumberID: type: string additionalProperties: false description: Change order message SellerSupplierParty: properties: Party: $ref: '#/definitions/Party' additionalProperties: false Delivery: type: object properties: RequestedDeliveryPeriod: $ref: '#/definitions/RequestedDeliveryPeriod' DeliveryAddress: $ref: '#/definitions/DeliveryAddress' Order: properties: CustomizationID: type: string ID: type: string IssueDate: type: string format: date IssueTime: type: string format: date-time NoteType: type: string BuyerCustomerParty: $ref: '#/definitions/BuyerCustomerParty' SellerSupplierParty: $ref: '#/definitions/SellerSupplierParty' Delivery: $ref: '#/definitions/Delivery' OrderLine: $ref: '#/definitions/OrderLine' additionalProperties: false description: DBE Core Order Data OrderLine: type: array items: $ref: '#/definitions/LineItem' LineItem: properties: ID: type: string Quantity: type: integer format: int64 TaxAmount: type: string Price: type: string Item: $ref: '#/definitions/Item' additionalProperties: false description: LineItem DeliveryAddress: properties: Postbox: type: string example: PL 12 StreetName: type: string example: Teollisuuskatu 1 CityName: type: string example: Kaupunki PostalZone: type: string example: "12340" CountrySubEntity: type: string example: PIRKANMAA Country: $ref: '#/definitions/Country' additionalProperties: false description: Delivery address info BuyerCustomerParty: properties: Party: $ref: '#/definitions/Party' Country: $ref: '#/definitions/Country' Contact: $ref: '#/definitions/Contact' additionalProperties: false description: An association to the buyer Contact: properties: Name: type: string example: Mr. Ville Vallaton Telephone: type: string example: "+35840033221" ElectronicMail: type: string example: ville.vallaton@ibm.com additionalProperties: false description: Contact information Country: properties: IndentificationCode: type: string example: FI description: Country code additionalProperties: false description: Country information Party: properties: PartyIdentification: type: string example: PartyID123 PartyName: type: string example: Ostaja/Myyja Oy PartyLegalEntity: type: string example: Corporate Contact: $ref: '#/definitions/Contact' additionalProperties: false description: Party information tags: - name: quotation description: An API operation that is related to handling quotation data. - name: optional description: An API operation that is optional for DBE Core compliance. - name: mandatory description: An API operation that is mandatory for DBE Core compliance. - name: order description: An API operation that is related to handling order data. x-ibm-endpoints: - endpointUrl: https://api.eu-gb.apiconnect.appdomain.cloud/dbe-core-api-development-api-hack-1/test description: Base Gateway API Endpoint type: - production - development ...