거래내역 요청

거래와 관련된 API 기능을 제공합니다.

발생한 매출에 대해 거래내역을 조회할 수 있습니다.
거래내역은 매출에 대한 상세 정보를 제공합니다.

기본 호출 구문

const API = axios.create({
  baseURL: `http://api.ubcn.co.kr/api`,
  headers: {
    "Access-Control-Allow-Origin": "*",
    "company": "{company}",
    "token": "{token}",
  },
});

//get, post 모두 지원합니다.
const res = await API.get("/sales/{date}/{time}/{minute}");
console.log(res.data);

// 프로세스가 제대로 완료되지 않은 경우 에러 코드가 존재합니다.
if (res.code != null) {
  return alert(res.decription);
}

Schema

결과 값에 들어 있는 필드는 다음과 같습니다.

필드명	상세필드명	필수	타입	설명	비고
decription	-	Y	String	API 상세설명	-
message	-	Y	String	응답 메시지	-
type	-	Y	String	API 유형	-
salesDate	-	Y	String	요청일자	YYYYMMDD
salesList	transactionDate	Y	String	매출일자	YYYYMMDD
	transactionNo	Y	String	거래고유번호	UBCn 거래번호 (PK)
	terminalId	Y	String	단말기 ID	UBCn 단말기 ID
	terminalCode	Y	String	단말기 코드	가맹점 관리 단말기 코드
	placeCode	Y	String	위치코드(점포코드)	점포코드
	placeNo	Y	String	위치순번(POS번호)	POS번호
	terminalTransSeq	Y	String	단말기 거래 번호	단말기 거래 번호
	tranDate	Y	String	거래일자	거래일자(YYYYMMDD)
	tranTime	Y	String	거래시간	거래시간(HH24MISS)
	payStep	Y	String	거래 종류	1:거래, 2:취소
	payType	Y	String	지불 종류	1:현금, 2:신용카드, 3:선불카드
	cardCode	Y	String	카드사 코드	카드사 코드 참고
	purchaseCode	Y	String	매입사 코드	매입사 코드 참고
	vanCode	Y	String	VAN사 코드	VAN사 코드 참고
	cardNo	Y	String	카드번호	마스킹된 카드번호
	approvalNo	Y	String	승인번호	-
	approvalDate	Y	String	승인일자	YYYYMMDD
	approvalTime	Y	String	승인시간	HH24MISS
	orgTransactionDate	Y	String	원거래일자	취소시 원거래 일자
	orgTerminalTransSeq	Y	String	원거래 단말기 거래 번호	취소시 단말기 거래 번호
	orgApprovalNo	Y	String	원거래 승인번호	취소시 원거래 승인번호
	colNo	Y	String	자판기 컬럼	-
	productCode	Y	String	상품코드	상품(바)코드
	productName	Y	String	상품명	-
	count	Y	String	판매수량	-
	price	Y	String	판매단가	-
	salesPrice	Y	String	판매금액	판매수량 * 판매단가
	discount	Y	String	할인금액	할인 결제시(현재 지원 안함)
	point	Y	String	사용포인트	포인트 혼용 결제시 (현재 지원 안함)
	amount	Y	String	결제금액	판매금액 - 할인금액 - 포인트
	beforeBalance	Y	String	사용전금액	티머니/캐시비 사용전 잔액
	afterBalance	Y	String	사용후금액	티머니/캐시비 사용후 잔액
	purchaseExpDate	Y	String	매입 예정일	카드결제 시 매입 예정일
	payExpDate	Y	String	입금 예정일	카드결제시 입금 예정일