가이드

계량 기록

계량 기록은 1차 계량(총중량)과 2차 계량(공차)으로 구성되며, 순중량은 총중량에서 공차를 뺀 값입니다.

도메인 흐름

화물 차량은 계량소에서 1차 계량(총중량, grossKg)을 마친 뒤 적재·하역하고, 2차 계량(공차, tareKg)을 진행합니다. 순중량(netKg)은 두 값의 차이로 산출됩니다.

각 계량값은 measurements 배열에 개별 측정으로 기록되며, 기록 자체는 status로 진행 상태를 나타냅니다. 전체 필드는 API 레퍼런스를 참고하세요.

목록 조회

read:weighing 스코프로 계량 기록을 조회합니다. 날짜(from·to), 상태(status), 차량번호(vehiclePlate), 품목(cargo)으로 필터링하고 page·limit으로 페이지네이션합니다.

목록 조회

curl -X GET 'https://api.weighter.shop/agent/v1/weighing-records?status=completed&limit=10' \
  -H 'Authorization: Bearer wtr_ak_xxxxxxxxxxxxxxxxxxxxxxxx'

기록 생성

write:weighing 스코프로 새 계량 기록을 생성합니다. 계량소는 키에 바인딩되어 있으므로 본문에 포함하지 않으며, 모든 필드는 선택입니다.

기록 생성

curl -X POST 'https://api.weighter.shop/agent/v1/weighing-records' \
  -H 'Authorization: Bearer wtr_ak_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "vehiclePlate": "12가3456",
    "vehicleType": "8.5톤",
    "cargoName": "고철",
    "partnerName": "대한금속"
  }'

생성·조회 응답의 전체 스키마와 상태 값은 API 레퍼런스에서 확인하세요.