Saltar al contenido
Facturador

Primeros clientes

GET /api/document/customers

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Devuelve los primeros 20 clientes ordenados por nombre, con sus direcciones. Para buscar usa Buscar clientes para vender.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: estándar {success, data, message?} (registro único). Los clientes vienen en data.customers.

Respuestas

200 — Clientes

{
  "success": true,
  "data": {
    "customers": [
      {
        "id": 1,
        "description": "20501973522 - EMPRESA XYZ S.A.C.",
        "name": "EMPRESA XYZ S.A.C.",
        "number": "20501973522",
        "identity_document_type_id": "6",
        "identity_document_type_code": "6",
        "identity_document_type_description": "RUC",
        "address": "Av. 2 de Mayo 123, Lima",
        "telephone": "014271148",
        "country_id": "PE",
        "district_id": "150101",
        "email": "facturacion@xyz.com.pe",
        "selected": false,
        "addresses": [
          {
            "id": 4,
            "location_id": [
              "15",
              "1501",
              "150101"
            ],
            "address": "Jr. Ica 450, Lima",
            "code": "0001",
            "has_consigned": false
          }
        ]
      }
    ]
  }
}

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.