Ver cliente o proveedor
GET /api/persons/record/{customer_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Devuelve una persona (cliente o proveedor) con sus direcciones y ubigeo.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado sin envoltura: devuelve directamente el objeto o arreglo (sin success). Devuelve {data: {...}}.
Errores:
- Si el id no existe responde HTTP 404 con
success: falseymessageRegistro no encontrado.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
customer_id |
ruta | sí | 1 |
Respuestas
200 — Persona
{
"data": {
"id": 25,
"description": "20601234567 - COMERCIAL NORTE E.I.R.L.",
"name": "COMERCIAL NORTE E.I.R.L.",
"number": "20601234567",
"addresses": [
{
"id": 8,
"trade_name": null,
"country_id": "PE",
"location_id": [
"04",
"0401",
"040101"
],
"address": "CALLE MERCADERES 456, AREQUIPA",
"phone": "054223344",
"email": "almacen@comercialnorte.pe",
"main": false,
"department_id": "04",
"province_id": "0401",
"district_id": "040101",
"establishment_code": "0001",
"has_consigned": false,
"consigned_id": null,
"consigned_name": null
}
],
"identity_document_type_id": "6",
"identity_document_type_code": "6",
"address": "AV. PRINCIPAL 123, LIMA",
"telephone": "987654321",
"country_id": "PE",
"district_id": "150101",
"email": "compras@comercialnorte.pe",
"enabled": true,
"selected": false,
"identity_document_type_description": "RUC",
"location_id": [
"15",
"1501",
"150101"
]
}
}
404 — Id inexistente
{
"success": false,
"message": "Registro no encontrado."
}
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.