Tipos de Documentos (Actualización)
Tipos de Documentos
Se introduce una mejora en el endpoint de carga de un documento.
El objetivo es estandarizar un formato de tipos de documentos entre los sistemas que originan documentos (Pilaga, Diaguita, etc), Araí-Documentos y Sudocu.
Para ello, se definen una serie de atributos que serán obligatorios, o se constituirán
en Araí Documentos a partir de datos de configuración por default, o de datos enviados
por los sistemas de origen.
Consideraciones iniciales
- Conocer los Tipos de Documentos disponibles
- A partir de version 1.1.0 de Araí Documentos
- A partir de version 1.1.0 de Sudocu
- Defaults a partir de variables de entorno
Configuraciones
configuraciones Existen algunos cambios de configuraciones que se deben verificar respecto a versiones anteriores:
- Variables de Organismo por Default
ORGANISMO_TIPO=CUIL
ORGANISMO_IDENTIFICADOR=XXXXXXXX
ORGANISMO_TIPO
puede ser CUIT
o CUIL
ORGANISMO_IDENTIFICADOR
debe poseer el siguiente formato:
- 10 u 11 dígitos numéricos consecutivos ej: 20111111115
- Formato CUIT con
-
y/
ej1: 20-11111111-5 ej2: 20-11111111/5
- Variables de conexión a Sudocu
Debido a un error en la configuración en versiones anteriores de la url de la api de sudocu,
se debe corregir:
TRAMITES_PARAMS={base_uri:'http://url-server/api/integracion/', method:'basic', user:'user', password:'password'}
- reemplazando por (notar que se elimina
integracion/
):
TRAMITES_PARAMS={base_uri:'http://url-server/api/', method:'basic', user:'user', password:'password'}
Implementar en sistema originante de documentos
Se involucran algunos campos previamente disponibles POST de documentos
A continuación indicaremos que campos se incluirán al post anterior y que campos comienzan a tener mayor relevancia para definir la metadata de un documento:
POST /backend/documentos
REQUEST
Campos obligatorios (Body Json)
Nombre | Tipo | Descripción |
---|---|---|
nro | object | Objeto que contiene todos los campos necesarios para implementar la nueva funcionalidad |
tipo_visible(*) | string | Tipo visible corresponde al tipo de documento del sistema origen que identificara al documento en el expediente |
nro_visible | string | Numero visible corresponde al un string visible del sistema origen que identificara al documento en el expediente |
metadata | object | Objeto que contiene detalles de la metadata del documento (Ver campos permitidos) |
numero(*) | string | Numero que identifica al documento que se esta enviando |
anio | integer | Correspondiente a la fecha, por default utiliza el actual |
revision | string | Corresponde a los documentos que se modifican, Por default "00" |
organismo | object | Objeto que contiene información del Organismo |
tipo_identificador | string | Tipo de Identificador de Organismo. Default en configuración |
tipo_identificador | string | Identificador de Organismo. Default en configuración |
(*) Campos obligatorios
{
"nro":
{
"tipo_visible": "string",
"nro_visible": "string",
"metadata": {
"numero": "string",
"anio": "integer",
"revision": "string",
"organismo":
{
"tipo_identificador": "string",
"identificador": "string"
}
}
},
"origen":
{
"id_usuario_sso": "string",
"id_instalacion": "string",
"cuenta_usuario": "string"
}
/*Demas en POST de Documentos*/
}
Validaciones sobre el campo nro
- calculateNroVisible()
Si no se envía el campo nro_visible
se conforma de la siguiente manera:
tipo_visible-numero/anio(revision)tipo_identificador:identificador
setOrganismoDefault()
organismo.tipo_identificador
yorganismo.identificador
se pueden indicar desde el sistema de origen. En caso de no indicarlos, el sistema toma el valor configuradovalidateUniqueIdentificadorSudocu()
Los campos nro.tipo_visible
, nro.nro_visible
y origen.origen_numeracion
deben ser unicos en el sistema
- validateUniqueMetadataNro()
Los campos nro.metadata
y origen.origen_numeracion
deben ser unicos en el sistema
Origen Numeración
Se agrega la posibilidad de indicar un origen de numeración en los campos de origen del documento
{
"origen":
{
"id_usuario_sso": "string",
"id_instalacion": "string",
"cuenta_usuario": "string",
"origen_numeracion": "string"
}
}
origen_numeracion
si viene vacío se toma el id_instalacion
para llenar este campo