Control de cambios

Leyenda

Nuevo

Modificado

Eliminado

Historial de cambios

Fecha	Cambios
03-may-2021	Adaptaciones a los cambios de operativa y campos para el alta de empresas con y sin datos económicos y a la nueva solicitud de modificación de las mismas.

Sistema de gestión de empresas

Entidades

Cambios

03-may-2021 Se actualiza lista de entidades para:

Modificar la definición de las entidades DatosContacto y DatosTipoEmpresa para añadir nuevos campos.
Añadir las entidades TipoTercero y TipoEmpresaContabilidad.
Modificar el uso de la entidad TipoEmpresa para pasar a ser información de empresas con datos económicos.

Entidad	Descripción
Empresa	Contiene los datos básicos de una empresa.
DatosContacto	Contiene los datos de contacto de la empresa.~~, a priori, únicamente la dirección postal.~~
DatosTipoEmpresa	Contiene los datos relativos a la tipología de la empresa, estando esta tipología basada en criterios diversos (los que se establezcan por parte de la universidad o sistema externo).~~, como puede ser por ejemplo su tamaño.~~
TipoIdentificador	Listado con los tipos de identificador fiscal (CIF, VAT, ...).
TipoTercero	Listado con los tipos de tercero (necesario para las empresas con datos económicos).
TipoEmpresa	~~Listado con los tipos de empresa (PYME, Microempresa, ...).~~ Listado con los tipos de empresa (necesario para las empresas con datos económicos).
TipoEmpresaContabilidad	Listado con los tipos de empresa para contabilidad (necesario para las empresas con datos económicos).

Modelo lógico

Cambios

03-may-2021 Se actualiza el modelo para:

Añadir las entidades TipoTercero, TipoEmpresaContabilidad, Pais, ComunidadAutonoma y Provincia.
Modificar entidad DatosTipoEmpresa para incluir nuevos campos, tipoTercero y tipoEmpresaContabilidad, como referencia a las entidades TipoTercero y TipoEmpresaContabilidad.
Modificar el uso de la entidad TipoEmpresa para pasar a ser información de empresas con datos económicos.
Modificar entidad DatosContacto para incluir nuevos campos, paisContacto, comunidadContacto, provinciaContacto como referencia a entidades Pais, ComunidadAutonoma y Provincia y los campos ciudadContacto y direccionWeb.
Modificar entidad Empresa para:
- Incluir el nuevo campo padreId que hace referencia a la empresa que hace de entidad principal en el caso de empresas que son subentidad de otra.
- Incluir el nuevo campo datosEconomicos para indicar si se trata de una empresa con datos económicos (está dada de alta en GENTE y en JUSTO) o sin datos económicos (está dada de alta solo en GENTE).

API

Características generales que todas las API REST deben de cumplir:

Definición de los objetos

Cambios

03-may-2021 Se actualiza la definición de objetos para:

Añadir los objetos TipoTercero, TipoEmpresa, TipoEmpresaContabilidad y las referencias a los objetos del SGO Pais, ComunidadAutonoma y Provincia.
Modificar objeto DatosTipoEmpresa para incluir nuevos campos, tipoTercero y tipoEmpresaContabilidad, como referencia a los objetos TipoTercero y TipoEmpresaContabilidad.
Modificar el uso del objeto TipoEmpresa para pasar a ser información de empresas con datos económicos.
Modificar objeto DatosContacto para incluir nuevos campos, paisContacto, comunidadContacto, provinciaContacto, como referencia a los objetos Pais, ComunidadAutonoma y Provincia y los campos ciudadContacto y direccionWeb.
Modificar objeto Empresa para:
- Incluir el nuevo campo padreId que hace referencia a la empresa que hace de entidad principal en el caso de empresas que son subentidad de otra.
- Incluir el nuevo campo datosEconomicos para indicar si se trata de una empresa con datos económicos (está dada de alta en GENTE y en JUSTO) o sin datos económicos (está dada de alta solo en GENTE).

Empresa

Nombre	Tipo	Descripción
id	String	Identificador de la empresa.
nombre	String	Nombre de la empresa.
tipoIdentificador	TipoIdentificador	Tipo de identificador fiscal de la empresa. Se devuelve la entidad TipoIdentificador con todos sus campos.
numeroIdentificacion	String	Número de identificación fiscal de la empresa del tipo indicado en "tipoIdentificador".
razonSocial	String	Razón social de la empresa.
datosEconomicos	Boolean	Indicador de si se trata de una empresa con datos económicos (está dada de alta en GENTE y en JUSTO) o sin datos económicos (está dada de alta solo en GENTE).
padreId	String	Identificador de la empresa padre o entidad principal. Estará informado en el caso de empresas que son subentidad de otra.

Empresa

{
    "id": "ent-002",
    "nombre": "Empresa de Prueba",
    "tipoIdentificador": {
          "id":"tp-1",
          "nombre":"CIF"
     },
    "numeroIdentificacion": "H11111111",
    "razonSocial": "Empresa que es mayoritariamente de prueba del SGI",
    "datosEconomicos": false,
	"padreId": "ent-001"
}

TipoIdentificador

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoIdentificador.
nombre	String	Nombre (Posibles valores: CIF, VAT, ...).

TipoIdentificador

{ 
    "id":"tp-1",
    "nombre": "CIF"   
}

DatosTipoEmpresa

Nombre	Tipo	Descripción
tipoTercero	TipoTercero	Tipo de tercero. Se devuelve la entidad TipoTercero con todos sus campos.
tipoEmpresa	TipoEmpresa	Tipo de empresa. Se devuelve la entidad TipoEmpresa con todos sus campos.
tipoEmpresaContabilidad	TipoEmpresaContabilidad	Tipo de tercero. Se devuelve la entidad TipoEmpresaContabilidad con todos sus campos.

DatosTipoEmpresa

{ 
	"tipoTercero": {
    	"id":"tt-1",
    	"nombre": "Personas jurídicas españolas"   
	},
	"tipoEmpresa": {
    	"id":"te-1",
    	"nombre": "Empr. extranjeras"   
	},  
	"tipoEmpresaContabilidad": {
    	"id":"tec-1",
	    "nombre": "Otros entes del sector público, empresa o institución privada"   
	}
}

TipoTercero

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoTercero.
nombre	String	Nombre.

TipoIdentificador

{ 
    "id":"tt-1",
    "nombre": "Personas jurídicas españolas"   
}

TipoEmpresa

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoEmpresa.
nombre	String	Nombre. ~~(Posibles valores: CIF, VAT, ...).~~

TipoIdentificador

{ 
    "id":"te-1",
    "nombre": "Empr. extranjeras"   
}

TipoEmpresaContabilidad

Nombre	Tipo	Descripción
id	String	Identificador de la entidad TipoEmpresaContabilidad.
nombre	String	Nombre (Posibles valores: CIF, VAT, ...).

TipoIdentificador

{ 
    "id":"tec-1",
    "nombre": "Otros entes del sector público, empresa o institución privada"   
}

DatosContacto

Nombre	Tipo	Descripción
paisContacto	Pais	Se devuelve la entidad Pais con todos sus campos. Ver definición en UM - SGI - ESB - SGO.
comAuntonomaContacto	ComunidadAutonoma	Se devuelve la entidad ComunidadAutonoma con todos sus campos. Ver definición en UM - SGI - ESB - SGO.
provinciaContacto	Provincia	Se devuelve la entidad Provincia con todos sus campos. Ver definición en UM - SGI - ESB - SGO.
ciudadContacto	String	Ciudad de contacto de la empresa.
direccionContacto	String	Dirección de contacto de la empresa.
direccionWeb	String	Dirección web de la empresa.

DatosContacto

{
	"paisContacto": {
       "id":"33",
       "nombre":"España"
     },
    "comAuntonomaContacto": {
       "id":"ca-3",
       "nombre":"Asturias"
     }, 
    "provinciaContacto": {
       "id":"pro-1",
       "nombre":"Asturias"
     }, 
	"ciudadContacto": "Oviedo",
    "direccionContacto": "C/ Uria número 4, puerta A",
	"direccionWeb": "www.empresadeprueba.es"
}

Servicios

Método	URL	Parámetros	Respuesta	Descripción
GET	/empresas	q+s (query + sort) La query estará formada por: id nombre razonSocial numeroIdentificacion	Lista[Empresa]	Listado de Empresa. Ejemplo: nombre=like=(Tree);(razonSocial=like=SL)
GET	/empresas/{id}		Empresa	Detalle de los datos generales de una empresa.
POST	/empresas	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos básicos (formly) con los campos necesarios para crear una empresa.

GET	/datos-contacto/empresa/{id}		DatosContacto	Contiene los datos de contacto de una empresa. En principio, únicamente la dirección de contacto.
POST	/datos-contacto	JSON		Recibe como parámetro la respuesta del usuario del formulario de datos contacto (formly) con los campos necesarios para crear los datos de contacto de una empresa. En el formulario se deben de incluir el campo id de Empresa para saber de qué empresa se trata (campo oculto).

GET	/datos-tipo-empresa/empresa/{id}		DatosTipoEmpresa	Detalle de los datos de tipo de empresa de una empresa.
POST	/datos-tipo-empresa	JSON		Recibe como parámetro la respuesta del usuario del formulario de vinculación (formly) con los campos necesarios para los datos de tipo de empresa de la empresa. En el formulario se deben de incluir el campo id de Empresa para saber de qué empresa se trata (campo oculto).

GET	/tipos-identificador		Lista[TipoIdentificador]	Listado de tipos de identificador fiscal para las empresas ordenados alfabéticamente de forma ascendente.

GET	/tipos-empresa		Lista[TipoEmpresa]	Listado de tipos de empresa ordenados alfabéticamente de forma ascendente.

Árbol de páginas

UM - SGI - ESB - SGEMP

Sistema de gestión de empresas

Entidades

Modelo lógico

API

Definición de los objetos

Empresa

TipoIdentificador

DatosTipoEmpresa

TipoTercero

TipoEmpresa

TipoEmpresaContabilidad

DatosContacto

Servicios