# Mostrar validación de recibo CFE

Fuente: /cfe/show-cfe-receipt-validation/

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}

```

> **Nota**
>
> Recuerda que debes tener un token válido para realizar la solicitud.
> Puedes obtener un token siguiendo los pasos descritos en la sección [Generar tokens](/authentication/generate-tokens/).

### **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](/cfe/create-cfe-receipt-validation/). |

### **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. |

> **Nota**
>
> Mientras el `status` sea `pendiente`, la respuesta no incluirá la llave `result`.

### **Ejemplo de Solicitud**

```bash
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

**status 200**

```json
    {
        "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" }
            ]
        }
    }
```

**status 200 (pendiente)**

```json
    {
        "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
    }
```

**status 200 (datos no coinciden)**

```json
    {
        "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": { "...": "..." }
    }
```

**status 404**

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

**status 401**

```json
    {
        "message": "Unauthorized"
    }
```

> **Precaución**
>
> Sólo puedes consultar validaciones creadas con tu propia cuenta. Si el UUID no existe o pertenece
> a otro usuario, la respuesta es `404`.