Empresas
Entidad legal dentro de una organización con libro mayor, perfil fiscal y estados financieros propios.
- Nombre API:
companies - Dominio: Estructura
- Módulos: Datos maestros, Directorio, Administración
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Posición | rank | Orden | Sí | |
| Nombre | label | Texto I18n | ||
| Correos electrónicos | emails | Correo electrónico | Correos electrónicos | ||
| Teléfonos | phones | Teléfono | Teléfonos | ||
| Enlaces | links | Enlace | Enlaces | ||
| País de registro | countryCode | Constante | Sí | País donde está registrada legalmente la empresa. Determina los requisitos y datos legales aplicables. |
| Moneda contable | currency | Constante | Sí | Moneda de los libros y de los estados financieros. No puede cambiarse después de publicar la empresa. |
| Marco contable | accountingFramework | Constante | Sí | Marco utilizado para preparar los estados financieros: IFRS o US GAAP. No sustituye los requisitos de contabilidad fiscal. |
| Base fiscal | accountingTaxBasis | Constante | Sí | Define cuándo se reconoce fiscalmente el impuesto: al emitir o recibir el documento, o al cobrar o pagar. |
| Modo contable | ledgerMode | Constante | Sí | Opción fija del conjunto permitido para este campo. |
| Fin de ejercicio fiscal | monthFiscalYearEnd | Número Entero | Sí | Mes en que termina el ejercicio fiscal. Los nuevos ejercicios fiscales se generan con base en este mes. |
| Método de valuación de inventario | inventoryValuationMethod | Constante | Sí | Política contable de valuación para todo el inventario de esta empresa. Todos los almacenes, tiendas y plantas de la empresa usan el mismo método; el motor resuelve el costo por sitio y posición operativa. |
| Base de costo en cotizaciones | costBasisQuote | Constante | Sí | Define qué costo de catálogo usa el margen de una cotización de venta para esta empresa. |
| Momento de registro del ingreso | revenuePostingPoint | Constante | Sí | Define cuándo se registra el ingreso de las ventas de esta empresa. Se bloquea al publicar la empresa. |
| Exigir proveedor calificado | requireQualifiedSupplier | Binario | Sí | Las órdenes de compra de esta empresa solo se aprueban si el proveedor tiene una calificación vigente. |
| Identificación fiscal | taxId | Texto | Identificador fiscal de la empresa, según su país de registro. | |
| Fuente del tipo de cambio | fxrateProvider | Constante | Serie publicada que esta empresa usa por defecto para convertir documentos a su moneda contable. | |
| Antigüedad máxima del tipo de cambio (días) | fxrateMaxAgeDays | Número Entero | Sí | Antigüedad máxima, en días, del tipo de cambio usado en documentos en moneda extranjera. 0 = solo un tipo del mismo día. |
| Logo | logo | Imagen | Logo de la empresa para listas y documentos. | |
| Símbolo | symbol | Imagen | Monograma o ícono compacto de la empresa. | |
| Descripción | description | Campo de Texto I18n | ||
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Claves de sistemas remotos y tipos de id opcionales. Un valor por par de sistema y tipo en este registro. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Publicado por | publishedBy | Usuario | ||
| Publicado el | publishedAt | Fecha y Hora | ||
| Deshabilitado por | disabledBy | Usuario | ||
| Deshabilitado el | disabledAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook companies.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una empresa. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la empresa. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva la empresa para usos nuevos. Las referencias existentes se mantienen. Actívala de nuevo para usarla. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar la empresa para usos nuevos. | App · API · MCP · CLI |
| Publicar | publish | Publica la disponibilidad para que pueda usarse. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la empresa. Sigue visible y puede seguir en documentos existentes. Desbloquéala para volver a cambiarla. | App · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar la empresa. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la empresa y los datos que le pertenecen. No se puede deshacer. | App · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.