## LROE - Consulta de facturas recibidas

`GET`  https://{entorno}.ticketbaiws.eus/lroe-recibidas/

**ATENCIÓN: Este método únicamente es válido para BATUZ Bizkaia.**  Permite consultar las facturas enviadas al LROE de Batuz de facturas recibidas (compras). Todos los parámetros menos el del ejercicio son opcionales (aunque se debe especificar al menos uno) y se pueden combinar, por ejemplo para buscar entre dos fechas las facturas de un proveedor concreto.

**Los métodos GET permiten el envío de los parámetros en el body como payload JSON o mediante query string en la URL como se ve en el ejemplo cURL.**

### Parámetros

- `ejercicio` (integer, obligatorio): Año fiscal del ejercicio del bloque de facturas recibicas en formato yyyy. Ejemplo: `2023`
- `fecha_factura_desde` (string, opcional): Fecha de la factura completa en formato dd/mm/yyyy. Ejemplo: `13/09/2023`
- `fecha_factura_hasta` (string, opcional): Fecha de la factura completa en formato dd/mm/yyyy. Ejemplo: `13/10/2023`
- `fecha_recepcion_desde` (string, opcional): Fecha de la factura completa en formato dd/mm/yyyy. Ejemplo: `13/09/2023`
- `fecha_recepcion_hasta` (string, opcional): Fecha de la factura completa en formato dd/mm/yyyy. Ejemplo: `13/10/2023`
- `pais_emisor` (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`
- `tipo_documento` (string, opcional): Tipo de documento identificativo para clientes extranjeros. Por defecto 02 para intracomunitarias ó 06 para el resto.
  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`
- `nif` (string, opcional): NIF del emisor de la factura. Ejemplo: `B01000012`
- `num_factura` (string, opcional): Número de la factura. Ejemplo: `2023715273`
- `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`
- `estado` (string, opcional): Estado de las facturas: Correcto, AceptadoConErrores, Incorrecto. Ejemplo: `Correcto`
- `pagina` (integer, opcional): Para especificar el número de página del resultado paginado. Ejemplo: `1`

**GET** `https://{entorno}.ticketbaiws.eus/lroe-recibidas/`

```bash
$ curl --request GET \
     --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,
    "fecha_factura_desde": "01/06/2023",
    "fecha_factura_hasta": "01/10/2023",
    "fecha_recepcion_desde": "01/09/2023",
    "fecha_recepcion_hasta": "01/10/2023",
    "pais_emisor": "IT",
    "tipo_documento": "06",
    "nif": "IT123895890",
    "num_factura": "2023715273",
    "epigrafe": "197210",
    "estado": "Correcto",
	"pagina": 1
}'
```

Respuesta:

```json
HTTP/1.1 200 OK
{
    "result": "OK",
    "return": {
        "response": [
            {
                "fecha": "31/08/2023",
                "fecha_operacion": "",
                "fecha_recepcion": "31/08/2023",
                "num_factura": "8064",
                "descripcion": "21312",
                "nif": "A88888888",
                "nombre_social": "EMPRESA EJEMPLO S.A.",
                "bases": [
                    {
                        "base_imponible": "400.72",
                        "tipo_iva": "21.00"
                    }
                ],
                "importe_total": "484.87",
                "inversion_sujeto_pasivo": false,
                "regimen_iva": "01",
                "fecha_presentacion": "15/11/2023 11:16:56",
                "fecha_modificacion": "15/11/2023 11:16:56",
                "estado": "Correcto"
            }
        ]
    },
    "msg": null
}
```

Fuente: https://ticketbaiws.eus/es/lroe-recibidas-get/