BizKitHub
DocsAPI ReferenceComplaint/bff/complaint/create
postComplaintAdmin BFF

/bff/complaint/create

Creates a new complaint case. Optionally links to an existing order and its items. An initial event is automatically created in the complaint timeline.

ComplaintpostBffComplaintCreate

Parameters

17 body

17 total
Body · 17
variantCodestringRequired

Organisation-defined complaint variant code.

orderIdnumber

Internal order ID to link the complaint to an existing order.

orderNumberstring

Human-readable order number. Use when order is external or unavailable by ID.

descriptionstringRequired

Customer-provided description and reason for the complaint.

customerNamestringRequired

Full name of the customer filing the complaint.

emailstring

Customer e-mail for complaint communication.

phonestring

Customer phone number.

pricenumber

Total claimed amount in the order-defined currency.

currencyIdnumber

Currency ID for the claimed amount.

refundCountrystring

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

refundBankAccountstring

Bank account number for refund transfer.

refundVariableSymbolstring

Variable symbol for refund bank transfer.

branchIdnumber

Branch ID where the product should be sent for inspection.

serviceIdnumber

External service provider ID handling the complaint.

resolutionMethodCodestring

Preferred resolution method code defined by organisation.

dueDatestring

Deadline for complaint resolution.

Format: date-time
itemsobject[]5 fields

List of complained items from the original order.

Request

POST /bff/complaint/create

post
curl -X POST "https://api.bizkithub.com/bff/complaint/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "variantCode": "reklamace",
  "orderId": 1024,
  "orderNumber": "25000087",
  "description": "Product arrived damaged, visible scratch on the surface.",
  "customerName": "Jan Novák",
  "email": "jan@example.com",
  "phone": "+420 777 123 456",
  "price": 1500,
  "currencyId": 1,
  "refundCountry": "CZ",
  "refundBankAccount": "123456789/0100",
  "refundVariableSymbol": "25000087",
  "branchId": 1,
  "serviceId": 1,
  "resolutionMethodCode": "repair",
  "dueDate": "2026-02-15T00:00:00.000Z",
  "items": [
    {
      "orderItemId": 501,
      "label": "Cheese burger",
      "quantity": 1,
      "price": 250,
      "currencyId": 1
    }
  ]
}'

Response

JSON payload

{
  "success": true,
  "id": "a1b2c3d4"
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key