Podpora Numiron
Numiron Podpora & časté otázky

Numiron Podpora & časté otázky

Kontaktujte nás ak ste nenašli odpoveď
Po - Pia od 08:00 - 16:00
Endpoint & Auth
Ako získať {assigned_company_id} nájdete v tomto návode.
| Pole | Typ | Povinné | Popis | Príklad | Enum / Poznámka |
|---|---|---|---|---|---|
| address_purchaser | string | ✅ | Adresa odberateľa – ulica a číslo. | Main street 5 | |
| address_supplier | string | ✅ | Moja adresa – ulica a číslo. | Main street 5 | |
| city_purchaser | string | ✅ | Mesto odberateľa. | Bratislava | |
| city_supplier | string | ✅ | Moje mesto. | Bratislava | |
| client_emails | array<object> | Zoznam e-mailov klienta (adresátov). | Každá položka má email: string (napr. client@client.com). | ||
| constant_symbol | string | Konštantný symbol dokumentu. | 1234 | ||
| country_purchaser | string | ✅ | Krajina odberateľa (ISO 3166-1 alpha-2). | SK | |
| country_supplier | string | Moja krajina (ISO 3166-1 alpha-2). | SK | ||
| creation_date | string (datetime) | ✅ | Dátum vystavenia. | 2025-08-26T07:59:41.920Z | ISO-8601 |
| currency | string | ✅ | Mena (ISO 4217 kód). | CZK | |
| delivery_city | string | Mesto dodacej adresy. | Bratislava | ||
| delivery_country | string | Krajina dodacej adresy (ISO-2). | SK | ||
| delivery_method | string | ✅ | Spôsob dodania. | in_person | by_courier, electronically, in_person, own_transport |
| delivery_name | string | Meno/kontakt na dodacej adrese. | Milan Malinový | ||
| delivery_street | string | Ulica a číslo dodacej adresy. | Main street 5 | ||
| delivery_zip | string | PSČ dodacej adresy. | 12345 | ||
| dic_purchaser | string | DIČ odberateľa. | 1234567890 | ||
| dic_supplier | string | Moje DIČ. | 1234567890 | ||
| exchange_rate | number | ✅ | Kurz cudzej meny voči EUR. | 25.123 | |
| icdph_purchaser | string | IČ DPH odberateľa. | SK1234567890 | ||
| icdph_supplier | string | Moje IČ DPH. | SK1234567890 | ||
| ico_purchaser | string | IČO odberateľa. | 12345678 | ||
| ico_supplier | string | Moje IČO. | 12345678 | ||
| invoice_lines | array<object> | ✅ | Položky dokumentu (viď tabuľka nižšie). | ||
| language | string | ✅ | Jazyk dokumentu. | SK | DE, EN, SK |
| message | string | Hlavný text (za „Fakturujeme Vám“). | na základe zmluvy... | ||
| name_purchaser | string | ✅ | Názov/meno odberateľa. | Company s.r.o. | |
| name_supplier | string | ✅ | Môj názov/meno. | Company s.r.o. | |
| note | string | Interná poznámka k dokladu. | Zákazník chcel darčekové balenie. | ||
| order_number | string | Číslo objednávky. | 123ABC | ||
| oss | boolean | Režim OSS (One Stop Shop). | false | ||
| paragraph_purchaser | string | Paragraf registrácie DPH odberateľa. | 4 | ||
| paragraph_supplier | string | Paragraf mojej registrácie DPH. | 4 | ||
| payment_method | string | ✅ | Spôsob úhrady. | bank_transfer | advance_payment, bank_transfer, by_compensation, card, cash, cash_on_delivery |
| save_client | boolean | Uložiť klienta do adresára. | false | ||
| signature | boolean | Podpis/pečiatka na PDF. | false | ||
| zip_purchaser | string | ✅ | PSČ odberateľa. | 12345 | |
| zip_supplier | string | ✅ | Moje PSČ. | 12345 | |
| delivery_date | string (datetime) | ✅ | Dátum dodania (DUZP). | 2025-08-26T07:59:41.920Z | ISO-8601 |
| delivery_note | boolean | Vytvoriť aj dodací list. | false | ||
| expiration_date | string (datetime) | ✅ | Dátum splatnosti. | 2025-08-26T07:59:41.920Z | ISO-8601 |
| iban | string (IBAN) | ✅ | IBAN dokladu. | SK0000000000000000000000 | Validný IBAN |
| invoice_number | string | ✅ | Číslo dokladu. | 20250001 | Unikátne v rade |
| variable_symbol | string | ✅ | Variabilný symbol. | 1234123477 |
| Pole | Typ | Povinné | Popis | Príklad | Enum / Poznámka |
|---|---|---|---|---|---|
| activity | string | Činnosť (pre dashboard „Tržby podľa činnosti“). | Act 1 | ||
| amount | number | ✅ | Množstvo položky. | 1 | |
| DPH | number | ✅ | Sadzba DPH v %. | 23 | |
| danova_povinnost | string | Daňový režim pre 0% riadok. | prenesenie_15 | oslobodenie_danovej_povinnosti, prenesenie_15, prenesenie_16, trojstranny_obchod, vynimka | |
| delivery_type | string | Typ plnenia. | services | napr. goods, services, … | |
| department | string | Stredisko (pre dashboard „Tržby podľa strediska“). | Dep 1 | ||
| discount_one_row | number | ✅ | Zľava na položke v %. | 10 | |
| desired_total | number | ✅ | Finálna suma položky. | 1.23 | Zvyčajne s DPH |
| idx | string | ✅ | Unikátny index položky v rámci dokladu. | 1 | |
| itemInfo | string | ✅ | Text/názov položky. | apples | |
| measureUnit | string | Merná jednotka. | ks | ||
| order | string | Zákazka (pre dashboard „Tržby podľa zákazky“). | Ord 1 |
Pozn.: Pri desired_total systém dopočíta jednotkové ceny a zaokrúhlenie podľa aktuálnych pravidiel.
cURL príklad (šablóna)
curl -X POST \
‚https://my.numiron.sk/api/public/v1/assigned_companies/{ASSIGNED_COMPANY_ID}/invoices‘ \
-H ‚accept: application/json‘ \
-H ‚authorization: Bearer ‚ \
-H ‚Content-Type: application/json‘ \
-d ‚{
„address_purchaser“: „Main Street 5“,
„address_supplier“: „Industrial Ave 10“,
„city_purchaser“: „Bratislava“,
„city_supplier“: „Bratislava“,
„client_emails“: [„client@example.com“],
„country_purchaser“: „SK“,
„country_supplier“: „SK“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„currency“: „EUR“,
„delivery_city“: „Bratislava“,
„delivery_country“: „SK“,
„delivery_method“: „in_person“,
„delivery_name“: „Contact Person“,
„delivery_street“: „Main Street 5“,
„delivery_zip“: „01001“,
„dic_purchaser“: „1234567890“,
„dic_supplier“: „1234567890“,
„exchange_rate“: 1,
„icdph_supplier“: „SK1234567890“,
„ico_purchaser“: „12345678“,
„ico_supplier“: „12345678“,
„invoice_lines“: [
{
„amount“: 1,
„DPH“: 23,
„delivery_type“: „services“,
„desired_total“: 195.10,
„idx“: „1“,
„itemInfo“: „Service package 06/2025“
},
{
„amount“: 1,
„DPH“: 23,
„delivery_type“: „services“,
„desired_total“: 18.44,
„idx“: „2“,
„itemInfo“: „Account maintenance 06/2025“
}
],
„language“: „SK“,
„message“: „Vyúčtovacia faktúra za poskytované služby“,
„name_purchaser“: „Customer s.r.o.“,
„name_supplier“: „Supplier s.r.o.“,
„paragraph_supplier“: „4“,
„payment_method“: „bank_transfer“,
„signature“: true,
„zip_purchaser“: „01001“,
„zip_supplier“: „01002“,
„delivery_date“: „2025-06-30T00:00:00.000+00:00“,
„expiration_date“: „2025-07-14T00:00:00.000+00:00“,
„iban“: „SK0000000000000000000000“,
„invoice_number“: „20250687“,
„variable_symbol“: „3001827867“
}‘
Očakávaná odpoveď
„abc123“
Možné kódy odpovedí:
| Code | Description |
| 201 | Created. |
| 400 | Bad request. Document number already exists or pairing to documents failed. |
| 401 | Not logged in. |
| 403 | Not allowed. |
| 422 | Input validation error. |
Kontaktujte nás ak ste nenašli odpoveď
Po - Pia od 08:00 - 16:00