Árbol del API · Pedidos › ordersConnection

Lista de órdenes de venta

ordersConnection

Tipo

Query

Devuelve

OrderConnection!

Permiso de la llave

Ventas

Página

20 por omisión · máx. 100

Estable

Lista las órdenes de venta de la empresa, de la más reciente a la más antigua. Filtra por cliente, vendedor, almacén, estatus, origen y rango de fechas, y recorre el resultado por páginas con cursores.

Úsala para llevar las órdenes de venta a tu sistema: pide sólo los campos que necesitas y continúa con after hasta que hasNextPage sea false. Para traer una sola orden con todas sus partidas usa order(id:).

La llave ve las órdenes de toda la empresa del subdominio, sin importar quién las capturó.

ordersConnection(
  first: Int  after: String  customerId: ID
  customerName: String  folio: String
  status: [OrderStatus!]  origin: [OrderOrigin!]
  from: Date  to: Date  warehouseId: ID
  salespersonId: ID  saleTypeId: ID
  purchaseOrder: String  reference: String  userId: ID
  sort: OrderSort = CREATED_AT_DESC
): OrderConnection!

# ordenes.graphql
query Ordenes($desde: Date!, $cursor: String) {
  ordersConnection(
    first: 50
    after: $cursor
    status: [CONFIRMED]
    from: $desde
    sort: FOLIO_DESC
  ) {
    nodes {
      id
      folio
      status
      createdAt
      customer { name rfc }
      warehouse { code name }
      currency
      subtotal
      tax
      total
    }
    pageInfo { hasNextPage endCursor }
  }
}

Variables: {"desde": "2026-10-01", "cursor": null}

jq -n --rawfile q ordenes.graphql \
  '{query: $q, variables: {"desde":"2026-10-01","cursor":null}}' |
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("ordenes.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: { desde: "2026-10-01", cursor: null },
  }),
});
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.ordersConnection);

import os, requests

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

cursor, nodos = None, []
while True:
    r = requests.post(URL, headers=HEADERS, timeout=30, json={
        "query": QUERY,
        "variables": {"desde": "2026-10-01", "cursor": cursor},
    })
    r.raise_for_status()
    body = r.json()
    if "errors" in body:
        raise RuntimeError(body["errors"][0]["message"])
    page = body["data"]["ordersConnection"]
    nodos += page["nodes"]
    if not page["pageInfo"]["hasNextPage"]:
        break
    cursor = page["pageInfo"]["endCursor"]

<?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('ordenes.graphql'),
        'variables' => ['desde' => '2026-10-01', 'cursor' => null],
    ]),
]);
$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']['ordersConnection'];

Respuesta 200 OK · 2 de 50 nodos

{
  "data": {
    "ordersConnection": {
      "nodes": [
        {
          "id": "48213",
          "folio": "OV00512",
          "status": "CONFIRMED",
          "createdAt": "2026-10-24T11:42:08.000000-06:00",
          "customer": {
            "name": "Público en General",
            "rfc": "XAXX010101000"
          },
          "warehouse": {
            "code": "MTY01",
            "name": "Monterrey Centro"
          },
          "currency": "MXN",
          "subtotal": "4200.00",
          "tax": "672.00",
          "total": "4872.00"
        },
        {
          "id": "48190",
          "folio": "OV00509",
          "status": "CONFIRMED",
          "createdAt": "2026-10-23T17:05:51.000000-06:00",
          "customer": {
            "name": "Ferretería Hermanos Garza",
            "rfc": "XAXX010101000"
          },
          "warehouse": {
            "code": "GDL02",
            "name": "Guadalajara Periférico"
          },
          "currency": "MXN",
          "subtotal": "16000.00",
          "tax": "2560.00",
          "total": "18560.00"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "WzEsInh2b21zIiwiaWR2bnRhIix0cnVlLCJPVjAwNTA5Iiw0ODE5MF0="
      }
    }
  }
}

Ver en el explorador

Argumentos

Argumento	Tipo	Descripción
Paginación
`first`Int	Int	Cuántas órdenes devolver desde el inicio o desde `after`. Sin `first` llegan 20; si pides más de 100 recibes 100.
`after`String	String	Cursor de la página anterior (`pageInfo.endCursor`). Devuelve las órdenes que siguen.
Filtros
`customerId`ID	ID	Sólo las órdenes de este cliente.
`customerName`String	String	Nombre del cliente que contiene el texto, sin distinguir mayúsculas.
`folio`String	String	Folio que contiene el texto: `"512"` encuentra `OV00512`.
`status`[OrderStatus!]	[OrderStatus!]	Uno o varios estatus; basta con que la orden tenga uno de ellos.
`origin`[OrderOrigin!]	[OrderOrigin!]	Dónde se capturó: orden de venta (`OV`), venta mostrador (`VM`), punto de venta (`PV`)… Sin este filtro no llegan las cotizaciones de venta (`CV`); pídelas con `origin: [CV]`.
`from`Date	Date	Capturadas desde este día, inclusive (`AAAA-MM-DD`).
`to`Date	Date	Capturadas hasta este día, inclusive. Con Llave API el día se corta en la hora del centro de México.
`warehouseId`ID	ID	Almacén que surte la orden.
`salespersonId`ID	ID	Vendedor asignado.
`saleTypeId`ID	ID	Tipo de venta.
`purchaseOrder`String	String	Orden de compra del cliente que contiene el texto.
`reference`String	String	Referencia de la orden que contiene el texto.
`userId`ID	ID	Usuario que capturó la orden.
Orden
`sort`OrderSort	OrderSort	`CREATED_AT_DESC`: más recientes primero. `FOLIO_DESC`: folio descendente. Si lo omites o envías `null`, se usa `CREATED_AT_DESC`. Por omisión: `CREATED_AT_DESC`

Estatus de una orden

OrderStatus

REGISTEREDRegistrada, aún sin confirmar

PRECONFIRMEDPreconfirmada por el vendedor

PENDING_CONFIRMATIONPor confirmar

CONFIRMEDConfirmada

PENDING_APPROVALEn espera de aprobación

REJECTEDRechazada

SOLDVendida

CLOSEDCerrada

CANCELLEDCancelada

QUOTEDCotización de mostrador

QUOTE_REQUESTEDCotización solicitada

QUOTE_SENTCotización enviada al cliente

QUOTE_APPROVEDCotización aprobada por el cliente

QUOTE_DECLINEDCotización rechazada por el cliente

QUOTE_EXPIREDCotización vencida

QUOTE_CONVERTEDCotización convertida en orden

UNKNOWNSin equivalente; revisa rawStatus

Ver OrderStatus

Lo que devuelve

OrderConnection!

nodes[Order]Las órdenes de esta página. La forma más corta de leerlas.

edges[OrderEdge]Las mismas órdenes, cada una con su cursor.

pageInfoPageInfo!Dónde estás en la lista.

hasNextPageBoolean!Hay más elementos después de esta página.

endCursorStringCursor del último elemento; pásalo en after para pedir la página siguiente.

hasPreviousPageBoolean!true si pediste esta página con after, es decir, si no es la primera.

startCursorStringCursor del primer elemento de esta página.

Campos principales de Order

Campo	Tipo	Descripción
`id`ID	ID	Identificador de la orden; úsalo con `order(id:)`.
`folio`String	String	Folio visible en la aplicación y en los documentos, p. ej. `OV00512`.
`status`OrderStatus!	OrderStatus!	Estatus de la orden.
`origin`OrderOrigin!	OrderOrigin!	Dónde se capturó la orden.
`createdAt`DateTime	DateTime	Fecha y hora de captura, con su desfase horario.
`customer`Customer	Customer	Cliente de la orden.
`salesperson`Employee	Employee	Vendedor asignado.
`warehouse`Warehouse	Warehouse	Almacén que surte la orden.
`currency`String	String	Clave de la moneda de la orden, p. ej. `MXN`.
`subtotal`Money	Money	Importe antes de impuestos.
`discount`Money	Money	Descuento total.
`tax`Money	Money	Impuestos.
`total`Money	Money	Total de la orden.
`openBalance`Money	Money	Saldo por cobrar de la orden.
`invoiceStatus`String	String	Estatus de facturación; vacío mientras la orden no se factura.
`lines`OrderLineConnection!	OrderLineConnection!	Partidas de la orden por número de partida, paginadas con cursores igual que las listas.20 por omisión, hasta 100 por página.
`shipment`OrderShipment!	OrderShipment!	Avance del embarque de la orden.

Ver todos los campos de Order

Paginación

first · after

Pide hasta 100 órdenes por página junto con pageInfo. Repite la misma consulta pasando endCursor en after mientras hasNextPage sea true. El orden es estable: no se saltan órdenes entre páginas. Más sobre paginación.

Las partidas de cada orden (lines) son otra conexión con su propio límite de 100. Si una orden tiene más, pide el resto con order(id:) y lines(after:).

Permisos

Llave API Integraciones

Ventas

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

Sin el permiso Sin error

La consulta responde sin error, pero nodes llega vacío y hasNextPage es false.

Así lo conserva el API para las integraciones que ya lo usan: revisa los permisos de la llave si una lista llega vacía sin razón.

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.
`argumentLiteralsIncompatible`	Un argumento escrito en la consulta no tiene el tipo esperado: una fecha que no es `AAAA-MM-DD` o un estatus fuera de `OrderStatus`. Si el valor llega en una variable, el error trae `extensions.problems` y puede no traer `code`.	Corrige la consulta; reintentar no ayuda.
`undefinedField`	Pides un campo que no existe en el tipo.	Revisa el nombre del campo en esta página o en el explorador.
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