Árbol del API · Pedidos › createOrder

Crear una orden de venta

createOrder

Tipo

Mutation

Devuelve

CreateOrderPayload

Permiso de la llave

Creacion de Orden de Venta

Reintentos

Seguros con idempotencyKey

Estable

Registra una orden de venta nueva con sus partidas. La orden queda registrada (REGISTERED), sin confirmar y sin apartar inventario.

La orden se registra a nombre del usuario de input.userId y con el precio vigente de cada artículo. Envía en expectedUnitPrice el precio que te dio quoteOrder: si cambió, la orden no se guarda y recibes CONFLICT en esa partida. Una partida con precio manual (unitPrice) no se compara.

Revisa siempre createOrder.errors y también errors de la respuesta: un error puede llegar en cualquiera de los dos y, con errores, order llega null. Las advertencias (warnings) de una orden creada no la invalidan.

Reintentos seguros

Si la conexión se corta y no sabes si la orden se creó, repite la petición con la misma idempotencyKey y los mismos datos: recibes la orden que ya se creó, sin duplicarla. La respuesta muestra la orden como está en ese momento, no una copia de la primera respuesta. La clave se recuerda alrededor de 30 días. Una clave repetida con datos distintos responde CONFLICT.

createOrder(
  input: OrderInput!  idempotencyKey: String!
): CreateOrderPayload

# crear-orden.graphql
mutation CrearOrden($input: OrderInput!, $clave: String!) {
  createOrder(input: $input, idempotencyKey: $clave) {
    order { id folio status total }
    warnings
    errors { field code message }
  }
}

jq -n --rawfile q crear-orden.graphql \
  '{query: $q, variables: {"clave":"pedido-web-100482","input":{"userId":"35","customerId":"1207","warehouseId":"3","priceStructureId":"4","saleTypeId":"1","creditTermId":"2","currencyId":"1","addressId":"88","deliveryDate":"2026-10-30","noocmp":"OC-2026-0193","notes":"Entregar por la mañana","lines":[{"productId":"5521","quantity":"1200.00","expectedUnitPrice":"2.50"},{"productId":"5530","quantity":"1200.00","expectedUnitPrice":"1.00"}]}}}' |
curl https://mi-empresa.advantacloud.com/graphql \
  -H "Authorization: Bearer $ADVANTA_API_KEY" \
  -H "Content-Type: application/json" \
  --data @-

import { readFile } from "node:fs/promises";

const query = await readFile("crear-orden.graphql", "utf8");

const res = await fetch("https://mi-empresa.advantacloud.com/graphql", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ADVANTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query,
    variables: {
      clave: "pedido-web-100482",
      input: {
        userId: "35",
        customerId: "1207",
        warehouseId: "3",
        priceStructureId: "4",
        saleTypeId: "1",
        creditTermId: "2",
        currencyId: "1",
        addressId: "88",
        deliveryDate: "2026-10-30",
        noocmp: "OC-2026-0193",
        notes: "Entregar por la mañana",
        lines: [
          {
            productId: "5521",
            quantity: "1200.00",
            expectedUnitPrice: "2.50",
          },
          {
            productId: "5530",
            quantity: "1200.00",
            expectedUnitPrice: "1.00",
          },
        ],
      },
    },
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);

const { data, errors } = await res.json();
if (errors) throw new Error(errors[0].extensions?.code ?? errors[0].message);
if (data.createOrder.errors.length) throw new Error(data.createOrder.errors[0].code);
console.log(data.createOrder);

import os, requests

URL = "https://mi-empresa.advantacloud.com/graphql"
HEADERS = {"Authorization": f"Bearer {os.environ['ADVANTA_API_KEY']}"}
QUERY = open("crear-orden.graphql").read()

r = requests.post(URL, headers=HEADERS, timeout=30, json={
    "query": QUERY,
    "variables": {
        "clave": "pedido-web-100482",
        "input": {
            "userId": "35",
            "customerId": "1207",
            "warehouseId": "3",
            "priceStructureId": "4",
            "saleTypeId": "1",
            "creditTermId": "2",
            "currencyId": "1",
            "addressId": "88",
            "deliveryDate": "2026-10-30",
            "noocmp": "OC-2026-0193",
            "notes": "Entregar por la mañana",
            "lines": [
                {
                    "productId": "5521",
                    "quantity": "1200.00",
                    "expectedUnitPrice": "2.50",
                },
                {
                    "productId": "5530",
                    "quantity": "1200.00",
                    "expectedUnitPrice": "1.00",
                },
            ],
        },
    },
})
r.raise_for_status()
body = r.json()
if "errors" in body:
    raise RuntimeError(body["errors"][0]["message"])
if body["data"]["createOrder"]["errors"]:
    raise RuntimeError(body["data"]["createOrder"]["errors"][0]["code"])
print(body["data"]["createOrder"])

<?php
$ch = curl_init('https://mi-empresa.advantacloud.com/graphql');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ADVANTA_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'query' => file_get_contents('crear-orden.graphql'),
        'variables' => [
            'clave' => 'pedido-web-100482',
            'input' => [
                'userId' => '35',
                'customerId' => '1207',
                'warehouseId' => '3',
                'priceStructureId' => '4',
                'saleTypeId' => '1',
                'creditTermId' => '2',
                'currencyId' => '1',
                'addressId' => '88',
                'deliveryDate' => '2026-10-30',
                'noocmp' => 'OC-2026-0193',
                'notes' => 'Entregar por la mañana',
                'lines' => [
                    [
                        'productId' => '5521',
                        'quantity' => '1200.00',
                        'expectedUnitPrice' => '2.50',
                    ],
                    [
                        'productId' => '5530',
                        'quantity' => '1200.00',
                        'expectedUnitPrice' => '1.00',
                    ],
                ],
            ],
        ],
    ]),
]);
$respuesta = curl_exec($ch);
$estatus = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($respuesta === false || $estatus !== 200) {
    throw new RuntimeException("HTTP $estatus " . curl_error($ch));
}
$body = json_decode($respuesta, true);
if (!empty($body['errors'])) {
    throw new RuntimeException($body['errors'][0]['message']);
}
$resultado = $body['data']['createOrder'];
if (!empty($resultado['errors'])) {
    throw new RuntimeException($resultado['errors'][0]['code']);
}

Variables

{
  "clave": "pedido-web-100482",
  "input": {
    "userId": "35",
    "customerId": "1207",
    "warehouseId": "3",
    "priceStructureId": "4",
    "saleTypeId": "1",
    "creditTermId": "2",
    "currencyId": "1",
    "addressId": "88",
    "deliveryDate": "2026-10-30",
    "noocmp": "OC-2026-0193",
    "notes": "Entregar por la mañana",
    "lines": [
      {
        "productId": "5521",
        "quantity": "1200.00",
        "expectedUnitPrice": "2.50"
      },
      {
        "productId": "5530",
        "quantity": "1200.00",
        "expectedUnitPrice": "1.00"
      }
    ]
  }
}

Respuesta 200 OK

{
  "data": {
    "createOrder": {
      "order": {
        "id": "48231",
        "folio": "OV00513",
        "status": "REGISTERED",
        "total": "4872.00"
      },
      "warnings": [],
      "errors": []
    }
  }
}

Ver en el explorador

Argumentos

Argumento	Tipo	Descripción
Orden
`input`OrderInput!	OrderInput!	Los datos de la orden y sus partidas (de 1 a 100). Ver `OrderInput`. Obligatorio.
Reintentos
`idempotencyKey`String!	String!	Clave única que generas por cada orden, por ejemplo un UUID o el folio de tu sistema. Si repites la petición con la misma clave y los mismos datos, recibes la orden que ya se creó en lugar de una nueva. Obligatorio.

Lo que devuelve

CreateOrderPayload

Campos principales de CreateOrderPayload:

Campo	Tipo	Descripción
`order`Order	Order	La orden creada; `null` si hubo errores.
`warnings`[OrderWarning!]	[OrderWarning!]	Advertencias de existencia y crédito de la orden creada.
`errors`[FieldError!]!	[FieldError!]!	Errores que impidieron crear la orden; vacía si se creó.

Ver todos los campos de CreateOrderPayload

Permisos

Llave API Integraciones

Creacion de Orden de Venta

La llave ve los registros de toda la empresa del subdominio.

Sin el permiso HTTP 422

La respuesta es HTTP 422 con el cuerpo {"error": "invalid_graphql_request"}, sin data.

Errores

Código	Cuándo ocurre	Qué hacer
HTTP 401	Falta el header `Authorization` o la llave no existe en la empresa del subdominio. La respuesta no trae cuerpo.	Revisa la llave y el subdominio. No reintentes.
HTTP 422	La llave no tiene «Creacion de Orden de Venta». La respuesta es HTTP 422 con el cuerpo `{"error": "invalid_graphql_request"}`, sin `data`.	La llave necesita ese permiso; reintentar no ayuda.
`VALIDATION`	Un dato de la orden no es válido. Puede llegar en `createOrder.errors` (por ejemplo `field: "lines[0].quantity"`) o en `errors` de la respuesta (por ejemplo, falta `userId`, la estructura de precios no es del cliente o hay más de 100 partidas). Revisa los dos.	Corrige el dato y vuelve a enviar con una clave nueva.
`CONFLICT`	El precio de una partida ya no es el `expectedUnitPrice` que enviaste (`field`: `lines[i].expectedUnitPrice`), o la `idempotencyKey` ya se usó con otros datos.	Vuelve a cotizar con `quoteOrder`; para otros datos usa otra clave.
`NOT_FOUND`	Un identificador del `input` no existe; `field` puede decir cuál.	Revisa los identificadores.
`INACTIVE`	Un catálogo del `input` existe pero ya no se ofrece.	Pide opciones vigentes con `orderDefaults`.
HTTP 422	Falla interna o dato rechazado al guardar. El cuerpo es `{"error": …}`, sin `data`.	Si no cambiaste nada, reintenta con la misma `idempotencyKey`.

Los errores de la consulta llegan con HTTP 200 en errors, con su código en extensions.code. Revisa siempre errors, no sólo el estatus HTTP. Errores y reintentos.

Relacionadas

Schema del 26 oct 2026 · Ver cambios¿Algo no cuadra? Repórtalo en ayuda.advanta.mx