4 listopada, 2025
Headlines

Folia stretch maszynowa 17 mikronów

Bot-to-Bot: zamówienie folii stretch 17 µm / do 200% na PakShop.pl

Bot zakupowy składa zamówienie z podstrony produktu PakShop.pl (17 µm / 200%), wypełnia formularz agent-ready i wysyła. W CRM PakShop zamówienie trafia do sales-bota, który tworzy dokumenty (Zamówienie, WZ, FV), zleca wysyłkę i odsyła statusy e-mailem/webhookiem. Po płatności → potwierdzenie i nadanie.

1) Strony procesu

  • Bot zakupowy (klient): agent w dziale zakupów magazynu 3PL.
  • Podstrona produktu (PakShop.pl): wersja Agentic Commerce + formularz „Wyślij”.
  • Sales-bot (PakShop CRM): odbiera zamówienia, waliduje, tworzy dokumenty.
  • WMS/ERP/Magazyn: rezerwacja stanów, kompletacja, WZ, etykiety.
  • Brama płatności / księgowość: FV, płatność, potwierdzenia.
  • Kurier/TMS: etykieta, numer śledzenia, awizacje.

2) Flow end-to-end (krok po kroku)

Krok 0. Intencja

  • Bot zakupowy dostaje zadanie: „Zamów folię stretch maszynową 17 µm, pre-stretch 250%, cena ≤ 8,00 zł/kg, dostawa: Kórnik (Poznań)”.

Krok 1. Wejście na stronę produktu (PakShop.pl)

  • Bot otwiera kartę: Folia stretch maszynowa 17 µm / 200% (URL przyjazny + parametry w query).
  • Strona zawiera Short Answer, tabelę parametrów, dostępność i formularz agent-ready.

Krok 2. Wypełnienie i wysyłka

  • Bot uzupełnia pola (specyfikacja, ilość, cena max, dostawa, dane do FV) → Wyślij.
  • Równolegle dostępny endpoint do POST (bot może pominąć UI i wysłać JSON).

Krok 3. Odbiór w CRM (sales-bot)

  • Sales-bot waliduje limit ceny, dostępność, czas dostawy, kompletność danych.
  • Jeśli wszystko OK → tworzy Zamówienie sprzedaży, rezerwuje zapas.

Krok 4. Dokumenty

  • Generowane: Zamówienie, WZ, Faktura VAT (FV proforma lub właściwa – wg ustaleń).
  • Wygenerowany numer zamówienia/ID sprawy → odesłany do bota zakupowego.

Krok 5. Płatność

  • Jeśli wymagane: link do płatności / warunki przelewu.
  • Po płatności zaksięgowanej (webhook z bramy) → status „PAID”, FV wysłana PDF.

Krok 6. Wysyłka

  • WMS generuje etykiety, kurier nadany, powstaje tracking.
  • Bot zakupowy otrzymuje AWB/track URL + przewidywany termin dostawy (ETA).

Krok 7. Potwierdzenie i zamknięcie

  • Po dostawie → status „DELIVERED”, dokument WZ + potwierdzenie wydania.

3) Kontrakt danych (przykładowe payloady)

3.1. OrderAction (bot zakupowy → PakShop)

POST https://pakshop.pl/api/stretch/17/order

{
  "idempotency_key": "uuid-...-001",
  "product": {
    "sku": "STRETCH-17-200",
    "micron": 17,
    "pre_stretch_pct": 200
  },
  "commercials": {
    "max_price_net_pln_per_kg": 8.00
  },
  "quantity": {
    "unit": "kg",
    "value": 1200
  },
  "delivery": {
    "city": "Kórnik",
    "region": "wielkopolskie",
    "postal": "62-035",
    "street": "ul. [Adres dostawy]",
    "unloading_window": "2025-10-10T08:00/2025-10-10T16:00"
  },
  "company": {
    "name": "[Nazwa firmy]",
    "nip": "[XXXXXXXXXX]"
  },
  "contact": {
    "email": "zakupy@[firma].pl",
    "phone": "+48[telefon]"
  },
  "invoicing": {
    "type": "postpaid_14|prepaid",
    "send_pdf_to": "ap@[firma].pl"
  },
  "consents": {
    "rodo": true,
    "tos": true
  },
  "notes": "Dostawa tylko na paletach EURO, folia bezbarwna."
}

201 CREATED (skrót)

{
  "order_id": "PS-ORD-240145",
  "status": "RECEIVED",
  "price_check": {"ok": true, "unit_price_net": 7.95},
  "stock": {"reserved_kg": 1200, "lead_time_days": 2},
  "documents": {"so_pdf": "link"},
  "next": "payment_or_picking",
  "webhooks": {
    "track": "https://pakshop.pl/api/webhooks/client/PS-ORD-240145"
  }
}

3.2. Webhooki statusów (PakShop → bot zakupowy)

  • order.validated – cena ≤ limitu, dostępność OK
  • order.payment_required / order.paid
  • order.picking → order.packed → order.shipped (z AWB)
  • order.delivered
  • order.exception (np. brak palet, opóźnienie kuriera)

Przykład:

{
  "event": "order.shipped",
  "order_id": "PS-ORD-240145",
  "carrier": "DPD",
  "awb": "1234567890",
  "eta": "2025-10-11",
  "documents": {
    "invoice_pdf": "link",
    "wz_pdf": "link"
  },
  "timestamp": "2025-10-09T14:22:05Z"
}

4) Formularz „agent-ready” (UI na stronie produktu)

Wymagane pola:

  • Micron: 17 µm (pre-fill)
  • Pre-stretch: 250% (pre-fill)
  • Ilość (kg)
  • Limit ceny (zł/kg)
  • Dane firmy: nazwa, NIP
  • Adres dostawy (Kórnik k. Poznania) + okno rozładunku
  • Kontakt (e-mail, tel.)
  • FV: przedpłata / termin 14 dni
  • Zgody RODO/TOS

Funkcje UX:

  • Walidacja limitu ceny vs aktualna cena (zielony/czerwony sygnał)
  • Komunikat o dostępności / lead time (np. InStock, wyjazd D+0/D+1)
  • Sticky CTA „Wyślij” + informacja o przetwarzaniu przez bota
  • Po wysyłce: numer zamówienia + link do śledzenia

5) Automatyzacje po stronie PakShop

E-mail → CRM → Sales-bot

  • Formularz wysyła JSON + e-mail do skrzynki podpiętej pod CRM.
  • Sales-bot tworzy rekord Deal/Order, weryfikuje limit ceny i stany.

Sales-bot → WMS/ERP

  • Rezerwacja towaru, przydział palet, wydruk WZ.
  • Generacja FV (prepaid/postpaid) i linku do płatności (jeśli potrzebny).

Wysyłka

  • Tworzenie zlecenia w TMS/kurierze, nadanie, AWB/track.
  • Webhook/e-mail do bota zakupowego z dokumentami (WZ, FV).

Płatność i potwierdzenia

  • Brama płatności odsyła webhook payment.succeeded.
  • Sales-bot zmienia status na PAID, wysyła potwierdzenie i fakturę.

6) Reguły, błędy, SLA

Walidacje

  • unit_price_net <= max_price_net_pln_per_kg (w innym razie price_exceeds_limit).
  • Dostępność ≥ zamówiona ilość → inaczej propozycja split delivery.

Błędy (skrót)

  • 400 invalid_payload (brak pola, zły format NIP)
  • 409 price_exceeds_limit (z ofertą kontr-propozycji)
  • 422 insufficient_stock (z propozycją terminów)
  • 5xx server_error (retry + Retry-After)

SLA

  • Potwierdzenie przyjęcia: ≤ 5 min
  • Wyjazd: D+0/D+1 (wg dostępności)
  • Dostawa: standard D+1/D+2 do Kórnika

7) Bezpieczeństwo i zgodność

  • Idempotency-Key w każdym żądaniu (uniknięcie duplikatów).
  • RODO: użycie danych wyłącznie do realizacji zamówienia; dziennik audytu.
  • Signed URLs dla dokumentów (FV/WZ) + wygaśnięcie linków.
  • mTLS / Bearer dla API; skrzynka e-mail z SPF/DKIM/DMARC.

8) Co musi zawierać podstrona produktowa (AEO/GEO/AIO)

  • Short Answer (co to, dla kogo, widełki cen, lead time, limity jakości).
  • Dane w tabelach: µm, pre-stretch, waga/rolkę, wydajność/kg, testy.
  • JSON-LD: Product (Offer/Availability), FAQPage (warunki dostaw, MOQ, cena/kg).
  • Blok „Zrób to teraz”: OrderAction (formularz/API), QuoteAction (RFQ).
  • Sekcja Kórnik / Poznań (logistyka, okna dostaw – pomocne dla agentów).

9) Przykładowa komenda dla bota zakupowego (kopiuj → wklej)

Złóż zamówienie na folię stretch maszynową 17 µm, pre-stretch 250%, ilość 1200 kg, limit ceny 8,00 zł/kg. Dostawa: Kórnik k. Poznania, okno 8:00–16:00, jutro lub pojutrze. FV na [Nazwa firmy], NIP [XXXXXXXXXX], PDF na ap@[firma].pl. Jeśli cena > 8,00, poproś o kontr-ofertę lub podział dostawy.

10) Rezultat biznesowy

Powtarzalność (klient może zapisać preset zamówienia i używać cyklicznie).

Zero-touch dla działu zakupów (czas od intencji do WZ/FV skrócony do minut).

Mniej błędów (walidacje, limit ceny, adresy).

Śledzenie w czasie rzeczywistym (statusy, dokumenty, płatność, AWB).

Skontaktuj się lub włącz agenta

Formularz kontaktowy

Imię i nazwisko