Skip to content
BILLZ for developers

Update of an unsent order

PUT
/v2/supplier-order/update/{id}
curl --request PUT \
  --url 'https://api-admin.billz.ai/v2/supplier-order/update/example?Billz-Response-Channel=HTTP' \
  --header 'Authorization: Bearer <token>' \
  --header 'Billz-Response-Channel: HTTP' \
  --header 'Content-Type: application/json' \
  --header 'platform-id: 7d4a4c38-dd84-4902-b744-0488b80a4c01' \
  --data '{ "accepting_date": "2024-12-17", "settlement_type": "commission", "shop_id": "70919136-9481-4c7e-8581-685d750d67a9", "supplier_id": "5f4c5af2-3320-4fa4-aed9-65a35e1dab8f", "name": "новый заказ 2" }'

Asynchronous method. To receive the result synchronously over HTTP, pass the Billz-Response-Channel: HTTP header — otherwise the response will be 200 {"message": "<correlation_id>"}. Maximum wait is 600 seconds, after which 408 with error.code = TIMEOUT is returned.

Error codes: 400 — input validation error; 404 — object not found; 408 — timed out waiting for the asynchronous result; 401, 403, 429, 500 — shared by all methods. Body formats and semantics: Response codes and errors.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Taken from the path; the value from the body is ignored

Header Parameters

Section titled “Header Parameters”
platform-id
string
default: 7d4a4c38-dd84-4902-b744-0488b80a4c01

Platform identifier. A static value is used for integrations.

Billz-Response-Channel
string
Allowed values: HTTP

HTTP — wait for the event processing result and return it in the HTTP response. Without the header the method returns only the correlation_id of the published event.

Query Parameters

Section titled “Query Parameters”
Billz-Response-Channel
string
Allowed values: HTTP

Same as the Billz-Response-Channel header — for clients that cannot send a custom header. If both are passed, the header applies.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
string
shop_id
string
supplier_id
string
accepting_date
string
payment_date
string
settlement_type

Type of settlement with the supplier: commission — commission, consegnation — consignment (the value is spelled exactly this way), realization — realization. Informational field: the debt to the supplier accrues for the full order amount when the order is sent, regardless of the type. An empty value keeps the current type.

string
Allowed values: commission consegnation realization ""
comment
string
invoice_number
integer format: int64
company_id
string
Example
{
  "accepting_date": "2024-12-17",
  "settlement_type": "commission",
  "shop_id": "70919136-9481-4c7e-8581-685d750d67a9",
  "supplier_id": "5f4c5af2-3320-4fa4-aed9-65a35e1dab8f",
  "name": "новый заказ 2"
}

Responses

Section titled “Responses”

200

Section titled “200”

Success. With the Billz-Response-Channel: HTTP header — the asynchronous response envelope, without it — {"message": "<correlation_id>"}.

Media typeapplication/json
One of:

Asynchronous response envelope. Returned when the Billz-Response-Channel: HTTP header is passed. The final HTTP code of the request is taken from the status_code field.

object
session_id

Customer session identifier

string format: uuid
status_code

Event processing status (also the final HTTP response code)

integer
error
object
code

Error code, empty string if there is no error

string
message

Error text, empty string if there is no error

string
correlation_id

Request identifier, matches the ID of the published event

string format: uuid
topic

Response event type, for example <event_type>.success

string
data

Operation result, if the method returns one

object
Example
{
  "data": {
    "settlement_type": "commission"
  }
}