Guardar dirección de una persona
POST /api/dispatch-addresses/save
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra o actualiza una dirección (de partida o llegada) de una persona (cliente, proveedor, remitente o destinatario). Sin id crea una nueva; con id la actualiza.
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. Respuesta {success, id}.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
integer | No | Id de la dirección a actualizar. null para crear. |
person_id |
integer | Sí | Id de la persona. |
location_id |
array | Sí | [departamento, provincia, distrito], p. ej. ["15", "1501", "150101"]. |
department_id / province_id |
string | No | Departamento y provincia. Envíalos explícitamente (iguales a location_id[0] y location_id[1]) para que se guarden. |
address |
string | Sí | Dirección. |
establishment_code |
string | No | Código de establecimiento anexo SUNAT (0000...). |
phone / email |
string | No | Teléfono y correo de contacto. |
main |
boolean | No | Dirección principal. |
has_consigned / consigned_id |
boolean / integer | No | Si la dirección tiene consignado y su id. |
Errores: {success: false, id: 0} (HTTP 200) si location_id no es un arreglo de 3 elementos; 500 si falta location_id.
Cuerpo
Content-Type: application/json
{
"id": null,
"person_id": "1",
"location_id": [
"15",
"1501",
"150122"
],
"department_id": "15",
"province_id": "1501",
"address": "Av. Larco 345, Miraflores",
"establishment_code": "0001",
"phone": "014445566",
"email": "almacen@xyz.com.pe",
"main": false,
"has_consigned": false,
"consigned_id": null
}
Respuestas
200 — Guardada
{
"success": true,
"id": 12
}
200 — Ubigeo inválido
{
"success": false,
"id": 0
}
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.