Árbol del API · Tipos › Invoice

Factura

Invoice

Clase

Objeto

Dominio

Común

Campos

Lo usan

0 operaciones · 3 tipos

Una factura de la empresa con su cliente, su total y su saldo por cobrar. Es lo que llega en las listas; para descargar su XML o su PDF pide la factura con invoice(id:).

Los importes (total, paid, balance) llegan como texto decimal en la moneda de la factura: "4872.00", nunca como número flotante.

Las notas de crédito de la empresa también llegan con este tipo; el API aún no trae un dato que las distinga de las facturas, más allá de la serie de su folio.

Campos

Campo	Tipo	Descripción
`balance`Money	Money	Saldo por cobrar, en la moneda de la factura. Llega `null` si la factura no tiene cuenta por cobrar en AdvantaCloud.
`currency`String	String	Clave SAT de la moneda de la factura, p. ej. `MXN` o `USD`.
`customer`Customer	Customer	Cliente de la factura.
`dueDate`Date	Date	Fecha de vencimiento del pago de la factura. No se borra al cobrarse: la factura está vencida si esta fecha ya pasó y `balance` es mayor que cero. Llega `null` si la factura no tiene cuenta por cobrar.
`folio`String	String	Folio de la factura con su serie, p. ej. `FMTY26100154`.
`id`ID!	ID!	Identificador de la factura; úsalo con `invoice(id:)` y en las aplicaciones de `createCollection`.
`issuedAt`DateTime	DateTime	Fecha y hora de emisión de la factura.
`orders`(after: String, first: Int)OrderConnection	OrderConnection	Órdenes de venta incluidas en la factura, de la más antigua a la más reciente. Requiere «Ventas» en la llave; sin él llega `null`.20 por omisión, hasta 100 por página.
`paid`Money	Money	Lo cobrado de la factura (`total` menos `balance`); `null` cuando `balance` es `null`.
`rawStatus`String	String	Clave del estatus tal como la guarda AdvantaCloud; útil cuando `status` es `UNKNOWN`.
`status`InvoiceStatus!	InvoiceStatus!	Estatus de la factura.
`total`Money	Money	Total de la factura.
`uuid`String	String	Folio fiscal (UUID) del CFDI; `null` mientras la factura no se timbra.

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