Skip to content
StraventaDocs
Now in Sandbox.

Create a tax category

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

application/json

application/json

curl -X POST "https://sandbox.505pay.link/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
{
  "error": "body_too_large",
  "message": "request body exceeds the 1048576-byte limit",
  "request_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6ffff"
}
{
  "error": "rate_limit_exceeded",
  "message": "Too many requests to /v1/check",
  "request_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6ffff"
}

Was this page helpful?