Change a transfer segment

curl --request PUT \
  --url https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_step_id": "<string>",
  "from_step_position": 2,
  "to_step_id": "<string>",
  "to_step_position": 2,
  "cost": "<string>",
  "costs": "<string>",
  "started_at": "<string>",
  "ended_at": "<string>"
}
'

import requests

url = "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}"

payload = {
    "from_step_id": "<string>",
    "from_step_position": 2,
    "to_step_id": "<string>",
    "to_step_position": 2,
    "cost": "<string>",
    "costs": "<string>",
    "started_at": "<string>",
    "ended_at": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    from_step_id: '<string>',
    from_step_position: 2,
    to_step_id: '<string>',
    to_step_position: 2,
    cost: '<string>',
    costs: '<string>',
    started_at: '<string>',
    ended_at: '<string>'
  })
};

fetch('https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'from_step_id' => '<string>',
    'from_step_position' => 2,
    'to_step_id' => '<string>',
    'to_step_position' => 2,
    'cost' => '<string>',
    'costs' => '<string>',
    'started_at' => '<string>',
    'ended_at' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}"

	payload := strings.NewReader("{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "transfer_id": "<string>",
  "from_step_id": "<string>",
  "to_step_id": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "route_leg_ids": "<array>",
  "cost_total_minor": 123,
  "from_step": {
    "id": "<string>",
    "transfer_id": "<string>",
    "position": 123,
    "location_group_id": "<string>",
    "status": "<string>",
    "operations_executed_at": "2023-11-07T05:31:56Z",
    "approved_by_company_id": "<string>",
    "approved_by_user_id": "<string>",
    "approved_at": "2023-11-07T05:31:56Z",
    "completed_by_company_id": "<string>",
    "completed_by_user_id": "<string>",
    "completed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "location_group": {
      "id": "<string>",
      "name": "<string>"
    },
    "receipts": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_line_id": "<string>",
        "asset_id": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ],
    "dispatches": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_segment_id": "<string>",
        "transfer_line_id": "<string>",
        "position": 123,
        "asset_id": "<string>",
        "group_id": "<string>",
        "vendor_name": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ]
  },
  "to_step": {
    "id": "<string>",
    "transfer_id": "<string>",
    "position": 123,
    "location_group_id": "<string>",
    "status": "<string>",
    "operations_executed_at": "2023-11-07T05:31:56Z",
    "approved_by_company_id": "<string>",
    "approved_by_user_id": "<string>",
    "approved_at": "2023-11-07T05:31:56Z",
    "completed_by_company_id": "<string>",
    "completed_by_user_id": "<string>",
    "completed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "location_group": {
      "id": "<string>",
      "name": "<string>"
    },
    "receipts": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_line_id": "<string>",
        "asset_id": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ],
    "dispatches": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_segment_id": "<string>",
        "transfer_line_id": "<string>",
        "position": 123,
        "asset_id": "<string>",
        "group_id": "<string>",
        "vendor_name": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ]
  },
  "costs": [
    {
      "id": "<string>",
      "transfer_segment_id": "<string>",
      "transfer_route_leg_cost_id": "<string>",
      "company_id": "<string>",
      "creator_user_id": "<string>",
      "label": "<string>",
      "amount": 123,
      "amount_minor": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "lines": [
    {
      "id": "<string>",
      "transfer_id": "<string>",
      "transfer_segment_id": "<string>",
      "stockable_id": "<string>",
      "stockable_unit_id": "<string>",
      "base_quantity": 123,
      "remaining_quantity": 123,
      "in_transit_quantity": 123,
      "created_by_company_id": "<string>",
      "creator_user_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "resolutions": [
        {
          "id": "<string>",
          "transfer_id": "<string>",
          "transfer_line_id": "<string>",
          "transfer_step_id": "<string>",
          "type": "<string>",
          "quantity": 123,
          "reason": "<string>",
          "company_id": "<string>",
          "creator_user_id": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "dispatches": [
        {
          "id": "<string>",
          "transfer_step_id": "<string>",
          "transfer_segment_id": "<string>",
          "transfer_line_id": "<string>",
          "position": 123,
          "asset_id": "<string>",
          "group_id": "<string>",
          "vendor_name": "<string>",
          "quantity": 123,
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "asset_name": "<string>"
        }
      ],
      "stockable": {
        "id": "<string>",
        "title": "<string>"
      },
      "stockable_unit": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ]
}

{
  "message": "<string>",
  "errors": {}
}

PUT

catalog

transfers

{transfer}

segments

{segment}

Change a transfer segment

curl --request PUT \
  --url https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_step_id": "<string>",
  "from_step_position": 2,
  "to_step_id": "<string>",
  "to_step_position": 2,
  "cost": "<string>",
  "costs": "<string>",
  "started_at": "<string>",
  "ended_at": "<string>"
}
'

import requests

url = "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}"

payload = {
    "from_step_id": "<string>",
    "from_step_position": 2,
    "to_step_id": "<string>",
    "to_step_position": 2,
    "cost": "<string>",
    "costs": "<string>",
    "started_at": "<string>",
    "ended_at": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    from_step_id: '<string>',
    from_step_position: 2,
    to_step_id: '<string>',
    to_step_position: 2,
    cost: '<string>',
    costs: '<string>',
    started_at: '<string>',
    ended_at: '<string>'
  })
};

fetch('https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'from_step_id' => '<string>',
    'from_step_position' => 2,
    'to_step_id' => '<string>',
    'to_step_position' => 2,
    'cost' => '<string>',
    'costs' => '<string>',
    'started_at' => '<string>',
    'ended_at' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}"

	payload := strings.NewReader("{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.exowpee.com/v1/catalog/transfers/{transfer}/segments/{segment}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"from_step_id\": \"<string>\",\n  \"from_step_position\": 2,\n  \"to_step_id\": \"<string>\",\n  \"to_step_position\": 2,\n  \"cost\": \"<string>\",\n  \"costs\": \"<string>\",\n  \"started_at\": \"<string>\",\n  \"ended_at\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "transfer_id": "<string>",
  "from_step_id": "<string>",
  "to_step_id": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "ended_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "route_leg_ids": "<array>",
  "cost_total_minor": 123,
  "from_step": {
    "id": "<string>",
    "transfer_id": "<string>",
    "position": 123,
    "location_group_id": "<string>",
    "status": "<string>",
    "operations_executed_at": "2023-11-07T05:31:56Z",
    "approved_by_company_id": "<string>",
    "approved_by_user_id": "<string>",
    "approved_at": "2023-11-07T05:31:56Z",
    "completed_by_company_id": "<string>",
    "completed_by_user_id": "<string>",
    "completed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "location_group": {
      "id": "<string>",
      "name": "<string>"
    },
    "receipts": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_line_id": "<string>",
        "asset_id": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ],
    "dispatches": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_segment_id": "<string>",
        "transfer_line_id": "<string>",
        "position": 123,
        "asset_id": "<string>",
        "group_id": "<string>",
        "vendor_name": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ]
  },
  "to_step": {
    "id": "<string>",
    "transfer_id": "<string>",
    "position": 123,
    "location_group_id": "<string>",
    "status": "<string>",
    "operations_executed_at": "2023-11-07T05:31:56Z",
    "approved_by_company_id": "<string>",
    "approved_by_user_id": "<string>",
    "approved_at": "2023-11-07T05:31:56Z",
    "completed_by_company_id": "<string>",
    "completed_by_user_id": "<string>",
    "completed_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "location_group": {
      "id": "<string>",
      "name": "<string>"
    },
    "receipts": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_line_id": "<string>",
        "asset_id": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ],
    "dispatches": [
      {
        "id": "<string>",
        "transfer_step_id": "<string>",
        "transfer_segment_id": "<string>",
        "transfer_line_id": "<string>",
        "position": 123,
        "asset_id": "<string>",
        "group_id": "<string>",
        "vendor_name": "<string>",
        "quantity": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "asset_name": "<string>"
      }
    ]
  },
  "costs": [
    {
      "id": "<string>",
      "transfer_segment_id": "<string>",
      "transfer_route_leg_cost_id": "<string>",
      "company_id": "<string>",
      "creator_user_id": "<string>",
      "label": "<string>",
      "amount": 123,
      "amount_minor": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "lines": [
    {
      "id": "<string>",
      "transfer_id": "<string>",
      "transfer_segment_id": "<string>",
      "stockable_id": "<string>",
      "stockable_unit_id": "<string>",
      "base_quantity": 123,
      "remaining_quantity": 123,
      "in_transit_quantity": 123,
      "created_by_company_id": "<string>",
      "creator_user_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "resolutions": [
        {
          "id": "<string>",
          "transfer_id": "<string>",
          "transfer_line_id": "<string>",
          "transfer_step_id": "<string>",
          "type": "<string>",
          "quantity": 123,
          "reason": "<string>",
          "company_id": "<string>",
          "creator_user_id": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ],
      "dispatches": [
        {
          "id": "<string>",
          "transfer_step_id": "<string>",
          "transfer_segment_id": "<string>",
          "transfer_line_id": "<string>",
          "position": 123,
          "asset_id": "<string>",
          "group_id": "<string>",
          "vendor_name": "<string>",
          "quantity": 123,
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "asset_name": "<string>"
        }
      ],
      "stockable": {
        "id": "<string>",
        "title": "<string>"
      },
      "stockable_unit": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ]
}

{
  "message": "<string>",
  "errors": {}
}

Company space For: Stock keeper · Permission: transfer_segments.update Conditions

Only the company that owns the transfer can do this.
The transfer must be in draft or running status.
The segment must belong to the transfer and neither of its steps may be current, done or skipped.
Both endpoints are required, each by step id or position; the destination must come after the source and, when the transfer is running, the new steps cannot be current, done or skipped.
The route legs between the endpoints must form a complete continuous path.
A transfer cannot hold two segments with the same source and destination steps.
cost, costs, started_at and ended_at are refused.

What else happens

Changes the endpoints and re-attaches the route legs of the segment.
When the source step changes, the planned dispatches of the segment are deleted.

Part of Load goods and handle losses in transit.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

transfer

string

required

Identifier of the transfer.

segment

string

required

Identifier of the transfer segment (27-character KSUID).

Body

application/json

from_step_id

string | null

Identifier of the step the segment leaves from (27-character KSUID). Required unless from_step_position is sent.

Required string length: 27

from_step_position

integer | null

Position (starting at 1) of the step the segment leaves from, as an alternative to from_step_id. Required unless from_step_id is sent.

Required range: x >= 1

to_step_id

string | null

Identifier of the step the segment arrives at (27-character KSUID). Required unless to_step_position is sent; it must come after the source step.

Required string length: 27

to_step_position

integer | null

Position (starting at 1) of the destination step, as an alternative to to_step_id. Required unless to_step_id is sent.

Required range: x >= 1

cost

string

Not accepted: segment costs come from the route-leg costs of the transfer, not from the segment.

costs

string

Not accepted: segment costs come from the route-leg costs of the transfer, not from the segment.

started_at

string

Not accepted: the start time is set by the server.

ended_at

string

Not accepted: the end time is set by the server.

Response

TransferSegmentResource

string

required

Identifier of the segment.

transfer_id

string

required

Identifier of the transfer.

from_step_id

string

required

Step the goods leave.

to_step_id

string

required

Step the goods go to; later in the route than the source.

started_at

string<date-time> | null

required

When goods were first withdrawn for this segment, ISO 8601; null before.

ended_at

string<date-time> | null

required

When goods were first received at the destination, ISO 8601; null before.

created_at

string<date-time>

required

Date and time the record was created (ISO 8601, UTC).

updated_at

string<date-time>

required

Date and time the record was last changed (ISO 8601, UTC).

route_leg_ids

array

Identifiers of the route legs the segment travels over.

cost_total_minor

integer

Total of the segment's costs in minor units. Present only for the owner company.

from_step

TransferStepResource · object

Source step, when included.

Show child attributes

to_step

TransferStepResource · object

Destination step, when included.

Show child attributes

costs

TransferSegmentCostResource · object[]

Costs allocated to the segment; shown to the owner company only.

Show child attributes

lines

TransferLineResource · object[]

Lines of goods carried by the segment.

Show child attributes

Platform access and team

Set up your organization and companies

Products, prices and taxes

Stock and logistics

Buy from suppliers

Sell at the counter and on order

Customers, credit and promotions

Keep the books day to day

Follow payments to the bank

Close periods and the fiscal year

Reports, statements and tax filings

Analyze costs and results by activity

Change a transfer segment

Authorizations

Path Parameters

Body

Response