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	Opis
PK	tak	Identyfikator rekordu do zwrotki wyniku
document_id	tak	Identyfikator dokumentu
date	tak	Data dokumentu w formacie ISO (YYYY-MM-DDThh:mm:ss); zapisywana jest tylko część daty
type	tak	Typ dokumentu
product_id	tak	Kod produktu
qty	tak	Ilość (float)
value	tak	Wartość (float)
warehouse_id	tak	Kod magazynu

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

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

Przykład żądania

{
  "documents": [
    {
      "PK": 1,
      "document_id": "SO-2026-000123",
      "date": "2026-08-01T00:00:00",
      "type": "13",
      "product_id": "ABC123",
      "qty": "5",
      "value": "62,50",
      "warehouse_id": "MAG-01"
    }
  ]
}

Przykład odpowiedzi

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