LX 판토스 연동 API 명세서

해당 문서는 LX 판토스 시스템과 연동되는 API 목록 및 요청/응답 포맷을 명시합니다.

인증 방식

Key:Secret 조합을 Base64로 인코딩한 값을 Authorization 헤더에 사용합니다.


개발 Key: dev-lx-pantos
개발 Secret: odLR/udO49MdMJaxum4uDlpUPrwrEhaq2w/353CUP+0=

Base64 인코딩 예제 (Java)


import java.util.Base64;

public class Base64Example {
    public static void main(String[] args) {
        String credentials = "dev-lx-pantos:odLR/udO49MdMJaxum4uDlpUPrwrEhaq2w/353CUP+0=";
        String encoded = Base64.getEncoder().encodeToString(credentials.getBytes());
        System.out.println("Base64 Encoded: " + encoded);
    }
}

API 인증 실패 응답 예시

{
  "message": "gateway error authorization",
  "success": false,
  "status": 401,
  "cause": "invalid or missing credentials",
  "timestamp": "2025-05-02T06:53:17.237852089"
}

1. WMS 재고 업데이트

POST /api/ext/lx-pantos/update-wms-stock

설명: LX 판토스의 재고 정보를 저장합니다.

요청 Header


Content-Type: application/json
Authorization: Basic {{ENCODED_AUTHORIZATION}}

요청 예시


  {
    "datalist": [
      {
        "INTERFACE_ID": "202210202350010080532184WM",
        "INTERFACE_SEQ": 1,
        "WH_CD": "KR119353",
        "BASEDT": "2025-03-31",
        "ZONE": "A ZONE",
        "CELL": "A01-01-01",
        "ITEM_CD": "YGE000200",
        "STATUS_CD": "GD",
        "LOT_NO": "FJZ",
        "MAN_DATE": "2025-03-31",
        "EXPIRE_DATE": "2025-03-31",
        "STOCK_QT": 250,
        "AVAILABLE_QT": 210
      }
    ]
  }

성공 응답


  {
    "state": "success",
    "message": "데이터 검증 & 저장 성공."
  }

실패 메세지

"내부 서버 에러."
"[Invalid date format for ‘BASEDT’. Expected format: yyyy-MM-dd. [20250530]]"
"[Invalid date format for ‘MAN_DATE’. Expected format: yyyy-MM-dd. [20250530]]"
"[Invalid date format for ‘EXPIRE_DATE’. Expected format: yyyy-MM-dd. [20250530]]"

실패 응답


  {
    "state": "fail",
    "message": "{{Error messages}}"
  }

2. 구매 입고 확정

POST /api/ext/lx-pantos/purchase-inbound-confirm

설명: 구매 입고 확정 처리

요청 Header


Content-Type: application/json
Authorization: Basic {{ENCODED_AUTHORIZATION}}

요청 예시


  {
    "datalist": [
      {
        "INTL_SYS_CD": "WMS",
        "WH_CD": "KR119353",
        "SEND_RCV_FG": "2",
        "RELATION_CD": "340",
        "CRUD_FG": "I",
        "INTL_DOC_NO": "COOB24041110413922",
        "INTL_DOC_SQ": 1,
        "COMPANY_CD": "9000",
        "PLANT_CD": "1000",
        "SL_CD": "LX001",
        "ITEM_CD": "TPM024",
        "PURREQ_DT": "20240412",
        "PURDOC_TP": "STD",
        "PURREQ_TP": "1000",
        "PURORG_CD": "1000",
        "PURGRP_CD": "1000",
        "PUR_LINE_TP": "I",
        "PURREQ_QT": 2,
        "STD_QT": 2,
        "LOT_NO": "LOT1",
        "MANUF_DTM": "2024-10-01",
        "CUST_CD": "CS2024100128",
        "EXPIRE_DATE": "2025-12-31",
        "INSERT_ID": ""
      }
    ]
  }

성공 응답


  {
    "state": "success",
    "data": "데이터 검증 & 저장 성공."
  }

실패 메세지

"내부 서버 에러."
"[Invalid date format for PURREQ_DT. Expected format: yyyyMMdd. [2025-05-30]]"
"[Invalid date format for MANUF_DTM. Expected format: yyyy-MM-dd. [20250530]]"
"[Invalid date format for EXPIRE_DATE. Expected format: yyyy-MM-dd. [20250530]]"

실패 응답


  {
    "state": "fail",
    "data": "{{Error messages}}"
  }

3. 운송장 등록

POST /api/ext/lx-pantos/update-oms-tracking-number

설명: OMS에 운송장 번호를 등록합니다.

요청 Header


Content-Type: application/json
Authorization: Basic {{ENCODED_AUTHORIZATION}}

요청 파라미터 (QueryString)

partner_key - 파트너 키
domain_key - 업체 키
action - 액션 타입 (예: set_trans_no)
seq - 관리 번호 (예: 1526074)
trans_corp - 택배사 코드 (예: 30002)
trans_no - 송장 번호 (예: 123456789012)

요청 예시


  POST /api/ext/lx-pantos/update-oms-tracking-number?
        partner_key={{파트너 키}}
        &domain_key={{업체 키}}
        &action=set_trans_no
        &seq=1503933
        &trans_corp=30003
        &trans_no=593623766414

성공 응답


  {
    "error": 0,
    "msg": "success",
    "seq": {{요청시 seq}}
  }

실패 응답


  {
    "error": 1,
    "msg": "system error",
    "seq": {{요청시 seq}}
  }

4. 기타 입/출고 재고 이동 확정

POST /api/ext/lx-pantos/etc-in-outbound-confirm

설명: 기타 입출고 및 재고 이동 확정 처리

요청 Header


Content-Type: application/json
Authorization: Basic {{ENCODED_AUTHORIZATION}}

요청 예시

{
  "datalist": [
    {
      "INTL_SYS_CD": "WMS",
      "WH_CD": "KR119353",
      "SEND_RCV_FG": "2",
      "RELATION_CD": "410",
      "CRUD_FG": "I",
      "INTL_DOC_NO": {{기타 입/출고 재고 이동 예정 요청 시 "EDI_NO"}},
      "INTL_DOC_SQ": 1,
      "COMPANY_CD": "1000",
      "ITEM_CD": "AA000242",
      "INVTRX_RSV_DT": "20250110",
      "INVTRX_RSV_TP": "3",
      "INVTRX_RSV_ST": "O",
      "INVTRX_TP_CD": "421",
      "STD_RSV_QT": "1",
      "LOT_NO": "LOT1",
      "EXPIRE_DATE": "2025-12-31",
      "PLANT_CD": "1000",
      "SL_CD": "LX007",
      "MV_PLANT_CD": "1000",
      "MV_SL_CD": "",
      "CC_CD": "F015",
      "RMK_DC": "20240110_일본 시딩_국제",
      "INSERT_ID": "yh.jang"
      "INVRSN_CD": "AB"
    }
  ]
}

성공 응답


  {
    "state": "success",
    "data": "데이터 검증 & 저장 성공."
  }

실패 메세지

"내부 서버 에러."
"[Invalid date format for ‘INVTRX_RSV_DT’. Expected format: yyyyMMdd. [2025-05-30]]"
"[Invalid date format for 'EXPIRE_DATE’. Expected format: yyyy-MM-dd. [20250530]]"

실패 응답


  {
    "state": "fail",
    "data": "{{Error messages}}"
  }

5. 판매 출고 확정

POST /api/ext/lx-pantos/shipping-outbound-confirm

설명: 판매 출고 확정 처리

요청 Header


Content-Type: application/json
Authorization: Basic {{ENCODED_AUTHORIZATION}}

요청 예시


  {
    "datalist": [
      {
        "SODOC_NO": "357326",
        "INVTRX_DT": "",
        "PARTNER_CD": "",
        "PARTNER_NM": ""
      }
    ],
    "itemList": [
      {
        "SODOC_NO": "357326",
        "SODOC_SQ": "",
        "ITEM_CD": "AN00001",
        "ITEM_NM": "",
        "LOT_NUMBER": "TEST00111",
        "EXPIRE_DATE": "2026-12-31",
        "STD_UNIT_QT": ""
      }
    ]
  }

성공 응답


  {
    "state": "success",
    "message": "데이터 검증 & 저장 성공."
  }

실패 메세지

"내부 서버 에러."
"[Invalid date format for ‘INVTRX_DT’. Expected format: yyyyMMdd. [2025-05-30]]"
"[Invalid date format for ‘EXPIRE_DATE’ in Items. Expected format: yyyy-MM-dd. [20250530]]"
"[Invalid value for ‘SODOC_NO’ in Items. That was required.]"

실패 응답


  {
    "state": "fail",
    "message": "{{Error messages}}"
  }