송장번호는 있는데 택배사 칸은 비었다: 여러 쇼핑몰 배송문의를 한 작업판으로

에이픽 서비스를 소개하는 홍보 글입니다. 아래는 현실적인 반복업무를 바탕으로 구성한 가상 도입 시나리오이며 실제 고객사 후기나 실측 결과가 아닙니다. 공식 문서는 2026년 11월 5일 확인했고, 국내외38개 표기는 같은 날12:27 UTC 공개 상품페이지 HTML로 다시 대조했습니다. 삽입 화면은 2026년 10월 28일 공개 문서 보관 캡처로 최신 상태·실제 API 호출 결과와 구분합니다.

어떤 업무를 바꾸려는가

여러 판매채널을 운영하는 작은 쇼핑몰을 가정합니다. 주문번호와 송장번호는 모였는데 택배사 이름이 일부 빠져 있습니다. 고객 문의가 올 때마다 택배사를 찾아 조회하고 상담 메모에 상태를 다시 적습니다.

이번 가상 연동은 택배사를 아는 건은 지정 조회로 보내고, 모르는 건만 자동인식 경로로 보내는 방식입니다. 에이픽 공식 문서는 국내외 38개 택배사 지원과 송장번호 기반 자동인식을 안내합니다. 이것이 모든 송장의 조회 성공이나 38개사의 현재 무중단 운영을 보장한다는 뜻은 아닙니다.

화면 1. 가입정보를 입력하지 않은 공식 빈 양식. 2026년 10월 28일 보관 캡처이며 실제 가입완료 화면이 아닙니다.

서버 연동 준비

에이픽 홈페이지에서 택배 배송조회 개발가이드로 이동해 현재 요청 필드와 택배사 코드를 확인합니다. 아래 공통 화면은 서비스 찾기, 계정 준비, 서버 인증, 요청 구조를 설명하는 참고용이며 택배 API 실행 화면은 아닙니다.

주문번호는 우리 시스템의 업무 식별자로 관리하고, 실제 송장번호는 서버 환경변수에 연결합니다. 택배사를 알고 있다면 현재 문서의 carrier 허용코드를 확인해 사용합니다. 모르는 경우에만 자동인식 API를 검토합니다.

공식 안내는 택배사를 알 때 지정 조회가 더 빠르고 저렴하다고 설명합니다. 자동인식을 모든 건에 적용하는 것이 최적이라는 주장은 하지 않습니다.

화면 2. 공식 인증·서버 환경변수 안내. 2026년 10월 28일 보관 캡처이며 실제 키를 표시하지 않습니다.

화면 3. 에이픽 공개 홈: API와 개발가이드로 이동하는 시작 화면. 2026년10월28일 보관 캡처이며 택배 조회 실행결과가 아닙니다. 당시 표시된 상품 수는 현재 수를 뜻하지 않습니다.

요청과 응답 예시

아래 curl은 공식 경로와 필드를 사용한 정적 연동 예시입니다. 환경변수에는 실행 전에 승인된 값을 서버에서 준비해야 합니다. 이 글을 작성하며 실제 호출·결제·발급은 하지 않았습니다. 키를 직접 코드에 넣거나 셸 디버깅으로 출력하지 마세요.

curl --request POST 'https://apick.app/rest/parcel_tracking' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "carrier=${APICK_CARRIER}" \
  --form-string "trackingNumber=${APICK_TRACKING_NUMBER}"

# 택배사를 모르는 별도 건의 자동인식 요청 예시
curl --request POST 'https://apick.app/rest/parcel_tracking_auto' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string "trackingNumber=${APICK_TRACKING_NUMBER}"

응답 형식 또는 공식 응답 일부를 설명하는 정적 예시입니다. 실제 조회 결과가 아니며 식별정보는 공개하지 않습니다.

{
  "data": {
    "carrier": {"code": "cj", "name": "CJ대한통운"},
    "trackingNumber": "[마스킹]",
    "status": "DELIVERED",
    "carrierStatus": "배달완료"
  }
}

위 JSON은 공식 정적 응답의 일부 구조이며 송장번호를 가렸습니다. 실제 배송건의 배달완료를 확인한 것이 아닙니다. 예시에는 완료 상태가 있지만 모든 조회가 같은 상태로 돌아오지는 않습니다.

CS 작업판에는 주문번호와 마지막 조회시각, 받은 상태를 함께 표시합니다. API가 반환하지 않은 배송예정일이나 사고 원인을 추정해 적지 않습니다. 송장이 아직 등록되지 않았거나 조회되지 않으면 고객에게 배송분실이라고 단정하지 말고 확인필요로 분류합니다.

교환 주문은 최초 발송과 회수 송장을 따로 관리합니다. 주문번호가 같다고 두 송장을 하나로 덮어쓰면 서로 다른 이동상태를 혼동할 수 있습니다. 이 작업판은 우리 서버에서 구현하는 예시이며 APICK이 완성된 쇼핑몰 관리자 화면을 제공한다는 뜻이 아닙니다.

화면 4. 공식 시작하기의 info cURL 정적 예시. 2026년 10월 28일 보관 캡처이며 본문의 택배조회 요청이나 성공응답을 촬영한 화면이 아닙니다.

비용과 예외 처리

공식 지정조회 기본요금은 5P이며 실패·정보없음은 무과금이라고 안내합니다. 자동인식의 적용 요금은 현재 문서에서 별도로 확인해야 하므로 같은 5P라고 단정하지 않습니다.

공개 상태표의 ‘상태 확인 중’ 표기를 실제 장애나 정상 증거로 해석하지 않습니다. 호출 전에 필요한 상품의 최신 상태를 확인하고 운영에 맞는 갱신 간격을 정합니다. 고객 문의마다 여러 번 새로고침하기보다는 마지막 확인시각을 보여주고 필요한 건만 다시 조회하는 방식부터 검토해 보세요.

사람이 확인할 일을 남겨둔다

이 연동에서 줄이고 싶은 것은 화면 사이의 복사·붙여넣기와 상태 확인의 반복입니다. 아직 측정한 결과가 없으므로 ‘밤새던 작업이 몇 분에 끝났다’고 실제 성과처럼 말하지 않습니다. 작은 승인된 범위에서 처리시간, 실패건, 담당자 개입건과 비용을 기록한 뒤 확대 여부를 판단합니다.

응답 원문에는 업무에 필요한 것 이상의 정보가 포함될 수 있습니다. 키·이름·계좌·주소·식별번호·문서·다운로드 링크는 공개 글과 공유 로그에서 제외하고, 내부 저장도 접근권한과 보관기간을 정합니다. 자동화가 판단과 동의 절차까지 없애주는 것은 아닙니다.

공식 서비스: https://apick.app

공식 해당 API 가이드: https://apick.app/dev_guide/parcel_tracking