Saltar al contenido
Facturador

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: false y message Registro 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.