Saltar al contenido
Facturador

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.