Recupera un XML timbrado con tu cuenta usando solo su UUID. Este servicio consulta el almacenamiento de SW (Storage) y regresa los datos del comprobante, junto con las URLs para descargar el XML y el PDF.
✓Antes de empezar
1Obtén un Bearer Token con tu usuario y contraseña de SW. Se recomienda usar un token infinito.
2Ten a la mano el UUID del CFDI que quieres recuperar. Debe haberse timbrado con la misma cuenta del token.
💡 Servicio de Almacenamiento (Storage): este servicio recupera los XML timbrados en tu cuenta y está sujeto al almacenamiento que tengas contratado. Si necesitas ampliarlo, escríbenos a soporte@sw.com.mx.
💡 Nota: un comprobante recién timbrado puede tardar en estar disponible para consulta.
URL´s
Este servicio usa el dominio api, distinto al de timbrado. Elige el ambiente y todos los ejemplos se actualizan.
🔗 Endpoint
Ejemplo Request
💡 Nota: estos ejemplos están basados en los SDK de SW, pero puedes armar la petición directamente contra la API REST en el lenguaje que prefieras. El ejemplo cURL es la llamada REST directa.
Respuesta
💡 Nota: si el UUID no existe, está mal escrito, no se timbró con la cuenta autenticada o no está dentro de tu almacenamiento contratado, el servicio responde con
status igual a success pero con el arreglo records vacío. Eso indica que no hubo coincidencias.📋 Campos de data.records[]
El registro trae 51 campos que reflejan los datos del comprobante. Aquí se muestran los más importantes; da clic en Ver los 46 campos restantes para desplegar la tabla completa.
Campo
Tipo
Descripción
Principales
urlXml
string
URL de descarga del XML.
urlPDF
string | null
URL de descarga del PDF. Es null si no hay PDF generado dentro del ADT.
urlAckCfdi
string | null
URL de descarga del acuse del CFDI.
urlAckCancellation
string | null
URL de descarga del acuse de cancelación. Es null si el CFDI no se ha cancelado desde la cuenta.
urlAddenda
string | null
URL de descarga del XML con addenda. Solo retorna dato si el comprobante fue timbrado por cierto path que almacena la addenda en el ADT. Es
null si no aplica.Comprobante
version
string
Versión del CFDI.
serie
string
Serie del comprobante.
folio
string
Folio del comprobante.
fecha
string
Fecha de emisión del comprobante.
tipoDeComprobante
string
Tipo de comprobante.
statusSAT
int
Último estatus del comprobante almacenado en el ADT; no necesariamente es el actual. Para que refleje el último estatus, debe actualizarse en el ADT. Para consultar el estatus de una factura, se recomienda usar el servicio WS Consulta Estatus CFDI – Timbrado Masivo CFDI.
numeroCertificado
string
Número del certificado (CSD) con el que se selló el comprobante.
subTotal
number
Subtotal del comprobante.
descuento
number
Descuento del comprobante.
total
number
Total del comprobante.
moneda
string
Moneda del comprobante.
tipoCambio
number
Tipo de cambio de la moneda.
metodoPago
string
Método de pago. Viene vacío si el comprobante no lo incluye.
formaPago
string
Forma de pago. Viene vacía si el comprobante no la incluye.
condicionesPago
string
Condiciones de pago del comprobante.
luegarExpedicion
string
Lugar de expedición del CFDI(código postal).
complementos
string
Complementos del comprobante, separados por espacio (por ejemplo,
Pagos TimbreFiscalDigital).Emisor y receptor
emisorRfc
string
RFC del emisor.
emisorNombre
string
Nombre del emisor.
regimenFiscal
string
Clave del régimen fiscal del emisor.
receptorRfc
string
RFC del receptor.
receptorNombre
string
Nombre del receptor.
residenciaFiscal
string
Residencia fiscal del receptor extranjero. Vacío si no aplica.
numRegIdTrib
string
Número de registro de identidad tributaria del receptor extranjero. Vacío si no aplica.
usoCFDI
string
Clave del uso del CFDI que declaró el receptor.
Impuestos
totalImpuestosTraslados
number
Total de impuestos trasladados.
totalImpuestosRetencion
number
Total de impuestos retenidos.
trasladosIVA
number
IVA trasladado.
trasladosIEPS
number
IEPS trasladado.
retencionesISR
number
ISR retenido.
retencionesIVA
number
IVA retenido.
retencionesIEPS
number
IEPS retenido.
totalImpuestosLocalesTraslados
number
Total de impuestos locales trasladados si aplica.
totalImpuestosLocalesRetencion
number
Total de impuestos locales retenidos si aplica.
Timbrado
uuid
string
UUID del CFDI.
fechaTimbrado
string
Fecha en que se timbró el CFDI.
rfcProvCertif
string
RFC del proveedor de certificación que timbró el comprobante.
selloCFD
string
Sello digital del comprobante.
Adenda, PDF y cancelación
codigoCancelacion
string | null
Código de cancelación. Es
null si el CFDI no se ha cancelado.hasAddenda
boolean
Indica si el comprobante incluye adenda.
addenda
string | null
Contenido de la adenda. Es
null si no hay.fechaGeneracionPdf
string | null
Fecha en que se generó el PDF. Es
null si no hay PDF.Datos internos
idDealer
string
Identificador interno de la cuenta Delear o padre.
idUser
string
Identificador interno de la subcuenta o cuenta hija.
yearMonth
int
Año y mes del timbrado, en formato AAAAMM (por ejemplo,
202610).status
boolean
Indicador interno del registro.
Updated on noviembre 3, 2026