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.

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

Métodos TicketBAI

Métodos específicos para BATUZ BIZKAIA