/api/v1/shop/complaint/create

Organisation-defined complaint variant code.

Each organisation configures its own set of complaint types (e.g. reklamace, vraceni, vymena). The variant must exist and be active in the organisation settings before it can be used.

Hash of the order this complaint is related to. The order must belong to the same organisation. If provided, the system automatically links the complaint to the order.

Human-readable order number for reference.

Use this field when the order is external or when you want to store the order number without linking to an internal order. If orderHash is provided, this field is optional and will be used as a display label only.

Customer-provided description and reason for the complaint.

Include as much detail as possible — product condition, circumstances, and what the customer expects. This text is visible to staff and can be shared with the customer.

Full name of the customer filing the complaint.

Customer e-mail address for complaint communication.

Used for sending status updates and resolution notifications to the customer.

Customer phone number in international format.

Preferred format: +<country_code> <local_number>
Example: +420 777123456

Total claimed amount in the specified currency.

The claimed amount represents the value the customer is requesting as refund, credit, or compensation. Use decimal precision up to two places.

ISO 4217 currency code for the claimed amount. Defaults to organisation currency if omitted.

ISO 3166-1 alpha-2 country code for the refund bank account.

Bank account number for refund transfer.

Use the local bank account format (e.g. 123456789/0100 for CZ) or IBAN.

Variable symbol for the refund bank transfer. Typically the original order number.

Branch ID where the product should be sent for inspection or return.

Preferred resolution method code defined by the organisation.

Common values: repair (fix the product), exchange (replace with new), refund (return money), credit (issue store credit). The method must exist in the organisation settings.

Deadline for complaint resolution. If omitted, the organisation default applies.

List of items being complained about.

Each item can optionally reference an original order item by ID. If the complaint covers the entire order, you can omit this field and set the total claimed amount in the price field instead.