Do you have any questions? Write to info@numiron.sk

Numiron support

Numiron Support & FAQ

Group 957 (1)
integrate

Personal tax return

home

Getting Started

pie-chart-analysis

Views

Frame 7718

Invoicing

bar-chart-analysis

Cost

Frame 7715

Finance

user

Settings

percent-badge

Data

user

Subscription

Frame 7718

Integrations

Contact us if you haven't found the answer

Mon - Fri from 08:00 - 16:00

Numiron

/

Support

/

/

Numiron Public API - Invoice creation (basic documentation)

Numiron Public API - Invoice creation (basic documentation)

4 min.

Written by

Endpoint & Auth

  • POST /api/public/v1/assigned_companies/{assigned_company_id}/invoices

How to get {assigned_company_id} please refer to this guide.

  • Headers:
    • Authorization: Bearer
    • Accept: application/json
    • Content-Type: application/json
  • Date format: ISO-8601, e.g. 2025-06-30T00:00:00.000+00:00
  • Currency: ISO-4217, e.g. EUR
FieldTypeRequiredDescriptionExampleEnum / Note
address_purchaserstringCustomer's address - street and number.Main street 5
address_supplierstringMy address - street and number.Main street 5
city_purchaserstringCity of the customer.Bratislava
city_supplierstringMy place.Bratislava
client_emailsarrayList of client emails (recipients).Each item has email: string (e.g. client@client.com).
constant_symbolstringConstant document symbol.1234
country_purchaserstringCountry of customer (ISO 3166-1 alpha-2).EN
country_supplierstringMy country (ISO 3166-1 alpha-2).EN
creation_datestring (datetime)Date of issue.2025-08-26T07:59:41.920ZISO-8601
currencystringCurrency (ISO 4217 code).CZK
delivery_citystringCity of delivery address.Bratislava
delivery_countrystringCountry of delivery address (ISO-2).EN
delivery_methodstringMethod of delivery.in_personby_courier, electronically, in_person, own_transport
delivery_namestringName/contact at the delivery address.Milan Malinový
delivery_streetstringStreet and delivery address number.Main street 5
delivery_zipstringThe postcode of the delivery address.12345
dic_purchaserstringthe customer's VAT number.1234567890
dic_supplierstringMy VAT number.1234567890
exchange_ratenumberForeign currency exchange rate against EUR.25.123
icdph_purchaserstringVAT number of the customer.SK1234567890
icdph_supplierstringMy VAT number.SK1234567890
ico_purchaserstringCustomer ID.12345678
ico_supplierstringMy ID.12345678
invoice_linesarrayDocument items (see table below).
languagestringDocument language.ENDE, EN, EN
messagestringMain text (after „We invoice you“).under contract...
name_purchaserstringName of the customer.Company s.r.o.
name_supplierstringMy name.Company s.r.o.
notestringInternal note to the document.The customer wanted gift wrapping.
order_numberstringOrder number.123ABC
ossbooleanOSS (One Stop Shop) mode.false
paragraph_purchaserstringParagraph of the customer's VAT registration.4
paragraph_supplierstringParagraph of my VAT registration.4
payment_methodstringMethod of payment.bank_transferadvance_payment, bank_transfer, by_compensation, card, cash, cash_on_delivery
save_clientbooleanSave the client to the directory.false
signaturebooleanSignature/stamps on PDF.false
zip_purchaserstringthe postcode of the customer.12345
zip_supplierstringMy zip code.12345
delivery_datestring (datetime)Date of delivery (DUZP).2025-08-26T07:59:41.920ZISO-8601
delivery_notebooleanAlso create a delivery note.false
expiration_datestring (datetime)Due Date.2025-08-26T07:59:41.920ZISO-8601
ibanstring (IBAN)IBAN of the document.SK0000000000000000000000Valid IBAN
invoice_numberstringDocument number.20250001Unique in the series
variable_symbolstringVariable symbol.1234123477

Items

FieldTypeRequired DescriptionExampleEnum / Note
activitystringActivity (for the dashboard „Sales by activity“).Act 1
amountnumberQuantity of the item.1
VATnumberVAT rate in %.23
given_obligationstringTax mode for 0% line.transfer_15exemption_from_tax_liability, transfer_15, transfer_16, triangular_trade, Exception
delivery_typestringType of performance.servicese.g. goods, services, ...
departmentstringCentre (for the dashboard „Sales by Centre“).Depot 1
discount_one_rownumberDiscount on the item in %.10
desired_totalnumberThe final amount of the item.1.23Usually with VAT
idxstringUnique index of the item within the document.1
itemInfostringText/title of the item.apples
measureUnitstringUnit of measurement.ks
orderstringContract (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:

CodeDescription
201Created.
400Bad request. Document number already exists or pairing to documents failed.
401Not logged in.
403Not allowed.
422Input validation error.

Contact us if you haven't found the answer

Mon - Fri from 08:00 - 16:00