Sistema efactura Normas de uso del formato UBLEU 1.0 para Sistema efactura 2.1. Definición de etiquetas v1.1

Transcripción

1 Sistema efactura Normas de uso del formato UBLEU 1.0 para Sistema efactura 2.1 Definición de etiquetas v1.1 Octubre de 2007

2 DOCUMENTO/ARCHIVO Título: DOC-eur-EFC- NormasUsoFormatoUBL10EU.doc Nombre Archivo/s Fecha: Versión: 1.1 Asunto/Detalle: Soporte lógico Localización: REGISTRO DE CAMBIOS Versión Páginas Fecha Modificación Cambios realizados Documento Inicial, basado en DOC-eur-EFC-NormasUsoFormatoUBL Actualización AdditionalDocumentReference, cbc:note. 2/37

3 Tabla de contenido Sistema efactura. 1 OBJETIVO NORMAS DE USO TAG INVOICE ID cbc:copyindicator GUID cbc:issuedate InvoiceTypeCode cbc:note TaxPointDate InvoiceCurrencyCode TaxCurrencyCode PricingCurrencyCode LineItemCountNumeric cac:orderreference DespatchDocumentReference ReceiptDocumentReference AdditionalDocumentReference cac:buyerparty cac:sellerparty cac:delivery cac:paymentmeans cac:paymentterms cac:factoringassignmentdata cac:confirmingassignmentdata cac:allowancecharge cac:exchangerate cac:taxtotal cac:legaltotal cac:invoiceline TAG PARTY TAG CAC:ALLOWENCECHARGE TAG CAC:TAXTOTAL TAG CAC:INVOICELINE DATOS EDI POSICIONES DE PEDIDO A NIVEL DE POSICIÓN DE LÍNEA DE FACTURA APÉNDICE CÓDIGOS DE MEDIOS DE PAGO SOPORTADOS CÓDIGOS DE MONEDA SOPORTADOS CÓDIGOS DE PAÍSES SOPORTADOS CÓDIGOS DE MOTIVO DE RECTIFICACIÓN /37

4 1 Objetivo El objetivo de este documento es describir las normas de uso que deberán seguirse a la hora de almacenar la información de una factura en un fichero XML en formato UBL 1.0 (Sistema efactura Factoring y Conforming) para que pueda importarse en la plataforma de facturación electrónica de diversas entidades financieras mediante el Sistema efactura, en ningún caso pretende ser una explicación extensiva del formato UBLEU para lo cual será necesario remitirse a la documentación específica. La especificación UBLEU se basa en XML y define todos los tipos de datos necesarios, así como las estructuras predefinidas requeridas para los distintos modelos de documentos comerciales existentes. Por ello será necesario y se toma como requisito el estar familiarizado con esta tecnología. En este caso se trata de documentos XML definidos en múltiples espacios de nombres, de esta forma un determinado tag se define por su espacio de nombre seguido de dos puntos seguido del nombre del tag. El formato de factura UBLEU es realmente extenso, permite especificar adecuadamente gran cantidad de información. En este documento solo se trata aquella información que sea necesaria para importar un documento de este formato. En cualquier caso será imprescindible contar con la última versión publicada de Especificación del modelo de documento de Factura según estándar UBLEU 1.0. También será imprescindible contar con la propia definición del estándar, y una aplicación que permita validar y editar archivos de tipo xml. Al tratarse de un formato tan amplio resulta inabordable sin contar con las herramientas apropiadas. 4/37

5 2 Normas de uso Como ya se ha dicho el formato UBLEU está basado en el uso de un documento XML para presentar todos los datos de forma jerárquica. El formato especifica que para en un archivo se especifique toda la información de una y solo una factura. Como dicha representación se basa en XML debe existir un único tag que engloba a todos los demás será, dicha etiqueta es Invoice. <Invoice>... </Invoice> 5/37

6 2.1 Tag Invoice A continuación se incluye la lista de tag que son hijos inmediatos de <Invoice> en cada uno de ellos se indica si es obligatorio o no para que el documento sea correcto, si es un elemento repetible y si es gestionado de alguna manera por Sistema efactura, así como una pequeña explicación de la información que almacenan ID Obligatorio. Identificador de factura, serie de la factura + número de factura cbc:copyindicator No obligatorio. No gestionado por Sistema efactura. Indica si el documento es una copia o un original. Es un valor Booleano: True/False GUID Obligatorio. Siglas de Globally Unique IDentifier. Identificador único que distinguirá el documento de forma única en cualquier sistema. Puede ser el resultado de una construcción basada en un código de proveedor más serie de factura más número de factura o una estructura similar cbc:issuedate No obligatorio. Fecha de emisión del documento. El tipo DateType se corresponde con el tipo Date de XML por lo que el formato deberá ser yyyy-mm-dd InvoiceTypeCode Obligatorio. Tipo de factura. Contiene un valor numérico que define el tipo de factura. A continuación se especifican dos posibles valores: 380 : Factura comercial (el emisor es el proveedor) 389 : Autofactura (El emisor es el pagador) 384 : Factura rectificativa cbc:note Obligatorio. En esta etiqueta se recoge el concepto de la factura. El sistema efactura también utiliza este campo para expresar el motivo de rectificación de una factura, cuando el documento corresponde a una factura rectificativa. Cuando se trata del motivo de rectificación Otros (99) se debe especificar el motivo de rectificación, este se almacena en esta misma etiqueta separada del código mediante una almohadilla # TaxPointDate 6/37

7 Obligatorio. Fecha que identifica el momento de pago de la factura o la fecha de emisión. Lo que ocurra primero. Se identifica con la fecha de devengo asociada a la factura InvoiceCurrencyCode Obligatorio. Código de moneda empleada genéricamente en la factura. Los códigos se especifican en un archivo de tipo CodeList incluido en los esquemas UBLEU TaxCurrencyCode No obligatorio. No gestionado por Sistema efactura. Código de moneda para los impuestos. Deberá coincidir con el valor del elemento InvoiceCurrencyCode PricingCurrencyCode No obligatorio. No gestionado por Sistema efactura. Código de moneda para tasaciones (definición de precios). Deberá coincidir con el InvoiceCurrencyCode y con el TaxCurrencyCode LineItemCountNumeric No obligatorio. Número de líneas de factura. Es un tipo Quantity, por lo que se debe especificar la unidad de medida (en este caso líneas de detalle) y la cantidad de unidades cac:orderreference No obligatorio. No gestionado por Sistema efactura. Repetible. Referencia a la hoja de pedido. Puede existir un único documento de factura que haga referencia a múltiples pedidos por lo que el número de elementos de este tipo es ilimitado. Tipo complejo. 7/37

8 DespatchDocumentReference No obligatorio. Repetible. No gestionado por Sistema efactura. Referencia al albarán de entrega de mercancías o de prestación de servicios. Puede existir un único documento de factura que haga referencia a múltiples albaranes por lo que el número de elementos de este tipo es ilimitado. Tipo complejo ReceiptDocumentReference No obligatorio. Repetible. No gestionado por Sistema efactura. Referencia al recibo o recibos asociados a la factura. Puede existir un único documento de factura relacionado con múltiples recibos por lo que el número de elementos de este tipo es ilimitado. Tipo complejo. 8/37

9 AdditionalDocumentReference No obligatorio. Repetible. Referencia a cualquier otro documento asociado a la factura que no sea pedido, albarán o recibo. Puede existir un único documento de factura relacionado con múltiples documentos externos de distintos tipos, por lo que el número de elementos de este tipo es ilimitado. Tipo complejo. Tiene dos funciones: ID: El sistema efactura utiliza esta etiqueta cuando se trata de una factura rectificativa y sirve para especificar la serie completa de una factura rectificada. ID: El sistema efactura utiliza esta etiqueta cuando se trata de una factura emitida para imprimir y sirve para especificar el código localizador de dicha factura. Para poder diferenciar si la etiqueta ID corresponde con la serie completa de una factura rectificada o un código localizador, se utiliza el atributo identificationschemeid con los valores codigorectificada y codigolocalizador según el caso cac:buyerparty Obligatorio. Estructura de datos del receptor de la factura o comprador. Tipo complejo basado en un elemento Party que se especificará más adelante. NOTA: Al contrario que en versiones anteriores de UBLEU Invoice, en el formato UBLEU 1.0 no existe el rol de pagador (PayerParty), por lo que en el Sistema efactura se asume que el pagador coincide con el comprador (BuyerParty). 9/37

10 BuyerAssignedAccountID: Obligatorio. Indica el número de referencia de los datos EDI. SellerAssignedAccountID: Obligatorio. Indica la delegación. AdditionalAccountID: Opcional. Indica el código EDI. Party: Tipo complejo que se especificará más adelante cac:sellerparty Obligatorio. Estructura de datos del proveedor emisor de la factura o vendedor. Tipo complejo basado en un elemento Party que se especificará más adelante. BuyerAssignedAccountID: Obligatorio. Indica el número de referencia de los datos EDI. SellerAssignedAccountID: Obligatorio. Indica la delegación. AdditionalAccountID: Opcional. Indica el código EDI. Party: Tipo complejo que se especificará más adelante. ShippingContact: No gestionado por Sistema efactura. AccountsContact: No gestionado por Sistema efactura. OrderContact: No gestionado por Sistema efactura. 10/37

11 cac:delivery No obligatorio. Repetible. No gestionado por Sistema efactura. Elemento que informa de la entrega de las mercancías facturadas. Tipo complejo. 11/37

12 cac:paymentmeans No obligatorio. Repetible. Elemento que contiene toda la información acerca de la forma de pago de la factura. Tipo complejo. Contiene los siguientes datos: Actualmente en el Sistema efactura se pueden especificar varios vencimientos del pago, es decir, se puede expresar que una factura debe ser pagada en varios plazos, para ello hay que incluir tantos tags PaymentMeans como vencimientos se quieran expresar. 12/37

13 A continuación se detalla la información recogida en cada uno de los tags. Los tags no recogidos no son utilizados por la plataforma: PaymentMeansCode: Obligatorio. Código que identifica el medio de pago. Ver apéndice. DuePaymentDate: Fecha de vencimiento (yyyy-mm-dd). PayerFinancialAccount: Obligatorio y excluye PayeeFinancialAccount. Datos sobre la cuenta de cargo. Sólo es obligatorio si la forma de pago implica una transacción de tipo cobro, es decir, si el medio de pago es recibo domiciliado. PayeeFinancialAccount: Obligatorio y excluye PayerFinancialAccount. Datos sobre la cuenta de abono. Sólo es obligatorio si la forma de pago implica una transacción de tipo pago, es decir, si el medio de pago es transferencia, efecto con vencimiento, efecto, pagaré, cheque o pago domiciliado. Tanto PayerFinancialAccount como PayeeFinancialAccount son tipos complejos que se componen de los siguientes elementos: o ID: Obligatorio, si existe. Numero de la Cuenta de Cargo o de Abono según corresponda. o Name: No obligatorio. No gestionado por Sistema efactura. El nombre o alias de la cuenta. o AccountTypeCode: No obligatorio. No gestionado por Sistema efactura. Tipo de cuenta. o CurrencyCode: No obligatorio. Código de la moneda preferida o aceptada por la cuenta. Ver apéndice. o FinancialInstitutionBranch: No obligatorio. No gestionado por Sistema efactura. Tipo complejo, que indica datos acerca de la entidad financiera que custodia la cuenta. o Country: No obligatorio. Tipo complejo: IdentificationCode: Obligatorio. Código del país donde reside la cuenta. Ver apéndice. Name: No es obligatorio. Descripción del país. PayerFinancialAccount tiene dos tags característicos. o o cac:payername: Obligatorio. El nombre del beneficiario de la cuenta. cac:payeraddress: Obligatorio. Dirección del beneficiario de la cuenta. Y por supuesto PayeeFinancialAccount tiene sus correspondientes. o cac:payeename: Obligatorio. El nombre del beneficiario de la cuenta. o cac:payeeaddress: Obligatorio. Dirección del beneficiario de la cuenta. Payment: Obligatorio. Datos del importe a pagar. o ID: Obligatorio. Número que identifica y ordena cada vencimiento. o PaidAmount: Obligatorio. Importe de la fracción correspondiente. La suma de todas las fracciones debe ser igual al importe total de la factura después de impuestos y descuentos. o ReceivedDate: No obligatorio. No gestionado por Sistema efactura. Fecha en la que se espera recibir el pago, se diferencia de DuePaymentDate en que esta fecha es recomendable y DuePaymentDate es la fecha límite, su incumplimiento puede implicar penalizaciones. 13/37

14 Los siguientes tags son comunes para todos los vencimientos, por lo tanto, sólo es necesario especificarlos en el primer vencimiento: Ref12: No obligatorio. Datos sobre la referencia 12 del pago, máximo 12 caracteres. Ref16: No obligatorio. Datos sobre la referencia 16 del pago, máximo 16 caracteres. Comments1: No obligatorio. Comentarios libres sobre el pago, el sistema permite buscar por este campo, máximo 100 caracteres. Comments2: No obligatorio. Comentarios libres sobre el pago, el sistema no permite buscar por este campo. No tiene longitud definida. Un ejemplo de forma de pago por transferencia en dos plazos el primero por 1000 para el día 15 de Abril de 2007 y el segundo por 508 para el día 15 de Mayo de 2007: <cac:paymentmeans> <cac:paymentmeanscode>4</cac:paymentmeanscode> <cbc:duepaymentdate> </cbc:duepaymentdate> <cac:payeefinancialaccount> <cac:id>*** ***67</cac:id> <cac:currencycode>eur</cac:currencycode> <cac:country> <cac:identificationcode codelistagencyid="iso" listid="3166-1">es</cac:identificationcode> </cac:country> <cbc:name>spain</cbc:name> <cbc:payeename>nombre</cbc:payeename> <cbc:payeeaddress>dirección sergio</cbc:payeeaddress> </cac:payeefinancialaccount> <cac:payment> <cac:id>1</cac:id> <cbc:paidamount amountcurrencyid="eur"> </cbc:PaidAmount> </cac:payment> <cac:ref12>texto Ref12</cac:Ref12> 14/37

15 <cac:ref16>texto de Ref16</cac:Ref16> <cac:comments1>texto de Observaciones 1</cac:Comments1> <cac:comments2>texto de Observaciones 2</cac:Comments2> </cac:paymentmeans> <cac:paymentmeans> <cac:paymentmeanscode>4</cac:paymentmeanscode> <cbc:duepaymentdate> </cbc:duepaymentdate> <cac:payeefinancialaccount> <cac:id>***** ***</cac:id> <cac:currencycode>eur</cac:currencycode> <cac:country> <cac:identificationcode codelistagencyid="iso" listid="3166-1">es</cac:identificationcode> </cac:country> <cbc:name>spain</cbc:name> <cbc:payeename>sergio</cbc:payeename> <cbc:payeeaddress>dirección sergio</cbc:payeeaddress> </cac:payeefinancialaccount> <cac:payment> <cac:id>2</cac:id> <cbc:paidamount> </cbc:paidamount> </cac:payment> </cac:paymentmeans> 15/37

16 cac:paymentterms No obligatorio. Repetible. No gestionado por Sistema efactura. Elemento que informa de los descuentos y penalizaciones en función de los pagos cac:factoringassignmentdata No obligatorio. Elemento que contiene los datos de cesión a Factoring de la factura. Tipo complejo. Contiene los siguientes datos: ID: Obligatorio. Número de la cuenta de cargo/abono. FinancialInstitution: Obligatorio. Datos de la entidad financiera cesionaria de los derechos de cobro de la factura. o ID: Obligatorio. CIF de la entidad financiera. o o Name: Obligatorio. Nombre de la entidad financiera Address: Obligatorio. Dirección de la entidad financiera. Tipo complejo. Son obligatorios los mismos campos que en el resto de nodos de tipo Address: CityName: Obligatorio. Localidad. PostalZone: Obligatorio. Código postal. CountrySubentity: Obligatorio. Provincia. AddressLine: Obligatorio. Dirección de la entidad financiera. Line: Obligatorio. Calle, número y portal. Country: Obligatorio. Identificación del país. Id: Obligatorio. Código del país. Ver apéndice. Name: No obligatorio. Nombre del país. FactoringCessionText: Obligatorio. Texto que cede los derechos del cobro de la factura a la entidad cesionaria. 16/37

17 Un ejemplo de factoring cedido a una entidad financiera X: <cac:factoringassignmentdata> <cac:id>**** </cac:id> <cac:financialinstitution> <cac:address> <cac:id>axxxxxx</cac:id> <cbc:name>xxxxx</cbc:name> <cbc:cityname>madrid</cbc:cityname> <cbc:postalzone>28046</cbc:postalzone> <cbc:countrysubentity>madrid</cbc:countrysubentity> <cac:addressline> <cbc:line>paseo de la Castellana, 29</cbc:Line> </cac:addressline> <cac:country> <cac:identificationcode codelistagencyid="iso" listid="3166-1">es</cac:identificationcode> </cac:country> </cac:address> </cac:financialinstitution> <cac:factoringcessiontext> <cbc:name>es</cbc:name> Cedo el cobro de esta factura a xxxx </cac:factoringcessiontext> </cac:factoringassignmentdata> 17/37

18 cac:confirmingassignmentdata No obligatorio. Elemento que contiene los datos de Confirming de la factura. Tipo complejo. Contiene los siguientes datos: PaymentMeansCode: Obligatorio. Código que identifica la forma de pago. Sólo se acepta: Transferencia, Cheque o Pago domiciliado. Ver apéndice. ID: Obligatorio. Número de la cuenta de cargo/abono. FinancialInstitution: Obligatorio. Datos de la entidad encargada del cobro o pago de la factura. o ID: Obligatorio. CIF de la entidad. o Name: Obligatorio. Nombre de la entidad. o Address: No obligatorio. Tipo complejo. No tratado por Sistema efactura. DuePaymentDate: Obligatorio. Fecha límite del pago. Un ejemplo de confirming contratado con una entidad X: <cac:confirmingassignmentdata> <cac:paymentmeanscode>0</cac:paymentmeanscode> <cac:id>**** ***</cac:id> <cac:financialinstitution> <cac:id>axxxxxxx</cac:id> <cbc:name>xxx</cbc:name> </cac:financialinstitution> <cbc:duepaymentdate> </cbc:duepaymentdate> <cac:factoringcessiontext> Cedo el cobro de esta factura a xxxx </cac:factoringcessiontext> 18/37

19 </cac:confirmingassignmentdata> cac:allowancecharge No obligatorio. Repetible. Elemento que informa acerca de un cargo o descuento sobre el total de la factura. Se trata de un tipo complejo que se explica con detalle más adelante cac:exchangerate No obligatorio. Repetible. No gestionado por Sistema efactura. Elemento que define la tarifa de cambio monetario cac:taxtotal Obligatorio. Elemento que informa del total y subtotal de importes derivados de impuestos. Se trata de un tipo complejo que se explica con detalle más adelante. Coincide con el resumen de tasas y en Sistema efactura se calcula a partir de la información de las líneas cac:legaltotal No obligatorio. No validado por Sistema efactura. Elemento que contiene la información de los totales absolutos del documento. LineExtensionTotalAmount: Se corresponde con la base imponible total (Importe neto - descuentos antes de impuestos ) TaxExclusiveTotalAmount: Se corresponde con el importe neto (Bruto - descuentos de línea) TaxInclusiveTotalAmount: Se corresponde con el total (Base imponible total + impuestos - descuentos después de impuestos) cac:invoiceline Elemento que contiene toda la información de una línea, se repite tantas veces como líneas tiene la factura. Se trata de un tipo complejo que se explica con detalle más adelante. 19/37

20 2.2 Tag Party Tanto el proveedor como el comprador se definen mediante una estructura más compleja de la que el único elemento obligatorio es un tag Party. El resto de información no obligatoria no es gestionada por Sistema efactura. cbc:markcareindicator: Tipo booleano. Indica si el Party ha de ser referenciado como Por cuenta de. Información no obligatoria no gestionada por Sistema efactura. cbc:markattentionindicator: Tipo booleano. Indica si el Party ha de ser referenciado como A la atención de. Información no obligatoria no gestionada por Sistema efactura. PartyIdentification: Elemento de tipo ID identificador. Representa el código de la parte entidad. Puede identificarse con el CIF o NIF o con algún código de los sistemas del proveedor o comprador. En el caso de trabajar con Puntos Operacionales se debe indicar en este campo el Punto Operacional Lógico. Se permiten varios IDs para este nodo, soportando el sistema los siguientes: o o <cac:id identificationschemename="cif"> para indicar el NIF del Party. <cac:id identificationschemename="icf"> para indicar el código de factura EDI en el caso de querer emplear uno distinto al de Invoice/ID e Invoice/GUID. PartyName: Nombre de la parte o entidad. Elemento de tipo Name. Obligatorio. Address: Datos de la dirección de la parte o entidad. Tipo complejo descrito a continuación. PartyTaxScheme: Datos fiscales asociados a la parte o entidad. La inscripción del registro mercantil debe colocarse en la etiqueta RegistrationName de este nodo, tal y como se indica en el siguiente ejemplo: <cac:partytaxscheme> <cbc:registrationname>eurobits Technologies. S.L. Tomo: , Libro: 0, Folio: 167, Sección: 8, Hoja: M </cbc:RegistrationName> <cac:taxscheme/> </cac:partytaxscheme> 20/37

21 Nota: Para las facturas del tipo Factura Comercial (380) es obligatorio la etiqueta RegistrationName en el caso del SellerParty (proveedor). Contact: Elemento de tipo Contact, contiene información acerca de la persona de contacto. Tipo complejo descrito a continuación. Language: Idioma de trato con la parte o entidad. Tipo complejo descrito a continuación. Para definir la entidad de forma que se pueda importar correctamente es necesario completar una serie de datos dentro de esta estructura que si bien en el formato UBLEU no son obligatorios si lo serán para poder importar una factura correctamente en la plataforma de Factura electrónica. Tales datos serán: - NIF/CIF: Tag PartyIdentification/ID con atributo identificationschemename="cif". - Nombre: Tag PartyName/Name - Dirección: Tag Address/AddressLine/Line - C.P: Tag Address/PostalZone - Población: Tag Address/CityName - Provincia: Tag Address/CountrySubentity - País: Tag Address/Country/Name - Nombre del contacto: Tag Contact/Name - Teléfono del contacto: Tag Contact/Telephone - Fax del contacto: Tag Contact/Telefax - del contacto: Tag Contact/ElectronicMail - Departamento del contacto: Tag Address/Department Un ejemplo de Party para los datos del comprador sería: <cac:buyerparty> <cac:party> <cac:partyidentification> <cac:id identificationschemename="cif"> y</cac:id> </cac:partyidentification> <cac:partyname> <cbc:name>nombre</cbc:name> </cac:partyname> <cac:address> <cbc:department>departamento</cbc:department> <cbc:cityname>ciudad</cbc:cityname> <cbc:postalzone>99999</cbc:postalzone> <cbc:countrysubentity>provincia</cbc:countrysubentity> <cac:addressline> <cbc:line>dirección</cbc:line> </cac:addressline> <cac:country> <cac:identificationcode codelistagencyid="iso" listid="3166-1">es</cac:identificationcode> <cbc:name>es</cbc:name> </cac:country> </cac:address> <cac:contact> <cbc:name>nombre contacto</cbc:name> <cbc:telephone> </cbc:telephone> 21/37

22 <cbc:telefax> </cbc:telefax> </cac:contact> <cac:language> <cac:id>es</cac:id> </cac:language> </cac:party> </cac:buyerparty> Como se puede ver para especificar el departamento de la persona de contacto es necesario incluirla en el campo Department del tag Address. La dirección del comprador/pagador/proveedor puede ir bien en los campos separados para la dirección: <cbc:streetname>rambla</cbc:streetname> <cbc:buildingnumber>s/n</cbc:buildingnumber> o puede incluirse en una sola línea: <cac:addressline> <cbc:line>rambla s/n</cbc:line> </cac:addressline> Es preferible el segundo método respecto al primero para especificar la dirección, es necesario que esté en uno o en otro pero no en ambos sitios. En cualquier caso, al exportar la factura siempre se especificará la dirección en un tag AddressLine. 22/37

23 2.3 Tag cac:allowencecharge Los descuentos y cargos antes y después de tasas al igual que los descuentos de línea se especifican en tags de este tipo. ID: Obligatorio. Identificador del tipo de descuento o cargo. Ver los posibles valores más adelante. ChargeIndicator: Obligatorio. Indicador booleano de si es un cargo (True) o descuento (False). ReasonCode: Motivo para la aplicación del descuento o cargo. MultiplierFactorNumeric: Factor de multiplicación aplicable al importe al que se refiere el elemento para calcular el cargo o descuento. CurrencyCode: Moneda del cargo o descuento según se define en el estándar ISO4217. PrepaidIndicator: Indicador booleano de si el cargo o descuento se aplica sobre un prepago (True) o sobre el total (False). SequenceNumeric: Obligatorio. Secuencia de aplicación del descuento o cargo sobre el importe al que se refiere. Si se debe aplicar sobre el importe neto sin cargas ni descuentos el valor deberá ser 1. De no ser así, el descuento o cargo se aplicará sobre el importe tras haber aplicado los descuentos o cargos anteriores en la secuencia. Amount: Cantidad que supone el descuento (en la unidad monetaria correspondiente). No obligatorio. Únicamente debe incluirse si se desea dar de alta el descuento por importe. TaxCategory: Categoría de impuestos aplicados al descuento o cargo. Tipo complejo. Se detalla a continuación. PaymentMeans: Medios de pagos asociados al descuento o cargo. 23/37

24 Según la especificación <cbc:chargeindicator>false</cbc:chargeindicator> es un descuento y <cbc:chargeindicator>true</cbc:chargeindicator> es un cargo. El que se trate de un descuento/cargo antes de tasas o un descuento de línea, debe indicarse con el tag PrepaidIndicator a valor false, además del tipo, el porcentaje y el número de secuencia. El que se trate de un descuento/cargo después de tasas debe indicarse conl el tag PrepaidIndicator a valor true además del tipo y la cantidad Para especificar el descuento por importe, deberemos incluir el campo Amount. Únicamente debe incluirse este campo en el caso de que queramos incluir el descuento por importe (si aparece este tag, el descuento se considerará como importe). Todos las cantidades porcentuales deben especificarse en base 100 y con dos decimales (si es necesario), las importes se especificarán en parte entera (sin puntos millares) y dos decimales (si es necesario), en ambos casos el separador de parte fraccionaria será el punto. La codificación que siguen los tipos de descuento (AllowanceCharge/ID) es la siguiente (de acuerdo con la normativa UN/ECE 4465 D.04A): Costes Financieros Fletes Montajes Royalties Embalajes Rappel Envases Retornables Seguros Descuento Comercial Descuento Pronto Pago Otros FI FC SH ACQ PC ABH RAD IN TD EAB OTH Un ejemplo de descuento antes de tasas del 12%: <cac:allowancecharge> <cac:id>oth</cac:id> <cbc:chargeindicator>false</cbc:chargeindicator> <cbc:multiplierfactornumeric>0.12</cbc:multiplierfactornumeric> <cbc:prepaidindicator>false</cbc:prepaidindicator> <cbc:sequencenumeric>1</cbc:sequencenumeric> </cac:allowancecharge> 24/37

25 Un ejemplo de descuento después de tasas por importe de 22. Nótese que en este caso se tomará el valor de cbc:amount para internamente recalcular el campo cbc:multiplierfactornumeric: <cac:allowancecharge> <cac:id>oth</cac:id> <cbc:chargeindicator>false</cbc:chargeindicator> <cbc:multiplierfactornumeric>0.22</cbc:multiplierfactornumeric> <cbc:prepaidindicator>true</cbc:prepaidindicator> <cbc:amount>22.00</cbc:amount> </cac:allowancecharge> 2.4 Tag cac:taxtotal El tag TaxTotal es el empleado para mostrar la información relacionada con los impuestos de la línea o de la factura. Aparece a nivel de línea (tasas asociadas a esa línea en concreto) y a nivel de factura (resumen global de tasas). A nivel de factura, las tasas aparecen agrupadas por tipo y porcentaje (por ejemplo, si hay tres líneas con IVA del 16%, aparecerá una única entrada con la suma de los importes del IVA de las tres líneas). 25/37

26 Mostramos a continuación desglosados los elementos que conforman este elemento: TotalTaxAmount: Importe total que supone la aplicación de la tasa. TaxSubTotal:Formado por: o TaxableAmount:Base Imponible sobre la que se aplica la tasa. o TaxAmount:Importe que supone la aplicación de la tasa. o TaxCategory: Formado por: ID:Tipo de tasa. Sigue la codificación expuesta más adelante. Percent:Porcentaje de la tasa (en base 10). ExemptionReason:Razón de exención. Opcional. No tratado por Sistema efactura. TaxScheme: Formado por: ID:Identificador del esquema de tasa. No tratado por Sistema efactura. TaxTypeCode: Tipo de tasa. Debe tener el mismo valor que TaxCategory/ID. Sigue la codificación expuesta más adelante. CurrencyCode:Código de divisa. Opcional. No tratado por Sistema efactura. JurisdictionAddress: Opcional. No tratado por Sistema efactura. Enumeramos a continuación los tipos de tasa aceptados por el Sistema efactura y su codificación (de acuerdo con la normativa UN/ECE 5153 D.04A): IVA Recargo de Equivalencia IGIC Exento Alcoholes ENV IPSI IRPF VAT RET IGI FRE ACT Punto Verde IPS IRP Para el caso del Punto Verde, hay dos posibles tratamientos: Punto Verde incluído en el importe: En este caso, se incorpora el valor ENV en el tag Invoice/InvoiceLine/Item/CommodityClassification/NatureCode Punto Verde desglosado a nivel de línea: En este caso, se incorpora a nivel de línea un nodo TaxCategory similar al empleado para el resto de tasas, pero añadiendo la peculiaridad de que su importe ha de sumarse al neto de línea tal y como especifica la normativa. Al sumarse al neto de línea, esta tasa no aparecerá en el resumen de tasa a nivel de factura. Mostramos a continuación un ejemplo de línea de factura con punto verde del 22%: 26/37

27 <cac:invoiceline> <cac:id>1</cac:id> <cbc:invoicedquantity quantityunitcode="pce"> </cbc:InvoicedQuantity> <cbc:lineextensionamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:LineExtensionAmount> <cac:taxtotal> <cbc:totaltaxamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:TotalTaxAmount> </cac:taxtotal> <cac:item> <cbc:description>1</cbc:description> <cac:sellersitemidentification> <cac:id>1</cac:id> </cac:sellersitemidentification> <cac:taxcategory> <cac:id>vat</cac:id> <cbc:percent>16</cbc:percent> <cac:taxscheme> <cac:taxtypecode>vat</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> <cac:taxcategory> <cac:id>env</cac:id> <cbc:percent>22</cbc:percent> <cac:taxscheme> <cac:taxtypecode>env</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:PriceAmount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> </cac:item> <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3">1.22</cbc:priceamount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> </cac:invoiceline> 27/37

28 2.5 Tag cac:invoiceline Cada una de las líneas de la factura se especifica mediante un tag InvoiceLine. Aquí se especifica la información del producto, los descuentos de línea y la información de pedidos y albaranes (si se precisa). 28/37

29 ID: Obligatorio. Identificador de la línea. LineStatusCode: No obligatorio. Indica el status actual de la línea en referencia a su estado original. InvoicedQuantity: Obligatorio. Cantidad de ítems facturados en esta línea. LineExtensionAmount: Obligatorio. Importe total de la línea, incluida cualquier variación de precio excepto los descuentos o cargos globales del documento y los impuestos. Puede calcularse como BasePrice*Quantity. Note: Texto genérico descriptivo. OrderLineReference: Referencia a la línea del pedido al que se asocia la línea de factura actual o al pedido en sí mismo. Elemento del tipo OrderLineReferenceType. DespatchLineReference: Referencia a la línea del albarán a la que se asocia la línea de factura actual o al albarán en sí mismo. Elemento de tipo LineReferenceType. ReceiptLineReference: Referencia a la línea de recibo a la que se asocia la línea de factura actual. Elemento de tipo LineReferenceType. Igual al anterior. Delivery: Elemento que contiene la información sobre la entrega de los tems acturados en la presente línea. Elemento de tipo DeliveryType. PaymentTerms: Información relativa al modo de pago de la factura. AllowanceCharge: Descuentos o cargos aplicados a los ítems facturados en la línea. TaxTotal: Suma de impuestos del mismo tipo asociados a la línea actual. Puede haber tantos elementos como tipos o categorías de tasa. Ítem: Obligatorio. Elemento que contiene la información relativa al objeto o ítem facturado. Tipo complejo. BasePrice: Precio base de la línea. Tipo complejo. Un ejemplo de línea sería: <cac:invoiceline> <cac:id>1</cac:id> <cbc:invoicedquantity quantityunitcode="pce"> </cbc:InvoicedQuantity> <cbc:lineextensionamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:LineExtensionAmount> <cac:orderlinereference> <cac:orderreference> <cac:guid>ped_001-l002</cac:guid> </cac:orderreference> </cac:orderlinereference> <cac:despatchlinereference> <cac:lineid>1</cac:lineid> <cac:documentreference> <cac:id>232323</cac:id> <cac:guid>232323</cac:guid> </cac:documentreference> </cac:despatchlinereference> <cac:taxtotal> <cbc:totaltaxamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:TotalTaxAmount> </cac:taxtotal> <cac:item> <cbc:description>descripción</cbc:description> <cac:sellersitemidentification> 29/37

30 <cac:id>dfas</cac:id> </cac:sellersitemidentification> <cac:taxcategory> <cac:id>vat</cac:id> <cbc:percent>16</cbc:percent> <cac:taxscheme> <cac:taxtypecode>vat</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> <cac:taxcategory> <cac:id>env</cac:id> <cbc:percent>50</cbc:percent> <cac:taxscheme> <cac:taxtypecode>env</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:PriceAmount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> </cac:item> <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3">1.5</cbc:priceamount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> </cac:invoiceline> En el tag Id se inserta el número de línea. En InvoicedQuantity la cantidad y la unidad (siguiendo la especificación UN/ECE Recommendation Nº20 - Codes for Units of Measure Used in International Trade), y en Note las observaciones de línea (si es necesario). La información de pedidos asociados a esta línea se incluye en OrderLineReference y la de los albaranes en DespatchLineReference. Por ejemplo en el caso de tener que asociar una línea a un pedido sería necesario: Para un albarán: <cac:orderlinereference> <cac:orderreference> <cac:guid>ped_001-l002</cac:guid> </cac:orderreference> </cac:orderlinereference> <cac:despatchlinereference> <cac:lineid>1</cac:lineid> <cac:documentreference> <cac:id>232323</cac:id> <cac:guid>232323</cac:guid> </cac:documentreference> </cac:despatchlinereference> 30/37

31 En caso de que se desee incluir a nivel de línea la referencia a la posición del producto en el pedido, deberemos hacerlo en el campo cac:id de un nodo AdditionalItemIdentification que se añadirá expresamente al producto de la línea (cac:invoceline/item) cuando haya que almacenar dicho campo. Dado que en este formato no existe un campo específico en el que almacenar esta información, se ha decidido emplear este campo para almacenar la posición del pedido a nivel de línea. Los descuentos de línea se especifican igual que los descuentos globales antes de tasas. En cada línea se puede especificar una gran cantidad de datos sobre el producto dentro de un tag Item. Para definir un producto de forma que se pueda importar correctamente es necesario completar una serie de datos obligatorios dentro de la estructura Item para poder trabajar con la plataforma de Factura electrónica. Tales datos serán: - Descripción: Tag Description - Código del producto: Tag SellersItemIdentification / ID - Información de Tasas: TaxCategory ver más adelante - Información de Articulo: BasePrice ver más adelante <cac:item> <cbc:description>paquete 500 folios</cbc:description> <cac:sellersitemidentification> <cac:id> </cac:id> </cac:sellersitemidentification> <cac:taxcategory> <cac:id>vat</cac:id> <cbc:percent>16</cbc:percent> <cac:taxscheme> <cac:taxtypecode>vat</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:priceamount > <cbc:basequantity quantityunitcode="pce"> </cbc:basequantity> </cac:baseprice> </cac:item> Para cada Item se tiene que especificar un elemento BasePrice así: <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3"> </cbc:PriceAmount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> Donde: 31/37

32 BaseQuantity es la cantidad de producto por precio, habitualmente su valor es 1. PriceAmount es el precio antes de aplicar los descuentos de la cantidad de producto expresada en el campo anterior. Se puede calcular como total de la linea antes de descuentos*cantidad de producto por precio/cantidad facturada. Este es el precio del item antes de descuentos y cargos de línea. A partir de aquí se calcula el total de línea antes de descuentos y tasas. (LIS). Aplicando a este precio unitario la serie de descuentos y cargos de línea se obtiene el total de línea después de descuentos (LAAD). Esta información se almacena en un tag BasePrice que es hijo del tag InvoiceLine: donde: <cac:baseprice> <cbc:priceamount amountcurrencyid="eur" amountcurrencycodelistversionid="0.3">1.5</cbc:priceamount> <cbc:basequantity quantityunitcode="pce"> </cbc:BaseQuantity> </cac:baseprice> o o BaseQuantity es la cantidad de producto por precio, habitualmente su valor es 1. PriceAmount es el precio tras aplicar los descuentos de la cantidad de producto expresada en el campo anterior. Se puede calcular como total de la linea despues de descuentos*cantidad de producto por precio/cantidad facturada, es decir laad*uxp/qty. Por último basta aplicar las tasas a dicha línea. Las tasas se almacenan en tag de tipo TaxCategory asociadas al Item. Todas las tasas utilizan como base imponible el total de línea después de descuentos y cargos. <cac:taxcategory> <cac:id>vat</cac:id> <cbc:percent>16</cbc:percent> <cac:taxscheme> <cac:taxtypecode>vat</cac:taxtypecode> </cac:taxscheme> </cac:taxcategory> 32/37

33 2.6 Datos EDI En la plataforma de Facturación electrónica, hay posibilidad de incorporar a la factura los siguientes datos EDI asociados a la misma (indicamos el campo del UBLEU 1.0 donde pueden almacenarse). Respecto a la información del proveedor: Código factura (icf) Invoice/SellerParty/Party/PartyIdentification/ID@ identificationschemename="icf" Código EDI (ec) Invoice/SellerParty/AdditionalAccountID Código propio (sc) Invoice/SellerParty/BuyerAssignedAccountID Número de referencia (cc) Invoice/SellerParty/SellerAssignedAccountID Se recomienda utilizar el código propio, tag Invoice/SellerParty/BuyerAssignedAccountID para recoger la información sobre la delegación del comprador o pagador, si por ejemplo se quiere especificar que área, departamento se hace cargo de la factura. Respecto a la información del pagador: Código factura (icf) Invoice/SellerParty/Party/PartyIdentification/ID@ identificationschemename="icf" Código EDI (ec) Invoice/BuyerParty/AdditionalAccountID Código propio (sc) Invoice/BuyerParty/SellerAssignedAccountID Número de referencia (cc) Invoice/BuyerParty/BuyerAssignedAccountID Se recomienda utilizar el código propio, tag Invoice/BuyerParty/SellerAssignedAccountID para recoger la información sobre la delegación del proveedor, si por ejemplo se quiere especificar a que área, centro, tienda va dirigida la factura. 33/37

34 2.7 Posiciones de pedido a nivel de posición de línea de factura Se almacenará dicha información en el campo cac:id de un nodo AdditionalItemIdentification que se añadirá expresamente al producto de la línea (cac:invoceline/item) cuando haya que almacenar dicho campo. Dado que en este formato no existe un campo específico en el que almacenar esta información, se ha decidido emplear este campo para almacenar la posición del pedido a nivel de línea. La conversión de UBLEU a IDOC asumirá que, en caso de que esta información no venga informada, la posición correspondiente en el pedido coincide con la posición de la línea de factura. Es decir, la línea N de la factura corresponde con la línea N del pedido. 34/37

35 3 Apéndice 3.1 Códigos de medios de pago soportados El valor de la etiqueta ID que identifica el medio de pago debe ser un valor numérico acorde con el estándar: 4461 Payment means code de United Nations Directories for Electronic Data Interchange for Administration, Commerce and Transport (UN/EDIFACT) recomendado por la especificación UBLEU, la especificación completa de esta codificación se puede consultar en: A continuación se enumeran todas las formas de pago soportadas por el Sistema efactura. No tiene forma de pago: -1. Transferencia: 4. Al Contado: 10. Cheque: 20. Pago Domiciliado: 42. Cargo en cuenta: 49. Recibo domiciliado: 49. Pagare: 60. Efecto: 75. Efecto con vencimiento: 75. Es necesario especificar una fecha de vencimiento. Otras formas de pago: ZZZ. 3.2 Códigos de moneda soportados El valor de la etiqueta currency que identifica la moneda empleada debe ser una cadena de texto acorde con el estándar: ISO 4217 Alpha 6 United Nations Economic Commission for Europe Currency 0.3 recomendado por la especificación UBL, la especificación completa puede consultarse en CurrencyCode-1.0.xsd. Actualmente el sistema efactura sólo trabaja con la moneda Euro cuyo código es EUR. 35/37

36 3.3 Códigos de países soportados El valor de la etiqueta ID que identifica el país debe ser una cadena de texto acorde con el estándar: ISO de United Nations Economic Commission for Europe recomendado por la especificación UBL. A continuación se enumeran algunos de los países soportados por el Sistema efactura: Alemania: DE. España: ES. Dinamarca: DK. Italia: IT. Francia: FR. Portugal: PT. Reino Unido: GB. Suiza: CH. Estados Unidos: US. En el siguiente enlace puede consultarse la lista completa países. 3.4 Códigos de motivo de rectificación El sistema efactura también utiliza la etiqueta cbc:note para expresar el motivo de rectificación de una factura, cuando el documento corresponde a una factura rectificativa. A continuación se enumeran todos los motivos de rectificación soportados por el Sistema efactura. Error - Número de la Factura: 1. Error - Serie de la Factura: 2. Error - Fecha Expedición: 3. Error - Nombre y Apellidos/Razón Social - Emisor: 4. Error - Nombre y Apellidos/Razón Social - Receptor: 5. Error - Identificación fiscal Emisor/Obligado: 6. Error - Identificación fiscal Receptor/Destinatario: 7. Error - Domicilio Emisor/Obligado: 8. Error - Domicilio Receptor/Destinatario: 9. Error - Detalle Operación: 10. Error - Porcentaje impositivo a aplicar: 11. Error - Cuota tributaria a aplicar: 12. Error - Fecha/Período a aplicar: 13. Error - Clase de Factura: 14. Error - Literales Legales: 15. Error - Base Imponible: 16. Error - cálculo de cuotas repercutidas: 80. Error - cálculo de cuotas retenidas: 81. Error - Base Imponible modificada por devolución de envases/embalajes: /37

37 Error - Base Imponible modificada por descuentos y bonificaciones: 83. Error - Base Imponible modificada por resolución firme, judicial o administrativa: 84. Error - Base Imponible modificada cuotas repercutidas no satisfechas. Autodeclaración concurso.: 85. Original no cumple los requisitos relativos a su contenido.: 51. Cuotas impositivas repercutidas incorrectas.: 52. Modificación de la base imponible.: 53. Otros: /37