Vai al contenuto

Precyzyjne wyszukiwanie kodów OE / AM we własnym systemie ERP

Przegląd ogólny

Integrując własny system ERP z Quoting24, można w czasie rzeczywistym zwracać spersonalizowane ceny i dostępność dla konkretnego klienta, z którym prowadzona jest rozmowa podczas wyszukiwania kodów.

W ten sposób szybko uzyskuje się konkretne warunki handlowe klienta, z którym aktualnie rozmawiasz.

Celem jest umożliwienie Quoting24, po zidentyfikowaniu kodu produktu, automatycznego pobrania:

  • dostępności i ceny netto konkretnego klienta
  • metadanych produktu: informacji opisowych, brandu, ewentualnych aktywnych promocji i innych powiązanych atrybutów.
  • przepływ jest zaprojektowany tak, aby w sposób przejrzysty integrować się z API ERP systemu zarządzania Dostawcy.

Parametry wyszukiwania

Od Quoting24 do Dostawcy

Parametry obowiązkowe

  • Token uwierzytelniania
    Unikalny token, który jednoznacznie identyfikuje serwery Quoting24.

  • Kod wyszukiwania
    Preferowany jest kod AM lub OE.
    Wyszukiwanie nie powinno ograniczać się wyłącznie do dokładnych kodów produktu, ale powinno również:

  • Szukać kodów alternatywnych
  • Szukać w zewnętrznych bazach

⚠️ Jeśli takie zachowanie nie jest obsługiwane, należy to jasno zakomunikować.
Jako minimum wyszukiwanie musi obejmować dane kartotekowe produktu, a nie tylko dokładne kody wewnętrzne.

Identyfikacja klienta

Należy podać co najmniej jeden z poniższych elementów

  • ID (zgodnie z kartoteką w systemie ERP) oddziału Waszego klienta
  • ID (zgodnie z kartoteką w systemie ERP) firmy Waszego klienta
  • NIP klienta
  • ID kategorii rabatowej
    Używany dla:
  • klientów niezarejestrowanych
  • umożliwienia operatorowi dynamicznej zmiany reguł rabatowych

Parametry opcjonalne

  • ID operatora (opcjonalne, ale zalecane)
    Używane do śledzenia, kto wygenerował wycenę.

  • Ilość
    Może być uwzględniona w żądaniu, jeśli jest ściśle wymagana.
    Preferowane podejście: obsługa ilości w odpowiedzi, a nie w żądaniu.

  • Brand / Producent
    Aby umożliwić bardziej precyzyjne wyszukiwania.

  • Tryb wyszukiwania
    Parametr opcji dokładnego wyszukiwania punktowego lub wyszukiwania z zamiennikami (które zwraca także wyniki produktów alternatywnych).

Parametry odpowiedzi

Od dostawcy do Quoting24

Odpowiedź musi zawierać listę produktów, każdy z poniższymi polami.

Pola obowiązkowe (dla produktu)

  • Kod produktu dostawcy
    Wewnętrzny kod zamówieniowy, z prefiksami, dokładnie taki, jak używany w systemach Dostawcy.

  • Producent
    Nazwa producenta (np. LUK, Magneti Marelli, Brembo).
    Może być ustrukturyzowana w 2 polach:

  • wersja skrócona / prekod (np. MAR)

  • pełna nazwa (np. Magneti Marelli)

  • Cena sprzedaży netto dla klienta

  • Cena netto (bez VAT)
  • Koszty wysyłki wyłączone

  • Koszty wysyłki mogą być zwrócone oddzielnie, jeśli dotyczy

  • Dostępność
    Wartość numeryczna reprezentująca ilość dostępną w magazynie.

  • Magazyn
    Nazwa magazynu, półka lub odniesienie do lokalizacji wewnętrznej.

Pola opcjonalne

  • Opis produktu
    Tekst swobodny (np. Klocki hamulcowe) i/lub kategoria towarowa.

  • Kod identyfikacyjny Producenta
    Obowiązkowy, gdy kod produktu ERP różni się od kodu producenta.

  • Cena katalogowa
    Nie jest konieczna, ale można ją odtworzyć, jeśli jest potrzebna.

  • Promocje

  • Obecność promocji (wartość binarna)
  • Tekst promocji (opcjonalny)

  • Jeśli tekst jest pusty → promocja nieaktywna

  • Obraz produktu

  • URL obrazu

  • Albo obraz Base64

  • URL karty produktu
    Link do strony szczegółów produktu w e-commerce lub na stronie zewnętrznej.
    Jeśli bezpośrednie połączenie nie jest możliwe:

  • Podaj reguły składni URL

  • Albo zwróć ogólny URL strony logowania

  • Ceny zależne od ilości / Rabaty
    Jeśli istnieją rabaty ilościowe, zwróć progi w dowolnym parsowalnym formacie, na przykład:

{
  "from": 2,
  "to": 10,
  "price": "50.00"
}