Перейти к содержанию

Получение чека

Метод получения информации о чеке самозанятого.

URL

Метод: GET

  • Production: https://api.baas.kvell.group/v1/smz/receipts/{receipt_id}
  • Stage: https://api.baas.stage.kvell.group/v1/smz/receipts/{receipt_id}

Параметры запроса

Название Тип данных Обязательно Описание
receipt_id integer Да Уникальный идентификатор чека

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор магазина
X-Signature string Да Подпись

Подпись X-Signature формируется конкатенацией X-Api-Key, receipt_id и secret_key. Формируется sha256 от полученной строки:

sha256({X-Api-Key}{receipt_id}{secret_key})

где secret_key - секретный ключ, который находится в настройках магазина мерчанта;

Ответ запроса

Пример ответа

{
  "id": 0,
  "merchant_inn": "string",
  "merchant_name": "string",
  "client": {
    "id": 0,
    "inn": "string",
    "phone": "string",
    "email": "string",
    "created_at": "2024-07-10T18:26:56.931Z"
  },
  "amount": 0,
  "service_name": "string",
  "description": "string",
  "status": "string",
  "message": "string",
  "remote_url": "string",
  "created_at": "2024-07-10T18:26:56.931Z"
}
{
  "errors": [
    {
      "code": 0,
      "message": "string"
    }
  ]
}

Параметры ответа

  • id - уникальный идентификатор созданного чека
  • merchant_inn - ИНН ЮЛ
  • merchant_name - название ЮЛ
  • client - информация самозанятого, связанный с чеком
  • amount - cумма в чеке, в копейках
  • service_name - название услуги в чеке
  • description - комментарий
  • status - статус чека:
    • created - чек создан
    • processing - чек в процессе регитрации
    • failed - ошибка формирования чека
    • canceling - чек в процессе аннулирования
    • canceled - чек анулирован
    • ready - чек зарегистирован и готов к выплате
    • paid - чек успешно выплачен
  • message - сообщение об ошибке, в случае неуспешного пробития чека
  • remote_url - url адрес сформированного чека
  • created_at - дата создания чека