Table of Contents

maxLevel	3

Info
Se ha eliminado la versión 1 de los servicios.

Método addManualInvoice

Permite añadir una factura de forma manual

Expand

title	Más detalles...

Signatura

ResultAddManualInvoice addManualInvoice(ParamAddManualInvoice paramAddManualInvoice)

Parámetros de invocación

ParamAddManualInvoice extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceData	InvoiceERPWS	Contenido de la factura a añadir

Parámetros de respuesta

ResultAddManualInvoice extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
idFace	String	Id de la factura en FACe

Códigos error

Código	Descripción
IMPORT_INVOICE_210	Error de al recuperar parámetros
ADD_MANUAL_INVOICE_300	No se ha proporcionado el identificador CSV
ADD_MANUAL_INVOICE_301	No se ha proporcionado el tipo de factura
ADD_MANUAL_INVOICE_302	No se ha proporcionado el número de factura / El valor del campo InvoiceNumber es demasiado largo, solo se permite un máximo de 20 caracteres
ADD_MANUAL_INVOICE_303	No se ha proporcionado la fecha de misión de la factura
ADD_MANUAL_INVOICE_304	No se ha proporcionado el importe total de la factura
ADD_MANUAL_INVOICE_305	No se ha proporcionado la fecha de creación de la factura
ADD_MANUAL_INVOICE_306	No se ha proporcionado el estado de la factura en los parámetros
ADD_MANUAL_INVOICE_307	No se ha proporcionado el formato de la factura / El valor del campo Format no es válido, debería ser FACTURAE_3_2
ADD_MANUAL_INVOICE_308	No se ha proporcionado el código del organismo pagador de la factura
ADD_MANUAL_INVOICE_309	No se ha proporcionado la descripción del organismo pagador de la factura
ADD_MANUAL_INVOICE_310	No se ha proporcionado el código del organismo receptor de la factura
ADD_MANUAL_INVOICE_311	No se ha proporcionado la descripción del organismo receptor de la factura
ADD_MANUAL_INVOICE_314	No se ha proporcionado el CIF del pagador
ADD_MANUAL_INVOICE_315	No se ha proporcionado el nombre del pagador
ADD_MANUAL_INVOICE_316	No se ha proporcionado la dirección del pagador
ADD_MANUAL_INVOICE_317	No se ha proporcionado el código postal del pagador
ADD_MANUAL_INVOICE_318	No se ha proporcionado la localidad del pagador
ADD_MANUAL_INVOICE_319	No se ha proporcionado la provincia del pagador
ADD_MANUAL_INVOICE_320	No se ha proporcionado el cif del proveedor
ADD_MANUAL_INVOICE_321	No se ha proporcionado el nombre del proveedor
ADD_MANUAL_INVOICE_327	Falta el código RCF de la factura
ADD_MANUAL_INVOICE_328	No se ha proporcionado el código del país del pagador

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamAddManualInvoice paramAddManualInvoice = new ParamAddManualInvoice();
		
paramAddManualInvoice.setApplicationId("SFE");
InvoiceERPWS invoiceData = new InvoiceERPWS();
		
//Creamos un CSV
CSVGenerator generator = new CSVGenerator();
String csv = generator.generateCSV(PREFIJO_GENERAR_DOCUMENTO_CSV, PREFIJO_GENERAR_DOCUMENTO_CSV_BORRADOR);
		
//Generamos un nuevo numero de factura
Calendar cal = Calendar.getInstance();
String invoiceNumber = new StringBuffer(10).append(cal.get(Calendar.YEAR)).append("/").append(cal.getTimeInMillis()).toString();
		
//Generamos un nuevo RCFCode
String rcfCode = StringUtils.leftPad(String.valueOf(cal.getTimeInMillis()), 22, '0');
		
invoiceData.setBuyerCif("ESS5011001D");
invoiceData.setBuyerCorporateName("Comprador");
invoiceData.setBuyerAddress("algun lugar");
invoiceData.setBuyerPostCode("50001");
invoiceData.setBuyerTown("Zaragoza");
invoiceData.setBuyerProvince("Zaragoza");
invoiceData.setBuyerCountryCode("ES");
invoiceData.setCreationDate(new Date());
invoiceData.setCsv(csv);
invoiceData.setFormat("FACTURAE_3_2");
invoiceData.setInvoiceNumber(invoiceNumber);
invoiceData.setInvoiceTotal(1.1E1);
invoiceData.setInvoiceType("OO");
invoiceData.setIssueDate(new Date());
invoiceData.setPayerCentreCode("A02003512");
invoiceData.setPayerCentreDescription("ORGANO GESTOR");
invoiceData.setReceiverCentreCode("A02003512");
invoiceData.setReceiverCentreDescription("UNIDAD TRAMITADORA");
invoiceData.setSellerAddress("PEDRO CERBUNA 12");
invoiceData.setSellerCif("73085512E");
invoiceData.setSellerCorporateName("MECÁMEDIC ESPAÑA SL");
invoiceData.setTotalGrossAmount(new Double(0));
invoiceData.setRegisterDate(new Date());
invoiceData.setDocumentType("INVOICE");
invoiceData.setRcfCode(rcfCode);
		
paramAddManualInvoice.setInvoiceData(invoiceData);
		
// Lanzamos la llamada
ResultAddManualInvoice resultAddManualInvoice = invoiceServiceImpl.addManualInvoice(paramAddManualInvoice);

Método getAllStates

Obtiene los datos idFace, stateFace, stateSFE, dir3Face y dir3SFE de cada factura introducida.

Expand

title	Más detalles...

Signatura

ResultGetAllStates getAllStates(ParamGetAllStates paramGetAllStates)

Parámetros de invocación

ParamGetAllStates extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
idsFace	String[]	Array con los Ids de las facturas en FACe

Parámetros de respuesta

ResultGetAllStates extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
idFace	String	Id de la factura en FACe
stateFace	String	Estado de la factura en FACe
stateSFE	String	Estado de la factura en SFE
oficinaContableFace	String	Oficina contable FACe
oficinaContableSFE	String	Oficina contable SFE
organoGestorFace	String	Órgano gestor FACe
organoGestorSFE	String	Órgano gestor SFE
unidadTramitadoraFace	String	Unidad Tramitadora en FACe
unidadTramitadoraSFE	String	Unidad Tramitadora en SFE
motivo	String	Motivo del estado en FACe

Códigos error

Código	Descripción
GET_ALL_STATES_001	Error al consultar id en SFE
GET_ALL_STATES_002	Error al consultar id en FACe
GET_ALL_STATES_100	La aplicación no está autorizada para utilizar el método
GET_ALL_STATES_110	No se ha podido conectar con FACe
GET_ALL_STATES_120	Error al conectar con BBDD

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
String[] idsFace = new String[] { "ID_FACE_1", "ID_FACE_2", "ID_FACE_N" };
ParamGetAllStates paramGetAllStates = new ParamGetAllStates(idsFace);
paramGetAllStates.setApplicationId("SFE");
paramGetAllStates.setOrganismCode("ORGXXXXX");
paramGetAllStates.setNif("00000000T");

// Lanzamos la llamada
ResultGetAllStates invoiceServiceImpl.getAllStates(paramGetAllStates);

Método getInvoiceByIdFace

Obtiene los datos idFace, csv, invoiceNumbre, invoiceTotal, rfcCode, receiverCentreCode, registerDate, seleerCorporateName, state de una factura

Expand

title	Más detalles...

Signatura

ResultGetInvoice getInvoiceByIdFace(ParamGetInvoice paramGetInvoiceByIdFace )

Parámetros de invocación

ParamGetInvoice extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
idFace	String	Id de la factura en FACe

Parámetros de respuesta

ResultGetInvoice extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
idFace	String	Id de la factura en FACe
csv	String	Código csv de la factura en SFE
invoiceNumber	String	Número de la factura
invoiceTotal	String	Importe total dela factura
rcfCode	String	Código rcf
receiverCentreCode	String	Código del centro receptor
registerDate	String	Fecha de registro
sellerCorporateName	String	Nombre del emisor
state	String	Estado de la factura en SFE

Códigos error

Código	Descripción
SEARCH_INVOICES_202	No se han proporcionado los parámetros de búsqueda
SEARCH_INVOICES_300	No se ha proporcionado el idFace de la factura

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
String idFace = "ID_FACE_1";
ParamGetInvoice paramGetInvoice = new ParamGetInvoice (idFace );
paramGetInvoice.setApplicationId("SFE");
paramGetInvoice.setOrganismCode("ORGXXXXX");
paramGetInvoice.setNif("00000000T");


// Lanzamos la llamada
ResultGetInvoice invoiceServiceImpl.getInvoiceByIdFace(paramGetInvoice);

Método importInvoice

Da de alta una factura en el sistema, almacenándola físicamente (DataHandler) y lógicamente (metadatos de facturación). Si lleva adjuntos, se almacenan también los adjuntos, física y lógicamente.

Expand

title	Más detalles...

Signatura

ResultImportInvoice importInvoice(ParamImportInvoice paramImportInvoice)

Parámetros de invocación

ParamImportInvoice extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceData	DataHandler	Contenido de la factura a importar
format	String	Formato de la factura
expedient	String	Número de expediente en el que se incluye la factura
attachmentsData	DataHandler	Contenido de los adjuntos a importar

Parámetros de respuesta

ResultImportInvoice extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoice	SFE v3.11.0 - Manual de integración#InvoiceWS	Metadatos de la factura importada
attachmentList	List<SFE v3.11.0 - Manual de integración#AttachmentWS>	Lista de metadatos de los adjuntos importados
invoiceValidationErrorList	List<SFE v3.11.0 - Manual de integración#InvoiceValidationError>	Lista con los errores de validación

InvoiceWS extends SFE v3.11.0 - Manual de integración#DocumentWS

Anchor

	InvoiceWS
	InvoiceWS

Nombre

Tipo

Descripción

registerDate

Date

Fecha de registro

receiptCSV

String

Identificador CSV del justificante de SRT

receiptSignOID

String

Identificador OID de Papiro de la firma del justificante de SRT

invoiceNoElect

String

DocumentWS

Anchor

	DocumentWS
	DocumentWS

Nombre

Tipo

Descripción

csv

String

CSV de la factura

sellerCif

String

CIF del proveedor

buyerCif

String

CIF del pagador

sellerCorporateName

String

Nombre corporativo del proveedor

buyerCorporateName

String

Nombre corporativo del pagador

sellerAddress

String

Dirección del proveedor

sellerPostCode

String

Código postal del proveedor

sellerTown

String

Población del proveedor

sellerProvince

String

Provincia del proveedor

sellerCountryCode

String

Código del país del proveedor

buyerAddress

String

Dirección del pagador

buyerPostCode

String

Código postal del pagador

buyerTown

String

Población del pagador

buyerProvince

String

Provincia del pagador

buyerCountryCode

String

Código del país del pagador

sellerTradeName

String

Nombre comercial del proveedor

buyerTradeName

String

Nombre comercial del pagador

invoiceType

String

Tipo de factura

invoiceNumber

String

Número de factura

invoiceSerialCode

String

Código de serie de la factura

correctiveReasonCode

String

Código de la razón de la corrección

correctiveReasonDescription

String

Descripción de la razón de la corrección

issueDate

Date

Fecha de emisión

operationDate

Date

Fecha de operación

invoicingPeriodStartDate

Date

Fecha de comienzo del periodo de servicio

invoicingPeriodEndDate

Date

Fecha de fin del periodo de servicio

creationDate

Date

Fecha de creación de la factura

totalGrossAmount

Double

Total importe bruto

invoiceTotal

Double

Importe total de la factura

sellerContactMail

String

Correo electrónico del proveedor

sellerContactPhone

String

Teléfono del proveedor

sellerContactPerson

String

Persona de contacto del proveedor

buyerContactMail

String

Correo electrónico del pagador

buyerContactPhone

String

Teléfono del proveedor

buyerContactPerson

String

Persona de contacto del pagador

state

String

Estado de la factura

format

String

Formato de la factura

correctedDraftNumber

String

Teléfono del proveedor

expedient

String

Expediente de la factura

correctedInvoiceNumber

String

Código del número de la corrección

additionalInformation

String

Información adicional

receiverCentreCode

String

Código del centro del receptor

receiverCentreDescription

String

Descripción del centro del receptor

payerCentreCode

String

Código del centro del pagador

payerCentreDescription

String

Nombre del centro del pagador

AttachmentWS

Anchor

	AttachmentWS
	AttachmentWS

Nombre

Tipo

Descripción

attachmentCsv

String

Identificador del adjunto

invoiceCsv

String

Identificador del documento al que se adjunta

creationDate

Date

Fecha en que se ha adjuntado el fichero

title

String

Título del fichero

description

String

Descripción del fichero

type

String

Tipo del fichero

InvoiceValidationError

Anchor

	InvoiceValidationError
	InvoiceValidationError

Nombre

Tipo

Descripción

errorCode

String

Código del error producido

errorMessage

String

Mensaje del error producido

Códigos error

Código	Descripción
IMPORT_INVOICE_000	Error al guardar los metadatos de la factura
IMPORT_INVOICE_100	Error al insertar en Documentum
IMPORT_INVOICE_101	Imposible guardar el estado de la factura
IMPORT_INVOICE_102	El proceso de verificación de firma no se ha realizado correctamente
IMPORT_INVOICE_103	Error al generar el HTML de la factura
IMPORT_INVOICE_110	Error de al insertar en Registro telemático
IMPORT_INVOICE_111	Error de comunicación con Registro telemático
IMPORT_INVOICE_112	Error al leer la factura para insertar en Registro telemático
IMPORT_INVOICE_113	Error al guardar el justificante de Registro Telemático
IMPORT_INVOICE_114	Error al obtener el justificante de registro
IMPORT_INVOICE_120	No existe fichero de metadatos en el ZIP de adjuntos
IMPORT_INVOICE_121	No se han proporcionado elementos Attachment en el fichero de metadatos
IMPORT_INVOICE_122	No se ha proporcionado el nombre del adjunto
IMPORT_INVOICE_123	No se ha proporcionado la descripción del adjunto
IMPORT_INVOICE_124	No se ha proporcionado el MIME-type del adjunto
IMPORT_INVOICE_125	Existe una entrada repetida en el fichero de metadatos
IMPORT_INVOICE_126	Error al leer el fichero de metadatos
IMPORT_INVOICE_127	No existen metadatos para una entrada del archivo ZIP
IMPORT_INVOICE_128	Existen metadatos sin entrada dentro del archivo ZIP
IMPORT_INVOICE_129	Error de E/S al manipular el zip de adjuntos
IMPORT_INVOICE_130	Error al guardar los metadatos del adjunto
IMPORT_INVOICE_131	Error al guardar el adjunto
IMPORT_INVOICE_132	El nombre del adjunto excede de la longitud máxima
IMPORT_INVOICE_133	La descripción del adjunto excede de la longitud máxima
IMPORT_INVOICE_134	El MIME-type del adjunto excede de la longitud máxima
IMPORT_INVOICE_150	Error al leer la factura para crear los parámetros de validación del ERP
IMPORT_INVOICE_151	Error al evaluar la expresión XPATH para crear los parámetros de validación del ERP
IMPORT_INVOICE_152	Error al consumir el servicio validateOBSY de SERPA
IMPORT_INVOICE_200	Error al leer la factura
IMPORT_INVOICE_201	Error al obtener el validador de la factura
IMPORT_INVOICE_202	La factura no cumple con el formato especificado
IMPORT_INVOICE_203	Error al realizar el unmarshal de la factura
IMPORT_INVOICE_204	Se han detectado errores en la validación en SERPA
IMPORT_INVOICE_205	Se han detectado errores en la validación
IMPORT_INVOICE_206	Error al buscar el organismo responsable
IMPORT_INVOICE_207	Error al buscar el usuario responsable
IMPORT_INVOICE_208	El XML con la factura no está codificado en UTF-8
IMPORT_INVOICE_209	Error de E/S al comprobar la codificación de la factura
IMPORT_INVOICE_210	Error de al recuperar parámetros
IMPORT_INVOICE_211	Error al preparar la validación contable
IMPORT_INVOICE_300	No se ha proporcionado el formato de la factura en los parámetros
IMPORT_INVOICE_301	No se ha proporcionado un formato de factura válido
IMPORT_INVOICE_302	No se ha proporcionado una factura en los parámetros
IMPORT_INVOICE_400	No se permite importar facturas en las que no actúe como emisor
IMPORT_INVOICE_401	Error al buscar el CIF del organismo
IMPORT_INVOICE_405	El expediente no cumple con el formato requerido
IMPORT_INVOICE_406	La factura es rectificativa y no está permitido que lo sea
VALIDATION_04	No existe una única factura en el documento
VALIDATION_05	El emisor es de tipo Persona Física y sólo se permite Persona Jurídica
VALIDATION_06	No se proporcionan los datos de contacto del emisor
VALIDATION_07	Se debe proporcionar la persona de contacto del emisor
VALIDATION_08	Se debe proporcionar el teléfono del emisor
VALIDATION_09	Se debe proporcionar el email del emisor
VALIDATION_10	El receptor es de tipo Persona Física y sólo se permite Persona Jurídica
VALIDATION_11	Se requieren dos centros administrativos en el receptor
VALIDATION_12	Es obligatorio que el centro administrativo tenga rol
VALIDATION_13	Es obligatorio que el centro administrativo tenga código
VALIDATION_14	Es obligatorio que el centro administrativo tenga nombre
VALIDATION_15	El código del centro receptor no se corresponde con el CIF del receptor
VALIDATION_16	El código del centro receptor no se corresponde con ningún organismo
VALIDATION_17	El código del centro pagador no se corresponde con el CIF del receptor
VALIDATION_18	El código del centro pagador no se corresponde con ningún organismo
VALIDATION_19	Se requiere un centro administrativo con rol Receptor
VALIDATION_20	Se requiere un centro administrativo con rol Pagador
VALIDATION_21	Se debe proporcionar el número de factura
VALIDATION_22	La cuenta del vencimiento no tiene IBAN
VALIDATION_23	El IBAN de la cuenta no es correcto
VALIDATION_25	No hay información del albarán en la línea
VALIDATION_26	No hay número de albarán en la línea
VALIDATION_27	No hay fecha de albarán en la línea
VALIDATION_28	No hay dirección de envío de la mercancía en la línea
VALIDATION_29	No hay concepto en la línea
VALIDATION_30	Es obligatorio indicar la cuota del impuesto en la línea
VALIDATION_32	El borrador/factura es rectificativo/a y no está permitido que lo sea
VALIDATION_33	Mensaje particular para cada error distinto en la propia validación contable
VALIDATION_34	La forma de pago del vencimiento del endoso debe ser Transferencia
VALIDATION_35	La cuenta del endoso no tiene IBAN
VALIDATION_36	El IBAN de la cuenta del endoso no es correcto
VALIDATION_37	No se permiten líneas con importes negativos y positivos, han de ser todos positivos o todos negativos
VALIDATION_38	Solo se permite un único vencimiento por endosatario

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamImportInvoice paramImportInvoice = new ParamImportInvoice();
paramImportInvoice.setApplicationId("SFE");
paramImportInvoice.setFormat("FACTURAE_3_2");
paramImportInvoice.setInvoiceData(new DataHandler(new FileDataSource("PATH_XML_FACTURA")));

// Lanzamos la llamada
ResultImportInvoice resultImportInvoice = invoiceServiceImpl.importInvoice(paramImportInvoice);

Método searchInvoices

Busca facturas en el sistema, según un criterio de búsqueda (metadatos de facturación).

Expand

title	Más detalles...

Signatura

ResultSearchInvoices searchInvoices(ParamSearchInvoices paramSearchInvoice)

Parámetros de invocación

ParamSearchInvoices extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
searchInvoice	SFE v3.11.0 - Manual de integración#SearchInvoiceWS	Criterios de búsqueda de facturas
isIssuer	boolean	Indica si es emisor o receptor

SearchInvoiceWS extends SFE v3.11.0 - Manual de integración#InvoiceWS

Anchor

	SearchInvoiceWS
	SearchInvoiceWS

Nombre

Tipo

Descripción

creationDateFrom

Date

Fecha de creación (desde)

creationDateTo

Date

Fecha de creación (hasta)

issueDateFrom

Date

Fecha de emisión (desde)

issueDateTo

Date

Fecha de emisión (hasta)

operationDateFrom

Date

Fecha de servicio (desde)

operationDateTo

Date

Fecha de servicio (hasta)

invoicingPeriodStartDateFrom

Date

Fecha de comienzo del periodo de facturación (desde)

invoicingPeriodStartDateTo

Date

Fecha de comienzo del período de facturación (hasta)

invoicingPeriodEndDateFrom

Date

Fecha de fin del período de facturación (desde)

invoicingPeriodEndDateTo

Date

Fecha de fin del período de facturación (hasta)

registerDateFrom

Date

Fecha de registro (desde)

registerDateTo

Date

Fecha de registro (hasta)

invoiceTotalFrom

Double

Total (desde)

invoiceTotalTo

Double

Total (hasta)

invoiceNoElect

String

params

SFE v3.11.0 - Manual de integración#SearchParamsWS

Otros parámetros de búsqueda (ordenación, paginación...)

SearchParamsWS

Anchor

	SearchParamsWS
	SearchParamsWS

Nombre

Tipo

Descripción

sortColumn

String

Ordenación de la columna

ascending

boolean

Es ascendente

fromIndex

int

Índice (desde)

toIndex

int

Índice (hasta)

Parámetros de respuesta

ResultSearchInvoices extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoiceList	List<SFE v3.11.0 - Manual de integración#InvoiceWS>	Lista de metadatos de las facturas
size	Integer	Número de facturas que cumplen los criterios de búsqueda

Códigos error

Código	Descripción
SEARCH_INVOICE_000	Error al buscar los metadatos de las facturas
SEARCH_INVOICE_200	No se ha encontrado ningún organismo padre con CIF
SEARCH_INVOICE_201	No se ha podido recuperar el organismo
SEARCH_INVOICE_202	No se ha podido recuperar los parámetros
SEARCH_INVOICE_300	No se han proporcionado los parámetros de búsqueda
SEARCH_INVOICE_400	Error al buscar el CIF del organismo
SEARCH_INVOICE_401	No se permite buscar facturas emitidas en las que no actúe como emisor
SEARCH_INVOICE_402	No se permite buscar facturas recibidas en las que no actúe como receptor
SEARCH_INVOICE_403	Error al obtener el ámbito de visibilidad del organismo
SEARCH_INVOICE_404	No se permite buscar facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
SEARCH_INVOICE_405	No se permite buscar facturas recibidas indicando un código del organismo pagador, que no coincida con el código de organismo del primer organismo que posee cif en el árbol ascendente del organismo asociado al usuario
SEARCH_INVOICE_406	Error al obtener el código de organismo del primer padre con CIF del organismo
SEARCH_INVOICE_407	No se permite buscar facturas con el estado especificado

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSearchInvoices paramSearchInvoices = new ParamSearchInvoices();
paramSearchInvoices.setApplicationId("SFE");
// paramSearchInvoices.setCif("A01274927");
paramSearchInvoices.setSearchInvoice(new SearchInvoiceWS());

// Lanzamos la llamada
ResultSearchInvoices resultSearchInvoicess = invoiceServiceImpl.searchInvoices(paramSearchInvoices);

Método searchInvoicesFromCSV

Expand

Signatura

ResultSearchInvoicesFromCSV searchInvoices(ParamSearchInvoicesFromCSV paramSearchInvoicesFromCSV)

Parámetros de invocación

ParamSearchInvoicesFromCSV extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
searchInvoiceFromCSV	SearchInvoiceFromCSVWS	Criterios de búsqueda de facturas
isIssuer	boolean	Indica si es emisor o receptor

SearchInvoiceFromCSVWS extends SFE v3.11.0 - Manual de integración#InvoiceWS

Anchor

	SearchInvoiceFromCSVWS
	SearchInvoiceFromCSVWS

Nombre

Tipo

Descripción

invoiceCSVList

List<String>

Lista de Strings con los csv para la búsqueda

params

SFE v3.11.0 - Manual de integración#SearchParamsWS

Otros parámetros de búsqueda (ordenación, paginación...)

SearchParamsWS

Anchor

	SearchParamsWS
	SearchParamsWS

Nombre

Tipo

Descripción

sortColumn

String

Ordenación de la columna

ascending

boolean

Es ascendente

fromIndex

int

Índice (desde)

toIndex

int

Índice (hasta)

ResultSearchInvoicesFromCSV extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoiceList	List<SFE v3.11.0 - Manual de integración#InvoiceWS>	Lista de metadatos de las facturas
size	Integer	Número de facturas que cumplen los criterios de búsqueda

Códigos error

Código	Descripción
SEARCH_INVOICE_000	Error al buscar los metadatos de las facturas
SEARCH_INVOICE_200	No se ha encontrado ningún organismo padre con CIF
SEARCH_INVOICE_201	No se ha podido recuperar el organismo
SEARCH_INVOICE_202	No se ha podido recuperar los parámetros
SEARCH_INVOICE_300	No se han proporcionado los parámetros de búsqueda
SEARCH_INVOICE_400	Error al buscar el CIF del organismo
SEARCH_INVOICE_401	No se permite buscar facturas emitidas en las que no actúe como emisor
SEARCH_INVOICE_402	No se permite buscar facturas recibidas en las que no actúe como receptor
SEARCH_INVOICE_403	Error al obtener el ámbito de visibilidad del organismo
SEARCH_INVOICE_404	No se permite buscar facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
SEARCH_INVOICE_405	No se permite buscar facturas recibidas indicando un código del organismo pagador, que no coincida con el código de organismo del primer organismo que posee cif en el árbol ascendente del organismo asociado al usuario
SEARCH_INVOICE_406	Error al obtener el código de organismo del primer padre con CIF del organismo
SEARCH_INVOICE_407	No se permite buscar facturas con el estado especificado
SEARCH_INVOICES_408	No se permite la búsqueda de facturas de empresas que no son su gestora.
SEARCH_INVOICES_409	Error al buscar la empresa y gestora por su NIF

Ejemplo de invocación

Code Block

language	java

// Rellenamos los parametros
ParamSearchInvoicesFromCSV paramSearchInvoicesFromCSV = new ParamSearchInvoicesFromCSV();
paramSearchInvoicesFromCSV.setApplicationId("SFE");
// paramSearchInvoicesFromCSV.setCif("A01274927");
paramSearchInvoicesFromCSV.setSearchInvoice(new SearchInvoiceWS());

// Lanzamos la llamada
ResultSearchInvoicesFromCSV ResultSearchInvoicesFromCSV = invoiceServiceImpl.searchInvoicesFromCSV(paramSearchInvoices);

Método downloadInvoice

Descarga los bytes (DataHandler) de la factura solicitada.

Expand

title	Más detalles...

Signatura

ResultDownloadInvoice downloadInvoice(ParamDownloadInvoice paramDownloadInvoice)

Parámetros de invocación

ParamDownloadInvoice extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV de la factura a descargar.
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadInvoice extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido de la factura

Códigos error

Código	Descripción
DOWNLOAD_INVOICE_100	Error al obtener la factura desde Documentum
DOWNLOAD_INVOICE_200	No se ha podido recuperar el organismo
DOWNLOAD_INVOICE_201	No se ha podido recuperar los parámetros
DOWNLOAD_INVOICE_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_INVOICE_400	Error de BD al buscar la factura
DOWNLOAD_INVOICE_401	No existe ninguna factura con el identificado proporcionado
DOWNLOAD_INVOICE_402	No se permite descargar facturas emitidas en las que no actúe como emisor
DOWNLOAD_INVOICE_403	Error al buscar el CIF del organismo
DOWNLOAD_INVOICE_404	No se permite descargar facturas recibidas de un organismo con código de receptor que no pertenezca a su ámbito de visión
DOWNLOAD_INVOICE_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadInvoice paramDownloadInvoice = new ParamDownloadInvoice("INVOICE_CSV", true);

// Lanzamos la llamada
ResultDownloadInvoice resultDownloadInvoice = invoiceServiceImpl.downloadInvoice(paramDownloadInvoice);

Método historicalStates

Obtiene el histórico de estados por los que ha pasado la factura desde su incorporación al sistema.

Expand

title	Más detalles...

Signatura

ResultHistoricalStates historicalStates(ParamHistoricalStates paramHistoricalStates)

Parámetros de invocación

ParamHistoricalStates extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV de la factura a descargar.
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultHistoricalStates extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
stateList	List<SFE v3.11.0 - Manual de integración#InvoiceStateWS>	Lista con los metadatos de los cambios de estado
size	Integer	Tamaño de la lista

Códigos error

Código	Descripción
HISTORICAL_STATES_000	Error de BD al buscar los estados de la factura
HISTORICAL_STATES_200	No se ha podido recuperar el organismo
HISTORICAL_STATES_201	No se ha podido recuperar los parámetros
HISTORICAL_STATES_300	No se ha proporcionado un identificador CSV en los parámetros
HISTORICAL_STATES_400	Error de BD al buscar la factura
HISTORICAL_STATES_401	No existe ninguna factura con el identificador proporcionado
HISTORICAL_STATES_402	No se permite comprobar el histórico de estados de facturas emitidas en las que no actúe como emisor
HISTORICAL_STATES_403	Error al buscar el CIF del organismo
HISTORICAL_STATES_404	No se permite comprobar el histórico de estados de facturas recibidas de un organismo con código de receptor que no pertenezca a su ámbito de visión
HISTORICAL_STATES_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamHistoricalStates paramHistoricalStates = new ParamHistoricalStates("INVOICE_CSV", true);

// Lanzamos la llamada
ResultHistoricalStates resultHistoricalStates = invoiceServiceImpl.historicalStates(paramHistoricalStates);

Método changeState

Cambia de estado la factura indicada

Expand

title	Más detalles...

Signatura

ResultChangeState changeState(ParamChangeState paramChangeState)

Parámetros de invocación

ParamChangeState extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceCsv	String	Identificador CSV de la factura
newState	String	Nuevo estado de la factura
changeStateReason	String	Motivo del cambio

Parámetros de respuesta

ResultHistoricalStates extends SFE v3.11.0 - Manual de integración#ResultError
No hay variables

Códigos error

Código	Descripción
CHANGE_STATE_000	Error de BD al buscar la factura. Error de BD al cambiar el estado de la factura.
CHANGE_STATE_200	No se ha podido recuperar el organismo
CHANGE_STATE_201	Error al buscar el usuario responsable
CHANGE_STATE_300	No se ha proporcionado un identificador CSV en los parámetros
CHANGE_STATE_301	No se ha proporcionado el nuevo estado en los parámetros
CHANGE_STATE_302	No se ha proporcionado el motivo del cambio de estado en los parámetros
CHANGE_STATE_303	No se ha proporcionado los parámetros
CHANGE_STATE_400	Error de BD al buscar la factura
CHANGE_STATE_401	No existe ninguna factura con el identificador proporcionado
CHANGE_STATE_402	No se permite el cambio del estado actual al nuevo estado especificado
CHANGE_STATE_403	No se permite que la aplicación invocante cambie el estado especificado
CHANGE_STATE_404	No se permite cambiar el estado de facturas recibidas de un organismo con código de receptor que no pertenezca a su ámbito de visión
CHANGE_STATE_405	Error al buscar los organismos en el ámbito de actuación
CHANGE_STATE_500	Error al consumir el servicio returnStatus de SERPA
CHANGE_STATE_501	Error, no coincide el código de estado pasado al changeState con el código de estado recuperado del returnStatus de SERPA

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamChangeState paramChangeState = new ParamChangeState();
paramChangeState.setApplicationId("SOA");
paramChangeState.setNewState("31");
paramChangeState.setInvoiceCsv("INVOICE_CSV");
paramChangeState.setChangeStateReason("Cambio de estados");
paramChangeState.setCif("A01274927");

// Lanzamos la llamada
ResultChangeState resultChangeState = invoiceServiceImpl.changeState(paramChangeState);

Método downloadAttachment

Descarga un adjunto a partir de su identificador único (csv).

Expand

title	Más detalles...

Signatura

ResultDownloadAttachment downloadAttachment(ParamDownloadAttachment paramDownloadAttachment)

Parámetros de invocación

ParamDownloadAttachment extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
attachmentCsv	String	Identificador CSV del adjunto a descargar
invoiceCsv	String	Identificador CSV de la factura
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadAttachment extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido del adjunto

Códigos error

Código	Descripción
DOWNLOAD_ATTACHMENT_100	Error al descargar el adjunto de Documentum
DOWNLOAD_ATTACHMENT_200	No se ha podido recuperar el organismo
DOWNLOAD_ATTACHMENT_201	No se ha podido recuperar los parámetros
DOWNLOAD_ATTACHMENT_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_ATTACHMENT_400	Error de BD al buscar el adjunto
DOWNLOAD_ATTACHMENT_401	No existe ningún adjunto con el identificador proporcionado
DOWNLOAD_ATTACHMENT_402	Error de BD al buscar la factura
DOWNLOAD_ATTACHMENT_403	No existe la factura a la que hace referencia el adjunto
DOWNLOAD_ATTACHMENT_404	No se permite descargar adjuntos de facturas emitidas en las que no actúe como emisor
DOWNLOAD_ATTACHMENT_405	Error al buscar el CIF del organismo
DOWNLOAD_ATTACHMENT_406	No se permite descargar adjuntos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
DOWNLOAD_ATTACHMENT_407	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadAttachment paramDownloadAttachment = new ParamDownloadAttachment("ATT_CSV", true, "INV_CSV");

// Lanzamos la llamada
ResultDownloadAttachment resultDownloadAttachment = invoiceServiceImpl.downloadAttachment(paramDownloadAttachment);

Método downloadAttachments

Descarga los adjuntos a una factura a partir del identificador único de la misma (csv).

Expand

title	Más detalles...

Signatura

ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)

Parámetros de invocación

ParamDownloadAttachments extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
parentCsv	String	Identificador CSV de la factura de la que obtener sus adjuntos
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadAttachment extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	DataHandler con el contenido comprimido de los adjuntos de una factura

Códigos error

Código	Descripción
DOWNLOAD_ATTACHMENTS_000	Error de BD al buscar los adjuntos de la factura
DOWNLOAD_ATTACHMENTS_100	Error al descargar el adjunto de Documentum
DOWNLOAD_ATTACHMENTS_101	Error al crear el fichero comprimido con los adjuntos de la factura
DOWNLOAD_ATTACHMENTS_200	No se ha podido recuperar el organismo
DOWNLOAD_ATTACHMENTS_201	No se ha podido recuperar los parámetros
DOWNLOAD_ATTACHMENTS_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_ATTACHMENTS_400	Error de BD al buscar la factura
DOWNLOAD_ATTACHMENTS_401	No existe ninguna factura con el identificador proporcionado
DOWNLOAD_ATTACHMENTS_402	No se permite descargar adjuntos de facturas emitidas en las que no actúe como emisor
DOWNLOAD_ATTACHMENTS_403	Error al buscar el CIF del organismo
DOWNLOAD_ATTACHMENTS_404	No se permite descargar adjuntos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
DOWNLOAD_ATTACHMENTS_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadAttachments paramDownloadAttachments = new ParamDownloadAttachments("INVOICE_CSV", true);

// Lanzamos la llamada
ResultDownloadAttachments resultDownloadAttachments = invoiceServiceImpl.downloadAttachments(paramDownloadAttachments);

Método searchAttachments

Busca los adjuntos a una factura a partir del identificador único de la misma (csv).

Expand

title	Más detalles...

Signatura

ResultSearchAttachments searchAttachments(ParamSearchAttachments paramSearchAttachments)

Parámetros de invocación

ParamSearchAttachments extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
parentCsv	String	Identificador CSV de la factura de la que obtener sus adjuntos
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultSearchAttachments extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
attachmentList	List<SFE v3.11.0 - Manual de integración#AttachmentWS>	Lista de metadatos de los adjuntos

Códigos error

Código	Descripción
SEARCH_ATTACHMENTS_000	Error de BD al buscar los adjuntos de la factura
SEARCH_ATTACHMENTS_200	No se ha podido recuperar el organismo
SEARCH_ATTACHMENTS_201	No se ha podido recuperar los parámetros
SEARCH_ATTACHMENTS_300	No se ha proporcionado un identificador CSV en los parámetros
SEARCH_ATTACHMENTS_400	Error de BD al buscar la factura
SEARCH_ATTACHMENTS_401	No existe ninguna factura con el identificador proporcionado
SEARCH_ATTACHMENTS_402	No se permite buscar adjuntos de facturas emitidas en las que no actúe como emisor
SEARCH_ATTACHMENTS_403	Error al buscar el CIF del organismo
SEARCH_ATTACHMENTS_404	No se permite buscar adjuntos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
SEARCH_ATTACHMENTS_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSearchAttachments paramSearchAttachments = new ParamSearchAttachments("ATT_CSV", true);

// Lanzamos la llamada
ResultSearchAttachments resultSearchAttachments = invoiceServiceImpl.searchAttachments(paramSearchAttachments);

Método downloadRegisterReceipt

Descarga los bytes (DataHandler) del recibo de registro de la factura.

Expand

title	Más detalles...

Signatura

ResultDownloadRegisterReceipt downloadRegisterReceipt(ParamDownloadRegisterReceipt paramDownloadRegisterReceipt)

Parámetros de invocación

ParamDownloadRegisterReceipt extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceCsv	String	Identificador de la factura de la que obtener su justificante
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultSearchAttachments extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido del recibo de registro

Códigos error

Código	Descripción
DOWNLOAD_INVOICE_REGISTER_RECEIPT_100	Error al obtener el justificante de registro de la factura desde Documentum
DOWNLOAD_INVOICE_REGISTER_RECEIPT_200	No se ha podido recuperar el organismo
DOWNLOAD_INVOICE_REGISTER_RECEIPT_201	No se ha podido recuperar los parámetros
DOWNLOAD_INVOICE_REGISTER_RECEIPT_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_INVOICE_REGISTER_RECEIPT_400	Error de BD al buscar la factura
DOWNLOAD_INVOICE_REGISTER_RECEIPT_401	No existe ninguna factura con el identificador proporcionado
DOWNLOAD_INVOICE_REGISTER_RECEIPT_402	No se permite descargar el justificante de registro de facturas emitidas en las que no actúe como emisor
DOWNLOAD_INVOICE_REGISTER_RECEIPT_403	Error al buscar el CIF del organismo
DOWNLOAD_INVOICE_REGISTER_RECEIPT_404	No se permite buscar adjuntos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
DOWNLOAD_INVOICE_REGISTER_RECEIPT_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadRegisterReceipt paramDownloadRegisterReceipt = new ParamDownloadRegisterReceipt("INVOICE_CSV", true);

// Lanzamos la llamada
ResultDownloadRegisterReceipt resultDownloadRegisterReceipt = invoiceServiceImpl.downloadRegisterReceipt(paramDownloadRegisterReceipt);

Método downloadRegisterReceiptSign

Descarga los bytes (DataHandler) de la firma del recibo de registro de la factura.

Expand

title	Más detalles...

Signatura

ResultDownloadRegisterReceiptSign downloadRegisterReceiptSign(ParamDownloadRegisterReceiptSign paramDownloadRegisterReceiptSign)

Parámetros de invocación

ParamDownloadRegisterReceiptSign extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceCsv	String	Identificador de la factura de la que obtener la firma del justificante de registro
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadRegisterReceiptSign extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido de la firma del recibo de registro

Códigos error

Código	Descripción
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_100	Error al obtener el justificante de registro de la factura desde Documentum
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_200	No se ha podido recuperar el organismo
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_201	No se ha podido recuperar los parámetros
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_400	Error de BD al buscar la factura
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_401	No existe ninguna factura con el identificador proporcionado
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_402	No se permite descargar el justificante de registro de facturas emitidas en las que no actúe como emisor
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_403	Error al buscar el CIF del organismo
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_404	No se permite buscar adjuntos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
DOWNLOAD_INVOICE_REGISTER_RECEIPT_SIGN_405	Error al obtener el ámbito de visibilidad del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadRegisterReceiptSign paramDownloadRegisterReceiptSign = new ParamDownloadRegisterReceiptSign("INVOICE_CSV", true);

// Lanzamos la llamada
ResultDownloadRegisterReceiptSign resultDownloadRegisterReceiptSign = invoiceServiceImpl.downloadRegisterReceiptSign(paramDownloadRegisterReceiptSign);

Método updateInvoiceMetadata

Actualiza los metadatos de facturación de una factura en el sistema. Sólo se permiten actualizar metadatos que no están incluidos en el fichero con la factura.

Expand

title	Más detalles...

Signatura

ResultUpdateInvoiceMetadata updateInvoiceMetadata(ParamUpdateInvoiceMetadata paramUpdateInvoiceMetadata)

Parámetros de invocación

ParamUpdateInvoiceMetadata extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
invoiceCsv	String	Identificador CSV de la factura a actualizar
metadata	Map<String, String>	Metadatos actualizados
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadRegisterReceiptSign extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoice	SFE v3.11.0 - Manual de integración#DataHandler	Mtadatos de la factura

Códigos error

Código	Descripción
UPDATE_INVOICE_METADATA_000	Error de BD al actualizar la factura
UPDATE_INVOICE_METADATA_200	No se ha podido recuperar el organismo
UPDATE_INVOICE_METADATA_201	No se ha podido recuperar los parámetros
UPDATE_INVOICE_METADATA_300	No se ha proporcionado un identificador CSV en los parámetros
UPDATE_INVOICE_METADATA_301	No se han proporcionado los metadatos en los parámetros
UPDATE_INVOICE_METADATA_400	Se ha proporcionado una clave de metadatos inválida
UPDATE_INVOICE_METADATA_401	El expediente no cumple con el formato requerido
UPDATE_INVOICE_METADATA_402	Error de BD al buscar la factura
UPDATE_INVOICE_METADATA_403	No existe ninguna factura con el identificador proporcionado
UPDATE_INVOICE_METADATA_404	No se permite actualizar metadatos de facturas emitidas en las que no actúe como emisor
UPDATE_INVOICE_METADATA_405	Error al buscar el CIF del organismo
UPDATE_INVOICE_METADATA_406	No se permite actualizar metadatos de facturas recibidas indicando un código de organismo receptor que no pertenezca a su ámbito de visión
UPDATE_INVOICE_METADATA_407	Error al buscar el ámbito del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamUpdateInvoiceMetadata paramUpdateInvoiceMetadata = new ParamUpdateInvoiceMetadata();
paramUpdateInvoiceMetadata.setApplicationId("SFE");
paramUpdateInvoiceMetadata.setInvoiceCsv("INVOICE_CSV");
paramUpdateInvoiceMetadata.setIssuer(true);
Map<String, String> metadata = new HashMap<String, String>();
metadata.put(es.aragon.sfe.core.util.ConstantSfe.KEY_EXPEDIENT, "AAAAA12345678910111");
paramUpdateInvoiceMetadata.setMetadata(metadata);

// Lanzamos la llamada
ResultUpdateInvoiceMetadata resultUpdateInvoiceMetadata = invoiceServiceImpl.updateInvoiceMetadata(paramUpdateInvoiceMetadata);

Servicios de borradores de facturas

...

IDraftServicePortType

Info
Se ha eliminado la versión 1 de los servicios.

Método importDraft

Da de alta un borrador en el sistema, almacenándola físicamente (DataHandler) y lógicamente (metadatos de facturación). Si lleva adjuntos, se almacenan también los adjuntos, física y lógicamente.

Expand

title	Más detalles...

Signatura

ResultImportDraft importDraft(ParamImportDraft paramImportDraft)

Parámetros de invocación

ParamImportInvoice extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
draftData	DataHandler	Contenido del borrador a insertar
format	String	Formato de la factura
expedient	String	Número de expediente en el que se incluye la factura
attachmentsData	DataHandler	Contenido de los adjuntos a importar

Parámetros de respuesta

ResultImportInvoice extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoice	SFE v3.11.0 - Manual de integración#DraftWS	Metadatos del borrador importado
attachmentList	List<SFE v3.11.0 - Manual de integración#AttachmentWS>	Lista de metadatos de los adjuntos importados
invoiceValidationErrorList	List<SFE v3.11.0 - Manual de integración#InvoiceValidationError>	Lista con los errores de validación

DraftWS extends SFE v3.11.0 - Manual de integración#DocumentWS
No hay variables

Códigos error

Código	Descripción
IMPORT_DRAFT_000	Error al guardar los metadatos del borrador
IMPORT_DRAFT_100	Error al guardar el borrador
IMPORT_DRAFT_101	Error al guardar el estado del borrador
IMPORT_DRAFT_102	Error al eliminar el documento de CSV para restaurar el estado tras el error
IMPORT_DRAFT_103	Error al obtener el organismo raíz del organismo receptor de la factura
IMPORT_DRAFT_104	Error al obtener los datos del procedimiento asociado
IMPORT_DRAFT_105	No se ha podido recuperar el organismo
IMPORT_DRAFT_120	No existe fichero de metadatos en el ZIP de adjuntos
IMPORT_DRAFT_121	No se han proporcionado elementos Attachment en el fichero de metadatos
IMPORT_DRAFT_122	No se ha proporcionado el nombre del adjunto
IMPORT_DRAFT_123	No se ha proporcionado la descripción del adjunto
IMPORT_DRAFT_124	No se ha proporcionado el MIME-type del adjunto
IMPORT_DRAFT_125	Existe una entrada repetida en el fichero de metadatos
IMPORT_DRAFT_126	Error al leer el fichero de metadatos
IMPORT_DRAFT_127	No existen metadatos para una entrada del archivo ZIP
IMPORT_DRAFT_128	Existen metadatos sin entrada dentro del archivo ZIP
IMPORT_DRAFT_129	Error de E/S al manipular el zip de adjuntos
IMPORT_DRAFT_130	Error al guardar los metadatos del adjunto
IMPORT_DRAFT_131	Error al guardar el adjunto
IMPORT_DRAFT_132	El nombre del adjunto excede de la longitud máxima
IMPORT_DRAFT_133	La descripción del adjunto excede de la longitud máxima
IMPORT_DRAFT_134	El MIME-type del adjunto excede de la longitud máxima
IMPORT_DRAFT_200	Error al leer el borrador
IMPORT_DRAFT_201	Error al obtener el validador del borrador
IMPORT_DRAFT_202	El borrador no cumple con el formato especificado
IMPORT_DRAFT_203	Error al realizar el unmarshal del borrador
IMPORT_DRAFT_204	Se han detectado errores en la validación
IMPORT_DRAFT_205	Error al buscar el usuario responsable
IMPORT_DRAFT_206	El XML con el borrador no está codificado en UTF-8
IMPORT_DRAFT_207	Error de E/S al comprobar la codificación del borrador
IMPORT_DRAFT_208	Error al preparar la validación contable
IMPORT_DRAFT_300	No se ha proporcionado el formato del borrador en los parámetros
IMPORT_DRAFT_301	No se ha proporcionado un formato de borrador válido
IMPORT_DRAFT_302	No se ha proporcionado un borrador en los parámetros
IMPORT_DRAFT_303	No se ha proporcionado los parámetros
IMPORT_DRAFT_400	No se permite importar borradores en los que no actúe como emisor
IMPORT_DRAFT_401	Error al buscar el NIF del organismo
IMPORT_DRAFT_402	El borrador se encuentra firmado
IMPORT_DRAFT_406	El expediente no cumple con el formato requerido
IMPORT_DRAFT_407	El borrador es rectificativo y no está permitido que lo sea

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamImportDraft paramImportDraft = new ParamImportDraft();
paramImportDraft.setApplicationId("SFE");
paramImportDraft.setAttachmentsData(null);
paramImportDraft.setExpedient(null);
paramImportDraft.setFormat("FACTURAE_3_2");
paramImportDraft.setDraftData(new DataHandler(new FileDataSource("PATH_XML_BORRADOR")));

// Lanzamos la llamada
ResultImportDraft resultImportDraft = draftServiceImpl.importDraft(paramImportDraft);

Método updateDraft

Modifica un borrador existente en el sistema.

Expand

title	Más detalles...

Signatura

ResultUpdateDraft updateDraft(ParamUpdateDraft paramUpdateDraft)

Parámetros de invocación

ParamUpdateDraft extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
draftData	DataHandler	Contenido del borrador a insertar
csv	String	Identificador CSV del borrador a actualizar
format	String	Formato de la factura
expedient	String	Número de expediente en el que se incluye la factura

Parámetros de respuesta

ResultUpdateDraft extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
draft	SFE v3.11.0 - Manual de integración#DraftWS	Metadatos del borrador actualizado
invoiceValidationErrorList	List<SFE v3.11.0 - Manual de integración#InvoiceValidationError>	Lista con los errores de validación encontrados

Códigos error

Código	Descripción
UPDATE_DRAFT_000	Error al guardar los metadatos del borrador
UPDATE_DRAFT_100	Error al guardar el borrador actualizado
UPDATE_DRAFT_101	La firma no es válida
UPDATE_DRAFT_102	Error al leer el borrador
UPDATE_DRAFT_103	Error al guardar el estado del borrador
UPDATE_DRAFT_104	Error al obtener el organismo raíz del organismo receptor de la factura
UPDATE_DRAFT_105	Error al obtener los datos del procedimiento asociado
UPDATE_DRAFT_106	No se ha podido recuperar el organismo
UPDATE_DRAFT_200	Error al leer el borrador
UPDATE_DRAFT_201	Error al obtener el validador del borrador
UPDATE_DRAFT_202	El borrador no cumple con el formato especificado
UPDATE_DRAFT_203	Error al realizar el unmarshal del borrador
UPDATE_DRAFT_204	Se han detectado errores en la validación
UPDATE_DRAFT_205	Error al buscar el usuario responsable
UPDATE_DRAFT_206	El XML con el borrador no está codificado en UTF-8
UPDATE_DRAFT_207	Error de E/S al comprobar la codificación del borrador
UPDATE_DRAFT_208	Error al preparar la validación contable
UPDATE_DRAFT_300	No se ha proporcionado el formato del borrador en los parámetros
UPDATE_DRAFT_301	No se ha proporcionado el csv del borrador en los parámetros
UPDATE_DRAFT_302	No se ha proporcionado un formato de borrador válido
UPDATE_DRAFT_303	No se ha proporcionado un borrador en los parámetros
UPDATE_DRAFT_304	No se ha proporcionado los parámetros
UPDATE_DRAFT_400	Error de BD al buscar el borrador
UPDATE_DRAFT_401	No existe ningún borrador con el identificador proporcionado
UPDATE_DRAFT_402	El borrador que se intenta actualizar no pertenece a su empresa
UPDATE_DRAFT_403	No se permite actualizar borradores en los que no actúe como emisor
UPDATE_DRAFT_404	Error al buscar el NIF del organismo
UPDATE_DRAFT_408	El expediente no cumple con el formato requerido
UPDATE_DRAFT_409	El borrador es rectificativo y no está permitido que lo sea

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamUpdateDraft paramUpdateDraft = new ParamUpdateDraft();
paramUpdateDraft.setApplicationId("SFE");
paramUpdateDraft.setExpedient(null);
paramUpdateDraft.setFormat("FACTURAE_3_2");
paramUpdateDraft.setDraftData(new DataHandler(new FileDataSource("PATH_XML_BORRADOR")));
paramUpdateDraft.setCsv("DRAFT_CSV");
// paramUpdateDraft.setCif("A01274927");

// Lanzamos la llamada
ResultUpdateDraft resultUpadteDraft = draftServiceImpl.updateDraft(paramUpdateDraft);

Método searchDrafts

Obtiene un listado de borradores existentes en el sistema.

Expand

title	Más detalles...

Signatura

ResultSearchDrafts searchDrafts(ParamSearchDrafts paramSearchDrafts)

Parámetros de invocación

ParamSearchDrafts extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
searchDrafts	SFE v3.11.0 - Manual de integración#SearchDraftWS	Criterios de búsqueda de los borradores

SearchDraftWS extends SFE v3.11.0 - Manual de integración#DraftWS

Anchor

	SearchDraftWS
	SearchDraftWS

Nombre

Tipo

Descripción

creationDateFrom

Date

Fecha de creación (desde)

creationDateTo

Date

Fecha de creación (hasta)

issueDateFrom

Date

Fecha de emisión (desde)

issueDateTo

Date

Fecha de emisión (hasta)

operationDateFrom

Date

Fecha de servicio (desde)

operationDateTo

Date

Fecha de servicio (hasta)

invoicingPeriodStartDateFrom

Date

Fecha de comienzo del periodo de facturación (desde)

invoicingPeriodStartDateTo

Date

Fecha de comienzo del período de facturación (hasta)

invoicingPeriodEndDateFrom

Date

Fecha de fin del período de facturación (desde)

invoicingPeriodEndDateTo

Date

Fecha de fin del período de facturación (hasta)

registerDateFrom

Date

Fecha de registro (desde)

registerDateTo

Date

Fecha de registro (hasta)

draftTotalFrom

Double

Total (desde)

draftTotalTo

Double

Total (hasta)

params

SFE v3.11.0 - Manual de integración#SearchParamsWS

Otros parámetros de búsqueda (ordenación, paginación...)

Parámetros de respuesta

ResultSearchDrafts extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
draftList	List<SFE v3.11.0 - Manual de integración#DraftWS>	Lista de metadatos de borradores
size	int	Número de borradores que cumplen los criterios de búsqueda

Códigos error

Código	Descripción
SEARCH_DRAFTS_000	Error al buscar los metadatos de los borradores
SEARCH_DRAFTS_200	Error al buscar el NIF del organismo
SEARCH_DRAFTS_300	No se han proporcionado los parámetros de búsqueda
SEARCH_DRAFTS_301	No se ha proporcionado el NIF de la empresa en los parámetros
SEARCH_DRAFTS_302	No se ha proporcionado los parámetros
SEARCH_DRAFTS_400	No se permite buscar borradores en los que no actúe como emisor

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSearchDrafts paramSearchDrafts = new ParamSearchDrafts();
paramSearchDrafts.setApplicationId("SFE");
paramSearchDrafts.setCif("A01274927");
SearchDraftWS searchDrafts = new SearchDraftWS();
paramSearchDrafts.setSearchDrafts(searchDrafts);

// Lanzamos la llamada
ResultSearchDrafts resultSearchDrafts = draftServiceImpl.searchDrafts(paramSearchDrafts);

Método downloadDraft

Descarga el borrador solicitado.

Expand

title	Más detalles...

Signatura

ResultDownloadDraft downloadDraft(ParamDownloadDraft paramDownloadDraft)

Parámetros de invocación

ParamDownloadDraft extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV del borrador a descargar

Parámetros de respuesta

ResultDownloadDraft extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido del borrador

Códigos error

Código	Descripción
DOWNLOAD_DRAFT_100	Error al recuperar el borrador del gestor documental
DOWNLOAD_DRAFT_300	No se ha proporcionado el NIF de la empresa en los parámetros
DOWNLOAD_DRAFT_301	No se ha proporcionado el csv del borrador en los parámetros
DOWNLOAD_DRAFT_302	No se ha proporcionado los parámetros
DOWNLOAD_DRAFT_400	Error de BD al buscar el borrador
DOWNLOAD_DRAFT_401	No existe ningún borrador con el identificador proporcionado
DOWNLOAD_DRAFT_402	No se permite descargar borradores en los que no actúe como emisor

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadDraft paramDownloadDraft = new ParamDownloadDraft();
paramDownloadDraft.setCsv("DRAFT_CSV");
paramDownloadDraft.setCif("A01274927");

// Lanzamos la llamada
ResultDownloadDraft resultDownloadDraft = draftServiceImpl.downloadDraft(paramDownloadDraft);

Método sendSignedDraft

Emite un borrador firmado, pasando a ser factura en el sistema.

Expand

title	Más detalles...

Signatura

ResultSendSignedDraft sendSignedDraft(ParamSendSignedDraft paramSendDraft)

Parámetros de invocación

ParamSendSignedDraft extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV del borrador a enviar

Parámetros de respuesta

ResultSendSignedDraft extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
invoiceValidationErrorList	List<SFE v3.11.0 - Manual de integración#InvoiceValidationError>	Lista con los errores de validación encontrados

Códigos error

Código	Descripción
SEND_DRAFT_000	Error de BD al envíar el borrador
SEND_DRAFT_100	Error en la inserción en Documentum
SEND_DRAFT_101	Error al leer el borrador
SEND_DRAFT_102	Error en la verificación de la firma del documento
SEND_DRAFT_103	Error al crear el HTML de la factura
SEND_DRAFT_104	Error al generar el Hash mediante el método SHA1
SEND_DRAFT_105	Error al enviar a registro telemático
SEND_DRAFT_106	Error al cambiar el estado de la factura
SEND_DRAFT_107	Error al actualizar la factura en la base de datos
SEND_DRAFT_108	Error al buscar la factura a rectificar. Existe más de una factura con ese NIF de proveedor y número de factura
SEND_DRAFT_109	Error al buscar la factura a rectificar. No existe ninguna factura con ese NIF de proveedor y número de factura
SEND_DRAFT_110	Error al leer la factura para crear los parámetros de validación del ERP
SEND_DRAFT_111	Error al evaluar la expresión XPATH para crear los parámetros de validación del ERP
SEND_DRAFT_112	Error al consumir el servicio validateOBSY de SERPA
SEND_DRAFT_113	Error al obtener los campos a prevalidar en SERPA
SEND_DRAFT_114	Error al obtener el organismo raíz del organismo receptor de la factura
SEND_DRAFT_115	Error al obtener los datos del procedimiento asociado
SEND_DRAFT_116	No se ha podido recuperar el organismo
SEND_DRAFT_200	Error al buscar el usuario responsable
SEND_DRAFT_201	Se han detectado errores en la validación de SERPA
SEND_DRAFT_300	No se ha proporcionado el csv del borrador en los parámetros
SEND_DRAFT_301	No se ha proporcionado los parámetros
SEND_DRAFT_400	Error de BD al buscar el borrador
SEND_DRAFT_401	No existe ningún borrador con el identificador proporcionado
SEND_DRAFT_402	No es posible enviar un borrador que no esté firmado
SEND_DRAFT_403	No se permite enviar borradores en los que no actúe como emisor
SEND_DRAFT_404	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSendSignedDraft paramSendDraft = new ParamSendSignedDraft();
paramSendDraft.setApplicationId("SFE");
paramSendDraft.setCsv("CSVOK");
// paramSendDraft.setCif("A01274927");

// Lanzamos la llamada
ResultSendSignedDraft resultSendSignedDraft = draftServiceImpl.sendSignedDraft(paramSendDraft);

Método deleteDraft

Elimina un borrador del sistema.

Expand

title	Más detalles...

Signatura

ResultDeleteDraft deleteDraft(ParamDeleteDraft paramDeleteDraft)

Parámetros de invocación

ParamDeleteDraft extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV del borrador a eliminar

Parámetros de respuesta

ResultDeleteDraft extends SFE v3.11.0 - Manual de integración#ResultError
No hay variables

Códigos error

Código	Descripción
DELETE_DRAFT_000	Error al eliminar los metadatos del borrador
DELETE_DRAFT_100	Error al eliminar los estados del borrador
DELETE_DRAFT_101	Error al eliminar el borrador de Documentum
DELETE_DRAFT_102	Error de BD al buscar los adjuntos
DELETE_DRAFT_103	Error de BD al borrar los metadatos del adjunto
DELETE_DRAFT_104	No existe el adjunto a eliminar
DELETE_DRAFT_105	Error al borrar el adjunto en Documentum
DELETE_DRAFT_300	No se ha proporcionado el CSV del borrador en los parámetros
DELETE_DRAFT_301	No se ha proporcionado los parámetros
DELETE_DRAFT_400	Error de BD al buscar el borrador
DELETE_DRAFT_401	No existe ningún borrador con el identificador proporcionado
DELETE_DRAFT_402	No se permite eliminar borradores en los que no actúe como emisor
DELETE_DRAFT_403	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDeleteDraft paramDeleteDraft = new ParamDeleteDraft();
paramDeleteDraft.setApplicationId("SFE");
paramDeleteDraft.setCsv("DRAFT_CSV");

// Lanzamos la llamada
ResultDeleteDraft resultDeleteDraft = draftServiceImpl.deleteDraft(paramDeleteDraft);

Método addAttachment

Adjunta un fichero a un borrador existente.

Expand

title	Más detalles...

Signatura

ResultAddAttachment addAttachment(ParamAddAttachment paramAddAttachment)

Parámetros de invocación

ParamAddAttachment extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
attachmentWS	SFE v3.11.0 - Manual de integración#AttachmentWS	Metadatos del adjunto
date	DataHandler	Contenido del adjunto

Parámetros de respuesta

ResultAddAttachment extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
attachment	SFE v3.11.0 - Manual de integración#AttachmentWS	Metadatos del adjunto añadido.

Códigos error

Código	Descripción
ADD_ATTACHMENT_000	Error de BD al escribir los metadatos del adjunto
ADD_ATTACHMENT_001	Error de BD al escribir los metadatos del adjunto por nombre duplicado
ADD_ATTACHMENT_100	Error al insertar el adjunto en Documentum
ADD_ATTACHMENT_101	Error al restablecer CCSV borrando el adjunto
ADD_ATTACHMENT_102	Error al obtener el organismo raíz del organismo receptor de la factura
ADD_ATTACHMENT_103	Error al obtener los datos del procedimiento asociado
ADD_ATTACHMENT_104	No se ha podido recuperar el organismo
ADD_ATTACHMENT_200	Error al obtener el usuario responsable
ADD_ATTACHMENT_300	No se han proporcionado metadatos del adjunto en los parámetros
ADD_ATTACHMENT_301	No se ha proporcionado un identificador CSV en los parámetros
ADD_ATTACHMENT_302	No se ha proporcionado un nombre del adjunto en los parámetros
ADD_ATTACHMENT_303	No se ha proporcionado una descripción del adjunto en los parámetros
ADD_ATTACHMENT_304	No se ha proporcionado un MIME-Type en los parámetros
ADD_ATTACHMENT_305	No se ha proporcionado el contenido del adjunto en los parámetros
ADD_ATTACHMENT_306	No se ha proporcionado parámetro
ADD_ATTACHMENT_400	Error de BD al buscar el borrador
ADD_ATTACHMENT_401	No existe ningún borrador con el identificador proporcionado
ADD_ATTACHMENT_402	No se permite añadir adjuntos a borradores en los que no actúe como emisor
ADD_ATTACHMENT_403	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamAddAttachment paramSendDraft = new ParamAddAttachment();
paramSendDraft.setApplicationId("SFE");

AttachmentWS att = new AttachmentWS();
att.setAttachmentCsv("CSV_ATT");
att.setCreationDate(new Date());
att.setDescription("description");
att.setInvoiceCsv("CSV_INVOICE");
att.setTitle("title");
att.setType("type");
paramSendDraft.setAttachmentWS(att );

paramSendDraft.setData(new DataHandler(new FileDataSource("PATH_XML_BORRADOR")));

// Lanzamos la llamada
ResultAddAttachment resultAddAttachment = draftServiceImpl.addAttachment(paramSendDraft);

Método deleteAttachment

Elimina un fichero adjunto a un borrador.

Expand

title	Más detalles...

Signatura

ResultDeleteAttachment deleteAttachment(ParamDeleteAttachment paramDeleteAttachment)

Parámetros de invocación

ParamDeleteAttachment extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
attachmentCsv	String	Identificador CSV del adjunto a eliminar
invoiceCsv	String	Identificador CSV del borrador

Parámetros de respuesta

ResultDeleteAttachment extends SFE v3.11.0 - Manual de integración#ResultError
No hay variables

Códigos error

Código	Descripción
DELETE_ATTACHMENT_000	Error de BD al borrar los metadatos del adjunto
DELETE_ATTACHMENT_100	No existe ningún adjunto con el identificador proporcionado
DELETE_ATTACHMENT_101	Error al borrar el adjunto en Documentum
DELETE_ATTACHMENT_300	No se ha proporcionado un identificador CSV en los parámetros
DELETE_ATTACHMENT_301	No se ha proporcionado los parámetros
DELETE_ATTACHMENT_400	Error de BD al buscar el adjunto
DELETE_ATTACHMENT_401	No existe ningún adjunto con el identificador proporcionado
DELETE_ATTACHMENT_402	Error de BD al buscar el borrador
DELETE_ATTACHMENT_403	No existe el borrador al que hace referencia el adjunto
DELETE_ATTACHMENT_404	No se permite eliminar adjuntos a borradores en los que no actúe como emisor
DELETE_ATTACHMENT_405	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDeleteAttachment paramDeleteAttachment = new ParamDeleteAttachment("ATT_CSV", "DRAFT_CSV");

// Lanzamos la llamada
ResultDeleteAttachment resultDeleteAttachment = draftServiceImpl.deleteAttachment(paramDeleteAttachment);

Método downloadAttachment

Descarga un fichero adjunto a un borrador.

Expand

title	Más detalles...

Signatura

ResultDownloadAttachment downloadAttachment(ParamDownloadAttachment paramDownloadAttachment)

Parámetros de invocación

ParamDownloadAttachment extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
attachmentCsv	String	Identificador CSV del adjunto a eliminar
invoiceCsv	String	Identificador CSV del borrador
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadAttachment extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido del adjunto

Códigos error

Código	Descripción
DOWNLOAD_ATTACHMENT_100	Error al descargar el adjunto de Documentum
DOWNLOAD_ATTACHMENT_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_ATTACHMENT_301	No se ha proporcionado los parámetros
DOWNLOAD_ATTACHMENT_400	Error de BD al buscar el adjunto
DOWNLOAD_ATTACHMENT_401	No existe ningún adjunto con el identificador proporcionado
DOWNLOAD_ATTACHMENT_402	Error de BD al buscar el borrador
DOWNLOAD_ATTACHMENT_403	No existe el borrador al que hace referencia el adjunto
DOWNLOAD_ATTACHMENT_404	No se permite descargar adjuntos a borradores en los que no actúe como emisor
DOWNLOAD_ATTACHMENT_405	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadAttachment paramDownloadAttachment = new ParamDownloadAttachment("ATT_CSV", true, "INV_CSV");

// Lanzamos la llamada
ResultDownloadAttachment resultDownloadAttachment = draftServiceImpl.downloadAttachment(paramDownloadAttachment);

Método downloadAttachments

Descarga todos los ficheros adjuntos a un borrador.

Expand

title	Más detalles...

Signatura

ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)

Parámetros de invocación

ParamDownloadAttachments extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
parentCsv	String	Identificador CSV de la factura de la que obtener sus adjuntos
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultDownloadAttachments extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
data	DataHandler	Contenido comprimido de los adjuntos de una factura

Códigos error

Código	Descripción
DOWNLOAD_ATTACHMENTS_000	Error de BD al buscar los adjuntos del borrador
DOWNLOAD_ATTACHMENTS_100	Error al descargar el adjunto de Documentum
DOWNLOAD_ATTACHMENTS_101	Error al crear el fichero comprimido con los adjuntos del borrador
DOWNLOAD_ATTACHMENTS_300	No se ha proporcionado un identificador CSV en los parámetros
DOWNLOAD_ATTACHMENTS_301	No se ha proporcionado los parámetros
DOWNLOAD_ATTACHMENTS_400	Error de BD al buscar el borrador
DOWNLOAD_ATTACHMENTS_401	No existe ningún borrador con el identificador proporcionado
DOWNLOAD_ATTACHMENTS_402	No se permite descargar adjuntos a borradores en los que no actúe como emisor
DOWNLOAD_ATTACHMENTS_403	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDownloadAttachments paramDownloadAttachments = new ParamDownloadAttachments("ATT_CSV", true);

// Lanzamos la llamada
ResultDownloadAttachments resultDownloadAttachments = draftServiceImpl.downloadAttachments(paramDownloadAttachments);

Método searchAttachments

Obtiene el listado de ficheros adjuntos a un borrador.

Expand

title	Más detalles...

Signatura

ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)

Parámetros de invocación

ParamSearchAttachments extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
parentCsv	String	Identificador CSV de la factura de la que buscar sus adjuntos
isIssuer	boolean	Indica si es emisor o receptor

Parámetros de respuesta

ResultSearchAttachments extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
attachmentList	List<SFE v3.11.0 - Manual de integración#AttachmentWS>	Lista de metadatos de los adjuntos

Códigos error

Código	Descripción
SEARCH_ATTACHMENTS_000	Error de BD al buscar los adjuntos del borrador
SEARCH_ATTACHMENTS_300	No se ha proporcionado un identificador CSV en los parámetros
SEARCH_ATTACHMENTS_301	No se ha proporcionado los parámetros
SEARCH_ATTACHMENTS_400	Error de BD al buscar el borrador
SEARCH_ATTACHMENTS_401	No existe ningún borrador con el identificador proporcionado
SEARCH_ATTACHMENTS_402	No se permite buscar adjuntos de borradores en los que no actúe como emisor
SEARCH_ATTACHMENTS_403	Error al buscar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSearchDrafts paramSearchDrafts = new ParamSearchDrafts();
paramSearchDrafts.setApplicationId("SFE");
paramSearchDrafts.setCif("A01274927");
SearchDraftWS searchDrafts = new SearchDraftWS();
paramSearchDrafts.setSearchDrafts(searchDrafts);

// Lanzamos la llamada
ResultSearchDrafts resultSearchDrafts = draftServiceImpl.searchDrafts(paramSearchDrafts);

Servicios de firma

...

ISignServicePortType

Info
Se ha eliminado la versión 1 de los servicios.

Método verifySign

Verifica la firma de la factura indicada.

Expand

title	Más detalles...

Signatura

ResultVerifySign verifySign(ParamVerifySign paramVerifySign) throws RestException

Parámetros de invocación

ParamVerifySign extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csv	String	Identificador CSV de la factura de la que comprobar su firma

Parámetros de respuesta

ResultVerifySign extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
cert	SFE v3.11.0 - Manual de integración#CertBean[]	Array con las CAs válidas

CertBean

Anchor

	CertBean
	CertBean

Nombre

Tipo

Descripción

issuer

String

Emisor

serialNumber

String

Número de serie del certificado

idNonRepudiation

String

ID

elements

SFE v3.11.0 - Manual de integración#DataBean[]

Pares de clave (valor con información adicional)

status

Integer

Estado

caChain

SFE v3.11.0 - Manual de integración#CABean[]

Cadena de CAs

validFrom

Calendar

Fecha comienzo de validez

validTo

Calendar

Fecha fin de validez

signDate

Calendar

Fecha de la firma

DataBean

Anchor

	DataBean
	DataBean

Nombre

Tipo

Descripción

name

String

Nombre de la propiedad

value

String

Valor de la propiedad

CABean

Anchor

	CABean
	CABean

Nombre

Tipo

Descripción

caChain

CABean[]

Cadena de la CA

issuer

String

Emisor

restrictionsFields

String

Campos de restricciones

restrictionsPatterns

String

Patrones de restricciones

Códigos error

Código	Descripción
VERIFY_SIGN_100	Error al obtener la factura desde Documentum
VERIFY_SIGN_101	Error al leer el contenido de la factura
VERIFY_SIGN_120	Se ha recibido un ResultVerifyInfoSet nulo de ASF
VERIFY_SIGN_121	Se ha producido un error al verificar la firma en ASF
VERIFY_SIGN_122	La lista con la información de los firmantes devuelta por ASF está vacía
VERIFY_SIGN_123	La firma no ha podido ser verificada por que ha ocurrido un error
VERIFY_SIGN_124	La firma no ha podido ser verificada por que ha ocurrido un error
VERIFY_SIGN_125	La firma no es válida
VERIFY_SIGN_126	El certificado no es válido
VERIFY_SIGN_127	No se confía en el certificado
VERIFY_SIGN_128	El certificado ha sido revocado
VERIFY_SIGN_129	El certificado no ha podido ser verificado
VERIFY_SIGN_130	El certificado no es válido para la operación especificada
VERIFY_SIGN_131	El algoritmo de la firma del certificado no está soportado por ASF
VERIFY_SIGN_132	La firma tiene una marca de tiempo no válida
VERIFY_SIGN_133	No se ha encontrado un certificado
VERIFY_SIGN_134	No se ha encontrado la cadena de certificación
VERIFY_SIGN_135	La información de la clave del documento XML no tiene certificado
VERIFY_SIGN_136	No hay información de la clave en el documento XML
VERIFY_SIGN_137	No se ha encontrado una firma en el documento XML
VERIFY_SIGN_138	Ha ocurrido un error validando el documento XML
VERIFY_SIGN_139	El contexto de la firma está definido por un intervalo inesperado de bytes
VERIFY_SIGN_300	No se ha proporcionado un identificador CSV en los parámetros.
VERIFY_SIGN_200	No se ha proporcionado los parámetros
VERIFY_SIGN_400	No existe ninguna factura con el identificador proporcionado
VERIFY_SIGN_401	No se permite verificar la firma de facturas en las que no actúe como receptor
VERIFY_SIGN_402	Error al consultar los metadatos de la factura
VERIFY_SIGN_403	Error al consultar el NIF del organismo

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamVerifySign paramVerifySign = new ParamVerifySign();
paramVerifySign.setApplicationId("SFE");
paramVerifySign.setCsv("INVOICE_CSV");

// Lanzamos la llamada
ResultVerifySign resultVerifySign = signServiceImpl.verifySign(paramVerifySign);

...

ISerpaXPathServicePortType

Info
Se ha eliminado la versión 1 de los servicios.

Método listAllSerpaXPath

Obtiene todos los campos a prevalidar en SERPA, con sus expresiones xpath.

Expand

title	Más detalles...

Signatura

ResultListAllSerpaXPath listAllSerpaXPath(ParamListAllSerpaXPath paramListAllSerpaXPath)

Parámetros de invocación

ParamListAllSerpaXPath extends SFE v3.11.0 - Manual de integración#ParamBase
No hay variables

Parámetros de respuesta

ResultListAllSerpaXPath extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
serpaXPathList	List<SFE v3.11.0 - Manual de integración#SerpaXPathWS>	Lista de nombres y expresiones xPath de los campos

SerpaXPathWS

Anchor

	SerpaXPathWS
	SerpaXPathWS

Nombre

Tipo

Descripción

field

String

Nombre del campo a prevalidar

xPath

String

Expresión xPath para obtener el campo

Códigos error

Código	Descripción
GETALL_SERPA_XPATH_00	Error en la operación de listado. Problema grave de BD
GETALL_SERPA_XPATH_01	Error en la operación de listado. Lista de campos a prevalidar a SERPA vacía

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamListAllSerpaXPath paramListAllSerpaXPath = new ParamListAllSerpaXPath();

// Lanzamos la llamada
ResultListAllSerpaXPath resultListAllSerpaXPath = serpaXPathServiceImpl.listAllSerpaXPath(paramListAllSerpaXPath);

Método createSerpaXPath

Da de alta un nuevo campo a prevalidar en SERPA, con su expresión xpath.

Expand

title	Más detalles...

Signatura

ResultCreateSerpaXPath createSerpaXPath(ParamCreateSerpaXPath paramCreateSerpaXPath)

Parámetros de invocación

ParamCreateSerpaXPath extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
serpaXPath	SFE v3.11.0 - Manual de integración#SerpaXPathWS	Nombre y expresión xPath del campo

Parámetros de respuesta

ResultCreateSerpaXPath extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
serpaXPath	SFE v3.11.0 - Manual de integración#SerpaXPathWS	Nombre y expresión xPath añadido

Códigos error

Código	Descripción
SAVE_SERPA_XPATH_00	Error en la operación de añadir. Problema grave de BD
SAVE_SERPA_XPATH_01	Error en la operación de añadir. Ya existe un campo con ese nombre
VALIDATION_CREATE_SERPA_XPATH_00	No puede estar vacío el nombre del campo a prevalidar a SERPA
VALIDATION_CREATE_SERPA_XPATH_01	No puede estar vacóo la expresión XPath del campo a prevalidar a SERPA
VALIDATION_CREATE_SERPA_XPATH_02	No se puede crear un campo con el nombre de uno que ya existe
VALIDATION_CREATE_SERPA_XPATH_03	Se ha de proporcionar la información necesaria para la creación del campo a validar en SERPA

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamCreateSerpaXPath paramCreateSerpaXPath = new ParamCreateSerpaXPath();
paramCreateSerpaXPath.setApplicationId("SFE");
SerpaXPathWS serpaXPathWS = new SerpaXPathWS();
serpaXPathWS.setField("Nuevo campo");
serpaXPathWS.setXPath("Nuevo XPath");
paramCreateSerpaXPath.setSerpaXPath(serpaXPathWS);

// Lanzamos la llamada
ResultCreateSerpaXPath resultCreateSerpaXPath = serpaXPathServiceImpl.createSerpaXPath(paramCreateSerpaXPath);

Método updateSerpaXPath

Actualiza la expresión xpath de un campo a prevalidar en SERPA.

Expand

title	Más detalles...

Signatura

ResultUpdateSerpaXPath updateSerpaXPath(ParamUpdateSerpaXPath paramUpdateSerpaXPath)

Parámetros de invocación

ParamUpdateSerpaXPath extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
serpaXPath	SFE v3.11.0 - Manual de integración#SerpaXPathWS	Nombre y expresión xPath del campo

Parámetros de respuesta

ResultUpdateSerpaXPath extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
serpaXPath	SFE v3.11.0 - Manual de integración#SerpaXPathWS	Nombre y expresión xPath actualizada

Códigos error

Código	Descripción
UPDATE_SERPA_XPATH_00	Error en la operación de actualizar. Problema grave de BD
UPDATE_SERPA_XPATH_01	Error en la operación de actualizar. No existe un campo con ese nombre
UPDATE_SERPA_XPATH_03	Error en la operación de actualizar. No se ha podido actualizar la información
VALIDATION_UPDATE_SERPA_XPATH_00	No puede estar vacío el nombre del campo a prevalidar a SERPA
VALIDATION_UPDATE_SERPA_XPATH_01	No puede estar vacío la expresión XPath del campo a prevalidar a SERPA
VALIDATION_UPDATE_SERPA_XPATH_02	Se ha de proporcionar la información necesaria para la creación del campo a validar en SERPA
VALIDATION_UPDATE_SERPA_XPATH_03	No se puede actualizar un campo a prevalidar a SERPA que no existe

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamUpdateSerpaXPath paramUpdateSerpaXPath = new ParamUpdateSerpaXPath();
paramUpdateSerpaXPath.setApplicationId("SFE");
SerpaXPathWS serpaXPathWS = new SerpaXPathWS();
serpaXPathWS.setField("Nuevo campo");
serpaXPathWS.setXPath("Nuevo XPath");
paramUpdateSerpaXPath.setSerpaXPath(serpaXPathWS);

// Lanzamos la llamada
ResultUpdateSerpaXPath resultUpdateSerpaXPath = serpaXPathServiceImpl.updateSerpaXPath(paramUpdateSerpaXPath);

Método deleteSerpaXPath

Elimina un campo a prevalidar en SERPA, con su expresión xpath.

Expand

title	Más detalles...

Signatura

ResultDeleteSerpaXPath deleteSerpaXPath(ParamDeleteSerpaXPath paramDeleteSerpaXPath)

Parámetros de invocación

ParamDeleteSerpaXPath extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
field	String	Nombre del campo a eliminar

Parámetros de respuesta

ResultDeleteSerpaXPath extends SFE v3.11.0 - Manual de integración#ResultError
No hay variables

Códigos error

Código	Descripción
DELETE_SERPA_XPATH_00	Error en la operación de eliminar. Problema grave de BD
DELETE_SERPA_XPATH_01	Error en la operación de eliminar. No existe un campo con ese nombre
VALIDATION_DELETE_SERPA_XPATH_00	No puede estar vacío el nombre del campo a prevalidar a SERPA
VALIDATION_DELETE_SERPA_XPATH_01	No se puede eliminar un campo a prevalidar a SERPA que no existe
VALIDATION_DELETE_SERPA_XPATH_02	No se puede eliminar falta de parámetros

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDeleteSerpaXPath paramDeleteSerpaXPath = new ParamDeleteSerpaXPath();
paramDeleteSerpaXPath.setApplicationId("SFE");
paramDeleteSerpaXPath.setField("XXX");

// Lanzamos la llamada
ResultDeleteSerpaXPath resultDeleteSerpaXPath = serpaXPathServiceImpl.deleteSerpaXPath(paramDeleteSerpaXPath);

Servicios de conformidad de facturas

...

IConformServicePortType

Info
Se ha eliminado la versión 1 de los servicios.

Método conformInvoices

Envía un documento de conformidad de facturas.

Expand

title	Más detalles...

Signatura

ResultConformInvoices conformInvoices(ParamConformInvoices paramConformInvoices) throws Exception

Parámetros de invocación

ParamConformInvoices extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
csvConform	String	Identificador CSV del documento de conformidad de la factura
signerNIF	String	NIF del firmante
signerOrganism	String	Organismo del firmante
tramitadorNIF	String	NIF del tramitador
conformDocument	String	Documento de conformidad en base64
arrayOfParamConformInvoices	SFE v3.11.0 - Manual de integración#ArrayOfParamConformInvoices	Array con el listado de facturas a conformar y su estados

ArrayOfParamConformInvoices

Anchor

	ArrayOfParamConformInvoices
	ArrayOfParamConformInvoices

Nombre

Tipo

Descripción

invoiceList

List<SFE v3.11.0 - Manual de integración#InvoiceList>

Listado de csv del listado de facturas que contiene el documento de conformidad

InvoiceList

Anchor

	InvoiceList
	InvoiceList

Nombre

Tipo

Descripción

csv

String

Listado de csv de facturas a conformar

Parámetros de respuesta

ResultConformInvoices extends SFE v3.11.0 - Manual de integración#ResultError

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamConformInvoices paramConformInvoices = new ParamConformInvoices();
paramConformInvoices.setConformDocument("DOC_BASE64");
paramConformInvoices.setSignerNIF("NIF_FIRMANTE");
paramConformInvoices.setTramitadorNIF("NIF_TRAMITADOR");
paramConformInvoices.setCsvConform("CSV_CONFORM");

ArrayOfParamConformInvoices arrayOfParamConformInvoices = new ArrayOfParamConformInvoices();
arrayOfParamConformInvoices.setInvoiceList(new ArrayList<InvoiceList>());
paramConformInvoices.setArrayOfParamConformInvoices(arrayOfParamConformInvoices);

// Lanzamos la llamada
ResultConformInvoices resultConformInvoices = conformServiceImpl.conformInvoices(paramConformInvoices);

Método stateConformInvoices

Comprueba el estado de conformidad de las facturas.

Expand

title	Más detalles...

Signatura

ResultStateConformInvoices stateConformInvoices(ParamStateConformInvoices paramStateConformInvoices) throws Exception

Parámetros de invocación

ParamStateConformInvoices extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
arrayOfParamConformInvoices	SFE v3.11.0 - Manual de integración#ArrayOfParamStateConformInvoices	Array con el listado de facturas a conformar y su estados

Parámetros de respuesta

ResultStateConformInvoices extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
arrayConformInvoices	SFE v3.11.0 - Manual de integración#ArrayOfConformInvoices	Array con el listado de facturas a conformar y su estados

ArrayOfParamStateConformInvoices

Anchor

	ArrayOfParamStateConformInvoices
	ArrayOfParamStateConformInvoices

Nombre

Tipo

Descripción

conformDocumentList

List<SFE v3.11.0 - Manual de integración#StateConformInvoicesData>

Array con el listado de facturas a conformar y su estados

StateConformInvoicesData

Anchor

	StateConformInvoicesData
	StateConformInvoicesData

Nombre

Tipo

Descripción

csv

String

Código csv del documento de conformidad

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamStateConformInvoices paramStateConformInvoices = new ParamStateConformInvoices();
paramStateConformInvoices.setConformDocument("DOC_BASE64");
paramStateConformInvoices.setSignerNIF("NIF_FIRMANTE");
paramStateConformInvoices.setTramitadorNIF("NIF_TRAMITADOR");
paramStateConformInvoices.setCsvConform("CSV_CONFORM");

ArrayOfParamConformInvoices arrayOfParamConformInvoices = new ArrayOfParamConformInvoices();
arrayOfParamConformInvoices.setInvoiceList(new ArrayList<InvoiceList>());
paramStateConformInvoices.setArrayOfParamConformInvoices(arrayOfParamConformInvoices);

// Lanzamos la llamada
ResultStateConformInvoices resultStateConformInvoices = conformServiceImpl.stateConformInvoices(paramStateConformInvoices);

Servicios de descarga de facturas de FACe

...

IFaceServicePortType

Método obtainNewInvoices

Invoca a los procesos de descarga de facturas tanto por listado, como por solicitud de facturas a FACe.

Expand

title	Más detalles...

Signatura

ResultObtainNewInvoices obtainNewInvoices(ParamObtainNewInvoices paramObtainNewInvoices)

Parámetros de invocación

ParamObtainNewInvoices extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
downloadType	String	Tipo de descarga de factura
invoiceList	List<SRCFFactura>	Listado de facturas

SRCFFactura

Anchor

	SRCFFactura
	SRCFFactura

Nombre

Tipo

Descripción

numeroRegistro

String

Número de registro

codigoDirOficinaContable

String

Código de la oficina contable

codigoDirOrganoGestor

String

Código del órgano gestor

codigoDirUnidadTramitadora

String

Código de la unidad tramitadora

fechaHoraRegistro

String

Fecha de la hora de registro

Parámetros de respuesta

ResultObtainNewInvoices extends SFE v3.11.0 - Manual de integración#ResultError
No hay variables

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamObtainNewInvoices paramObtainNewInvoices = new ParamObtainNewInvoices();
paramObtainNewInvoices.setDownloadType("auto");

// Lanzamos la llamada
ResultObtainNewInvoices resultObtainNewInvoices = faceServiceImpl.obtainNewInvoices(paramObtainNewInvoices);

...

IOrganismDir3ServicePortType

Info
Se ha eliminado la versión 1 de los servicios.

Método obtainNewInvoices

Obtiene un listado de organismos DIR3.

Expand

title	Más detalles...

Signatura

ResultSearchOrganismsDir3 searchOrganismsDir3(ParamSearchOrganismsDir3 paramSearchOrganismsDir3)

Parámetros de invocación

ParamSearchOrganismsDir3 extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
searchOrganismsDir3	SFE v3.11.0 - Manual de integración#SearchOrganismDir3WS	Criterios de búsqueda de los borradores

SearchOrganismDir3WS

Anchor

	SearchOrganismDir3WS
	SearchOrganismDir3WS

Nombre

Tipo

Descripción

distinctColumn

String

Columnas para el distinct

params

SFE v3.11.0 - Manual de integración#SearchParamsWS

Parámetros de búsqueda

SearchParamsWS

Anchor

	SearchParamsWS
	SearchParamsWS

Nombre

Tipo

Descripción

sortColumn

String

Columna de ordenación

ascending

boolean

Es ascendente

fromIndex

int

Índice (hasta)

toIndex

int

Índice (desde)

Parámetros de respuesta

ResultSearchOrganismsDir3 extends SFE v3.11.0 - Manual de integración#ResultError
Nombre	Tipo	Descripción
organismDir3List	List<OrganismDir3WS>	Lista de organismos
size	int	Número de organismos que cumplen los criterios de búsqueda

OrganismDir3WS

Anchor

	OrganismDir3WS
	OrganismDir3WS

Nombre

Tipo

Descripción

tramitadoraSiu

String

Código SIU correspondiente al organismo de contratación, cuyo rol será el de pagador

gestorSiu

String

Código SIU correspondiente al organismo gestor, cuyo rol será el de receptor

contableSiu

String

Código SIU correspondiente al organismo contable, cuyo rol será el de fiscal

tramitadoraDIR3

String

Código DIR3 correspondiente al organismo de contratación, cuyo rol será el de pagador

gestorDIR3

String

Código DIR3 correspondiente al organismo gestor, cuyo rol será el de receptor

contableDIR3

String

Código DIR3 correspondiente al organismo contable, cuyo rol será el de fiscal

proponenteDIR3

String

Código DIR3 correspondiente al organismo proponente, cuyo rol será el de comprador

nombreTramitadora

String

Nombre del organismo tramitador

nombreGestor

String

Nombre del organismo gestor

nombreContable

String

Nombre del organismo contable

nombreProponente

String

Nombre del organismo proponente

serpaCode

String

Código SERPA de la factura

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamSearchOrganismsDir3 paramSearchOrganismsDir3 = new ParamSearchOrganismsDir3();
paramSearchOrganismsDir3.setSearchOrganismsDir3(new SearchOrganismDir3WS());

// Lanzamos la llamada
ResultSearchOrganismsDir3 resultSearchOrganismsdir3 = organismDir3AccessWS.searchOrganismsDir3(paramSearchOrganismsDir3);

...

SerpaSRCFWebServiceProxyPortImplPortType

Método cambiarEstadoFactura

Cambia el estado de una factura

Expand

title	Más detalles...

Signatura

SRCFFacturaCambioEstado cambiarEstadoFactura(ParamCambiarEstadoFactura paramCambiarEstadoFactura)

Parámetros de invocación

ParamCambiarEstadoFactura extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
oficinaContable	String	Código de la oficina contable
numeroRegistro	String	Código idFace de la factura
codigoEstado	String	Código del nuevo estado al que pasará la factura
comentarios	String	Comentario sobre el cambio de estado

Parámetros de respuesta

SRCFFacturaCambioEstado
Nombre	Tipo	Descripción
numeroRegistro	String	Número de registro de la factura
codigoEstado	String	Código del estado en el que queda la factura

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamCambiarEstadoFactura param = new ParamCambiarEstadoFactura();
param.setApplicationId("SERPA");
param.setOficinaContable("GE0000675");
param.setNumeroRegistro("2017014087058");
param.setCodigoEstado("2600");
param.setComentarios("Se rechaza la factura");

SRCFFacturaCambioEstado facturaCambioEstado = serpaSRCFWS.cambiarEstadoFactura(param);

Método confirmarDescargaFactura

Confirma la descarga de una factura desde FACe. Será necesario invocar a este método cuando se desee anular o rechazar una factura y no permita cambio entre estados.

Expand

title	Más detalles...

Signatura

SRCFFacturaConfirmacionDescarga confirmarDescargaFactura(ParamConfirmarDescargaFactura paramConfirmarDescargaFactura)

Parámetros de invocación

ParamConfirmarDescargaFactura extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
oficinaContable	String	Código de la oficina contable
numeroRegistro	String	Código idFace de la factura
codigoRCF	String	Código del registro contable

Parámetros de respuesta

SRCFFacturaConfirmacionDescarga
Nombre	Tipo	Descripción
numeroRegistro	String	Número de registro de la factura
codigoDirOficinaContable	String	Código de la oficina contable
codigoEstado	String	Código del estado en el que queda la factura

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamConfirmarDescargaFactura param = new ParamConfirmarDescargaFactura();
param.setApplicationId("SERPA");
param.setOficinaContable("GE0000675");
param.setNumeroRegistro("2017016043869");
param.setCodigoRCF("59528758F71370F2E1000000AC1B1E1E");

//Invocamos al servicio
SRCFFacturaConfirmacionDescarga facturaConfirmacionDescaga = serpaSRCFWS.confirmarDescargaFactura(param);

Método consultarEstados

Este método retorna la lista de estados que maneja FACe para la gestión de la factura. Existen dos flujos, el ordinario y el de anulación. El flujo ordinario corresponde al ciclo de vida de la factura, y el flujo de anulación corresponde al ciclo de solicitud de anulación

Expand

title	Más detalles...

Signatura

SRCFEstados consultarEstados(ParamConsultarEstados paramConsultarEstados)

Parámetros de invocación

ParamConsultarEstados.

En realidad solo hace la validación con PAU

Parámetros de respuesta

SRCFEstados
Nombre	Tipo	Descripción
estados	ArrayOfSRCFEstado	Lista de estados (SRCFEstado)

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamConsultarEstados param = new ParamConsultarEstados();
param.setApplicationId("SERPA");


//Invocamos al servicio
SRCFEstados consultarEstados= serpaSRCFWS.consultarEstados(param);

Método consultarUnidades

Este método permite consultar las relaciones OG-UT-OC asociadas al RCF que firma la petición SOAP

Expand

title	Más detalles...

Signatura

SRCFOrganosGestoresUnidadesTramitadoras consultarUnidades(ParamConsultarUnidades paramConsultarUnidades)

Parámetros de invocación

ParamConsultarUnidades.

En realidad solo hace la validación con PAU

Parámetros de respuesta

SRCFOrganosGestoresUnidadesTramitadoras
Nombre	Tipo	Descripción
relaciones	ArrayOfSRCFOrganoGestorUnidadTramitadora	Lista de relaciones

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamConsultarUnidades param = new ParamConsultarUnidades();
param.setApplicationId("SERPA");


//Invocamos al servicio
SRCFOrganosGestoresUnidadesTramitadoras consultarUnidades= serpaSRCFWS.consultarUnidades(param);

Método descargarFactura

Permite descargar factura

Expand

title	Más detalles...

Signatura

SRCFFacturaCompleta descargarFactura(ParamDescargarFactura paramDescargarFactura)

Parámetros de invocación

ParamDescargarFactura extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
numeroRegistro	String	Número de registro

Parámetros de respuesta

SRCFFacturaCompleta
Nombre	Tipo	Descripción
numero	String	Número de factura
serie	String	Serie de la factura
importe	String	Importe
proveedor	String	Proveedor
nombreFicheroFactura	String	Nombre del fichero de la factura
ficheroFactura	String	Fichero de la factura
formatoFactura	String	Formato
anexos	ArrayOfSRCFFacturaCompletaAnexo	Ficheros adjuntos

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamDescargarFactura param = new ParamDescargarFactura();
param.setApplicationId("SERPA");
param.setNumeroRegistro("2016014339972");

//Invocamos al servicio
SRCFFacturaCompleta facturaCompleta = serpaSRCFWS.descargarFactura(param);

Método gestionarSolicitudAnulacionFactura

Este método permite gestionar una solicitud de anulación, aceptándola o rechazando dicha solicitud

...

Expand

title	Más detalles...

Signatura

SRCFFacturaGestionAnulacion gestionarSolicitudAnulacionFactura(ParamGestionarSolicitudAnulacionFactura paramGestionarSolicitudAnulacionFactura)

Parámetros de invocación

ParamGestionarSolicitudAnulacionFactura extends SFE v3.11.0 - Manual de integración#ParamBase
Nombre	Tipo	Descripción
oficinaContable	String	Código de la oficina contable
numeroRegistro	String	Número de registro
codigoEstado	String	Código de estado
comentario	String	Comentario

Parámetros de respuesta

SRCFFacturaGestionAnulacion
Nombre	Tipo	Descripción
numeroRegistro	String	Número de registro
codigoEstado	String	Código de estado

Códigos error

No hay códigos de error

Ejemplo de invocación

Code Block

language	java
title	Ejemplo de invocación
collapse	true

// Rellenamos los parametros
ParamGestionarSolicitudAnulacionFactura param = new ParamGestionarSolicitudAnulacionFactura ();
param.setApplicationId("SERPA");
param.setOficinaContable("GE0000675");
param.setNumeroRegistro("2017016043869");
param.setCodigoRCF("59528758F71370F2E1000000AC1B1E1E");

//Invocamos al servicio
SRCFFacturaGestionAnulacion facturaCompleta = serpaSRCFWS.gestionarSolicitudAnulacionFactura(param);

Anexos

...

Objetos comunes

ParamBase
Anchor
ParamBase
ParamBase

Clase de la que extienden todos los parámetros de entrada de los servicios.

Esta clase proporciona las variables base de los parámetros de entrada.

Nombre	Tipo	Descripción
applicationId	String	Identificador de la aplicación que llama al web service
nif	String	NIF del usuario que realiza la invocación
cif	String	CIF del organismo/empresa que realiza la invocación
organismCode	String	Código del organismo/empresa que realiza la invocación

ResultError
Anchor
ResultError
ResultError

Clase de la que extienden todos los parámetros de salida de los servicios.

Esta clase proporciona las variables base de los parámetros de salida.

Nombre	Tipo	Descripción
errors	boolean	Indica si se han producido errores en la operación
errorMsg	String	Mensaje del error producido
errorCode	String	Código identificador del error producido

Page Comparison

Versions Compared

Old Version 2

New Version Current

Key

Método addManualInvoice

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método getAllStates

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método getInvoiceByIdFace

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método importInvoice

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método searchInvoices

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método searchInvoicesFromCSV

Signatura

Parámetros de invocación

Códigos error

Ejemplo de invocación

Método downloadInvoice

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método historicalStates

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método changeState

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método downloadAttachment

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método downloadAttachments

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método searchAttachments

Signatura

Parámetros de invocación

Parámetros de respuesta

Códigos error

Ejemplo de invocación

Método downloadRegisterReceipt

Signatura

Parámetros de invocación

Parámetros de respuesta