Árbol del API · Tipos › Customer

Cliente

Customer

Clase

Objeto

Dominio

Común

Campos

Lo usan

0 operaciones · 5 tipos

Un cliente de la empresa con sus datos de contacto, su crédito, su saldo y sus valores para las órdenes de venta.

Los importes (creditLimit, balance, overdueBalance, availableCredit) llegan como texto decimal en la moneda de crédito del cliente: "48720.00", nunca como número flotante.

Campos

Campo	Tipo	Descripción
`addresses`(after: String, first: Int)CustomerAddressConnection!	CustomerAddressConnection!	Lugares de entrega del cliente, del modificado hace más tiempo al más reciente.20 por omisión, hasta 100 por página.
`auxPriceStructure`PriceStructure	PriceStructure	Estructura de precios auxiliar. Cuando el cliente tiene una, sus precios tienen prioridad sobre los de `priceStructure`. Requiere «Cliente» en la llave; sin él llega `null`.
`availableCredit`Money	Money	Crédito disponible, `creditLimit` menos `balance`. Requiere «Cliente» en la llave; sin él llega `null`.
`balance`Money	Money	Saldo por cobrar: las parcialidades pendientes de sus facturas, vencidas y por vencer, menos los cobros que aún no se aplican a una factura. Es negativo si el cliente tiene saldo a favor. Requiere «Cliente» en la llave; sin él llega `null`.
`code`String	String	Clave del cliente, p. ej. `C-0042`.
`contacts`[CustomerContact!]!	[CustomerContact!]!	Contactos del cliente, ordenados por nombre.
`creditCurrency`String	String	Clave SAT de la moneda de crédito, p. ej. `MXN`. El límite y los saldos están en esta moneda. Requiere «Cliente» en la llave; sin él llega `null`.
`creditLimit`Money	Money	Límite de crédito, en la moneda de crédito (`creditCurrency`). Requiere «Cliente» en la llave; sin él llega `null`.
`creditTerm`CreditTerm	CreditTerm	Término de crédito del cliente; es el que se propone en sus órdenes.
`documentCurrency`Currency	Currency	Moneda de los documentos del cliente.
`email`String	String	Correo electrónico.
`id`ID!	ID!	Identificador del cliente; es el que se envía en `customerId`.
`name`String	String	Nombre del cliente.
`noreco`String	String	Número del cliente en el programa de recompensas.
`overdueBalance`Money	Money	Importe de las parcialidades ya vencidas, sin descontar los cobros por aplicar. Requiere «Cliente» en la llave; sin él llega `null`.
`pendingInvoicesCount`Int!	Int!	Número de facturas con saldo por cobrar, sin contar las facturas de anticipo. Requiere «Cliente» en la llave; sin él la petición responde HTTP 422.
`phone`String	String	Teléfono.
`priceStructure`PriceStructure	PriceStructure	Estructura de precios principal del cliente. Requiere «Cliente» en la llave; sin él llega `null`.
`rfc`String	String	RFC del cliente.
`salesperson`Employee	Employee	Vendedor asignado al cliente.
`shippingMethod`ShippingMethod	ShippingMethod	Forma de embarque del cliente; es la que toman sus órdenes si no envías otra.
`updatedAt`DateTime	DateTime	Fecha y hora de la última modificación del cliente; úsala con `customersConnection(updatedAfter:)`.
`vtplus`Boolean!	Boolean!	`true` si el cliente puede comprar con tipos de venta «Venta Plus».

Dónde se usa

Seguir sus relaciones en el explorador

Schema del 26 oct 2026 · Descargar schema.graphql¿Algo no cuadra? Repórtalo en ayuda.advanta.mx