Saltar al contenido
Facturador

Registrar placa

POST /api/plates

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Registra una placa para un cliente. Se guarda en mayúsculas y sin espacios al inicio o final; si ya estaba registrada no se duplica.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.

Campo Tipo Obligatorio Descripción / valores permitidos
person_id integer Sí Id del cliente (habilitado).
value string Sí Placa (máx. 20). También se acepta en la clave plates.

Reglas:

  • Responde la lista completa de placas del cliente en data y el id de la placa en id.

Errores:

  • Validación: 422 con {success: false, message: {campo: [mensajes]}}.
  • Cliente inexistente o inhabilitado: HTTP 200 con success: false.

Cuerpo

Content-Type: application/json

{
  "person_id": "1",
  "value": "ABC-123"
}

Respuestas

200 — Guardada

{
  "success": true,
  "message": "Placa guardada con éxito",
  "id": 5,
  "data": [
    {
      "id": 5,
      "value": "ABC-123"
    }
  ]
}

422 — Validación

{
  "success": false,
  "message": {
    "value": [
      "El campo value es obligatorio."
    ]
  }
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.