curl --request POST \
  --url https://staging-api.tyms.io/v1/adam/production/orders/{uuid}/void \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

{
  "status": "success",
  "message": "This record has been voided.",
  "data": {
    "uuid": "cc0e8400-e29b-41d4-a716-446655440008",
    "void_date": "2026-11-03",
    "void_journal_no": 1042
  }
}

Inventory

Void production order

Void a posted production order. When the order moved stock, the void date must be today.

Void a record that is already on the books. Tyms keeps the record and posts the reverse of its ledger lines. Send an empty body to void it today.

date cannot be in the future, inside a closed period, or before the record and any activity already posted. reason is optional and is stored up to 500 characters. It is required when the record was approved and the void must be approved again. In that case the record stays as it is until someone approves the void, and the response includes void_pending: true.

A record that is not on the books yet can be deleted instead. A record that is already voided cannot be voided again. Opening balances cannot be voided.

POST

/

production

/

orders

/

{uuid}

/

void

curl --request POST \
  --url https://staging-api.tyms.io/v1/adam/production/orders/{uuid}/void \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

{
  "status": "success",
  "message": "This record has been voided.",
  "data": {
    "uuid": "cc0e8400-e29b-41d4-a716-446655440008",
    "void_date": "2026-11-03",
    "void_journal_no": 1042
  }
}

Authorizations

X-API-Key

string

header

default:your_tyms_sk_or_partner_key

required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Path Parameters

uuid

string

required

Record id.

Body

application/json

Optional. An empty body voids the record today.

date

string<date>

Void date. Defaults to today in the business timezone. It cannot be in the future, on or before a closed period, or before the record date and any activity already posted. Stock records can only be voided today.

reason

string

Note stored on the void. Required when the record was approved and this void must be approved again.

Maximum string length: 500

Response

The record was voided, or the void was sent for approval.

status

string

required

Example:

"success"

message

string

required

data

any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

meta

object

Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.