Import zamówienia

Wymagania i uprawnienia

Izolowany POC, własny PostgreSQL, dane syntetyczne. Wymagane: orders.import. Konto prywatne nie może korzystać z firmowego magazynu.

Krok po kroku

  1. Wyślij POST /api/import z accountId, externalRef i stałym key.
  2. Dodaj pozycje, ceny w groszach, dostawę oraz potwierdzony fakt przedpłaty.
  3. Odczytaj operationId i HOLD lub ALLOCATED..

Przykład

Dwie pozycje: 2 × 1234 i 3 × 1337, dostawa 500; przedpłata 6979 groszy.

Błędy i korekty

400: popraw sumę lub pola. 409: porównaj treść pod tym samym kluczem. HOLD: uzupełnij brak magazynowy i uzgodnij ręcznie.

Skutki i ograniczenia

Atomowa rezerwacja, zapis przedpłaty i outbox. Import nie pobiera płatności.

Identyfikator i wersja

helpId: g0-import. Wersja 0.1.0.

Kontrakt POC v1: kwoty jako całkowite grosze w PLN; ilości jako całkowite sztuki (pcs). Import wymaga contractVersion: 1 i currency: PLN. Brak waluty, inna waluta, wersja lub niezgodna suma: INVALID_COMMAND — popraw dane i sprawdź wynik po tym samym kluczu. Błędy SQL 40P01/40001 ponawiają całą transakcję najwyżej trzy razy. UNKNOWN wymaga uzgodnienia; nie tworzy drugiej operacji. TalkBack: testy pominięte decyzją użytkownika 2026-10-12.