Бади АПИ документација (3.0.0)

Download OpenAPI specification:Download

Документација за приступ платформи Бади путем АПИ сервиса.

⚠️ Напомена: АПИ документација још увек није комплетна.

Увод

Добродошли на Бади АПИ документацију. Можете користити Бади АПИ за приступ ресурсима на платформи и за фискализацију рачуна.

Окружења

Доступна су два окружења:

Sandbox, користи се у сврху тестирања и развоја. Адреса АПИ сервиса је https://api.sandbox.badi.rs/v2 а адреса за приступ апликацији је https://sandbox.badi.rs
Production, продукцијско окружење. Адреса АПИ сервиса је https://api.production.badi.rs/v2 а адреса за приступ апликацији је https://app.badi.rs

Верзија АПИ сервиса

Тренутно активна верзија АПИ сервиса је v2

Локални АПИ сервер

Од верзије 3.2.0, на апликацији је могуће укључити локални АПИ сервер. Путем овог сервера је могуће приступати само ресурсима за фискализацију. Ресурсима се приступа путем HTTP протокола на адреси и порту који је конфигурисан у апликацији, без верзије АПИ сервиса, на пример: http://127.0.0.1:9999/fiscalization/receipts.

Локалном АПИ серверу се приступа без аутентификације, и приликом захтева се не прослећује clientId или storeId.

Аутентификација

Аутентификација се не односи на локални АПИ

Како бисте могли да користите АПИ, потребно је да креирате АПИ кључ и АПИ тајну у подешавањима апликације Бади. Више информација можете наћи на https://badi.rs/docs/koriscenje/moduli-aplikacije/podesavanja/aplikacije/za-programere/api-kljucevi/.

Пажња: АПИ тајна ће бити приказана само једном приликом креирања АПИ кључа. Уколико изгубите АПИ тајну, мораћете да је рекреирате.

АПИ кључ и тајна морају бити послати при сваком захтеву кроз Authorization header. Садржај овог поља се шаље као base64 кодиран АПИ кључ и тајна у формату API_KEY:API_SECRET.

На пример, ако је ваш АПИ кључ production.6BO7smrNTMCpugLBzPSVdX а АПИ тајна 6cuiEePSXps0xdHjm4SeQp, саставите их као production.6BO7smrNTMCpugLBzPSVdX:6cuiEePSXps0xdHjm4SeQp и кодирајте их као base64. Добићете вредност cHJvZHVjdGlvbi42Qk83c21yTlRNQ3B1Z0xCelBTVmRYOjZjdWlFZVBTWHBzMHhkSGptNFNlUXA=.

Тако добијену вредност поставите у Authorization header у формату
Basic cHJvZHVjdGlvbi42Qk83c21yTlRNQ3B1Z0xCelBTVmRYOjZjdWlFZVBTWHBzMHhkSGptNFNlUXA=.

Продајна места

Листа продајних места

Листа свих продајних места везаних за налог

⚠️ Ова метода враћа сва продајна места без пагинације

Authorizations:

BasicAuth

Responses

Response samples

200

Content type

application/json

[{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}
]

Додавање продајног места

⚠️ Коришћење апликације Бади се наплаћује по продајном месту, тако да будите сигурни да ли желите да додате ново продајно место.

Authorizations:

BasicAuth

Request Body schema: application/json

name required	string non-empty Назив
address	string Адреса
city	string Град
zip	string Поштански број
gln	string ГЛН
phone	string Број телефона
language	any Default: "sr-Cyrl-RS" Enum: "sr-Cyrl-RS" "sr-Latn-RS" Језик на ком се издаје фискални рачун
	object Доступни начини издавања фискалног рачуна
printBankAccounts	boolean Штампа текућих рачуна уколико је начин плаћања пренос на рачун
printDiscounts	boolean Штампа остварених попуста
paymentMethodsOrder	Array of arrays Редослед начина плаћања на прозору за плаћање
productPickerType	string Enum: "list" "grid" Начин приказа производа на каси
isSoundEnabled	boolean Репродукција звучних сигнала при куцању артикала
defaultUnknownAmountAdvance	boolean Да ли је подразумевано укључена опција за аванс без познатог коначног износа

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Response samples

201
400

Content type

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Измена продајног места

Authorizations:

BasicAuth

path Parameters

required

Id (string)

ИД продајног места

Request Body schema: application/json

name required	string non-empty Назив
address	string Адреса
city	string Град
zip	string Поштански број
gln	string ГЛН
phone	string Број телефона
language	any Default: "sr-Cyrl-RS" Enum: "sr-Cyrl-RS" "sr-Latn-RS" Језик на ком се издаје фискални рачун
	object Доступни начини издавања фискалног рачуна
printBankAccounts	boolean Штампа текућих рачуна уколико је начин плаћања пренос на рачун
printDiscounts	boolean Штампа остварених попуста
paymentMethodsOrder	Array of arrays Редослед начина плаћања на прозору за плаћање
productPickerType	string Enum: "list" "grid" Начин приказа производа на каси
isSoundEnabled	boolean Репродукција звучних сигнала при куцању артикала
defaultUnknownAmountAdvance	boolean Да ли је подразумевано укључена опција за аванс без познатог коначног износа

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Response samples

200
400
404

Content type

application/json

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Брисање продајног места

Authorizations:

BasicAuth

path Parameters

required

Id (string)

ИД продајног места

Request Body schema: application/json

name required	string non-empty Назив
address	string Адреса
city	string Град
zip	string Поштански број
gln	string ГЛН
phone	string Број телефона
language	any Default: "sr-Cyrl-RS" Enum: "sr-Cyrl-RS" "sr-Latn-RS" Језик на ком се издаје фискални рачун
	object Доступни начини издавања фискалног рачуна
printBankAccounts	boolean Штампа текућих рачуна уколико је начин плаћања пренос на рачун
printDiscounts	boolean Штампа остварених попуста
paymentMethodsOrder	Array of arrays Редослед начина плаћања на прозору за плаћање
productPickerType	string Enum: "list" "grid" Начин приказа производа на каси
isSoundEnabled	boolean Репродукција звучних сигнала при куцању артикала
defaultUnknownAmountAdvance	boolean Да ли је подразумевано укључена опција за аванс без познатог коначног износа

Responses

Request samples

Payload

Content type

application/json

{"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Response samples

200
400
404

Content type

application/json

{ }

Артикли

Листа артикала

Листа свих артикала

⚠️ Ова метода враћа све артикле без пагинације

Authorizations:

BasicAuth

Responses

Response samples

200

Content type

application/json

[{"variants": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
}
]

Додавање артикла

Authorizations:

BasicAuth

Request Body schema: application/json

	Array of objects
name required	string non-empty Назив
sku	number Шифра
manufacturerSku	string Шифра произвођача
description	string Опис у HTML формату
saleUnitId	string <uuid> Продајна јединица мере
baseUnitId	string <uuid> Јединица мере у којој је исказана количина производа
quantityPerBaseUnit	number Количина у јединици мере
price	number Цена са ПДВ-ом
taxRateLabel required	string Enum: "Ђ" "Е" "Г" "А" Пореска ознака
subtitle	string Кратак опис
productType	string Enum: "product" "service" "digital" Врста артикла
weight	number Маса
dimensions	string Димензије у центиметрима, у формату ШИРИНАxДУБИНАxВИСИНА
hasVariants	boolean Артикал има варијанте
variantName	string Назив варијанте, само уколико је артикал варијанта
ean	string ГТИН артикла
categories	Array of strings <uuid> [ items <uuid > ] ИД-еви категорија у којима се налази артикал
createdAt	string <date-time> Датум и време креирања
updatedAt	string <date-time> Датум и време измене
deletedAt	string <date-time> Датум и време брисања
images	Array of strings <uuid> (Id) [ items <uuid > ] ИД-еви фајлова

Responses

Request samples

Payload

Content type

application/json

{"variants": [{"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z",
"images": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}

Response samples

201
400

Content type

application/json

{"variants": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
}

Измена артикла

Authorizations:

BasicAuth

path Parameters

required

Id (string)

ИД артикла

Request Body schema: application/json

	Array of objects
name required	string non-empty Назив
sku	number Шифра
manufacturerSku	string Шифра произвођача
description	string Опис у HTML формату
saleUnitId	string <uuid> Продајна јединица мере
baseUnitId	string <uuid> Јединица мере у којој је исказана количина производа
quantityPerBaseUnit	number Количина у јединици мере
price	number Цена са ПДВ-ом
taxRateLabel required	string Enum: "Ђ" "Е" "Г" "А" Пореска ознака
subtitle	string Кратак опис
productType	string Enum: "product" "service" "digital" Врста артикла
weight	number Маса
dimensions	string Димензије у центиметрима, у формату ШИРИНАxДУБИНАxВИСИНА
hasVariants	boolean Артикал има варијанте
variantName	string Назив варијанте, само уколико је артикал варијанта
ean	string ГТИН артикла
categories	Array of strings <uuid> [ items <uuid > ] ИД-еви категорија у којима се налази артикал
createdAt	string <date-time> Датум и време креирања
updatedAt	string <date-time> Датум и време измене
deletedAt	string <date-time> Датум и време брисања
images	Array of strings <uuid> (Id) [ items <uuid > ] ИД-еви фајлова

Responses

Request samples

Payload

Content type

application/json

{"variants": [{"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z",
"images": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}

Response samples

200
400
404

Content type

application/json

{"variants": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
}

Брисање артикла

Authorizations:

BasicAuth

path Parameters

required

Id (string)

ИД Artikla

Request Body schema: application/json

	Array of objects
name required	string non-empty Назив
sku	number Шифра
manufacturerSku	string Шифра произвођача
description	string Опис у HTML формату
saleUnitId	string <uuid> Продајна јединица мере
baseUnitId	string <uuid> Јединица мере у којој је исказана количина производа
quantityPerBaseUnit	number Количина у јединици мере
price	number Цена са ПДВ-ом
taxRateLabel required	string Enum: "Ђ" "Е" "Г" "А" Пореска ознака
subtitle	string Кратак опис
productType	string Enum: "product" "service" "digital" Врста артикла
weight	number Маса
dimensions	string Димензије у центиметрима, у формату ШИРИНАxДУБИНАxВИСИНА
hasVariants	boolean Артикал има варијанте
variantName	string Назив варијанте, само уколико је артикал варијанта
ean	string ГТИН артикла
categories	Array of strings <uuid> [ items <uuid > ] ИД-еви категорија у којима се налази артикал
createdAt	string <date-time> Датум и време креирања
updatedAt	string <date-time> Датум и време измене
deletedAt	string <date-time> Датум и време брисања

Responses

Request samples

Payload

Content type

application/json

{"variants": [{"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
}

Response samples

200
400
404

Content type

application/json

{ }

Фискализација

Фискализација рачуна је могућа у следећим режимима:

Употребом ЛПФР-а или ВПФР-а путем јавног АПИ-ја уз коришћење апликације која је покренута на вашем рачунару, захтева сталну интернет везу
Употребом ЛПФР-а или ВПФР-а путем локалног АПИ-ја уз коришћење апликације која је покренута на вашем рачунару, интернет веза није неопходна
Употребом ВПФР-а уз коришћење сертификата (у изради)

Издавање фискалног рачуна

Authorizations:

BasicAuth

Request Body schema: application/json

storeId	string <uuid> Deprecated Продајно место које се користи за издавање фискалног рачуна. Само једна апликација може бити отворена по продајном месту, како би рачун био издат. Из овог разлога препоручујемо да користите `clientId` уместо `storeId`.
clientId	string <uuid> Клијент који се користи за издавање рачуна.
invoiceType required	any <string> Enum: "normal" "advance" "proforma" "training" Врста рачуна
transactionType required	any <string> Enum: "sale" "refund" Врста трансацкије
buyerId	string ИД купца, мора бити у складу са шифраником
buyerCostCenterId	string Опционо поље купца, мора бити у складу са шифраником
required	object non-empty Начини плаћања фискалног рачуна
referentDocumentNumber	string^a-zA-Z-0-9{8}\-a-zA-Z-0-9{8}\-\d+$ Број референтног документа. Користите само у случају потребе ручног референцирања рачуна, у свим осталим случајевима користите АПИ методе за вршење акција над фискалним рачунима.
referentDocumentDT	string <date-time> Датум референтног документа. Користите само у случају када шаљете `referentDocumentNumber`.
posTime	string <date-time> ЕСИР време, користите када је уплата аванса настала ранијег датума
required	Array of objects non-empty Ставке фискалног рачуна
unknownAmountAdvance	boolean Издавање аванса без познатог коначног износа. Додавање авансних уплата неће бити ограничено. Потребно је унети спецификацију уплата по пореским ознакама уколико се на рачуну налази више од једне пореске ознаке.
	object Спецификација уплата по пореским ознакама. Обавезно је само када се на фискалном рачуну налази више пореских ознака и коначан износ није познат.
discount	number Попуст на целом рачуну. Напомена: попуст се примењује на свакој ставци појединачно, па може доћи одступања у односу на износ који се добија када би се попуст применио на коначном износу рачуна.
additionalText	string Додатни текст који ће се штампати након фискалног рачуна
required	object non-empty Начин издавања фискалног рачуна

Responses

Request samples

Payload

Content type

application/json

{"storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",
"clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
"invoiceType": "normal",
"transactionType": "sale",
"buyerId": "string",
"buyerCostCenterId": "string",
"payments": {"cash": 0,
"card": 0,
"check": 0,
"mobilemoney": 0,
"wiretransfer": 0,
"voucher": 0,
"other": 0
},
"referentDocumentNumber": "string",
"referentDocumentDT": "2019-08-24T14:15:22Z",
"posTime": "2019-08-24T14:15:22Z",
"items": [{"sku": 1,
"quantity": 0.01,
"unitPrice": 0
}
],
"unknownAmountAdvance": true,
"advanceSpecification": {"Ђ": 0,
"Е": 0,
"Г": 0,
"А": 0
},
"discount": 0,
"additionalText": "string",
"receiptDelivery": {"thermalPrinter": true,
"a4Printer": true,
"email": "user@example.com",
"pdf": true,
"base64pdf": true
}
}

Response samples

200
400
500

Content type

application/json

{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}

Додавање авансне уплате

Authorizations:

BasicAuth

path Parameters

required

Id (string) or string

ИД или број фискалног рачуна

Request Body schema: application/json

storeId	string <uuid> Deprecated Продајно место које се користи за издавање фискалног рачуна. Само једна апликација може бити отворена по продајном месту, како би рачун био издат. Из овог разлога препоручујемо да користите `clientId` уместо `storeId`.
clientId	string <uuid> Клијент који се користи за издавање рачуна.
buyerId	string ИД купца, мора бити у складу са шифраником
buyerCostCenterId	string Опционо поље купца, мора бити у складу са шифраником
required	object non-empty Начини плаћања фискалног рачуна
posTime	string <date-time> ЕСИР време, користите када је уплата аванса настала ранијег датума
	object Спецификација уплата по пореским ознакама. Обавезно је само када се на фискалном рачуну налази више пореских ознака и коначан износ није познат.
additionalText	string Додатни текст који ће се штампати након фискалног рачуна
required	object non-empty Начин издавања фискалног рачуна

Responses

Request samples

Payload

Content type

application/json

{"storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",
"clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
"buyerId": "string",
"buyerCostCenterId": "string",
"payments": {"cash": 0,
"card": 0,
"check": 0,
"mobilemoney": 0,
"wiretransfer": 0,
"voucher": 0,
"other": 0
},
"posTime": "2019-08-24T14:15:22Z",
"advanceSpecification": {"Ђ": 0,
"Е": 0,
"Г": 0,
"А": 0
},
"additionalText": "string",
"receiptDelivery": {"thermalPrinter": true,
"a4Printer": true,
"email": "user@example.com",
"pdf": true,
"base64pdf": true
}
}

Response samples

200
400
404
500

Content type

application/json

{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}

Затварање аванса

Authorizations:

BasicAuth

path Parameters

required

Id (string) or string

ИД или број фискалног рачуна

Request Body schema: application/json

storeId	string <uuid> Deprecated Продајно место које се користи за издавање фискалног рачуна. Само једна апликација може бити отворена по продајном месту, како би рачун био издат. Из овог разлога препоручујемо да користите `clientId` уместо `storeId`.
clientId	string <uuid> Клијент који се користи за издавање рачуна.
buyerId	string ИД купца, мора бити у складу са шифраником
buyerCostCenterId	string Опционо поље купца, мора бити у складу са шифраником
required	object Начини плаћања фискалног рачуна
	Array of objects non-empty Ставке рачуна, шаље се уколико је непознат коначан износ авансног рачуна и на рачуну постоји више ставки.
additionalText	string Додатни текст који ће се штампати након фискалног рачуна
required	object non-empty Начин издавања фискалног рачуна

Responses

Request samples

Payload

Content type

application/json

{"storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",
"clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
"buyerId": "string",
"buyerCostCenterId": "string",
"payments": {"cash": 0,
"card": 0,
"check": 0,
"mobilemoney": 0,
"wiretransfer": 0,
"voucher": 0,
"other": 0
},
"items": [{"sku": 1,
"quantity": 0.01,
"unitPrice": 0
}
],
"additionalText": "string",
"receiptDelivery": {"thermalPrinter": true,
"a4Printer": true,
"email": "user@example.com",
"pdf": true,
"base64pdf": true
}
}

Response samples

200
400
404
500

Content type

application/json

[{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}
]

Издавање копије фискалног рачуна

Authorizations:

BasicAuth

path Parameters

required

Id (string) or string

ИД или број фискалног рачуна

Request Body schema: application/json

storeId	string <uuid> Deprecated Продајно место које се користи за издавање фискалног рачуна. Само једна апликација може бити отворена по продајном месту, како би рачун био издат. Из овог разлога препоручујемо да користите `clientId` уместо `storeId`.
clientId	string <uuid> Клијент који се користи за издавање рачуна.
required	object non-empty Начин издавања фискалног рачуна

Responses

Request samples

Payload

Content type

application/json

{"storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",
"clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
"receiptDelivery": {"thermalPrinter": true,
"a4Printer": true,
"email": "user@example.com",
"pdf": true,
"base64pdf": true
}
}

Response samples

200
400
404
500

Content type

application/json

{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}

Рефундација

Authorizations:

BasicAuth

path Parameters

required

Id (string) or string

ИД или број фискалног рачуна

Request Body schema: application/json

storeId	string <uuid> Deprecated Продајно место које се користи за издавање фискалног рачуна. Само једна апликација може бити отворена по продајном месту, како би рачун био издат. Из овог разлога препоручујемо да користите `clientId` уместо `storeId`.
clientId	string <uuid> Клијент који се користи за издавање рачуна.
buyerId required	string ИД купца, мора бити у складу са шифраником
buyerCostCenterId	string Опционо поље купца, мора бити у складу са шифраником
required	object Начини плаћања фискалног рачуна
	Array of objects non-empty Ставке рачуна које се рефундирају
additionalText	string Додатни текст који ће се штампати након фискалног рачуна
required	object non-empty Начин издавања фискалног рачуна
	object Спецификација рефундација по пореским ознакама. Обавезно је само када се на фискалном рачуну налази више пореских ознака и коначан износ није познат.

Responses

Request samples

Payload

Content type

application/json

{"storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",
"clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
"buyerId": "string",
"buyerCostCenterId": "string",
"payments": {"cash": 0,
"card": 0,
"check": 0,
"mobilemoney": 0,
"wiretransfer": 0,
"voucher": 0,
"other": 0
},
"items": [{"sku": 1,
"quantity": 0.01
}
],
"additionalText": "string",
"receiptDelivery": {"thermalPrinter": true,
"a4Printer": true,
"email": "user@example.com",
"pdf": true,
"base64pdf": true
},
"advanceSpecification": {"Ђ": 0,
"Е": 0,
"Г": 0,
"А": 0
}
}

Response samples

200
400
404
500

Content type

application/json

[{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}
]

Артикал

	Array of objects
id	string <uuid> ИД
name required	string non-empty Назив
sku	number Шифра
manufacturerSku	string Шифра произвођача
description	string Опис у HTML формату
descriptionPlain	string Опис у текстуалном формату
saleUnitId	string <uuid> Продајна јединица мере
baseUnitId	string <uuid> Јединица мере у којој је исказана количина производа
quantityPerBaseUnit	number Количина у јединици мере
price	number Цена са ПДВ-ом
taxRateLabel required	string Enum: "Ђ" "Е" "Г" "А" Пореска ознака
subtitle	string Кратак опис
productType	string Enum: "product" "service" "digital" Врста артикла
weight	number Маса
dimensions	string Димензије у центиметрима, у формату ШИРИНАxДУБИНАxВИСИНА
hasVariants	boolean Артикал има варијанте
variantName	string Назив варијанте, само уколико је артикал варијанта
ean	string ГТИН артикла
	object (File) Главна фотографија
categories	Array of strings <uuid> [ items <uuid > ] ИД-еви категорија у којима се налази артикал
createdAt	string <date-time> Датум и време креирања
updatedAt	string <date-time> Датум и време измене
deletedAt	string <date-time> Датум и време брисања

{"variants": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"sku": 0,
"manufacturerSku": "string",
"description": "string",
"descriptionPlain": "string",
"saleUnitId": "7973feb3-94e3-4aff-aff4-9ed6e37a0d5e",
"baseUnitId": "60f3a59f-633d-415d-9234-0526f6d44591",
"quantityPerBaseUnit": 0,
"price": 0,
"taxRateLabel": "Ђ",
"subtitle": "string",
"productType": "product",
"weight": 0,
"dimensions": "string",
"hasVariants": true,
"variantName": "string",
"ean": "string",
"coverImage": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"filename": "string",
"originalFilename": "string",
"mimetypeFilename": "string",
"size": 0,
"reference": "string",
"referenceId": "8502eb05-558d-4480-8511-c1011710b340",
"private": true,
"urls": {"original": "string",
"64x64": "string",
"128x128": "string",
"256x256": "string",
"512x512": "string",
"1024x1024": "string"
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
},
"categories": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"deletedAt": "2019-08-24T14:15:22Z"
}

Продајно место

id	string <uuid> ИД
name required	string non-empty Назив
address	string Адреса
city	string Град
zip	string Поштански број
gln	string ГЛН
phone	string Број телефона
language	any Default: "sr-Cyrl-RS" Enum: "sr-Cyrl-RS" "sr-Latn-RS" Језик на ком се издаје фискални рачун
	object Доступни начини издавања фискалног рачуна
printBankAccounts	boolean Штампа текућих рачуна уколико је начин плаћања пренос на рачун
printDiscounts	boolean Штампа остварених попуста
paymentMethodsOrder	Array of arrays Редослед начина плаћања на прозору за плаћање
productPickerType	string Enum: "list" "grid" Начин приказа производа на каси
isSoundEnabled	boolean Репродукција звучних сигнала при куцању артикала
defaultUnknownAmountAdvance	boolean Да ли је подразумевано укључена опција за аванс без познатог коначног износа

{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"address": "string",
"city": "string",
"zip": "string",
"gln": "string",
"phone": "string",
"language": "sr-Cyrl-RS",
"printMethod": {"thermal": true,
"a4": true,
"email": true
},
"printBankAccounts": true,
"printDiscounts": true,
"paymentMethodsOrder": [ ],
"productPickerType": "list",
"isSoundEnabled": true,
"defaultUnknownAmountAdvance": true
}

Фискални рачун

requestedBy	string ЈИД безбедносног елемента који је захтевао потписивање фискалног рачуна
sdcDateTime	string <date-time> Датум и време издавања фискалног рачуна
invoiceCounter	string Бројач рачуна
invoiceCounterExtension	string Тип бројача рачуна
invoiceNumber	string Број фискалног рачуна
	Array of objects Ставке пореза
verificationUrl	string <url> Верификациони УРЛ
verificationQRCode	string Верификациони QR код у GIF формату
journal	string Фискални рачун у текстуалном формату. Напомена: У овом пољу се налази текст рачуна какав је вратио процесор фискалних рачуна, и он не садржи све додатне информације које су додате од стране ЕСИР-а.
messages	string Поруке процесора фискалних рачуна
signedBy	string ЈИД безбедносног елемента који је потписао фискални рачун
encryptedInternalData	string Шифровани интерни подаци
signature	string Дигитални потпис
totalCounter	number Укупан број издатих рачуна
transactionTypeCounter	number Укупан број издатих рачуна за тренутан тип трансакције
totalAmount	number Укупан износ рачуна
taxGroupRevision	number Ревизија пореске групе
businessName	string Назив предузећа
tin	string Порески идентификациони број (ПИБ)
locationName	string Назив пословног простора
address	string Адреса
district	string Општина
mrc	string Регистарски број произвођача ПФР-а
pdf	string УРЛ до ПДФ фајла Напомена: УРЛ ће бити важећи 10 минута од издавања фискалног рачуна.
base64pdf	string ПДФ фајл у base64 формату

{"requestedBy": "string",
"sdcDateTime": "2019-08-24T14:15:22Z",
"invoiceCounter": "string",
"invoiceCounterExtension": "string",
"invoiceNumber": "string",
"taxItems": [{"categoryType": 0,
"categoryName": "string",
"label": "s",
"rate": 100,
"amount": 0
}
],
"verificationUrl": "string",
"verificationQRCode": "string",
"journal": "string",
"messages": "string",
"signedBy": "string",
"encryptedInternalData": "string",
"signature": "string",
"totalCounter": 0,
"transactionTypeCounter": 0,
"totalAmount": 0,
"taxGroupRevision": 0,
"businessName": "string",
"tin": "string",
"locationName": "string",
"address": "string",
"district": "string",
"mrc": "string",
"pdf": "string",
"base64pdf": "string"
}