Interfaz WS FACe- Proveedores

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


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


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



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.



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_


anexo_1_

Captulo 4 Definicin de los servicios para sistemasautomatizados de proveedores.


14

_contenido en base_64

del fichero anexo_2_


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


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"



15

Ficheros Anexos: Los anexos son optativos, existe un maximo de 5 anexos.


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_



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_


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]



18

_NUMERO_REGISTRO

_CODIGO_ESTADO_

_DESCRIPCION_CAMBIO_ESTADO_

_CODIGO_ESTADO_ANULACION_

_DESCRIPCION_CAMBIO_ESTADO_ANULACION_




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 Cdigo del estado actual de la factura

descripcion_estado Descripcin del motivo del cambio de estado al actual



19


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_




motivo Descripcin del motivo por el que se hace la anulacin de la

factura



20

4.4.2 RespuestaLa respuesta contiene los datos ms representativos de la factura anulada:

[code xml]

_NUMERO_REGISTRO_

Anulacin solicitada

correctamente




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.



21


4.5.2 RespuestaLa respuesta contiene los datos ms representativos de los distintos estados por los quepuede pasar una factura.

[code xml]

Registrada

1100



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:


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.




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__


__CODIGO_DIR__



24


.............

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.




_CODIGO_REGISTRO_

_CODIGO_REGISTRO_

_CODIGO_REGISTRO_


listado_facturas Cdigos de registro en el REC, identificador nico de la factura


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]



26

_NUMERO_REGISTRO

_CODIGO_ESTADO_

_DESCRIPCION_CAMBIO_ESTADO_

_CODIGO_ESTADO_ANULACION_

_DESCRIPCION_CAMBIO_ESTADO_ANULACION_

.............






27


tramitacion Informacion del estado de tramitacin. Contiene los elementos


anulacion Informacion del estado de anulacin. Contiene los elementos


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.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/



28

2001/XMLSchema-instance" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/

addressing">

__CODIGO_DIR__


__CODIGO_DIR__


.............


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.


xmlns:xsd="http://www.w3.org/2001/XMLSchema"



__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__



30


__CODIGO_DIR__


__CODIGO_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



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



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


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


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


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


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


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==


F.2.2 Clave pblica para firma en los SOAP del entorno de PRO-DUCCION


MIID+TCCA2KgAwIBAgIEPRP+JzANBgkqhkiG9w0BAQUFADA2MQswCQYDVQQGEwJF



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==




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.4 Anular Factura4.4.1 Peticin4.4.1.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.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

Documents

Interfaz WS FACe- Proveedores