interfaz ws face- proveedores
DESCRIPTION
Interfaz WS FACe- ProveedoresTRANSCRIPT
-
Servicios parasistemasautomatizadosde proveedoresEquipo de desarrollo de FACe
www.princexml.comPrince - Non-commercial LicenseThis document was created with Prince, a great way of getting web content onto paper.
-
Esta pgina se ha dejado vaca a propsito
-
ndice de contenidosCaptulo 1 Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 Historial de versiones del documento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 Objetivo de este documento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.3 Firma electrnica en los servicios web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Captulo 2 Alta de su sistema en la plataforma . . . . . . . . . . . . . . . . . . . . 7
2.1 Certificado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Captulo 3 Formato de factura admitido por la plataforma FACe . . . . 9
Captulo 4 Definicin de los servicios para sistemas automatizados deproveedores. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.1 WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.2 Enviar Factura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.3 Consultar Factura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.4 Anular Factura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.5 Consultar Estados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.6 Consultar Unidades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.7 Consultar Listado Facturas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.8 Consultar Administraciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.9 Consultar Unidades Por Administracin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Apndice A Firma de los servicios web. . . . . . . . . . . . . . . . . . . . . . . . . . . 33
A.1 Ejemplo de peticin firmada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
A.2 Ejemplo de respuesta firmada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Apndice B Resumen de los estados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
B.1 Estados de tramitacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
B.2 Estados de anulacin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Apndice C Datos de prueba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Apndice D Mimes admitidos por la aplicacion. . . . . . . . . . . . . . . . . . . 41
-
Apndice E Integracin con WSDL en RPC/Literal . . . . . . . . . . . . . . . 43
Apndice F Integracin con validacin de certificado publico ypolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
F.1 Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
F.2 Clave publica del certificado en las respuestas SOAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
-
Captulo 1
Introduccin1.1 Historial de versiones del documentoVersin Fecha Descripcin de los cambios
1.0.0 01/06/2013 Inicio del documento
1.0.1 01/02/2014 Revision de las interfaces
1.2.3 03/11/2014 Revision de las urls, actualizacin de los estados
1.2 Objetivo de este documentoEl objetivo de este documento es facilitar la labor de integracin para los sistemas auto-matizados de proveedores dentro de la plataforma de facturacin electrnica FACe
1.3 Firma electrnica en los servicios webUsted debe tener en cuenta que todas las peticiones y respuestas deben ir firmadas porun certificado reconocido por la plataforma @firma (https://valide.redsara.es/valide/faqs.html#3) .
En el capitulo "Firma de los servicios web" encontrar ms informacin.
5
-
Esta pgina se ha dejado vaca a propsito
6
-
Captulo 2
Alta de su sistema enla plataformaLos sistemas que deseen integrarse con la plataforma FACe necesitan solicitar el alta, pa-ra ello, debern facilitar la parte pblica del certificado de componente que utilizarn pa-ra firmar las peticiones.
Para solicitar el alta debe dar de alta el certificado de su organismo, aceptar las condicio-nes de uso del sistema y firmar una declaracin de responsabilidad en el portal face.gob.esen la seccin 'alta proveedores'.
2.1 CertificadoEl certificado que tienen que remitir tiene la siguiente forma.
-----BEGIN CERTIFICATE-----
MIIIXTCCB0WgAwIBAgIJALuqFmwpfhMTMA0GCSqGSIb3DQEBBQUAMIHgMQswCQYD
VQQGEwJFUzEuMCwGCSqGSIb3DQEJARYfYWNfY2FtZXJmaXJtYV9jY0BjYW1lcmZp
// ..
KnqOrQzKlN5CsZE7ObXT4DSlS3c62sEyb716iIpSX79C
-----END CERTIFICATE-----
7
-
Esta pgina se ha dejado vaca a propsito
8
-
Captulo 3
Formato de facturaadmitido por laplataforma FACeEl formato de factura electrnica admitido por la plataforma es FACTURAE 3.2 y 3.2.1,para ms informacin sobre dicho formato consulte la direccin www.facturae.es.
Adems de la obligatoriedad del uso de dicho formato el sistema requiere la obligatorie-dad del uso de una serie de campos dentro de la factura para la comunicacin de los des-tinatarios. Algunos de estos campos son obligatorios en todas las facturas, otros de ellosson opcionales, pero en el caso de que se desee informar de los mismos debe hacerse me-diante el campo que se indica.
Dentro del documento de factura electrnica (.xsig) ser obligatorio, para la correcta re-misin de la factura al rgano destinatario final, informar del rgano gestor, la unidadtramitadora y la oficina contable destinatarios. Y opcionalmente del rgano proponentey del nmero de expediente al que pertenece la factura.
Las unidades debern ir codificadas bajo la etiqueta de centros administrativos del de la factura.
ROL Cdigo CentroCode Descripcin Tipo
Fiscal 01 Cdigo de la unidad en
DIRECTORIO
Oficina
Contable
Obligatorio
9
-
ROL Cdigo CentroCode Descripcin Tipo
Receptor 02 Cdigo de la unidad en
DIRECTORIO
rgano Gestor Obligatorio
Pagador 03 Cdigo de la unidad en
DIRECTORIO
Unidad
Tramitadora
Obligatorio
Comprador 04 Cdigo de la unidad en
DIRECTORIO
rgano
proponente
Opcional
El cdigo del centro ser el cdigo de dicha unidad en el sistema Direc-torio Comn de Unidades Orgnicas y Oficinas DIR3. Para los roles obligatorios se po-dr realizar una consulta de las unidades y sus cdigos a travs del directorio presente enla plataforma FACe. Su consulta est disponible desde el portal del proveedor en la sec-cin Consulte el directorio de unidades.
Ejemplo de XML todos los roles de centros administrativos rellenos:
[code xml]
E00000001
01
direccion
18230
Madrid
Madrid
ESP
Oficina Contable
P00000001
01
direccion
18230
Madrid
Captulo 3 Formato de factura admitido por la plataformaFACe
Servicios para sistemas automatizados deproveedores
10
-
Madrid
ESP
Organo Gestor
E00000002
02
direccion
18230
Madrid
Madrid
ESP
Organo Gestor
P00000003
03
direccion
18230
Madrid
Madrid
ESP
Unidad Tramitadora
E00000004
04
direccion
18230
Madrid
Madrid
ESP
Servicios para sistemas automatizados deproveedores
Captulo 3 Formato de factura admitido por la plataformaFACe
11
-
Subdireccion de compras
Si se debiera consignar el nmero del expediente asociado a la factura, se recomienda ha-cerlo en el campo de la primera lnea de los conceptos de la factura.
[code xml]
// ...
El campo FileReference es una recomendacin, FACe no hace uso de dicho campo pararedirigir o almacenar las facturas en su plataforma de facturacin. Es decisin del orga-nismo destinatario la obligatoriedad u opcionalidad del nmero de expediente en unafactura as como decidir el uso del campo FileReference para informar del mismo.
Captulo 3 Formato de factura admitido por la plataformaFACe
Servicios para sistemas automatizados deproveedores
12
-
Captulo 4
Definicin de losservicios parasistemasautomatizados deproveedores.A continuacin se detallan los servicios web disponibles para proveedores del servicio FA-Ce
Recuerde que todas las peticiones han de ir firmadas tal y como se indica en el captulo"Firma de los servicios web."
4.1 WSDLPuedes encontrar el wsdl de los servicios en las siguientes rutas:
Entorno Ruta
STAGING (https://se-face-webservice.redsara.es/sspp?wsdl)
PROD (https://webservice.face.gob.es/sspp?wsdl)
El entorno de PROD es el entorno de produccin de FACe, mientras que el entorno deSTAGING es un entorno de integracin habilitado para pruebas de los sistemas de losproveedores.
13
-
4.2 Enviar FacturaEste servicio permite enviar facturas al sistema.
4.2.1 PeticinA continuacin aparece un ejemplo de estructura de peticin.
[code xml]
XXXX correo electronico
XXXX
_contenido en
base_64 del fichero factura_
_nombre del fichero
factura_
_mimeType del fichero
factura_
_contenido en base_64
del fichero anexo_1_
_nombre del fichero
anexo_1_
_mimeType del fichero
anexo_1_
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
14
-
_contenido en base_64
del fichero anexo_2_
_mimeType del fichero
anexo_2_
* contenido en base_64
del fichero anexo_n *
* nombre del fichero
anexo_n *
* mimeType del fichero
anexo_n *
4.2.1.1 ValoresLa peticin al servicio se estructura en 3 apartados:
Informacin del proveedor:
Parametro Descripcin
correo Correo destinatario de las distintas notificaciones asociadas a la factura
Fichero factura
Parametro Descripcin
factura Contenido codificado en base64 del documento .xsig de la factura, el
fichero debe tener la extensin vlida ".xsig"
nombre nombre del documento de la factura
mime mime type del documento, en este caso debe ser "application/xml"
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
15
-
Ficheros Anexos: Los anexos son optativos, existe un maximo de 5 anexos.
Parametro Descripcin
anexo Contenido codificado en base64 del documento anexo
nombre nombre del documento anexo
mime mime type del documento. Ver mimes admitidos en el Apendice D
(pgina 41)
4.2.2 RespuestaLa respuesta contiene los datos ms representativos de la factura que ha sido enviada:
[code xml]
_CODIGO_
_UNIDAD_
_UNIDAD_
_UNIDAD_
_IDENTIFICADOR_
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
16
-
_NUMERO_
_SERIE_
_FECHA_
4.2.2.1 ValoresParametro Descripcin
codigo_registro Cdigo de registro en el REC, identificador nico de la
factura dentro de la plataforma
organo_gesto Cdigo dir del Organo Gestor destino
unidad_tramitadora Cdigo dir de la unidad tramitatora destino
oficina_contable Cdigo dir de la oficina contable destino
identificador_emisor identificador del emisor(NIF o CIF o NIE ...)
numero_factura nmero de la factura
serie_factura serie de la factura
fecha_recepcion fecha de recepcin de la factura
4.3 Consultar FacturaEste servicio permite consultar el estado de una factura.
4.3.1 PeticinPara realizar esta consulta nicamente es necesario especificar uno de los valores solicita-dos:
[code xml]
-
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:web="https://webservice.face.gob.es">
_CODIGO_REGISTRO_
4.3.1.1 ValoresParametro Descripcin
numero_registro Cdigo de registro en el REC, identificador nico de la factura
dentro de la plataforma
Esta peticion buscar la factura con el cdigo de registro indicado.
4.3.2 RespuestaLa respuesta contiene informacin sobre el estado de la factura:
[code xml]
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
18
-
_NUMERO_REGISTRO
_CODIGO_ESTADO_
_DESCRIPCION_CAMBIO_ESTADO_
_CODIGO_ESTADO_ANULACION_
_DESCRIPCION_CAMBIO_ESTADO_ANULACION_
4.3.2.1 ValoresParametro Descripcin
numero_registro Cdigo de registro en el REC, identificador nico de la factura
dentro de la plataforma
tramitacion Informacion del estado de tramitacin. Contiene los elementos
codigo_estado,descripcion_estado y motivo_estado
anulacion Informacion del estado de anulacin. Contiene los elementos
codigo_estado,descripcion_estado y motivo_estado
codigo_estado Cdigo del estado actual de la factura
descripcion_estado Descripcin del motivo del cambio de estado al actual
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
19
-
Parametro Descripcin
motivo_estado Comentario asociado al estado
4.4 Anular FacturaEste servicio permite solicitar la anulacin de una factura.
Es necesario que el cambio de estado sea vlido. No se podr solicitar la anulacin de fac-turas en estado: Pagada, Rechazada, Anulada o Propuesta Anulacin.
4.4.1 Peticin[code xml]
_NUMERO_REGISTRO_
_MOTIVOS_DE_ANULACION_
4.4.1.1 ValoresParametro Descripcin
numero_registro Cdigo de registro en el REC, identificador nico de la factura
dentro de la plataforma
motivo Descripcin del motivo por el que se hace la anulacin de la
factura
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
20
-
4.4.2 RespuestaLa respuesta contiene los datos ms representativos de la factura anulada:
[code xml]
_NUMERO_REGISTRO_
Anulacin solicitada
correctamente
4.4.2.1 ValoresParametro Descripcin
numero_registro Cdigo de registro en el REC, identificador nico de la factura
dentro de la plataforma
mensaje "Anulacin solicitada correctamente"
En caso de error o cambio de estado no vlido, se devolver la excepcin correspondiente.
4.5 Consultar EstadosEste servicio permite consultar los posibles estados de una factura.
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
21
-
4.5.1 Peticin[code xml]
4.5.2 RespuestaLa respuesta contiene los datos ms representativos de los distintos estados por los quepuede pasar una factura.
[code xml]
Registrada
1100
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
22
-
El sistema ha
registrado la factura en el REC o en el registro de la IGAE
.............
4.5.2.1 ValoresCada estado estar representado por los siguientes valores:
Parametro Descripcin
nombre Nombre del estado
codigo Cdigo representativo y nico del estado
descripcin Descripcin del estado
4.6 Consultar UnidadesEste servicio permite consultar los organos gestores y unidades tramitadoras existentesen el sistema.
4.6.1 Peticin[code xml]
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
23
-
4.6.2 RespuestaLa respuesta contiene todos los organos gestores, unidades tramitadoras y oficinas conta-bles del sistema, agrupados en nodos de tres elementos (unidad tramitadora, organo ges-tor y oficina contable relacionados)
[code xml]
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
__CODIGO_DIR__
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
24
-
__NOMBRE_UNIDAD_DIR__
.............
4.6.2.1 ValoresPara cada relacin organo gestor - unidad tramitadora encontraremos la siguiente infor-macin:
Nombre Descripcion
organoGestor (codigo_dir) Cdigo de la unidad dir asociada al organo gestor
organoGestor (nombre) Nombre de la unidad dir asociada al organo gestor
unidadTramitadora
(codigo_dir)
Cdigo de la unidad dir asociada a la unidad
tramitadora
unidadTramitadora
(nombre)
Nombre de la unidad dir asociada a la unidad
tramitadora
oficinaContable (codigo_dir) Cdigo de la unidad dir asociada a la oficina contable
oficinaContable (nombre) Nombre de la unidad dir asociada a la oficina
contable
4.7 Consultar Listado FacturasEste servicio permite consultar el estado de varias factura.
4.7.1 Peticin[code xml]
-
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:web="https://webservice.face.gob.es">
_CODIGO_REGISTRO_
_CODIGO_REGISTRO_
_CODIGO_REGISTRO_
4.7.1.1 ValoresParametro Descripcin
listado_facturas Cdigos de registro en el REC, identificador nico de la factura
dentro de la plataforma
Esta peticion buscar las factura con el cdigo de registro indicado. Se puede solicitar unmximo de 500 facturas por peticin.
4.7.2 RespuestaLa respuesta contiene informacin sobre el estado de la factura:
[code xml]
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
26
-
_NUMERO_REGISTRO
_CODIGO_ESTADO_
_DESCRIPCION_CAMBIO_ESTADO_
_CODIGO_ESTADO_ANULACION_
_DESCRIPCION_CAMBIO_ESTADO_ANULACION_
.............
4.7.2.1 ValoresParametro Descripcin
numero_registro Cdigo de registro en el REC, identificador nico de la factura
dentro de la plataforma
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
27
-
Parametro Descripcin
tramitacion Informacion del estado de tramitacin. Contiene los elementos
codigo_estado,descripcion_estado y motivo_estado
anulacion Informacion del estado de anulacin. Contiene los elementos
codigo_estado,descripcion_estado y motivo_estado
codigo_estado Cdigo del estado actual de la factura
descripcion_estado Descripcin del motivo del cambio de estado al actual
motivo_estado Comentario asociado al estado
4.8 Consultar AdministracionesEste servicio permite consultar las Administraciones
4.8.1 Peticin[code xml]
4.8.2 RespuestaLa respuesta contiene un listado de las Administraciones
[code xml]
SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/
encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://webservice.face.gob.es"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
28
-
2001/XMLSchema-instance" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/
addressing">
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
.............
4.8.2.1 ValoresParametro Descripcin
codigo_dir Cdigo de la unidad dir asociada
nombre_unidad_dir Nombre de la unidad dir asociada
4.9 Consultar Unidades Por AdministracinEste servicio permite consultar los organos gestores, unidades tramitadoras y oficinascontables por administracin.
4.9.1 Peticin[code xml]
-
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:web="https://webservice.face.gob.es">
__CODIGO_DIR__
4.9.2 RespuestaLa respuesta contiene todos los organos gestores, unidades tramitadoras y oficinas conta-bles del sistema, agrupados en nodos de tres elementos (unidad tramitadora, organo ges-tor y oficina contable relacionados)
[code xml]
__CODIGO_DIR__
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
30
-
__NOMBRE_UNIDAD_DIR__
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
__CODIGO_DIR__
__NOMBRE_UNIDAD_DIR__
.............
4.9.2.1 ValoresPara cada relacin organo gestor - unidad tramitadora - oficina contable encontraremosla siguiente informacin:
Nombre Descripcion
organoGestor (codigo_dir) Cdigo de la unidad dir asociada al organo gestor
organoGestor (nombre) Nombre de la unidad dir asociada al organo gestor
unidadTramitadora
(codigo_dir)
Cdigo de la unidad dir asociada a la unidad
tramitadora
unidadTramitadora
(nombre)
Nombre de la unidad dir asociada a la unidad
tramitadora
Servicios para sistemas automatizados deproveedores
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
31
-
Nombre Descripcion
oficinaContable (codigo_dir) Cdigo de la unidad dir asociada a la oficina contable
oficinaContable (nombre) Nombre de la unidad dir asociada a la oficina
contable
Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.
Servicios para sistemas automatizados deproveedores
32
-
Apndice AFirma de los servicios web.Las peticiones tanto como las respuestas deben ir firmadas segn el estandar OASIS WS-Security 1.0 X509 Token Profile
http://en.wikipedia.org/wiki/WS-Security
http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0.pdf
La plataforma FACe delega sobre la plataforma @firma(http://administracionelectronica.gob.es/ctt/afirma) la validacin y la firma electrnicadigital de los servicios web, por lo que usted puede encontrar la documentacin completaen la misma.
A.1 Ejemplo de peticin firmadaA continuacin puede ver un ejemplo de peticin firmada, dentro del bloque "header" seincluye un bloque "security" que contiene todos los datos necesarios para la correcta vali-dacin de la firma.
[code xml]
-
ValueType="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-x509-token-profile-1.0#X509v3"
wsu:Id="CertId-5A5C126069B253F2B0135998798458616"
xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/
oasis-200401-wss-wssecurity-utility-1.0.xsd">MIIEpDCCBA2gAwIBAgIEPLPTKTANBgkqhkiG9w0BAQUFADA2MQswCQYDVQQGEwJFUzENMAsGA1UEChMERk5NVDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMB4XDTA5MDkyOTEyMTkxOVoXDTEzMDkyOTEyMTkxOVowggEdMQswCQYDVQQGEwJFUzENMAsGA1UEChMERk5NVDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMREwDwYDVQQLEwhQdWJsaWNvczESMBAGA1UECxMJNTAwMDcwMDE1MYG9MIG6BgNVBAMTgbJERVNDUklQQ0lPTiBGSVJNQSBFTEVDVFJPTklDQSBERSBMQSBBRE1JTklTVFJBQ0lPTiBQUkVTVVBVRVNUQVJJQSBDT04gU0VSVklDSU8gREUgU0VMTEFETyBERSBUSUVNUE8gLSBFTlRJREFEIElOVEVSVkVOQ0lPTiBHRU5FUkFMIERFIExBIEFETUlOSVNUUkFDSU9OIERFTCBFU1RBRE8gLSBDSUYgUzI4MjYwMTVGMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDEiBRtf4n2KSabqoldQbT2E+mF/
LS6PmAJWFoOUT3Xvp8UxYptb9/
YK93ykPj5NYLcsXeh8L9SRWbFSnozoiATZoECDnrcMd054DdPrNVYLTZNhZ9Y2U9JqJpnIWR+a64Mo3iiMk/
KBkI2jo3QIuaCjvPK+k6LQCwTIaRvnHGRxwIDAQABo4IB1DCCAdAwgdgGA1UdEQSB0DCBzaSByjCBxzEYMBYGCSsGAQQBrGYBDxMJUzI4MjYwMTVGMUMwQQYJKwYBBAGsZgEOEzRJTlRFUlZFTkNJT04gR0VORVJBTCBERSBMQSBBRE1JTklTVFJBQ0lPTiBERUwgRVNUQURPMWYwZAYJKwYBBAGsZgEIE1dGSVJNQSBFTEVDVFJPTklDQSBERSBMQSBBRE1JTklTVFJBQ0lPTiBQUkVTVVBVRVNUQVJJQSBDT04gU0VSVklDSU8gREUgU0VMTEFETyBERSBUSUVNUE8wCQYDVR0TBAIwADArBgNVHRAEJDAigA8yMDA5MDkyOTEyMTkxOVqBDzIwMTMwOTI5MTIxOTE5WjALBgNVHQ8EBAMCBaAwEQYJYIZIAYb4QgEBBAQDAgWgMB0GA1UdDgQWBBTStmUzGHncSmDG1JxoSVooTOfe5DAfBgNVHSMEGDAWgBRAmnZEl3QHxKwUyx6NTzpFfDDXYTBbBgNVHR8EVDBSMFCgTqBMpEowSDELMAkGA1UEBhMCRVMxDTALBgNVBAoTBEZOTVQxGDAWBgNVBAsTD0ZOTVQgQ2xhc2UgMiBDQTEQMA4GA1UEAxMHQ1JMNjMzMzANBgkqhkiG9w0BAQUFAAOBgQAqMsoZapJH6Ly9L0I1cW+XQWtn2oYNAcpzMJlpscqjNBtLuzPT4D6Jh42gmlOmS3cughRZuYx1mf+Gz8Sk4o9h7d/
Vc9fS1I6qgUkmwCZKHiwgJ4tS1Mv3gKMZ+8ulc8JErYo661ql3GVmLsfdH5g3eWyC5rBEcCjkHSKO0qDhzg==
vfoQe7yobzrB5LzQZ/
HD4B2F1BY=
HOZFzxAsMAH8BDbuXOHekl+yyLXfodmPka5727t3LDFSkbxICkL92wy6dSbWyU07zK/dhfLl2a4c
33FcvOxAtYAEvQVRLcQM3VU9+L2SX9NReQaGTPPmtBb8UAWeH5m56nM9uxT7yIwfO424+lNEYEeo
1pYC+0DBI6WcN4LRgV4=
Apndice A Firma de los servicios web. Servicios para sistemas automatizados de proveedores
34
-
2013-02-04T14:26:24.586Z
2013-02-04T14:31:24.586Z
A.2 Ejemplo de respuesta firmadaA continuacin puede ver un ejemplo de respuesta firmada, dentro del bloque "header" seincluye un bloque "security" que contiene todos los datos necesarios para la correcta vali-dacin de la firma.
[code xml]
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDmet1o2c2UZ0ZLddzNjcBFg2lVqTBcnMax4DrBdWAiIYXK6WHVRqB5Q+9TaCuvGMgEcxWuGF5B5vqVpKyxGhwAgC1i69B8Mz8YIinlqwMeJDs4gExFsH2JKxsLDK6DlAL3bClAAKUlW49cHZBtvDbmRRbXkDKRYNmKhzqWZy+KFQIDAQAB
Servicios para sistemas automatizados de proveedores Apndice A Firma de los servicios web.
35
-
eQhMOl9VLm+QJxT/rRyb/
a0FnBQ=
v9rfyqtFdbfiq6Usiw5illtvZpUYkBP6hg795YPKzJwoKqgKe6w9X+FIMb2CMl5WD0Xzt6igJlIAVkr4PP4eWBN6fmZGg8ejaXGzUTQwf/
iElUjgnFrmscq/8Wu/8L4nE4PaXq7XocwPJUJ44/rWr7C241jJSG/
UNPBcn61peSk=
Apndice A Firma de los servicios web. Servicios para sistemas automatizados de proveedores
36
-
Apndice BResumen de los estadosA continuacin aparece el resumen de los estados junto con su nombre, cdigo y descrip-cin.
El nombre se corresponde con el nombre del estado.
El cdigo de estado se corresponde con un identificador que permite diferenciar las co-municaciones de estados, entre diferentes plataformas independientemente de las deno-minaciones que pudieran tener internamente cada uno de ellos.
Se distinguen dos tipos de estados, para la tramitacin y para la anulacin.
B.1 Estados de tramitacinNombre Cdigo Descripcin
Registrada 1200 La factura ha sido registrada en el registro
electrnico REC
Registrada en RCF 1300 la factura ha sido registrada en el RCF
Contabilizada la obligacin
de pago
2400 La factura ha sido reconocida con obligacin
de pago
Pagada 2500 Factura pagada
Rechazada 2600 La Unidad rechaza la factura
Anulada 3100 La Unidad aprueba la propuesta de anulacin
37
-
B.2 Estados de anulacinNombre Cdigo Descripcin
No solicitada anulacin 4100 No solicitada anulacin
Solicitada anulacin 4200 Solicitada anulacin
Aceptada anulacin 4300 Aceptada anulacin
Solicitud de anulacin 4400 Rechazada anulacin
Apndice B Resumen de los estados Servicios para sistemas automatizados de proveedores
38
-
Apndice CDatos de pruebaPara facilitar el trabajo de integradores hemos puesto a su disposicin una factura deprueba que pueden utilizar durante su desarrollo.
Tenga en cuenta que esta factura es "especial" y que se omiten determinadas validaciones,que si se ejecutarn en las facturas generadas por usted.
Puede descargar la factura de prueba de la siguiente direccin.
(en breve se publicar la url)
39
-
Esta pgina se ha dejado vaca a propsito
40
-
Apndice DMimes admitidos por laaplicacionEste es el listado de mimes admitidos para ficheros anexos.
image/jpeg
image/png
application/pdf
application/msword
application/msword
application/zip
application/x-rar-compressed
text/plain
41
-
Esta pgina se ha dejado vaca a propsito
42
-
Apndice EIntegracin con WSDL en RPC/LiteralLos WSDLs estan en RPC/Encoded. Algunas metodologas no admiten esta codificacinpor considerarla antigua. Desde FACe hemos planteado presentar una interfaz en fase depruebas para aquellos que quieran realizar pruebas con RPC/Literal.
WSDL (https://se-face-webservice.redsara.es/sspp2?wsdl)
43
-
Esta pgina se ha dejado vaca a propsito
44
-
Apndice FIntegracin con validacin decertificado publico y policyAlgunas nuevas metodologas requieren la inclusion de ficheros policy en formato xml.
F.1 Policy[code xml]
45
-
Apndice F Integracin con validacin de certificado publicoy policy
Servicios para sistemas automatizados deproveedores
46
-
F.2 Clave publica del certificado en las respuestas SOAPEn este apartado mostramos las claves publicas de los certificados que firman las respues-tas de los SOAP.
F.2.1 Clave pblica para firma en los SOAP del entorno de STA-GING
-----BEGIN CERTIFICATE-----
MIIEHTCCA4agAwIBAgIEPRQCPjANBgkqhkiG9w0BAQUFADA2MQswCQYDVQQGEwJF
UzENMAsGA1UEChMERk5NVDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMB4XDTE0
MDUyMTEwNTM1MloXDTE2MDUyMTEwNTM1MlowgdgxCzAJBgNVBAYTAkVTMQ0wCwYD
VQQKEwRGTk1UMRgwFgYDVQQLEw9GTk1UIENsYXNlIDIgQ0ExETAPBgNVBAsTCFB1
YmxpY29zMRIwEAYDVQQLEwk1MDAwNzAwMTUxeTB3BgNVBAMUcERFU0NSSVBDSU9O
IFNHUEVJQUUgKFBSRVBST0RVQ0NJT04pIC0gRU5USURBRCBNSU5JU1RFUklPIERF
IEhBQ0lFTkRBIFkgQURNSU5JU1RSQUNJT05FUyBQ2kJMSUNBUyAtIENJRiBTMjgz
MzAwMkUwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAKfmWJTM4NBCf2RsEgSP
Mrg7xqXyObCzAHEV2scz1aUdQ8qX0By197NZdxNgJU5DQDRm5351dyB5WdGyO5f1
wryfi1XniikbxD85RN/sTE4YGwZsFPhJMZVkMi70uq4dAZcfa3bRYOavn4ftT2Dr
3Gc4tnuhp+FTQhMY+905F/odAgMBAAGjggGTMIIBjzCBlgYDVR0RBIGOMIGLpIGI
MIGFMRgwFgYJKwYBBAGsZgEPEwlTMjgzMzAwMkUxQTA/BgkrBgEEAaxmAQ4UMk1J
TklTVEVSSU8gREUgSEFDSUVOREEgWSBBRE1JTklTVFJBQ0lPTkVTIFDaQkxJQ0FT
MSYwJAYJKwYBBAGsZgEIExdTR1BFSUFFIChQUkVQUk9EVUNDSU9OKTAJBgNVHRME
AjAAMCsGA1UdEAQkMCKADzIwMTQwNTIxMTA1MzUyWoEPMjAxODA1MjExMDUzNTJa
MAsGA1UdDwQEAwIFoDARBglghkgBhvhCAQEEBAMCBaAwHQYDVR0OBBYEFHYCfUJB
X/422PEF+1CnlNzBmQ6AMB8GA1UdIwQYMBaAFECadkSXdAfErBTLHo1POkV8MNdh
MFwGA1UdHwRVMFMwUaBPoE2kSzBJMQswCQYDVQQGEwJFUzENMAsGA1UEChMERk5N
VDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMREwDwYDVQQDEwhDUkwxNDczNzAN
BgkqhkiG9w0BAQUFAAOBgQAbZEdG+q3wPfs29KYvgwcabHnmad3Quz5ZiDHv6XzH
RYJolxI6aX+N1riDUqn1WsCqSywAfKJSIY8GR7gIyydV7IbM0/xHdjZ+MM+FBI/c
yvkpEP5vO9v/IIIToosGsXZLTems4umYpB2HiHfC4tYbG/qxIIkTNmVkNBUIMrJ6
Xw==
-----END CERTIFICATE-----
F.2.2 Clave pblica para firma en los SOAP del entorno de PRO-DUCCION
-----BEGIN CERTIFICATE-----
MIID+TCCA2KgAwIBAgIEPRP+JzANBgkqhkiG9w0BAQUFADA2MQswCQYDVQQGEwJF
Servicios para sistemas automatizados deproveedores
Apndice F Integracin con validacin de certificado publicoy policy
47
-
UzENMAsGA1UEChMERk5NVDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMB4XDTE0
MDUyMTA5NDgwMloXDTE2MDUyMTA5NDgwMlowgcgxCzAJBgNVBAYTAkVTMQ0wCwYD
VQQKEwRGTk1UMRgwFgYDVQQLEw9GTk1UIENsYXNlIDIgQ0ExETAPBgNVBAsTCFB1
YmxpY29zMRIwEAYDVQQLEwk1MDAwNzAwMTUxaTBnBgNVBAMUYERFU0NSSVBDSU9O
IFNHUEVJQUUgLSBFTlRJREFEIE1JTklTVEVSSU8gREUgSEFDSUVOREEgWSBBRE1J
TklTVFJBQ0lPTkVTIFDaQkxJQ0FTIC0gQ0lGIFMyODMzMDAyRTCBnzANBgkqhkiG
9w0BAQEFAAOBjQAwgYkCgYEA3V4NOV4RR5cKS4j4qShp7+iWhYtjDDgQHzAV0nGL
eLFEW7Mt7rO2C1G9WWYVfxctkt1piwhntIbPsNlPVTVlxN4ElGzf/06kh6aa6rp0
jH/+kda4xg+h+yu37TZEIifEIaiiNkoq1nm04dqRBfjjUyiVfl3e9oEaT7iPwrnb
NncCAwEAAaOCAX8wggF7MIGCBgNVHREEezB5pHcwdTEYMBYGCSsGAQQBrGYBDxMJ
UzI4MzMwMDJFMUEwPwYJKwYBBAGsZgEOFDJNSU5JU1RFUklPIERFIEhBQ0lFTkRB
IFkgQURNSU5JU1RSQUNJT05FUyBQ2kJMSUNBUzEWMBQGCSsGAQQBrGYBCBMHU0dQ
RUlBRTAJBgNVHRMEAjAAMCsGA1UdEAQkMCKADzIwMTQwNTIxMDk0ODAyWoEPMjAx
ODA1MjEwOTQ4MDJaMAsGA1UdDwQEAwIFoDARBglghkgBhvhCAQEEBAMCBaAwHQYD
VR0OBBYEFBDIUynTs6NzMxjMKgc+Dbfdx+TsMB8GA1UdIwQYMBaAFECadkSXdAfE
rBTLHo1POkV8MNdhMFwGA1UdHwRVMFMwUaBPoE2kSzBJMQswCQYDVQQGEwJFUzEN
MAsGA1UEChMERk5NVDEYMBYGA1UECxMPRk5NVCBDbGFzZSAyIENBMREwDwYDVQQD
EwhDUkwxNDczNjANBgkqhkiG9w0BAQUFAAOBgQBGdF/8mmz7twNhEVUJofZ4tfWc
1JmZFAOa+DFCZsFyRpY2oPHsCqoysPWu/dwtZNrKmRVom18tfHKPvhcMmk2mK5sP
IPs7WAvWtZcawsN3UjZlzVF3WZvpdNeVOg1u6LyCHJ2MymnwYhZ+dfNWQi72vehl
QDSSH1UGtJj4biVm8A==
-----END CERTIFICATE-----
Apndice F Integracin con validacin de certificado publicoy policy
Servicios para sistemas automatizados deproveedores
48
Servicios para sistemas automatizados de proveedoresEquipo de desarrollo de FACe
ndice de contenidosCaptulo 1 Introduccin1.1 Historial de versiones del documento1.2 Objetivo de este documento1.3 Firma electrnica en los servicios web
Captulo 2 Alta de su sistema en la plataforma2.1 Certificado
Captulo 3 Formato de factura admitido por la plataforma FACeCaptulo 4 Definicin de los servicios para sistemas automatizados de proveedores.4.1 WSDL4.2 Enviar Factura4.2.1 Peticin4.2.1.1 Valores
4.2.2 Respuesta4.2.2.1 Valores
4.3 Consultar Factura4.3.1 Peticin4.3.1.1 Valores
4.3.2 Respuesta4.3.2.1 Valores
4.4 Anular Factura4.4.1 Peticin4.4.1.1 Valores
4.4.2 Respuesta4.4.2.1 Valores
4.5 Consultar Estados4.5.1 Peticin4.5.2 Respuesta4.5.2.1 Valores
4.6 Consultar Unidades4.6.1 Peticin4.6.2 Respuesta4.6.2.1 Valores
4.7 Consultar Listado Facturas4.7.1 Peticin4.7.1.1 Valores
4.7.2 Respuesta4.7.2.1 Valores
4.8 Consultar Administraciones4.8.1 Peticin4.8.2 Respuesta4.8.2.1 Valores
4.9 Consultar Unidades Por Administracin4.9.1 Peticin4.9.2 Respuesta4.9.2.1 Valores
Apndice A Firma de los servicios web.A.1 Ejemplo de peticin firmadaA.2 Ejemplo de respuesta firmada
Apndice B Resumen de los estadosB.1 Estados de tramitacinB.2 Estados de anulacin
Apndice C Datos de pruebaApndice D Mimes admitidos por la aplicacionApndice E Integracin con WSDL en RPC/LiteralApndice F Integracin con validacin de certificado publico y policyF.1 PolicyF.2 Clave publica del certificado en las respuestas SOAPF.2.1 Clave pblica para firma en los SOAP del entorno de STAGINGF.2.2 Clave pblica para firma en los SOAP del entorno de PRODUCCION