GEThttps://api.veriko.mx/v1/validations/{id}/cep

Descargar el CEP oficial

Audiencia: public
Autenticación: API key
Permiso: validations_cep:download

Descarga el Comprobante Electrónico de Pago (CEP) emitido por Banxico de una validación con veredicto valid, o returned cuando el CEP se descargó antes de conocerse la devolución.

El formato predeterminado es xml; con format=pdf se solicita el documento en PDF.

Si el comprobante, o el formato pedido, no está disponible, responde con un estado HTTP 404 (con cep_not_available en el cuerpo).

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	Identificador (UUID) de la validación
`format`	query	`string`	opcional	Formato del certificado: `xml` o `pdf`. Predeterminado: `xml` p. ej. `xml`

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/validations/{id}/cep' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Códigos de respuesta**`GET /v1/validations/{id}/cep`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Archivo del certificado CEP. El `Content-Type` es `application/xml` o `application/pdf` según el formato solicitado.	Cuerpo sin schema
400	`4xx`	Formato fuera de la lista admitida (`invalid_export_format`).	`ErrorResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	Validación no encontrada (`not_found`) o el CEP no está disponible para esta validación (`cep_not_available`). Este último código se devuelve cuando `banxico_status` no es `valid` ni `returned` o falta el archivo solicitado.	`ErrorResponse`
410	`4xx`	La validación se purgó y este recurso ya no existe (`validation_purged`).	`ErrorResponse`
422	`4xx`	UUID inválido en la ruta (`invalid_uuid`).	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Content-Disposition`	`string`	Nombre de descarga con el formato `CEP-{validation_id}.{ext}`.

**Errores de `GET /v1/validations/{id}/cep`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`
410	`validation_purged`	La validación se purgó y este recurso ya no existe. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`