Crear o editar consignado
POST /api/consigneds
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra un consignado o, si envías id, lo edita.
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 |
|---|---|---|---|
id |
integer | No | Id a editar; omítelo para crear. |
identity_document_type_id |
string | Sí | Tipo de documento (1 DNI, 4 CE, 6 RUC, 7 pasaporte). |
number |
string | Sí | Número de documento. |
name |
string | Sí | Nombre. |
telephone |
string | No | Teléfono. |
Reglas:
- No hay validación de campos: envía todos los obligatorios.
Cuerpo
Content-Type: application/json
{
"identity_document_type_id": "1",
"number": "45678912",
"name": "ROSA HUAMAN TORRES",
"telephone": "987111222"
}
Respuestas
200 — Registrado
{
"id": 3,
"success": true,
"message": "Consignado registrado con éxito"
}
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.