API > LROE - Envío de facturas recibidas

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
2023
facturas object array obligatorio (máx 1000) registros
fecha string obligatorio
Fecha de expedición de la factura en formato dd/mm/yyyy
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
13/11/2023
fecha_recepcion string opcional
Fecha de la recepción de la factura en formato dd/mm/yyyy
13/11/2023
nif string obligatorio
NIF del emisor de la factura
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
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)
ES
nombre_social string obligatorio
Nombre social del proveedor que emite la factura
Empresa de ejemplo S.L.
serie string opcional
Serie de factura
A
num_factura string obligatorio
Número de factura
2023715273
descripción string obligatorio
Descripción del servicio/o producto de la factura
Factura móviles
importacion boolean obligatorio
Es factura de importación
false

tipo_factura enum obligatorio
Valores posibles:
compras (Compra de bienes corrientes)
inversion (Adquisición de bienes de inversión)
gasto (Gastos)

gasto
importe_total float obligatorio
Importe total de la factura IVA incluído
121.00
bases object array.  obligatorio
Bases imponibles de la factura
base_imponible float obligatorio
Importe SIN IVA de la base imponible
100.00
tipo_iva float obligatorio
Porcentaje de IVA aplicado a la base imponible
21.00
tipo_req float obligatorio
Porcentaje de recargo de equivalencia aplicado a la línea
0.00
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
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)
inversion
cuota_soportada float opcional
Si no se define, el valor de la cuota soportada se calculará automáticamente
21.00
cuota_deducible float opcional
Si se define, el parámetro de prorrata no tiene efecto
10.50
regimen_iva integer opcional
Clave de régimen especial de IVA
17
regimen_iva_2 integer opcional
Clave de régimen especial de IVA 2
17
regimen_iva_3 integer opcional
Clave de régimen especial de IVA 3
17
inversion_sujeto_pasivo boolean opcional
Factura con inversión de sujeto pasivo
false
rectificativa boolean obligatorio
Es factura rectificativa
false
serie_factura_rectificada string opcional
Serie de factura que se está rectificando
A
num_factura_rectificada string obligatorio si rectificativa
Número de factura que se está rectificando
2023000100
fecha_rectificada string obligatorio si rectificativa
Fecha de la factura que se está rectificando en formato dd/mm/yyyy
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
R1
tipo_rectificativa string opcional
Tipo de factura rectificativa: (S)ustitutiva  (I) por diferencias. Si no se define se interpretará como I (por diferencias)
I
base_rectificada float obligatorio si rectificativa
Base de la factura que se está rectificando
100.00
cuota_rectificada float obligatorio si rectificativa
Cuota de IVA de la factura que se está rectificando.
21.00
prorrata integer opcional
Porcentaje del importe deducible de la factura
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
F1


POST https://{entorno}.ticketbaiws.eus/lroe-recibidas/
$ 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
        }
    ]
}'
$ composer require guzzlehttp/guzzle
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api-test.ticketbaiws.eus/lroe-recibidas/', [
  'body' => '{"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}]}',
  '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,
    "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
        }
    ]
}

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

print(response.text)
CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
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_POSTFIELDS, '{"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}]}');

CURLcode ret = curl_easy_perform(hnd);
OkHttpClient client = new OkHttpClient();

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

Request request = new Request.Builder()
  .url("https://api-test.ticketbaiws.eus/lroe-recibidas/")
  .post(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": "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
}