Saltar al contenido
Facturador

Cliente por defecto

GET /api/persons/default-customer/{document_type_id}

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

Devuelve el cliente por defecto para vender: el configurado en el establecimiento del usuario o, si no hay y el tipo de comprobante es boleta (03) o nota de venta (80), el cliente Clientes varios. El tipo de comprobante en la URL es opcional (/api/persons/default-customer).

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.

Reglas:

  • Si no hay cliente por defecto responde {success: false, data: null} (HTTP 200).

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
document_type_id ruta sí 03

Respuestas

200 — Cliente

{
  "success": true,
  "data": {
    "id": 1,
    "description": "99999999 - Clientes - Varios",
    "name": "Clientes - Varios",
    "number": "99999999",
    "addresses": [],
    "identity_document_type_id": "0",
    "identity_document_type_code": "0",
    "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": "DOC.TRIB.NO.DOM.SIN.RUC",
    "location_id": []
  }
}

200 — Sin cliente por defecto

{
  "success": false,
  "data": null
}

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.