DOCS

Update orders

/

Crear pedidos

Aprenda cómo actualizar elementos en un pedido.

GraphQL

PRÓXIMAMENTE

Si ha creado un pedido pero se da cuenta de que no todos los artículos se pueden cumplir debido a envíos incompletos u otras circunstancias imprevistas, puede utilizar la mutación orderItemUpdate para eliminar artículos del pedido. Una vez que se elimina un artículo, realizaremos un nuevo cálculo de costo de llegada y actualizaremos la factura de este pedido para reflejar el nuevo monto que se le cobrará. Si ya ha sido cobrado, agregaremos ese monto como un crédito en su próxima factura.

Prepare la entrada de la mutación 

La mutación orderCreate requiere datos de entrada específicos. Si bien hay campos adicionales disponibles, los siguientes campos son obligatorios:

  • productId o sku: El ID del producto o SKU que utiliza para identificar los artículos en el pedido (El valor que utiliza para identificar productos en su sistema).
  • accountOrderNumber: El número de pedido que asignó al pedido (a menudo el número de pedido de la plataforma).

Solo puede eliminar artículos de un pedido si no han sido enviados.

Envíe la mutación 

Una vez que tenga los datos de entrada requeridos, envíe la mutación GraphQL al punto final de la API utilizando su biblioteca de cliente o herramienta elegida. Aquí hay un ejemplo de cómo puede estructurar la mutación:

Mutación

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
    }
  }
}

Respuesta

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"
      }
    }
  }
}

¿Fue útil esta página?