Кассовые чеки

Готовые сценарии

01

Начать работу с разделом «Кассовые чеки»

Используйте отдельный API-токен и сначала проверяйте операции чтения на тестовых данных.

Сохраните токен на серверной стороне и передавайте его в заголовке Authorization.
Проверьте обязательные параметры и раскройте структуру запроса или ответа.
Обрабатывайте HTTP-статус и стабильное поле error в прикладных ошибках.

GETПолучить чеки заказа POSTСоздать чек для заказа GETПолучить чек по ID

Модель данных

Структуры данных раздела

Модели перечислены отдельно и раскрываются также непосредственно у методов, где они используются.

Receipt14 полей

idinteger · int64

ID чека

read-only

clientIdinteger · int64

ID клиента

read-only

orderIdinteger · int64

ID заказа

read-only

organizationIdinteger · int64

ID организации

read-only

externalReceiptIdstring

ID чека в системе онлайн-кассы

fiscalNumberstring

Фискальный номер документа (ФД), присвоенный ФНС

cashRegisterServicestring

Сервис онлайн-кассы

fnsUrlstring

Ссылка на проверку чека на сайте ФНС

statusstring

Статус чека

receiptTypestring

Тип операции

totalAmountnumber · double

Общая сумма чека

createdDatestring · date-time

Дата создания записи

read-only

completedDatestring · date-time

Дата успешного пробития чека

errorMessagestring

Сообщение об ошибке, если статус FAILED

Контракт ошибок

Как API возвращает прикладные ошибки

Код ошибки одинаков для всех локалей, а текст для пользователя переводится сервером. Поэтому бизнес-логику стройте по error, а localMessage используйте только для отображения.

error

Стабильный машинный код ошибки для логики интеграции.

localMessage

Готовое сообщение на языке пользователя API-токена.

params

Значения

文

Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.

RUПользователь с локалью ru

{
  "error": "error_brand_already_exists",
  "localMessage": "Бренд Base уже существует",
  "params": {
    "name": "Base"
  }
}

ENПользователь с локалью en

{
  "error": "error_brand_already_exists",
  "localMessage": "Brand Base already exists",
  "params": {
    "name": "Base"
  }
}

Методы

GET

Получить чеки заказа

/api/receipt/order/{orderId}

Токен с правами чтения

Возвращает все чеки, пробитые для указанного заказа

Параметры пути

Поле	Тип	Обязательно	Описание
`orderId`	integer · int64	Да	Поле orderId.

curl --request GET 'https://api.selsup.ru/api/receipt/order/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/receipt/order/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/receipt/order/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/receipt/order/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/receipt/order/1001',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/receipt/order/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/receipt/order/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Структура элемента массива Receipt[]

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	ID чека
`clientId`	integer · int64	Нет	ID клиента
`orderId`	integer · int64	Нет	ID заказа
`organizationId`	integer · int64	Нет	ID организации
`externalReceiptId`	string	Нет	ID чека в системе онлайн-кассы
`fiscalNumber`	string	Нет	Фискальный номер документа (ФД), присвоенный ФНС
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Нет	Сервис онлайн-кассы
`fnsUrl`	string	Нет	Ссылка на проверку чека на сайте ФНС
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Нет	Статус чека
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Нет	Тип операции
`totalAmount`	number · double	Нет	Общая сумма чека
`createdDate`	string · date-time	Нет	Дата создания записи
`completedDate`	string · date-time	Нет	Дата успешного пробития чека
`errorMessage`	string	Нет	Сообщение об ошибке, если статус FAILED

[
  "string"
]

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

POST

Создать чек для заказа

/api/receipt/order/{orderId}

Токен с правами записи

Пробивает чек через онлайн-кассу для указанного заказа

Параметры пути

Поле	Тип	Обязательно	Описание
`orderId`	integer · int64	Да	Поле orderId.

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

Поле	Тип	Обязательно	Описание
`type`По умолчанию: INCOME	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Нет	Поле type.

curl --request POST 'https://api.selsup.ru/api/receipt/order/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/receipt/order/1001', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/receipt/order/1001', {
  method: 'POST',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.post(
    'https://api.selsup.ru/api/receipt/order/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/receipt/order/1001',
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("POST", "https://api.selsup.ru/api/receipt/order/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/receipt/order/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("POST", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Receipt

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	ID чека
`clientId`	integer · int64	Нет	ID клиента
`orderId`	integer · int64	Нет	ID заказа
`organizationId`	integer · int64	Нет	ID организации
`externalReceiptId`	string	Нет	ID чека в системе онлайн-кассы
`fiscalNumber`	string	Нет	Фискальный номер документа (ФД), присвоенный ФНС
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Нет	Сервис онлайн-кассы
`fnsUrl`	string	Нет	Ссылка на проверку чека на сайте ФНС
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Нет	Статус чека
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Нет	Тип операции
`totalAmount`	number · double	Нет	Общая сумма чека
`createdDate`	string · date-time	Нет	Дата создания записи
`completedDate`	string · date-time	Нет	Дата успешного пробития чека
`errorMessage`	string	Нет	Сообщение об ошибке, если статус FAILED

{
  "id": 1001,
  "clientId": 1001,
  "orderId": 1001,
  "organizationId": 1001,
  "externalReceiptId": "string",
  "fiscalNumber": "string"
}

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Получить чек по ID

/api/receipt/{receiptId}

Токен с правами чтения

Возвращает детальную информацию о чеке

Параметры пути

Поле	Тип	Обязательно	Описание
`receiptId`	integer · int64	Да	Поле receiptId.

curl --request GET 'https://api.selsup.ru/api/receipt/1001' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/receipt/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/receipt/1001', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/receipt/1001',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/receipt/1001',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/receipt/1001", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/receipt/1001"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Receipt

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	ID чека
`clientId`	integer · int64	Нет	ID клиента
`orderId`	integer · int64	Нет	ID заказа
`organizationId`	integer · int64	Нет	ID организации
`externalReceiptId`	string	Нет	ID чека в системе онлайн-кассы
`fiscalNumber`	string	Нет	Фискальный номер документа (ФД), присвоенный ФНС
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Нет	Сервис онлайн-кассы
`fnsUrl`	string	Нет	Ссылка на проверку чека на сайте ФНС
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Нет	Статус чека
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Нет	Тип операции
`totalAmount`	number · double	Нет	Общая сумма чека
`createdDate`	string · date-time	Нет	Дата создания записи
`completedDate`	string · date-time	Нет	Дата успешного пробития чека
`errorMessage`	string	Нет	Сообщение об ошибке, если статус FAILED

{
  "id": 1001,
  "clientId": 1001,
  "orderId": 1001,
  "organizationId": 1001,
  "externalReceiptId": "string",
  "fiscalNumber": "string"
}

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

GET

Обновить статус чека

/api/receipt/{receiptId}/update

Токен с правами чтения

Запрашивает актуальный статус чека у онлайн-кассы

Параметры пути

Поле	Тип	Обязательно	Описание
`receiptId`	integer · int64	Да	Поле receiptId.

curl --request GET 'https://api.selsup.ru/api/receipt/1001/update' \
  --header 'Authorization: YOUR_API_TOKEN'

const response = await fetch('https://api.selsup.ru/api/receipt/1001/update', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN },
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error || 'selsup_request_failed');
}

const result = await response.json();

const response: Response = await fetch('https://api.selsup.ru/api/receipt/1001/update', {
  method: 'GET',
  headers: { Authorization: process.env.SELSUP_API_TOKEN! },
});

if (!response.ok) {
  const error = await response.json() as { error?: string };
  throw new Error(error.error ?? 'selsup_request_failed');
}

const result: unknown = await response.json();

import os
import requests

response = requests.get(
    'https://api.selsup.ru/api/receipt/1001/update',
    headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
result = response.json()

<?php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.selsup.ru/api/receipt/1001/update',
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
]);

$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

if ($response === false || $status >= 400) {
    throw new RuntimeException($response ?: 'selsup_request_failed');
}

echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    req, err := http.NewRequest("GET", "https://api.selsup.ru/api/receipt/1001/update", nil)
    if err != nil { panic(err) }
    req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))

    response, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer response.Body.Close()
    result, _ := io.ReadAll(response.Body)
    fmt.Printf("%d\n%s\n", response.StatusCode, result)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SelSupExample {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/receipt/1001/update"))
            .header("Authorization", System.getenv("SELSUP_API_TOKEN"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode());
        System.out.println(response.body());
    }
}

Успешный ответ

200

Поля объекта Receipt

Поле	Тип	Обязательно	Описание
`id`	integer · int64	Нет	ID чека
`clientId`	integer · int64	Нет	ID клиента
`orderId`	integer · int64	Нет	ID заказа
`organizationId`	integer · int64	Нет	ID организации
`externalReceiptId`	string	Нет	ID чека в системе онлайн-кассы
`fiscalNumber`	string	Нет	Фискальный номер документа (ФД), присвоенный ФНС
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Нет	Сервис онлайн-кассы
`fnsUrl`	string	Нет	Ссылка на проверку чека на сайте ФНС
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Нет	Статус чека
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Нет	Тип операции
`totalAmount`	number · double	Нет	Общая сумма чека
`createdDate`	string · date-time	Нет	Дата создания записи
`completedDate`	string · date-time	Нет	Дата успешного пробития чека
`errorMessage`	string	Нет	Сообщение об ошибке, если статус FAILED

{
  "id": 1001,
  "clientId": 1001,
  "orderId": 1001,
  "organizationId": 1001,
  "externalReceiptId": "string",
  "fiscalNumber": "string"
}

Ошибки3

Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑

401auth_required

Требуется авторизация

Заголовок Authorization отсутствует, пуст или содержит недействительный токен.

400error_access_denied

Недостаточно прав

Токен существует, но его роль не позволяет выполнить операцию.

500error_unknown

Непредвиденная ошибка

Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.

Готовые сценарии

Начать работу с разделом «Кассовые чеки»

Структуры данных раздела

Как API возвращает прикладные ошибки

Методы

Получить чеки заказа

Параметры пути

Успешный ответ

Создать чек для заказа

Параметры пути

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

Успешный ответ

Получить чек по ID

Параметры пути

Успешный ответ

Обновить статус чека

Параметры пути

Успешный ответ

Токен для тестовых запросов

Параметры реального запроса

Реальный ответ API