This endpoint handles the complete campaign registration workflow, allowing drivers to apply for advertising campaigns by submitting their personal information, banking details, vehicle information, and required documentation (license and vehicle registration).
Request Body User ID of the driver applying for the campaign
Campaign ID that the driver wants to join
Vehicle ID that will be used in the campaign
Driver’s contact phone number
Driver’s national ID number (10 digits)
Driver’s email address (max 50 characters)
Driver’s license document (PDF, image formats accepted)
Uploaded to: documents/ directory
Required for verification
Vehicle registration document (PDF, image formats accepted)
Uploaded to: documents/ directory
Required for vehicle verification
Bank account number (max 15 characters) for payment transfers
Name of the banking institution
Type of bank account (e.g., “savings”, “checking”)
City ID where the driver is located
Country ID where the driver is located
Branding Selection Fields Whether the vehicle requires complete branding
Apply branding to vehicle hood
Apply branding to vehicle roof
Apply branding to driver’s door
Apply branding to passenger door
Apply branding to rear left door
Apply branding to rear right door
Apply branding to trunk/rear door
Response Unique identifier for the registration form
Vehicle ID registered for campaign
URL path to uploaded license document
URL path to uploaded vehicle registration
Bank account number for payments
Date when the form was submitted (YYYY-MM-DD)
Application status: “pendiente” (pending), “aprobado” (approved), “rechazado” (rejected)
curl -X POST https://api.example.com/api/formularioregistrocampana \ -H "Content-Type: multipart/form-data" \ -F "id_usuario=123" \ -F "id_campana=45" \ -F "id_vehiculo=78" \ -F "telefono_conductor=0987654321" \ -F "cedula=1234567890" \ -F "[email protected] " \ -F "licencia=@/path/to/license.pdf" \ -F "matricula=@/path/to/registration.pdf" \ -F "numero_cuenta_bancaria=1234567890123" \ -F "entidad_bancaria=Banco Nacional" \ -F "tipo_cuenta_bancaria=savings" \ -F "brandeo=true" \ -F "carroceria_capo=true" \ -F "carroceria_techo=true" \ -F "puerta_conductor=true" \ -F "puerta_pasajero=true" \ -F "id_ciudad=1" \ -F "id_pais=1"
200 - Success
400 - Bad Request
404 - Not Found
{ "id_formulario" : 567 , "id_usuario" : 123 , "id_campana" : 45 , "id_vehiculo" : 78 , "telefono_conductor" : 987654321 , "cedula" : "1234567890" , "correo_electronico" : "[email protected] " , "licencia" : "documents/license_20260309_123.pdf" , "matricula" : "documents/registration_20260309_123.pdf" , "numero_cuenta_bancaria" : "1234567890123" , "entidad_bancaria" : "Banco Nacional" , "tipo_cuenta_bancaria" : "savings" , "fecha_envio" : "2026-03-09" , "estado_solicitud" : "pendiente" , "brandeo" : true , "carroceria_capo" : true , "carroceria_techo" : true , "puerta_conductor" : true , "puerta_pasajero" : true , "puerta_trasera_iz" : false , "puerta_trasera_der" : false , "puerta_maletero" : false , "id_ciudad" : 1 , "id_pais" : 1 }
Campaign Registration Workflow
Form Submission : Driver submits registration form with personal info, banking details, and documentsDocument Upload : License and vehicle registration files are uploaded to documents/ directoryBranding Selection : Driver selects which parts of their vehicle will display campaign brandingValidation : System validates all required fields and file uploadsStatus Assignment : Form is marked as “pendiente” (pending) awaiting admin approvalNext Steps :
Admin reviews the application
If approved, driver proceeds to IngresoConductorCampana with QR code generation
Driver must complete VerificacionConductorCampana before starting routes
Notes
All file uploads use multipart/form-data encoding
Supported document formats: PDF, JPG, PNG
Maximum file size: 10MB per document
Application status transitions: pendiente → aprobado or rechazado
Branding pricing is calculated based on selected vehicle parts and campaign rates
The fecha_envio field is automatically set to the submission date