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

Enviar el comprobante al chat de Telegram vinculado

Audiencia
public
Autenticación
API key
Permiso
validations_cep:download
Guía de uso →

Inicia el envío del CEP en PDF al chat de Telegram vinculado con la cuenta de usuario propietaria.

Un estado HTTP 202 (con queued: true en el cuerpo) confirma que la entrega quedó pendiente, no que se completó.

Requiere un comprobante disponible y una cuenta de Telegram vinculada:

  • Sin el documento, responde con un estado HTTP 409 (con cep_not_available en el cuerpo).
  • Sin la vinculación, responde con un estado HTTP 409 (con telegram_not_linked en el cuerpo).
Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
id*pathstring (uuid)obligatorio

Identificador (UUID) de la validación

Petición
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 respuestaPOST /v1/validations/{id}/cep/send-telegram
CódigoClaseDescripciónCuerpo
2022xxLa entrega del CEP fue aceptada y quedó pendiente de envío al chat de Telegram vinculado.Cuerpo sin schema
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
4044xxValidación no encontrada o ajena a la cuenta de usuario (not_found).ErrorResponse
4094xxEl CEP no está disponible (cep_not_available) o la cuenta de usuario no tiene un chat de Telegram vinculado (telegram_not_linked).ErrorResponse
4104xxLa validación se purgó y este recurso ya no existe (validation_purged).ErrorResponse
4224xxUUID inválido en la ruta (invalid_uuid).ErrorResponse
5035xxNo se pudo iniciar la entrega (dispatch_failed).ErrorResponse
Errores de POST /v1/validations/{id}/cep/send-telegram
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c
403permission_denied

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c00c9b8a7f6e5d
410validation_purged

La validación se purgó y este recurso ya no existe.

Envelope
meta.request_id
1a2b3c4d5e6ff6e5d4c3b2a1