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-10-09T02:12:12Z
HTTP 200
Request
[]Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"legalEntities": [
{
"legalEntityUuid": "019c0f9f-fc56-4a2c-9bdb-1af5aa8da03f",
"legalEntityId": 6,
"legalName": "Cafe Central Renombrado SAS",
"displayName": "Cafe Central",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "1f5ea072-102a-4966-a033-52f357f2fda4",
"legalEntityId": 4,
"legalName": "Comidas del Valle SAS 6ac84d5957e60",
"displayName": "Comidas del Valle",
"logoUrl": null,
"phone": "***",
"city": "Cali",
"taxNumber": "900123456-7",
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "b51f968d-49d8-4177-81a1-c81b5654b8b4",
"legalEntityId": 9,
"legalName": "Defecto Tirilla SAS 6ac84d5d619bc",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "6064946f-c386-11f1-a755-a2f78ac020f7",
"legalEntityId": 1,
"legalName": "Mi Negocio",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": "Armenia",
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "614f661d-c386-11f1-a755-a2f78ac020f7",
"legalEntityId": 3,
"legalName": "Negocio Descartable Test",
"displayName": "Descartable Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "6634bea1-79f5-444f-b56e-6c465b1ad479",
"legalEntityId": 5,
"legalName": "Parrilla Norte SAS 6ac84d5a2becc",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "6d2247e8-e1ca-4757-ad30-c26750079d24",
"legalEntityId": 7,
"legalName": "Sin Nombre SAS 6ac84d5b95519",
"displayName": null,
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "614f5bd3-c386-11f1-a755-a2f78ac020f7",
"legalEntityId": 2,
"legalName": "Sucursal Test",
"displayName": "Sucursal Test",
"logoUrl": null,
"phone": "***",
"city": null,
"taxNumber": null,
"isActive": 1,
"isAvailable": 1
},
{
"legalEntityUuid": "cb350d23-4f91-4737-b458-da994ecb681b",
"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
}
}
}