Recuperar XML por UUID

Servicio para recuperar información de un XML timbrado con SW.

URL´s

🛠️ Pruebas:

https://api.test.sw.com.mx 📄

🚀 Productivo:

https://api.sw.com.mx 📄

Recuperar por UUID

Método para recuperar la información de un XML enviando el UUID de la factura, así como el token de la cuenta en la cual fue timbrada.

🔗 Endpoint

Método	Ruta
GET	/datawarehouse/v1/live/{uuid}

🔐 Autenticación y Headers

Header	Value
Authorization	Bearer Token

📍 Parámetros Path

Propiedad	Uso	Descripción
uuid	Requerido	UUID de la factura a recuperar

Ejemplo Request

curl --request GET \
  --url http://api.test.sw.com.mx/datawarehouse/v1/live/acc1d155-fb8a-42f4-9735-e43513eb9a32 \
  --header 'Authorization: Bearer $token'

Ejemplo Response

💡Nota Importante: En caso de que el UUID proporcionado no exista, esté mal escrito o no haya sido timbrado con la cuenta autenticada, el servicio responderá con un status igual a “success”, pero el arreglo records será vacío. Esto indica que no se encontraron coincidencias, sin que represente un error en la ejecución del servicio.

{
    "data": {
        "metaData": {
            "page": 1,
            "perPage": 10,
            "pageCount": 1,
            "totalCount": 1,
            "links": {
                "current": "?page=1&amp;perPage=10"
            }
        },
        "records": [
            {
                "status": "Vigente",
                "urlPDF": null,
                "urlAckCfdi": "https://smarter-datawarehouse-storage-test.s3.amazonaws.com/acusecfdi/2021/8/10/bbf8387e-aeef-45ba-92c1-939e28905e8e/bbf8387e-aeef-45ba-92c1-939e28905e8e/URE180429TM6/ab21a13a-7385-4493-bec1-52cfb53ec9a7.xml?AWSAccessKeyId=ASIAWONWNULEZNRAZU56&amp;Expires=1686378331&amp;x-amz-security-token=IQoJb3JpZ2luX2VjEBoaCXVzLWVhc3QtMSJHMEUCIEXVbFQXHjAXEfHlkE35WTeLZ9AomNPCApQHKZMv2DLnAiEAnFFbgIOJBaGyHtD5TRa9%2Bid92yi4oxkTUJub5Y5ut4sqowQIIhAAGgw0NDMzMDEwNzc3MDUiDM%2Fw5LveRzhXovVYZyqABORw%2FHAynMv407X8WOT7ghx4irkARE6co3GEGpRioXSG2p3o4VdobxsLIIDTrRvC7%2F6caBj%2FL2MVuuCn43s0OAS84OA9p%2FyNfe7euTDnW8LrlsUDX2BI1kuWMqnUt46g0Ti41UKy2N1J7JaxG8GYZXXZRZQC2QIEuW9jpn0RYgL0uXB%2FUER9bQMhN%2BG9THCODZqcciQ18IwcayT8p5OBb%2BZWZBNWW1aFPpRh6%2BzmKc1nNk1ugQ4TqSmJVH9JBPRCsJMknMsf2dJQzvRzTinSuFQyTfHiXP9XYhbTzjhxKD5TRDebq4MfcQ7DnWTOEkYCxVp6hDIbA6yautFJsfEV6wTLyfP1Eb4RWD4qSiopn%2BR%2B4kyk9X%2FpzXvpoytQNU3xr%2BVzPYhySQNqQOkSIFfcZFzJwnKmAr4WgAp%2BfPfBksTxmjK6SeoAokMQDFPvay8VWqOngoqUIsBGM%2FXUrCRk0l4gqHTWD4rz6%2FAoMTASM0RUcFC%2FlutWZjm8fkky3LYNZxob%2FMktbSpTGnoXUBpY00wf3mkpBR%2FiDi3Y2JixWGtQaVZXow%2FWcVw5o%2FZHKzqJ%2BtZu%2BOyqLwP%2FJclzKaqYbkpIT6rKCHtyzXVkdnSGxpGr7crCiHArnMhStHRX%2FWWyb5WtpBEazTd1zlsA7i78BiH545GBpK30bjENRZuSrWZRMMKxipUGOqYBdPAdbO%2B1iToxmd2BkDXP5Ye33BgSeCAelHKTsyghbPETZl61kzQtfKEp4rKzoSmNSjhQgYIcZ5xZTPSzNgtpNlwClCetCcXgireWuavioNH57RJpFPczsDAKfI7Hn8Hv2GG89zLrtDk6YPoGINuLr9W2PCrQbPlSSFUkyPVVhYt1rXXE27L9nHYTdIU50kBQS01p6Lge0JsADz%2F5bZZRPa95pSM65Q%3D%3D&amp;Signature=0NRioq6AHp%2BKceHaJrMhUL%2FA",
                "urlAckCancellation": null,
                "hasAddenda": false,
                "addenda": null,
                "urlAddenda": null,
                "fechaGeneracionPdf": null,
                "idDealer": "bbf8387e-aeef-45ba-92c1-939e2898e",
                "idUser": "bbf8387e-aeef-45ba-92c1-939e2898e",
                "version": "3.3",
                "serie": "-",
                "folio": "2080427802",
                "fecha": "2021-08-09T23:58:30",
                "numeroCertificado": "30001000000400002444",
                "subTotal": 0,
                "descuento": 0,
                "total": 0,
                "moneda": "XXX",
                "tipoCambio": 1,
                "tipoDeComprobante": "T",
                "metodoPago": "-",
                "formaPago": "-",
                "condicionesPago": "-",
                "luegarExpedicion": "50071",
                "emisorRfc": "URE180429TM6",
                "emisorNombre": "CV",
                "regimenFiscal": "624",
                "receptorRfc": "S1231112301231",
                "receptorNombre": "receptor, S.A. DE C.V.",
                "residenciaFiscal": "-",
                "numRegIdTrib": "-",
                "usoCFDI": "P01",
                "totalImpuestosTraslados": 0,
                "totalImpuestosRetencion": 0,
                "trasladosIVA": 0,
                "trasladosIEPS": 0,
                "retencionesISR": 0,
                "retencionesIVA": 0,
                "retencionesIEPS": 0,
                "totalImpuestosLocalesTraslados": 0,
                "totalImpuestosLocalesRetencion": 0,
                "complementos": "CartaPorte TimbreFiscalDigital",
                "uuid": "ab21a13a-7385-4493-bec1-52cfb53ec9a7",
                "fechaTimbrado": "2021-08-10T09:42:20",
                "rfcProvCertif": "SPR190613I52",
                "selloCFD": "Og1WO8ddkx3PgddGvBlcDPbr3SNFEvTu7TzCKtQ5P4N5w91vIi4zX28Io/AIOJwGWZa2Wd0UHxlEnioJulyj5vLnOeH740kczwUqhdtR3bI3hAs123WlZd5lls9AUsNVaPwnsKd3cPZF32NBEyfDWSUXAlkX64fGjUZxTQeerrRLwokfhwnLUZ+mCHBWqlXdPq73cIgu/ReWBv3euWDaQX48sBuqvuw7zL/ryRTRVKtkNNSXyZ1Ru/iO57HulD/jL0tHlMektVhfxmT5SsEYQncBxs6iBo5SyRhfEAmAsi24uUS3iMtqnMWAZR6TZXwgK91GrCK/vtwL2UPBw+ag==",
                "urlXml": "https://smarter-datawarehouse-storage-test.s3.amazonaws.com/cfdi33/2021/8/10/bbf8387e-aeef-45ba-92c1-939e28905e8e/bbf8387e-aeef-45ba-92c1-939e28905e8e/URE180429TM6/ab21a13a-7385-4493-bec1-52cfb53ec9a7.xml?AWSAccessKeyId=ASIAWONWNULEZNRAZU56&amp;Expires=1686378331&amp;x-amz-security-token=IQoJb3JpZ2luX2VjEBoaCXVzLWVhc3QtMSJHMEUCIEXVbFQXHjAXEfHlkE35WTeLZ9AomNPCApQHKZMv2DLnAiEAnFFbgIOJB123Ra9%2Bid92yi4oxkTUJub5Y5ut4sqowQIIhAAGgw0NDMzMDEwNzc3MDUiDM%2Fw5LveRzhXovVYZyqABORw%2FHAynMv407X8WOT7ghx4irkARE6co3GEGpRioXSG2p3o4VdobxsLIIDTrRvC7%2F6caBj%2FL2MVuuCn43s0OAS84OA9p%2FyNfe7euTDnW8LrlsUDX2BI1kuWMqnUt46g0Ti41UKy2N1J7JaxG8GYZXXZRZQC2QIEuW9jpn0RYgL0uXB%2FUER9bQMhN%2BG9THCODZqcciQ18IwcayT8p5OBb%2BZWZBNWW1aFPpRh6%2BzmKc1nNk1ugQ4TqSmJVH9JBPRCsJMknMsf2dJQzvRzTinSuFQyTfHiXP9XYhbTzjhxKD5TRDebq4MfcQ7DnWTOEkYCxVp6hDIbA6yautFJsfEV6wTLyfP1Eb4RWD4qSiopn%2BR%2B4kyk9X%2FpzXvpoytQNU3xr%2BVzPYhySQNqQOkSIFfcZFzJwnKmAr4WgAp%2BfPfBksTxmjK6SeoAokMQDFPvay8VWqOngoqUIsBGM%2FXUrCRk0l4gqHTWD4rz6%2FAoMTASM0RUcFC%2FlutWZjm8fkky3LYNZxob%2FMktbSpTGnoXUBpY00wf3mkpBR%2FiDi3Y2JixWGtQaVZXow%2FWcVw5o%2FZHKzqJ%2BtZu%2BOyqLwP%2FJclzKaqYbkpIT6rKCHtyzXVkdnSGxpGr7crCiHArnMhStHRX%2FWWyb5WtpBEazTd1zlsA7i78BiH545GBpK30bjENRZuSrWZRMMKxipUGOqYBdPAdbO%2B1iToxmd2BkDXP5Ye33BgSeCAelHKTsyghbPETZl61kzQtfKEp4rKzoSmNSjhQgYIcZ5xZTPSzNgtpNlwClCetCcXgireWuavioNH57RJpFPczsDAKfI7Hn8Hv2GG89zLrtDk6YPoGINuLr9W2PCrQbPlSSFUkyPVVhYt1rXXE27L9nHYTdIU50kBQS01p6Lge0JsADz%2F5bZZRPa95pSM65Q%3D%3D&amp;Signature=4vy4lQRhTAxzdCeEfaz%2FdHJNpD8%3D",
                "yearMonth": 202108
            }
        ]
    },
    "status": "success"
}

{
    "data": {
        "metaData": {
            "page": 1,
            "perPage": 10,
            "pageCount": 0,
            "totalCount": 0,
            "links": {
                "current": "?page=1&amp;perPage=10"
            }
        },
        "records": []
    },
    "status": "success"
}

Atributo	Tipo	Descripción
data	object/null	Contiene los datos de la consulta, incluyendo metadatos de paginación (`metaData`) y el arreglo `records`. Dentro de “records” vendrá la información referente al XML, como el URL para descargar el XML y el PDF en caso de existir.
status	String	“success”.

Probar en Postman

En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este articulo y dejando tus comentarios.

Updated on agosto 5, 2025