Haben Sie noch Fragen? Schreiben Sie an info@numiron.sk

Numiron-Unterstützung

Numiron Unterstützung & FAQ

Group 957 (1)
integrieren

Persönliche Steuererklärung

home

Erste Schritte

pie-chart-analysis

Ansichten

Frame 7718

Rechnungsstellung

bar-chart-analysis

Kosten

Frame 7715

Finanzen

user

Einstellungen

percent-badge

Daten

user

Abonnement

Frame 7718

Integrationen

Kontaktieren Sie uns, wenn Sie die Antwort nicht gefunden haben

Mo - Fr von 08:00 - 16:00

Numiron

/

Unterstützung

/

/

Numiron Public API - Erstellung von Rechnungen (grundlegende Dokumentation)
Zurück zuIntegrationen

Numiron Public API - Erstellung von Rechnungen (grundlegende Dokumentation)

4 min.

Geschrieben von

Endpunkt & Autorisierung

  • POST /api/public/v1/zugewiesene_Unternehmen/{zugewiesene_Unternehmen_id}/invoices

Wie erhält man {assigned_company_id} Bitte beachten Sie diesen Leitfaden.

  • Überschriften:
    • Autorisierung: Überbringer
    • Akzeptieren: application/json
    • Inhalt-Typ: application/json
  • Datumsformat: ISO-8601, z. B. 2025-06-30T00:00:00.000+00:00
  • Währung: ISO-4217, z.B. EUR
FeldTypErforderlichBeschreibungBeispielAufzählung / Anmerkung
Adresse_KäuferStringAdresse des Kunden - Straße und Hausnummer.Hauptstraße 5
Adresse_LieferantStringMeine Adresse - Straße und Hausnummer.Hauptstraße 5
stadt_käuferStringStadt des Kunden.Bratislava
stadt_lieferantStringMeine Wohnung.Bratislava
kunden_emailsarrayListe der Kunden-E-Mails (Empfänger).Jeder Artikel hat E-Mail: Zeichenkette (z.B.. client@client.com).
konstantes_symbolStringKonstantes Dokumentensymbol.1234
land_käuferStringLand des Kunden (ISO 3166-1 alpha-2).DE
land_lieferantStringMein Land (ISO 3166-1 alpha-2).DE
Erstellungsdatumstring (datetime)Datum der Ausgabe.2025-08-26T07:59:41.920ZISO-8601
WährungStringWährung (ISO 4217 Code).CZK
lieferung_stadtStringOrt der Lieferadresse.Bratislava
lieferlandStringLand der Lieferadresse (ISO-2).DE
LiefermethodeStringArt der Lieferung.in_persondurch_Kurier, elektronisch, in_person, eigener_Transport
lieferung_nameStringName/Kontaktperson an der Lieferadresse.Milan Malinový
LieferstraßeStringStraße und Nummer der Lieferadresse.Hauptstraße 5
lieferung_zipStringDie Postleitzahl der Lieferadresse.12345
dic_käuferStringdie Mehrwertsteuernummer des Kunden.1234567890
dic_lieferantStringMeine Umsatzsteuer-Identifikationsnummer.1234567890
UmrechnungskursNummerFremdwährungskurs gegenüber EUR.25.123
icdph_KäuferStringMehrwertsteuernummer des Kunden.SK1234567890
icdph_lieferantStringMeine Umsatzsteuer-Identifikationsnummer.SK1234567890
ico_KäuferStringKunden-ID.12345678
ico_LieferantStringMeine ID.12345678
rechnung_zeilenarrayBelegpositionen (siehe Tabelle unten).
SpracheStringSprache des Dokuments.DEDE, DE, DE
NachrichtStringHaupttext (nach „Wir stellen Ihnen eine Rechnung“).unter Vertrag...
Name_KäuferStringName des Kunden.Gesellschaft s.r.o.
Name_LieferantStringMein Name.Gesellschaft s.r.o.
HinweisStringInterne Notiz zum Dokument.Der Kunde wollte eine Geschenkverpackung.
auftrag_nummerStringBestellnummer.123ABC
ossbooleanOSS-Modus (One Stop Shop).falsch
absatz_käuferStringAbsatz der Mehrwertsteuerregistrierung des Kunden.4
absatz_lieferantStringAbsatz meiner MwSt.-Registrierung.4
ZahlungsmethodeStringArt der Bezahlung.bank_überweisungVorschuss_Zahlung, bank_überweisung, durch_Entschädigung, Karte, Bargeld, Nachnahme
save_clientbooleanSpeichern Sie den Client in dem Verzeichnis.falsch
UnterschriftbooleanUnterschrift/Stempel auf PDF.falsch
zip_käuferStringdie Postleitzahl des Kunden.12345
zip_lieferantStringMeine Postleitzahl.12345
Lieferdatumstring (datetime)Datum der Lieferung (DUZP).2025-08-26T07:59:41.920ZISO-8601
LieferscheinbooleanErstellen Sie auch einen Lieferschein.falsch
Verfallsdatumstring (datetime)Fälligkeitsdatum.2025-08-26T07:59:41.920ZISO-8601
ibanZeichenfolge (IBAN)IBAN des Dokuments.SK0000000000000000000000Gültige IBAN
rechnung_nummerStringDokument Nummer.20250001Einzigartig in der Serie
variables_symbolStringVariables Symbol.1234123477

Artikel

FeldTypErforderlich BeschreibungBeispielAufzählung / Anmerkung
TätigkeitStringAktivität (für das Dashboard „Umsatz nach Aktivität“).Akt 1
BetragNummerMenge des Artikels.1
MEHRWERTSTEUERNummerMehrwertsteuersatz in %.23
gegebene_verpflichtungStringSteuermodus für die Linie 0%.transfer_15Befreiung_von_der_Steuerpflicht, transfer_15, transfer_16, dreieckig_handeln, Ausnahme
lieferung_artStringArt der Leistung.Dienstleistungenz.B.. Waren, Dienstleistungen, ...
AbteilungStringZentrum (für das Dashboard „Verkäufe nach Zentrum“).Depot 1
rabatt_eine_zeileNummerRabatt auf den Artikel in %.10
gewünschte_gesamtzahlNummerDer Endbetrag des Postens.1.23In der Regel mit Mehrwertsteuer
idxStringEindeutiger Index des Artikels innerhalb des Dokuments.1
itemInfoStringText/Titel des Artikels.Äpfel
measureUnitStringMaßeinheit.ks
BestellungStringVertrag (für das Dashboard „Verkäufe nach Vertrag“).Bestellung 1

Hinweis: Für desired_total berechnet das System die Einheitspreise und Rundungen nach den geltenden Regeln.


cURL-Beispiel (Vorlage)

curl -X POST \
‚https://my.numiron.sk/api/public/v1/assigned_companies/{ASSIGNED_COMPANY_ID}/Rechnungen‘
-H ‚accept: application/json‘ \
-H ‚authorization: bearer‚ \
-H ‚Content-Type: application/json‘ \
-d ‚{
„Adresse_Käufer“: „5 Main Street“,
„Adresse_Lieferant“: „10 Industrial Ave“,
„Stadt_Käufer“: „Bratislava“,
„Stadt_Lieferant“: „Bratislava“,
„client_emails“: [ „client@example.com“ ],
„Land_Käufer“: „de“,
„Land_Lieferant“: „de“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„Währung“: „EUR“,
„lieferung_stadt“: „Bratislava“,
„Lieferland“,
„Zustellungsmethode“,
„lieferung_name“,
„Lieferstraße“: „5 Main Street“,
„lieferung_zip“: „01001“,
„dic_purchaser“: „1234567890“,
„dic_supplier“: „1234567890“,
„Wechselkurs“: 1,
„icdph_supplier“: „SK1234567890“,
„ico_purchaser“: „12345678“,
„ico_lieferant“: „12345678“,
„invoice_lines“: [
{
„Betrag“: 1,
„MEHRWERTSTEUER“: 23,
„Lieferart“: „Dienstleistungen“,
„gewünschte_summe“: 195.10,
„idx“: „1“,
„itemInfo“: „Dienstleistungspaket 06/2025“
},
{
„Betrag“: 1,
„MEHRWERTSTEUER“: 23,
„Lieferart“: „Dienstleistungen“,
„gewünschte_gesamtsumme“: 18.44,
„idx“: „2“,
„itemInfo“: „Kontoführung 06/2025“
}
],
„Sprache“,
„Nachricht“: „Rechnung für erbrachte Dienstleistungen“,
„Name_Käufer“,
„Name_Lieferant“,
„Absatz-Lieferant“: „4“,
„Zahlungsmethode“: „Banküberweisung“,
„Unterschrift“: true,
„zip_purchaser“: „01001“,
„zip_lieferant“: „01002“,
„delivery_date“: „2025-06-30T00:00:00.000+00:00“,
„expiration_date“: „2025-07-14T00:00:00.000+00:00“,
„iban“: „SK0000000000000000000000“,
„Rechnungsnummer“: „20250687“,
„variable_symbol“: „3001827867“
}‘


Erwartete Antwort

  „abc123“

Mögliche Antwortcodes:

CodeBeschreibung
201Erstellt.
400Fehlerhafte Anfrage. Die Belegnummer ist bereits vorhanden oder die Verknüpfung mit den Belegen ist fehlgeschlagen.
401Nicht eingeloggt.
403Nicht erlaubt.
422Fehler bei der Eingabeüberprüfung.

Kontaktieren Sie uns, wenn Sie die Antwort nicht gefunden haben

Mo - Fr von 08:00 - 16:00