Update a POS Category

Endpoint Overview

This API endpoint provides a detailed overview of the endpoint responsible for updating an existing POS category within the POS module of the Juleb ERP.

name is still required

This endpoint reuses the same request body as Create a POS Category, so name must still be included even when only updating other fields.

Endpoint Details

• Method: PATCH
• URL: /api/v1/pos/pos-category/{id}

Parameters

• Path Parameters:
  • id (string, required): The ID of the POS category to update.
• Query Parameters: None

Request Body

Same fields as Create a POS Category: name (required), parent_id, sequence.

{
  "name": string,
  "sequence": integer
}

Response

• 202 Accepted: Successfully updated the record.
• 400 Bad Request: Bad request.
• 401 Unauthorized: Unauthorized.
• 404 Not Found: Record with the provided ID not found.

Response Body

{
  "data": {
    ...record fields
  }
}

Example

Request

NodeJS

const axios = require('axios');
const accountName = process.env.ACCOUNT_NAME;
const apiKey = process.env.API_KEY;

axios.patch(`https://${accountName}.juleb.com/api/v1/pos/pos-category/8`, {
  name: 'Pain Relief',
  sequence: 20
}, {
  headers: {
    accept: '*/*',
    Authorization: `TOKEN`,
    'Content-Type': 'application/json'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error('Error:', error);
});

curl

curl -X PATCH \
-H "accept: */*" \
-H "Authorization: ******" \
-H "Content-Type: application/json" \
-d '{
  "name": "Pain Relief",
  "sequence": 20
}' \
"https://$ACCOUNT_NAME.juleb.com/api/v1/pos/pos-category/8"

python

import os
import requests

account_name = os.getenv('ACCOUNT_NAME')
api_key = os.getenv('API_KEY')

url = f'https://{account_name}.juleb.com/api/v1/pos/pos-category/8'
headers = {
    'accept': '*/*',
    'Authorization': f'******',
    'Content-Type': 'application/json'
}
data = {
    'name': 'Pain Relief',
    'sequence': 20
}

response = requests.patch(url, headers=headers, json=data)
if response.status_code == 202:
    print(response.json())
else:
    print(f'Error: {response.status_code}', response.text)

java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;

public class Main {
    public static void main(String[] args) throws Exception {
        String accountName = System.getenv("ACCOUNT_NAME");
        String apiKey = System.getenv("API_KEY");

        String json = "{"
            + "\"name\": \"Pain Relief\","
            + "\"sequence\": 20"
            + "}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(new URI("https://" + accountName + ".juleb.com/api/v1/pos/pos-category/8"))
            .header("accept", "*/*")
            .header("Authorization", "Bearer " + apiKey)
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
        if (response.statusCode() == 202) {
            System.out.println(response.body());
        } else {
            System.out.println("Error: " + response.statusCode() + ", " + response.body());
        }
    }
}

Response

{
  "data": {
    "id": 8,
    "name": "Pain Relief",
    "sequence": 20
  }
}