상품 가격 정보 API

ERP에서 추가한 상품의 가격을 얻기 위해서는 아래와 같은 API를 사용합니다.

https://{클라이언트 투어보드 URL}/api/products?code={ERP에 등록되어 있는 상품 코드}&start={검색 시작일}&end={검색 종료일}

검색 시작일과 종료일은 YYYY-MM-DD형태의 데이터입니다. ERP에 등록되어 있는 상품코드는 상품 페이지에서 확인 가능합니다.

 

위의 요청을 받으면 상품의 가격이 ERP로부터 리턴됩니다. prices 부분이 상품 가격이 표함된 부분이며, date이 판매 날짜로 이를 홈페이지의 가격에 반영해주면 됩니다. 추가적인 옵션이 있을 경우 price의 object 하위에 options 배열이 반환됩니다. 가격 부분에 null 값이 있는 경우는 여행사에서 가격을 올리지 않은 경우로 이 경우에는 홈페이지에서 가격을 보여주어서는 안됩니다. 예를 들어 아래의 response를 받은 경우 pricePerChild와 pricePerInfant의 가격이 null로 설정되어 있으므로, 이에 대한 가격 상세 정보를 홈페이지에서는 보여주어서는 안됩니다. 통화를 표기하려면 currency 또는 currencySymbol을 사용하여 표기하면 됩니다. tax는 %로 설정된 값입니다.

{
    "productId": "3c5aa3db-9700-4dfa-ab1b-8676b65010a8",
    "product": "캘거리 로키일주 4박 5일",
    "logoImageUrl": "/files/e146d420-deb1-44c4-bef7-b74a0cb12707/logo.png",
    "client": "Admin.",
    "currency": "CAD",
    "currencySymbol": "$",
    "checkoutEnabled": true,
    "stripePublicKey": "pk_test_51Q4tBmPKxcaIG03hCkYtRcwAhbLrgzkyGLzUln9e97FcdwOdZx8JU2WyroDL7TKbNIpXtyBoa9AOsSS5b4XcBU9I0057M1eM5E",
    "prices": [
        {
            "id": "0088e326-240d-419e-ab10-e0ef61bb279b",
            "date": "2024-10-20",
            "description": "2인 1실 기준 가격입니다",
            "pricePerAdult": 100,
            "pricePerChild": null,
            "pricePerInfant": null,
            "tax": 4.32,
            "options": []
        },
        {
            "id": "142b4039-e1a7-4290-83fc-fae2a3f851d1",
            "date": "2024-10-16",
            "description": "2인 1실 기준 가격입니다",
            "pricePerAdult": 100,
            "pricePerChild": null,
            "pricePerInfant": null,
            "tax": 4.32,
            "options": [
                {
                    "id": "266567f0-e9db-47fc-b52a-260ca0d80cc1",
                    "name": "낚시",
                    "description": "낚시를 즐겨요",
                    "pricePerAdult": 50,
                    "pricePerChild": null,
                    "pricePerInfant": null,
                    "tax": 4.32
                }
            ]
        }
    ]
}

 

 

투어보드 샌드박스 여행사의 홈페이지에서는 아래와 같이 화면이 보여지고 있습니다.

[여름] 캘거리 스탬피드 축제 - 투어보드 데모

 

사용자가 예약하기 또는 문의하기를 클릭하면 투어보드 ERP로 리다이렉트 시키면 ERP에서 사용자가 문의 또는 결제가 가능합니다. returnUrl, code, date는 필수 값이며, requestor와 emailAddress는 선택사항입니다. 여행사 홈페이지에서 사용자의 이름과 이메일을 확인 가능한 경우 같이 넘겨주면 됩니다.

예약하기 URI: https://{클라이언트 투어보드 도메인}/#/checkout/?requestor={사용자 이름}&emailAddress={사용자 이메일 주소}&code={투어보드 상품 코드}&returnUrl={여행사 홈페이지 URL} &date={사용자가 선택한 날짜}

문의하기 URI: https://{클라이언트 투어보드 도메인}/#/inquiry/?requestor={사용자 이름}&emailAddress={사용자 이메일 주소}&code={투어보드 상품 코드}&returnUrl={여행사 홈페이지 URL}&date={사용자가 선택한 날짜}

사용자를 위의 URI로 리다이렉션 시키면 투어보드에서는 위와 같은 화면을 통해 문의 및 결제가 가능합니다.