Numiron support
Numiron Support & FAQ

Numiron Support & FAQ

Contact us if you haven't found the answer
Mon - Fri from 08:00 - 16:00
Endpoint & Auth
How to get {assigned_company_id} please refer to this guide.
| Field | Type | Required | Description | Example | Enum / Note |
|---|---|---|---|---|---|
| address_purchaser | string | ✅ | Customer's address - street and number. | Main street 5 | |
| address_supplier | string | ✅ | My address - street and number. | Main street 5 | |
| city_purchaser | string | ✅ | City of the customer. | Bratislava | |
| city_supplier | string | ✅ | My place. | Bratislava | |
| client_emails | array | List of client emails (recipients). | Each item has email: string (e.g. client@client.com). | ||
| constant_symbol | string | Constant document symbol. | 1234 | ||
| country_purchaser | string | ✅ | Country of customer (ISO 3166-1 alpha-2). | EN | |
| country_supplier | string | My country (ISO 3166-1 alpha-2). | EN | ||
| creation_date | string (datetime) | ✅ | Date of issue. | 2025-08-26T07:59:41.920Z | ISO-8601 |
| currency | string | ✅ | Currency (ISO 4217 code). | CZK | |
| delivery_city | string | City of delivery address. | Bratislava | ||
| delivery_country | string | Country of delivery address (ISO-2). | EN | ||
| delivery_method | string | ✅ | Method of delivery. | in_person | by_courier, electronically, in_person, own_transport |
| delivery_name | string | Name/contact at the delivery address. | Milan Malinový | ||
| delivery_street | string | Street and delivery address number. | Main street 5 | ||
| delivery_zip | string | The postcode of the delivery address. | 12345 | ||
| dic_purchaser | string | the customer's VAT number. | 1234567890 | ||
| dic_supplier | string | My VAT number. | 1234567890 | ||
| exchange_rate | number | ✅ | Foreign currency exchange rate against EUR. | 25.123 | |
| icdph_purchaser | string | VAT number of the customer. | SK1234567890 | ||
| icdph_supplier | string | My VAT number. | SK1234567890 | ||
| ico_purchaser | string | Customer ID. | 12345678 | ||
| ico_supplier | string | My ID. | 12345678 | ||
| invoice_lines | array | ✅ | Document items (see table below). | ||
| language | string | ✅ | Document language. | EN | DE, EN, EN |
| message | string | Main text (after „We invoice you“). | under contract... | ||
| name_purchaser | string | ✅ | Name of the customer. | Company s.r.o. | |
| name_supplier | string | ✅ | My name. | Company s.r.o. | |
| note | string | Internal note to the document. | The customer wanted gift wrapping. | ||
| order_number | string | Order number. | 123ABC | ||
| oss | boolean | OSS (One Stop Shop) mode. | false | ||
| paragraph_purchaser | string | Paragraph of the customer's VAT registration. | 4 | ||
| paragraph_supplier | string | Paragraph of my VAT registration. | 4 | ||
| payment_method | string | ✅ | Method of payment. | bank_transfer | advance_payment, bank_transfer, by_compensation, card, cash, cash_on_delivery |
| save_client | boolean | Save the client to the directory. | false | ||
| signature | boolean | Signature/stamps on PDF. | false | ||
| zip_purchaser | string | ✅ | the postcode of the customer. | 12345 | |
| zip_supplier | string | ✅ | My zip code. | 12345 | |
| delivery_date | string (datetime) | ✅ | Date of delivery (DUZP). | 2025-08-26T07:59:41.920Z | ISO-8601 |
| delivery_note | boolean | Also create a delivery note. | false | ||
| expiration_date | string (datetime) | ✅ | Due Date. | 2025-08-26T07:59:41.920Z | ISO-8601 |
| iban | string (IBAN) | ✅ | IBAN of the document. | SK0000000000000000000000 | Valid IBAN |
| invoice_number | string | ✅ | Document number. | 20250001 | Unique in the series |
| variable_symbol | string | ✅ | Variable symbol. | 1234123477 |
| Field | Type | Required | Description | Example | Enum / Note |
|---|---|---|---|---|---|
| activity | string | Activity (for the dashboard „Sales by activity“). | Act 1 | ||
| amount | number | ✅ | Quantity of the item. | 1 | |
| VAT | number | ✅ | VAT rate in %. | 23 | |
| given_obligation | string | Tax mode for 0% line. | transfer_15 | exemption_from_tax_liability, transfer_15, transfer_16, triangular_trade, Exception | |
| delivery_type | string | Type of performance. | services | e.g. goods, services, ... | |
| department | string | Centre (for the dashboard „Sales by Centre“). | Depot 1 | ||
| discount_one_row | number | ✅ | Discount on the item in %. | 10 | |
| desired_total | number | ✅ | The final amount of the item. | 1.23 | Usually with VAT |
| idx | string | ✅ | Unique index of the item within the document. | 1 | |
| itemInfo | string | ✅ | Text/title of the item. | apples | |
| measureUnit | string | Unit of measurement. | ks | ||
| order | string | Contract (for the dashboard „Sales by Contract“). | Order 1 |
Note: For desired_total, the system will calculate unit prices and rounding according to the current rules.
cURL example (template)
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“: „5 Main Street“,
„address_supplier“: „10 Industrial Ave“,
„city_purchaser“: „Bratislava“,
„city_supplier“: „Bratislava“,
„client_emails“: [ „client@example.com“ ],
„country_purchaser“: „en“,
„country_supplier“: „en“,
„creation_date“: „2025-06-30T00:00:00.000+00:00“,
„currency“: „EUR“,
„delivery_city“: „Bratislava“,
„delivery_country“,
„delivery_method“,
„delivery_name“,
„delivery_street“: „5 Main Street“,
„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,
„VAT“: 23,
„delivery_type“: „services“,
„desired_total“: 195.10,
„idx“: „1“,
„itemInfo“: „Service package 06/2025“
},
{
„amount“: 1,
„VAT“: 23,
„delivery_type“: „services“,
„desired_total“: 18.44,
„idx“: „2“,
„itemInfo“: „Account maintenance 06/2025“
}
],
„language“,
„message“: „Billing invoice for services rendered“,
„name_purchaser“,
„name_supplier“,
„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“
}‘
Expected answer
„abc123“
Possible answer codes:
| 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. |
Contact us if you haven't found the answer
Mon - Fri from 08:00 - 16:00