Documentos de vehículo

didi exige la tarjeta de circulación (frente) para aprobar un vehículo. indrive no pide documentos.

Requisitos del archivo

Regla Valor
Tipo circulation_card_front (único en v1)
Formato JPEG o PNG — PDF no (DiDi lo rechaza)
Tamaño máximo 4 MB (413 FILE_TOO_LARGE si lo excedes)
Contenido Foto nítida, sin filtros, sin recortes ni ediciones

El vehículo debe estar registrado en didi antes (si no: 409 CONFLICT).

Subir

Multipart con el campo file:

curl -X POST https://api.credikul.com/v1/vehicles/{id}/documents \
  -H "Authorization: Bearer ck_live_TU_LLAVE" \
  -F "type=circulation_card_front" \
  -F "file=@tarjeta-frente.jpg"

Respuesta 201:

{
  "id": "77aa…",
  "vehicleId": "1f2e…",
  "type": "circulation_card_front",
  "status": "submitted",
  "contentType": "image/jpeg",
  "sizeBytes": 812345,
  "submittedAt": "2026-07-06T18:22:03.000Z"
}

submitted significa que la plataforma recibió el documento — la revisión sigue pendiente. El veredicto vive en la registración del vehículo:

curl https://api.credikul.com/v1/vehicles/{id}/registrations/didi \
  -H "Authorization: Bearer ck_live_TU_LLAVE"
# → docStatus: "submitted", docReviewStatus: "pending" | "approved" | "rejected"

Documento rechazado

Si docReviewStatus es rejected (foto borrosa, con filtros, lado equivocado), simplemente vuelve a subir con el mismo endpoint — cada intento queda en el historial (GET /v1/vehicles/{id}/documents) y reinicia la revisión.

Errores

HTTP Código Causa
409 CONFLICT El vehículo aún no está registrado en didi
413 FILE_TOO_LARGE Más de 4 MB
400 INVALID_FILE_TYPE No es JPEG/PNG, o type no soportado
422 PLATFORM_REJECTED La plataforma rechazó el archivo al recibirlo (reintenta con mejor foto)