Kwit

Gotowe do użytkowania przepływy robocze

01

Zacznij używać Kwitówki

Użyj dedykowanego tokena API i najpierw sprawdź operacje odczytu z danymi testowymi.

Trzymaj token z serwera i wysłać go w nagłówku Authorization.
Sprawdź wymagane parametry i poszerz schemat żądania lub odpowiedzi.
Zrób z statusem HTTP i stabilnym pole error w przypadku błędów aplikacyjnych.

GETOtrzymuj kwity po zamówieniu POSTUtwórz kwitancję do zamówienia GETOtrzymaj kwitament

Model danych

Struktura danych

Modele są wymienione tutaj raz i mogą być również rozszerzane bezpośrednio z punktów końcowych, które je wykorzystują.

Receipt14 pola

idinteger · int64

Id.

read-only

clientIdinteger · int64

Id klientów.

read-only

orderIdinteger · int64

Identyfikacja zamówienia.

read-only

organizationIdinteger · int64

Id organizacyjny.

read-only

externalReceiptIdstring

Wynik odbioru.

fiscalNumberstring

Numer fiskalny.

cashRegisterServicestring

Usługa rejestru gotówki.

fnsUrlstring

- Url.

statusstring

Status.

receiptTypestring

Typ kwitu.

totalAmountnumber · double

Źródło:

createdDatestring · date-time

Tworzony Termin.

read-only

completedDatestring · date-time

Termin zakończony.

errorMessagestring

Wiadomość błędu.

Umowa o błędzie

W jaki sposób można zwrócić błędy w aplikacji

Kod error jest identyczny w każdym miejscu, podczas gdy wiadomość skierowana do użytkownika jest tłumaczona przez serwer.

error

Stabilny kod czytelny maszynowo do logiki integracyjnej.

localMessage

Przesłanie gotowe do wyświetlania w języku użytkownika tokenu API.

params

Wartości interpołowane przez serwer w szablonie lokalizowanej wiadomości.

文

localMessage wykorzystuje pole lang użytkownika, który posiada token API. Język dokumentacji i nagłówek Accept-Language nie zmieniają go; rosyjski jest używany, gdy użytkujący nie ma konfigurowanego języka.

RULokalizacja użytkownika jest ru

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

PLPolski (pl)

{
  "error": "error_brand_already_exists",
  "localMessage": "Marka Base już istnieje",
  "params": {
    "name": "Base"
  }
}

Punkty końcowe

GET

Otrzymuj kwity po zamówieniu

/api/receipt/order/{orderId}

Token z dostępem do odczytu

Uzyskaj kwoty za zamówienie za pomocą GET /api/receipt/order/{orderId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`orderId`	integer · int64	Tak	Identyfikacja zamówienia.

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

Odpowiedź udana

200

Struktura pozycji zestawu Receipt[]

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`clientId`	integer · int64	Nie	Id klientów.
`orderId`	integer · int64	Nie	Identyfikacja zamówienia.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`externalReceiptId`	string	Nie	Wynik odbioru.
`fiscalNumber`	string	Nie	Numer fiskalny.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Nie	Usługa rejestru gotówki.
`fnsUrl`	string	Nie	- Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Nie	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Nie	Typ kwitu.
`totalAmount`	number · double	Nie	Źródło:
`createdDate`	string · date-time	Nie	Tworzony Termin.
`completedDate`	string · date-time	Nie	Termin zakończony.
`errorMessage`	string	Nie	Wiadomość błędu.

[
  "string"
]

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

POST

Utwórz kwitancję do zamówienia

/api/receipt/order/{orderId}

Token z dostępem do pisania

Utworz Kwitę do zamówienia za pomocą POST /api/receipt/order/{orderId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`orderId`	integer · int64	Tak	Identyfikacja zamówienia.

Parametry zapytania

Pole	Typ	Wymagane	Opis
`type`Wartość domyślna: INCOME	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Nie	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());
    }
}

Odpowiedź udana

200

Połączenia obiektu Receipt

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`clientId`	integer · int64	Nie	Id klientów.
`orderId`	integer · int64	Nie	Identyfikacja zamówienia.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`externalReceiptId`	string	Nie	Wynik odbioru.
`fiscalNumber`	string	Nie	Numer fiskalny.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Nie	Usługa rejestru gotówki.
`fnsUrl`	string	Nie	- Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Nie	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Nie	Typ kwitu.
`totalAmount`	number · double	Nie	Źródło:
`createdDate`	string · date-time	Nie	Tworzony Termin.
`completedDate`	string · date-time	Nie	Termin zakończony.
`errorMessage`	string	Nie	Wiadomość błędu.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Otrzymaj kwitament

/api/receipt/{receiptId}

Token z dostępem do odczytu

Uzyskaj Kwitę za pomocą GET /api/receipt/{receiptId}.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`receiptId`	integer · int64	Tak	Idekcja odbioru.

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

Odpowiedź udana

200

Połączenia obiektu Receipt

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`clientId`	integer · int64	Nie	Id klientów.
`orderId`	integer · int64	Nie	Identyfikacja zamówienia.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`externalReceiptId`	string	Nie	Wynik odbioru.
`fiscalNumber`	string	Nie	Numer fiskalny.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Nie	Usługa rejestru gotówki.
`fnsUrl`	string	Nie	- Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Nie	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Nie	Typ kwitu.
`totalAmount`	number · double	Nie	Źródło:
`createdDate`	string · date-time	Nie	Tworzony Termin.
`completedDate`	string · date-time	Nie	Termin zakończony.
`errorMessage`	string	Nie	Wiadomość błędu.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

GET

Aktualizacja stanu otrzymania

/api/receipt/{receiptId}/update

Token z dostępem do odczytu

Aktualizacja stanu otrzymania przy użyciu GET /api/receipt/{receiptId}/update.

Parametry ścieżki

Pole	Typ	Wymagane	Opis
`receiptId`	integer · int64	Tak	Idekcja odbioru.

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

Odpowiedź udana

200

Połączenia obiektu Receipt

Pole	Typ	Wymagane	Opis
`id`	integer · int64	Nie	Id.
`clientId`	integer · int64	Nie	Id klientów.
`orderId`	integer · int64	Nie	Identyfikacja zamówienia.
`organizationId`	integer · int64	Nie	Id organizacyjny.
`externalReceiptId`	string	Nie	Wynik odbioru.
`fiscalNumber`	string	Nie	Numer fiskalny.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Nie	Usługa rejestru gotówki.
`fnsUrl`	string	Nie	- Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Nie	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Nie	Typ kwitu.
`totalAmount`	number · double	Nie	Źródło:
`createdDate`	string · date-time	Nie	Tworzony Termin.
`completedDate`	string · date-time	Nie	Termin zakończony.
`errorMessage`	string	Nie	Wiadomość błędu.

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

Władze3

błędy aplikacyjne są zwykle zwrócone jako JSON w error, localMessage i params. Oddział na error; tekst lokalizowany może się zmienić. W jaki sposób można zwrócić błędy w aplikacji ↑

401auth_required

Wymagane uwierzytelnianie

Authorization brakuje, jest puste lub zawiera nieważny token.

400error_access_denied

Dostęp zabroniony

Token istnieje, ale jego rola nie może wykonywać tej operacji.

500error_unknown

Wystąpił nieznany błąd. Jeśli problem się powtórzy, napisz do służby wsparcia

Nie próbuj ponownie mutacji.

Gotowe do użytkowania przepływy robocze

Zacznij używać Kwitówki

Struktura danych

W jaki sposób można zwrócić błędy w aplikacji

Punkty końcowe

Otrzymuj kwity po zamówieniu

Parametry ścieżki

Odpowiedź udana

Utwórz kwitancję do zamówienia

Parametry ścieżki

Parametry zapytania

Odpowiedź udana

Otrzymaj kwitament

Parametry ścieżki

Odpowiedź udana

Aktualizacja stanu otrzymania

Parametry ścieżki

Odpowiedź udana

Token do wniosków o badania

Prawdziwe parametry żądania

Odpowiedź API