Ushbu sahifani tahrirlash mumkin bo'lgan mustaqil shartnoma bilan ta'minlaydi. Ishlab chiqarishdan oldin sinov ma'lumotlari bilan yozish operatsiyalarini tasdiqlash.
/api/receipt
Ishga tayyor ish oqimlari
Ishga tayyor ish oqimlari
01
Rasmdan foydalanish
API tokenidan foydalaning va avval o'qish operatsiyalarini sinov ma'lumotlari bilan tasdiqlash.
Tokeni server tomoniga saqlang va Authorization boshliqida yuboring.
Kerakli parametrlarni tekshiring va so'rov yoki javob sxemasini kengaytiring.
HTTP holatini va error o'rniga dastur xatolarida ishlash.
Modellari bu yerda bir marta ro'yxatga olingan va ularni ishlatadigan oxirgi nuqtalardan to'g'ridan-to'gʻri kengaytirilishi mumkin.
Receipt14 maydonlar
idinteger · int64
Id.
read-only
clientIdinteger · int64
Mijozning identifikatori.
read-only
orderIdinteger · int64
Buyurtma guvohnomasi.
read-only
organizationIdinteger · int64
Tashkilot identifikatori.
read-only
externalReceiptIdstring
Tashqi rasim guvohnomasi.
fiscalNumberstring
Moliyaviy raqam.
cashRegisterServicestring
Pul qayd xizmati.
fnsUrlstring
Fns Url.
statusstring
Status.
receiptTypestring
Rasm turi.
totalAmountnumber · double
Jami miqdor.
createdDatestring · date-time
Tanlangan kun.
read-only
completedDatestring · date-time
To'liq tugallangan sana.
errorMessagestring
Xato xabarlari.
Xato shartnomasi
Ilovalar xatolarini qaytarib berish usuli
error kodlari har bir joyda bir xil, foydalanuvchiga qaratilgan xabar server tomonidan tarjima qilinadi. error atrofida dastur mantiqasini quring va localMessage-dan faqat ko'rsatish uchun foydalaning.
error
Integratsiya mantiqasini yaratish uchun barqaror mashina o'qiladigan kod.
localMessage
API token foydalanuvchisining tilida ko'rsatishga tayyor xabar.
params
Server tomonidan mahalliylashtirilgan xabar namunalariga interpolatsiya qilingan qiymatlar.
文
localMessage API tokenini egallagan foydalanuvchining lang maydoni ishlatiladi. Hujjat tili va Accept-Language boshliq uni o'zgartirmaydi; foydalanuvchi tilni moslamasa rus tilida ishlatiladigan.
RUFoydalanuvchi manzili ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
POST
Buyurtma uchun rasmga ega boʻling
/api/receipt/order/{orderId}
Yozib olish imkoniyatiga ega token
POST /api/receipt/order/{orderId}. yordamida buyurtma uchun rasmga ega boʻling
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
orderId
integer · int64
Ha
Buyurtma guvohnomasi.
Soʻrov parametrlari
Maydon
Tur
Majburiy
Tavsif
typeStandart qiymat: INCOME
stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND
Yoʻq
Type.
curl --request POST 'https://api.selsup.ru/api/receipt/order/1001' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
GET
Rasm olish
/api/receipt/{receiptId}
Oʻqish imkoniyatiga ega token
GET /api/receipt/{receiptId}. yordamida rasmga ega boʻling
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
receiptId
integer · int64
Ha
Rasm guvohnomasi.
curl --request GET 'https://api.selsup.ru/api/receipt/1001' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.
GET
Qildiruv holatini yangilash
/api/receipt/{receiptId}/update
Oʻqish imkoniyatiga ega token
GET /api/receipt/{receiptId}/update. yordamida Qutlugʻ Kechlik holati
Yo'l parametrlari
Maydon
Tur
Majburiy
Tavsif
receiptId
integer · int64
Ha
Rasm guvohnomasi.
curl --request GET 'https://api.selsup.ru/api/receipt/1001/update' \
--header 'Authorization: YOUR_API_TOKEN'
Dastur xatolari error, localMessage va params bilan JSON sifatida qaytarilgan. XPROTextning XPRO TECTED4X-ga bo'linishi; mahalliylashtirilgan matn o'zgarishi mumkin. Ilovalar xatolarini qaytarib berish usuli ↑
401auth_required
Tasdiqlash talab etiladi
Authorization yo'qolgan, bo'sh yoki haqiqiy bo'lmagan tokenni o'z ichiga oladi.
400error_access_denied
Kirish taqiqlangan
Token mavjud, ammo uning roli ushbu operatsiyani amalga oshirolmaydi.
500error_unknown
Noma'lum xatolik yuz berdi. Agar muammo takrorlansa, qo'llab-quvvatlash xizmatiga yozing
Ichki xato. So'rov vaqtini va aloqalarni saqlab qoling; mutatsiyani ko'r bo'lib qayta sinab ko'ring.