🚀 API для клиентов FULSTOR

// Пример запроса
POST https://panel.fulstor.pl/api/dm/create
X-API-Key: vash_api_kliuch_tut
Content-Type: application/json

{
  "tranzit_warehouse": 0,
  "numer_dokumentu": "DOSTAWA005",
  "uwagi_dokumentu": "Полная поставка — коробки WAUDOG",
  "products": [
    {
      "Nazwa": "Автоматический поводок WAUDOG R-leash, фиолетовый M",
      "EAN": "4823089360478",
      "SKU": "26289",
      "jednostka": "towar",
      "Ilość": 3,
      "Cena": 21.2,
      "Waga (kg)": 0.35,
      "Długość (cm)": 15,
      "Szerokość (cm)": 8,
      "Wysokość (cm)": 4,
      "m3": 0.00048,
      "Numer kartonu": "74989",
      "Numer palety": "PLT001"
    },
    {
      "Nazwa": "Автоматический поводок WAUDOG R-leash, синий L",
      "EAN": "4823089360492",
      "SKU": "26292",
      "jednostka": "towar",
      "Ilość": 3,
      "Cena": 25.32,
      "Waga (kg)": 0.4,
      "Długość (cm)": 18,
      "Szerokość (cm)": 9,
      "Wysokość (cm)": 4.5,
      "m3": 0.000729,
      "Numer kartonu": "74989",
      "Numer palety": "PLT001"
    },
    {
      "Nazwa": "Гигиенический пояс WAUDOG Vet, серый S",
      "EAN": "4823089381718",
      "SKU": "674211",
      "jednostka": "towar",
      "Ilość": 9,
      "Cena": 10.02,
      "Waga (kg)": 0.05,
      "Długość (cm)": 25,
      "Szerokość (cm)": 15,
      "Wysokość (cm)": 2,
      "m3": 0.00075,
      "Numer kartonu": "74989",
      "Numer palety": "PLT001"
    }
  ]
}

// Пример успешного ответа
{
  "status": "success",
  "document_id": 12345,
  "document_number": "DM123/25 - WH1",
  "warehouse_id": 1,
  "warehouse_name": "Главный склад",
  "tranzit_warehouse": 0,
  "numer_dokumentu": "DOSTAWA005",
  "created_products_count": 3,
  "total_products_count": 3,
  "message": "Документ DM успешно создан через API"
}

// Обязательные поля: Nazwa, EAN, jednostka (towar/karton/paleta), Ilość, Cena
// Необязательные поля: SKU, Waga (kg), размеры, m3, Numer kartonu, Numer palety

// Пример запроса
GET https://panel.fulstor.pl/api/client/v1/orders?date_from=2025-10-01&date_to=2025-10-22&status=Nowe zamówienia&limit=50
X-API-Key: vash_api_kliuch_tut

// Пример ответа
{
  "success": true,
  "data": [
    {
      "IDOrder": 12345,
      "Number": "ZO/2025/10/001",
      "Created": "2025-10-20 14:30:00",
      "Modified": "2025-10-20 15:45:00",
      "status": "Nowe zamówienia",
      "external_order_id": "SHOP-2025-456",
      "customer_name": "Jan Kowalski",
      "customer_email": "jan.kowalski@example.com",
      "products": [
        {
          "ean": "5901234123457",
          "quantity": 2,
          "price_brutto": 799.99
        }
      ]
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "count": 1
  }
}

// Пример создания нового заказа
POST https://panel.fulstor.pl/api/client/v1/order
X-API-Key: vash_api_kliuch_tut
Content-Type: application/json

{
  "external_id": "12345667",
  "status": "Nie wysyłać",
  "customer": {
    "name": "Fulstor2",
    "email": "Fulstor2@example.com",
    "phone": "+480123456772",
    "NIP": ""
  },
  "delivery": {
    "fullname": "Fulstorw",
    "company": "Fulstor",
    "phone": "+48123456789",
    "country_code": "PL",
    "country": "Poland",
    "postcode": "01001",
    "state": "",
    "city": "Krakow",
    "street": "ul. Centralna",
    "house_number": "15",
    "apartment": "23",
    "price": 50,
    "smart": 0,
    "point": {
      "name": "Fulstorw",
      "id": "1111111",
      "address": "ul. Centralna 10",
      "postcode": "01001",
      "city": "Krakow"
    },
    "method": "DPD"
  },
  "nofaktura": 0,
  "sendWhenReady": 0,
  "forpalety": 1,
  "products": [
    {
      "ean": "4823089360478",
      "quantity": 2,
      "price_brutto": 21.99,
      "Remarks": "Дополнительная информация",
      "tax_rate": 23
    }
  ],
  "order_source": "B2B",
  "currency": "PLN",
  "currency_rate": 1,
  "payment_method_cod": "0",
  "date_confirmed": "2025-08-01",
  "comments": "Позвоните перед доставкой"
}

// Пример ответа после создания
{
  "success": true,
  "data": {
    "order_id": 12345,
    "order_number": "ZO/2025/10/456",
    "external_order_id": "12345667",
    "status": "Nowe zamówienia",
    "nofaktura": 0,
    "sendWhenReady": 0,
    "forpalety": 1,
    "order_lines": [
      {
        "order_line_id": 98765,
        "ean": "4823089360478",
        "etiketa": 0
      }
    ],
    "created": true
  }
}

// Пример ответа после обновления
{
  "success": true,
  "data": {
    "order_id": 12345,
    "order_number": "ZO/2025/10/456",
    "external_order_id": "12345667",
    "status": "Nie wysyłać",
    "nofaktura": 0,
    "sendWhenReady": 1,
    "forpalety": 1,
    "order_lines": [
      {
        "order_line_id": 98765,
        "ean": "4823089360478",
        "etiketa": 1
      }
    ],
    "updated": true
  }
}

// Внимание: при обновлении все товары перезаписываются
// nofaktura: 1 = заказ без счёта-фактуры, 0 = стандартный режим
// sendWhenReady / send_when_ready: 1 = отправить после готовности, 0 = выключено
// forpalety: 1 = упаковка на палеты, 0 = стандартная упаковка
// Этикетки товаров и документы заказа обрабатываются отдельными эндпоинтами
// Статусы API: Anulowany, Nie wysyłać, Nowe zamówienia, W realizacji, Kompletowanie, Do wysłania, Wysłane

// Пример получения событий заказа
POST https://panel.fulstor.pl/api/client/v1/getJournalList
X-API-Key: vash_api_kliuch_tut
Content-Type: application/json

{
  "order_id": 12345,
  "type": 18,
  "last_log_id": 100
}

// Пример ответа
{
  "success": true,
  "data": [
    {
      "last_log_id": 105,
      "order_id": 12345,
      "type": 18,
      "message": "Изменение статуса: Nowe zamówienia → W realizacji",
      "created_at": "2025-10-20 14:30:00",
      "object_id": "ZO/2025/10/001"
    },
    {
      "last_log_id": 108,
      "order_id": 12345,
      "type": 18,
      "message": "Изменение статуса: W realizacji → Wysłane",
      "created_at": "2025-10-21 10:15:00",
      "object_id": "ZO/2025/10/001"
    }
  ],
  "meta": {
    "count": 2,
    "total": 2
  }
}

// Типы событий:
// 1 — создание заказа
// 16 — обновление заказа
// 18 — изменение статуса

// Пример запроса (multipart/form-data)
POST https://panel.fulstor.pl/api/client/v1/files/upload
X-API-Key: vash_api_kliuch_tut
Content-Type: multipart/form-data

// Поля формы:
doc_type: "ZO" // или "DM"
doc_id: "12345" // ID в системе FULSTOR
files[]: [invoice.pdf, photo.jpg]
file_types[]: ["invoice", "photo"]
descriptions[]: ["Счёт-фактура VAT", "Фото товара"]
client_doc_number: "CLIENT-001"
reference_number: "FST-2025-001"

// Пример cURL:
curl -X POST https://panel.fulstor.pl/api/client/v1/files/upload \
  -H "X-API-Key: vash_api_kliuch" \
  -F "doc_type=ZO" \
  -F "doc_id=12345" \
  -F "files[]=@invoice.pdf" \
  -F "files[]=@photo.jpg" \
  -F "file_types[]=invoice" \
  -F "file_types[]=photo" \
  -F "descriptions[]=Счёт-фактура VAT" \
  -F "descriptions[]=Фото товара"

// Пример ответа
{
  "success": true,
  "message": "Файлы успешно загружены",
  "data": {
    "uploaded_files": [
      {
        "id": 123,
        "name": "invoice.pdf",
        "type": "invoice",
        "description": "Счёт-фактура VAT",
        "uploaded_at": "2025-10-22 12:34:56",
        "status": "uploaded_successfully"
      }
    ],
    "summary": {
      "total_files": 2,
      "uploaded_successfully": 2,
      "failed": 0
    }
  }
}

// Типы файлов: invoice, label, aviso, packing_list, certificate, photo, consignment_note, other
// Форматы: jpg, jpeg, png, webp, pdf, doc, docx, xls, xlsx, txt, csv, ods, odt, rtf