Data for deals (i.e. orders) is available in XML and JSON output formats.
Deal
Detailed information about an order:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| orderId | Yes | String (250) | Unique ITscope key of the purchase order |
| ownOrderId | String (250) | Own order ID | |
| customerOrderId | String (250) | End customer’s order ID | |
| cartId | Yes | String (250) | ID of the shopping cart containing the order, only available in API 2.1 |
| status | Yes | String (255) | Current order status of the order, see section 8: ‘Order status overview’ further down |
| statusMessage | Yes | String (8192) | Additional textual order status notes, sometimes transmitted directly by the seller |
| statusDate | Yes | Date | Last modification date of the order |
| archived | Yes | Boolean | Indicates if an order has been archived, only available in API 2.1 |
| deeplink | Yes | String (2048) | Deep link to the ITscope.com platform, only available in API 2.1 |
| vendor | Vendor (255) | Reference to the seller (internal key, n:1) | |
| orders | List <order> | Details about the list of OpenTrans 2.1 ORDER documents | |
| orderresponses | List <orderresponse> | Details about the list of OpenTrans 2.1 ORDERRESPONSE documents | |
| dispatchnotifications | List <dispatchnotification> | Details about the list of OpenTrans 2.1 DISPATCHNOTIFICATION documents | |
| invoices | List <invoice> | Details about the list of OpenTrans 2.1 INVOICE documents. |
Vendor
Seller data for an order:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| name | Yes | String (255) | Name of the company |
| supplier | Yes | supplier | Reference to the supplier object; only available if this company is a supplier. |
Supplier
Supplier of a source of supply:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| id | Yes | long | Unique key |
| name | Yes | String (255) | Supplier identifier |
| deeplink | Yes | String (2048) | URL, link to the supplier’s page on the ITscope platform |
| customerAccountNumber | String (255) | Customer number in case of partnership. Can be used as a filter to determine if there is a partnership with this supplier. |
Orders
Details about the list of OpenTrans 2.1 ORDER documents:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| transactionId | String (36) | ITscope transactional ID | |
| lastUpdate | Date | Date of the last document update | |
| documentUrl | String (255) | API business documents URL to download the document. If no URL exists, this transaction has no ORDER document. |
Order responses
Details about the list of OpenTrans 2.1 ORDERRESPONSE documents:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| transactionId | String (36) | ITscope transactional ID | |
| lastUpdate | Date | Date of the last document update | |
| documentUrl | String (255) | API business documents URL to download the document. If no URL is available, this transaction has no ORDERRESPONSE document, e.g. because the transaction was initiated manually on the salesboard. |
Dispatch notifications
Details about the list of OpenTrans 2.1 DISPATCHNOTIFICATION documents:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| transactionId | String (36) | ITscope Transactional ID | |
| lastUpdate | Date | Date of the last document update | |
| documentUrl | String (255) | API business documents URL to download the document. If no URL is available, this transaction has no DISPATCHNOTIFICATION document, e.g. because the transaction was initiated manually on the salesboard. |
Invoices
Details about the list of OpenTrans 2.1 INVOICE documents:
| Name | Compulsory field | Data type | Description |
|---|---|---|---|
| transactionId | String (36) | ITscope Transactional ID | |
| lastUpdate | Date | Date of the last document update | |
| documentUrl | String (255) | API business documents URL to download the document. If no URL is available, this transaction has no INVOICE document, e.g. because the transaction was initiated manually on the salesboard. |
Order status overview
| API status | Platform status | Description |
| PREPARING | Suggestion | The order is available as an order proposal, only the orderer can see this order |
| PAYMENT_AWAITING | Payment awaiting/outstanding | For some orders it is possible to make a payment before the order is sent. This status indicates that a payment process is currently taking place |
| PAYMENT_SUCCESSFUL | Payment successful | For some orders it is possible to make a payment before the order is sent. This status indicates that the payment was successful |
| TRANSMITTING | Is currently being sent | The order is being sent to the seller’s system |
| SENT | Sent out | The order has been transmitted to the seller |
| ARRIVED | Arrived | The order has arrived at the seller |
| ARRIVED_WARNING | Arrived with warning | The order has arrived at the seller, but there were some warning notices on the seller’s side. See the statusMessage field for more information. This status may occur if, for example, some of your ordered items have been cancelled or are on backorder. Alternatively, some of your ordered items may have been cancelled or a specific message has been provided by the seller in the field mentioned above |
| PARTIALLY_PROCESSING | Order partially confirmed | The order has been partially confirmed by the seller, i.e. not all line items have been confirmed. See the statusMessage field for more information. This status may occur if, for example, some of your ordered items have been cancelled or are on backorder. Alternatively, some of your ordered items may have been cancelled or a specific message has been provided by the seller in the field mentioned above |
| PROCESSING | Order confirmed | The full order (all line items) has been confirmed by the seller |
| PARTIALLY_ADVISED | Partially in shipment | The order has been partially shipped by the seller, i.e. not all order items have been dispatched yet |
| ADVISED | In shipment | The full order (all line items) has been dispatched by the seller |
| PARTIALLY_INVOICED | Partially invoiced | The order has been partially invoiced by the seller, i.e. not all order items have been invoiced yet |
| INVOICED | Invoiced | The full order (all line items) has been invoiced by the seller |
| CANCELED | Cancelled | The full order has now been rejected by the seller, even though parts of the order may have already been confirmed |
| REJECTED | Rejected | The entire order has been rejected by the seller, or all items in the order have been set to ‘cancelled’ |
| BLOCKED | Blocked | Die Bestellung wurde vom Verkäufer gesperrt, diese kann dann nur explizit vom Verkäufer wieder freigegeben werden |
| BLOCKED_BYLIMIT | Blocked due to exceeding a limit | The order has been blocked because the credit limit or budget has been exceeded |
| ERROR | Error | The order has been successfully transmitted technically to the seller’s system, but the system has reported an error in the initial review of the order. The corresponding error message is recorded in the statusMessage field |
| ORDERED_ELSEWHERE | Ordered elsewhere | This status can be set manually or via the ITscope API, and indicates that the orderer has placed this order elsewhere (email, phone, seller’s shop,…). Under this status, the order is not sent to the seller, but it is still possible to receive EDI response messages from the seller. |