Niemcy
Co Ocost odczytuje z niemieckiego dokumentu i gdzie to zapisuje w ocost.document.v1.
| Niemcy | Ukraina | |
|---|---|---|
| Dokumenty | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identyfikatory | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Stawki VAT | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| E-faktury | XRechnung, ZUGFeRD, Factur-X, bez modelu | Jeszcze bez formatu XML: wyślij PDF lub skan |
| Eksport dla księgowego | DATEV | 1С / BAS |
Dokumenty
| Drukowany jako | kind | kind_detail |
|---|---|---|
| Rechnung | invoice | invoice |
| Abschlagsrechnung, Teilrechnung | invoice | partial_invoice |
| Schlussrechnung | invoice | final_invoice |
| Anzahlungsrechnung | invoice | advance_payment_invoice |
| Gutschrift im Gutschriftverfahren | invoice | credit_invoice |
| Gutschrift, Storno | credit_note | credit_note |
| Rechnungskorrektur | invoice_correction | invoice_correction |
| Proforma-Rechnung | pro_forma | pro_forma_invoice |
| Quittung, Kassenbon | receipt | receipt |
| Lieferschein | delivery_note | delivery_note |
| Bestellung, Auftrag | order | order |
| Auftragsbestätigung | order_confirmation | order_confirmation |
| Angebot | quote | offer |
| Vertrag, Mietvertrag | contract | contract, lease_contract |
| Mahnung, Zahlungserinnerung | payment_reminder | payment_reminder |
| Nebenkostenabrechnung | other | cost_statement |
Gutschrift może oznaczać dwie rzeczy. Taka, która cofa fakturę, to credit_note. Taka, którą klient wystawia zamiast faktury dostawcy, to credit_invoice, a attention zawiera self_billed.
Identyfikatory
| Drukowany jako | Pole | Kontrola |
|---|---|---|
USt-IdNr. (DE i dziewięć cyfr) | vat_id, identifiers jako EU_VAT | Kontrola vat_id: jego format. Ocost nie pyta VIES. |
| Steuernummer | tax_registration_id, identifiers jako DE_STNR | Brak |
| Handelsregister: HRB lub HRA z sądem | legal_registration_id, identifiers jako COMMERCIAL_REGISTER | Brak. Zachowywany tylko wtedy, gdy wskazuje rejestr i numer. |
| Leitweg-ID | buyer_reference | Odczytywany tylko z XRechnung |
| IBAN | payment.iban | Kontrola iban: jego cyfry kontrolne |
VAT
Ocost odczytuje stawki wydrukowane na dokumencie, zwykle 19 % i 7 %. Każda stawka to jedna grupa vat_breakdown. Kontrola vat przechodzi, gdy VAT grupy równa się jej kwocie netto razy stawka.
| Kategoria | Na niemieckim dokumencie |
|---|---|
S | 19 % lub 7 % |
Z | 0 % |
E | Steuerfrei (§ 4 UStG), z wydrukowanym powodem |
AE | § 13b UStG: „Steuerschuldnerschaft des Leistungsempfängers” |
K | Innergemeinschaftliche Lieferung |
G | Eksport poza UE |
O | Nicht steuerbar |
Sprawdzenie faktury
tax_check zawiera to, czego fakturze przychodzącej brakuje do odliczenia VAT naliczonego. Ocost wypełnia go, gdy Twoja firma i dostawca są w Niemczech. Kraj dostawcy Ocost bierze z jego adresu, a gdy go brak, z numeru VAT UE. Obejmuje faktury do zapłaty i paragony do 250 €. Dla wszystkiego innego ma wartość null.
case | Czego Ocost wymaga |
|---|---|
standard | § 14 Abs. 4 UStG: nazwy i adresy obu stron, Twoja firma jako odbiorca, numer podatkowy lub NIP UE dostawcy, data, numer, towary lub usługi, data wykonania usługi i kwota netto. Do tego stawka i VAT. |
small | § 33 UStDV, do 250 € brutto: nazwa i adres dostawcy, data, towary lub usługi oraz stawka |
reverse_charge | Standardowe elementy aż do kwoty netto i adnotacja, że VAT jesteś winien Ty |
intra_eu | Standardowe elementy aż do kwoty netto, adnotacja i oba numery NIP UE |
exempt | Standardowe elementy aż do kwoty netto i powód zwolnienia |
Każdy element w missing podaje swoje law. at_stake ma wartość true, gdy brak kosztuje odliczenie. vat_charged oznacza niemiecki VAT, który zgodnie z § 13b jesteś winien sam. Nie podlega odliczeniu, a kto go zapłaci, płaci go dwa razy. Ocost wstrzymuje taką fakturę do decyzji człowieka.
E-faktury
Ocost odczytuje XRechnung w UBL i CII oraz ZUGFeRD lub Factur-X bez modelu. Bierze sam XML albo XML z wnętrza pliku PDF. read_with ma wartość e_invoice, a każda wartość jest checked.
Daty, kwoty i język
Niemieckie dokumenty drukują 03.11.2026 i 1.270,92 €. Ocost zapisuje 2026-11-03, 1270.92 i EUR. sources zachowuje cytat tak, jak wydrukowano. Warunki Skonto trafiają do early_payment_discounts. Nazwy i pozycje zostają w słowach dokumentu.
Twoja firma
Ocost odróżnia dokumenty przychodzące od wychodzących po Twoich danych w Ustawienia › Firma. Niemiecka firma potrzebuje adresu oraz USt-IdNr. lub Steuernummer. GmbH, UG, AG, KG, OHG lub e.K. podaje też sąd rejestrowy i numer.
Ocost uzupełnia puste pole z Twoich dokumentów i dokumentów grupy, gdy wskazuje Cię dokładny identyfikator. Nigdy nie nadpisuje wartości.
Poczta na belege@<name>.ocost.io trafia do Ocost. Nazwa to Twoja nazwa bez formy prawnej, z umlautami rozpisanymi na dwie litery, na przykład mueller-bau.
Przykład
Fragment faktury przychodzącej:
{
"kind": "invoice",
"kind_detail": "invoice",
"type_code": "380",
"number": "RE-2026-0412",
"currency": "EUR",
"seller": {
"name": "Beispiel Werkstatt GmbH",
"identifiers": [
{ "scheme": "EU_VAT", "value": "DE123456788", "valid": null },
{ "scheme": "DE_STNR", "value": "21/815/08150", "valid": null },
{ "scheme": "COMMERCIAL_REGISTER", "value": "Amtsgericht Köln HRB 12345", "valid": null }
],
"vat_id": "DE123456788",
"tax_registration_id": "21/815/08150",
"legal_registration_id": "Amtsgericht Köln HRB 12345"
},
"totals": { "net": 500, "tax": 95, "gross": 595, "payable": null, "prices_include_vat": false },
"vat_breakdown": [
{ "category": "S", "rate": 19, "taxable_amount": 500, "tax_amount": 95, "exemption_reason": null }
],
"early_payment_discounts": [
{ "days": 10, "percent": 2, "base_amount": null, "due_date": "2026-11-13" }
],
"tax_check": { "case": "standard", "missing": [] },
"read_with": "reader"
}