Mostrar validación de recibo CFE

Este endpoint te permite obtener el detalle de una validación de recibo CFE filtrando por su UUID, incluyendo los datos oficiales del recibo y el enlace de descarga del comprobante.

Es también la alternativa al webhook: si prefieres no exponer una URL pública, puedes consultar periódicamente este endpoint hasta que el campo status deje de ser pendiente.

Método: GET

Endpoint

https://api.verificamex.com/identity/v1/miscellaneous/cfe/recibo/{uuid}

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Encabezado	Valor	Descripción
Accept	`application/json`	Tipo de contenido de la solicitud.
Authorization	`Bearer {tu_token}`	Token generado para autenticar al usuario.

Parámetros de la Solicitud

Parámetro	Tipo	Descripción
uuid	`String`	UUID de la validación, devuelto al crearla con Validar recibo de CFE.

Campos de la Respuesta

Campo	Descripción
status	Estado de la validación: `pendiente`, `OK`, `DATOS_NO_COINCIDEN` o `ERROR`.
result.verificado	`true` únicamente cuando los datos coinciden con el recibo emitido por CFE.
result.mensaje	Descripción legible del resultado.
result.codigo_rechazo	Motivo del rechazo cuando los datos no coinciden. `null` si no aplica.
result.datos_oficiales	Datos del recibo tal como los publica CFE.
result.pdf_url	URL firmada, con vigencia de 1 hora, para descargar el comprobante en PDF.
job_id	Identificador interno de la consulta, útil para soporte.
webhook	URL configurada al crear la validación, o `null` si no se indicó ninguna.
raw_response	Respuesta íntegra de CFE, sin los archivos codificados en Base64.
error_message	Sólo presente cuando la validación no pudo completarse.

Ejemplo de Solicitud

curl https://api.verificamex.com/identity/v1/miscellaneous/cfe/recibo/870c7eee-3604-4995-aa98-bc8fa6aa1112 \
  -H "Authorization: Bearer {TU_TOKEN}" \
  -H "Accept: application/json"

Respuesta del Endpoint

    {
        "uuid": "870c7eee-3604-4995-aa98-bc8fa6aa1112",
        "status": "OK",
        "numero_servicio": "123456789012",
        "nombre_titular": "JUAN PEREZ LOPEZ",
        "importe": "1042",
        "created_at": "2026-07-27T10:55:00+00:00",
        "updated_at": "2026-07-27T10:56:12+00:00",
        "result": {
            "estado": "OK",
            "verificado": true,
            "mensaje": "Los datos coinciden con el recibo emitido por CFE",
            "codigo_rechazo": null,
            "datos_oficiales": {
                "titular": "JUAN PEREZ LOPEZ",
                "domicilio": "CALLE FALSA 123, COL. CENTRO, 06000",
                "numero_servicio": "123456789012",
                "periodo": "MAY - JUN 2026",
                "importe": "1042",
                "estado_recibo": "PAGADO",
                "fecha_limite": "2026-07-15"
            },
            "pdf_url": "https://storage.googleapis.com/..."
        },
        "job_id": "job-123",
        "webhook": "https://tu-api.com/webhooks/cfe",
        "raw_response": {
            "estado": "OK",
            "verificado": true,
            "mensaje": "Los datos coinciden con el recibo emitido por CFE",
            "datos_oficiales": { "...": "..." },
            "archivos": [
                { "filename": "recibo.pdf" }
            ]
        }
    }

    {
        "uuid": "870c7eee-3604-4995-aa98-bc8fa6aa1112",
        "status": "pendiente",
        "numero_servicio": "123456789012",
        "nombre_titular": "JUAN PEREZ LOPEZ",
        "importe": "1042",
        "created_at": "2026-07-27T10:55:00+00:00",
        "updated_at": "2026-07-27T10:55:00+00:00",
        "job_id": "job-123",
        "webhook": "https://tu-api.com/webhooks/cfe",
        "raw_response": null
    }

    {
        "uuid": "1f2a9b44-77c1-4a10-9de3-0b5c2e8f1a30",
        "status": "DATOS_NO_COINCIDEN",
        "numero_servicio": "123456789012",
        "nombre_titular": "JUAN PEREZ LOPEZ",
        "importe": "999",
        "created_at": "2026-07-27T10:55:00+00:00",
        "updated_at": "2026-07-27T10:56:12+00:00",
        "result": {
            "estado": "DATOS_NO_COINCIDEN",
            "verificado": false,
            "mensaje": "El importe no coincide con el recibo",
            "codigo_rechazo": "IMPORTE",
            "datos_oficiales": { "...": "..." },
            "pdf_url": null
        },
        "job_id": "job-456",
        "webhook": null,
        "raw_response": { "...": "..." }
    }

    {
        "message": "Validación de recibo CFE no encontrada."
    }

    {
        "message": "Unauthorized"
    }