LROE - Consulta de facturas recibidas - Ticketbai API Web Service - Conecta tu tienda online o aplicación a TicketBAI

API > LROE - Consulta de facturas recibidas

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	2023
fecha_factura_desde string opcional Fecha de la factura completa en formato dd/mm/yyyy	13/09/2023
fecha_factura_hasta string opcional Fecha de la factura completa en formato dd/mm/yyyy	13/10/2023
fecha_recepcion_desde string opcional Fecha de la factura completa en formato dd/mm/yyyy	13/09/2023
fecha_recepcion_hasta string opcional Fecha de la factura completa en formato dd/mm/yyyy	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)	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	02
nif string opcional NIF del emisor de la factura	B01000012
num_factura string opcional Número de la factura	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.	197210
estado string opcional Estado de las facturas: Correcto, AceptadoConErrores, Incorrecto	Correcto
pagina integer opcional Para especificar el número de página del resultado paginado.	1

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

$ 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
}'

$ curl --request GET \
     --url 'https://api-test.ticketbaiws.eus/lroe-recibidas/?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' \
     --header 'Accept: application/json' \
     --header 'Token: xxx' \
     --header 'Nif: 00000014Z'

$ composer require guzzlehttp/guzzle

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-test.ticketbaiws.eus/lroe-recibidas/', [
  'body' => '{"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}',
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
    'Token' => 'xxx',
    'Nif' => '00000014Z'
  ],
]);

echo $response->getBody();

$ python -m pip install requests

import requests

url = "https://api-test.ticketbaiws.eus/lroe-recibidas/"
payload = {
    "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
}

headers = {"Accept": "application/json", "Token" : "xxx", "Nif" : "00000014Z"}
response = requests.request("GET", url, json=payload, headers=headers)

print(response.text)

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api-test.ticketbaiws.eus/lroe-recibidas/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_GETFIELDS, '{"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}');

CURLcode ret = curl_easy_perform(hnd);

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, '{"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}');

Request request = new Request.Builder()
  .url("https://api-test.ticketbaiws.eus/lroe-recibidas/")
  .GET(body)
  .addHeader("Accept", "application/json")
  .addHeader("Token", "xxx")
  .addHeader("Nif", "00000014Z")
  .build();
  
Response response = client.newCall(request).execute();

{ } Response 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
}

LROE - Consulta de facturas recibidas

Métodos TicketBAI / Verifactu

Métodos específicos para Verifactu

Métodos específicos para BATUZ BIZKAIA

Otros métodos