Przejdź do głównej zawartości

Kapitan

Przed rozpoczęciem​

  1. Zarejestruj się na https://manager.captain.ai/.
  2. Upewnij się, że Syrve POS, Syrve App oraz Call Center App są zainstalowane i skonfigurowane.
  3. Upewnij się, że Twoje sklepy mają zainstalowane licencje na dostawy Syrve.
  4. Pobierz i zainstaluj aplikacje Captain Driver (dla kurierów) oraz Captain Dispatch (dla operatorów call center) na swoim telefonie.
  5. Aktywuj Syrve Live API (w Syrve App).

Przegląd​

Integracja została zaprojektowana do połączenia Syrve POS z systemem śledzenia i dystrybucji dostaw Captain.

Dokumentacja techniczna systemu Captain AI:

https://captainai.notion.site/Syrve-Technical-Flow-d2fb0b58e6744a709c02c71f16382ee6

Przed rozpoczęciem należy skonfigurować integrację zgodnie z dokumentem:

https://captainai.notion.site/Onboard-a-New-Store-1d97337762534df8adebc89a696ab64e

Dokument opisuje proces dodawania sklepu w serwisie Captain oraz ustawienia integracji po stronie Captain.

Komunikacja Syrve z Captain.AI​

Webhook — DeliveryOrderUpdate​

Ten webhook służy zarówno do tworzenia, jak i aktualizowania zamówień w Captain.AI. Przetwarzane są tylko zamówienia na dostawę (jeśli order.orderType.orderServiceType jest równe DeliveryByCourier). Proszę zapoznać się z "Technical Reference — Delivery Schema", aby zobaczyć, które pola są wykorzystywane przez Captain.AI.

Webhook — PersonalShift​

Ten webhook służy do rejestrowania rozpoczęcia i zakończenia pracy kierowców. Proszę zapoznać się z "Technical Reference — Personal Shift", aby zobaczyć, które pola są wykorzystywane przez Captain.AI.

Konfiguracja integracji​

Należy utworzyć webhook w Syrve App, który będzie używany do integracji z Captain. W tym celu:

  1. Przejdź do strony ustawień Live API.

  2. Kliknij + Dodaj integrację, aby dodać nową integrację.

  3. Dodaj nową integrację do serwisu Captain.

 

Wybierz sklepy, które będą połączone z Captain. W polu URL wpisz następujący link: https://integrations.captain.ai/webhooks/syrve

  1. Zaznacz wszystkie pola wyboru pokazane na powyższym zrzucie ekranu. Należy również zaznaczyć pole Wyślij w sekcji Personal Shifts.

  2. Tokeny uwierzytelniające można znaleźć w przestrzeni osobistej Captain. Pole to nazywa się Partners Secret Key w ustawieniach Captain.

  3. Dodaj pracowników w Syrve Office — ich dane zostaną przesłane do Captain po skonfigurowaniu integracji.

     

    Pracownicy muszą mieć przypisaną rolę Kierowcy. Muszą być również powiązani z konkretnymi sklepami, posiadać adres e-mail (używany do rejestracji i logowania do Captain Driver) oraz utworzony PIN do logowania w Syrve POS.

     

    Należy wypełnić wszystkie wymagane pola podczas dodawania pracownika. Jeśli któreś pole pozostanie puste, Captain nie doda tego pracownika do swojego systemu i konieczne będzie dodanie nowego pracownika.

Korzystanie z integracji​

Aby integracja działała w Syrve, musisz utworzyć lub zaakceptować zamówienie z systemu zewnętrznego w call center Syrve App. Następnie należy rozdzielić zamówienie do jednego ze sklepów. Następnie zaakceptuj zamówienie w Syrve POS, wyślij je do przygotowania i przypisz kierowcę. Po wykonaniu tych czynności operator będzie musiał rozdzielić zamówienie do odpowiedniego kuriera w aplikacji Captain Dispatch.

Wszystkie transakcje zamówień realizowane w Captain będą przesyłane do Syrve POS odpowiedniego sklepu w czasie rzeczywistym. Na przykład, do POS będą przesyłane następujące statusy: „Dostawa”, „Dostarczono” lub „Anulowano”.