거래명세서 데이터 조회 - JSON

주문번호(ord_no) 또는 주문품목번호(ord_prd_no)로 해당 주문/품목이 포함된 정산 건의 거래명세서 데이터를 JSON으로 조회합니다.

비권장: 이 API는 거래명세서 데이터를 JSON 구조로 반환합니다. 향후 응답 스키마가 변경될 경우 연동 파트너 측에서도 코드 수정이 필요합니다. 데이터를 프로그래밍적으로 가공해야 하는 특수한 경우에만 사용하고, 그 외에는 PDF API 사용을 권장합니다.

Endpoint


POST /vendor-api/settlements/transaction-statement/data

요청 파라미터

필드	타입	필수	설명
`ord_no`	string	택1	주문번호 — 권장. 미출하 품목만 포함
`ord_prd_no`	string	택1	주문품목번호 (형식: `{주문번호}_[{인덱스}]`) — 하위 호환
`settlement_type`	string	-	정산 유형 (기본값: `"standard"`)

요청 형식은 PDF API와 동일합니다. ord_no와 ord_prd_no의 동작 차이도 동일합니다.

요청 예시

주문번호로 조회 (권장)


curl -X POST "https://brightmall-backend.certi.life/vendor-api/settlements/transaction-statement/data" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: bm_xOpGAqgHbJQBXxBBbUIZ_bAGZk4wK2FdLgF50277PU8" \
  -H "X-Vendor-Id: 01KC51ST1WSTAET481SHPH3PSY" \
  -d '{"ord_no": "202601220157_000020196"}'

주문품목번호로 조회 (하위 호환)


curl -X POST "https://brightmall-backend.certi.life/vendor-api/settlements/transaction-statement/data" \
  -H "Content-Type: application/json" \
  -H "X-Vendor-Api-Key: bm_xOpGAqgHbJQBXxBBbUIZ_bAGZk4wK2FdLgF50277PU8" \
  -H "X-Vendor-Id: 01KC51ST1WSTAET481SHPH3PSY" \
  -d '{"ord_prd_no": "202601220157_000020196_[1]"}'

응답 예시


{
  "success": true,
  "request_id": "req_mkp3tsd_abc123",
  "timestamp": "2026-02-13T10:00:00.000Z",
  "settlement": {
    "settlement_id": "01SETTLEMENT_ID_EXAMPLE",
    "settlement_no": "SET-20260211-001",
    "status": "pending",
    "period_start": "2026-02-01",
    "period_end": "2026-02-11",
    "settlement_date": "2026-02-11"
  },
  "orders": [
    {
      "delivery_date": "2026-02-10",
      "proof_number": "SET-20260211-001-001",
      "receiver": {
        "biz_no": "123-45-67890",
        "name": "행복치과의원",
        "owner": "홍길동",
        "address": "서울특별시 강남구 테헤란로 123",
        "phone": "02-1234-5678",
        "biz_type": "의료업",
        "biz_kind": "치과의원"
      },
      "supplier": {
        "name": "세일글로벌",
        "biz_no": "987-65-43210",
        "owner": "김대표",
        "address": "서울특별시 서초구 서초대로 456",
        "biz_type": "도매업",
        "biz_kind": "의료기기",
        "phone": "02-9876-5432",
        "email": "sales@seilglobal.com"
      },
      "items": [
        {
          "no": 1,
          "insurance_code": "J1234567",
          "product_title": "델리킷 Impre Kicker / M사이즈",
          "specifications": "",
          "unit": "EA",
          "quantity": 2,
          "unit_price": 75000,
          "amount": 150000
        }
      ],
      "summary": {
        "subtotal": 150000,
        "supply_amount": 136364,
        "vat_amount": 13636,
        "total": 150000,
        "outstanding": ""
      },
      "footer": {
        "notes": "",
        "sales_office": "브라이트몰",
        "sales_rep_name": "담당자",
        "sales_rep_phone": ""
      }
    }
  ]
}

응답 필드 설명

settlement (정산 정보)

필드	타입	설명
`settlement_id`	string	정산 고유 ID
`settlement_no`	string	정산 번호 (형식: `SET-YYYYMMDD-NNN`)
`status`	string	정산 상태 (`pending`, `confirmed`, `paid`)
`period_start`	string	정산 기간 시작일 (YYYY-MM-DD)
`period_end`	string	정산 기간 종료일 (YYYY-MM-DD)
`settlement_date`	string	정산일 (YYYY-MM-DD)

orders[] (주문별 거래명세서)

필드	타입	설명
`delivery_date`	string	인도일 (배송일)
`proof_number`	string	증빙번호

orders[].receiver (공급받는자 정보)

필드	타입	설명
`biz_no`	string	사업자등록번호
`name`	string	상호
`owner`	string	대표자명
`address`	string	주소
`phone`	string	전화번호
`biz_type`	string	업태
`biz_kind`	string	종목

orders[].supplier (공급자 정보)

필드	타입	설명
`name`	string	상호
`biz_no`	string	사업자등록번호
`owner`	string	대표자명
`address`	string	주소
`biz_type`	string	업태
`biz_kind`	string	종목
`phone`	string	전화번호
`email`	string	이메일

orders[].items[] (품목 상세)

필드	타입	설명
`no`	number	순번
`insurance_code`	string	보험코드 (해당 없으면 빈 문자열)
`product_title`	string	상품명
`specifications`	string	규격
`unit`	string	단위 (예: `"EA"`)
`quantity`	number	수량
`unit_price`	number	단가 (공급가 기준)
`amount`	number	금액 (unit_price x quantity)

orders[].summary (합계)

필드	타입	설명
`subtotal`	number	합계 금액
`supply_amount`	number	공급가액 (부가세 제외)
`vat_amount`	number	부가세액
`total`	number	총액 (공급가액 + 부가세)
`outstanding`	string	미수금 (해당 없으면 빈 문자열)

orders[].footer (하단 정보)

필드	타입	설명
`notes`	string	비고
`sales_office`	string	영업소
`sales_rep_name`	string	영업 담당자명
`sales_rep_phone`	string	영업 담당자 연락처

참고사항

요청 형식 및 동작은 PDF API와 동일합니다.
정산이 아직 생성되지 않은 품목은 SETTLEMENT_NOT_FOUND 에러가 반환됩니다.
향후 응답 스키마가 변경될 수 있으므로, 단순 출력/보관 목적이라면 PDF API를 사용하세요.