Árbol del API · Pedidos › quoteOrder

Cotizar una orden

quoteOrder

Tipo

Query

Devuelve

OrderQuote

Permiso de la llave

Creacion de Orden de Venta

Estable

Calcula precios, descuentos, impuestos y totales de una orden sin guardarla. Devuelve la orden calculada y las advertencias de existencia, precio y crédito.

Es una consulta: no guarda nada, no asigna folio y no necesita idempotencyKey. Úsala para mostrar el total antes de confirmar o para saber el precio vigente de cada partida.

Copia el unitPrice de cada partida cotizada en expectedUnitPrice al llamar a createOrder: si el precio cambió entre la cotización y la creación, la orden no se guarda y lo sabrás.

NO_STOCK avisa que no hay existencia suficiente y CREDIT_EXCEEDED que el cliente rebasa su crédito; ninguna impide crear la orden. PRICE_CHANGED avisa que un expectedUnitPrice ya no coincide: la cotización se completa, pero createOrder rechazará esa partida hasta que envíes el precio vigente.

quoteOrder(
  input: OrderInput!
): OrderQuote

# cotizar.graphql
query Cotizar($input: OrderInput!) {
  quoteOrder(input: $input) {
    order {
      subtotal
      discount
      tax
      total
      lines { nodes { product { idpart } quantity unitPrice total } }
    }
    warnings
  }
}

jq -n --rawfile q cotizar.graphql \
  '{query: $q, variables: {"input":{"userId":"35","customerId":"1207","warehouseId":"3","priceStructureId":"4","saleTypeId":"1","creditTermId":"2","currencyId":"1","lines":[{"productId":"5521","quantity":"1200.00"},{"productId":"5530","quantity":"1200.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("cotizar.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: {
      input: {
        userId: "35",
        customerId: "1207",
        warehouseId: "3",
        priceStructureId: "4",
        saleTypeId: "1",
        creditTermId: "2",
        currencyId: "1",
        lines: [
          { productId: "5521", quantity: "1200.00" },
          { productId: "5530", quantity: "1200.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);
console.log(data.quoteOrder);

import os, requests

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

r = requests.post(URL, headers=HEADERS, timeout=30, json={
    "query": QUERY,
    "variables": {
        "input": {
            "userId": "35",
            "customerId": "1207",
            "warehouseId": "3",
            "priceStructureId": "4",
            "saleTypeId": "1",
            "creditTermId": "2",
            "currencyId": "1",
            "lines": [
                {"productId": "5521", "quantity": "1200.00"},
                {"productId": "5530", "quantity": "1200.00"},
            ],
        },
    },
})
r.raise_for_status()
body = r.json()
if "errors" in body:
    raise RuntimeError(body["errors"][0]["message"])
print(body["data"]["quoteOrder"])

<?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('cotizar.graphql'),
        'variables' => [
            'input' => [
                'userId' => '35',
                'customerId' => '1207',
                'warehouseId' => '3',
                'priceStructureId' => '4',
                'saleTypeId' => '1',
                'creditTermId' => '2',
                'currencyId' => '1',
                'lines' => [
                    ['productId' => '5521', 'quantity' => '1200.00'],
                    ['productId' => '5530', 'quantity' => '1200.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']['quoteOrder'];

Variables

{
  "input": {
    "userId": "35",
    "customerId": "1207",
    "warehouseId": "3",
    "priceStructureId": "4",
    "saleTypeId": "1",
    "creditTermId": "2",
    "currencyId": "1",
    "lines": [
      {
        "productId": "5521",
        "quantity": "1200.00"
      },
      {
        "productId": "5530",
        "quantity": "1200.00"
      }
    ]
  }
}

Respuesta 200 OK

{
  "data": {
    "quoteOrder": {
      "order": {
        "subtotal": "4200.00",
        "discount": "0.00",
        "tax": "672.00",
        "total": "4872.00",
        "lines": {
          "nodes": [
            {
              "product": {
                "idpart": "TOR-0420"
              },
              "quantity": "1200.00",
              "unitPrice": "2.50",
              "total": "3480.00"
            },
            {
              "product": {
                "idpart": "TUE-0420"
              },
              "quantity": "1200.00",
              "unitPrice": "1.00",
              "total": "1392.00"
            }
          ]
        }
      },
      "warnings": [
        "NO_STOCK"
      ]
    }
  }
}

Ver en el explorador

Argumentos

Argumento	Tipo	Descripción
`input`OrderInput!	OrderInput!	La orden a cotizar, con los mismos datos que enviarás a `createOrder`. Ver `OrderInput`. Obligatorio.

Advertencias de una orden

OrderWarning

NO_STOCKNo hay existencia suficiente de algún artículo en el almacén

PRICE_CHANGEDEl precio de una partida ya no coincide con su expectedUnitPrice; createOrder la rechaza con CONFLICT

CREDIT_EXCEEDEDLa orden rebasa el crédito disponible del cliente

Ver OrderWarning

Lo que devuelve

OrderQuote

Campos principales de OrderQuote:

Campo	Tipo	Descripción
`order`Order!	Order!	La orden con precios, descuentos, impuestos y totales calculados. No tiene `id` ni folio.
`warnings`[OrderWarning!]!	[OrderWarning!]!	Advertencias de existencia, precio y crédito.

Ver todos los campos de OrderQuote

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 no es válido: la estructura de precios no es del cliente, una cantidad no es positiva, un artículo está inactivo, hay más de 100 partidas o falta `userId`. Si el error es de una partida, `extensions.field` dice cuál, por ejemplo `lines[1].quantity`.	Corrige el dato indicado.
`NOT_FOUND`	El cliente, el almacén, el artículo u otro dato de la orden no existe.	Revisa los identificadores; `extensions.field` puede indicar cuál falló.
`INACTIVE`	El almacén, el tipo de venta, el término de crédito, el proyecto o la forma de embarque existe, pero ya no se ofrece.	Pide opciones vigentes con `orderDefaults`.
`CONFLICT`	Una regla del negocio impide calcular la orden con esos datos.	Lee el mensaje; reintentar sin cambios no ayuda.
HTTP 422	Falla interna o dato rechazado al guardar. El cuerpo es `{"error": …}`, sin `data`.	Si no cambiaste nada, reintenta con espera exponencial.

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