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
osku
: 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"
}
}
}
}
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 delandedCost
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.