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) |