Odoo용 한국 CJ대한통운 연동
CJ대한통운 택배 송장 출력 및 배송 추적 - 직접 발급받은 CJ API 인증정보 사용 (BYOK)
Odoo에서 바로 CJ대한통운으로 배송
이 모듈은 Odoo의 모든 출고 배송을 CJ대한통운 택배로 전환합니다. 배송을 접수하고, CJ가 부여한 운송장번호 범위에서 운송장번호를 할당하며, 스캔 가능한 운송장 라벨을 인쇄하고, 배송 상태를 동기화 상태로 유지합니다. 이는 직접 키 사용(BYOK) 연동 모듈입니다 - CJ대한통운에서 발급받은 API 키와 고객 코드를 입력하면, 모든 요청이 설정한 CJ 엔드포인트로 직접 전송됩니다. 미들웨어도, 제3자 중계도 없습니다.
택배 접수 (사전 채번 방식)
재고 출고에서 클릭 한 번으로 CJ 택배를 접수합니다. CJ는 API 응답으로 운송장번호를 발급하지 않으므로, CJ가 계약 시 부여한 운송장번호 범위(사전 채번)에서 다음 번호를 로컬에서 순차 할당하여 접수 페이로드(발송인, 수취인, 택배 제원, 운임 유형, 운송장번호)와 함께 CJ에 등록합니다. 범위 소진 시 접수가 중단되며 CJ로부터 새 번호 블록을 받아 설정합니다.
인쇄 가능한 운송장 라벨
발송인 / 수취인 블록, 택배 제원, CJ 운송장번호의 스캔 가능한 Code128 바코드를 포함한 독립형 인쇄용 HTML 운송장입니다 - 로컬에서 렌더링되며, 외부 인쇄 서비스를 사용하지 않습니다.
실시간 추적
접수된 모든 택배의 현재 CJ 스캔 상태를 필요 시 또는 선택적 예약 갱신을 통해 조회합니다. 모든 배송에 공개 추적 링크가 자동으로 생성됩니다.
집화 전 취소
집화되기 전에 접수된 CJ 택배를 취소하고, 배송에서 운송장번호와 추적 참조를 삭제합니다.
한국 환경에 맞게 정확하게
| 기능 | 상세 |
|---|---|
| 운송장번호 | 공개 CJ 형식(10~13자리 숫자)으로 검증·정규화되며, 표시를 위해 그룹화됩니다. |
| 한국 우편번호 | 5자리 도로명 우편번호(2015-08-01 이후 우정사업본부); 구 6자리 코드도 허용 및 보존. |
| 박스 크기 등급 | 택배 둘레(L+W+H)와 무게로 극소/소/중/대/특대 자동 분류. |
| 운임 유형 | 선불, 착불, 신용(월정산). |
| 공개 추적 | 배송별 CJ 추적 URL 자동 생성(gnbInvcNo). |
| 감사 로그 | 모든 CJ API 호출을 작업, 상태, 소요 시간, 오류 발췌와 함께 기록. |
작동 방식
- 제공업체를 CJ대한통운 (한국)으로 하는 배송 방법을 생성합니다.
- CJ API 키, 고객 코드, (선택) 계약 번호를 입력합니다.
- CJ 연결 테스트를 눌러 인증정보를 확인합니다.
- 모든 출고 배송에서 CJ 라벨을 열어 접수·미리보기·운송장 인쇄를 합니다.
- 배송에서 택배를 추적하거나, 예약 상태 갱신을 활성화합니다.
요구 사항
- Odoo 18.0 또는 19.0 (Community 또는 Enterprise).
- API 키와 고객 코드가 있는 유효한 CJ대한통운 화주 계약.
- Odoo 서버에서 CJ 엔드포인트로의 HTTPS 아웃바운드.
이 연동 모듈은 CJ 형식의 접수 페이로드를 생성하여 직접 발급받은 인증정보로 전송합니다. CJ 인증 중계나 미들웨어가 아니며, 인증정보를 사용자의 데이터베이스 외부에 저장하지 않습니다.
English Version
Korea CJ Logistics Connector for Odoo
CJ대한통운 parcel label generation and shipment tracking - using your own CJ API credentials (BYOK)
Ship with CJ Logistics straight from Odoo
This module turns any outgoing Odoo delivery into a CJ Logistics parcel: it books the shipment, assigns the waybill number (운송장번호) from the range CJ issued to you, prints a scannable waybill label, and keeps the delivery status in sync. It is a bring-your-own-key (BYOK) connector - you paste the API key and customer code issued to you by CJ Logistics, and every request goes straight to the CJ endpoint you configure.
Parcel booking & printable label
Book a CJ parcel from a stock picking in one click. The next waybill number is drawn from your CJ-issued range (사전 채번) and sent to CJ for registration - CJ does not mint one in the API response. A self-contained printable HTML waybill carries a scannable Code128 barcode, rendered locally with no external print service.
Live tracking & cancellation
Query the current CJ scan status on demand or via scheduled refresh, with an auto-built public tracking link, and cancel a booked parcel before pickup. Korea-specific handling: invoice number normalisation, 5-digit road-name postcodes, box-size class, freight type, full audit log.
Requirements
Odoo 18.0 or 19.0 (Community or Enterprise), an active CJ Logistics shipper contract with API key and customer code, and HTTPS outbound to the CJ endpoint. This connector generates the CJ-format booking payload and transmits it with your own credentials; it is not a CJ-certified relay and stores no credentials outside your own database.
Screenshots
Api Log
Settings
BYOK · 지원 · 환불
이 모듈은 BYOK(직접 키 사용) 연동입니다 - CJ 공인 연동사·중계·미들웨어가 아니며, 사용자가 CJ대한통운과 직접 계약하여 발급받은 API 키·고객 코드·운송장번호 범위로 동작합니다. 인증정보는 사용자의 데이터베이스에만 저장됩니다. 엔드포인트 경로와 페이로드 필드는 사용자의 CJ open-API 계약에 맞게 설정에서 조정할 수 있습니다. 기술 지원: support@pokutsoft.com. 모듈 결함은 무료로 수정합니다. 환불: 모듈이 설명대로 동작하지 않고 30일 내 수정이 불가능한 경우 전액 환불.
BYOK · Support · Refund
This is a bring-your-own-key (BYOK) connector - it is not a CJ-certified integrator, relay or middleware. It runs on the API key, customer code and waybill number range that you obtain under your own direct contract with CJ Logistics, and credentials are stored only in your own database. Endpoint paths and payload field keys are configurable so you can match your exact CJ open-API contract. Support: support@pokutsoft.com. Module defects are fixed free of charge. Refund: if the module does not work as described and we cannot fix it within 30 days, you get a full refund.
Update date: 2026-07-02