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.