Contrato de Servicio

Transcripción

1 Contrato de Servicio Servicio de consulta del estado de Facturas Junta de Comunidades de Castilla la Mancha VERSIÓN: 1.00 FECHA: Octubre de 2015 CORREO ELECTRÓNICO:

2 ÍNDICE CONTRATO DE SERVICIO... 1 ÍNDICE DATOS FUNCIONALES REQUERIMIENTOS FUNCIONALES Requerimientos Cubiertos Restricciones de Uso SERVICIO CONSULTAESTADOS Operación getinvoicestatus Descripción de la funcionalidad de la operación Precondiciones para su utilización Parámetros de entrada Parámetros de salida Documentación adjunta: Datos de invocación RESTRICCIONES DE SEGURIDAD CÓDIGOS ESTADOS EQUIVALENCIA CÓDIGOS ESTADOS FLUJO CÓDIGOS ESTADOS... 8 Fecha Impresión: 10/12/2015 Página 2 de 8

3 1 DATOS FUNCIONALES 1.1 Requerimientos funcionales Servicio responsable de obtener a partir de una lista de números de Registro Único (en adelante RCF), el estado de cada una de las facturas correspondientes a dicho RCF. 1.2 Requerimientos Cubiertos. El servicio implementa los siguientes requerimientos: Los proveedores podrán obtener el estado de tramitación de las facturas presentadas. 1.3 Restricciones de Uso. Uso restringido a los proveedores de Junta de Comunidades de Castilla la Mancha y la aplicación web correspondiente al sistema de gestión de factura electrónica de Junta de Comunidades de Castilla la Mancha. Los proveedores de Junta de Comunidades de Castilla la Mancha deben estar contratados previamente en la plataforma a través de los parámetros configurados en el módulo de administración. 1.4 Servicio ConsultaEstados 1.5 Operación getinvoicestatus Descripción de la funcionalidad de la operación Obtiene a través de una lista de RCF recibidos como parámetros, los estados de tramitación en los que se encuentran actualmente las facturas correspondientes al conjunto de RCF recibidos Precondiciones para su utilización No existe ninguna precondición para su utilización Parámetros de entrada El método dispone de un único parámetro de entrada de tipo GetStatusInvoiceStatusRequestType que se ajusta a la siguiente definición: Fecha Impresión: 10/12/2015 Página 3 de 8

4 Como puede apreciarse, esta estructura tiene un único campo que es de tipo de datos InvoiceStatusRequestType, cuya definición es la siguiente: El campo cuyo tipo de datos es InvoiceStatusRequestType contiene una lista de 0 a n elementos, de tipo RcfType que contiene un elemento por cada RCF que quiera consultarse. Todos los elementos y tipos están contenidos en esquemas embebidos dentro del.wsdl según corresponda. Se adjunta a este documento el fichero: getinvoicesstatusrequest.xml, con un ejemplo de invocación Parámetros de salida El documento de salida obtenido como resultado de invocar la operación es del tipo GetStatusResponseType que se ajusta a la siguiente definición: Contiene un elemento de tipo InvoiceStatusResponseType, cuya definición es la siguiente: Fecha Impresión: 10/12/2015 Página 4 de 8

5 Se devuelve una lista de registros de tipo RegisterData, por cada uno de los RCF recibidos como parámetro de entrada, cuya definición es la mostrada en la imagen anterior. Todos los elementos y tipos están contenidos en esquemas embebidos dentro del.wsdl según corresponda. A parte se adjunta los esquemas embebidos por separado. A continuación se detalle el significado de los campos que componen la estructura: rcf: contiene el RCF de la factura para la cual se están devolviendo los datos de estado. Debe coincidir con el enviado en la request. status: contiene el código que identifica el estado en el que se encuentra la factura. invoicenumber: contiene el número de la factura value: descripción corta del estado description: descripción larga del estado en el que se encuentra la factura. Los estados devueltos se corresponden con la siguiente tabla: Código Descripción corta Descripción larga 100 ERROR Mostrará la información del registro de la última auditoría asociada a la factura 150 NO EXISTE La factura no existe en PeCAM. 300 FIRMADA La factura está correctamente generada y/o recibida en el servicio PeCAM. 450 CONSOLIDADA La factura recibida en el PeCAM ha superado las validaciones establecidas por el destinatario, y ha sido remitida al sistema contable de la oficina contable destinataria. 603 PAGADA La obligación de pago derivada de la factura ha sido pagada completamente por Tesorería. 600/800 ACEPTADA La factura ha sido registrada por el Órgano Gestor destinatario y ha sido conformada y validada. 700 RECHAZADA Mostrará la información del registro de la última auditoría asociada a la factura 901 ENTREGADA La factura ha sido recibida, superando las validaciones automatizadas y en espera de ser tratada por el Órgano Gestor destinatario. Fecha Impresión: 10/12/2015 Página 5 de 8

6 200 RECIBIDA EN PLATAFORMA Recibida en Plataforma. 400 PENDIENTE DE VERIFICACION La factura está pendiente de verificación de firma. Se adjunta a este documento el fichero: getinvoicesstatusresponse.xml, con un ejemplo de respuesta del servicio. 1.6 Documentación adjunta: - WSDL: o getinvoicestatus.wsdl - Ejemplos: o getinvoicesstatusrequest.xml o getinvoicesstatusresponse.xml 1.7 Datos de invocación Protocolo: Soap 1.1 Soap Binding: Tipo de transporte: URL: Preproducción (integración y pruebas) URL: Producción Certificado: Document/literal https mgetinvoicesstatusservicesecureproxy tinvoicesstatusservicesecureproxy Descargar 2 RESTRICCIONES DE SEGURIDAD La seguridad se establecerá a nivel de transporte y de mensaje, tal y como a continuación se detalla: Nivel de Transporte: Https/ One way SSL, es decir, autenticación de servidor vía SSL, sin autenticación de cliente Fecha Impresión: 10/12/2015 Página 6 de 8

7 Nivel de Mensaje: Existirá autenticación a nivel de mensaje la cual se traducirá en el suministro por parte del cliente de un token usuario y password en la cabecera del mensaje SOAP. De esta manera, sólo usuarios autorizados podrán acceder al servicio. Declarativamente, el suministro del usuario y la password se hará según la siguiente expresión Xpath: declare namespace soapenv=" /soapenv:envelope/soapenv:header/authentication/@username declare namespace soapenv=" /soapenv:envelope/soapenv:header/authentication/@password 3 CÓDIGOS ESTADOS 3.1 Equivalencia códigos estados La equivalencia entre los códigos de estados utilizados en PeCAM y los utilizados por FACe se indican en la siguiente tabla. PeCAM Estados FACe Descripción Código Estado En trámite 2100 Registrada en RCF Reencaminada 2100 Registrada en RCF Recibida en Plataforma 2100 Registrada en RCF Firmada 2100 Registrada en RCF Pendiente de verificación 2100 Registrada en RCF Entregada 2100 Registrada en RCF Rechazada 2600 Rechazada Aceptada 2300 Aceptada Propuesta pago 2400 Reconocida la Obligación Pagada 2500 Pagada Parcialmente pagada 2500 Pagada Fecha Impresión: 10/12/2015 Página 7 de 8

8 3.2 Flujo códigos estados Error 2800 Error El flujo que realiza una factura en la Plataforma de PeCAM se resume en el siguiente esquema: 200 Recibida en Plataforma 400 Pendiente de verificación 300 Firmada 100 Error 450 Consolidada 700 Rechazada 901 Entregada 600/800 Aceptada 603 Pagada Fecha Impresión: 10/12/2015 Página 8 de 8