Sign in

v1

latestOpenAPI 3.0.22026-07-223907721.1 MB
return

Get Return

Get a specific return

get/v2/returns/{returnId}

Path parameters

returnIdstring uuid required
Example:b45f6432-2462-4c6f-b00f-1d9d01000000

The id of the return.

Headers

x-tenant-idstring uuid required

The tenant ID for the target ERP instance.

x-runasstring

The User-Id (int or uuid) on whose behalf the request is executed. Requires scope 'Application.RunAs'.

x-companyidstring

The Company-Id (int or uuid) of the company on whose behalf the request is executed.

Response

Returns the return for the given id.

idstring uuid
numberstring

The number of the return.

returnDatestring date-time

The date when the return was created.

customerIdstring uuid

Represents a unique key for identifying a customer in the JTL system.

externalNumberstring

An arbitrary external reference number for identifying the return, provided only during creation and cannot be changed afterward.

origin0 | 1 | 2 | 3 | 4 | 5 | 6 | 7

0 = None, 1 = Email, 2 = Manual, 3 = Phone, 4 = Fax, 5 = FFN, 6 = SCX, 7 = RestAPI

companyIdstring uuid

Represents a key for identifying a firm within the application.

salesOrderIdstring uuid
stateIdstring uuid
warehouseIdstring uuid
externalCommentstring

The external comment of the sales order.

internalCommentstring

The internal comment of the sales order.

contactstring

The contact of the return.

transmitToSalesChannelboolean

Indicates whether the return should be transmitted to the sales channel (e.g. SCX or Amazon).

Example response

{
  "id": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "customerId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "companyId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "salesOrderId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "stateId": "b45f6432-2462-4c6f-b00f-1d9d01000000",
  "warehouseId": "b45f6432-2462-4c6f-b00f-1d9d01000000"
}