30.75. Тестване на Shopify интеграцията

Shopify интеграцията може да се провери по два начина, без да завършвате поръчка и без да създавате товарителница:

1. с отделен тестов продукт и изолиран Shopify shipping profile;
2. с вътрешния Debug mode и получател TEST TEST.

Препоръка: използвайте тестов продукт и отделен shipping profile. Този вариант ограничава проверката само до конкретния продукт. Вътрешният TEST режим е за кратка контролирана диагностика и може да скрие Izprati методите за останалите checkout-и.

Преди да започнете #

Уверете се, че:

• Izprati account е свързан с правилния Shopify магазин;
• нужният куриер и типовете доставка са активни;
• Carrier Calculated Shipping е наличен;
• разполагате с валиден тестов адрес и postcode;
• няма да завършвате плащане, поръчка или товарителница само за тази проверка.

Метод 1 — тестов продукт и отделен shipping profile #

Този метод е подходящ, когато магазинът работи с реални клиенти и не искате тестовите rates да се появяват за други продукти.

1. В Shopify създайте отделен продукт с неутрално име, например Test product.
2. Отворете Settings → Shipping and delivery и създайте нов custom shipping profile, например Test profile.
3. Добавете само тестовия продукт към този profile. Не премествайте реален продаваем продукт: един продукт може да принадлежи само към един shipping profile.
4. Добавете правилната fulfillment location и тестовата shipping zone.
5. В зоната изберете Add shipping option → Use carrier or app to calculate rates, добавете Izprati.bg (via app) и запазете.

Реалният Shopify екран по-долу показва необходимата връзка: един тестов продукт, отделен profile и Izprati calculated rate в тестовата zone.

1. Отворете storefront-а с тестовия продукт, добавете го в количката и преминете към checkout.
2. Въведете валиден тестов адрес и postcode.
3. Проверете method до адрес, office и/или locker. При service point отворете търсенето, изберете точка и се уверете, че изборът се запазва.
4. След теста премахнете тестовия продукт от продажба или изтрийте временния profile, ако повече не е необходим.

Ако в количката има продукт от друг shipping profile, Shopify може да обедини или раздели наличните доставки. За най-чист резултат тествайте само с един тестов продукт.

Метод 2 — вътрешен TEST режим с TEST TEST #

Този метод използва защитен обход по името на получателя. Когато Debug mode е включен, Izprati връща празен списък с rates за обикновените заявки. Ако името на получателя съвпада с Debug bypass recipient name, debug режимът се изключва само за тази заявка и се изпълнява реалното изчисление.

Важно: ако същият Izprati calculated rate обслужва реален checkout, включеният Debug mode може да скрие Izprati доставките за всички клиенти, чието име не съвпада. Използвайте го само в DEV/test магазин или в кратък контролиран прозорец и го изключете веднага след теста.

1. В Shopify отворете Apps → Изпрати.БГ → Настройки на връзката → Още опции (PRO).
2. Намерете секцията Calculation.
3. В Debug bypass recipient name въведете точно TEST TEST.
4. Включете Debug mode и запазете настройките.

На следващия реален анонимизиран Izprati екран са показани двата контрола. Стойността TEST TEST е примерната безопасна стойност за тази проверка:

1. В тестовия checkout въведете First name: TEST и Last name: TEST. Така destination name става TEST TEST.
2. Въведете валиден адрес и postcode и изчакайте Shopify да поиска calculated rates.
3. Проверете очакваните методи и отворете търсенето на office/locker, когато такъв rate е върнат.
4. Не завършвайте поръчката.
5. Върнете се в Calculation, изключете Debug mode и запазете. Проверете повторно, че нормалният checkout отново получава Izprati rates.

Какво точно проверявате #

• продуктът използва правилния shipping profile;
• Izprati calculated rate е добавен към правилната zone;
• country, postcode и адресът връщат очакваните куриери;
• методите до адрес, office и locker са различими;
• търсенето на service points се отваря и избраната точка се запазва;
• след изключване на TEST режима обикновеният checkout отново работи.

Ако няма методи #

• При метода с продукт проверете дали в количката е само тестовият продукт и дали той е в Test profile.
• Проверете дали Izprati.bg (via app) е добавен като calculated rate към правилната zone.
• При TEST режима проверете точните стойности TEST / TEST и Debug bypass recipient name: TEST TEST.
• Проверете дали Debug mode е записан и дали тестът е в същия магазин/Izprati source.
• Проверете валидността на country, postcode и активния courier scope.
• Ако тестът приключи или не сте сигурни в обхвата, изключете Debug mode и използвайте метода с отделен test product/profile.

За настройка на международни пазари вижте 15.65. Международна локализация на Shopify интеграцията.

За Shopify Plus checkout blocks и dynamic rates вижте 15.35. Shopify Plus checkout: настройка на динамични куриерски методи.