...
Entidad | Descripción | |||||
---|---|---|---|---|---|---|
Empresa | Contiene los datos básicos de una empresa. | |||||
DatosContacto | Contiene los datos de contacto de la empresa. | |||||
TipoIdentificador | Listado con los tipos de identificador fiscal (CIF, VAT, ...). | |||||
EmpresaClasificacion | Listado de relaciones entre empresas y clasificaciones. Las empresas se relacionarán únicamente con las clasificaciones del tipo "Sector Industrial". Ver definición de clasificaciones en SGI - ESB - SGO.
|
Modelo lógico
API
Características generales que todas las API REST deben de cumplir:
...
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. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "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, ...). |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "id":"tp-1", "nombre": "CIF" } |
DatosTipoEmpresa
...
language | java |
---|---|
theme | RDark |
title | TipoTercero |
collapse | true |
TipoEmpresa
...
DatosContacto
Nombre | Tipo | Descripción | |
---|---|---|---|
direccion | String | Dirección de contacto de la empresa. |
Bloque de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "direccion": "C/ Uría, número 4, puerta A, 33002, Oviedo, Asturias, España" } |
...
Método | URL | Parámetros | Respuesta | Descripción | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
GET | /empresas | q+s (query + sort) La query estará formada por:
| Lista[Empresa] | Listado de Empresa. Ejemplo: nombre=like=(Tree);(razonSocial=like=SL) | ||||||||
GET | /empresas/{id} | id | Empresa | Detalle de los datos generales de una empresa. | ||||||||
GET | /empresas/formly/create | Formly | Devuelve el formulario (formly) a pintar para la pantalla de solicitar alta empresa, pestaña "Datos generales". Ver IU-GEN-0081 - Solicitar alta de empresa. | |||||||||
POST | /empresas | JSON | Recibe como parámetro la respuesta del usuario del formulario de datos de alta (formly) con los campos necesarios para crear una empresa. | |||||||||
PUT | /empresas | JSON | id Vendrá relleno si la creación es síncrona y no vendrá si es asíncrona. | Recibe como parámetro la respuesta del usuario del formulario de datos de modificación (formly) con los campos necesarios para actualizar una empresa. | ||||||||
GET | /empresas/formly/{id} | JSON | Devuelve los datos a pintar en el formulario de Ver Detalle/Actualizar en el SGI (formly). | |||||||||
GET | /datos-contacto/empresa/{id} | id | DatosContacto | Contiene los datos de contacto de una empresa. |
| 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).||||||
| empresa | . | ||||||||||
GET | /tipos-identificador | Lista[TipoIdentificador] | Listado de tipos de identificador fiscal para las empresas ordenados alfabéticamente de forma ascendente. | ordenados alfabéticamente de forma ascendente. | ||||||||
GET | /empresas/modificadas-ids | q+s La query estará formada por:
| Lista[String] | Listado de los identificadores de empresas que han sufrido cambios en los datos de identificativos de la empresa o en sus datos de contacto. |
...