Seanergy - 사용자 가이드

NEW-002 인보이스 AED(디르함) 통화 발행 ▼

기능 설명

아랍권(UAE) 거래 시 인보이스를 USD 대신 AED(디르함)로 발행합니다. 고정 환율 1 USD = 3.6725 AED로 자동 변환됩니다.

사용 방법

바이어 관리 → 주문 상세 → 서류관리 섹션으로 이동
"AED(디르함) 발행" 체크박스를 선택
인보이스 발행 버튼 클릭
생성된 PDF에 AED 금액 + 환율 정보가 표시됨

변환 예시

USD 금액	AED 금액	계산
$50,000.00	183,625.00 AED	50,000 x 3.6725
$1,400.00	5,141.50 AED	1,400 x 3.6725
$500.00	1,836.25 AED	500 x 3.6725

IBK 은행계좌, 선박명 제거와 동시에 사용 가능합니다. 3개 체크박스를 모두 선택할 수 있습니다.

NEW-003 인보이스 IBK 은행계좌 발행 ▼

기능 설명

인보이스 하단 Payment Instructions에 우리은행(기본) 대신 IBK(기업은행) 계좌를 표시합니다.

사용 방법

바이어 관리 → 주문 상세 → 서류관리 섹션으로 이동
"IBK 계좌로 발행" 체크박스를 선택
인보이스 발행 버튼 클릭

은행 계좌 정보

항목	우리은행 (기본)	IBK 기업은행
계좌번호	`1081-101-077868`	`054-160034-56-00011`
은행명	Woori Bank	Industrial Bank of Korea
SWIFT	`HVBKKRSE`	`IBKOKRSEXXX`

NEW-010 인보이스 선박명 제거 발행 ▼

기능 설명

기밀 또는 계약상 이유로 인보이스에서 선박명을 제거합니다. "Vessel /Ship To" 라벨과 선박명이 모두 비워집니다.

사용 방법

바이어 관리 → 주문 상세 → 서류관리 섹션으로 이동
"선박명 제거" 체크박스를 선택
인보이스 발행 버튼 클릭
생성된 PDF에서 선박명 관련 항목이 공란으로 표시됨

제거되는 항목

위치	선박명 제거 OFF	선박명 제거 ON
인보이스 상단 헤더	WAN YING ASSAA	(공란)
Vessel /Ship To 라벨	Vessel /Ship To	(공란)
Vessel /Ship To 값	WAN YING ASSAA	(공란)

AED, IBK 옵션과 동시에 사용 가능합니다.

NEW-007 인쿼리 자동 파싱 - 개요 및 사용법 ▼

기능 설명

인쿼리(견적 요청) 텍스트를 붙여넣으면 선박명, 항구, 유종, 수량, 가격, 결제조건 등을 자동으로 추출하여 바이어/셀러 주문을 생성합니다. 수작업 입력 없이 복사+붙여넣기만으로 주문이 만들어집니다.

사용 방법

바이어 관리 페이지에서 "인쿼리 파싱" 버튼 클릭
인쿼리 텍스트를 입력창에 복사+붙여넣기
"파싱" 버튼 클릭
자동 추출된 정보를 확인 (선박명, 항구, 유종, 가격 등)
필요 시 수정 후 "주문 등록" 클릭

필수 입력 항목

아래 7개 항목은 반드시 포함되어야 합니다. 하나라도 빠지면 파싱이 실패합니다.

#	항목	키워드	예시
1	선박명	`VESSEL NAME:`	`VESSEL NAME: DIAMOND SEA`
2	IMO	`IMO :`	`IMO : 9112233`
3	항구	`DELIVERY PORT/AREA NAME:`	`DELIVERY PORT/AREA NAME: BUSAN`
4	공급일	`DELIVERY WINDOW:`	`DELIVERY WINDOW: 15-17TH MAR 2026`
5	유종 + 수량	(유종명 : 수량MT)	`VLSFO : 100MT` (최소 1개)
6	바이어	`바이어 :` 또는 `BUYER :`	`바이어 : 홍콩이마린 1400 (30DDD)`
7	셀러	`셀러 :` 또는 `SELLER :`	`셀러 : 금진 1300 (7DDD)`

선택 입력 항목

아래 항목은 없어도 파싱이 성공합니다. 있으면 자동으로 입력됩니다.

항목	키워드	예시
에이전트 업체	`AGENT :`	`AGENT : GLOBAL OFFSHORE MARINE SERVICE`
에이전트 전화	`T.`	`T.+82 51 715 9679`
에이전트 이메일	`E-mail :`	`E-mail : ops@globaloms.co.kr`
에이전트 담당자	`AGENT NAME :`	`AGENT NAME : CHOI, SUNG HO`
서플라이어	`서플 :`	`서플 : Roins`
비고	`비고 :` 또는 `REMARK :`	`비고 : STEM CONFIRMED`

최소 입력 예시 (필수 항목만)

VESSEL NAME: SEA PIONEER
IMO : 9334567
DELIVERY PORT/AREA NAME: BUSAN
DELIVERY WINDOW: 10-12TH APR 2026
VLSFO : 100MT
바이어 : 홍콩이마린 1400 (30DDD)
셀러 : 금진 1300 (7DDD)

위 7줄만 있으면 주문이 생성됩니다. 에이전트, 서플라이어, 비고는 나중에 웹에서 수동 입력 가능합니다.

파싱 실패 시 확인 사항

에러 메시지	원인	해결
선박명을 찾을 수 없습니다	`VESSEL NAME:` 누락	텍스트에 선박명 추가
IMO를 찾을 수 없습니다	`IMO :` 누락	IMO 번호 추가 (숫자만)
항구를 찾을 수 없습니다	`DELIVERY PORT:` 누락	항구명 추가
공급일을 찾을 수 없습니다	`DELIVERY WINDOW:` 누락	날짜 범위 추가
유종 정보가 없습니다	유종 라인 누락	`VLSFO : 100MT` 형식 추가
바이어 정보가 없습니다	`바이어 :` 누락	바이어 업체+가격+결제조건 추가
가격 개수가 유종과 불일치	유종 3개인데 가격 2개	가격을 유종 개수만큼 `/`로 구분
바이어 업체를 찾을 수 없습니다	DB에 미등록 업체	업체관리에서 먼저 등록

전체 추출 항목

항목	설명	필수
선박명 (Vessel)	선박 이름	필수
IMO	선박 고유번호 (7자리)	필수
항구 (Port)	공급 항구	필수
공급일 (Delivery Window)	공급 시작~종료일	필수
유종 + 수량	VLSFO, HSFO 등 + MT	필수
바이어 정보	업체명 + 단가 + 결제조건	필수
셀러 정보	업체명 + 단가 + 결제조건	필수
에이전트	업체명, 전화, 이메일, 담당자	선택
서플라이어	공급업체명	선택
비고	추가 메모	선택

파싱 결과는 반드시 확인 후 저장하세요. 텍스트 형식이 다르면 일부 항목이 빠질 수 있습니다.

NEW-007 인쿼리 파싱 - 입력 형식 상세 ▼

필드별 입력 형식

필드	키워드	입력 예시
선박명	`VESSEL NAME:`	`VESSEL NAME: SEA PIONEER`
IMO	`IMO :`	`IMO : 9334567`
항구	`DELIVERY PORT/AREA NAME:` 또는 `DELIVERY PORT:`	`DELIVERY PORT/AREA NAME: BUSAN`
공급일	`DELIVERY WINDOW:`	`DELIVERY WINDOW: 16-20TH MAR 2026`
유종	(유종명 : 수량MT)	`VLSFO : 100MT`
바이어	`바이어 :` 또는 `BUYER :`	`바이어 : 홍콩이마린 1400 (30DDD)`
셀러	`셀러 :` 또는 `SELLER :`	`셀러 : 금진 1300 (7DDD)`
서플라이어	`서플 :` 또는 `SUPPLIER :`	`서플 : Roins`
에이전트	`AGENT :`	`AGENT : GLOBAL OFFSHORE MARINE SERVICE`
전화	`T.` 또는 `TEL`	`T.+82 51 715 9679`
이메일	`E-mail :`	`E-mail : ops@globaloms.co.kr`
담당자	`AGENT NAME :`	`AGENT NAME : SONG, HYO SUNG`
비고	`비고 :` 또는 `REMARK :`	`비고 : STEM CONFIRMED`

공급일(Delivery Window) 형식

날짜 범위를 입력합니다. 서수 접미사(ST, ND, RD, TH)는 자동으로 제거됩니다.

입력 예시	파싱 결과
`16-20TH MAR 2026`	2026-03-16 ~ 2026-03-20
`1-3RD AUG 2026`	2026-08-01 ~ 2026-08-03
`10-12TH APR 2026`	2026-04-10 ~ 2026-04-12

키워드는 대소문자를 구분하지 않습니다. vessel name:이나 VESSEL NAME: 모두 인식됩니다.

NEW-007 인쿼리 파싱 - 유종 / 규격 / 수량 ▼

지원 유종

아래 유종을 인식합니다. 규격은 자동으로 ISO 8217 규격으로 변환됩니다.

유종	입력 예시	자동 변환 규격
VLSFO	`VLSFO : 100MT`	ISO 8217:2010 RMG 380 Max 0.5% S
VLSFO 180VIS	`VLSFO 180VIS : 55MT`	ISO 8217:2010 RMG 380 Max 0.5% S, Max 180 Vis.
HSFO 380CST	`HSFO 380CST : 200MT`	ISO 8217:2010 RMG 380 Max 3.5% S
HSFO 500CST	`HSFO 500CST : 150MT`	ISO 8217:2010 RMK 500 Max 3.5% S
HSFO 700CST	`HSFO 700CST : 100MT`	ISO 8217:2010 RMK 700 Max 3.5% S
LSMGO	`LSMGO : 22MT`	ISO 8217:2010 DMA Max 0.1% S
LSMGO 0.5%	`LSMGO 0.5% : 30MT`	ISO 8217:2010 DMA Max 0.5% S
MGO	`MGO : 50MT`	ISO 8217:2010 DMA
MDO	`MDO : 80MT`	ISO 8217:2010 DMB

수량 입력 형식

형식	입력 예시	파싱 결과
고정 수량	`VLSFO : 100MT`	최소=100, 최대=100, 확정=100
범위 (~ 사용)	`VLSFO : 55~100MT`	최소=55, 최대=100, 확정=(비움)
범위 (- 사용)	`VLSFO : 55-100MT`	최소=55, 최대=100, 확정=(비움)

MT 단위는 생략 가능합니다. VLSFO : 100도 인식됩니다.

NEW-007 인쿼리 파싱 - 가격 / 결제조건 ▼

가격 입력 형식

바이어/셀러 라인에서 업체명 뒤에 가격을 입력합니다. 유종이 여러 개면 /로 구분합니다.

형식	입력 예시	파싱 결과
단일 가격	`홍콩이마린 1400 (30DDD)`	유종1: $1,400
복수 가격	`홍콩이마린 1370/1620 (30DDD)`	유종1: $1,370 / 유종2: $1,620
3개 가격	`홍콩이마린 1400/1650/1800 (30DDD)`	유종1~3 순서대로
추가비용 포함	`홍콩이마린 1400+500 (30DDD)`	유종: $1,400 + Barge Charge: $500
복수 가격+추가비용	`홍콩이마린 1370/1620+500 (30DDD)`	유종1: $1,370 / 유종2: $1,620 + Barge: $500

가격 개수와 유종 개수가 일치해야 합니다. 유종 3개인데 가격 2개면 에러가 발생합니다.

결제조건 (Payment Terms)

입력	의미
`(7DDD)`	공급일 기준 7일 후 결제
`(15DDD)`	공급일 기준 15일 후 결제
`(30DDD)`	공급일 기준 30일 후 결제
`(45DDD)`	공급일 기준 45일 후 결제
`(60DDD)`	공급일 기준 60일 후 결제
`(90DDD)`	공급일 기준 90일 후 결제
`(CIA)`	Cash In Advance (선불)
`(COD)`	Cash On Delivery (공급 시 결제)

NEW-007 인쿼리 파싱 - 업체명 매핑 (한국어 약칭) ▼

한국어 약칭 자동 매핑

자주 사용하는 업체는 한국어 약칭으로 입력해도 자동으로 정식 영문명으로 매핑됩니다.

한국어 약칭	자동 매핑 영문명
홍콩이마린	HONGKONG E-MARINE ...
금진	KEUMJIN ...
동림	DONGRIM PETROLEUM ...
프라임	PRIME BUNKER ...
로인스	ROINS ...
글로벌오프쇼어	GLOBAL OFFSHORE ...
코모션	COMOCEAN ...
파노코	PANOCO ...
옥주	OJ PETRO SALES CO., LTD.
포우처	FOUCHER TRADE LIMITED FZE
페트라	PETRA PRIME SHIPPING FZE

영문 정식명 직접 입력

한국어 약칭이 등록되지 않은 업체는 영문명을 직접 입력하면 됩니다.

바이어 : HONGKONG E-MARINE SUPPLY SERVICE CORP., LTD. 1400 (30DDD)
셀러 : KEUMJIN MARINE CO., LTD. 1300 (7DDD)

NEW-007 인쿼리 파싱 - 에이전트 정보 ▼

에이전트 입력 형식

에이전트 정보는 선택 사항이며, 여러 줄에 걸쳐 입력합니다.

AGENT : GLOBAL OFFSHORE MARINE SERVICE
T.+82 51 715 9679
E-mail : ops@globaloms.co.kr
AGENT NAME : SONG, HYO SUNG

항목	키워드	예시	필수
업체명	`AGENT :`	GLOBAL OFFSHORE MARINE SERVICE	AGENT 입력 시 필수
전화번호	`T.` 또는 `TEL`	+82 51 715 9679	선택
이메일	`E-mail :`	ops@globaloms.co.kr	선택
담당자명	`AGENT NAME :`	`AGENT NAME : SONG, HYO SUNG`	선택

에이전트 전체를 생략해도 파싱은 정상 동작합니다. 에이전트 없는 인쿼리도 지원됩니다.

NEW-007 인쿼리 파싱 - 전체 입력 예시 ▼

예시 1: 기본 (유종 1개)

VESSEL NAME: SEA PIONEER
IMO : 9334567
DELIVERY PORT/AREA NAME: BUSAN
DELIVERY WINDOW: 10-12TH APR 2026
VLSFO 0.5% : 100MT
바이어 : 홍콩이마린 1400 (30DDD)
셀러 : 금진 1300 (7DDD)

예시 2: 유종 2개 + 추가비용 + 에이전트

VESSEL NAME: TONG RUN 7
IMO : 9673563
DELIVERY PORT/AREA NAME: BUSAN
DELIVERY WINDOW: 16-20TH MAR 2026
VLSFO : 55MT
LSMGO : 22MT
바이어 : HONGKONG E-MARINE SUPPLY SERVICE CORP., LTD. 1370/1620+500 (30DDD)
셀러 : KEUMJIN MARINE CO., LTD. 1290/1540+500 (7DDD)
서플 : Roins
AGENT : GLOBAL OFFSHORE MARINE SERVICE
T.+82 51 715 9679
E-mail : ops@globaloms.co.kr
AGENT NAME : SONG, HYO SUNG

예시 3: 유종 3개 + 수량 범위 + 비고

VESSEL NAME: XIN SHENG SHENG 6
IMO : 8358013
DELIVERY PORT/AREA NAME: YOSU
DELIVERY WINDOW: 01-03RD AUG 2026
HSFO 380CST : 200MT
VLSFO 180VIS : 55~100MT
LSMGO 0.1% : 22~50MT
바이어 : 홍콩이마린 1400/1650/1800+500 (30DDD)
셀러 : 동림 1300/1550/1700+500 (7DDD)
서플 : Roins
AGENT : GLOBAL OFFSHORE MARINE SERVICE
T.+82 51 715 9679
E-mail : ops@globaloms.co.kr
AGENT NAME : SONG, HYO SUNG
비고 : STEM CONFIRMED

주의사항:
- 가격 개수 = 유종 개수여야 합니다 (유종 3개면 가격도 3개: 1400/1650/1800)
- IMO는 숫자만 입력 (7자리)
- 결제조건은 반드시 괄호로 감싸야 합니다: (30DDD)

NEW-013 ETA 필드 + 3단계 DDD 자동 계산 ▼

기능 설명

주문 상세에 ETA(선박 도착 예정일) 필드가 추가되었습니다. ETA, 공급예정일, 공급확정일 중 하나가 변경되면 지급기한일(PayDueDate)이 자동으로 재계산됩니다.

사용 방법

바이어 관리 → 주문 클릭 → 상세 팝업 열기
ETA 날짜 입력 (공급요청일과 최종완료일 사이에 위치)
날짜 선택 즉시 → 지급기한일이 자동 갱신됨
저장하면 ETA 값이 DB에 저장됨

지급기한일 계산 우선순위

아래 순서로 기준일을 선택하여 DDD를 계산합니다. 상위 값이 있으면 하위 값은 무시됩니다.

우선순위	기준일	설명
1순위	공급확정일 (SupplyCompleteDate)	실제 공급이 완료된 날짜
2순위	공급예정일 (EstSupplyStartDate)	공급 예정 시작일
3순위	ETA (선박 도착 예정일)	선박이 항구에 도착하는 예정일
4순위	공급요청일 (ReqSupplyStartDate)	바이어가 요청한 공급일

계산 예시 (30DDD, 홍콩 선사)

기준일	+29일	주말/공휴일 조정	최종 지급기한일
ETA: 2026-04-04	2026-05-03 (일)	-1일=토 → -1일=금(5/1 노동절) → -1일	2026-04-30 (목)

공휴일 자동 반영

선사(ShipCompany)의 국가별 공휴일이 자동으로 반영됩니다. 100개국 이상 지원되며, 외부 API(Nager.Date)에서 실시간으로 공휴일 데이터를 가져옵니다.

국가	반영 공휴일 예시
한국 (KOR)	설날, 추석, 광복절, 한글날 등
홍콩 (HKG)	노동절(5/1), 국경절, 중추절 등
UAE (ARE)	이슬람 공휴일, 국경일 등
싱가포르 (SGP)	National Day, Deepavali 등

자동 트리거: ETA, 공급예정일, 공급확정일 중 하나만 변경해도 지급기한일이 즉시 재계산됩니다. PayType(결제유형) 변경 시에도 재계산됩니다.

NEW-015 주문 수정 이력 로그 ▼

기능 설명

주문을 수정할 때마다 누가, 언제, 무엇을 변경했는지 자동으로 기록됩니다. "변경 이력" 버튼을 클릭하면 전체 수정 내역을 확인할 수 있습니다.

수정자 표시

주문 상세 상단의 "최근 업데이트" 옆에 마지막 수정자 이름이 표시됩니다.

최근 업데이트 하지혁 2026.03.31 13:17

변경 이력 확인 방법

바이어 관리 → 주문 클릭 → 상세 팝업 열기
상단의 "변경 이력" 버튼 클릭
팝업에 수정 내역 목록이 표시됨 (일시, 수정자, 내용)

변경 이력 예시

일시	수정자	내용
2026.03.31 13:17	하지혁	주문 생성
2026.03.31 14:00	하지혁	ETA: 2026-04-04
2026.03.31 15:30	김동현	VLSFO 확정수량: 50 → 100, 항구: BUSAN → YOSU
2026.03.31 16:00	하지혁	인보이스 발송
2026.03.31 16:30	하지혁	노미네이션 발송

자동 추적되는 항목

카테고리	항목
주문 기본	상태, ETA, 공급요청일, 공급예정일, 공급완료일, 항구, 주문유형, 거래유형, 벙커온리, 요청사항
업체/담당	에이전트, 에이전트 담당자/연락처/이메일, 선사 담당자/연락처/이메일
결제	결제유형, 지급기한, 지급완료일, 인보이스 발신, 세금계산서 발행, BDR 수신
유종	확정수량, 매출단가, 매입단가, 최소/최대수량, 생산자, BDR 발행자
판매업체	판매사, 판매담당자/연락처/이메일
바지선	바지 업체, 바지 담당자, 바지선명
공급 일정	출하예정일, 출하일, 공급완료일(유종별)
발송	인보이스 발송, 노미네이션 발송, 확인서 발송, 메일 발송

변경 이력은 EF Core ChangeTracker를 사용하여 자동 감지됩니다. 새 필드가 추가되어도 자동으로 추적됩니다. 변경 없이 저장하면 "주문 수정"으로 기록됩니다.

NEW-018 서류(PDF/이미지) 편집기 - 사용법 ▼

기능 설명

BDR, 인보이스 등 서류 PDF/이미지에서 특정 내용(업체명, 선박명, 워터마크 등)을 지워서 수정본을 만듭니다. 외부 편집 도구 없이 인트라넷에서 바로 편집 가능합니다.

편집기 열기

바이어 관리 또는 셀러 관리 → 주문 상세 열기
서류관리 → 서류보기에서 PDF/이미지 파일 확인
파일 옆의 연필(✎) 아이콘 클릭
편집 모달이 열리면서 해당 파일이 자동으로 로드됨

파일 직접 선택 (로컬 파일)

편집 모달에서 "파일" 버튼 클릭
내 컴퓨터에서 PDF 또는 이미지 파일 선택
파일이 캔버스에 로드됨

지원 파일 형식

형식	확장자	비고
PDF	.pdf	멀티페이지 지원 (모든 페이지 세로로 표시)
이미지	.png, .jpg, .jpeg	단일 이미지

PDF는 브라우저에서 직접 렌더링됩니다 (서버 의존 없음). 멀티페이지 PDF는 모든 페이지가 세로로 이어붙여져 표시됩니다.

NEW-018 서류 편집기 - 편집 모드 상세 ▼

브러시 모드 (자유 칠하기)

항목	설명
활성화	"브러시" 버튼 클릭
사용법	마우스로 클릭+드래그하여 칠하기
브러시 크기	슬라이더로 5~80px 조절 (기본 25px)
표시	빨간 하이라이트로 표시 (실제 지우기는 저장 시)

사각형 모드 (영역 선택)

항목	설명
활성화	"사각형" 버튼 클릭
사용법	시작점 클릭 → 끝점까지 드래그 → 사각형 영역 선택
최소 크기	5x5 픽셀
표시	빨간 반투명 사각형으로 표시

색상지정 모드 (워터마크 제거용)

항목	설명
활성화	"색상지정" 버튼 클릭
사용법	문서에서 배경색 부분을 클릭 → 그 색으로 지우기 색상 고정
용도	워터마크가 심한 문서에서 자동 배경 추출이 잘 안 될 때 사용
해제	다른 모드(브러시/사각형)로 전환하면 자동 배경 모드로 복귀

되돌리기 / 초기화

기능	동작
"되돌리기" 버튼	마지막 브러시 스트로크 / 사각형 1개를 취소 (최대 30회)
"초기화" 버튼	모든 편집 내용을 지우고 원본 상태로 복원

NEW-018 서류 편집기 - 저장 및 파일명 규칙 ▼

저장 방법

편집 완료 후 "저장" 버튼 클릭
빨간 하이라이트 영역이 주변 배경색으로 자동 채워짐
원본 파일은 유지되고, 편집본이 새 파일로 추가됨
서류보기 목록에 편집본이 새로 나타남

지우기 알고리즘

모드	동작 방식
자동 배경 (기본)	빨간 영역의 각 픽셀마다 주변 반경을 확장하며 배경 픽셀 30개를 수집 → RGB 평균값으로 채움. 글자(밝기 350 이하)는 건너뜀
색상지정 모드	사용자가 클릭한 색상으로 단색 채움. 워터마크가 심한 문서에서 유용

파일명 규칙

원본 파일명	편집본 파일명
`_BDR_20260326A9PP.pdf`	`_BDR_20260326A9PPE.pdf`
이미 E가 있는 경우	`_BDR_20260326A9PPE2.pdf`
E2도 있으면	`_BDR_20260326A9PPE3.pdf`

저장 형식

원본 형식	저장 형식
PDF (단일/멀티페이지)	PDF (멀티페이지 유지)
PNG / JPG	원본과 동일 형식

편집본은 새 파일로 생성되므로 원본은 절대 변경되지 않습니다. 안심하고 편집하세요.

EXT-API 외부 인쿼리 API (자동 주문 생성) ▼

기능 설명

외부 시스템에서 인쿼리 텍스트를 HTTP API로 전송하면, 웹에서 인쿼리 파싱 → 주문 등록하는 것과 동일하게 바이어 주문 + 셀러 주문이 자동 생성됩니다. 내부적으로 웹과 같은 API를 순서대로 호출하므로 결과가 100% 동일합니다.

API 정보

항목	값
URL	`POST https://api.seanergyp.com/api/ExternalInquiry/Create`
인증	헤더 `X-Api-Key: 발급받은키`
Content-Type	`application/json; charset=utf-8`
본문	JSON `{"text": "인쿼리 텍스트"}`

요청 본문 형식

JSON 객체에 text 필드 하나만 넣으면 됩니다. 줄바꿈은 \n으로 구분합니다.

{
  "text": "VESSEL NAME: DIAMOND SEA\n
IMO : 9112233\n
DELIVERY PORT/AREA NAME: YOSU\n
DELIVERY WINDOW: 15-17TH MAR 2026\n
HSFO 380CST : 400MT\n
VLSFO : 100MT\n
LSMGO 0.1% : 30MT\n
바이어 : 홍콩이마린 1350/1550/1750+800 (30DDD)\n
셀러 : 동림 1250/1450/1650+500 (7DDD)\n
AGENT : GLOBAL OFFSHORE MARINE SERVICE\n
T.+82 51 715 9679\n
E-mail : ops@globaloms.co.kr\n
AGENT NAME : CHOI, SUNG HO\n
비고 : STEM CONFIRMED"
}

호출 예시 (curl)

curl -X POST \
  https://api.seanergyp.com/api/ExternalInquiry/Create \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "X-Api-Key: sk-sngy-8f2a4c6e9b1d3f5a7c0e2b4d" \
  -d '{"text":"VESSEL NAME: DIAMOND SEA\nIMO..."}'

호출 예시 (PowerShell)

$body = @{
  text = "VESSEL NAME: DIAMOND SEA`n" +
         "IMO : 9112233`n" +
         "DELIVERY PORT/AREA NAME: YOSU`n" +
         "DELIVERY WINDOW: 15-17TH MAR 2026`n" +
         "HSFO 380CST : 400MT`n" +
         "VLSFO : 100MT`n" +
         "LSMGO 0.1% : 30MT`n" +
         "바이어 : 홍콩이마린 1350/1550/1750+800 (30DDD)`n" +
         "셀러 : 동림 1250/1450/1650+500 (7DDD)`n" +
         "AGENT : GLOBAL OFFSHORE MARINE SERVICE`n" +
         "T.+82 51 715 9679`n" +
         "E-mail : ops@globaloms.co.kr`n" +
         "AGENT NAME : CHOI, SUNG HO`n" +
         "비고 : STEM CONFIRMED"
} | ConvertTo-Json

Invoke-RestMethod `
  -Method POST `
  -Uri "https://api.seanergyp.com/api/ExternalInquiry/Create" `
  -ContentType "application/json; charset=utf-8" `
  -Headers @{"X-Api-Key"="sk-sngy-8f2a4c6e9b1d3f5a7c0e2b4d"} `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

호출 예시 (Python)

import requests

url = "https://api.seanergyp.com/api/ExternalInquiry/Create"
headers = {
    "X-Api-Key": "sk-sngy-8f2a4c6e9b1d3f5a7c0e2b4d",
    "Content-Type": "application/json; charset=utf-8"
}
data = {
    "text": """VESSEL NAME: DIAMOND SEA
IMO : 9112233
DELIVERY PORT/AREA NAME: YOSU
DELIVERY WINDOW: 15-17TH MAR 2026
HSFO 380CST : 400MT
VLSFO : 100MT
LSMGO 0.1% : 30MT
바이어 : 홍콩이마린 1350/1550/1750+800 (30DDD)
셀러 : 동림 1250/1450/1650+500 (7DDD)
AGENT : GLOBAL OFFSHORE MARINE SERVICE
T.+82 51 715 9679
E-mail : ops@globaloms.co.kr
AGENT NAME : CHOI, SUNG HO
비고 : STEM CONFIRMED"""
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

응답 예시 (성공)

{
  "code": 200,
  "message": "주문 생성 완료",
  "data": {
    "orderId": "20260331WMQG",
    "vesselName": "DIAMOND SEA",
    "port": "YOSU",
    "buyerCompany": "홍콩이마린",
    "sellerCompany": "동림",
    "oilCount": 3,
    "payType": "30DDD",
    "buyerPayDueDate": "2026-04-13",
    "sellerPayDueDate": "2026-03-23"
  }
}

응답 필드 설명

필드	설명
`orderId`	생성된 주문번호 (바이어 관리에서 조회 가능)
`vesselName`	파싱된 선박명
`port`	파싱된 항구명
`buyerCompany`	매칭된 바이어 업체명
`sellerCompany`	매칭된 셀러 업체명
`oilCount`	유종 개수
`payType`	결제유형 (30DDD, 7DDD, CIA 등)
`buyerPayDueDate`	바이어 지급기한일
`sellerPayDueDate`	셀러 지급기한일

응답 예시 (실패)

// API Key 없거나 틀림
{"code": 401, "message": "유효하지 않은 API Key입니다."}

// 텍스트 비어있음
{"code": 400, "message": "텍스트가 비어있습니다."}

// 파싱 실패 (필수 항목 누락)
{"code": 400, "message": "파싱 실패",
 "errors": ["선박명(VESSEL NAME)을 찾을 수 없습니다."]}

// 업체를 DB에서 못 찾음
{"code": 400,
 "message": "바이어 업체를 찾을 수 없습니다: ABC Trading"}

텍스트 입력 규칙

인쿼리 파싱과 동일한 형식입니다. 자세한 내용은 위의 입력 형식 상세, 유종/규격/수량, 가격/결제조건, 전체 입력 예시를 참고하세요.

자동 생성되는 항목

항목	설명
바이어 주문	유종, 가격, 수량, 에이전트, 결제유형 전부 포함
셀러 주문	판매업체 자동 연결, 셀러 단가 입력
추가비용	+500 → BARGE CHARGE 매출/매입 자동 분리 생성
지급기한일	DDD 자동 계산 (공휴일 100개국 반영, 주말 제외)
에이전트	업체명, 담당자, 전화번호, 이메일 자동 입력
선박	DB에 없으면 자동 생성 (선박명 + IMO)

동시 호출

여러 요청이 동시에 들어와도 순차적으로 1건씩 처리됩니다. 주문번호 중복이 발생하지 않습니다.

API Key 관리

작업	방법
새 키 발급	DB `ExternalApi` 테이블에 INSERT 1줄
키 폐기	해당 행 DELETE
업체별 별도 키	같은 구조로 행 추가, `AuthKey01`만 다르게
키 유출 시	즉시 DELETE 후 새 키 INSERT

API Key 발급 시 DB에 주문 등록자/담당자 설정도 함께 필요합니다. 자세한 INSERT SQL과 GUID 확인 방법은 배포 가이드 → DB 마이그레이션 → 외부 API Key 등록을 참고하세요.

보안 주의:
- API Key는 비밀번호와 같습니다. 절대 공개하지 마세요.
- 반드시 HTTPS로만 호출하세요.
- 키가 유출되면 즉시 DB에서 삭제하고 새 키를 발급하세요.