Import zamówienia zewnętrznego
helpId: poc-import
Cel
Sprawdzenie atomowego zapisu syntetycznego zamówienia, ceny brutto, płatności już rozliczonej poza CORE i zadania.
Wymagania i uprawnienia
Lokalne Windows, Node 24, pnpm i własny katalog POC. Używaj wyłącznie testowych danych. Importer wymaga uprawnienia SuperAdmin w kontekście administracyjnym. Testowe dane uwierzytelniające są odrębne od kont użytkownika.
Krok po kroku
- Przejdź w terminalu do tests/poc-engine-00-02.
- Zainstaluj wyłącznie zależności tego POC poleceniem pnpm install --frozen-lockfile --ignore-scripts.
- Uruchom pnpm test. Poczekaj na testy importu, anulowania, awarii oraz profil zasobów.
- Odczytaj evidence/runtime.json i raport POC_ENGINE_DECISION.md. PASS dotyczy konkretnego testu; status G0 odczytaj z raportu.
Przykład
synthetic-allegro / order-1: 5 sztuk × 1234 grosze = 6170 groszy brutto PLN. Przy stanie 2 silnik może alokować 2; brakujące 3 wymagają osobnego rozstrzygnięcia.
Błędy i rozwiązania
| Błąd | Rozwiązanie |
|---|---|
| IDEMPOTENCY_CONFLICT | Ten sam identyfikator ma zmienione dane. Zachowaj oryginalne dane; korektę zaprojektuj jako oddzielną operację. |
| PRIVATE_OFFERS_ONLY | Konto prywatne służy tylko do ofert; nie importuj go do firmowego OMS. |
| INVALID_MONEY_OR_QUANTITY | Użyj całkowitych groszy PLN i dodatniej całkowitej ilości. Płatność musi być równa ilość × cena. |
| INSUFFICIENT_STOCK_ERROR | Domyślna ścieżka koszyka ogranicza ilość. POC ma odrębną strategię przyjęcia zaufanego importu; nie zwiększaj fizycznego stanu, aby ukryć brak. |
Anulowanie, korekty i skutki
Powtórz identyczny import z tym samym kluczem kanał/konto/order. Zmiana ceny pod tym samym kluczem jest odrzucana. Wstrzyknięta awaria po płatności lub enqueue ma wycofać całą transakcję. POC nie obsługuje kosztu dostawy, rabatów, wielu pozycji ani aktualizacji marketplace.