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-09-13T21:05:19Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"legalEntities": [
{
"legalEntityUuid": "07d4ca65-74aa-4323-8cdb-ac905bdfd688",
"legalEntityId": 6,
"legalName": "Cafe Central Renombrado SAS",
"displayName": "Cafe Central",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "054dcb7e-930e-46e1-95b9-60dfaa7eacef",
"legalEntityId": 4,
"legalName": "Comidas del Valle SAS 6aa70f449a390",
"displayName": "Comidas del Valle",
"logoUrl": null,
"phone": "***",
"city": "Cali",
"taxNumber": "900123456-7",
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "23fe8375-b034-455e-87af-b2a39bb5292a",
"legalEntityId": 9,
"legalName": "Defecto Tirilla SAS 6aa70f46a83ed",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "0156277d-acb4-11f1-b72d-f2569efa6eee",
"legalEntityId": 1,
"legalName": "Mi Negocio",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "01e0727a-acb4-11f1-b72d-f2569efa6eee",
"legalEntityId": 3,
"legalName": "Negocio Descartable Test",
"displayName": "Descartable Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "9595922d-e1e8-4c99-a107-c2688e77390d",
"legalEntityId": 5,
"legalName": "Parrilla Norte SAS 6aa70f44d6c56",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "bc5a5075-b90e-4f3c-b04c-544db3deca29",
"legalEntityId": 7,
"legalName": "Sin Nombre SAS 6aa70f45b0b01",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "01e06fc7-acb4-11f1-b72d-f2569efa6eee",
"legalEntityId": 2,
"legalName": "Sucursal Test",
"displayName": "Sucursal Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "b9ee5489-1d67-4ed4-a8be-0aaedf365dd1",
"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
}
}
}