## LROE - Envío de facturas recibidas `POST` https://{entorno}.ticketbaiws.eus/lroe-recibidas/ **ATENCIÓN: Este método únicamente es válido para BATUZ Bizkaia.** Permite enviar al LROE de Batuz las facturas recibidas (compras) ### Parámetros - `ejercicio` (integer, obligatorio): Año fiscal del ejercicio del bloque de facturas recibicas en formato yyyy. Ejemplo: `2023` - `facturas` (object array, obligatorio (máx 1000) registros) - `fecha` (string, obligatorio): Fecha de expedición de la factura en formato dd/mm/yyyy. Ejemplo: `13/11/2023` - `fecha_operacion` (string, opcional): Fecha en la que se ha realizado la operación siempre que sea diferente a la fecha de expedición en formato dd/mm/yyyy. Ejemplo: `13/11/2023` - `fecha_recepcion` (string, opcional): Fecha de la recepción de la factura en formato dd/mm/yyyy. Ejemplo: `13/11/2023` - `nif` (string, obligatorio): NIF del emisor de la factura. Ejemplo: `B01000012` - `tipo_documento` (string, opcional): Tipo de documento identificativo para proveedores extranjeros. Por defecto 02. Posibles valores: **02** => NIF-IVA **03** => Pasaporte **04** => Documento oficial de identificación expedido por el país o territorio de residencia, **05** => Certificado de residencia **06** => Otro documento probatorio. Ejemplo: `02` - `pais` (string, opcional): Código 2 letras del país del emisor de la factura si el NIF del proveedor es extranjero (formato ISO-3166 Alpha-2 code) Ejemplo: `ES` - `nombre_social` (string, obligatorio): Nombre social del proveedor que emite la factura. Ejemplo: `Empresa de ejemplo S.L.` - `serie` (string, opcional): Serie de factura. Ejemplo: `A` - `num_factura` (string, obligatorio): Número de factura. Ejemplo: `2023715273` - `descripción` (string, obligatorio): Descripción del servicio/o producto de la factura. Ejemplo: `Factura móviles` - `importacion` (boolean, obligatorio): Es factura de importación. Ejemplo: `false` - `importe_total` (float, obligatorio): Importe total de la factura IVA incluído. Ejemplo: `121.00` - `bases` (object array., obligatorio): Bases imponibles de la factura - `base_imponible` (float, obligatorio): Importe SIN IVA de la base imponible. Ejemplo: `100.00` - `tipo_iva` (float, obligatorio): Porcentaje de IVA aplicado a la base imponible. Ejemplo: `21.00` - `tipo_req` (float, obligatorio): Porcentaje de recargo de equivalencia aplicado a la línea. Ejemplo: `0.00` - `tipo` (enum, opcional (para especificar un valor diferente al global de la factura)): Valores posibles: **compras** (Compra de bienes corrientes) **inversion** (Adquisición de bienes de inversión) **gasto** (Gastos) Ejemplo: `inversion` - `cuota_soportada` (float, opcional): Si no se define, el valor de la cuota soportada se calculará automáticamente. En caso de especificar el valor de la cuota soportada, es necesario especificar asimismo el valor de la cuota deducible. Ejemplo: `21.00` - `cuota_deducible` (float, opcional): Si se define, el parámetro de prorrata no tiene efecto. Parámetro obligatorio si se desea especificar el valor de la cuota soportada. Ejemplo: `10.50` - `epigrafe` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Indica que el concepto va en un epígrafe específico diferente al epígrafe general definido en la ficha de empresa o diferente del definido en la factura. Ejemplo: `197210` - `bien_afecto_irpf_iva` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Identificador que especifica si se trata de una adquisición de un bien afecto al IRPF o de un bien de inversión de IVA. Si no se informa este campo se entenderá que tiene valor «N». Valores posibles: I, R, ó N. Ejemplo: `N` - `importe_gasto_irpf` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Importe del gasto deducible en el IRPF. Ejemplo: `121.00` - `concepto_contable` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Clave que identifica el subgrupo o la cuenta contable. Ejemplo: `600` - `referencia_bien` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Referencia que le corresponde al bien afecto sobre el que puede recaer el gasto al que hace referencia la cuenta contable, debiendo coincidir con la referencia que aparece en el capítulo de bienes afectos o de inversión. Ejemplo: `ABC` - `modo_recargo_simplificado` (integer, opcional únicamente para personas físicas en Bizkaia (LROE 140)): Identificador que especifica si se trata de una factura recibida por un o una contribuyente en régimen simplificado o en régimen de recargo de equivalencia. Si no se informa este campo se entenderá que tiene valor «N». Opciones posibles: E (Recargo equivalencia), N (Régimen general), S (Régimen simplificado) Ejemplo: `E` - `regimen_iva` (integer, opcional): Clave de régimen especial de IVA. Ejemplo: `17` - `regimen_iva_2` (integer, opcional): Clave de régimen especial de IVA 2. Ejemplo: `17` - `regimen_iva_3` (integer, opcional): Clave de régimen especial de IVA 3. Ejemplo: `17` - `inversion_sujeto_pasivo` (boolean, opcional): Factura con inversión de sujeto pasivo. Ejemplo: `false` - `rectificativa` (boolean, obligatorio): Es factura rectificativa. Ejemplo: `false` - `serie_factura_rectificada` (string, opcional): Serie de factura que se está rectificando. Ejemplo: `A` - `num_factura_rectificada` (string, obligatorio si rectificativa): Número de factura que se está rectificando. Ejemplo: `2023000100` - `fecha_rectificada` (string, obligatorio si rectificativa): Fecha de la factura que se está rectificando en formato dd/mm/yyyy. Ejemplo: `13/11/2023` - `clave_rectificativa` (string, opcional): Clave de la factura rectificativa (R1, R2, R3, R4, R5). Si no se define se cogerá la R1 ó la R5 si es simplificada. Ejemplo: `R1` - `tipo_rectificativa` (string, opcional): Tipo de factura rectificativa: (S)ustitutiva (I) por diferencias. Si no se define se interpretará como**I (por diferencias)**. Ejemplo: `I` - `base_rectificada` (float, obligatorio si rectificativa): Base de la factura que se está rectificando. Ejemplo: `100.00` - `cuota_rectificada` (float, obligatorio si rectificativa): Cuota de IVA de la factura que se está rectificando. Ejemplo: `21.00` - `prorrata` (integer, opcional): Porcentaje del importe deducible de la factura. Ejemplo: `92` - `clave_factura` (string, opcional): Clave de tipo de factura. Por defecto F1. Valores posibles: **F1** - Factura con identificación del destinatario o de la destinataria **F2** - Factura sin identificación del destinatario o de la destinataria **F3** - Factura emitida en sustitución de facturas simplificadas y declaradas con anterioridad **F4** - Asiento resumen de facturas **F5** - Importaciones con DUA **F6** - Otros justificantes **LC** - Aduanas - Liquidación complementaria. Ejemplo: `F1` **POST** `https://{entorno}.ticketbaiws.eus/lroe-recibidas/` ```bash $ curl --request POST \ --url https://api-test.ticketbaiws.eus/lroe-recibidas/ \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Token: xxx' \ --header 'Nif: 00000014Z' --data ' { "ejercicio": 2023, "facturas":[ { "fecha": "02/09/2023", "nombre_social": "Empresa de ejemplo S.L.", "nif": "B01000012", "num_factura": "2023715273", "descripcion": "Factura móviles", "importacion": false, "tipo_factura": "gasto", "importe_total":121.00, "bases": [ { "base_imponible": 100.00, "tipo_iva": 21.00, "tipo_req": 0, "epigrafe": "197210" } ], "regimen_iva": 1, "inversion_sujeto_pasivo": false, "rectificativa": true, "num_factura_rectificada": "2023015273", "fecha_rectificada": "13/11/2023", "clave_rectificativa": "R1", "tipo_rectificativa": "S", "base_rectificada": 80.00, "cuota_rectificada" : 16.80 } ] }' ``` Respuesta: ```json HTTP/1.1 200 OK { "result": "OK", "return": { "response": [ { "fecha": "01-09-2023", "num_factura": "9092", "estado": "Incorrecto", "codigo_error": "B4_2000000", "descripcion_error": "El campo es obligatorio por lo que debe venir informado: [DescripcionOperacion].", "nif": "A88888888" }, { "fecha": "01-09-2023", "num_factura": "9091", "estado": "Correcto", "nif": "A88888888" } ], "status": "ERROR" }, "msg": null } ``` Fuente: https://ticketbaiws.eus/es/lroe-recibidas-post/