Skip to main content

Transfer Group

The Transfer Group API allows the user to create, view, and update transfer groups.

Security

jwt-bearer-token

apiKey

API Key

Name

Authorization

In

header

Endpoints

GET /transfer-group/schema

Summary

Get the transfer group schema.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

Responses

Code

Description

Schema

200

Success

transfer_group_get_response_1

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

POST /transfer-group

Summary

Create the transfer group.

Request Parameters

In

Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

body

body

transfer_group_post_body_2

Yes

The JSON formatted request

Responses

Code

Description

Schema

201

Success

transfer_group_post_response_2

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

GET /transfer-group

Summary

Get the transfer group list.

Request Parameters

In

Field Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

query

$filter

string

No

A filter expression in OData v4 format

query

$top

integer

No

The maximum documents to return. For example, if top is 100, and skip is 0, the system returns documents 1 to 100.

query

$skip

integer

No

The documents to skip before returning. For example, if top is 100, and skip is 100, the system returns documents 101 to 200.

query

$select

string

No

query

$orderby

string

No

An order by expression in OData v4 format

query

include_cost_fields

boolean

No

If true, gets cost fields

Responses

Code

Description

Schema

200

Success

transfer_group_get_response_3

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

PATCH /transfer-group/{id}

Summary

Update the transfer group.

Request Parameters

In

Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

path

id

string

Yes

The transfer group's document ID from the database

body

body

transfer_group_patch_body_4

Yes

The JSON formatted request

Responses

Code

Description

Schema

204

No content

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

GET /transfer-group/{id}

Summary

Get the transfer group detail.

Request Parameters

In

Name

Type

Required

Description

header

X-COMPANY-ID

string

Yes

The identifier (ID) of the company that owns the document

path

id

string

Yes

The transfer group's document ID from the database

query

get_updated_items

boolean

No

Get updated items

query

include_transfer

boolean

No

Get transfer items

query

transfer_fields_select

string

No

Get transfer items

Responses

Code

Description

Schema

200

Success

transfer_group_get_response_5

400

Bad request, for more information look at body error

401

Unauthorized error

403

Forbidden error

404

Not Found

422

Unprocessable error

500

Internal Server Error

Data Models

transfer_group_get_response_1

Field Name

Type

Description

transfer_group_get_response_1

object

The transfer group schema definition

transfer_group_post_body_2

Field Name

Type

Required

Description

event_id

string

No

site_id

string

No

The transfer group site identifier (ID)

transfer_group_type

string

No

The transfer group type

transfer_type

string

Yes

The transfer type.

Enum: preduringoutside

name

string

Yes

transaction_date

date/time

Yes

The transfer group date

transfer_group_post_response_2

Field Name

Type

Description

_id

string

id

string

transfer_type

string

The transfer type

transfer_group_type

string

The transfer group type

entity_id

string

name

string

The transfer group's name

event_id

string

site_id

string

The transfer from site identifier (ID)

site_name

string

The transfer from site name

store_number

string

The transfer from store number

transaction_date

date/time

company_id

string

The user's company ID

created_at

date/time

The date of creation

created_by

string

The created by user ID

updated_at

date/time

The updated date

updated_by

string

The updated by user ID

transfer_group_get_response_3

Field Name

Type

Description

items

transfer_group_get_response_3_items

total

number

page_count

number

current_page

number

page_size

number

transfer_group_get_response_3_items

Field Name

Type

Required

Description

_id

string

Yes

 

entity_id

string

Yes

The transfer group's entity identifier (ID)

name

string

Yes

The transfer group's name

site_id

string

Yes

The site's ID

site_name

string

Yes

The site's name

store_number

string

Yes

The site ID

transaction_date

date/time

Yes

The transfer group transaction date

transfer_group_type

string

No

The transfer group type

transfer_type

string

No

The transfer type

updated_at

date/time

Yes

The last update date

transfer_group_request_cost

number

No

The sum of all transfers' request_cost of the group

transfer_group_received_cost

number

No

The sum of all transfers' received_cost of the group

transfer_group_reversed_cost

number

No

The sum of all transfers' reversed_cost of the group

transfer_group_patch_body_4

Field Name

Type

Description

event_id

string

site_id

string

The transfer from site identifier (ID)

transfer_type

string

The transfer group's type.

Enum: preduringoutside

name

string

The transfer group's name

transaction_date

date/time

The transfer group date

transfer_group_get_response_5

Field Name

Type

Description

_id

string

 

transfer_type

string

The transfer type

transfer_group_type

string

The transfer group type

name

string

The transfer group's name

event_id

string

site_id

string

The transfer from site identifier (ID)

site_name

string

The transfer from site name

transaction_date

date/time

 

transfer_items

[transfer_group_get_response_5_transfer_items]

A list of transfer items

transfer_group_get_response_5_transfer_items

Field Name

Type

Description

transfer_group_get_response_5_transfer_items

object