{"openapi":"3.1.0","info":{"title":"Документация по SelSup API","description":"API SelSup — программный интерфейс для работы с сервисом SelSup. Даёт возможность работать со всеми функциями SelSup из вашей системы. Для использования API добавьте новый токен на странице:https://selsup.ru/application/integration/api. Добавленный токен необходимо передавать во всех запросах к API SelSup, в заголовке Authorization.","contact":{"name":"Support Team","email":"admin@selsup.ru"},"license":{"name":"Apache 2.0","url":"https://selsup.ru/dogovor-offerta/"},"version":"1.0"},"servers":[{"url":"http://localhost:9050/"}],"tags":[{"name":"Кассовые чеки","description":"Управление чеками онлайн-касс"}],"paths":{"/api/receipt/order/{orderId}":{"get":{"tags":["Кассовые чеки"],"summary":"Получить чеки заказа","description":"Возвращает все чеки, пробитые для указанного заказа","operationId":"getReceiptsByOrder","parameters":[{"name":"orderId","in":"path","description":"ID заказа","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/hal+json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Receipt"}}}}}}},"post":{"tags":["Кассовые чеки"],"summary":"Создать чек для заказа","description":"Пробивает чек через онлайн-кассу для указанного заказа","operationId":"createReceiptForOrder","parameters":[{"name":"orderId","in":"path","description":"ID заказа","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"type","in":"query","description":"Тип чека","required":false,"schema":{"type":"string","default":"INCOME","enum":["INCOME","EXPENSE","REFUND","EXPENSE_REFUND"]}}],"responses":{"200":{"description":"OK","content":{"application/hal+json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}}}}},"/api/receipt/{receiptId}":{"get":{"tags":["Кассовые чеки"],"summary":"Получить чек по ID","description":"Возвращает детальную информацию о чеке","operationId":"getReceipt","parameters":[{"name":"receiptId","in":"path","description":"ID чека","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/hal+json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}}}}},"/api/receipt/{receiptId}/update":{"get":{"tags":["Кассовые чеки"],"summary":"Обновить статус чека","description":"Запрашивает актуальный статус чека у онлайн-кассы","operationId":"updateReceiptStatus","parameters":[{"name":"receiptId","in":"path","description":"ID чека","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/hal+json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}}}}}},"components":{"schemas":{"Receipt":{"type":"object","description":"Чек онлайн-кассы","properties":{"id":{"type":"integer","format":"int64","description":"ID чека","readOnly":true},"clientId":{"type":"integer","format":"int64","description":"ID клиента","readOnly":true},"orderId":{"type":"integer","format":"int64","description":"ID заказа","readOnly":true},"organizationId":{"type":"integer","format":"int64","description":"ID организации","readOnly":true},"externalReceiptId":{"type":"string","description":"ID чека в системе онлайн-кассы"},"fiscalNumber":{"type":"string","description":"Фискальный номер документа (ФД), присвоенный ФНС"},"cashRegisterService":{"type":"string","description":"Сервис онлайн-кассы","enum":["NONE","EVOTOR","ATOL"]},"fnsUrl":{"type":"string","description":"Ссылка на проверку чека на сайте ФНС"},"status":{"type":"string","description":"Статус чека","enum":["CREATED","PENDING","COMPLETED","FAILED","CANCELLED"]},"receiptType":{"type":"string","description":"Тип операции","enum":["INCOME","EXPENSE","REFUND","EXPENSE_REFUND"]},"totalAmount":{"type":"number","format":"double","description":"Общая сумма чека"},"createdDate":{"type":"string","format":"date-time","description":"Дата создания записи","readOnly":true},"completedDate":{"type":"string","format":"date-time","description":"Дата успешного пробития чека"},"errorMessage":{"type":"string","description":"Сообщение об ошибке, если статус FAILED"}}}},"securitySchemes":{"ApiKey":{"type":"apiKey","name":"Authorization","in":"header"}}}}