Saltar al contenido
Facturador

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.