WAPRO API v2
orders.create
Tworzy i zatwierdza podstawowe ZO. Dostawę i status ustawia się osobnymi requestami.
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_iddata.order_numberdata.external_numberdata.finalizeddata.status_codedata.fulfillment_statusdata.payment_method_iddata.payment_methoddata.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.