Entidades legales
POST
Listar entidades legales
POST /api/legal-entities/list-legal-entities
Descripción
Lista paginada de las entidades legales de facturación con búsqueda.
Detalles
* Busca por razón social o nombre visible de forma simultánea. * Incluye entidades suspendidas; las eliminadas no aparecen. * Soporta ordenamiento por razón social, nombre visible y ciudad.
Permisos requeridos
admin.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [legalName, displayName, city] |
Ejemplo de request
curl -X POST https://restofy.pro/api/legal-entities/list-legal-entities \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"legalEntities": [
{
"legalEntityUuid": "4c7df78b-3164-4b64-9fa1-f1b1d064167b",
"legalEntityId": 6,
"legalName": "Cafe Central Renombrado SAS",
"displayName": "Cafe Central",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "bf552800-14b1-4865-9934-da4761dc1ebd",
"legalEntityId": 4,
"legalName": "Comidas del Valle SAS 6aa038917a3bc",
"displayName": "Comidas del Valle",
"logoUrl": null,
"phone": "***",
"city": "Cali",
"taxNumber": "900123456-7",
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "222acd3b-f9f8-4502-bc75-1ff61309171b",
"legalEntityId": 9,
"legalName": "Defecto Tirilla SAS 6aa03893ae9ae",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "23d89f9a-ab4a-11f1-b72d-f2569efa6eee",
"legalEntityId": 1,
"legalName": "Mi Negocio",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "2455c9c7-ab4a-11f1-b72d-f2569efa6eee",
"legalEntityId": 3,
"legalName": "Negocio Descartable Test",
"displayName": "Descartable Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "88b8e52c-05f3-4ba9-9849-f294da0fd2b8",
"legalEntityId": 5,
"legalName": "Parrilla Norte SAS 6aa03891b1aed",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "9b940b05-3f68-476e-b6ff-201027d877eb",
"legalEntityId": 7,
"legalName": "Sin Nombre SAS 6aa038928ff81",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "2455c71c-ab4a-11f1-b72d-f2569efa6eee",
"legalEntityId": 2,
"legalName": "Sucursal Test",
"displayName": "Sucursal Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "f6475b9a-00a0-41dd-a926-43b790ceb6d6",
"legalEntityId": 8,
"legalName": "Tirilla SAS",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 9,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}