VibeFox ShipStation for PrestaShop — 도움말

요구 사항

PrestaShop: 8.0~9.x.

PHP: 8.0 이상. 모듈은 이전 PHP 버전에는 설치되지 않습니다.

ShipStation 계정: ShipStation에서 운송업체를 연결한 다음(Settings > Shipping > Carriers), ShipStation > Settings > Account > API Settings에서 API Key와 API Secret을 복사하십시오. API 접근 권한은 ShipStation 요금제에 따라 다릅니다. 이 페이지를 사용할 수 없다면 요금제에 API 접근이 포함되지 않은 것입니다. 이 모듈은 ShipStation API V1(API Key와 API Secret)을 사용합니다. API 키가 하나뿐인 ShipStation API V2 계정은 지원되지 않습니다. 키가 없으면 대체 배송비만 사용됩니다.

VibeFox 라이선스 키: vibefox.net에서 구매합니다. 키 하나는 도메인 하나에서 사용할 수 있습니다.

설치

1. 백오피스에서 Modules > Module Manager로 이동하여 Upload a module을 클릭하십시오. 모듈의 ZIP 파일을 선택하십시오.

2. 업로드가 끝나면 Configure를 클릭하십시오. 나중에 하려면 모듈 목록에서 VibeFox ShipStation을 찾아 Configure를 클릭하십시오.

3. VibeFox 라이선스 키를 Configure 페이지 상단의 라이선스 블록에 있는 License key에 입력하고 Activate를 클릭하십시오(라이선스 키 참조).

4. API Key와 API Secret을 붙여 넣고, 출고지 우편번호를 입력한 다음 Save를 클릭하십시오. 이제 페이지에 계정의 운송업체 코드가 표시됩니다. 사용할 코드를 Carrier codes에 입력하고 다시 저장하십시오.

5. 쇼핑몰의 기본 통화가 ShipStation 계정의 통화와 다르면 Exchange rate를 설정하십시오.

6. 선택 사항으로 대체 배송비를 입력하십시오.

설치 시 모듈은 배송 소요 시간 텍스트 ShipStation carriers (USPS, UPS, FedEx, ...)와 함께 운송업체 ShipStation Shipping을 만듭니다. 운송업체는 모든 배송 지역과 모든 고객 그룹에 할당됩니다. 배송 지역, 고객 그룹, 배송 소요 시간, 로고, 크기 제한은 Shipping > Carriers에서 변경할 수 있습니다. 그곳에서 가격을 설정하지 마십시오. 가격은 항상 모듈에서 가져옵니다.

설정

모든 설정은 모듈 페이지에 있습니다: Modules > Module Manager > VibeFox ShipStation > Configure. 각 섹션에는 자체 Save 버튼이 있으며, 이 버튼은 페이지 전체를 저장합니다. 저장할 때마다 캐시된 ShipStation 요금이 지워지고 API Key와 API Secret을 확인합니다. 그런 다음 페이지에 계정에 연결된 운송업체와 코드가 표시됩니다. 예: "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)".

페이지 상단의 경고는 실시간 요금이 작동할 수 없는 경우를 알려 줍니다. 키가 없음, 운송업체 코드가 없음, 출고지 우편번호가 없음, 환율이 없음, 연결 확인 실패, 또는 계정에 연결되지 않은 운송업체 코드가 있는 경우입니다. 쇼핑몰의 무게 또는 크기 단위를 모듈이 변환할 수 없는 경우에도 경고가 표시됩니다. International > Localization(Local units)에서 kg, g, lb 또는 oz와 cm, mm, m 또는 in을 설정하십시오. 음수 값이나 숫자가 아닌 텍스트가 입력된 숫자 필드, 또는 Maximum weight보다 큰 Minimum weight는 오류로 표시되며 아무것도 저장되지 않습니다.

일반

Enable ShipStation shipping: 운송업체를 켜거나 끕니다. Shipping > Carriers의 운송업체 상태와 같은 스위치입니다.

Name: 체크아웃에서 고객에게 표시되는 운송업체 이름입니다. 기본값: ShipStation Shipping. 필수 항목이며 최대 64자입니다.

Tax: 운송업체의 세금 규칙 또는 No tax. ShipStation 요금에는 판매세가 포함되지 않습니다. No tax는 견적 그대로 표시합니다. 세금 규칙을 선택하면 세금 규칙에 따라 배송비에 세금이 추가됩니다.

ShipStation 계정

API Key: ShipStation > Settings > Account > API Settings의 API Key입니다. ShipStation으로만 전송되며 절대 기록되지 않습니다. 저장한 후 이 필드는 비워지고 Saved — leave empty to keep it.을 표시합니다. 변경하려는 경우에만 새 값을 입력하십시오.

API Secret: 같은 페이지의 API Secret입니다. 키와 같은 방식으로 보관됩니다.

Remove the saved API key and secret: 키가 저장되면 나타납니다. 체크한 후 저장하면 둘 다 삭제됩니다.

Carrier codes: 쉼표로 구분된 ShipStation 운송업체 코드 하나 이상(예: stamps_com, ups_walleted). 최대 5개 코드가 사용되며, 운송업체마다 API 요청이 한 번씩 이루어집니다. 더 많이 입력하면 처음 5개만 유지되며, 페이지에서 이를 알려 줍니다. 이 운송업체들 중 가장 저렴한 요금이 표시됩니다. 코드는 저장 후 표시되는 목록에서 가져오십시오.

Allowed services: 선택 사항. 쉼표로 구분된 ShipStation 서비스 코드(예: usps_priority_mail, ups_ground). 비워 두면 위의 운송업체 중 가장 저렴한 서비스가 표시됩니다.

Package code: "package"(기본값)는 사용자의 상자를 기준으로 요금을 계산하며, 운송업체의 봉투와 정액 상자는 제외합니다. 비워 두면 운송업체가 제공하는 모든 패키지 유형의 요금을 계산합니다.

출고지

Ship-from postal code: 실시간 요금에 필요합니다. ShipStation은 우편번호만으로 요금을 계산하며, 이 우편번호는 ShipStation 계정의 국가 안에 있어야 합니다. 비워 두면 Shop Parameters > Contact > Stores의 쇼핑몰 우편번호를 사용합니다.

요금

Parcels: 장바구니가 ShipStation으로 전송되는 방식입니다.

ShipStation account currency: ShipStation이 요금을 반환하는 통화입니다: USD, CAD, GBP, AUD, NZD 또는 EUR. 기본값: USD(미국 계정).

Exchange rate: 계정 통화 1단위의 쇼핑몰 기본 통화 가격입니다(예: 0.92). 기본 통화가 계정 통화와 다를 때만 필요합니다. 설정하지 않으면 실시간 요금은 사용되지 않고 대체 배송비가 적용됩니다. 환율은 자동으로 업데이트되지 않습니다.

대체 배송비(실시간 요금이 없을 때 사용됩니다: API 키가 없음, ShipStation에 연결할 수 없음, 주소에 대한 운송업체 요금이 없음. 가격은 쇼핑몰의 기본 통화입니다. 이 경우 운송업체를 숨기려면 표와 Other countries를 비워 두십시오)

Prices by country: 국가별 기본 요금과 소포 무게별 크기 열이 있는 표입니다: XS ≤ 1 kg, S ≤ 2 kg, M ≤ 3 kg, L ≤ 5 kg, XL > 5 kg. 행을 추가하려면 Add country를, 행을 삭제하려면 휴지통 아이콘을 클릭하십시오. 크기를 비워 두면 기본 요금을 사용합니다. 기본 요금이 0이면 무료 배송입니다. * Default (all other countries) 행은 자체 행이 없는 국가에 적용됩니다. 가격이 전혀 없는 행은 저장되지 않습니다.

Other countries: 표에 해당 국가의 가격이 없을 때 적용되는 요금입니다. 이 경우 운송업체를 숨기려면 비워 두십시오.

조건

Free shipping from: 무료 배송이 시작되는 장바구니 소계(할인 후, 세금 전)입니다. 이 경우 ShipStation에 요청하지 않습니다. 비활성화하려면 비워 두십시오.

Minimum subtotal: 장바구니 소계(할인 후, 세금 전)가 이 금액 이상일 때만 운송업체를 표시합니다. 항상 표시하려면 비워 두십시오.

Minimum weight: 운송업체를 표시하기 위한 최소 장바구니 무게이며, 쇼핑몰의 무게 단위로 입력합니다. 0은 제한 없음을 의미합니다.

Maximum weight: 장바구니 무게가 이 값을 초과하면 운송업체를 숨깁니다. 쇼핑몰의 무게 단위로 입력합니다. 0은 제한 없음을 의미합니다.

배송 지역 없이 이용 가능 여부

보통 운송업체는 Shipping > Carriers에서 설정한 지역에서 제공됩니다. 대신 국가별로 제공할 수도 있습니다.

Ignore shipping zones: 아래에 지정한 국가에 대해 해당 지역이 할당되었는지와 관계없이 운송업체를 제공합니다. 켜져 있는 동안 운송업체는 나중에 만든 지역을 포함한 모든 지역에 추가됩니다. 끄면 추가된 지역이 제거됩니다.

Countries: 이 모드의 배송 대상 국가입니다. 비워 두면 쇼핑몰의 활성 국가 전체를 사용합니다. 이 필드는 Ignore shipping zones가 켜져 있을 때만 사용됩니다.

고급

Debug log: ShipStation 요청을 모듈 폴더의 logs/vfd_shst_debug.log.php에 기록합니다. 이 파일은 웹에서 열 수 없습니다. API 오류는 이 옵션이 꺼져 있어도 항상 기록됩니다. API Key, API Secret, 고객 주소는 절대 기록되지 않습니다. 우편번호는 마스킹됩니다.

Log: 로그의 크기와 최신 항목을 표시합니다. 비우려면 Clear log를 클릭하십시오.

Remove data on uninstall: 켜져 있으면 모듈을 제거할 때 설정, 운송업체, 로그, 주문과 함께 저장된 ShipStation 서비스가 삭제됩니다. 꺼져 있으면 다시 설치할 수 있도록 모든 내용이 유지됩니다.

체크아웃에서의 작동 방식

배송 단계에서 PrestaShop은 모듈에 가격을 요청합니다. 실물 상품만 계산에 포함됩니다. 가상 상품은 무게를 더하지 않으며 소계에도 포함되지 않습니다. 모듈은 먼저 조건을 확인합니다: 허용된 국가(Ignore shipping zones 포함), 장바구니 무게, 최소 소계. 무료 배송이 적용되면 운송업체는 0원으로 표시되며 ShipStation에 요청을 보내지 않습니다.

그다음 모듈은 ShipStation에 출고지 우편번호, 목적지 국가, 시/도, 도시, 우편번호, 소포 무게, 상자 크기를 보냅니다. 고객이 우편번호를 입력하기 전에는 요청하지 않습니다. 우편번호가 없는 국가는 대체 배송비를 받습니다. 상품은 한 상자에 담깁니다. 상품에 크기 정보가 없으면 무게만으로 소포 요금을 계산합니다.

운송업체 코드마다 ShipStation에 한 번씩 요청합니다. 모듈은 허용된 요금 중 가장 저렴한 것을 사용하고, 이를 쇼핑몰의 기본 통화로 환산합니다. 그런 다음 가격을 고객의 장바구니 통화로 표시합니다.

각 응답은 1시간 동안 캐시됩니다. ShipStation이 사용할 수 있는 요금 없이 응답하면 그 결과를 10분 동안 기억합니다. ShipStation이 키를 거부하거나 연결할 수 없으면 요청을 5분 동안 일시 중지합니다. 요청 한도 초과 후에는 ShipStation이 알려 준 재설정 시간까지 일시 중지합니다. 요청 시간 제한은 12초입니다. 모듈을 비활성화하면 캐시된 요금이 지워집니다.

실시간 요금이 없으면 가격은 대체 배송비 표에서 가져온 다음 Other countries에서 가져옵니다. 둘 다 해당하지 않으면 운송업체는 숨겨집니다. 고객에게 ShipStation 오류 메시지가 표시되는 일은 없습니다. 자세한 내용은 디버그 로그에 기록됩니다.

운송업체에 주문이 있은 후 Shipping > Carriers에서 운송업체를 수정하면 PrestaShop은 이를 운송업체의 새 버전으로 저장합니다. 모듈은 새 버전을 자동으로 따릅니다.

모듈은 요금만 계산합니다. 운송장 라벨을 구매하지 않고, ShipStation에 주문이나 배송을 만들지 않으며, 소포를 추적하지 않고, 반품을 처리하지 않습니다. 픽업 장소도, 체크아웃에서 여러 서비스 중 선택하는 기능도, 주소 검증, 보험, 서명 확인, 여러 소포로 나누기, 요금 가산도 없습니다.

주문

ShipStation 실시간 요금으로 주문하면 선택한 서비스가 주문과 함께 저장됩니다. 백오피스의 주문 페이지는 이를 ShipStation 블록에 Service로 표시합니다. 예: "USPS Ground Advantage - Package". 따라서 ShipStation에서 해당 운송장 라벨을 만들 수 있습니다. 이후 장바구니를 다시 계산해도 바뀌지 않습니다. 대체 배송비나 무료 배송으로 주문된 경우에는 서비스 블록이 없습니다.

라이선스 키

이 모듈은 vibefox.net에서 받은 VibeFox 라이선스 키로 작동합니다. 라이선스 블록 License — VibeFox ShipStation은 Modules > Module Manager > VibeFox ShipStation > Configure 페이지에서 설정 위에 있는 첫 번째 블록입니다. 키를 License key에 입력하고 Activate를 클릭하십시오. 이후 블록에는 마스킹된 키, 상태(예: 라이선스 유효 기간의 마감일과 도메인)가 표시되며, 다음 버튼이 있습니다: 상태를 다시 확인하는 Check now, 다른 키를 입력하는 Change key, 이 쇼핑몰에서 키를 제거하는 Remove key. 그 아래에는 Product: presta-shipping-shipstation 줄과 vibefox.net 계정을 여는 링크 Manage licenses and domains in your account가 있습니다. 모듈의 Configure 권한이 있는 직원만 키를 변경할 수 있습니다. 블록의 문구는 백오피스 언어를 따릅니다(영어와 러시아어 포함).

키가 승인되지 않으면 블록에 이유가 표시됩니다. 예: Key not found, This key belongs to another product, Domain limit reached 또는 날짜가 포함된 License expired on. 쇼핑몰 주소를 변경한 후 또는 계정에서 도메인 슬롯을 해제한 후에는 Check now를 클릭하십시오. 라이선스 서버에 연결할 수 없으면 모듈은 마지막으로 확인된 상태로 계속 작동합니다.

키 하나는 도메인 하나에서 작동합니다. 기본 쇼핑몰의 도메인이며, 다중 스토어 설정에서도 마찬가지입니다. 쇼핑몰에서 키를 제거해도 도메인 슬롯은 해제되지 않습니다. vibefox.net 계정에서 슬롯을 해제하십시오.

유효한 키가 없으면 체크아웃에서 고객에게 ShipStation 운송업체가 표시되지 않으며 요금도 계산되지 않습니다. PrestaShop 스토어프론트는 백오피스에 로그인되어 있는지 알지 못하므로, 운송업체는 사용자에게도 숨겨집니다. 키를 구매하기 전에 모듈을 설정할 수는 있지만 체크아웃에서 테스트할 수는 없습니다. Modules > Module Manager의 Alerts 탭에 알림이 나타납니다. 기존 주문에는 영향을 주지 않습니다.

라이선스가 만료되어도 모듈은 계속 작동하지만, 업데이트와 지원에는 갱신이 필요합니다. 백오피스에서 작업하는 동안 상태는 자동으로 다시 확인됩니다. 키를 입력한 후 처음 14일 동안은 하루에 한 번, 그 이후에는 일주일에 한 번입니다. cron 작업은 필요하지 않습니다. 모듈을 제거하거나 재설정하면 라이선스 키와 라이선스 상태가 항상 삭제됩니다.

문제 해결

체크아웃에 ShipStation이 나타나지 않음: 라이선스가 활성 상태이고 Enable ShipStation shipping이 켜져 있는지 확인하십시오. Shipping > Carriers에서 운송업체가 고객 국가의 지역과 고객 그룹을 포함하는지 확인하거나, Ignore shipping zones를 켜고 Countries를 확인하십시오. 무게 제한과 Minimum subtotal도 확인하십시오. 실시간 요금이 없다면 해당 국가, * Default 또는 Other countries에 가격이 있는지 확인하십시오. 또한 상품 페이지에서 상품이 특정 운송업체로 제한되어 있을 수도 있습니다.

체크아웃에 ShipStation 요금 대신 대체 배송비가 표시됨: 모듈 페이지 상단의 경고(키, 운송업체 코드, 출고지 우편번호, 환율)를 확인하십시오. Debug log를 켜고 체크아웃을 새로 고친 다음 Log 필드를 확인하십시오. 고객의 우편번호가 필요합니다. 입력하기 전에는 요청하지 않습니다.

입력할 운송업체 코드: 키와 secret을 넣고 설정을 저장하십시오. 페이지에 계정의 운송업체 코드가 표시됩니다. 그중 하나 이상을 사용하십시오.

ShipStation 연결 확인 실패: 메시지에 이유가 표시됩니다. API Key와 API Secret을 확인한 후 다시 저장하여 확인을 반복하십시오.

요금이 ShipStation과 다름: 소포는 상품 무게와 크기로 구성되며, 상품은 한 상자에 담깁니다. 크기가 없는 상품은 무게만으로 계산됩니다. 요금은 1시간 동안 캐시됩니다. 캐시를 지우려면 모듈 페이지에서 Save를 클릭하십시오.

페이지에 ShipStation 운송업체를 찾을 수 없다고 표시됨: 운송업체가 Shipping > Carriers에서 삭제되었습니다. 다시 만들려면 Modules > Module Manager에서 모듈을 재설정하십시오.

제거

Modules > Module Manager로 이동하여 VibeFox ShipStation 옆의 메뉴를 열고 Uninstall을 선택하십시오. 라이선스 키와 라이선스 상태는 항상 삭제됩니다. 캐시된 요금과 연결 확인 결과는 항상 삭제됩니다. Remove data on uninstall이 켜져 있으면 운송업체가 삭제되고(주문은 이력을 유지합니다), 설정, 로그, 주문과 함께 저장된 서비스도 제거됩니다. 꺼져 있으면 운송업체는 비활성화만 되고, 설정과 이미 주문된 서비스는 유지됩니다. 모듈을 다시 설치하거나 Reset을 하면 운송업체는 이전 상태로 돌아갑니다.

ShipStation은 해당 소유자의 상표입니다. 이 모듈은 ShipStation과 제휴하거나 ShipStation의 승인을 받은 것이 아닙니다.