DOCS

Siparişleri Güncelle

Sipariş Oluştur

Sipariş üzerindeki öğeleri nasıl güncelleyeceğinizi öğrenin.

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 fatura güncellenerek sizden alınacak yeni tutarı yansıtacaktır. 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?