TicketBAI WS
Acceder Documentación
INICIO
Qué es TicketBAI Qué es Verifactu Cómo funciona Certificados electrónicos Preguntas frecuentes
FUNCIONALIDADES API TARIFAS CONTACTO
API > LROE - Criterio de caja - COBROS - Consulta de cobros

LROE - Criterio de caja - COBROS - Consulta de cobros

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

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. Este método es para empresas o personas autónomas acogidas al régimen especial del criterio de caja

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_operacion_desde string opcional
Fecha de la operación en formato dd/mm/yyyy		13/09/2023
fecha_operacion_hasta string opcional
Fecha de la operación en formato dd/mm/yyyy		13/10/2023
fecha_cobro_desde string opcional
Fecha del cobro en formato dd/mm/yyyy		13/09/2023
fecha_cobro_hasta string opcional
Fecha del cobro en formato dd/mm/yyyy		13/10/2023
tipo_ingreso string opcional
Cuando la operación es sin factura y únicamente para el modelo 140 (autónomos o sociedades sin PJ) . Posibles opciones:
1  - Percepciones incapacidad temporal
2 - Subvenciones (subgrupo 74)
3 - Ingresos financieros (subgrupo 76)
4 - Ingresos extraordinarios y otros (subgrupos 73, 77 y 79)		02
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-critcaja-cobros/ 
$ curl --request GET \
     --url https://api-test.ticketbaiws.eus/lroe-critcaja-cobros/ \
     --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",
	"pagina": 1
}'

$ curl --request GET \
     --url 'https://api-test.ticketbaiws.eus/lroe-critcaja-cobros/?ejercicio=2023&fecha_factura_desde=01/06/2023&fecha_factura_hasta=01/10/2023&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-critcaja-cobros/', [
  'body' => '{"ejercicio": 2023,"fecha_factura_desde": "01/06/2023","fecha_factura_hasta": "01/10/2023","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-critcaja-cobros/"
payload = {
    "ejercicio": 2023,
    "fecha_factura_desde": "01/06/2023",
    "fecha_factura_hasta": "01/10/2023",
	"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-critcaja-cobros/");

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","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","pagina": 1}');

Request request = new Request.Builder()
  .url("https://api-test.ticketbaiws.eus/lroe-critcaja-cobros/")
  .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_factura": "29/11/2023",
                "fecha_cobro": "29/11/2023",
                "serie": "A",
                "num_factura": "2023000699",
                "importe_cobrado": "250.00",
                "iva_devengado": "52.50",
                "forma_pago": "01",
                "descripcion_fpago": "Transferencia",
                "estado": "Correcto"
            },
            {
                "fecha_factura": "29/11/2023",
                "fecha_cobro": "05/12/2023",
                "serie": "A",
                "num_factura": "2023000699",
                "importe_cobrado": "50.00",
                "iva_devengado": "10.50",
                "forma_pago": "04",
                "descripcion_fpago": "Otros medios de cobro o de pago",
                "estado": "Correcto"
            }
        ]
    },
    "msg": null
}

Métodos TicketBAI / Verifactu

Métodos específicos para Verifactu

Métodos específicos para BATUZ BIZKAIA

Otros métodos