---
title: "Zmień status zwrotu"
method: PUT
path: "/returns_status/{id}"
tags: ["Zwroty"]
---

# Zmień status zwrotu

`PUT /returns_status/{id}`

## Request

- Base URL: `https://demo.sellasist.pl/api/v1`
- URL: `https://demo.sellasist.pl/api/v1/returns_status/{id}`
- Auth: API key in header `apiKey`

Zmienia status zwrotu tak jak w panelu, razem z wiadomościami do klienta i akcjami automatycznymi przypisanymi do statusu. Ponowne wysłanie tego samego statusu niczego nie zmienia.

## Path parameters

- `id` integer, required

## Request body

- object
  - `status_id` integer, required: ID statusu zwrotu (pełną listę pobierzesz z GET /returns_statuses). Statusy, które wystawiają korektę, zlecają zwrot środków albo odrzucają zwrot, można ustawić tylko w panelu.

## Response `200`

Pomyślnie zmieniono status zwrotu.

- object
  - `id` integer, required: ID zwrotu
  - `return_number` string: Numer zwrotu
  - `status_id` integer: ID aktualnego statusu zwrotu
  - `status` string: Nazwa aktualnego statusu zwrotu
  - `last_change_status_date` string, nullable: Data ostatniej zmiany statusu (format Y-m-d H:i:s)
  - `warnings` object[]: Pojawia się tylko wtedy, gdy status został zmieniony, ale nie wszystkie akcje statusu się wykonały.
    - `code` 'status_actions_incomplete': Kod ostrzeżenia
    - `message` string: Opis ostrzeżenia

## Other responses

- `401`: Błąd autoryzacji
- `403`: Konto API nie ma dostępu do tego endpointu.
- `404`: Nie znaleziono zwrotu o podanym ID.
- `409`: Status zwrotu jest właśnie zmieniany. Spróbuj ponownie za chwilę.
- `422`: Nie można ustawić podanego statusu zwrotu.
- `429`: Przekroczono limit zapytań.
- `500`: Wewnętrzny błąd serwera. Zwraca unikalny identyfikator incydentu (error_id) do przekazania do działu wsparcia technicznego.

## Changes

- **2026-10-13** `bcd78d4d0fc2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sellasist/apis/sellasist-api/changes/returns_status/:id/put.md)

---

[API](https://skmtc.dev/sellasist/apis/sellasist-api.md) - [All operations](https://skmtc.dev/sellasist/apis/sellasist-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellasist/apis/sellasist-api/revisions/58415a41c446?raw)