documents — import dokumentów sprzedażowych

Klucz JSON: documents · Handler: App\Api\Bizami\Documents

Import tworzy nowe rekordy w tabeli dokumentów sprzedażowych (SaleDocument). Dokumenty nie są aktualizowane — jeśli dokument o tej samej kombinacji document_id:product_id:type już istnieje w bazie, jest pomijany (nie zgłasza błędu, po prostu nie tworzy duplikatu).

Pola rekordu

Pole	Wymagane	Mapowane na	Opis
PK	tak	—	Identyfikator rekordu do zwrotki wyniku
BASE_REF	tak	document_id	Identyfikator dokumentu
DocDate	tak	date	Data dokumentu w formacie ISO (YYYY-MM-DDThh:mm:ss); zapisywana jest tylko część daty
DocType	tak	type	Typ dokumentu
ItemCode	tak	product_id	Kod produktu
Qty	tak	qty	Ilość (float)
Value	tak	value	Wartość (float)
LocCode	tak	warehouse_id	Kod magazynu

Dodatkowo automatycznie ustawiane są: is_investment = 0, source_file = '', recalculate_flag = 1.

Magazyn z pola LocCode, jeśli nie istnieje jeszcze w systemie, jest automatycznie dodawany (patrz import magazynów).

Przykład żądania

{
  "documents": [
    {
      "PK": 1,
      "BASE_REF": "SO-2026-000123",
      "DocDate": "2026-08-01T00:00:00",
      "DocType": "13",
      "ItemCode": "ABC123",
      "Qty": "5",
      "Value": "62,50",
      "LocCode": "MAG-01"
    }
  ]
}

Przykład odpowiedzi

{
  "documents": [
    { "PK": 1, "SendStatus": "Y" }
  ]
}