Árbol del API · Tipos › InvoiceDetail
Factura con descargas
InvoiceDetail
Una factura con las ligas para descargar su XML y su PDF. La devuelve invoice(id:); en las listas la misma factura llega como Invoice, sin ligas.
Las ligas no llevan el header Authorization: cualquiera que tenga la liga
puede descargar el archivo mientras no venza, así que descárgalo desde tu
servidor en lugar de compartirla. Al descargar, AdvantaCloud vuelve a revisar
que la llave exista y conserve sus permisos: si la liga venció o la llave
perdió el permiso, responde HTTP 403. Para una liga nueva, vuelve a pedir la
factura.
Campos
15
| Campo | Tipo | Descripción |
|---|---|---|
balanceMoney |
Money | Saldo por cobrar, en la moneda de la factura. Llega null si la factura no tiene cuenta por cobrar en AdvantaCloud.
|
currencyString |
String | Clave SAT de la moneda de la factura, p. ej. MXN o USD.
|
customerCustomer |
Customer | Cliente de la factura. |
dueDateDate |
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.
|
folioString |
String | Folio de la factura con su serie, p. ej. FMTY26100154.
|
idID! |
ID! | Identificador de la factura. |
issuedAtDateTime |
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.
|
paidMoney |
Money | Lo cobrado de la factura (total menos balance); null cuando balance es null.
|
pdfUrlString |
String | Liga para descargar el PDF de la factura, que se genera al descargarlo con el formato de la empresa. Está firmada y vence a los 10 minutos. Llega null si la factura no está timbrada.
|
rawStatusString |
String | Clave del estatus tal como la guarda AdvantaCloud; útil cuando status es UNKNOWN.
|
statusInvoiceStatus! |
InvoiceStatus! | Estatus de la factura. |
totalMoney |
Money | Total de la factura. |
uuidString |
String | Folio fiscal (UUID) del CFDI; null mientras la factura no se timbra.
|
xmlUrlString |
String | Liga para descargar el XML del CFDI timbrado. Está firmada y vence a los 10 minutos. Llega null si la factura no está timbrada. Requiere «Consultar XML de Factura» en la llave; sin él llega null.
|
Dónde se usa
Schema del 26 oct 2026 · Descargar schema.graphql¿Algo no cuadra? Repórtalo en ayuda.advanta.mx