DOCS

Actualizar pedidos

Crear pedidos

Aprende cómo actualizar artículos en un pedido.

PRÓXIMAMENTE

Si has creado un pedido pero te das cuenta de que no todos los artículos pueden ser cumplidos debido a envíos incompletos u otras circunstancias imprevistas, puedes usar la mutación orderItemUpdate para eliminar artículos del pedido. Una vez que se elimina un artículo, realizaremos un nuevo cálculo de landedCost y actualizaremos la factura de este pedido para reflejar el nuevo monto que se te cobrará. Si ya se te ha cobrado, añadiremos esa cantidad como un crédito en tu próxima factura.

Preparar 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 utilizas para identificar artículos en el pedido (El valor que usas para identificar productos en tu sistema).
  • accountOrderNumber: El número de pedido que asignaste al pedido (a menudo el número de pedido de la plataforma).

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

Enviar la mutación 

Una vez que tengas los datos de entrada requeridos, envía la mutación GraphQL al punto final de la API utilizando la biblioteca o herramienta de cliente que elijas. Aquí tienes un ejemplo de cómo puedes 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?