Skip to main content
PUT
/
warehouse-inbound-receipts
/
{warehouseInboundReceipt}
Update warehouse inbound receipt
curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/warehouse-inbound-receipts/{warehouseInboundReceipt} \
  --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.

Path Parameters

​
warehouseInboundReceipt
integer
required

Warehouse inbound receipt ID.

Example:

901

Body

application/json

Payload used to update a warehouse inbound receipt. The Fintoro API uses a full PUT contract, so the same business fields are required as on create.

​
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
​
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.

​
note
string | null

Optional internal note on the inbound receipt.

Maximum string length: 3000
Example:

"Receipt from external purchase"

Response

Warehouse inbound receipt updated.

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

​
id
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.

​
warehouse
object

Warehouse into which the receipt adds stock.

​
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.

​
currency
object

Inbound receipt currency.

​
language
object

Inbound receipt language.

​
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.