Čitanje računa, njegovih događaja i dokumenata

Jednostavnim riječima

Ovi pozivi pokazuju u kojem je stanju račun, svaki događaj u njegovoj povijesti i datoteke spremljene za njega.

Četiri poziva za čitanje prate račun nakon odgovora 202. Za sve je potreban ključ s opsegom read. ID koji ne postoji ili pripada drugom klijentu daje odgovor 404.

Polje	Značenje
`id`, `invoice_ref`, `invoice_number`	Naš ID, ID dokumenta u ERP-u i broj računa.
`route`, `environment`, `client`	Kanal slanja, okruženje i identifikator klijenta (`local` kad nije naveden).
`state`	`queued`, `submitted`, `ready`, `cancelled` i tako dalje. Stranica Statusi navodi oba sloja.
`legal_id`	Vlastita referenca kanala nakon što prijenosni sustav primi račun: broj KSeF, indeks učitavanja ANAF, ID dokumenta pristupne točke ili ID računa francuske platforme.
`document_sha256`	SHA-256 onoga što je spremljeno.
`attempts`	Ranije predaje istog `invoice_ref`, na primjer nakon odbijanja i ispravka.
`deadline_at`	Okvirni rok, samo za Rumunjsku i Poljsku, i samo kad račun sadrži datum izdavanja. Nikad nije raniji od stvarnog roka i nije pravni savjet.
`created_at`, `updated_at`	Vremenske oznake prema RFC 3339, u UTC-u.

GET /invoices/{id}/events reproducira svaki statusni događaj računa, redoslijedom polja sequence. Koristite ga da nadoknadite propušteno nakon prekida rada. Događaji ne istječu dok traje ugovor i ništa ne treba potvrđivati.

curl "https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/events" \
  -H "Authorization: Bearer <your-api-key>"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/events"))
            .header("Authorization", "Bearer <your-api-key>")
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}
const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/inv_936a93e38de84e7b0a1d7681/events', {
  headers: {
    Authorization: 'Bearer <your-api-key>',
  },
});
console.log(response.status);
console.log(await response.text());

Odgovor200 OK

{
  "data": [
    {
      "occurred_at": "2026-10-06T19:49:01.621Z",
      "sequence": 1,
      "environment": "sandbox",
      "invoice_ref": "CAPTURE-JSON-1790961440",
      "document_sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc",
      "event_id": "evt_e1b58da963c46e4a63409006",
      "country_route": "DE-XRECHNUNG",
      "invoice_number": "DOC-mux3dlqm",
      "status": "received"
    },
    {
      "occurred_at": "2026-10-06T19:49:02.661Z",
      "sequence": 2,
      "environment": "sandbox",
      "invoice_ref": "CAPTURE-JSON-1790961440",
      "document_sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc",
      "event_id": "evt_0dcb4d0b797e93185b22c27d",
      "country_route": "DE-XRECHNUNG",
      "invoice_number": "DOC-mux3dlqm",
      "status": "validated"
    }
  ]
}

Zabilježeno 7. lis. 2026.

Svi računi

GET /invoices popisuje i pretražuje račune klijenta, od najnovijeg, stranicu po stranicu. Filtrira se po q (dio invoice_ref ili broja), route, state i danu zaprimanja (received_from, received_to). Redak sadrži ono što sadrži GET /invoices/{id}, bez dokumenata i bez sadržaja računa: bez kupca, iznosa i datuma izdavanja. GET /invoices/series broji zaprimljene i odbijene račune po danu i kanalu, za grafikon. Pogledajte referencu.

Njegovi dokumenti

GET /invoices/{id}/documents/{kind} vraća ono što je usluga spremila. Vrsta je jedna od sljedećih:

Vrsta	Kada se sprema
`canonical`	Predali ste JSON. Datoteka je račun onakav kakav ste ga poslali.
`erp-export`	Predali ste izvoz iz ERP-a. Datoteka je izvoz onakav kakav ga je poslao ERP.
`ubl`, `cii`, `fa3`, `pdf`	Datoteka kakva je poslana ili dokument koji je usluga izradila: `xrechnung-ubl` za Njemačku, `ubl` ili `fa3` za ostale kanale.
`validation-report`	Što je pronašla svaka provjera.
`manifest`	SHA-256 bajtova koji idu na kanal slanja i provjere koje su na njima izvršene.

JSON vrste poslužuju se kao application/json.

ETag je SHA-256 datoteke. Dokumenti se mogu čitati samo s ključem. Nema javnih poveznica. Probna provjera ništa ne sprema.

curl "https://api-sandbox-eu.eurinvoice.com/invoices/inv_1721a979f65d8ff80ef5f64b/documents/ubl" \
  -H "Authorization: Bearer <your-api-key>"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/inv_1721a979f65d8ff80ef5f64b/documents/ubl"))
            .header("Authorization", "Bearer <your-api-key>")
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}
const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/inv_1721a979f65d8ff80ef5f64b/documents/ubl', {
  headers: {
    Authorization: 'Bearer <your-api-key>',
  },
});
console.log(response.status);
console.log(await response.text());

Odgovor200 OK

<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"><cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0</cbc:CustomizationID><cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID><cbc:ID>RE-2026-0142</cbc:ID><cbc:IssueDate>2026-09-26</cbc:IssueDate><cbc:DueDate>2026-10-10</cbc:DueDate><cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode><cbc:Note>Vielen Dank für Ihren Auftrag.</cbc:Note><cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode><cbc:BuyerReference>PO-88731</cbc:BuyerReference><cac:InvoicePeriod><cbc:StartDate>2026-09-01</cbc:StartDate><cbc:EndDate>2026-09-30</cbc:EndDate></cac:InvoicePeriod><cac:AccountingSupplierParty><cac:Party><cbc:EndpointID schemeID="9930">DE123456789</cbc:EndpointID><cac:PostalAddress><cbc:StreetName>Hafenstraße 12</cbc:StreetName><cbc:CityName>Hamburg</cbc:CityName><cbc:PostalZone>20457</cbc:PostalZone><cac:Country><cbc:IdentificationCode>DE</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>DE123456789</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>Nordlicht Software GmbH</cbc:RegistrationName><cbc:CompanyID>HRB 123456</cbc:CompanyID><cbc:CompanyLegalForm>GmbH</cbc:CompanyLegalForm></cac:PartyLegalEntity><cac:Contact><cbc:Name>Jana Petersen</cbc:Name><cbc:Telephone>+49 40 1234567</cbc:Telephone><cbc:ElectronicMail>[email protected]</cbc:ElectronicMail></cac:Contact></cac:Party></cac:AccountingSupplierParty><cac:AccountingCustomerParty><cac:Party><cbc:EndpointID schemeID="9930">DE987654321</cbc:EndpointID><cac:PostalAddress><cbc:StreetName>Marienplatz 4</cbc:StreetName><cbc:CityName>München</cbc:CityName><cbc:PostalZone>80331</cbc:PostalZone><cac:Country><cbc:IdentificationCode>DE</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>DE987654321</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>Brauhaus Weber AG</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingCustomerParty><cac:PaymentMeans><cbc:PaymentMeansCode>58</cbc:PaymentMeansCode><cbc:PaymentID>RE-2026-0142</cbc:PaymentID><cac:PayeeFinancialAccount><cbc:ID>DE89370400440532013000</cbc:ID><cbc:Name>Nordlicht Software GmbH</cbc:Name><cac:FinancialInstitutionBranch><cbc:ID>COBADEFFXXX</cbc:ID></cac:FinancialInstitutionBranch></cac:PayeeFinancialAccount></cac:PaymentMeans><cac:PaymentTerms><cbc:Note>Zahlbar innerhalb von 14 Tagen ohne Abzug.</cbc:Note></cac:PaymentTerms><cac:TaxTotal><cbc:TaxAmount currencyID="EUR">1255.71</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxableAmount currencyID="EUR">6609.00</cbc:TaxableAmount><cbc:TaxAmount currencyID="EUR">1255.71</cbc:TaxAmount><cac:TaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>19.00</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:TaxCategory></cac:TaxSubtotal></cac:TaxTotal><cac:LegalMonetaryTotal><cbc:LineExtensionAmount currencyID="EUR">6609.00</cbc:LineExtensionAmount><cbc:TaxExclusiveAmount currencyID="EUR">6609.00</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount currencyID="EUR">7864.71</cbc:TaxInclusiveAmount><cbc:PayableAmount currencyID="EUR">7864.71</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:InvoicedQuantity unitCode="LS">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID="EUR">5900.00</cbc:LineExtensionAmount><cac:Item><cbc:Description>Mapping Business Central → EN 16931, Validierung XRechnung, Test im Peppol-Testnetz</cbc:Description><cbc:Name>E-Rechnung Einführung (Festpreis)</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>19.00</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID="EUR">5900.00</cbc:PriceAmount></cac:Price></cac:InvoiceLine><cac:InvoiceLine><cbc:ID>2</cbc:ID><cbc:InvoicedQuantity unitCode="MON">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID="EUR">349.00</cbc:LineExtensionAmount><cac:Item><cbc:Description>Care Plus, September 2026</cbc:Description><cbc:Name>Betreuung abgelehnter Rechnungen</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>19.00</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID="EUR">349.00</cbc:PriceAmount></cac:Price></cac:InvoiceLine><cac:InvoiceLine><cbc:ID>3</cbc:ID><cbc:InvoicedQuantity unitCode="HUR">3</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID="EUR">360.00</cbc:LineExtensionAmount><cac:Item><cbc:Description>Remote, Buchhaltungsteam</cbc:Description><cbc:Name>Zusätzliche Schulung</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>19.00</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID="EUR">120.00</cbc:PriceAmount></cac:Price></cac:InvoiceLine></Invoice>

<!-- shortened for these docs -->

UBL datoteka iz predaje za Peppol, skraćena, zabilježena 7. lis. 2026.

Odgovori

Status	Značenje
`200`	Račun, njegovi događaji ili datoteka.
`401`	Nema ključa ili je ključ nepoznat.
`403`	Ključ nema opseg `read`.
`404`	Za ovog klijenta nema takvog računa ili račun nema takvu vrstu dokumenta.
`429`	Previše zahtjeva za ključ. Pričekajte onoliko sekundi koliko navodi `Retry-After`.

curl "https://api-sandbox-eu.eurinvoice.com/invoices/inv_unknown" \
  -H "Authorization: Bearer <your-api-key>"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api-sandbox-eu.eurinvoice.com/invoices/inv_unknown"))
            .header("Authorization", "Bearer <your-api-key>")
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}
const response = await fetch('https://api-sandbox-eu.eurinvoice.com/invoices/inv_unknown', {
  headers: {
    Authorization: 'Bearer <your-api-key>',
  },
});
console.log(response.status);
console.log(await response.text());

Odgovor404 Not Found

{
  "type": "https://eurinvoice.com/problems/not-found",
  "title": "No such resource for this client",
  "status": 404
}

Zabilježeno 7. lis. 2026.

Čitanje računa, njegovih događaja i dokumenata

Račun

Njegovi događaji

Svi računi

Njegovi dokumenti

Odgovori

Na ovoj stranici

RačunKopiraj poveznicu na ovaj odjeljak

Njegovi događajiKopiraj poveznicu na ovaj odjeljak

Svi računiKopiraj poveznicu na ovaj odjeljak

Njegovi dokumentiKopiraj poveznicu na ovaj odjeljak

OdgovoriKopiraj poveznicu na ovaj odjeljak

Na ovoj stranici

Račun

Njegovi događaji

Svi računi

Njegovi dokumenti

Odgovori