Receipt

Ready-to-use workflows

01

Start using Receipt

Use a dedicated API token and validate read operations with test data first.

Keep the token server-side and send it in the Authorization header.
Check required parameters and expand the request or response schema.
Handle the HTTP status and the stable error field in application errors.

GETGet Receipts By Order POSTCreate Receipt For Order GETGet Receipt

Data model

Data structures

Models are listed once here and can also be expanded directly from the endpoints that use them.

Receipt14 fields

idinteger · int64

Id.

read-only

clientIdinteger · int64

Client Id.

read-only

orderIdinteger · int64

Order Id.

read-only

organizationIdinteger · int64

Organization Id.

read-only

externalReceiptIdstring

External Receipt Id.

fiscalNumberstring

Fiscal Number.

cashRegisterServicestring

Cash Register Service.

fnsUrlstring

Fns Url.

statusstring

Status.

receiptTypestring

Receipt Type.

totalAmountnumber · double

Total Amount.

createdDatestring · date-time

Created Date.

read-only

completedDatestring · date-time

Completed Date.

errorMessagestring

Error Message.

Error contract

How application errors are returned

The error code is identical in every locale, while the user-facing message is translated by the server. Build application logic around error and use localMessage for display only.

error

Stable machine-readable code for integration logic.

localMessage

Display-ready message in the API token user's language.

params

Values interpolated by the server into the localized message template.

文

localMessage uses the lang field of the user who owns the API token. The documentation language and Accept-Language header do not change it; Russian is used when the user has no language configured.

RUUser locale is ru

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

ENUser locale is en

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

Endpoints

GET

Get Receipts By Order

/api/receipt/order/{orderId}

Token with read access

Get Receipts By Order using GET /api/receipt/order/{orderId}.

Path parameters

Field	Type	Required	Description
`orderId`	integer · int64	Yes	Order Id.

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());
    }
}

Success response

200

Array item structure Receipt[]

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`clientId`	integer · int64	No	Client Id.
`orderId`	integer · int64	No	Order Id.
`organizationId`	integer · int64	No	Organization Id.
`externalReceiptId`	string	No	External Receipt Id.
`fiscalNumber`	string	No	Fiscal Number.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	No	Cash Register Service.
`fnsUrl`	string	No	Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	No	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	No	Receipt Type.
`totalAmount`	number · double	No	Total Amount.
`createdDate`	string · date-time	No	Created Date.
`completedDate`	string · date-time	No	Completed Date.
`errorMessage`	string	No	Error Message.

[
  "string"
]

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

POST

Create Receipt For Order

/api/receipt/order/{orderId}

Token with write access

Create Receipt For Order using POST /api/receipt/order/{orderId}.

Path parameters

Field	Type	Required	Description
`orderId`	integer · int64	Yes	Order Id.

Query parameters

Field	Type	Required	Description
`type`Default: INCOME	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	No	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());
    }
}

Success response

200

Object fields Receipt

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`clientId`	integer · int64	No	Client Id.
`orderId`	integer · int64	No	Order Id.
`organizationId`	integer · int64	No	Organization Id.
`externalReceiptId`	string	No	External Receipt Id.
`fiscalNumber`	string	No	Fiscal Number.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	No	Cash Register Service.
`fnsUrl`	string	No	Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	No	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	No	Receipt Type.
`totalAmount`	number · double	No	Total Amount.
`createdDate`	string · date-time	No	Created Date.
`completedDate`	string · date-time	No	Completed Date.
`errorMessage`	string	No	Error Message.

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

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Get Receipt

/api/receipt/{receiptId}

Token with read access

Get Receipt using GET /api/receipt/{receiptId}.

Path parameters

Field	Type	Required	Description
`receiptId`	integer · int64	Yes	Receipt Id.

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());
    }
}

Success response

200

Object fields Receipt

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`clientId`	integer · int64	No	Client Id.
`orderId`	integer · int64	No	Order Id.
`organizationId`	integer · int64	No	Organization Id.
`externalReceiptId`	string	No	External Receipt Id.
`fiscalNumber`	string	No	Fiscal Number.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	No	Cash Register Service.
`fnsUrl`	string	No	Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	No	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	No	Receipt Type.
`totalAmount`	number · double	No	Total Amount.
`createdDate`	string · date-time	No	Created Date.
`completedDate`	string · date-time	No	Completed Date.
`errorMessage`	string	No	Error Message.

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

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

GET

Update Receipt Status

/api/receipt/{receiptId}/update

Token with read access

Update Receipt Status using GET /api/receipt/{receiptId}/update.

Path parameters

Field	Type	Required	Description
`receiptId`	integer · int64	Yes	Receipt Id.

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());
    }
}

Success response

200

Object fields Receipt

Field	Type	Required	Description
`id`	integer · int64	No	Id.
`clientId`	integer · int64	No	Client Id.
`orderId`	integer · int64	No	Order Id.
`organizationId`	integer · int64	No	Organization Id.
`externalReceiptId`	string	No	External Receipt Id.
`fiscalNumber`	string	No	Fiscal Number.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	No	Cash Register Service.
`fnsUrl`	string	No	Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	No	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	No	Receipt Type.
`totalAmount`	number · double	No	Total Amount.
`createdDate`	string · date-time	No	Created Date.
`completedDate`	string · date-time	No	Completed Date.
`errorMessage`	string	No	Error Message.

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

Errors3

Application errors are normally returned as JSON with error, localMessage, and params. Branch on error; localized text may change. How application errors are returned ↑

401auth_required

Authentication required

Authorization is missing, empty, or contains an invalid token.

400error_access_denied

Insufficient permissions

The token exists, but its role cannot perform this operation.

500error_unknown

Unexpected error

Internal failure. Save the request time and contact support; do not blindly retry a mutation.

Ready-to-use workflows

Start using Receipt

Data structures

How application errors are returned

Endpoints

Get Receipts By Order

Path parameters

Success response

Create Receipt For Order

Path parameters

Query parameters

Success response

Get Receipt

Path parameters

Success response

Update Receipt Status

Path parameters

Success response

Token for test requests

Real request parameters

Live API response