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>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"legalEntities": [
{
"legalEntityUuid": "061893d9-0976-4b02-afd4-c635bb3578bd",
"legalEntityId": 6,
"legalName": "Cafe Central Renombrado SAS",
"displayName": "Cafe Central",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "6db2f5ec-9b3e-4b99-b3fc-3b614b66ece2",
"legalEntityId": 4,
"legalName": "Comidas del Valle SAS 6ae8d81392f77",
"displayName": "Comidas del Valle",
"logoUrl": null,
"phone": "***",
"city": "Cali",
"taxNumber": "900123456-7",
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "a2ad4ead-1b47-40ee-a9a1-d30838f87b53",
"legalEntityId": 9,
"legalName": "Defecto Tirilla SAS 6ae8d815b8ac4",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "037dda34-d113-11f1-8bb6-de64ef616b7c",
"legalEntityId": 1,
"legalName": "Mi Negocio",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": "Armenia",
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "0487b348-d113-11f1-8bb6-de64ef616b7c",
"legalEntityId": 3,
"legalName": "Negocio Descartable Test",
"displayName": "Descartable Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "f28d41b4-f5c1-437b-b0b1-692ae2433cae",
"legalEntityId": 5,
"legalName": "Parrilla Norte SAS 6ae8d8140d8f8",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "ede1e484-6708-428e-a9b2-3350e86170be",
"legalEntityId": 7,
"legalName": "Sin Nombre SAS 6ae8d814cd170",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "0487b105-d113-11f1-8bb6-de64ef616b7c",
"legalEntityId": 2,
"legalName": "Sucursal Test",
"displayName": "Sucursal Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "2a636e77-9f77-4da9-9889-c337f73f3977",
"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
}
}
}