/
4.- Servicios de SFE

4.- Servicios de SFE

28 May 2021

Servicios de facturas

IInvoiceServicePortType

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

 

Método addManualInvoice

Permite añadir una factura de forma manual

Signatura

ResultAddManualInvoice addManualInvoice(ParamAddManualInvoice paramAddManualInvoice)

Parámetros de invocación

ParamAddManualInvoice extends SFE v3.11.0 - Manual de integración#ParamBase

ParamAddManualInvoice extends SFE v3.11.0 - Manual de integración#ParamBase

Nombre

Tipo

Descripción

invoiceData

InvoiceERPWS

Contenido de la factura a añadir

Parámetros de respuesta

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

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

Nombre

Tipo

Descripción

idFace

String

Id de la factura en FACe

Códigos error

Código

Descripción

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

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 SFE v3.11.0 - Manual de integración#ParamBase

ParamGetAllStates extends SFE v3.11.0 - Manual de integración#ParamBase

Nombre

Tipo

Descripción

idsFace

String[]

Array con los Ids de las facturas en FACe

Parámetros de respuesta

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

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

Nombre

Tipo

Descripción

idFace

String

Id de la factura en FACe

stateFace

String

Estado de la factura en FACe

stateSFE

String

Estado de la factura en SFE

oficinaContableFace

String

Oficina contable FACe

oficinaContableSFE

String

Oficina contable SFE

organoGestorFace

String

Órgano gestor FACe

organoGestorSFE

String

Órgano gestor SFE

unidadTramitadoraFace

String

Unidad Tramitadora en FACe

unidadTramitadoraSFE

String

Unidad Tramitadora en SFE

motivo

String

Motivo del estado en FACe

Códigos error

Código

Descripción

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

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 SFE v3.11.0 - Manual de integración#ParamBase

ParamGetInvoice extends SFE v3.11.0 - Manual de integración#ParamBase

Nombre

Tipo

Descripción

idFace

String

Id de la factura en FACe

Parámetros de respuesta

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

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

Nombre

Tipo

Descripción

idFace

String

Id de la factura en FACe

csv

String

Código csv de la factura en SFE

invoiceNumber

String

Número de la factura

invoiceTotal

String

Importe total dela factura

rcfCode

String

Código rcf

receiverCentreCode

String

Código del centro receptor

registerDate

String

Fecha de registro

sellerCorporateName

String

Nombre del emisor

state

String

Estado de la factura en SFE

Códigos error

Código

Descripción

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

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 SFE v3.11.0 - Manual de integración#ParamBase

ParamImportInvoice extends SFE v3.11.0 - Manual de integración#ParamBase

Nombre

Tipo

Descripción

invoiceData

DataHandler

Contenido de la factura a importar

format

String

Formato de la factura

expedient

String

Número de expediente en el que se incluye la factura

attachmentsData

DataHandler

Contenido de los adjuntos a importar

Parámetros de respuesta

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

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

Nombre

Tipo

Descripción

invoice

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

Metadatos de la factura importada

attachmentList

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

Lista de metadatos de los adjuntos importados

invoiceValidationErrorList

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

Lista con los errores de validación

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

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

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

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