Obtener Detalle Completo de la Compañía
Obtener Detalle Completo de la Compañía
- URL:
GET /api/partner/v1/companies/details - Cabeceras Obligatorias:
Authorization: Bearer <TOKEN_PARTNER_API>tenant-key: <COMPANY_KEY_DE_LA_SUB_CUENTA>
- Seguridad: Requiere autenticación de Partner (
checkRole:5) y pertenencia sobre eltenant-keyenviado. No accesible públicamente. - Descripción: Devuelve el perfil completo, estado técnico, sectores autorizados, credenciales y árbol de sucursales/POS de la sub-compañía. No requiere payload de petición.
Ejemplo de Respuesta (200 OK)
{
"status": true,
"company": {
"id": 12,
"tenant_id": "8f3b2a9e...",
"name": "Comercializadora Ejemplo",
"business_name": "Razón Social S.A.",
"nit": "1020304050",
"modality_code": 1,
"modality_description": "Electrónica en Línea",
"is_uniper": false,
"environment_code": 2,
"system_codes": [
"221000"
],
"document_sectors": [
{
"code": 1,
"name": "Factura Compra Venta"
}
],
"logo_image": "1020304050_logo_1721832000.png",
"enabled": true,
"has_digital_certificate": true,
"certificate_expiration": "2027-07-24 10:00:00",
"limits": {
"limit_type": "monthly_invoices",
"limit_value": "500"
},
"branches": [
{
"branch_code": 0,
"name": "Casa Matriz",
"address": "Av. Principal #123",
"city": "La Paz",
"municipality": "La Paz",
"zone": "Central",
"phone": "22446688",
"pos": [
{
"pos_code": 0,
"name": "Punto de Venta 0"
}
],
"assigned_documents": [
{
"document_code": 1,
"template_id": 5,
"template_name": "Plantilla Estándar Compra Venta"
}
]
}
],
"created_at": "2026-07-24 11:00:00"
}
}
Detalles de los Campos de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
company.id | Integer | ID numérico único de la empresa en la base de datos. |
company.tenant_id | String | Identificador company_key necesario en la cabecera tenant-key. |
company.name | String | Nombre comercial asignado. |
company.business_name | String | Razón social legal. |
company.nit | String | Número de NIT. |
company.modality_code | Integer | Código numérico de modalidad (1: Electrónica, 2: Computarizada). |
company.modality_description | String | Descripción en texto plano de la modalidad. |
company.is_uniper | Boolean | true si es empresa unipersonal, false si es jurídica. |
company.environment_code | Integer | Entorno del SIN (1: Producción, 2: Pruebas/Piloto). |
company.system_codes | Array[String] | Arreglos de códigos de sistema con los que opera la compañía. |
company.document_sectors | Array[Object] | Lista de objetos con los sectores de documento habilitados (code y name). |
company.has_digital_certificate | Boolean | Indica si la empresa cuenta con certificado digital .p12 subido. |
company.certificate_expiration | String/Null | Fecha y hora de expiración de la firma digital. |
company.limits.limit_type | String/Null | Tipo de restricción configurada (ej. monthly_invoices). |
company.limits.limit_value | String/Null | Límite máximo de emisión permitido. |
company.branches | Array[Object] | Sucursales con su dirección, lista de puntos de venta (pos) y plantillas asignadas. |