business/deals/sales methods

Last modified: 4. March 2025

These methods are for sales deals.

Retrieve a list of received portal deals

URL: GET /business/deals/sales/{view}.{type}

The following query parameters are possible

  • lastUpdateDateFrom 
    • from the date of the last update. Filters out only those orders where something has really changed since date x. In other words, new response documents have been added
  • lastUpdateDateTo
    • to the date of the last update. Filters out only those orders where something has really changed up to date x. In other words, new response documents have been added
  • archiv
    • ARCHIVED: archived deals
    • NOTARCHIVED: unarchived deals
  • sort – Sortierungskriterien
    • LAST_MODIFIED : Change date descending
    • SENT_DESC: Shipping date in descending order
    • SEND_ASC: Shipping date in ascending order
    • SUPPLIER: descending according to supplier
    • ID: descending according to the unique ITscope deal number (orderId field)
  • page
    •  1..n, The queries are always limited to 50 deals per page
  • testOrder (only API 2.1)
    • true: deals which are marked as test
    • false: deals which are not marked as test

E.g.: https://api.itscope.com/2.1/business/deals/sales/deal.xml 

A description of the response is described in the deal format description.

Search for received portal deals

URL: GET /business/deals/sales/search/{filter}/{view}.{type}

The following filters are possible

  • keywords: Partial searches in orderId , ownOrderId and customerOrderId, e.g. keywords=11SRRK
  • orderId (or legacy by dealId): ITscope unique deal number e.g. orderId=11SRRK-150126-1136
  • ownOrderId (or legacy by ownDealId): Own order number assigned by the purchaser, e.g. ownOrderId=54321
  • customerOrderId (or legacy by customerDealId): The order number of the end customer, e.g. customerOrderId=12345
  • status: Filter by deal status, e.g. status=ADVISED
  • cartId: Search based on the shopping cart IDs in which the deal is located*

* only API 2.1, see here.

The following query parameters are possible

  • archiv
    • ARCHIVED: archived deals
    • NOTARCHIVED: unarchived deals
  • sort – Sortierungskriterien
    • LAST_MODIFIED : Change date descending
    • SENT_DESC: Shipping date in descending order
    • SEND_ASC: Shipping date in ascending order
    • SUPPLIER: descending according to supplier
    • ID: descending according to the unique ITscope deal number (orderId field)
  • page
    •  1..n, The queries are always limited to 50 deals per page
  • lastUpdateDateFrom (only API 2.1)
    • Search start date, in the format yyyy-MM-dd or yyyy-MM-ddThh:mm:ss or with time zones yyyy-MM-ddThh:mm:ss±hh:mm
    • see ‘Last Modified Date Search Limitation’ later in this post
  • lastUpdateDateTo (only API 2.1)
    • Search end date, in the format yyyy-MM-dd or yyyy-MM-ddThh:mm:ss or with time zones yyyy-MM-ddThh:mm:ss±hh:mm
    • see ‘Last Modified Date Search Limitation’ later in this post
  • testOrder (only API 2.1)
    • true: deals which are marked as test
    • false: deals which are not marked as test

Example of a search for an order number 54231 assigned by the buyer

https://api.itscope.com/2.1/business/deals/search/sales/ownOrderID%3D54231/deal.xml

Example of a search for an end customer order number 12345

https://api.itscope.com/2.1/business/deals/search/sales/customerOrderID%3D12345/deal.xml

Example of a search for all deals for a shopping cart with the ID 611e-ac7b-42c2-a3b6-2434812ede75

https://api.itscope.com/2.1/business/deals/search/sales/cartId%3D611-ac7b-42c2-a3b6-2434812ede75/deal.xml

A description of the response is described in the deal format description.

Last Modified Date Search Limitation (API 2.1 only)

The corresponding request parameters are only available from API 2.1. The parameters filter on the statusDate field for deals, see format description for deals. The change date indicates when the last time a new response document (transaction document) was added to an deal, such as a changed order confirmation or a delivery note or invoice. New deals that were created during this period are also found

  • lastUpdateDateFrom: The start time for restricting the deal change date period in the format yyyy-MM-dd or yyyy-MM-ddThh:mm:ss or with time zones yyyy-MM-ddThh:mm:ss±hh:mm. Only if this parameter is set will the deals be filtered by the change date period.
  • lastUpdateDateTo: The end time for the order change date period restriction in the format yyyy-MM-dd or yyyy-MM-ddThh:mm:ss or with time zones yyyy-MM-ddThh:mm:ss±hh:mm. If no value is transmitted, the default value is the current date. The value cannot be less than lastUpdateDateFrom.

Submit B2B shop order via API

URL: POST /business/deals/sales/send

B2B orders can be sent to ITscope via POST in API version 2.1.

  • The industry standard OpenTrans 2.1 is used as the format for orders.
  • to download the OpenTrans 2.1 documentation and sample files
  • The MimeType must be application/xml.
  • Sending only works via HTTP POST.
  • In the POST body, only the ORDER may be in OpenTrans 2.1 format and encoded as UTF-8.

The following query parameter is possible:

  • testOrder
    • true: The order is marked with ‘Test’
    • false: The order is not marked with ‘Test’

In the XML of the order, the BUYERIDREF must be set to the ID of the purchasing company. In addition, the email of the purchasing user must be entered in the EMAILS of the buyer party to ensure assignment.

Was this article helpful?
Dislike 0
Views: 97