# Transfer Green Lot To Location

Transfers weight from a given green lot to another location.
 
When transferring green lot weight the following cases need to be distinguish:
 - When the green lot hasn't yet transferred to the destination location, a new green lot in the destination location will be created.
 - When the green lot has already been transferred to the specified destination location, the green lot weight in the destination location will be increased.
 
Please consider the following business constraints before you execute your request:
  - Consumed lots cannot be transferred
  - Transferred weight may not be negative
  - Transferred weight may be less or equal than the origin green lot weight

Endpoint: POST /inventory.green.transferGreenLotToLocation
Security: oauth2

## Request fields (application/json):

  - `data` (object)
    Defines the data required for the operation, including all mandatory and optional fields.

  - `data.greenLotId` (string, required)
    The green lot that should be transferred to another location
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `data.weight` (object, required)
    Represents the current weight of the object.

  - `data.weight.amount` (number, required)
    The weight amount represented as floating-point number.
    Example: 12.5

  - `data.weight.unit` (string, required)
    The weight unit of the object.
    Enum: "KG", "LBS"

  - `data.destinationLocationId` (string, required)
    The destination location where the green lot should be transferred to
    Example: "660e8400-e29b-41d4-a716-446655440000"

## Response 200 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful.
    Example: true

  - `result` (object)
    Contains the response data of a successful request.

  - `result.sourceGreenLot` (object)
    The source green lot from which weight was transferred.

  - `result.sourceGreenLot.id` (string)
    The unique identifier of the green lot.
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `result.sourceGreenLot.weight` (object)
    Represents the current weight of the object.

  - `result.sourceGreenLot.weight.amount` (number, required)
    The weight amount represented as floating-point number.
    Example: 12.5

  - `result.sourceGreenLot.weight.unit` (string, required)
    The weight unit of the object.
    Enum: "KG", "LBS"

  - `result.sourceGreenLot.locationId` (string)
    The location identifier that is associated to the green lot.
    Example: "660e8400-e29b-41d4-a716-446655440000"

  - `result.destinationGreenLot` (object)
    The destination green lot that received the transferred weight.

## Response 400 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 401 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 403 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 422 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 500 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"