Call a Weighbridge Ticket OCR API from Java

Why Weighbridge Tickets Need More Than Plain OCR

A scale ticket may place the same three measurements in different rows, reverse the order of the first and second weighing, abbreviate units, or mix ticket, vehicle, job, and material identifiers. A generic OCR engine returns text but leaves your application to decide which value is gross, tare, or net. That brittle parsing becomes harder across quarry, waste, grain, logistics, and recycling layouts.

A Structured Java Workflow

The StructOCR Weighbridge Ticket OCR API returns a stable schema for ticket, facility, vehicle, material, and weight data. It preserves each printed value, normalizes supported units to kilograms, and runs deterministic gross-minus-tare validation. Test a sample first with the free weighbridge ticket scanner, then use the same endpoint in Java.

Where Java Teams Use Weighbridge OCR

• Transport and Dispatch: Match ticket numbers and vehicle registrations to loads without retyping paper tickets.
• Quarry and Waste Operations: Capture material, customer, job, gross, tare, and net values for downstream reconciliation.
• Exception Review: Route missing weights, unit issues, or printed net mismatches to a human using machine-readable review reasons.

Implementation: Java HttpClient

The request uses POST /v1/weighbridge-ticket. Send one Base64-encoded JPG, PNG, WebP, or PDF in the img property and allow a 60-second client timeout. See the complete API reference for the full response and error contract.

Prerequisite: Java 17+ and Jackson Databind

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.net.URI;
import java.net.http.*;
import java.nio.file.Files;
import java.nio.file.Path;
import java.time.Duration;
import java.util.Base64;

ObjectMapper mapper = new ObjectMapper();
String image = Base64.getEncoder().encodeToString(
    Files.readAllBytes(Path.of("weighbridge-ticket.jpg"))
);
String body = mapper.writeValueAsString(java.util.Map.of("img", image));

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.structocr.com/v1/weighbridge-ticket"))
    .timeout(Duration.ofSeconds(60))
    .header("Content-Type", "application/json")
    .header("x-api-key", "YOUR_API_KEY")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) throw new RuntimeException(response.body());

JsonNode data = mapper.readTree(response.body()).path("data");
System.out.println("Ticket: " + data.path("ticket_number").asText());
System.out.println("Net kg: " + data.path("weights").path("net").path("normalized_kg"));
System.out.println("Needs review: " + data.path("validation").path("needs_review"));

Example Validated JSON Response

The API separates extracted fields from deterministic validation so your application can store the record and make an explicit review decision.

{
  "success": true,
  "data": {
    "is_weighbridge_ticket": true,
    "document_type": "generic_weighbridge_ticket",
    "ticket_number": "1042",
    "facility": {
      "name": "North Yard Scale",
      "address": null,
      "scale_id": "SCALE-2"
    },
    "vehicle": {
      "registration": "AB12 CDE",
      "trailer_registration": null,
      "fleet_number": null,
      "driver_name": null
    },
    "material": {
      "description": "Recycled aggregate",
      "code": "RA20"
    },
    "weights": {
      "gross": {
        "value": 25330,
        "unit": "kg",
        "raw": "25,330 kg",
        "normalized_kg": 25330
      },
      "tare": {
        "value": 6770,
        "unit": "kg",
        "raw": "6,770 kg",
        "normalized_kg": 6770
      },
      "net": {
        "value": 18560,
        "unit": "kg",
        "raw": "18,560 kg",
        "normalized_kg": 18560
      }
    },
    "confidence": "high",
    "is_valid": true,
    "validation_error": null,
    "validation": {
      "calculated_net_kg": 18560,
      "difference_kg": 0,
      "weight_check_passed": true,
      "needs_review": false,
      "review_reasons": []
    }
  }
}