Dokumentacja
Kontakt z pomocą ↗
Baza wiedzy / Zamówienia — zapis / orders.create
WAPRO API v2

orders.create

Tworzy i zatwierdza podstawowe ZO. Dostawę i status ustawia się osobnymi requestami.

ZAPISPOST/v2/connect.php

Nagłówki

HTTP
Authorization: Bearer rvn_api_TUTAJ_WPROWADZ_KLUCZ
Content-Type: application/json
Idempotency-Key: integracja-unikalny-klucz-001

Request

json
{
  "method": "orders.create",
  "company_id": 1,
  "customer_id": 209,
  "warehouse_id": 1,
  "external_number": "SHOP-20261104-001",
  "price_mode": "Brutto",
  "document_kind": "invoice",
  "payment_method_id": 4,
  "payment_days": 14,
  "priority": 2,
  "delivery_date": "2026-11-06",
  "notes": "Uwagi klienta",
  "additional_info": "Źródło: sklep B2B / zamówienie 12345",
  "ordering_person": "Jan Kowalski",
  "contact_id": 0,
  "shipment_number": "",
  "shipment_operator_id": 0,
  "currency": "PLN",
  "auto_reservation": true,
  "items": [
    {
      "product_id": 464,
      "quantity": 1,
      "gross_price": 19.99,
      "discount": 0,
      "description": "Pozycja testowa API"
    }
  ]
}

Przykładowa odpowiedź

json
{
  "ok": true,
  "data": {
    "order_id": 337,
    "order_number": "ZO 0008/26",
    "external_number": "SHOP-20261104-001",
    "finalized": true,
    "status_code": "",
    "fulfillment_status": "",
    "payment_method_id": 4,
    "payment_method": "Przelew",
    "payment_days": 14
  },
  "trace_id": "api_demo_001"
}

Najważniejsze pola odpowiedzi

  • data.order_id
  • data.order_number
  • data.external_number
  • data.finalized
  • data.status_code
  • data.fulfillment_status
  • data.payment_method_id
  • data.payment_method
  • data.payment_days
orders.create celowo odrzuca pola delivery, status, status_code i status_comment. Po otrzymaniu order_id użyj orders.delivery.set oraz orders.status.set.
Każda pozycja musi mieć product_id, quantity > 0 oraz net_price lub gross_price.
document_kind: none, invoice, receipt. price_mode: Netto lub Brutto. priority: 1..3.