Árbol de páginas

Versiones comparadas

Clave

  • Se ha añadido esta línea.
  • Se ha eliminado esta línea.
  • El formato se ha cambiado.

...

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.

17-may-2021 

Adaptaciones a la fusión de los campos nombre y razón social en un único campo, a los nuevos campos de datos de contacto, a la nueva asociación con sectores industriales, códigos CNAE o clasificaciones de tipo sector industrial (llamado indistintamente de las tres formas) y al nuevo campo de "Tipo de tercero Reino Unido" para entidades con datos económicos con dirección en Reino Unido.

08-jun-2021

 Se actualizan los siguientes servicios del API de empresas:

  • POST: Se cambia la definición a /empresas/formly.
  • PUT: Se cambia la definición a /empresas/formly/{id} y se añade en el JSON el campo empresaId para facilitar su identificación.

18-jun-2021 

Eliminar de los servicios de este API el método para obtener el listado de tipos de vía y su entidad relacionada por trasladarse al API del SGO.

28-jun-2021 

Modificar definición del objeto Empresa para separar los campos nombre y razón social y de la búsqueda para que pueda filtrar por ambos campos.

18-oct-2021 

Se modificar el servicio del alta de empresa para que en el caso de que el servicio sea síncrono devuelva el id de la empresa creada.

28-oct-2021 

Nuevo servicio para obtener las empresas modificadas o nuevas a partir de una fecha

...

Sistema de gestión de empresas

Entidades

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

...

  • Eliminar la entidad "TipoVia".

    Entidad

    Descripción

    Empresa (EmpresaUM)

    Contiene los datos básicos de una empresa.

    DatosContacto (DatosContactoUM)

    Contiene los datos de contacto de la empresa.

    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).

    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 (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).

    TipoTerceroReinoUnido

    Listado con los tipos de tercero para Reino Unido (necesario para las empresas con datos económicos cuyo país es el Reino Unido).

    TipoVia

    Listado con los tipos de vía (Calle, Avenida, ...).

    EmpresaClasificacion (EmpresaUMClasificacion)

    Listado de relaciones entre empresas y clasificaciones. En principio, únicamente con las del tipo "Código CNAE" también llamado "Sector Industrial". Ver definición de clasificaciones en UM - SGI - ESB - SGO.


    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).

...

28-jun-2021 Modificar definición de la entidad Empresa para separar los campos nombre y razón social.

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:

...

  • Modificar el objeto Empresa para separar los campos nombre y razón social.

Empresa


Nombre

Tipo

Descripción

id

String

Identificador de la empresa.

nombreRazonSocial

String

Nombre y/o razón social de la empresa.

nombre

String

Nombre de la empresa. Se devolverá lo mismo que en el campo "razonSocial".

razonSocial

String

Razón social de la empresa. Se devolverá lo mismo que en el campo "nombre".

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".

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  Ampliar origen
{
"id": "ent-002",
"nombre": "Empresa de Prueba",
"razonSocial": "Empresa de Prueba",
"tipoIdentificador": {
"id":"tp-1",
"nombre":"CIF"
},
"numeroIdentificacion": "H11111111",
"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  Ampliar origen
{
"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.

tipoTerceroReinoUnido

TipoTerceroReinoUnido

Tipo de tercero para personas físicas (personas actuando como empresas) con dirección en el Reino Unido. Se devuelve la entidad TipoTerceroReinoUnido con todos sus campos.

DatosTipoEmpresa  Ampliar origen
{
"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"
},
"tipoTerceroReinoUnido": {
"id":"IN",
"nombre": "Tercero de Irlanda del Norte"
}
}

TipoTercero

Nombre

Tipo

Descripción

id

String

Identificador de la entidad TipoTercero.

nombre

String

Nombre.

clase

String

Clase de tercero Reino Unido. Posibles valores: F (Persona física), J (Persona jurídica).

TipoTercero  Ampliar origen
{
"id":"tt-1",
"nombre": "Personas jurídicas: españolas",
"clase": "J"
}

TipoEmpresa

Nombre

Tipo

Descripción

id

String

Identificador de la entidad TipoEmpresa.

nombre

String

Nombre. 

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

TipoEmpresaContabilidad

Nombre

Tipo

Descripción

id

String

Identificador de la entidad TipoEmpresaContabilidad.

nombre

String

Nombre.

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

TipoTerceroReinoUnido

Nombre

Tipo

Descripción

id

String

Identificador de la entidad TipoTerceroReinoUnido. Posibles valores: S (Tercero normal), IN (Tercero de Irlanda del Norte).

nombre

String

Nombre. Posibles valores: Tercero normal (S), Tercero de Irlanda del Norte (IN).

TipoTerceroReinoUnido  Ampliar origen
{
"id":"IN",
"nombre": "Tercero de Irlanda del Norte"
}

EmpresaClasificacion

Nombre

Tipo

Descripción

id

String

Identificador de la clasificación.

codigo

String

Código de la clasificación.

nombre

String

Nombre de la clasificación.

padreId

String

Identificador de la entidad padre de la clasificación.

Empresa-Clasificación padre  Ampliar origen
{
"id": "1",
"codigo": "01"
"nombre":"Cultivos no perennes",
"padreId": null
}
Empresa-Clasificación hija de primer nivel  Ampliar origen
{
"id": "2",
"codigo": "0112"
"nombre":"Cultivo de arroz",
"padreId": "1"
}

DatosContacto


Nombre

Tipo

Descripción

paisContacto

Pais

Se devuelve la entidad Pais con todos sus campos. Ver definición en UM - SGI - ESB - SGO.

comAutonomaContacto

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.

codigoPostal

String

Código postal de la empresa.

tipoVia

TipoVia

Tipo de vía de la dirección de contacto de la empersa. Se devuelve la entidad TipoVia con todos sus campos. Ver definición en UM - SGI - ESB - SGO.

nombreVia

String

Nombre de la vía de la dirección de contacto de la empresa.

numero

String

Número de la vía de la dirección de contacto de la empresa.

ampliacion

String

Campo para ampliar la informaicón de la dirección de contacto de la empresa.

email

String

Email de contacto de la empresa.

fax

String

Fax de contacto de la empresa.

telefono

String

Teléfono de contacto de la empresa.

direccionWeb

String

Dirección web de la empresa.



DatosContacto  Ampliar origen
{
"paisContacto": {
"id":"33",
"nombre":"España"
},
"comAutonomaContacto": {
"id":"ca-3",
"nombre":"Asturias"
},
"provinciaContacto": {
"id":"pro-1",
"nombre":"Asturias"
},
"ciudadContacto": "Oviedo",
"codigoPostal": "33002",
"tipoVia": {
"id":"tv-1",
"nombre":"Calle"
},
"nombreVia": "Uría",
"numero": "4",
"ampliacion": "puerta A",
"email": "email@empresadeprueba.es",
"fax": "985798765",
"telefono": "985798766",
"direccionWeb": "www.empresadeprueba.es"
}

TipoVia

Nombre

Tipo

Descripción

id

String

Identificador de la entidad TipoVia.

nombre

String

Nombre.

Servicios

Cambios
03-may-2021 Se actualizan los servicios API para:

...