Create warehouse inbound receipt

curl --request POST \ --url https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "number": "INB-2026-0001", "warehouseId": 301, "languageId": 1, "issueDate": "2026-03-11", "items": [ { "priceListItemId": 701, "quantity": 3, "unitPrice": 15, "vatRate": 20 } ], "supplierId": 401, "supplier": { "name": "Supply s.r.o.", "type": "company", "subjectId": "12345678", "taxId": "2020123456", "vatId": "SK2020123456", "isVatPayer": true, "email": "billing@supply.test", "street": "Supplier Street 1", "city": "Bratislava", "zip": "81101", "countryId": 703 }, "note": "Receipt from external purchase" } '

{ "id": 901, "uuid": "5d6f8b1d-44c2-4ef6-a2c9-2d4d1c1a6e10", "number": "INB-2026-0001", "webDokladUrl": "https://app.fintoro.sk/web-doklad/company/warehouse-inbound-receipt/uuid", "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/901/pdf", "company": { "name": "Fintoro s.r.o.", "subjectId": "12345678", "legalForm": "Limited liability company", "taxId": "2020123456", "vatId": "SK2020123456", "vatPayerTypeId": 4, "country": "Slovakia", "city": "Bratislava", "street": "Main Street 1", "zip": "81101", "logo": "https://cdn.fintoro.sk/company/logo.svg", "signature": "https://cdn.fintoro.sk/company/signature.png", "registrationCourt": "City Court Bratislava III", "registrationNumber": "12345/B", "email": "support@fintoro.sk", "phone": "+421900000000", "web": "https://fintoro.sk" }, "warehouse": { "id": 301, "name": "Main warehouse", "code": "MAIN-WH", "inboundNumericalSeriesPattern": "INB-(YY)-(CCCC)", "inboundNumericalSeriesNextNumber": 12, "outboundNumericalSeriesPattern": "OUT-(YY)-(CCCC)", "outboundNumericalSeriesNextNumber": 8 }, "supplierId": 401, "supplier": { "name": "Supply s.r.o.", "type": "company", "subjectId": "12345678", "taxId": "2020123456", "vatId": "SK2020123456", "isVatPayer": true, "email": "billing@supply.test", "street": "Supplier Street 1", "city": "Bratislava", "zip": "81101", "countryId": 703, "country": { "id": 703, "name": "Slovakia", "code": "SK", "eu": true } }, "currency": { "id": 1, "symbol": "EUR", "name": "Euro", "mark": "€" }, "language": { "id": 1, "name": "Slovak", "code": "sk" }, "issueDate": "2026-03-11", "note": "Receipt from external purchase", "hasVat": true, "total": 45, "totalWithVat": 54, "items": [ { "id": 7001, "priceListItemId": 701, "priceListItemName": "Installation kit", "priceListItemWarehouseCode": "SKU-001", "unitName": "pcs", "quantity": 3, "unitPrice": 15, "unitPriceWithVat": 18, "vatRate": 20 } ] }

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

"invoice-create-2026-03-03-001"

Body

application/json

Payload used to create a warehouse inbound receipt.

number

string

required

Warehouse inbound receipt number. If you want to use the next automatic warehouse number, send it explicitly according to the current warehouse numbering series.

Required string length: 1 - 20

Example:

"INB-2026-0001"

warehouseId

integer

required

ID of a warehouse.

Example:

301

languageId

integer

required

Language ID from the language lookup endpoint.

Example:

1

issueDate

string<date>

required

Inbound receipt issue date.

Example:

"2026-03-11"

items

object[]

required

Inbound receipt items. Every line item must target a warehouse-enabled price list item.

Minimum array length: 1

Show child attributes

supplierId

integer | null

Optional ID of an existing supplier. If you send supplierId, the supplier object is only used as a snapshot override for this specific receipt.

Example:

401

supplier

object

Sparse supplier payload. If you send supplierId, it acts as a snapshot override for this receipt. If you omit supplierId, the backend resolves or creates the supplier from this payload.

Show child attributes

note

string | null

Optional internal note on the inbound receipt.

Maximum string length: 3000

Example:

"Receipt from external purchase"

Response

Warehouse inbound receipt created.

Warehouse inbound receipt including warehouse, supplier snapshot, and items.

integer

Internal warehouse inbound receipt ID.

Example:

901

uuid

string

Public warehouse inbound receipt UUID also used in the webDoklad URL.

Example:

"5d6f8b1d-44c2-4ef6-a2c9-2d4d1c1a6e10"

number

string

Warehouse inbound receipt number.

Example:

"INB-2026-0001"

webDokladUrl

string

Public web document URL for this inbound receipt.

Example:

"https://app.fintoro.sk/web-doklad/company/warehouse-inbound-receipt/uuid"

pdfDownloadUrl

string

Direct URL for downloading the PDF export of this inbound receipt.

Example:

"https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/901/pdf"

company

object

Historical supplier snapshot stored on the document.

Show child attributes

warehouse

object

Warehouse into which the receipt adds stock.

Show child attributes

supplierId

integer | null

Live supplier ID when the receipt is still linked to an existing supplier.

Example:

401

supplier

object

Historical supplier snapshot stored on the inbound receipt.

Show child attributes

currency

object

Inbound receipt currency.

Show child attributes

language

object

Inbound receipt language.

Show child attributes

issueDate

string<date>

Inbound receipt issue date.

Example:

"2026-03-11"

note

string | null

Optional internal note on the inbound receipt.

Example:

"Receipt from external purchase"

hasVat

boolean

Indicates whether the inbound receipt contains VAT.

Example:

true

total

number<float>

Total amount excluding VAT.

Example:

45

totalWithVat

number<float>

Total amount including VAT.

Example:

54

items

object[]

Line items of the warehouse inbound receipt.

Show child attributes

Overview

Endpoints

Create warehouse inbound receipt

Authorizations

Headers

Body

Response