Skip to main content
POST
/
warehouses
Create warehouse
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/warehouses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Main warehouse",
  "code": "MAIN-WH",
  "inboundNumericalSeriesPattern": "INB-(YY)-(CCCC)",
  "inboundNumericalSeriesNextNumber": 1,
  "outboundNumericalSeriesPattern": "OUT-(YY)-(CCCC)",
  "outboundNumericalSeriesNextNumber": 1
}
'
{
  "id": 301,
  "name": "Main warehouse",
  "code": "MAIN-WH",
  "inboundNumericalSeriesPattern": "INB-(YY)-(CCCC)",
  "inboundNumericalSeriesNextNumber": 12,
  "outboundNumericalSeriesPattern": "OUT-(YY)-(CCCC)",
  "outboundNumericalSeriesNextNumber": 8
}

Authorizations

​
Authorization
string
header
required

Bearer token created for a specific company in Integrations → API.

Body

application/json

Payload used to create a warehouse. All business fields are required.

​
name
string
required

Warehouse name.

Maximum string length: 255
Example:

"Main warehouse"

​
code
string
required

Internal warehouse code unique within the token scope.

Maximum string length: 255
Example:

"MAIN-WH"

​
inboundNumericalSeriesPattern
string
required

Numbering-series pattern for warehouse inbound receipts. It must contain a counter token.

Maximum string length: 255
Example:

"INB-(YY)-(CCCC)"

​
inboundNumericalSeriesNextNumber
integer
required

Next sequence number for the inbound series. Minimum value is 1.

Required range: x >= 1
Example:

1

​
outboundNumericalSeriesPattern
string
required

Numbering-series pattern for warehouse outbound receipts. It must contain a counter token.

Maximum string length: 255
Example:

"OUT-(YY)-(CCCC)"

​
outboundNumericalSeriesNextNumber
integer
required

Next sequence number for the outbound series. Minimum value is 1.

Required range: x >= 1
Example:

1

Response

Warehouse created.

Warehouse, including inbound and outbound numbering-series configuration.

​
id
integer

Internal warehouse ID in Fintoro.

Example:

301

​
name
string

Warehouse name displayed in Fintoro.

Example:

"Main warehouse"

​
code
string

Internal warehouse code unique within the token scope.

Example:

"MAIN-WH"

​
inboundNumericalSeriesPattern
string

Numbering-series pattern used for warehouse inbound receipts of this warehouse.

Example:

"INB-(YY)-(CCCC)"

​
inboundNumericalSeriesNextNumber
integer

Next sequence number that will be used when automatically generating a warehouse inbound receipt.

Example:

12

​
outboundNumericalSeriesPattern
string

Numbering-series pattern used for warehouse outbound receipts of this warehouse.

Example:

"OUT-(YY)-(CCCC)"

​
outboundNumericalSeriesNextNumber
integer

Next sequence number that will be used when automatically generating a warehouse outbound receipt.

Example:

8