Plantilla y estructura del fichero de alta y actualización de deuda

Recomendación: Descárgate una muestra en csv/excel para ver el formato del fichero.

1. Introducción

En este documento queda reflejada la estructura y datos de configuración que debe de disponer el fichero de aportación de datos.

2. Relación de datos a aportar

El fichero contendrá los datos necesarios para poder crear una operación en ICIRED. Estos son: datos del acreedor, del deudor, de la operación y del impago/factura.

Características de los Campos

Los importes en euros vendrán expresados con formato numérico europeo, utilizando un punto para separar los grupos de miles y una coma para indicar la posición decimal.

Las Tablas que describen el diseño de los diferentes tipos de registro contienen las siguientes columnas:

Nombre del Campo: Indica el Nombre del campo
Descripción: Indica la definición y el contenido del campo
Tipo: Indica el tipo de formato de campo (numérico, tabla, cadena, etc)
Long.: Número de caracteres máximos que permite el campo
Oblig.: Obligatoriedad del campo
Observaciones: Indica las observaciones sobre obligatoriedad y validaciones que se realizarán en el campo

3. Colección de datos del fichero

Nombre	Descripción	Tipo	Long.	Oblig.	Observaciones
Deudor NIF NIE	NIF del deudor de la operación.	Cadena	9	Sí	Debe ser NIF válido en España. Validación según el tipo de sociedad: Letra + 7 dígitos + digito control (numérico o alfabético)
Deudor nombre	Nombre o razón social del deudor de la operación	Cadena	256	Sí	Será nombre o razón social en función de si el deudor es una persona física o jurídica.
Deudor apellidos	Apellidos del deudor de la operación	Cadena	256	*	Sólo es obligatorio en el caso de que el deudor sea una persona física
Deudor tel	Teléfono móvil del deudor de la operación.	Cadena	9	*	Puede estar vacío si el producto no incluye la notificación por sms certificado. Debe ser un teléfono móvil válido.
Deudor email	Email del deudor de la operación.	Cadena	256	*	Puede estar vacío si el producto no incluye la notificación por email certificado. Debe ser una dirección de correo válida.
Deudor direccion	Descripción de la dirección del deudor.	Cadena	150	*	Puede estar vacío si el producto no incluye la notificación postal al deudor.
Deudor CP	Código postal del deudor de la operación.	Cadena	5	*	Puede estar vacío si el producto no incluye la notificación postal al deudor. Cadena que represente un código postal válido en función del país del deudor. En el caso de España se constituye con 5 valores numéricos dónde sus dos primeros dígitos correspondan a una provincia
Deudor localidad	Localidad del deudor de la operación.	Cadena	256	*	Puede estar vacío si el producto no incluye la notificación postal al deudor.
Referencia operacion	Número de referencia utilizado por el cliente para identificar unívocamente la operación impagada.	Cadena	256	Sí	Es un campo alfanumérico. Este valor debe ser único para cada operación
Referencia factura	Referencia de la factura impagada.	Cadena	256	Sí	Es única por cliente y operación No puede estar duplicada en más de un registro de una operación. Admite espacios en blanco: Si se añaden espacios en blanco al principio o final de la cadena se eliminan. Distingue entre mayúsculas y minúsculas.
Importe pendiente	Cantidad que indica el importe pendiente de pago de una factura	Numérico	10	Sí	Debe venir en formato #,# Por ejemplo: 1550,99 Será redondeado a dos decimales.
Fecha vencimiento	Fecha de vencimiento de la factura	Fecha	10	Sí	Formato dd-mm-aaaa El separador es "-". No puede ser posterior a la fecha de procesamiento.
Fecha suspension
Tipo producto Icired	Tipo de producto que se desea crear y al que se asociará la operación	Tabla	256	*	No es obligatorio si se le ha configurado un producto por defecto en BackOffice. Debe ser uno de los valores permitido en la TC01
Iban	Iban del acreedor informado para el pago de la deuda.	Cadena	24	*	No es obligatorio si el IBAN del acreedor es siempre el mismo y se le ha configurado en el BackOffice. Debe ser un IBAN válido de España.
Referencia cartera	Referencia de la cartera operativa a la que pertenezca la operación.	Cadena	256	*	Este campo sólo es obligatorio si tiene creada diferentes carteras de deuda en el BackOffice. Debe estar previamente Informada por el cliente y dada de alta en el BackOffice.
Acreedor NIF NIE	NIF del acreedor de la operación.	Cadena	20	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice Debe ser un NIF (CIF, DNI, NIE para España) válido en función del tipo de acreedor
Acreedor nombre	Nombre o razón social del acreedor de la operación, en función de si el acreedor es de tipo Empresa.	Cadena	256	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice
Acreedor apellidos	Apellidos del del acreedor de la operación cuando el tipo del acreedor es un autónomo.	Cadena	256	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice
Acreedor tel	Teléfono del acreedor de la operación.	Cadena	9	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice. Debe ser un teléfono válido.
Acreedor email	Email del acreedor de la operación.	Cadena	256	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice Debe ser un email válido
Acreedor direccion	Descripción de la dirección del acreedor.	Cadena	150	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice
Acreedor CP	Código postal del acreedor de la operación.	Cadena	5	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice Cadena que represente un código postal válido en función del país del deudor. En el caso de España se constituye con 5 valores numéricos dónde sus dos primeros dígitos correspondan a una provincia
Acreedor localidad	Localidad del acreedor de la operación.	Cadena	256	*	No es obligatorio si el acreedor es siempre el mismo y se ha configurado en el Backoffice
Origen deuda	Origen o naturaleza de la operación a la que estará asociada la deuda.	Tabla	2	*	No es obligatorio si el origen es siempre el mismo y se ha configurado un código por defecto en backoffice. Debe ser uno de los valores permitidos en la TC02
Fecha suspension	Indica la fecha hasta la que quieres suspender la operación	Fecha		No	Formato dd-mm-aaaa El separador es "-". No puede ser anterior a la fecha de procesamiento.

Tablas de códigos y valores permitidos

TC01 - Tabla Tipo de Producto ICIRED

Los clientes pueden tener dos tipos de contratos: ICIRED CS o ICIRED Impagados. Dependiendo del tipo de contrato, estarán disponibles diferentes tipos de productos.

En las siguientes tablas se describe el tipo de producto asociado a la operación impagada procesada en ICIRED y los servicios incluidos en cada tipo de producto.

Hay una tabla específica para cada tipo de contrato, y el sistema verificará que el código del tipo de producto esté incluido en el contrato. Si, durante el procesamiento, se recibe un código de producto no contratado, la operación no será válida, no se procesará y se registrará en el log de carga dentro del fichero de errores.

Nota: Si el cliente tiene asignado en backoffice un tipo de producto por defecto, este campo podrá permanecer vacío.

Tabla si el contrato del cliente es ICIRED Impagados:

Código	Servicios incluidos	Método de notificación
ICIRED_EMAIL_CERTIFICADO	Requerimiento de pago Publicación en el fichero Notificación de inclusión	EMAIL Certificado
ICIRED_SMS_CERTIFICADO	Requerimiento de pago Publicación en el fichero Notificación de inclusión	SMS Certificado
PUBLICACION_EMAIL_CERTIFICADO	Requerimiento de pago Publicación en el fichero Notificación de inclusión	EMAIL Certificado
PUBLICACION_SMS_CERTIFICADO	Requerimiento de pago Publicación en el fichero Notificación de inclusión	SMS Certificado

Tabla si el contrato es ICIRED CS

Código	Servicios incluidos	Método de notificación
99111	Requerimiento de pago Publicación en el fichero Notificación de inclusión	EMAIL Certificado
99112	Requerimiento de pago Publicación en el fichero Notificación de inclusión	SMS Certificado

T02- Tabla Origen Deuda:

En esta tabla se define el origen o naturaleza de la deuda a la que estará asociada la deuda.

Nota: Si el cliente tiene asignado en backoffice un origen de la deuda por defecto, este campo podrá permanecer vacío.

Código	Descripción
0	Contrato de agencia comercial
1	Contrato de anticresis
2	Contrato de arras
3	Contrato de arrendamiento
4	Contrato de cesión de derecho de superficie
5	Contrato de cesión de licencia
6	Contrato de cesión de marca
7	Contrato de comisión e intermediación
8	Contrato de compraventa
9	Contrato de concesión
10	Contrato de corretaje
11	Contrato de depósito
12	Contrato de donación remuneratoria
13	Contrato de factoring
14	Contrato de fianza o aval
15	Contrato de fiducia
16	Contrato de franquicia
17	Contrato de futuros o forward
18	Contrato de habitación
19	Contrato de leasing
20	Contrato de mandato
21	Contrato de obra
22	Contrato de prestación de servicios
23	Contrato de préstamo
24	Contrato de seguro
25	Contrato de sociedad
26	Contrato de suministro
27	Contrato de transporte
28	Contrato de traspaso
29	Contrato de underwriting
30	Contrato laboral
31	Indemnización derivada de delito o falta
32	Obligación extracontractual
33	Servidumbre
34	Contrato financiero
35	Obligación de pago acordado en procesos matrimoniales o de menores
36	Obligación de pago acordado en procesos de división de herencia
37	Obligación de pago acordado en procesos de liquidación del régimen económico matrimonial
38	Cuotas de contribución a gastos comunes en inmuebles divididos en régimen de propiedad horizontal