univoozAPI
Errors

branch_required

You did not send branch, and you have more than one active branch.

HTTP 422invalid_request_error

branch is optional only when there is one possible answer.

Why it happens

You did not send branch, and the number of active branches is not one.

Univooz counts active branches only. Closed branches do not count.

The usual cause is growth. The integration works with one shop. The second shop opens, and every order stops.

How to fix it

Send branch. Use one of two forms:

  • your branch reference — Univooz compares it exactly, and it is case-sensitive
  • the branch id — a UUID

Univooz reads a UUID as an id, and all other values as a reference.

{ "branch": "noerrebro" }

Get the values from List branches.

Send branch always, also when you have one branch. It costs nothing, and it works when the second branch opens.

Example response

{
  "error": {
    "type": "invalid_request_error",
    "code": "branch_required",
    "message": "This organization has 3 branches; 'branch' is required.",
    "param": "branch",
    "doc_url": "https://docs.univooz.com/errors/branch_required",
    "request_id": "req_01KZCCF8ZH4M7XQ2VB9RSTNPKD"
  }
}

On this page