Skip to content
StraventaDocs

Create a tax category

Story 4 AC-4.10.6. Body `{ code, name, rate_bp, inclusive }`. `code` is upper-cased server-side and is immutable post-create (admins should soft-delete and recreate to rename). `rate_bp` ∈ [0, 10000] (basis points: 1100 = 11%). Returns 409 `tax_category_exists` on duplicate `(tenant_id, code)`. Gated by `pos.catalog.write`.

POST
/api/pos/v1/catalog/tax-categories

Story 4 AC-4.10.6. Body { code, name, rate_bp, inclusive }. code is upper-cased server-side and is immutable post-create (admins should soft-delete and recreate to rename). rate_bp ∈ [0, 10000] (basis points: 1100 = 11%). Returns 409 tax_category_exists on duplicate (tenant_id, code). Gated by pos.catalog.write.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/pos/v1/catalog/tax-categories" \  -H "Content-Type: application/json" \  -d '{    "code": "STANDARD",    "name": "PPN 11%",    "rate_bp": 1100,    "inclusive": true  }'
{
  "id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6e401",
  "code": "STANDARD",
  "name": "PPN 11%",
  "rate_bp": 1100,
  "inclusive": true,
  "tax_kind": "ppn",
  "dpp_basis": "post_discount"
}
Empty
Empty
Empty
Empty

Was this page helpful?