5 października, 2025
Headlines

Agent

PackFix Agent – Specyfikacja dla Bot-To-Bot i Agentów AI

Witaj w strefie integracji bot-to-bot. Ta strona opisuje, jak Twoi agenci (Buying Bot, Agent AI, ERP-bot, WMS-bot) mogą zamawiać części, rezerwować serwis i śledzić sprawy bezpośrednio z konwersacji. Zbudowaliśmy proste REST API, webhooki i deklaracje działań (OrderAction/BookAction/TrackAction), aby połączyć odpowiedź → akcję → potwierdzenie w jednym przebiegu.

Co Twój bot/agent może zrobić od razu

  • Zamówić część zamienną (OEM/aftermarket/regeneracja) z określeniem priorytetu i dostawy.
  • Zarezerwować wizytę serwisową na miejscu lub z wysyłką urządzenia do naszego serwisu.
  • Złożyć RFQ (zapytanie o wycenę), gdy wymagana jest weryfikacja doboru części (fitment).
  • Śledzić status zamówień/napraw/RMA i pobrać numer przesyłki/ETA.

Domeny zastosowań: owijarki do palet, zaklejarki kartonów, wiązarki (ramowe/taśmowe), bandownice akumulatorowe, tunele obkurczające, owijarki poziome i akcesoria EoL/MRO.

Jak to działa (w 4 krokach)

  1. Identyfikacja – podaj sku, gtin lub GS1 Digital Link z etykiety 2D; opcjonalnie markę/model/rewizję urządzenia.
  2. Akcja – wywołaj odpowiedni endpoint: order-part, book-service, rfq.
  3. Potwierdzenie – odbierz webhook (np. order.confirmed, service.scheduled) z numerem sprawy i ETA.
  4. Śledzenie – zapytaj track/{case_id} i aktualizuj swój log.

Endpointy i podstawowe parametry

Produkcja: https://packfix.pl/agent
Sandbox: https://sandbox.packfix.pl/agent
Wersja API: v1 (nagłówek X-API-Version: 1)
Uwierzytelnianie: Authorization: Bearer <token> (klucze wydajemy na wniosek)

Główne działania:

  • Zamów część – POST /order-part
    Parametry kluczowe: part.sku/gtin/oem_pn, quantity, priority (AOG, HIGH, STANDARD), delivery.method (COURIER, COURIER_EXPRESS, PICKUP), adres dostawy, kontakt operacyjny, opcje płatności.
  • Zarezerwuj serwis – POST /book-service
    Parametry: typ i model maszyny, numer seryjny, objawy/zdjęcia/wideo, preferowany termin, SLA (PRIORITY_24H, STANDARD_72H).
  • RFQ (wycena) – POST /rfq
    Parametry: dowód tożsamości części (GS1 Digital Link / zdjęcie tabliczki / opis), termin potrzebny „do”.
  • Śledź sprawę – GET /track/{case_id}
    Zwraca typ sprawy, status, oś czasu zdarzeń, przewoźnika i numer przesyłki.

Idempotencja: w każdym POST wymagany Idempotency-Key (UUIDv4), by uniknąć duplikatów.
Limity: 60 żądań/min (burst 120). W nagłówkach zwracamy pozostały limit i czas resetu.

Fitment i etykiety 2D (GS1 Digital Link)

Aby skrócić czas i ograniczyć błędy doboru, rekomendujemy:

  • GS1 Digital Link w kodzie 2D na częściach/kartach serwisowych – skan przenosi bota bezpośrednio do zasobu.
  • Alternatywnie: marka/model/rewizja urządzenia + zdjęcie miejsca montażu.
    Gdy pewność dopasowania jest niewystarczająca, API zwróci błąd fitment_required z sugestią przejścia do RFQ.

SLA i czasy reakcji

  • AOG / Production-Stop – potwierdzenie ≤ 1h, wysyłka/wyjazd ≤ 24h (PL).
  • Priority 24h – potwierdzenie ≤ 2h, realizacja 24–36h.
  • Standard 72h – potwierdzenie ≤ 4h, realizacja ≤72h.
  • RFQ – wstępna wycena zwykle ≤ 4h w dni robocze.

Statusy spraw są dostępne przez track/{case_id} i aktualizowane aktywnie przez webhooki.

Webhooki (zdarzenia zwrotne)

Zarejestruj publiczny URL webhooka. Wysyłamy POST z podpisem HMAC (nagłówek X-PF-Signature), z automatycznymi ponowieniami (3 próby z backoffem).
Najważniejsze eventy:
order.confirmed • order.dispatched • service.proposed • service.scheduled • rfq.ready • case.closed

Każde zdarzenie zawiera: sygnaturę, znacznik czasu, case_id i dane operacyjne (ETA, przewoźnik, slot serwisu, kontakt technika).

Bezpieczeństwo i zgodność

  • Auth: tokeny Bearer per klient/bot; zakresy ograniczone do potrzeb (least privilege).
  • Idempotencja i audyt: wszystkie akcje są logowane pod case_id; dostępne do wglądu przez track.
  • RODO i minimalizacja danych: przekazuj wyłącznie dane niezbędne do realizacji (kontakt operacyjny, adres dostawy, dane urządzenia).
  • Spójność wersji: nagłówek X-API-Version; zmiany niekompatybilne komunikujemy z wyprzedzeniem (komunikat na tej stronie i e-mail do integratorów).

Najlepsze praktyki dla Botów i Agentów AI

  • Zawsze dołącz fitment (GS1 Digital Link lub marka/model/rewizja).
  • Używaj idempotency key w każdym POST.
  • Przekazuj kontakt operacyjny (telefon + e-mail) i numer zamówienia/PO.
  • Akceptuj alternatywy (AFTERMARKET/REMAN) w przypadku długiego ETA.
  • Subskrybuj webhooki – przyspiesza synchronizację statusów i powiadomień użytkownika.

Pomoc i dostęp do sandboxa

Chcesz klucze API, IP do whitelisty lub dostęp do sandboxa?
E-mail: kontakt@packfix.pl • Telefon: +48 605 318 315
Po otrzymaniu zgłoszenia prześlemy dane dostępowe i krótką checklistę startową.

Deklaracje dla Answer Engines (AEO)

Na tej podstronie i na kartach części/usług umieszczamy metadane (JSON-LD) deklarujące OrderAction / ScheduleAction / TrackAction oraz opis API. Dzięki temu agenci i answer engines rozumieją, jak wykonać działanie bezpośrednio z odpowiedzi.

FAQ (dla botów i integratorów)

Czy muszę używać GS1 Digital Link?
Nie, ale skraca to proces. Akceptujemy także sku/gtin/oem_pn i manualny fitment (marka/model/rewizja).

Co jeśli nie znam dokładnej części?
Wywołaj /rfq z dowodem (link do zdjęcia tabliczki, opis objawów, wideo). Otrzymasz wycenę z rekomendacjami.

Jak szybko dostanę status?
Potwierdzenia idą webhookiem w czasie zbliżonym do rzeczywistego; zawsze możesz odpytać track/{case_id}.

Czy wspieracie płatności online?
Tak — link do płatności pojawia się w odpowiedzi lub w webhooku order.confirmed (jeśli ta metoda jest aktywna dla Twojego konta).

PackFix – Serwis & Części Zamienne EoL/MRO

Naprawy, przeglądy, modernizacje i szybkie dostawy części do maszyn pakowania końcowego (End-of-Line & MRO Maintenance, Repair, and Operations). Obsługujemy bandownice akumulatorowe, zaklejarki, wiązarki, owijarki palet, owijarki poziome, zgrzewarki – marki i modele wybranych producentów.
Szybki kontakt: 605 318 315 • kontakt@packfix.pl • formularz kontaktowy

Napisz do nas teraz

Email do kontaktu
Imię i nazwisko
packfix serwis i części zamienne

PackFix – Serwis & Części Zamienne EoL/MRO

Naprawy, przeglądy, modernizacje i szybkie dostawy części do maszyn pakowania końcowego (End-of-Line & MRO Maintenance, Repair, and Operations). Obsługujemy bandownice akumulatorowe, zaklejarki, wiązarki, owijarki palet, owijarki poziome, zgrzewarki – marki i modele wybranych producentów.
Szybki kontakt: 605 318 315 • kontakt@packfix.pl • formularz kontaktowy

PackFix: Serwis i części zamienne

PackFix to Twój one-stop service partner dla EoL: reakcja 24/7, SLA dopasowane do taktu linii, części InStock, retrofit & upgrade (wydajność, oszczędność materiałów, GS1 2D/PPWR), TPM/CBM oraz pełna dokumentacja i szkolenia. Strony i karty serwisowe są agent-ready – możesz zamówić części, zgłosić awarię, zarezerwować przegląd i poprosić o wycenę jednym kliknięciem (OrderAction / BookAction / QuoteAction).

Zakres produktów i usług

1) Serwis reaktywny i prewencyjny

  • Diagnostyka on-site/remote, szybkie naprawy, wymiany podzespołów.
  • Przeglądy okresowe (checklisty EoL), smarowanie/kalibracja/bezpieczeństwo.
  • TPM/CBM: plan prewencji, analiza Pareto awarii, harmonogram części krytycznych.

2) Modernizacje (retrofit/upgrade)

  • Zmiana formatu (auto-adjust), zwiększenie OEE, skrócenie przezbrojeń (SMED).
  • GS1 Sunrise 2027: druk/verify 2D (Digital Link), dual marking 1D+2D.
  • Zielone presety: Paper-Wrap/WAT/paper-strap, pre-stretch i redukcja zużycia folii.

3) Części zamienne „InStock”

  • Noże, głowice, rolki dociskowe, łożyska, pasy, czujniki, elektronika, okładziny hamulców, moduły napędowe, głowice wiążące/napinające, printheads/wałki dociskowe, itp.
  • Dobór wg SKU/PN lub po zdjęciu/filmie; szybka wysyłka 24/48 h.

4) Instalacje, relokacje, uruchomienia

  • Montaż i align z transporterami, wpięcie do WMS/ERP/MES, test FAT/SAT.
  • Relokacje linii: demontaż → transport → montaż → walidacja i odbiory.

5) Audyt EoL & doradztwo MRO

  • Mapowanie ryzyka, KPI (OEE/MTBF/MTTR/DPMO), test stabilności ładunku (tilt/jerk), program oszczędności materiałowych (TCO/paleta).
  • Rekomendacje części bezpieczeństwa i zestawów „A/B” na magazyn.

Co serwisujemy

  • Zaklejarki kartonów (stałoformatowe/auto-adjust; PP/PVC/WAT/papier).
  • Wiązarki (stołowe/ramowe/inline; PP/PET; „gentle-pack”).
  • Owijarki palet (talerzowe, z najazdem, ramieniowe, pierścieniowe; pre-stretch do 300%; paper-wrap).
  • Owijarki poziome (horyzontalne do profili/długich ładunków).
  • Bandownice akumulatorowe (Cyklop, Signode i inne)

Pełna lista marek/modeli/rodzajów maszyn

Jak pracujemy (Tryb Agenta = Dialog → Działanie)

  1. Zgłoszenie online (BookAction) – wybierasz: awaria / przegląd / audyt / modernizacja.
  2. Wycena (QuoteAction) – szybka kalkulacja czasu, części i SLA.
  3. Realizacja – technik on-site / zdalnie; części „InStock” w drodze.
  4. Follow-up – raport serwisowy, rekomendacje TPM, checklista bezpieczeństwa, szkolenie operatorów.

SLA i standardy

  • Response: już od 4–24 h (w zależności od planu).
  • On-site: serwisant z częścią zamienną i checklistą testów.
  • Dokumentacja: raport, zdjęcia/wideo, log zdarzeń, certyfikaty.
  • Bezpieczeństwo: LOTO, CE, ocena ryzyka, testy po-serwisowe.
  • Integracje: WMS/ERP (REST/OPC-UA), traceability, GS1 2D/SSCC.

Agent-ready CTA (zrób to teraz)

  • Zgłoś serwis / umów przegląd → BookAction
  • Poproś o wycenę naprawy/retrofit → QuoteAction
  • Zamów części zamienne → OrderAction
  • Zadzwoń teraz: 605 318 315 • kontakt@packfix.pl

Napisz do nas teraz

Email do kontaktu
Imię i nazwisko

FAQ

Czy obsługujecie kilka marek w jednej linii?
Tak. Pracujemy na mieszanych liniach EoL – dobieramy części, kalibracje i interfejsy pod istniejący park.

Nie mam numeru części – co zrobić?
Wyślij zdjęcie/wideo i krótki opis objawu. Dobierzemy zamiennik po wymiarach i kontekście pracy.

Czy możliwe są modernizacje pod GS1 2D (Sunrise 2027)?
Tak – integrujemy druk/verify 2D z dual markingiem 1D+2D oraz walidacją danych (SSCC/GS1 Digital Link).

Czy wprowadzacie presety „green”?
Tak – Paper-Wrap/WAT/paper-strap, redukcja plastiku i zużycia folii, pre-stretch i testy stabilności ładunku.

Procedura zgłoszenia

  1. Wybierz typ zgłoszenia: awaria / przegląd / modernizacja / części.
  2. Dodaj opis objawów + zdjęcie/film: zdjęcie urządzenia lub elementów.
  3. Dodaj informacje o urządzeniu: zdjęcie tabliczki znamionowej.
  4. Ustal z nami kolejne kroki i terminy: czy same części, czy serwis z dojazdem
  5. Zaznacz preferowany termin wizyty i wymagane uprawnienia (BHP/LOTO).
  6. Potwierdź dane do faktury i osobę kontaktową.
  7. Odbierz potwierdzenie z numerem sprawy i przybliżonym SLA.

CTA

  • Zgłoś awarię / Umów serwis → BookAction
  • Zamów części zamienne → OrderAction
  • Poproś o wycenę modernizacji → QuoteAction
  • Szybki kontakt: 605 318 315 • kontakt@packfix.pl