Obtener detalles de la factura

GET

/invoices/{id}

Devuelve información detallada sobre una factura específica. Requiere autenticación; solo devuelve documentos pertenecientes al usuario autenticado.

Authorizations

token

Parameters

Path Parameters

required

Document ID

integer

>= 1

ID de la factura

Responses

200

Invoice resource

Invoice details (JSON-LD)

object

@id

JSON-LD ID

string

@type

JSON-LD type

string

@context

One of:

string
object

string

Invoice ID

string

created_at

Creation date (unix timestamp)

integer

amount

Invoice amount

number

currency

Moneda

string

default: EUR

Allowed values: EUR CHF

status

Invoice status: 0 = New (unpaid), 1 = Success (paid), 2 = Failed

integer

Allowed values: 0 1 2

payment_type

Payment method: 1 = SEPA, 6 = Bank Transfer, 7 = PayPal, 8 = Sofort, 91 = Stored Card, 92 = New Card

integer

Allowed values: 1 6 7 8 91 92

paid_at

Payment date (unix timestamp), 0 if not paid

integer

client_name

Client company name

string

client_address

Client address

string

client_info

Client info line

string

vat

VAT percentage

number

vat_id

VAT identification number

string

vat_val

VAT value

number

fee

Fee percentage

number

fee_val

Fee value

number

net_val

Net cost value

number

iso2

ISO-2 country code

string

custom_text

Custom text on the invoice

string

pdf

URI to download invoice PDF

string

credit_note

URI to related credit note, null if none

string | null

key

additional properties

any

Examples

invoice_jsonld

Invoice detail example (JSON-LD)

Example response for GET /invoices/{id} with Accept: application/ld+json

{
  "@context": "/contexts/Invoice",
  "@id": "/invoices/44969",
  "@type": "Invoice",
  "id": "44969",
  "created_at": 1626123015,
  "amount": 24.63,
  "currency": "EUR",
  "status": 1,
  "payment_type": 7,
  "paid_at": 1626123015,
  "client_name": "Example Customer Ltd.",
  "client_address": "Main Street 42\n12345 Example City",
  "client_info": "John Doe",
  "vat": 19,
  "vat_id": "DE123456789",
  "vat_val": 3.93,
  "fee": 3.5,
  "fee_val": 0.72,
  "net_val": 19.98,
  "iso2": "DE",
  "custom_text": "PO-2024-001",
  "pdf": "/invoices/44969/pdf",
  "credit_note": "/credit_notes/240"
}

Invoice details

object

ID de la factura

string

created_at

Fecha de creación (timestamp Unix)

integer

amount

Importe de la factura

number

currency

Código de moneda

string

default: EUR

Allowed values: EUR CHF

status

Estado de la factura: 0 = Nueva (no pagada), 1 = Exitosa (pagada), 2 = Fallida

integer

Allowed values: 0 1 2

payment_type

Método de pago: 1 = SEPA, 6 = Transferencia, 7 = PayPal, 8 = Sofort, 91 = Tarjeta guardada, 92 = Nueva tarjeta

integer

Allowed values: 1 6 7 8 91 92

paid_at

Fecha de pago (timestamp Unix), 0 si no pagado

integer

client_name

Nombre de la empresa del cliente

string

client_address

Dirección del cliente

string

client_info

Línea de información del cliente

string

vat

Porcentaje de IVA

number

vat_id

Número de identificación fiscal

string

vat_val

Valor del IVA

number

fee

Porcentaje de comisión

number

fee_val

Valor de la comisión

number

net_val

Valor del coste neto

number

iso2

Código de país ISO-2

string

custom_text

Texto personalizado en la factura

string

pdf

URI para descargar el PDF de la factura

string

credit_note

URI a la nota de crédito relacionada, null si no existe

string | null

key

additional properties

any

Examples

invoice_json

Invoice detail example

Example response for GET /invoices/{id}

{
  "id": "44969",
  "created_at": 1626123015,
  "amount": 24.63,
  "currency": "EUR",
  "status": 1,
  "payment_type": 7,
  "paid_at": 1626123015,
  "client_name": "Example Customer Ltd.",
  "client_address": "Main Street 42\n12345 Example City",
  "client_info": "John Doe",
  "vat": 19,
  "vat_id": "DE123456789",
  "vat_val": 3.93,
  "fee": 3.5,
  "fee_val": 0.72,
  "net_val": 19.98,
  "iso2": "DE",
  "custom_text": "PO-2024-001",
  "pdf": "/invoices/44969/pdf",
  "credit_note": "/credit_notes/240"
}

401

El ID de cliente o la clave API no están activos o no son válidos.

403

La cuenta no está activada. Espere o póngase en contacto con el servicio de asistencia.

404

No se ha encontrado el recurso

429

La dirección IP fue bloqueada temporalmente, ya que durante poco tiempo se enviaron muchas solicitudes con credenciales no válidas. Espere y pruebe más tarde.

Code Samples

curl -s 'https://api.lox24.eu/invoices/34101' -H 'X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN' | jq

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN");

        var response = await client.GetStringAsync("https://api.lox24.eu/invoices/34101");
        Console.WriteLine(response);
    }
}

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.lox24.eu/invoices/34101", nil)
  req.Header.Set("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.lox24.eu/invoices/34101"))
                .header("X-LOX24-AUTH-TOKEN", "YOUR_API_TOKEN")
                .GET()
                .build();

        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

<?php

$ch = curl_init('https://api.lox24.eu/invoices/34101');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-LOX24-AUTH-TOKEN: YOUR_API_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;