Pređi na sadržaj
ShopentlyLearn
Srpski (latinica)

Preuzmi — Porudžbine

Pročitajte podatke iz „Porudžbine“. Rezultat zavisi od parametara ove radnje.

GET/api/v1/orders/{order_id}

Autentifikacija
Bearer
Dostupno od
BASIC
Potrebna ovlašćenja
orders.order:read

Primeri koda

Primer zahteva

cURL

: "${SHOPENTLY_SHOP_URL:?}"

curl --disable --globoff --fail-with-body --silent --show-error \
  --proto '=https' --connect-timeout 5 --max-time 30 \
  --request GET \
  --header "Authorization: Bearer ${SHOPENTLY_ACCESS_TOKEN:?}" \
  --url "${SHOPENTLY_SHOP_URL%/}"/api/v1/orders/example

PHP

<?php
declare(strict_types=1);

$baseUrl = rtrim(getenv('SHOPENTLY_SHOP_URL') ?: '', '/');
$origin = parse_url($baseUrl);
if (!$origin || ($origin['scheme'] ?? '') !== 'https' || empty($origin['host']) ||
    isset($origin['user'], $origin['pass']) || isset($origin['user']) || isset($origin['path']) ||
    isset($origin['query']) || isset($origin['fragment'])) {
    throw new RuntimeException('SHOPENTLY_SHOP_URL must be an HTTPS origin');
}
$credential = getenv('SHOPENTLY_ACCESS_TOKEN') ?: '';
if ($credential === '' || strpbrk($credential, "\r\n") !== false) {
    throw new RuntimeException('Invalid credential');
}
$headers = [];
$headers[] = 'Authorization: Bearer ' . $credential;
$responseHeaders = [];
$handle = curl_init($baseUrl . '/api/v1/orders/example');
curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_PROTOCOLS => CURLPROTO_HTTPS,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_SSL_VERIFYHOST => 2,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HEADERFUNCTION => static function ($handle, string $line) use (&$responseHeaders): int {
        if (str_contains($line, ':')) {
            [$name, $value] = explode(':', $line, 2);
            $responseHeaders[strtolower(trim($name))] = trim($value);
        }
        return strlen($line);
    },
]);
$raw = curl_exec($handle);
$status = curl_getinfo($handle, CURLINFO_RESPONSE_CODE);
$error = curl_error($handle);
curl_close($handle);
if ($raw === false) {
    throw new RuntimeException('Transport error: ' . $error);
}
if ($status < 200 || $status >= 300) {
    throw new RuntimeException('HTTP ' . $status . '; request_id=' .
        ($responseHeaders['x-request-id'] ?? '') . '; retry_after=' . ($responseHeaders['retry-after'] ?? ''));
}
$result = $raw === '' ? null : json_decode($raw, true, 512, JSON_THROW_ON_ERROR | JSON_BIGINT_AS_STRING);
echo json_encode($result, JSON_THROW_ON_ERROR | JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE), PHP_EOL;

Python

from contextlib import ExitStack
import json
import os
from urllib.parse import urlsplit

import requests  # python -m pip install requests

base_url = os.environ["SHOPENTLY_SHOP_URL"].rstrip("/")
origin = urlsplit(base_url)
if origin.scheme != "https" or not origin.hostname or origin.username or origin.password or origin.path or origin.query or origin.fragment:
    raise ValueError("SHOPENTLY_SHOP_URL must be an HTTPS origin")
credential = os.environ['SHOPENTLY_ACCESS_TOKEN']
if not credential or "\r" in credential or "\n" in credential:
    raise ValueError("Invalid credential")
headers = {}
headers["Authorization"] = 'Bearer' + " " + credential
body = None
if body is not None:
    headers["Content-Type"] = "application/json"

with ExitStack() as stack:
    session = stack.enter_context(requests.Session())
    files = None
    if False:
        image = stack.enter_context(open(os.environ["SHOPENTLY_IMAGE_FILE"], "rb"))
        if os.fstat(image.fileno()).st_size > 5242880:
            raise ValueError("Image exceeds 5 MiB")
        files = {"file": ("article.png", image, "image/png")}
    response = session.request(
        'GET', base_url + '/api/v1/orders/example', headers=headers,
        data=body.encode("utf-8") if body is not None else None, files=files,
        timeout=(5, 30), allow_redirects=False,
    )
    if not 200 <= response.status_code < 300:
        raise RuntimeError(f"HTTP {response.status_code}; request_id={response.headers.get('X-Request-ID', '')}; retry_after={response.headers.get('Retry-After', '')}")
    if False:
        if response.headers.get("Content-Type") != "image/webp" or len(response.content) > 5242880:
            raise ValueError("Unexpected image response")
        with open(os.environ["SHOPENTLY_OUTPUT_FILE"], "xb") as output:
            output.write(response.content)
    else:
        result = response.json() if response.content else None
        print(json.dumps(result, ensure_ascii=False, indent=2))

Primer odgovora 200

JSON
{
  "data": {
    "created_at": "2026-10-19T10:00:00Z",
    "customer": {
      "email": "customer@example.invalid",
      "first_name": "Example",
      "last_name": "Example",
      "phone": null
    },
    "delivery": {
      "amount": {
        "amount": "0.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "dates": {
        "dispatch_timezone": "Europe/Warsaw",
        "estimated_delivery_from": "2026-10-20",
        "estimated_delivery_to": "2026-10-21",
        "planned_dispatch_on": "2026-10-19"
      },
      "discount_gross": {
        "amount": "24.60",
        "currency": "PLN",
        "minor_units": 2
      },
      "discount_net": {
        "amount": "20.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "discount_tax": {
        "amount": "4.60",
        "currency": "PLN",
        "minor_units": 2
      },
      "discounts": [
        {
          "amount": {
            "amount": "24.60",
            "currency": "PLN",
            "minor_units": 2
          },
          "campaign_id": "saved-coupon",
          "code": "SAVE",
          "kind": "coupon",
          "name": "Saved coupon",
          "sequence": 1,
          "version": 3
        }
      ],
      "gross": {
        "amount": "0.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "method_code": "shipping-old",
      "method_name": "Historic carrier",
      "net": {
        "amount": "0.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "original_gross": {
        "amount": "24.60",
        "currency": "PLN",
        "minor_units": 2
      },
      "original_net": {
        "amount": "20.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "original_tax": {
        "amount": "4.60",
        "currency": "PLN",
        "minor_units": 2
      },
      "pickup_point": null,
      "recipient_mode": "full_address",
      "tax": {
        "amount": "0.00",
        "currency": "PLN",
        "minor_units": 2
      },
      "tax_category_id": "standard",
      "tax_category_name": "VAT 23%",
      "tax_rate": "0.23"
    },
    "discount_amount": {
      "amount": "24.60",
      "currency": "PLN",
      "minor_units": 2
    },
    "discounts": [
      {
        "amount": {
          "amount": "12.30",
          "currency": "PLN",
          "minor_units": 2
        },
        "campaign_id": "saved-coupon",
        "code": "SAVE",
        "kind": "coupon",
        "name": "Saved coupon",
        "sequence": 1,
        "shipping_amount": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "version": 3
      }
    ],
    "id": "order-0000",
    "invoice": null,
    "invoice_requested": false,
    "lifecycle_state": "placed",
    "lines": [
      {
        "discount_amount": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_gross": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_net": {
          "amount": "20.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_tax": {
          "amount": "4.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "discounts": [
          {
            "amount": {
              "amount": "12.30",
              "currency": "PLN",
              "minor_units": 2
            },
            "campaign_id": "saved-coupon",
            "code": "SAVE",
            "kind": "coupon",
            "name": "Saved coupon",
            "sequence": 1,
            "shipping_amount": null,
            "version": 3
          }
        ],
        "identifiers": {},
        "image": null,
        "line_id": "saved-line-a",
        "manual_discount": {
          "amount": {
            "amount": "12.30",
            "currency": "PLN",
            "minor_units": 2
          },
          "kind": "fixed",
          "value": "12.30"
        },
        "name": "Saved A",
        "original_total": {
          "amount": "246.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_gross": {
          "amount": "246.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_net": {
          "amount": "200.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_tax": {
          "amount": "46.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "position": 1,
        "product_id": "product-api",
        "quantity": 2,
        "sku": "A",
        "tax": {
          "amount": "20.70",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax_category_id": "standard",
        "tax_category_name": "VAT 23%",
        "tax_rate": "0.23",
        "total": {
          "amount": "221.40",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_gross": {
          "amount": "221.40",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_net": {
          "amount": "180.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_tax": {
          "amount": "41.40",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_gross": {
          "amount": "123.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_net": {
          "amount": "100.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_price": {
          "amount": "123.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_tax": {
          "amount": "23.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "variant_id": null,
        "variant_options": []
      },
      {
        "discount_amount": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_gross": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_net": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "discount_tax": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "discounts": [],
        "identifiers": {},
        "image": null,
        "line_id": "b548a171-c331-505f-98f8-db3a06070998",
        "manual_discount": null,
        "name": "Saved B",
        "original_total": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_gross": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_net": {
          "amount": "100.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "original_total_tax": {
          "amount": "8.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "position": 2,
        "product_id": "deleted-product",
        "quantity": 1,
        "sku": "B",
        "tax": null,
        "tax_category_id": "reduced",
        "tax_category_name": "VAT 8%",
        "tax_rate": "0.08",
        "total": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_gross": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_net": {
          "amount": "100.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "total_tax": {
          "amount": "8.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_gross": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_net": {
          "amount": "100.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_price": {
          "amount": "108.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "unit_tax": {
          "amount": "8.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "variant_id": null,
        "variant_options": []
      }
    ],
    "locale": "pl",
    "market_id": "market-pl",
    "number": "0001",
    "payment": {
      "amount": {
        "amount": "329.40",
        "currency": "PLN",
        "minor_units": 2
      },
      "environment": "live",
      "method_code": "payment-old",
      "method_name": "Historic method",
      "paid_at": null,
      "status": "unpaid",
      "updated_at": "2026-10-19T10:00:00Z",
      "version": 0
    },
    "pickup_point": null,
    "prices_include_tax": true,
    "shipping_address": null,
    "shipping_discount_amount": {
      "amount": "24.60",
      "currency": "PLN",
      "minor_units": 2
    },
    "status": {
      "id": "status-0",
      "name": "Status 0",
      "updated_at": "2026-10-19T10:00:00Z",
      "version": 1
    },
    "subtotal": {
      "amount": "329.40",
      "currency": "PLN",
      "minor_units": 2
    },
    "tax": {
      "amount": "49.40",
      "currency": "PLN",
      "minor_units": 2
    },
    "tax_breakdown": {
      "groups": [
        {
          "gross": {
            "amount": "221.40",
            "currency": "PLN",
            "minor_units": 2
          },
          "net": {
            "amount": "180.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "source": "products",
          "tax": {
            "amount": "41.40",
            "currency": "PLN",
            "minor_units": 2
          },
          "tax_rate": "0.23"
        },
        {
          "gross": {
            "amount": "108.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "net": {
            "amount": "100.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "source": "products",
          "tax": {
            "amount": "8.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "tax_rate": "0.08"
        },
        {
          "gross": {
            "amount": "0.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "net": {
            "amount": "0.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "source": "shipping",
          "tax": {
            "amount": "0.00",
            "currency": "PLN",
            "minor_units": 2
          },
          "tax_rate": "0.23"
        }
      ],
      "unallocated_tax": {
        "amount": "0.00",
        "currency": "PLN",
        "minor_units": 2
      }
    },
    "tax_country_code": "PL",
    "total": {
      "amount": "329.40",
      "currency": "PLN",
      "minor_units": 2
    },
    "totals": {
      "before_discounts": {
        "gross": {
          "amount": "378.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "320.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "58.60",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "discounts": {
        "gross": {
          "amount": "49.20",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "40.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "9.20",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "order": {
        "gross": {
          "amount": "329.40",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "280.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "49.40",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "product_discounts": {
        "gross": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "20.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "4.60",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "products": {
        "gross": {
          "amount": "329.40",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "280.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "49.40",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "products_before_discounts": {
        "gross": {
          "amount": "354.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "300.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "54.00",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "shipping": {
        "gross": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "0.00",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "shipping_before_discounts": {
        "gross": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "20.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "4.60",
          "currency": "PLN",
          "minor_units": 2
        }
      },
      "shipping_discounts": {
        "gross": {
          "amount": "24.60",
          "currency": "PLN",
          "minor_units": 2
        },
        "net": {
          "amount": "20.00",
          "currency": "PLN",
          "minor_units": 2
        },
        "tax": {
          "amount": "4.60",
          "currency": "PLN",
          "minor_units": 2
        }
      }
    }
  },
  "meta": {
    "request_id": "example-request"
  }
}

Kako funkcioniše

  • Kolekcija pruža sažetke porudžbina i filtere za broj, status, status plaćanja i vreme kreiranja.
  • Lista i detalji porudžbine sadrže delivery.dates. Planirani datumi YYYY-MM-DD ne potvrđuju otpremu. Trenutni datumi imaju prednost; starije porudžbine koriste sačuvanu procenu. Obrisane ili nepoznate vrednosti su null. Detalji sadrže i sve stavke i slike proizvoda.
  • Valjane identifikatore statusa dohvatite s /api/v1/order-statuses.
  • Status porudžbine i status plaćanja koriste posebne PATCH krajnje tačke i ovlašćenja.
  • Promena evidentiranog statusa plaćanja ne tereti karticu niti izvršava povrat preko pružaoca platnih usluga.

Sigurni upisi

Ovlašćenja i planovi

Porudžbina · Ukupni iznosi

Iznosi i stope potiču iz sačuvane porudžbine, uključujući ispravke stavki. Nedostajući istorijski podaci su null i ne zamenjuju se trenutnim stopama iz kataloga. Iznosi ostaju decimalni nizovi.

Lista vraća sažetke. Za svaki rezultat preuzmite GET /api/v1/orders/{order_id} za potpune finansijske podatke. Ponavljanja GET su ograničena i poštuju Retry-After. Izvoz po datumu kreiranja ne sinhronizuje kasnije ispravke.

  • tax_country_code · Poreska država · Sačuvani podaci porudžbine · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Jedna jedinica · Pre popusta; lines[].original_total_* · Pre popusta; lines[].total_* · Posle popusta.
  • lines[].discount_* · Popusti; manual_discount · Ručni popust; percentage "10" = 10%.
  • delivery.net / tax / gross · Posle popusta; delivery.original_* · Pre popusta; delivery.discount_* · Popusti.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Nepoznato: null; poznata nula: 0.
  • totals · Ukupni iznosi; tax_breakdown.groups · Poreske grupe; Neraspoređeni porez = order.tax − Σ groups.tax; ±.

payment.amount je ukupan iznos porudžbine. Status plaćanja ne određuje plaćene, vraćene ili preostale iznose.

Parametri

Parametri putanje

order_idNiz znakovaObavezno

Identifikator povezane porudžbine.

Ograničenja
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Primer: "example"

Ova operacija ne prihvata JSON telo.

Odgovori

Odgovor 200

Ceo model: ApiResponse_OrderDetailData_

dataOrderDetailData Obavezno

Podaci uspešnog odgovora.

Polja · data

Ceo model: OrderDetailData

created_atNiz znakovaObavezno

Vreme kreiranja.

format: "date-time"
customerCustomerData Obavezno

Podaci kupca zabeleženi za ovaj resurs.

Polja · customer

Ceo model: CustomerData

emailNiz znakovaObavezno

Adresa e-pošte.

first_nameNiz znakova nullObavezno

Ime.

last_nameNiz znakova nullObavezno

Prezime.

phoneNiz znakova nullObavezno

Telefonski broj.

deliveryShippingDetailData Obavezno

Način dostave i povezani podaci.

Polja · delivery

Ceo model: ShippingDetailData

amountMoneyData Obavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

datesDeliveryDatesData Obavezno

Datumi otpreme i dostave

discount_grossMoneyData Obavezno

Bruto iznos · Popusti; Nepoznato: null; poznata nula: 0.

discount_netMoneyData nullObavezno

Neto iznos · Popusti; Nepoznato: null; poznata nula: 0.

discount_taxMoneyData nullObavezno

Iznos poreza · Popusti; Nepoznato: null; poznata nula: 0.

discountsNiz vrednosti <OrderDeliveryDiscountData > nullObavezno

Popusti

grossMoneyData Obavezno

Bruto iznos · Posle popusta; Nepoznato: null; poznata nula: 0.

method_codeNiz znakova nullObavezno

Kod načina dostave ili plaćanja.

method_nameNiz znakova nullObavezno

Naziv načina dostave ili plaćanja.

netMoneyData nullObavezno

Neto iznos · Posle popusta; Nepoznato: null; poznata nula: 0.

original_grossMoneyData Obavezno

Bruto iznos · Dostava · Pre popusta; Nepoznato: null; poznata nula: 0.

original_netMoneyData nullObavezno

Neto iznos · Dostava · Pre popusta; Nepoznato: null; poznata nula: 0.

original_taxMoneyData nullObavezno

Iznos poreza · Dostava · Pre popusta; Nepoznato: null; poznata nula: 0.

pickup_pointDeliveryPickupPointData nullObavezno

Mesto preuzimanja

recipient_modeNiz znakovaObavezno

Varijanta strukture podataka opisana dozvoljenim vrednostima.

Ograničenja
enum
["full_address", "pickup_contact"]
taxMoneyData nullObavezno

Poreski podaci.

tax_category_idNiz znakova nullObavezno

Identifikator poreske kategorije.

tax_category_nameNiz znakova nullObavezno

Sačuvani naziv poreske kategorije; null.

tax_rateNiz znakova nullObavezno

tax_rate · Sačuvani podaci porudžbine: "0.23" = 23%; "0" ≠ null.

discount_amountMoneyData Obavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

Polja · discount_amount

Ceo model: MoneyData

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4
discountsNiz vrednosti <OrderDiscountData > Obavezno

Popusti

Polja · discounts

OrderDiscountData

Ceo model: OrderDiscountData

idNiz znakovaObavezno

Identifikator resursa; sačuvajte ga u vraćenom obliku.

invoiceInvoiceData nullObavezno

Podaci računa.

Polja · invoice

InvoiceData

Ceo model: InvoiceData

null

invoice_requestedLogička vrednostObavezno

Da li je zatražen račun.

lifecycle_stateOrderLifecycleState Obavezno

Stanje poslovnog životnog ciklusa.

linesNiz vrednosti <OrderLineData > Obavezno

Snimke stanja stavki porudžbine.

Polja · lines

OrderLineData

Ceo model: OrderLineData

localeNiz znakovaObavezno

Jezik odabran za ovaj zahtev.

market_idNiz znakovaObavezno

Identifikator tržišta vraćen s krajnje tačke konteksta.

numberNiz znakovaObavezno

Broj porudžbine ili zahteva namenjen korisniku.

paymentPaymentData Obavezno

Podaci o plaćanju zabeleženi za porudžbinu.

Polja · payment

Ceo model: PaymentData

amountMoneyData Obavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

environmentNiz znakovaObavezno

Podaci o okruženju pridruženi zapisu.

Ograničenja
enum
["live", "sandbox"]
method_codeNiz znakova nullObavezno

Kod načina dostave ili plaćanja.

method_nameNiz znakova nullObavezno

Naziv načina dostave ili plaćanja.

paid_atNiz znakova nullObavezno

Datum i vreme kada je plaćanje označeno kao plaćeno.

Niz znakova:format: "date-time"
statusOrderPaymentStatus Obavezno

Status prihvaćen za ovu određenu operaciju.

updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"
versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

pickup_pointPickupPointData nullObavezno

Mesto preuzimanja

Polja · pickup_point

PickupPointData

Ceo model: PickupPointData

null

prices_include_taxLogička vrednostObavezno

Da li uključuju navedene cene porez.

shipping_addressAddressData nullObavezno

Adresa dostave.

Polja · shipping_address

AddressData

Ceo model: AddressData

null

shipping_discount_amountMoneyData Obavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

Polja · shipping_discount_amount

Ceo model: MoneyData

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4
statusOrderStatusData Obavezno

Status prihvaćen za ovu određenu operaciju.

Polja · status

Ceo model: OrderStatusData

idNiz znakovaObavezno

Identifikator resursa; sačuvajte ga u vraćenom obliku.

nameNiz znakovaObavezno

Naziv resursa u odgovarajućem kontekstu.

updated_atNiz znakovaObavezno

Vreme poslednjeg ažuriranja.

format: "date-time"
versionCeli brojObavezno

Verzija resursa za kontrolu istovremenih upisa.

subtotalMoneyData Obavezno

Iznos pre dodatnih sastavnica prikazanih u odgovoru.

Polja · subtotal

Ceo model: MoneyData

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4
taxMoneyData Obavezno

Poreski podaci.

Polja · tax

Ceo model: MoneyData

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4
tax_breakdownOrderTaxBreakdownData Obavezno

Poreske grupe · source + tax_rate; unallocated_tax.

Polja · tax_breakdown

Ceo model: OrderTaxBreakdownData

groupsNiz vrednosti <OrderTaxGroupData > Obavezno

Poreske grupe · source + tax_rate; Nepoznato: null; poznata nula: 0.

unallocated_taxMoneyData Obavezno

Neraspoređeni porez = order.tax − Σ groups.tax; ±.

tax_country_codeNiz znakova nullObavezno

Poreska država · Sačuvani podaci porudžbine · ISO 3166-1 alpha-2; null.

totalMoneyData Obavezno

Ukupan iznos.

Polja · total

Ceo model: MoneyData

amountNiz znakovaObavezno

Decimalni iznos kodiran kao JSON niz znakova; null samo gde je dozvoljen.

currencyNiz znakovaObavezno

Kod valute iznosa.

Ograničenja
pattern
"^[A-Z]{3}$"
minor_unitsCeli brojObavezno

Broj decimalnih cifara valute.

minimum: 0maximum: 4
totalsOrderTotalsData Obavezno

Ukupni iznosi · net / tax / gross; Pre popusta / Posle popusta.

Polja · totals

Ceo model: OrderTotalsData

before_discountsOrderAmountBreakdownData Obavezno

Porudžbina · Pre popusta · net / tax / gross.

discountsOrderAmountBreakdownData Obavezno

Popusti

orderOrderAmountBreakdownData Obavezno

Porudžbina · Posle popusta · net / tax / gross.

product_discountsOrderAmountBreakdownData Obavezno

Proizvodi · Popusti · net / tax / gross.

productsOrderAmountBreakdownData Obavezno

Proizvodi · Posle popusta · net / tax / gross.

products_before_discountsOrderAmountBreakdownData Obavezno

Proizvodi · Pre popusta · net / tax / gross.

shippingOrderAmountBreakdownData Obavezno

Dostava · Posle popusta · net / tax / gross.

shipping_before_discountsOrderAmountBreakdownData Obavezno

Dostava · Pre popusta · net / tax / gross.

shipping_discountsOrderAmountBreakdownData Obavezno

Dostava · Popusti · net / tax / gross.

metaContextPageMeta ContextMeta PageMeta RequestMeta Obavezno

Metapodaci odgovora.

Polja · meta

ContextPageMeta

Ceo model: ContextPageMeta

localeNiz znakovaObavezno

Jezik odabran za ovaj zahtev.

market_codeNiz znakovaObavezno

Kod tržišta vraćen s krajnje tačke konteksta.

market_idNiz znakovaObavezno

Identifikator tržišta vraćen s krajnje tačke konteksta.

paginationPagination Obavezno

Metapodaci paginacije pomoću kursora.

request_idNiz znakovaObavezno

Identifikator zahteva; u metapodacima odgovora označava HTTP zahtev.

minLength: 1maxLength: 100

ContextMeta

Ceo model: ContextMeta

localeNiz znakovaObavezno

Jezik odabran za ovaj zahtev.

market_codeNiz znakovaObavezno

Kod tržišta vraćen s krajnje tačke konteksta.

market_idNiz znakovaObavezno

Identifikator tržišta vraćen s krajnje tačke konteksta.

request_idNiz znakovaObavezno

Identifikator zahteva; u metapodacima odgovora označava HTTP zahtev.

minLength: 1maxLength: 100

PageMeta

Ceo model: PageMeta

paginationPagination Obavezno

Metapodaci paginacije pomoću kursora.

request_idNiz znakovaObavezno

Identifikator zahteva; u metapodacima odgovora označava HTTP zahtev.

minLength: 1maxLength: 100

RequestMeta

Ceo model: RequestMeta

request_idNiz znakovaObavezno

Identifikator zahteva; u metapodacima odgovora označava HTTP zahtev.

minLength: 1maxLength: 100
Primer odgovora

HTTP status

200
Uspešan odgovor Šema
400
Nevažeći zahtev
401
Potrebna je autentifikacija
403
Pristup odbijen
404
Resurs nije pronađen
409
Sukob verzija
422
Provera nije uspela
429
Prekoračeno ograničenje zahteva
Ostali HTTP statusi (7)
405
Metoda nije dozvoljena
413
Zahtev je prevelik
415
Nepodržan format
500
Greška servera
502
Greška API mrežnog prolaza
503
Usluga nije dostupna
504
Istek vremena

Katalog grešaka: ErrorResponse

Zaglavlja

401

WWW-AuthenticateNiz znakovaOpciono

Šema autentifikacije koju zahteva server.

405

AllowNiz znakovaOpciono

HTTP metode koje ovaj resurs podržava.

429, 503

Retry-AfterCeli brojOpciono

Najkraće čekanje pre ponavljanja, u sekundama.

minimum: 0

Katalog grešaka · Saznajte više