Platforma integracyjna dla logistyki e-commerce byrd

O projekcie

Klient:

Byrd to dynamicznie rozwijająca się firma technologiczna oferująca kompleksowe usługi fulfillmentowe dla e-commerce. Dzięki własnej sieci magazynów w całej Europie oraz nowoczesnemu oprogramowaniu opartemu na chmurze, byrd umożliwia sprzedawcom internetowym automatyzację procesów logistycznych, integrację z popularnymi platformami e-commerce i skuteczne zarządzanie zwrotami.

Cel projektu:
Optimization of the app development process
Nowy zespół integracyjny wspierający automatyzację logistyki
Stworzenie dedykowanego zespołu integracyjnego odpowiedzialnego za wdrażanie i utrzymanie integracji zewnętrznych systemów API firm kurierskich i platform e-commerce. Rozwój nowych integracji miał wspierać ekspansję byrd na rynki hiszpański i włoski oraz zwiększyć automatyzację procesów logistycznych.

Doświadczenie klienta

Fireup.pro to najlepsza agencja IT, z którą kiedykolwiek współpracowałem, a mam w tej dziedzinie obszerne doświadczenie!

Sebastian Mach

Współzałożyciel & CTO w byrd

Buckle
Od wyzwania

Kluczowe wyzwania

1

Strategia ekspansji rynkowej

Rozbudowa integracji z API firm kurierskich i e-commerce w celu szybkiego wejścia na nowe rynki.

2

Budowa rozwiązania od podstaw

Konieczność stworzenia zespołu integracyjnego od zera, który zapewniłby utrzymanie oraz rozwój istniejących rozwiązań

3

Elastyczność w obliczu zmieniających się API

Potrzeba reagowania na częste zmiany w API zewnętrznych systemów.

4

Wysoka jakość danych

Utrzymanie wysokiej jakości danych – poprawność adresów, deklaracji celnych, kodów HS.

Kluczowe wymagania funkcjonalne

Integracje kurierskie:

  • Rejestrowanie i zamawianie przesyłek.
  • Generowanie etykiet kurierskich: dla przesyłek z magazynu do klienta końcowego i dla przesyłek zwrotnych.
  • Obsługa dokumentów i deklaracji celnych.
  • Pobieranie danych do śledzenia paczek (numer przesyłki, link do śledzenia).
  • Obsługa różnych metod odbioru (adres, punkt odbioru, automaty paczkowe).

Integracje sklepowe:

  • Import zamówień z platform e-commerce do WMS byrd.
  • Synchronizacja stanów magazynowych pomiędzy byrd WMS a sklepem.
  • Przesyłanie danych śledzenia paczek z byrd WMS do sklepu, umożliwiające klientom sprawdzenie statusu zamówienia.

Kluczowe wymagania niefunkcjonalne

Integracje kurierskie:

  • Minimalizacja liczby błędów przy generowaniu etykiet kurierskich.
  • Skrócenie czasu zamawiania przesyłek (w tym generowania etykiet).
  • Zmniejszenie liczby zwrotów spowodowanych błędami w danych adresowych lub deklaracjach celnych.
  • Ograniczenie dodatkowych kosztów naliczanych przez przewoźników w wyniku błędnych deklaracji celnych.

Integracje sklepowe:

  • Minimalizacja liczby niezaimportowanych zamówień.
  • Ograniczenie błędów w synchronizacji stanów magazynowych.
  • Dostosowanie się do limitów przepustowości API platform e-commerce.
Przez rozwiązanie

Proces wdrożenia

Zespół fireup.pro rozpoczął pracę od onboardingu oraz analizy dokumentacji technicznej. Każda integracja przechodziła pełny cykl: od zebrania wymagań, przez zaprojektowanie architektury i implementację, aż po testowanie i wdrożenie produkcyjne. Kluczowym elementem procesu była również dokumentacja oraz tworzenie runbooków.

    Zastosowane metodyki

    Początkowo zespół pracował w sprintach, później przeszedł na podejście Kanbanowe – co lepiej odpowiadało zmieniającej się specyfice projektu i konieczności szybkiego reagowania na zmiany.

      Wyzwania

      • Różna jakość dokumentacji technicznej API (często dostępnej wyłącznie po włosku lub hiszpańsku).
      • Awarie systemów zewnętrznych i konieczność przełączania się na alternatywne integracje.
      • Problemy z jakością danych wprowadzanych przez użytkowników końcowych.
      • Duży nacisk na testy i jakość – każda nowa integracja musiała przejść rygorystyczne scenariusze testowe w środowisku testowym.
      Po sukces

      Fazy projektowe

      1

      Zbieranie wymagań biznesowych

      Na tym etapie zespół identyfikuje potrzeby klienta i określa cele, jakie ma spełniać planowana integracja.

      2

      Uzyskanie dostępu do dokumentacji technicznej integrowanej usługi

      Obejmuje to aktywację firmowego konta u dostawcy usługi, a także uzyskanie dostępu do środowiska deweloperskiego/testowego (tzw. piaskownicy – sandbox). Działania te zazwyczaj wymagają podpisania odpowiedniej umowy między byrd a dostawcą usługi.

      3

      Etap discovery/investigation

      Na tym etapie analizowana jest dokumentacja techniczna oraz przygotowywane są zadania techniczne. Projektowana jest również architektura integracji, a także identyfikowane są potencjalne zależności względem innych zespołów.

      4

      Etap implementacji

      Kod źródłowy najczęściej tworzony jest przez jednego dewelopera. Równolegle, co najmniej jedna inna osoba przeprowadza code review w celu zapewnienia wysokiej jakości wdrażanych rozwiązań.

      5

      Etap testowania

      Testy prowadzone są w izolowanym, nieprodukcyjnym środowisku. Weryfikowana jest poprawność działania integracji oraz eliminowane są ewentualne usterki i braki.

      – W przypadku integracji z przewoźnikami (carrier integrations) testy obejmują m.in. generowanie etykiet kurierskich (carrier labels) dla różnych kombinacji parametrów, takich jak: przesyłki krajowe, wewnątrzunijne czy z deklaracjami celnymi.
      
– W przypadku integracji ze sklepami internetowymi (shop integrations) testy polegają na sprawdzeniu poprawności importu zamówień do byrd WMS, synchronizacji stanów magazynowych (stock levels) oraz propagacji szczegółów śledzenia przesyłek z WMS do sklepu.
      6

      Wdrożenie integracji na środowisko produkcyjne

      Po pomyślnym zakończeniu testów, integracja zostaje uruchomiona w środowisku produkcyjnym.

      7

      Onboarding klientów

      Zespół wspiera klientów podczas podłączania ich sklepów internetowych (na danej platformie e-commerce) do systemu byrd WMS.

      8

      Utrzymanie integracji

      Obejmuje bieżące wsparcie techniczne, monitorowanie działania integracji oraz reagowanie na zmiany po stronie dostawcy usługi lub platformy sklepowej.

      Efekty technologiczne

      Stworzenie i utrzymanie skalowalnego systemu integracyjnego, obsługującego wiele platform e-commerce oraz API firm kurierskich.

      Wdrożenie nowych integracji, umożliwiających ekspansję na rynki włoski i hiszpański (m.in. BRT, Correos, Posteitaliane, SEUR).

      Automatyzacja procesów onboardingowych za pomocą Zapiera i niestandardowych komponentów integracyjnych.

      Utrzymanie wysokiej niezawodności systemu dzięki szybkiemu reagowaniu na zmiany i awarie w zewnętrznych API.

      Rozwój systemu billingowego, umożliwiającego automatyczne generowanie faktur i obliczanie taryf transportowych na podstawie danych operacyjnych.

      Korzyści biznesowe

      Możliwość ekspansji usług byrd na nowe rynki – Włochy i Hiszpanię – bez zwiększania obciążeń zespołu core’owego.

      Usprawniliśmy obsługę dostaw paczek do punktów odbioru, w tym różnego rodzaju automatów paczkowych (parcel lockers) w kilku krajach europejskich.

      Redukcja liczby błędów integracyjnych i zgłoszeń od klientów końcowych, co przełożyło się na poprawę jakości usług.

      Skrócenie czasu potrzebnego na wdrażanie nowych integracji i reagowanie na zmiany w systemach zewnętrznych.

      Wzrost zaufania partnerów i klientów dzięki stabilności operacyjnej i transparentności procesów logistycznych.

      Odciążenie zespołów operacyjnych i customer support – dzięki automatyzacji wielu manualnych procesów i integracji danych między systemami.

      Zwiększona elastyczność operacyjna – dzięki automatyzacji i dedykowanemu zespołowi integracyjnemu możliwe było szybkie dostosowanie się do zmian rynkowych i technologicznych.


      Zespół projektowy
      Abstract background
      Piotr
      Marta
      Michał

      Piotr

      Software Engineer,
      (Integration & WMS Systems)

      Projektowanie i implementacja integracji z zewnętrznymi usługami, takimi jak API firm kurierskich (carrier APIs) oraz platformy e-commerce (shop platforms)
      Refaktoryzacja kodu oraz usprawnianie architektury systemu WMS w celu poprawy wydajności i skalowalności
      Analiza wymagań biznesowych oraz ich przekładanie na rozwiązania techniczne
      Wprowadzanie nowych programistów i programistek do zespołu – zarówno technicznie, jak i procesowo
      Studium dokumentacji technicznej zewnętrznych usług i interfejsów API
      Tworzenie oraz aktualizowanie wewnętrznej dokumentacji technicznej
      Projektowanie i wdrażanie nowych funkcji w systemie WMS – zarówno w ramach zespołu, jak i we współpracy z innymi zespołami
      Prowadzenie warsztatów i demonstracji nowych funkcjonalności systemu WMS – zarówno dla zespołu deweloperskiego, jak i interesariuszy biznesowych
      Utrzymywanie regularnej komunikacji z zewnętrznymi dostawcami usług w celu zapewnienia sprawnej integracji
      Utrzymanie istniejących integracji, w tym: naprawa błędów, dostosowywanie do aktualizacji oraz reagowanie na breaking changes po stronie zewnętrznych usług
      Planowanie kwartalnych inicjatyw technicznych wspierających rozwój systemu

      Kluczowe kompetencje zespołu

      • Projektowanie architektury integracji
      • Doświadczenie z systemami WMS
      • Automatyczne i manualne testowanie
      • Obserwowalność i telemetria (OpenTelemetry)
      • Znajomość wzorców DDD i czystej architektury

      Tech stack

      Python

      Python

      Flask

      PostgreSQL

      Redshift

      Redis

      AWS

      Kubernetes

      OpenTelemetry

      Grafana

      TypeScript

      Angular

      Android

      Kotlin

      Twoja sukces to nasz sukces!

      Zobacz, jak możemy wspólnie zbudować technologiczną przewagę dla Twojej firmy

      Umów się na konsultację!
      Innowacje i unikalne podejście

      Wdrożenie własnych bloków integracyjnych w Zapier umożliwiających automatyzację procesów onboardingowych.

      Innovation image
      Innovation image

      Praca asynchroniczna i dokumentowanie wszystkich procesów w runbookach.

      Stworzenie systemu billingowego automatyzującego generowanie faktur i analizę kosztów logistycznych.

      Innovation image

      Mamy zespół, który naprawdę zna się na rzeczy — pomożemy Ci znaleźć rozwiązanie, które działa.

      Wnioski i rekomendacje

      Warto przypisywać przynajmniej 2 odpowiedzialne osoby  do konkretnej integracji – zwiększa to szybkość reakcji i poczucie odpowiedzialności.

      Kluczowa jest dokładna dokumentacja i unikanie silosów wiedzy.

      Zaleca się ostrożne planowanie liczby równoległych integracji – jakość powinna mieć pierwszeństwo przed ilością.

      Asynchroniczne formy współpracy (np. nagrywane wideo) zwiększają efektywność zespołu.

      Background

      Czas na Twój projekt!

      Przekształć idee w rzeczywiste rozwiązanie i skontaktuj się z nami.

      Twoja wizja, nasza realizacja
      Napisz, omówimy szczegóły.

      Wyrażam zgodę na przetwarzanie moich danych osobowych przez Fire ...