TICKETS

거래·증빙 티켓

카드 승인, 입출금, 세금계산서 이벤트를 조회해요. 분류와 연결 상태 관리.

티켓 조회·갱신·정산 연결

티켓 조회는 POST body로 조건을 전달해요. 최신 데이터 갱신과 증빙·결제 관계는 ticket-references 기준.

  • POST/api/public-docs/tickets
    거래·증빙 티켓을 조회해요. 기간은 1회 최대 31일.
  • POST/api/public-docs/tickets/bulk-update-individual
    티켓의 계정과목, 1차/2차 태그, 설명을 단건 또는 묶음으로 수정해요.
  • POST/api/public-docs/tickets/refresh
    워크스페이스의 거래·증빙 데이터 갱신을 비동기로 요청해요.
  • GET/api/public-docs/ticket-references
    특정 티켓에 직접 연결된 상대 티켓 목록을 조회해요.
  • POST/api/public-docs/ticket-references
    증빙/업무 티켓과 카드·계좌 거래 티켓의 연결 관계를 생성해요.
  • DELETE/api/public-docs/ticket-references
    연결 관계 ID 기준으로 연결만 해제해요. 원본 티켓 미삭제.

조회 body와 연결 규칙

파라미터타입필수설명
ticketTypestringrequired예: EXPENSE_TICKET, BANK_TRANSACTION_TICKET, TAX_INVOICE_TICKET.
startDatestring (YYYY-MM-DD)required조회 시작일. 기간 기반 조회는 1회 최대 31일 기준.
endDatestring (YYYY-MM-DD)required조회 종료일. 더 긴 기간은 31일 이하 분할 호출.
referenceableIdnumberrequired연결 조회 기준 티켓 ID.
referenceableTypestringrequired예: TAX_INVOICE_TICKET.
ticketReferenceIdsnumber[]required연결 해제 시 ticketReferenceId 사용.
POST /api/public-docs/tickets
$ curl -X POST https://app.granter.biz/api/public-docs/tickets \
-H "Content-Type: application/json" \
-H "Authorization: Basic <BASE64(API_KEY:)>" \
-d '{"ticketType":"EXPENSE_TICKET","startDate":"2026-03-01","endDate":"2026-03-07"}'
{ "data": [{ "ticketType": "EXPENSE_TICKET" }] }

예시를 복사해
첫 요청을 보내세요

API 키는 Basic 인증으로 넣어요. 필요한 필드와 응답은 문서에서 확인.