4.- Servicios de SFE
- Servicios Digitales de Aragón
Servicios de facturas
IInvoiceServicePortType
Método addManualInvoice
Permite añadir una factura de forma manual
Signatura
ResultAddManualInvoice addManualInvoice(ParamAddManualInvoice paramAddManualInvoice)
Parámetros de invocación
ParamAddManualInvoice extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceData | InvoiceERPWS | Contenido de la factura a añadir |
Parámetros de respuesta
ResultAddManualInvoice extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultGetAllStates getAllStates(ParamGetAllStates paramGetAllStates)
Parámetros de invocación
ParamGetAllStates extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
idsFace | String[] | Array con los Ids de las facturas en FACe |
Parámetros de respuesta
ResultGetAllStates extends 2553511978 | ||
---|---|---|
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
// 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
Signatura
ResultGetInvoice getInvoiceByIdFace(ParamGetInvoice paramGetInvoiceByIdFace )
Parámetros de invocación
ParamGetInvoice extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
idFace | String | Id de la factura en FACe |
Parámetros de respuesta
ResultGetInvoice extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultImportInvoice importInvoice(ParamImportInvoice paramImportInvoice)
Parámetros de invocación
ParamImportInvoice extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoice | 2553511978 | Metadatos de la factura importada |
attachmentList | List<2553511978> | Lista de metadatos de los adjuntos importados |
invoiceValidationErrorList | List<2553511978> | Lista con los errores de validación |
InvoiceWS extends 2553511978 | ||
---|---|---|
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 | ||
---|---|---|
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 | ||
---|---|---|
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 | ||
---|---|---|
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 |
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
// 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).
Signatura
ResultSearchInvoices searchInvoices(ParamSearchInvoices paramSearchInvoice)
Parámetros de invocación
ParamSearchInvoices extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
searchInvoice | 2553511978 | Criterios de búsqueda de facturas |
isIssuer | boolean | Indica si es emisor o receptor |
SearchInvoiceWS extends 2553511978 | ||
---|---|---|
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 | 2553511978 | Otros parámetros de búsqueda (ordenación, paginación...) |
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceList | List<2553511978> | 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
// 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
Signatura
ResultSearchInvoicesFromCSV searchInvoices(ParamSearchInvoicesFromCSV paramSearchInvoicesFromCSV)
Parámetros de invocación
ParamSearchInvoicesFromCSV extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
searchInvoiceFromCSV | SearchInvoiceFromCSVWS | Criterios de búsqueda de facturas |
isIssuer | boolean | Indica si es emisor o receptor |
SearchInvoiceFromCSVWS extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceCSVList | List<String> | Lista de Strings con los csv para la búsqueda |
params | 2553511978 | Otros parámetros de búsqueda (ordenación, paginación...) |
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceList | List<2553511978> | 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
// 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.
Signatura
ResultDownloadInvoice downloadInvoice(ParamDownloadInvoice paramDownloadInvoice)
Parámetros de invocación
ParamDownloadInvoice extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultHistoricalStates historicalStates(ParamHistoricalStates paramHistoricalStates)
Parámetros de invocación
ParamHistoricalStates extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
stateList | List<2553511978> | 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
// 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
Signatura
ResultChangeState changeState(ParamChangeState paramChangeState)
Parámetros de invocación
ParamChangeState extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
No hay variables |
Códigos error
Código | Descripción |
---|---|
CHANGE_STATE_000 | Error de BD al buscar 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
// 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).
Signatura
ResultDownloadAttachment downloadAttachment(ParamDownloadAttachment paramDownloadAttachment)
Parámetros de invocación
ParamDownloadAttachment extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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
// 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).
Signatura
ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)
Parámetros de invocación
ParamDownloadAttachments extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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
// 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).
Signatura
ResultSearchAttachments searchAttachments(ParamSearchAttachments paramSearchAttachments)
Parámetros de invocación
ParamSearchAttachments extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
attachmentList | List<2553511978> | 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
// 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.
Signatura
ResultDownloadRegisterReceipt downloadRegisterReceipt(ParamDownloadRegisterReceipt paramDownloadRegisterReceipt)
Parámetros de invocación
ParamDownloadRegisterReceipt extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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 |
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
// 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.
Signatura
ResultDownloadRegisterReceiptSign downloadRegisterReceiptSign(ParamDownloadRegisterReceiptSign paramDownloadRegisterReceiptSign)
Parámetros de invocación
ParamDownloadRegisterReceiptSign extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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 |
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
// 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.
Signatura
ResultUpdateInvoiceMetadata updateInvoiceMetadata(ParamUpdateInvoiceMetadata paramUpdateInvoiceMetadata)
Parámetros de invocación
ParamUpdateInvoiceMetadata extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoice | 2553511978 | 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
// 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
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.
Signatura
ResultImportDraft importDraft(ParamImportDraft paramImportDraft)
Parámetros de invocación
ParamImportInvoice extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoice | 2553511978 | Metadatos del borrador importado |
attachmentList | List<2553511978> | Lista de metadatos de los adjuntos importados |
invoiceValidationErrorList | List<2553511978> | Lista con los errores de validación |
DraftWS extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultUpdateDraft updateDraft(ParamUpdateDraft paramUpdateDraft)
Parámetros de invocación
ParamUpdateDraft extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
draft | 2553511978 | Metadatos del borrador actualizado |
invoiceValidationErrorList | List<2553511978> | 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
// 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.
Signatura
ResultSearchDrafts searchDrafts(ParamSearchDrafts paramSearchDrafts)
Parámetros de invocación
ParamSearchDrafts extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
searchDrafts | 2553511978 | Criterios de búsqueda de los borradores |
SearchDraftWS extends 2553511978 | ||
---|---|---|
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 | 2553511978 | Otros parámetros de búsqueda (ordenación, paginación...) |
Parámetros de respuesta
ResultSearchDrafts extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
draftList | List<2553511978> | 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
// 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.
Signatura
ResultDownloadDraft downloadDraft(ParamDownloadDraft paramDownloadDraft)
Parámetros de invocación
ParamDownloadDraft extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
csv | String | Identificador CSV del borrador a descargar |
Parámetros de respuesta
ResultDownloadDraft extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultSendSignedDraft sendSignedDraft(ParamSendSignedDraft paramSendDraft)
Parámetros de invocación
ParamSendSignedDraft extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
csv | String | Identificador CSV del borrador a enviar |
Parámetros de respuesta
ResultSendSignedDraft extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceValidationErrorList | List<2553511978> | 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
// 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.
Signatura
ResultDeleteDraft deleteDraft(ParamDeleteDraft paramDeleteDraft)
Parámetros de invocación
ParamDeleteDraft extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
csv | String | Identificador CSV del borrador a eliminar |
Parámetros de respuesta
ResultDeleteDraft extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultAddAttachment addAttachment(ParamAddAttachment paramAddAttachment)
Parámetros de invocación
ParamAddAttachment extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
attachmentWS | 2553511978 | Metadatos del adjunto |
date | DataHandler | Contenido del adjunto |
Parámetros de respuesta
ResultAddAttachment extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
attachment | 2553511978 | 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
// 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.
Signatura
ResultDeleteAttachment deleteAttachment(ParamDeleteAttachment paramDeleteAttachment)
Parámetros de invocación
ParamDeleteAttachment extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
attachmentCsv | String | Identificador CSV del adjunto a eliminar |
invoiceCsv | String | Identificador CSV del borrador |
Parámetros de respuesta
ResultDeleteAttachment extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultDownloadAttachment downloadAttachment(ParamDownloadAttachment paramDownloadAttachment)
Parámetros de invocación
ParamDownloadAttachment extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)
Parámetros de invocación
ParamDownloadAttachments extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
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
// 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.
Signatura
ResultDownloadAttachments downloadAttachments(ParamDownloadAttachments paramDownloadAttachments)
Parámetros de invocación
ParamSearchAttachments extends 2553511978 | ||
---|---|---|
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
attachmentList | List<2553511978> | 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
// 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
Se ha eliminado la versión 1 de los servicios.
Método verifySign
Verifica la firma de la factura indicada.
Signatura
ResultVerifySign verifySign(ParamVerifySign paramVerifySign) throws RestException
Parámetros de invocación
ParamVerifySign extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
csv | String | Identificador CSV de la factura de la que comprobar su firma |
Parámetros de respuesta
ResultVerifySign extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
cert | 2553511978[] | Array con las CAs válidas |
CertBean | ||
---|---|---|
Nombre | Tipo | Descripción |
issuer | String | Emisor |
serialNumber | String | Número de serie del certificado |
idNonRepudiation | String | ID |
elements | 2553511978[] | Pares de clave (valor con información adicional) |
status | Integer | Estado |
caChain | 2553511978[] | Cadena de CAs |
validFrom | Calendar | Fecha comienzo de validez |
validTo | Calendar | Fecha fin de validez |
signDate | Calendar | Fecha de la firma |
DataBean | ||
---|---|---|
Nombre | Tipo | Descripción |
name | String | Nombre de la propiedad |
value | String | Valor de la propiedad |
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
// Rellenamos los parametros ParamVerifySign paramVerifySign = new ParamVerifySign(); paramVerifySign.setApplicationId("SFE"); paramVerifySign.setCsv("INVOICE_CSV"); // Lanzamos la llamada ResultVerifySign resultVerifySign = signServiceImpl.verifySign(paramVerifySign);
Servicios de campos a prevalidar en SERPA
ISerpaXPathServicePortType
Método listAllSerpaXPath
Obtiene todos los campos a prevalidar en SERPA, con sus expresiones xpath.
Signatura
ResultListAllSerpaXPath listAllSerpaXPath(ParamListAllSerpaXPath paramListAllSerpaXPath)
Parámetros de invocación
ParamListAllSerpaXPath extends 2553511978 | ||
---|---|---|
No hay variables |
Parámetros de respuesta
ResultListAllSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
serpaXPathList | List<2553511978> | Lista de nombres y expresiones xPath de los campos |
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
// 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.
Signatura
ResultCreateSerpaXPath createSerpaXPath(ParamCreateSerpaXPath paramCreateSerpaXPath)
Parámetros de invocación
ParamCreateSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
serpaXPath | 2553511978 | Nombre y expresión xPath del campo |
Parámetros de respuesta
ResultCreateSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
serpaXPath | 2553511978 | 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
// 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.
Signatura
ResultUpdateSerpaXPath updateSerpaXPath(ParamUpdateSerpaXPath paramUpdateSerpaXPath)
Parámetros de invocación
ParamUpdateSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
serpaXPath | 2553511978 | Nombre y expresión xPath del campo |
Parámetros de respuesta
ResultUpdateSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
serpaXPath | 2553511978 | 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
// 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.
Signatura
ResultDeleteSerpaXPath deleteSerpaXPath(ParamDeleteSerpaXPath paramDeleteSerpaXPath)
Parámetros de invocación
ParamDeleteSerpaXPath extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
field | String | Nombre del campo a eliminar |
Parámetros de respuesta
ResultDeleteSerpaXPath extends 2553511978 | ||
---|---|---|
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
// 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
Método conformInvoices
Envía un documento de conformidad de facturas.
Signatura
ResultConformInvoices conformInvoices(ParamConformInvoices paramConformInvoices) throws Exception
Parámetros de invocación
ParamConformInvoices extends 2553511978 | ||
---|---|---|
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 | 2553511978 | Array con el listado de facturas a conformar y su estados |
ArrayOfParamConformInvoices | ||
---|---|---|
Nombre | Tipo | Descripción |
invoiceList | List<2553511978> | Listado de csv del listado de facturas que contiene el documento de conformidad |
InvoiceList | ||
---|---|---|
Nombre | Tipo | Descripción |
csv | String | Listado de csv de facturas a conformar |
Parámetros de respuesta
ResultConformInvoices extends 2553511978 |
---|
Códigos error
No hay códigos de error
Ejemplo de invocación
// 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.
Signatura
ResultStateConformInvoices stateConformInvoices(ParamStateConformInvoices paramStateConformInvoices) throws Exception
Parámetros de invocación
ParamStateConformInvoices extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
arrayOfParamConformInvoices | 2553511978 | Array con el listado de facturas a conformar y su estados |
Parámetros de respuesta
ResultStateConformInvoices extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
arrayConformInvoices | 2553511978 | Array con el listado de facturas a conformar y su estados |
ArrayOfParamStateConformInvoices | ||
---|---|---|
Nombre | Tipo | Descripción |
conformDocumentList | List<2553511978> | Array con el listado de facturas a conformar y su estados |
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
// 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.
Signatura
ResultObtainNewInvoices obtainNewInvoices(ParamObtainNewInvoices paramObtainNewInvoices)
Parámetros de invocación
ParamObtainNewInvoices extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
downloadType | String | Tipo de descarga de factura |
invoiceList | List<SRCFFactura> | Listado de facturas |
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 2553511978 | ||
---|---|---|
No hay variables |
Códigos error
No hay códigos de error
Ejemplo de invocación
// Rellenamos los parametros ParamObtainNewInvoices paramObtainNewInvoices = new ParamObtainNewInvoices(); paramObtainNewInvoices.setDownloadType("auto"); // Lanzamos la llamada ResultObtainNewInvoices resultObtainNewInvoices = faceServiceImpl.obtainNewInvoices(paramObtainNewInvoices);
Servicios para el organismo DIR3
IOrganismDir3ServicePortType
Método obtainNewInvoices
Obtiene un listado de organismos DIR3.
Signatura
ResultSearchOrganismsDir3 searchOrganismsDir3(ParamSearchOrganismsDir3 paramSearchOrganismsDir3)
Parámetros de invocación
ParamSearchOrganismsDir3 extends 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
searchOrganismsDir3 | 2553511978 | Criterios de búsqueda de los borradores |
SearchOrganismDir3WS | ||
---|---|---|
Nombre | Tipo | Descripción |
distinctColumn | String | Columnas para el distinct |
params | 2553511978 | Parámetros de búsqueda |
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 2553511978 | ||
---|---|---|
Nombre | Tipo | Descripción |
organismDir3List | List<OrganismDir3WS> | Lista de organismos |
size | int | Número de organismos que cumplen los criterios de búsqueda |
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
// Rellenamos los parametros ParamSearchOrganismsDir3 paramSearchOrganismsDir3 = new ParamSearchOrganismsDir3(); paramSearchOrganismsDir3.setSearchOrganismsDir3(new SearchOrganismDir3WS()); // Lanzamos la llamada ResultSearchOrganismsDir3 resultSearchOrganismsdir3 = organismDir3AccessWS.searchOrganismsDir3(paramSearchOrganismsDir3);
Servicios para SERPA
SerpaSRCFWebServiceProxyPortImplPortType
Método cambiarEstadoFactura
Cambia el estado de una factura
Signatura
SRCFFacturaCambioEstado cambiarEstadoFactura(ParamCambiarEstadoFactura paramCambiarEstadoFactura)
Parámetros de invocación
ParamCambiarEstadoFactura extends 2553511978 | ||
---|---|---|
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
// 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.
Signatura
SRCFFacturaConfirmacionDescarga confirmarDescargaFactura(ParamConfirmarDescargaFactura paramConfirmarDescargaFactura)
Parámetros de invocación
ParamConfirmarDescargaFactura extends 2553511978 | ||
---|---|---|
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
// 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
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
// 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
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
// Rellenamos los parametros ParamConsultarUnidades param = new ParamConsultarUnidades(); param.setApplicationId("SERPA"); //Invocamos al servicio SRCFOrganosGestoresUnidadesTramitadoras consultarUnidades= serpaSRCFWS.consultarUnidades(param);
Método descargarFactura
Permite descargar factura
Signatura
SRCFFacturaCompleta descargarFactura(ParamDescargarFactura paramDescargarFactura)
Parámetros de invocación
ParamDescargarFactura extends 2553511978 | ||
---|---|---|
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
// 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
Signatura
SRCFFacturaGestionAnulacion gestionarSolicitudAnulacionFactura(ParamGestionarSolicitudAnulacionFactura paramGestionarSolicitudAnulacionFactura)
Parámetros de invocación
ParamGestionarSolicitudAnulacionFactura extends 2553511978 | ||
---|---|---|
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
// 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
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
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 |