platestringObligatoriopattern"^[A-Z]{3}[0-9][A-Z0-9][0-9]{2}$"← InicioFleetPay / API
Registrar un vehículo
Parámetros, estructura de datos y respuestas del contrato versionado.
POST
/fiscal/veiculosLas descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Autenticación
[
{
"oauth2": []
},
{
"chaveApi": []
}
]La disponibilidad depende del entorno, los permisos habilitados y el proveedor. Esta referencia no ejecuta solicitudes ni recibe credenciales.
Parámetros
No hay parámetros declarados para esta operación.
Cuerpo de la Solicitud
Obligatorio
application/json
plate_statestring | nullOpcionalminLength2maxLength2renavamstring | nullOpcionalpattern"^\\d{11}$"tare_kgnumber | nullOpcionalminimum0capacity_kgnumber | nullOpcionalminimum0capacity_m3number | nullOpcionalminimum0axlesnumber | nullOpcionalminimum0maximum255body_typenumber | nullOpcionalminimum0maximum255wheel_typenumber | nullOpcionalminimum0maximum255owner_typestring | nullOpcional"own" · "third"owner_documentstring | nullOpcionalmaxLength14owner_namestring | nullOpcionalmaxLength120owner_rntrcstring | nullOpcionalmaxLength8default_driver_user_idinteger | nullOpcionalminimum1Respuestas
201 Respuesta HTTP
Vehículo registrado.
application/json
dataobjectObligatorioenvironmentobjectObligatorioHeaders
X-Request-IdIdentificador de correlación de la llamada.
401 Respuesta HTTP
Clave de API FleetPay ausente o no válida.
Headers
X-Request-IdIdentificador de correlación de la llamada.
403 Respuesta HTTP
Ámbito fiscal deshabilitado en la clave, o clave sin transportista activo.
Headers
X-Request-IdIdentificador de correlación de la llamada.
422 Respuesta HTTP
Payload inválido, requisito pendiente o regla de negocio.
Headers
X-Request-IdIdentificador de correlación de la llamada.
429 Respuesta HTTP
Límite por transportista excedido.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Retry-AfterSegundos hasta un nuevo intento.
500 Respuesta HTTP
Fallo interno sin detalles de las integraciones operativas.
Headers
X-Request-IdIdentificador de correlación de la llamada.
Definición Completa de la Operación
{
"tags": [
"Veículos"
],
"summary": "Cadastrar veículo",
"operationId": "createVehicle",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/VehicleCreateInput"
}
}
}
},
"responses": {
"201": {
"$ref": "#/components/responses/VehicleCreated"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"422": {
"$ref": "#/components/responses/ValidationOrBusinessRuleFailed"
},
"429": {
"$ref": "#/components/responses/RateLimited"
},
"500": {
"$ref": "#/components/responses/InternalError"
}
},
"method": "POST",
"path": "/fiscal/veiculos",
"parameters": []
}