Document Tree
Document Properties
Kbid
30S611
Last Modified
27-Sep-2022
Added to KB
23-Sep-2022
Public Access
Everyone
Status
Online
Doc Type
References
Product
  • IOM 4.2
  • IOM 4.3
  • IOM 4.4
  • IOM 4.5
  • IOM 4.6
  • IOM 4.7
  • IOM 5.0
  • IOM 5.1
Reference - IOM REST API - Transmissions 2.0


This API specification is available for download as an Open API 3.0 YAML file: 

API Specification

openapi: 3.0.3 info: contact: name: Intershop Communications AG url: https://www.intershop.com description: | The transmission REST API supports tasks to view and manage transmissions of the IOM. title: IOM Transmission REST API version: "2.0" servers: - description: The production API server. url: "{protocol}://{domain}:{port}/rest" variables: protocol: default: https enum: - http - https domain: default: localhost port: default: "443" tags: - description: Transmission related operations exposed by this service. name: transmission paths: /transmissions/by-type: post: description: | Returns all transmissions for selected search criterias. **Note:** This is a POST request (instead of GET with query params) in order to prevent hitting URL / header length restrictions in certain browsers / API clients. operationId: searchTransmissions requestBody: content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/TransmissionSearchRequest' required: true responses: "200": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/TransmissionCollectionContainer' description: The response for a transmission collection request. "400": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/ErrorReport' description: Bad request - Generic or business logic validation error. "401": description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple "403": description: Forbidden - the user is not authorized to use this resource. "406": description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. "500": description: Internal Server Error - An unexpected error occured. security: - basicAuth: [] - bearerAuth: [] summary: Get transmissions by type + additional filter criteria. tags: - transmission /transmissions/{transmissionId}: get: description: Returns a transmission for the given id. operationId: getTransmission parameters: - description: The transmission identifier. example: ORDERTRANSMISSION-10000 explode: false in: path name: transmissionId required: true schema: type: string style: simple responses: "200": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/Transmission' description: The response for one transmission request. "400": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/ErrorReport' description: Bad request - Generic or business logic validation error. "401": description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple "403": description: Forbidden - the user is not authorized to use this resource. "404": description: Not found - the resource is not found. "406": description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. "500": description: Internal Server Error - An unexpected error occured. security: - basicAuth: [] - bearerAuth: [] summary: Get a transmission by id. tags: - transmission /transmissions/types: get: description: Get a list of TransmissionTypes supported by the API. operationId: getTransmissionTypes responses: "200": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/TransmissionTypeMapping' description: TransmissionTypes supported by the API. "401": description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple "403": description: Forbidden - the user is not authorized to use this resource. "406": description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. "500": description: Internal Server Error - An unexpected error occured. security: - basicAuth: [] - bearerAuth: [] summary: Get a list of TransmissionTypes supported by the API. tags: - transmission /transmission-updates/by-id: post: description: "Bulk create processes to update statuses of transmissions. \ \ A process will be created for each transmission, which will be processed\ \ asynchronously." operationId: updateTransmissionsById requestBody: content: application/vnd.intershop.transmission.v2+json: schema: description: Ids of transmissions and update types that should be done. items: $ref: '#/components/schemas/TransmissionUpdateRequest' type: array responses: "207": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/MultiStatusCollectionContainer' description: "Contains multiple responses for different requests, that was\ \ done within one single request." "400": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/ErrorReport' description: Bad request - Generic or business logic validation error. "401": description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple "403": description: Forbidden - the user is not authorized to use this resource. "406": description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. "415": description: Unsupported Media Type - The media type of the sent body is not supported. security: - basicAuth: [] - bearerAuth: [] summary: Bulk create processes to update statuses of transmissions. tags: - transmissionUpdate /transmission-updates/by-filter: post: description: "Bulk create processes to update statuses of transmissions. \ \ A process will be created for each transmission, which will be processed\ \ asynchronously." operationId: updateTransmissionsByFilter requestBody: content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/TransmissionBulkUpdateRequest' responses: "202": description: | The request has been accepted by the system. Updates will be processed in an asynchronous fashion. "400": content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/ErrorReport' description: Bad request - Generic or business logic validation error. "401": description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple "403": description: Forbidden - the user is not authorized to use this resource. "406": description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. "415": description: Unsupported Media Type - The media type of the sent body is not supported. security: - basicAuth: [] - bearerAuth: [] summary: Bulk create processes to update statuses of transmissions. tags: - transmissionUpdate components: parameters: LimitParam: description: The number of items to return. If not set the limit is 1000. explode: true in: query name: limit required: false schema: default: 1000 example: 50 type: integer x-field-extra-annotation: com.intershop.TestAnnotation x-class-extra-annotation: com.intershop.TestAnnotation style: form x-field-extra-annotation: com.intershop.TestAnnotation x-class-extra-annotation: com.intershop.TestAnnotation OffsetParam: description: The number of items to skip before starting to collect the result set. explode: true in: query name: offset required: false schema: default: 0 example: 0 type: integer style: form SortDirectionParam: explode: true in: query name: sortDirection required: false schema: $ref: '#/components/schemas/SortDirection' style: form responses: TransmissionCollectionContainerResponse: content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/TransmissionCollectionContainer' description: The response for a transmission collection request. Created: description: Created - The entity was created successfully. Accepted: description: Accepted - The request was successful and will be processed asynchronously. MultiStatus: description: Multi Status - The request contains several response statuses. BadRequest: content: application/vnd.intershop.transmission.v2+json: schema: $ref: '#/components/schemas/ErrorReport' description: Bad request - Generic or business logic validation error. Unauthorized: description: Unauthorized - Authentication information is missing or invalid. headers: WWW-Authenticate: description: "" explode: false schema: type: string style: simple Forbidden: description: Forbidden - the user is not authorized to use this resource. NotFound: description: Not found - the resource is not found. NotAcceptable: description: Not Acceptable - A representation of the response in the media type that was requested in the ACCEPT header cannot be provided. UnsupportedMediaType: description: Unsupported Media Type - The media type of the sent body is not supported. InternalServerError: description: Internal Server Error - An unexpected error occured. schemas: TransmissionCollectionContainer: properties: meta: $ref: '#/components/schemas/CollectionMetaData' data: description: The core data of the transmission collection. items: $ref: '#/components/schemas/Transmission' type: array type: object MultiStatusCollectionContainer: properties: meta: $ref: '#/components/schemas/MultiStatusCollectionMetaData' data: description: The core data of the multi-status collection. items: $ref: '#/components/schemas/MultiStatus' type: array type: object Transmission: properties: links: items: $ref: '#/components/schemas/Link' type: array id: description: The transmission identifier. example: ORDERTRANSMISSION-10000 type: string transmissionTypeGroup: description: "The type of the transmission. \nNOTE: The following\ \ values are valid examples for this specific API version.\nAPI consumers\ \ must be able to handle other/unknown values in future\n(minor)\ \ versions.\n \n\n| type | description |\n| --- | --- |\n| ORDERTRANSMISSION\ \ | Transmissions that are used for order processing messages, e.g. to\ \ announce an order entry. |\n| DISPATCHTRANSMISSION | Transmissions that\ \ are used for dispatch messages, e.g. a delivery that was made. |\n|\ \ MAILTRANSMISSION | Transmissions that are used for emails, e.g. to send\ \ a delivery email to the customer. |\n| PAYMENTTRANSMISSION | Transmissions\ \ that are used for payment notification messages, e.g. a received payment.\ \ |\n| RETURNTRANSMISSION | Transmissions that are used for return messages,\ \ e.g. a received return. |\n| RESPONSETRANSMISSION | Transmissions that\ \ are used for response messages, e.g. to respond to a delivery request.\ \ |\n| INVOICETRANSMISSION | Transmissions that are used for invoice processing\ \ messages. |\n| DOCUMENTTRANSMISSION | Transmissions that are used for\ \ document processing messages. |\n| RETURNANNOUNCEMENTTRANSMISSION |\ \ Transmissions that are used for return announcements messages. |\n" example: ORDERTRANSMISSION type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeGroupConstraint' transmissionType: description: | Name of the TransmissionType. Internally translates to TransmissionTypeDefDOEnumInterface::getFieldName example: SEND_ANNOUNCE_ORDER type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeNameConstraint' status: description: "The processing status of the transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| status | description |\n| ------ | -----------\ \ |\n| INITIAL | Transmission is initially stored. |\n| DO_PULL | Transmission\ \ will be pulled. |\n| PULLED | Transmission was received (pulled) from\ \ the sender. |\n| DO_PUSH | Transmission can be sent (pushed) to the\ \ receiver. |\n| PUSHED | Transmission was sent (pushed) to the receiver.\ \ |\n| DO_MANUAL_CHECK | The processing of transmission was canceled because\ \ of errors. The transmission has to be checked manually. |\n| CHECKED\ \ | Transmission was checked manually and is ready to process. |\n| DO_CANCEL\ \ | Transmission will be canceled. |\n| CANCELED | Transmission can be\ \ canceled because processing is not required any longer. |\n| TRANSMISSIONED\ \ | Transmission was submitted. |\n| CONFIRMED | Transmission was confirmed\ \ from the receiver. |\n" example: CONFIRMED type: string responseStatus: description: "The status of the response of the transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| responseStatus | description |\n| ------\ \ | ----------- |\n| OK | The transmission was successfully received.\ \ |\n| INVALID | An error occurred during validation check at the receiver.\ \ |\n| REJECTED | The operation was rejected by the receiver. |\n| EXTERNAL_ERROR\ \ | An unexpected error occurred at the receiver. |\n| INTERNAL_ERROR\ \ | Internal unexpected error has occurred. |\n| NOT_AVAILABLE | The response\ \ status is not set. |\n" example: REJECTED type: string creationDate: description: The date when the transmission was created. example: 2018-02-27T09:15:37.562+02:00 format: date-time type: string modificationDate: description: The date when the transmission was modified. example: 2018-02-27T09:15:40.562+02:00 format: date-time type: string orderReferences: description: "The orders connected to this transmission. Multiple orders\ \ might me linked, e.g. for aggregated invoices.\n" items: $ref: '#/components/schemas/ObjectReference' type: array shopId: description: The id of the shop. example: 1000 format: int64 type: integer shopName: description: The name of the shop. example: Test Shop US DE type: string supplierId: description: The id of the supplier. example: 1000 format: int64 type: integer supplierName: description: The name of the supplier. example: Test Supplier US DE type: string receiverType: description: "The type of the receiver of a transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| type | description |\n| ------ | -----------\ \ |\n| OMS | The OMS-application itself. |\n| SHOP | The shop is the receiver\ \ of the transmission. |\n| SUPPLIER | The supplier is the receiver of\ \ the transmission, e.g. of a delivery request. |\n| CUSTOMER | The customer\ \ is the receiver of the transmission, e.g. an email to confirm an order.\ \ |\n| PAYMENTPROVIDER | A payment provider is the receiver of the transmission,\ \ e.g. to note a received payment to. |\n| FINANCECONTROLLER | A finance\ \ contoller is the receiver of the transmission, e.g. a debitor management\ \ system that receives open amounts. |\n" example: SHOP type: string retryCount: description: Number of sending attempts. example: 2 type: integer retryDate: description: The date of the last attempt to send the transmission. example: 2018-02-28T09:15:40.562+02:00 format: date-time type: string nextRetryDate: description: The next date to send the transmission. example: 2018-02-28T09:45:40.562+02:00 format: date-time type: string errorText: description: "The error text, if the transmission failed." example: Timeout - no response within 30s type: string invoiceReference: $ref: '#/components/schemas/ObjectReference' type: object TransmissionBulkUpdateRequest: description: | A request combining updateType + transmissionFilter to trigger a mass update of transmissions. properties: updateType: $ref: '#/components/schemas/TransmissionUpdateType' transmissionFilter: $ref: '#/components/schemas/TransmissionFilter' required: - transmissionFilter - updateType type: object TransmissionUpdateRequest: description: A transmission id and the process that should be done on this transmission. properties: id: description: The transmission identifier. example: ORDERTRANSMISSION-10000 type: string updateType: $ref: '#/components/schemas/TransmissionUpdateType' required: - id - updateType type: object TransmissionTypeGroup: description: "The type of the transmission. \nNOTE: The following\ \ values are valid examples for this specific API version.\nAPI consumers\ \ must be able to handle other/unknown values in future\n(minor) versions.\n\ \n\n| type | description |\n| --- | --- |\n| ORDERTRANSMISSION | Transmissions\ \ that are used for order processing messages, e.g. to announce an order entry.\ \ |\n| DISPATCHTRANSMISSION | Transmissions that are used for dispatch messages,\ \ e.g. a delivery that was made. |\n| MAILTRANSMISSION | Transmissions that\ \ are used for emails, e.g. to send a delivery email to the customer. |\n\ | PAYMENTTRANSMISSION | Transmissions that are used for payment notification\ \ messages, e.g. a received payment. |\n| RETURNTRANSMISSION | Transmissions\ \ that are used for return messages, e.g. a received return. |\n| RESPONSETRANSMISSION\ \ | Transmissions that are used for response messages, e.g. to respond to\ \ a delivery request. |\n| INVOICETRANSMISSION | Transmissions that are used\ \ for invoice processing messages. |\n| DOCUMENTTRANSMISSION | Transmissions\ \ that are used for document processing messages. |\n| RETURNANNOUNCEMENTTRANSMISSION\ \ | Transmissions that are used for return announcements messages. |\n" example: ORDERTRANSMISSION type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeGroupConstraint' TransmissionType: description: "The type of the transmission, e.g. an email that was sent to confirm\ \ an order. TODO - link to docs\n" properties: name: description: | Name of the TransmissionType. Internally translates to TransmissionTypeDefDOEnumInterface::getFieldName example: SEND_ANNOUNCE_ORDER type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeNameConstraint' description: description: | Default description - can be used by frontend applications as a fallback for missing localizations. example: Send an order. type: string type: object TransmissionStatus: description: "The processing status of the transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| status | description |\n| ------ | -----------\ \ |\n| INITIAL | Transmission is initially stored. |\n| DO_PULL | Transmission\ \ will be pulled. |\n| PULLED | Transmission was received (pulled) from the\ \ sender. |\n| DO_PUSH | Transmission can be sent (pushed) to the receiver.\ \ |\n| PUSHED | Transmission was sent (pushed) to the receiver. |\n| DO_MANUAL_CHECK\ \ | The processing of transmission was canceled because of errors. The transmission\ \ has to be checked manually. |\n| CHECKED | Transmission was checked manually\ \ and is ready to process. |\n| DO_CANCEL | Transmission will be canceled.\ \ |\n| CANCELED | Transmission can be canceled because processing is not required\ \ any longer. |\n| TRANSMISSIONED | Transmission was submitted. |\n| CONFIRMED\ \ | Transmission was confirmed from the receiver. |\n" example: CONFIRMED type: string TransmissionTypeMapping: items: $ref: '#/components/schemas/TransmissionTypeMapping_inner' type: array TransmissionUpdateType: description: "The type of process to create on a transmission, e.g. to resend\ \ a transmission. \n\n| type | description |\n| --- | --- |\n| RESEND |\ \ Resend the transmission. |\n| CANCEL | Cancel the transmission. |\n| SENT\ \ | Set the transmission as already sent. |\n" enum: - RESEND - CANCEL - SENT example: RESEND type: string TransmissionResponseStatus: description: "The status of the response of the transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| responseStatus | description |\n| ------ | -----------\ \ |\n| OK | The transmission was successfully received. |\n| INVALID | An\ \ error occurred during validation check at the receiver. |\n| REJECTED |\ \ The operation was rejected by the receiver. |\n| EXTERNAL_ERROR | An unexpected\ \ error occurred at the receiver. |\n| INTERNAL_ERROR | Internal unexpected\ \ error has occurred. |\n| NOT_AVAILABLE | The response status is not set.\ \ |\n" example: REJECTED type: string ReceiverType: description: "The type of the receiver of a transmission. \nNOTE:\ \ The following values are valid examples for this specific API version.\n\ API consumers must be able to handle other/unknown values in future\n\ (minor) versions.\n \n\n| type | description |\n| ------ | -----------\ \ |\n| OMS | The OMS-application itself. |\n| SHOP | The shop is the receiver\ \ of the transmission. |\n| SUPPLIER | The supplier is the receiver of the\ \ transmission, e.g. of a delivery request. |\n| CUSTOMER | The customer is\ \ the receiver of the transmission, e.g. an email to confirm an order. |\n\ | PAYMENTPROVIDER | A payment provider is the receiver of the transmission,\ \ e.g. to note a received payment to. |\n| FINANCECONTROLLER | A finance contoller\ \ is the receiver of the transmission, e.g. a debitor management system that\ \ receives open amounts. |\n" example: SHOP type: string SortableTransmissionAttribute: default: id description: "The attribute to sort by. \nNOTE: The following values\ \ are valid examples for this specific API version.\nAPI consumers must\ \ be able to handle other/unknown values in future\n(minor) versions.\n \n\ \n| type | description |\n| ------ | ----------- |\n| id | Sorts by the ID\ \ in scope of it's type |\n| transmissionType | Sorts by the TransmissionType\ \ |\n| status | Sorts by the processing status |\n| responseStatus | Sorts\ \ by the response status |\n| creationDate | Sorts by the creation date |\n\ | modificationDate | Sorts by the modification date |\n| shopId | Sorts by\ \ the ID of the shop |\n| shopName | Sorts by the name of the shop |\n| supplierId\ \ | Sorts by the ID of the supplier |\n| supplierName | Sorts by the name\ \ of the supplier |\n| receiverType | Sorts by the receiver type of the transmission\ \ |\n| retryCount | Sorts by the number of sending attempts |\n| retryDate\ \ | Sorts by the date of the last attempt to send |\n| nextRetryDate | Sorts\ \ by the next date to send |\n| invoiceNumber | Sorts by the invoice number\ \ |\n" example: creationDate type: string SortDirection: default: ASC description: | The direction used to sort the attributes: | type | description | | ------ | ----------- | | ASC | Ascending sorting. | | DESC | Descending sorting. | enum: - ASC - DESC example: ASC type: string x-class-extra-annotation: com.intershop.TestAnnotation TransmissionFilter: properties: creationDateFrom: description: The earliest creation date of a transmission. example: 2019-01-01T00:00:00.5+02:00 format: date-time type: string creationDateTo: description: The latest creation date of a transmission. example: 2019-01-31T23:59:59.999+02:00 format: date-time type: string transmissionTypeGroup: description: "The type of the transmission. \nNOTE: The following\ \ values are valid examples for this specific API version.\nAPI consumers\ \ must be able to handle other/unknown values in future\n(minor)\ \ versions.\n \n\n| type | description |\n| --- | --- |\n| ORDERTRANSMISSION\ \ | Transmissions that are used for order processing messages, e.g. to\ \ announce an order entry. |\n| DISPATCHTRANSMISSION | Transmissions that\ \ are used for dispatch messages, e.g. a delivery that was made. |\n|\ \ MAILTRANSMISSION | Transmissions that are used for emails, e.g. to send\ \ a delivery email to the customer. |\n| PAYMENTTRANSMISSION | Transmissions\ \ that are used for payment notification messages, e.g. a received payment.\ \ |\n| RETURNTRANSMISSION | Transmissions that are used for return messages,\ \ e.g. a received return. |\n| RESPONSETRANSMISSION | Transmissions that\ \ are used for response messages, e.g. to respond to a delivery request.\ \ |\n| INVOICETRANSMISSION | Transmissions that are used for invoice processing\ \ messages. |\n| DOCUMENTTRANSMISSION | Transmissions that are used for\ \ document processing messages. |\n| RETURNANNOUNCEMENTTRANSMISSION |\ \ Transmissions that are used for return announcements messages. |\n" example: ORDERTRANSMISSION type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeGroupConstraint' transmissionTypeNames: items: $ref: '#/components/schemas/TransmissionTypeName' type: array transmissionStatuses: items: $ref: '#/components/schemas/TransmissionStatus' type: array transmissionResponseStatuses: items: $ref: '#/components/schemas/TransmissionResponseStatus' type: array receiverTypes: items: $ref: '#/components/schemas/ReceiverType' type: array shopIds: description: The id(s) of the shop(s). items: format: int64 type: integer type: array supplierIds: description: The id(s) of the supplier(s). items: format: int64 type: integer type: array shopOrderNumbers: description: | Using this filter will only return transmissions connected to the provided shopOrderNumbers. items: type: string type: array invoiceNumbers: description: | Using this filter will only return transmissions connected to the provided invoiceNumbers. example: - X1939148 - X1939149 items: type: string type: array required: - transmissionTypeGroup type: object x-field-extra-annotation: '@javax.validation.Valid' TransmissionTypeName: description: | Name of the TransmissionType. Internally translates to TransmissionTypeDefDOEnumInterface::getFieldName example: SEND_ANNOUNCE_ORDER type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeNameConstraint' TransmissionSearchRequest: properties: transmissionFilter: $ref: '#/components/schemas/TransmissionFilter' limit: default: 50 description: The number of items to return. If not set the limit is 1000. example: 50 maximum: 1000 type: integer offset: default: 0 description: The number of items to skip before starting to collect the result set. example: 0 type: integer sortBy: default: id description: "The attribute to sort by. \nNOTE: The following\ \ values are valid examples for this specific API version.\nAPI consumers\ \ must be able to handle other/unknown values in future\n(minor)\ \ versions.\n \n\n| type | description |\n| ------ | ----------- |\n\ | id | Sorts by the ID in scope of it's type |\n| transmissionType | Sorts\ \ by the TransmissionType |\n| status | Sorts by the processing status\ \ |\n| responseStatus | Sorts by the response status |\n| creationDate\ \ | Sorts by the creation date |\n| modificationDate | Sorts by the modification\ \ date |\n| shopId | Sorts by the ID of the shop |\n| shopName | Sorts\ \ by the name of the shop |\n| supplierId | Sorts by the ID of the supplier\ \ |\n| supplierName | Sorts by the name of the supplier |\n| receiverType\ \ | Sorts by the receiver type of the transmission |\n| retryCount | Sorts\ \ by the number of sending attempts |\n| retryDate | Sorts by the date\ \ of the last attempt to send |\n| nextRetryDate | Sorts by the next date\ \ to send |\n| invoiceNumber | Sorts by the invoice number |\n" example: creationDate type: string sortDirection: default: ASC description: | The direction used to sort the attributes: `ASC` - Ascending sorting `DESC` - Descending sorting by attribute enum: - ASC - DESC example: ASC type: string required: - transmissionFilter type: object ObjectReference: properties: referenceName: description: "frontend facing identifier, e.g. order number, invoice number" example: X93019345 type: string id: description: internal id of the object example: 10013 format: int64 type: integer type: object Status: description: The HTTP status code. example: 400 format: int32 type: integer MultiStatus: description: "Contains multiple responses `MultiStatusResponse` for different\ \ requests, that was done within one single request." properties: link: $ref: '#/components/schemas/Link' status: description: The HTTP status code. example: 400 format: int32 type: integer errors: items: $ref: '#/components/schemas/Error' type: array required: - link - status type: object Link: properties: href: description: The link to the resource. type: string rel: description: "The relation of the link to the resource, i.e. self." type: string type: object Error: properties: code: description: Exception / Error code example: VALIDATION_EXCEPTION type: string message: description: Exception / Error message example: Attribute XYZ is mandatory type: string required: - code - message type: object ErrorReport: description: Detailed information about what went wrong. properties: status: description: The HTTP status code. example: 400 format: int32 type: integer errors: items: $ref: '#/components/schemas/Error' type: array type: object CollectionMetaData: description: The meta data of the collection. properties: totalCount: description: The total number of objects in the collection (without offset and limit). example: 10000 format: int64 type: integer type: object MultiStatusCollectionMetaData: description: The meta data of a multi-status collection. properties: successCount: description: The number of successful operations. example: 100 format: int64 type: integer failureCount: description: The number of failed operations. example: 5 format: int64 type: integer type: object TransmissionTypeMapping_inner: properties: transmissionTypeGroup: description: "The type of the transmission. \nNOTE: The following\ \ values are valid examples for this specific API version.\nAPI consumers\ \ must be able to handle other/unknown values in future\n(minor)\ \ versions.\n \n\n| type | description |\n| --- | --- |\n| ORDERTRANSMISSION\ \ | Transmissions that are used for order processing messages, e.g. to\ \ announce an order entry. |\n| DISPATCHTRANSMISSION | Transmissions that\ \ are used for dispatch messages, e.g. a delivery that was made. |\n|\ \ MAILTRANSMISSION | Transmissions that are used for emails, e.g. to send\ \ a delivery email to the customer. |\n| PAYMENTTRANSMISSION | Transmissions\ \ that are used for payment notification messages, e.g. a received payment.\ \ |\n| RETURNTRANSMISSION | Transmissions that are used for return messages,\ \ e.g. a received return. |\n| RESPONSETRANSMISSION | Transmissions that\ \ are used for response messages, e.g. to respond to a delivery request.\ \ |\n| INVOICETRANSMISSION | Transmissions that are used for invoice processing\ \ messages. |\n| DOCUMENTTRANSMISSION | Transmissions that are used for\ \ document processing messages. |\n| RETURNANNOUNCEMENTTRANSMISSION |\ \ Transmissions that are used for return announcements messages. |\n" example: ORDERTRANSMISSION type: string x-field-extra-annotation: '@com.intershop.oms.transmission.v2.validation.TransmissionTypeGroupConstraint' transmissionTypes: items: $ref: '#/components/schemas/TransmissionType' type: array type: object securitySchemes: bearerAuth: bearerFormat: JWT description: JWT Bearer token scheme: bearer type: http basicAuth: description: Basic Authentication scheme: basic type: http

Open ReDoc-rendered Open API documentation in separate window.

Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.