오투 솔루션(OTOO WMS) 표준 API 가이드입니다. 고객사 시스템(ERP·쇼핑몰·OMS 등)과 WMS 사이에 품목·입고·출고·재고 정보를 자동으로 주고받는 방법을 연동 순서대로 설명합니다.
한눈에 보는 연동 흐름
일반적인 연동은 아래 순서로 진행합니다. 품목이 먼저 등록되어 있어야 입고·출고 예정을 보낼 수 있습니다.
순서 | 인터페이스 | 방향 | 언제 호출하나요 |
STEP 1 | 품목정보 송신 | 고객사 → WMS | 신규 품목이 생기거나 품목 정보가 바뀔 때 |
STEP 2 | 입고예정 송신 | 고객사 → WMS | 센터로 들어올 물건(발주·반품)이 정해졌을 때 |
STEP 3 | 입고확정 조회 | WMS → 고객사 | 센터에서 실제로 입고 처리된 수량을 받아올 때 |
STEP 4 | 출고예정 송신 | 고객사 → WMS | 주문이 들어와 출고 요청을 보낼 때 |
STEP 5 | 출고확정 조회 | WMS → 고객사 | 센터에서 실제로 출고된 수량을 받아올 때 |
STEP 6 | 품목별 재고 조회 | WMS → 고객사 | 쇼핑몰 재고 동기화 등 현재 재고·가용수량이 필요할 때 |
인터페이스 목록
모든 API는 POST 방식이며, 전송주기 제한 없이 수시로 호출할 수 있습니다.
업무 | 인터페이스 항목 | URL | Method |
기준정보 | 품목정보 송신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/std/item | POST |
입고정보 | 입고예정 송신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/inbound/reg | POST |
입고정보 | 입고확정 송수신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/inbound/conf | POST |
출고정보 | 출고예정 송신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/outbound/reg | POST |
출고정보 | 출고확정 송수신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/outbound/conf | POST |
재고정보 | 품목재고 송수신 | https://cloud.otoowms.kr/rest/v1/otoowmsapi/inventory/iteminv | POST |
시작하기 — 연동 전 준비
순서 | 할 일 | 설명 |
1 | 토큰 발급 요청 | 오투 프리오에 API 사용을 요청하여 인증 토큰을 사전 발급받습니다. |
2 | 코드 확인 | WMS에 등록된 화주코드(ORGCD), 창고코드(WHCD), 거래처코드(CUSTCD)를 확인합니다. |
3 | 테스트 서버로 개발 | Header의 TESTYN에 "Y"를 넣고 호출하면 개발(Test) 서버로 연결됩니다. |
4 | 운영 서버 전환 | TESTYN에 "N"을 넣거나 아무 값도 넣지 않으면 운영(Live) 서버로 호출됩니다. |
기본사항
•
통신규약: REST
•
데이터 형식: JSON (Content-Type: application/json)
Headers
No | Key | 설명 |
1 | Authorization | 오투 프리오에서 발급받은 토큰 값 |
2 | Content-Type | application/json |
3 | TESTYN | Y: 개발 server, N: 운영 server (빈 값일 때는 운영) |
공통 응답 형식
모든 API는 아래 구조로 결과를 돌려줍니다. CODE가 0이면 성공입니다.
Body Response 공통 구조
No | Key | 설명 |
1 | CODE | Response 코드 (0: 성공, 음수: 오류) |
2 | MESSAGE | Response 메시지 |
3 | PATH | 호출한 API URI |
4 | DATA | Response 데이터 (송신 API는 null, 조회 API는 결과 목록) |
5 | COUNT | 처리 건수 |
Response 코드 / 메시지
코드 | 메시지 |
0 | 성공 |
-1 | 시스템 처리 오류입니다. |
-2 | 잘못된 인자 값이거나 필수 값이 없습니다. |
-3 | 지원되지 않는 서비스 API에 대한 호출입니다. |
-4 | 해당 API에 대한 권한이 없습니다. |
-5 | 토큰이 유효하지 않습니다. |
-6 | 토큰 기간이 만료되었습니다. |
-7 | 세션이 유효하지 않습니다. |
-8 | 세션이 만료되었습니다. |
-10 | 데이터 오류. 데이터 변환 오류입니다. |
-11 | 잘못된 데이터입니다. |
-20 | 잘못된 JSON 형식입니다. |
-21 | JSON 파싱 중 오류가 발생했습니다. |
-30 | 잘못된 XML 형식입니다. |
-31 | XML 파싱 중 오류가 발생했습니다. |
-40 | 잘못된 인증입니다. |
-41 | 인증 유효시간이 만료되었습니다. |
-201 | 파일을 읽어 올 수 없습니다. |
-202 | 파일 업로드 처리 오류입니다. |
-203 | 파일 업로드 처리 오류. 폴더 생성 중 오류가 발생했습니다. |
-205 | 시스템 처리 오류. 파일 생성 중 오류가 발생했습니다. |
-301 | 시스템 오류. DB 연결이 정상적이지 않습니다. |
-302 | 시스템 오류. DB 처리 오류가 발생했습니다. |
-501 | I/F 처리 중 오류가 발생했습니다. |
-502 | I/F에 잘못된 인자 값이거나 필수 값이 없습니다. |
STEP 1. 품목정보 송신
방향 / 주기 | 고객사 → WMS / 수시 가능 |
하는 일 | 입출고에 필요한 품목정보를 WMS에 신규 등록하거나 수정합니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/std/item |
Request Body
No | KEY | 설명 | 필수 | 길이 | 비고 |
1 | ORGCD | 화주코드 | Y | 20 | |
2 | ITEMCD | 품목코드 | Y | 20 | |
3 | NAME | 품목명 | Y | 100 | |
4 | SNAME | 품목명 약칭 | 100 | 기본값: 품목명 | |
5 | FNAME | 품목명 별칭 | 100 | 기본값: 품목명 | |
6 | ITEMTYPE | 품목유형 | 10 | 10: 상품 (사용자요청에 따라 달라질 수 있음) | |
7 | CATEGORYCD | 분류 | 20 | 소분류코드, 품목분류 사용하는 사용자만 가능 | |
8 | UNITCD | 단위 | 10 | ||
9 | ITEMSIZE | 규격 | 20 | ||
10 | BARCODE | 물류바코드 | 50 | ||
11 | UNITTYPE | 관리단위 | 10 | EA: 낱개
BOXEA: 박스+낱개
PLTBOXEA: 팔렛+박스+낱개
(기본값: EA, 수량관리단위에 팔레트도 포함할 때만 PLTBOXEA 가능) | |
12 | INBOXQTY | BOX입수량 | 10 | 정수만 가능 (기본값: 1) | |
13 | INCTNQTY | 카톤박스입수량 | 10 | 수량관리단위에 카톤박스 포함할 때만 정수 사용가능 (기본값: 1) | |
14 | INPLTQTY | 팔레트입수량 | 10 | 수량관리단위에 팔레트도 포함할 때만 정수 사용가능 (기본값: 1) | |
15 | WIDTH | 가로 | 10 | 소수점 3번째 자리까지 가능 | |
16 | LENGTH | 세로 | 10 | 소수점 3번째 자리까지 가능 | |
17 | HEIGHT | 높이 | 10 | 소수점 3번째 자리까지 가능 | |
18 | CAPACITY | 체적 | 10 | 소수점 3번째 자리까지 가능 | |
19 | WEIGHT | 무게 | 10 | 소수점 3번째 자리까지 가능 | |
20 | KEEPTEMP | 보관온도 | 10 | STD: 상온, COLD: 냉장, FROZEN: 냉동 | |
21 | MANUFACTURE | 제조사 | 20 | ||
22 | MANUCOUNTRY | 제조국 | 20 | ||
23 | LIMITDAY | 유통기한(일) | 10 | ||
24 | SETYN | 주문세트여부 | 1 | Y: 아니오, N: 예 (기본값: N, 재고관리 안함) | |
25 | BOMSETYN | 가공세트여부 | 1 | Y: 아니오, N: 예 (기본값: N, 재고관리 함) | |
26 | F_USER01~05 | 사용자지정(코드) | 20 | 회사별로 설정 다름 | |
27 | F_USER11~15 | 사용자지정(TEXT) | 20~50 | 회사별로 설정 다름 | |
28 | ISUSING | 사용여부 | 1 | Y: 사용, N: 미사용 (기본값: Y) | |
29 | REMARK | 비고 | 200 |
예시 — Request
예시 — Response
STEP 2. 입고예정 송신
방향 / 주기 | 고객사 → WMS / 수시 가능 |
하는 일 | 입고처리에 필요한 입고 예정 정보를 WMS에 신규 등록합니다. |
전표 분리 기준 | 고객사 입고번호, 화주코드, 창고코드, 거래처코드, 입고예정일자, 입고유형 |
주의 | 고객사 입고번호는 중복 검사(validation check)를 하지 않습니다. 같은 번호로 여러 번 보내면 OTOO 안에서 각각 다른 전표로 만들어집니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/inbound/reg |
Request Body
No | KEY | 설명 | 필수 | 길이 | 비고 |
1 | CUST_WI_CD | 고객사입고번호 | Y | 20 | 고객사의 입고번호 |
2 | ORGCD | 화주코드 | Y | 20 | |
3 | WHCD | 창고코드 | Y | 20 | |
4 | CUSTCD | 거래처코드 | Y | 20 | |
5 | WISCHDT | 입고예정일자 | Y | 8 | YYYYMMDD 형식 |
6 | WITYPE | 입고유형 | 10 | STD: 일반, RET: 매출반품 (기본값: STD) | |
7 | ITEMCD | 품목코드 | Y | 20 | |
8 | QTY | 수량 | Y | 10 | 정수만 가능 |
9 | LOTDAMAGE | 품목속성 | 5 | 0: 정상품, 1: 불량품, 2: 보류품 (기본값: 0) |
예시 — Request
예시 — Response
STEP 3. 입고확정 조회
방향 / 주기 | WMS → 고객사 / 수시 가능 |
하는 일 | 센터에서 입고 처리가 완료된 정보(입고확정수량)를 조회 조건에 맞게 돌려줍니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/inbound/conf |
Param (조회 조건)
No | KEY | 설명 | 필수 | 비고 |
1 | S_WIDT | 입고일자 | Y | |
2 | S_ORGCD | 화주코드 | ||
3 | S_WHCD | 창고코드 | ||
4 | S_CUSTCD | 거래처코드 | ||
5 | S_CUST_WI_CD | 고객사입고번호 |
Response Data
No | KEY | 설명 | 비고 |
1 | CUST_WI_CD | 고객사 입고번호 | |
2 | WIKEY | OTOO 입고번호 | |
3 | SEQ | OTOO 입고번호 순번 | |
4 | ORGCD | 화주코드 | |
5 | WHCD | 창고코드 | |
6 | WIDT | 입고일자 | YYYYMMDD 형식 |
7 | ITEMCD | 품목코드 | |
8 | QTY | 입고확정수량 | 정수만 가능 |
9 | LOTDAMAGE | 품목속성 | 0: 정상품, 1: 불량품, 2: 보류품 (기본값: 0) |
예시 — Param
예시 — Response
STEP 4. 출고예정 송신
방향 / 주기 | 고객사 → WMS / 수시 가능 |
하는 일 | 출고처리에 필요한 출고 예정 정보를 WMS에 신규 등록합니다. |
전표 분리 기준 | 고객사 출고번호, 화주코드, 창고코드, 거래처코드, 납품처코드, 출고예정일자, 출고유형, 우편번호, 주소, 수령인, 수령인연락처 |
주의 | 고객사 출고번호는 중복 검사(validation check)를 하지 않습니다. 같은 번호로 여러 번 보내면 OTOO 안에서 각각 다른 전표로 만들어집니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/outbound/reg |
Request Body
No | KEY | 설명 | 필수 | 길이 | 비고 |
1 | CUST_WO_CD | 고객사출고번호 | Y | 20 | 고객사의 출고번호 |
2 | ORGCD | 화주코드 | Y | 20 | |
3 | WHCD | 창고코드 | Y | 20 | |
4 | CUSTCD | 거래처코드 | 20 | 기본값: B2C (B2C 미존재시 자동생성) | |
5 | SHIPTOCD | 납품처코드 | 20 | 기본값: 거래처코드 | |
6 | WOSCHDT | 출고예정일자 | Y | 8 | YYYYMMDD 형식 |
7 | WOTYPE | 출고유형 | 10 | STD: 일반, B2C: B2C (기본값: B2C) | |
8 | POSTNO | 우편번호 | Y | 20 | |
9 | ADDRESS | 주소 | Y | 200 | |
10 | RECIPIENT | 수령인 | Y | 20 | |
11 | RECIPPHONENO | 수령인연락처 | Y | 20 | |
12 | ITEMCD | 품목코드 | Y | 20 | |
13 | QTY | 수량 | Y | 10 | 정수만 가능 |
14 | LOTDAMAGE | 품목속성 | 5 | 0: 정상품, 1: 불량품, 2: 보류품 (기본값: 0) |
예시 — Request
예시 — Response
STEP 5. 출고확정 조회
방향 / 주기 | WMS → 고객사 / 수시 가능 |
하는 일 | 센터에서 출고 처리가 완료된 정보(출고확정수량)를 조회 조건에 맞게 돌려줍니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/outbound/conf |
Param (조회 조건)
No | KEY | 설명 | 필수 | 비고 |
1 | S_WODT | 출고일자 | Y | |
2 | S_ORGCD | 화주코드 | ||
3 | S_WHCD | 창고코드 | ||
4 | S_CUSTCD | 거래처코드 | ||
5 | S_CUST_WO_CD | 고객사출고번호 |
Response Data
No | KEY | 설명 | 비고 |
1 | CUST_WO_CD | 고객사 출고번호 | |
2 | WOKEY | OTOO 출고번호 | |
3 | SEQ | OTOO 출고번호 순번 | |
4 | ORGCD | 화주코드 | |
5 | WHCD | 창고코드 | |
6 | WODT | 출고일자 | YYYYMMDD 형식 |
7 | ITEMCD | 품목코드 | |
8 | QTY | 출고확정수량 | 정수만 가능 |
9 | LOTDAMAGE | 품목속성 | 0: 정상품, 1: 불량품, 2: 보류품 (기본값: 0) |
예시 — Param
예시 — Response
STEP 6. 품목별 재고 조회
방향 / 주기 | WMS → 고객사 / 수시 가능 |
하는 일 | 요청한 품목들의 센터 재고수량과 가용수량을 품목속성별로 돌려줍니다. |
엔드포인트 | (POST) https://cloud.otoowms.kr/rest/v1/otoowmsapi/inventory/iteminv |
Param (조회 조건)
No | KEY | 설명 | 필수 | 비고 |
1 | S_ORGCD | 화주코드 | Y | |
2 | S_WHCD | 창고코드 | Y | |
3 | S_ITEMLIST | 품목코드 | Y | 품목코드를 리스트 형식으로 보냄 |
Response Data
No | KEY | 설명 | 비고 |
1 | WHCD | 창고코드 | |
2 | ORGCD | 화주코드 | |
3 | ITEMCD | 품목코드 | |
4 | QTY | 재고수량 | 센터에 있는 수량 (정수만 가능) |
5 | ABLEQTY | 가용수량 | 센터에서 사용 가능한 수량 (정수만 가능) |
6 | LOTDAMAGE | 품목속성 | 0: 정상품, 1: 불량품, 2: 보류품 (기본값: 0) |
예시 — Param
예시 — Response
자주 묻는 질문 (FAQ)
Q. 호출했는데 CODE가 -5 또는 -6으로 옵니다.
Q. CODE -2가 나옵니다.
Q. 같은 입고(출고)번호를 다시 보내면 기존 전표가 수정되나요?
Q. 테스트 데이터가 운영 서버에 들어갔어요.
Q. 재고 조회에서 같은 품목이 여러 줄로 옵니다.
용어 정리
용어 | 설명 |
API | 응용 프로그램에서 사용할 수 있도록, 운영 체제나 프로그래밍 언어가 제공하는 기능을 제어할 수 있게 만든 인터페이스 |
JSON | 속성-값 쌍(키-값 쌍)으로 이루어진 데이터 오브젝트를 전달하기 위한 개방형 표준 텍스트 포맷 |
Token | 시스템과 데이터 통신을 위한 인증키 |
화주코드 (ORGCD) | WMS에 등록된 화주(물건 주인)를 구분하는 코드 |
창고코드 (WHCD) | 입출고가 이루어지는 물류센터(창고)를 구분하는 코드 |
품목속성 (LOTDAMAGE) | 재고의 상태 구분 — 0: 정상품, 1: 불량품, 2: 보류품 |
가용수량 (ABLEQTY) | 센터 재고 중 출고에 바로 쓸 수 있는 수량 |
문서 변경 이력
Version | 변경 내용 | 작성자 | 일자 |
1.0 | 최초 작성 | 프리오 | 2021.02.23 |
1.1 | 연동 순서(STEP) 중심으로 구성 개편, FAQ·용어 정리 추가 | 프리오 | 2026.11.12 |