DOCS

Update orders

/

Sipariş Oluştur

Bir siparişteki öğeleri nasıl güncelleyeceğinizi öğrenin.

GraphQL

YAKINDA

Eğer bir sipariş oluşturduysanız ancak tüm öğelerin kısa gönderimler veya diğer beklenmedik durumlar nedeniyle yerine getirilemeyeceğini fark ettiyseniz, siparişten öğeleri kaldırmak için orderItemUpdate mutasyonunu kullanabilirsiniz. Bir öğe kaldırıldığında, yeni bir landedCost hesaplaması yapacağız ve bu sipariş için faturanızı, sizden alınacak yeni tutarı yansıtacak şekilde güncelleyeceğiz. Eğer zaten ücretlendirildiyseniz, bu tutarı gelecek faturanızda bir kredi olarak ekleyeceğiz.

Mutasyon Girişini Hazırlayın 

orderCreate mutasyonu belirli giriş verileri gerektirir. Ek alanlar mevcut olsa da, aşağıdaki alanlar zorunludur:

  • productId veya sku: Siparişteki öğeleri tanımlamak için kullandığınız ürün ID'si veya SKU (Sisteminizde ürünleri tanımlamak için kullandığınız değer).
  • accountOrderNumber: Siparişe atadığınız sipariş numarası (genellikle platformun sipariş numarası).

Bir siparişten yalnızca gönderilmemiş öğeleri kaldırabilirsiniz.

Mutasyonu Gönderin 

Gerekli giriş verilerine sahip olduğunuzda, seçtiğiniz istemci kütüphanesi veya aracı kullanarak GraphQL mutasyonunu API uç noktasına gönderin. İşte mutasyonu nasıl yapılandırabileceğinize dair bir örnek:

Mutasyon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
mutation {
  orderItemUpdate(
    orderId: "order_4f52ec0e-3467-11ed-b878-0242ac120002"
    accountOrderNumber: "AO-67890"
    itemId: "item_8659ec0e-3467-11ed-b878-0242ac120002"
    itemSku: "T123-BLUE"
    quantity: 1
  ) {
    order {
      accountOrderNumber
      createdAt
      createdBy
      currencyCode
      id
      items {
        id
        name
        quantity
        amount
        currencyCode
      }
      status
      updatedAt
      updatedBy
    }
  }
}

Yanıt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "data": {
    "orderItemUpdate": {
      "order": {
        "accountOrderNumber": "AO-67890",
        "createdAt": "2024-06-01T12:00:00Z",
        "createdBy": "user_3258ec0e-3467-11ed-b878-0242ac120002",
        "currencyCode": "USD",
        "id": "order_4f52ec0e-3467-11ed-b878-0242ac120002",
        "items": [
          {
            "id": "item_8659ec0e-3467-11ed-b878-0242ac120002",
            "name": "T-Shirt",
            "quantity": 0,
            "amount": 19.99,
            "currencyCode": "USD"
          }
        ],
        "status": "OPEN",
        "updatedAt": "2024-07-09T12:20:00Z",
        "updatedBy": "user_4258ec0e-3467-11ed-b878-0242ac120002"
      }
    }
  }
}

Bu sayfa yardımcı oldu mu?