Enviar el comprobante al chat de Telegram vinculado

POSThttps://api.veriko.mx/v1/validations/{id}/cep/send-telegram

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

Entrega el CEP de esta validación en el chat de Telegram vinculado a la cuenta. El envío ocurre en segundo plano, así que la respuesta es un 202 inmediato con queued: true y el documento aparece en el chat unos segundos después: el 202 confirma que se encoló, no que se entregó. Hacen falta dos condiciones. Que el CEP exista, es decir que la validación haya terminado en banxico_status: 'valid'; y que la cuenta tenga Telegram vinculado, lo que se comprueba en telegram_linked de GET /v1/users/me. Sin lo primero la respuesta es 404 cep_not_available; sin lo segundo, 409 telegram_not_linked. El documento entregado es el mismo PDF que devuelve GET /v1/validations/{id}/cep?format=pdf.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	UUID de la validación

Petición

cURLPython•JavaScript•PHP•

curl -X POST 'https://api.veriko.mx/v1/validations/{id}/cep/send-telegram' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Códigos de respuesta**`POST /v1/validations/{id}/cep/send-telegram`
Código	Clase	Descripción	Cuerpo
202	`2xx`	La entrega del CEP a Telegram fue encolada. El trabajador `bots` sube el documento al chat vinculado de forma asíncrona.	Sin cuerpo
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	Validación no encontrada o ajena al usuario (`not_found`).	`ErrorResponse`
409	`4xx`	El CEP no está disponible para esta validación (`cep_not_available`, cuando `banxico_status` no es `valid` o el PDF no fue persistido), o el usuario no tiene Telegram vinculado (`telegram_not_linked`).	`ErrorResponse`
422	`4xx`	UUID inválido en el path (`invalid_uuid`).	`ErrorResponse`
503	`5xx`	No se pudo encolar la entrega (broker no disponible, `dispatch_failed`). El cliente puede reintentar.	`ErrorResponse`

**Errores de `POST /v1/validations/{id}/cep/send-telegram`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c0`