Skip to main content
PUT
/
warehouse-outbound-receipts
/
{warehouseOutboundReceipt}
Update warehouse outbound receipt
curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/{warehouseOutboundReceipt} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "OUT-2026-0001",
  "warehouseId": 301,
  "languageId": 1,
  "issueDate": "2026-03-11",
  "items": [
    {
      "priceListItemId": 701,
      "quantity": 3,
      "unitPrice": 15,
      "vatRate": 20
    }
  ],
  "clientId": 101,
  "client": {
    "name": "Client s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@client.test",
    "street": "Client Street 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703
  },
  "note": "Manual stock issue"
}
'
{
  "id": 951,
  "uuid": "3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4",
  "number": "OUT-2026-0001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/company/warehouse-outbound-receipt/uuid",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/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
  },
  "clientId": 101,
  "client": {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Main Street 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "country": {
      "id": 703,
      "name": "Slovakia",
      "code": "SK",
      "eu": true
    },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Warehouse 9",
    "deliveryCity": "Kosice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": {
      "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": "Manual stock issue",
  "hasVat": true,
  "total": 30,
  "totalWithVat": 36,
  "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

​
warehouseOutboundReceipt
integer
required

Warehouse outbound receipt ID.

Example:

951

Body

application/json

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

​
number
string
required

Warehouse outbound 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:

"OUT-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

Outbound receipt issue date.

Example:

"2026-03-11"

​
items
object[]
required

Outbound receipt items. Every line item must target a warehouse-enabled price list item, and the backend validates available stock.

Minimum array length: 1
​
clientId
integer | null

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

Example:

101

​
client
object

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

​
note
string | null

Optional internal note on the outbound receipt.

Maximum string length: 3000
Example:

"Manual stock issue"

Response

Warehouse outbound receipt updated.

Warehouse outbound receipt including warehouse, client snapshot, and items.

​
id
integer

Internal warehouse outbound receipt ID.

Example:

951

​
uuid
string

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

Example:

"3f4c9fdd-6f9b-42c9-8c4b-a9d3a3435cf4"

​
number
string

Warehouse outbound receipt number.

Example:

"OUT-2026-0001"

​
webDokladUrl
string

Public web document URL for this outbound receipt.

Example:

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

​
pdfDownloadUrl
string

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

Example:

"https://app.fintoro.sk/api/public/v1/warehouse-outbound-receipts/951/pdf"

​
company
object

Historical supplier snapshot stored on the document.

​
warehouse
object

Warehouse from which the receipt deducts stock.

​
clientId
integer | null

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

Example:

101

​
client
object

Historical client snapshot stored on the outbound receipt.

​
currency
object

Outbound receipt currency.

​
language
object

Outbound receipt language.

​
issueDate
string<date>

Outbound receipt issue date.

Example:

"2026-03-11"

​
note
string | null

Optional internal note on the outbound receipt.

Example:

"Manual stock issue"

​
hasVat
boolean

Indicates whether the outbound receipt contains VAT.

Example:

true

​
total
number<float>

Total amount excluding VAT.

Example:

30

​
totalWithVat
number<float>

Total amount including VAT.

Example:

36

​
items
object[]

Line items of the warehouse outbound receipt.