Résumé

Flux de travail prêts à l'emploi

01

Commencez à utiliser le reçu

Utilisez un jeton API dédié et validez d'abord les opérations de lecture avec les données de test.

Gardez le jeton côté serveur et envoyez-le dans l'en-tête Authorization.
Vérifiez les paramètres requis et élargissez le schéma de demande ou de réponse.
Traiter l'état HTTP et le champ stable error dans les erreurs d'application.

GETObtenez des reçus par ordre POSTCréer un reçu pour la commande GETObtenez le reçu

Modèle de données

Structures de données

Les modèles sont énumérés une fois ici et peuvent également être étendus directement depuis les terminaux qui les utilisent.

Receipt14 champs

idinteger · int64

Id.

read-only

clientIdinteger · int64

Nom du client.

read-only

orderIdinteger · int64

Nom de commande.

read-only

organizationIdinteger · int64

Identification de l'organisation.

read-only

externalReceiptIdstring

Identification de réception externe.

fiscalNumberstring

Numéro fiscal.

cashRegisterServicestring

Le service de l'enregistrement des espèces.

fnsUrlstring

Je suis en train de vous dire.

statusstring

Status.

receiptTypestring

Type de reçu.

totalAmountnumber · double

Montant total.

createdDatestring · date-time

Date créée.

read-only

completedDatestring · date-time

Date de finition.

errorMessagestring

Message d'erreur.

Contrats d'erreur

Comment les erreurs d'application sont retournées

Le code error est identique dans chaque locale, tandis que le message d'utilisateur est traduit par le serveur.

Le projet de loi

Code stable lisible par machine pour la logique d'intégration.

Le projet de loi

Message prêt à être affiché dans la langue de l'utilisateur de jeton API.

Le projet de loi

Les valeurs interpolées par le serveur dans le modèle de message localisé.

文

localMessage utilise le champ lang de l'utilisateur qui possède le jeton API. Le langage de documentation et l'en-tête Accept-Language ne le modifient pas; le russe est utilisé lorsque l'usager n'a pas de langue configurée.

RULocalisation de l'utilisateur est ru

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

FRFrançais (fr)

{
  "error": "error_brand_already_exists",
  "localMessage": "La marque Base existe déjà",
  "params": {
    "name": "Base"
  }
}

Les points de fin

GET

Obtenez des reçus par ordre

/api/receipt/order/{orderId}

Token avec accès à la lecture

Obtenez des reçus par commande à l'aide de GET /api/receipt/order/{orderId}.

Parametres de parcours

Champ	Type	Obligatoire	Description
`orderId`	integer · int64	Oui	Nom de commande.

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

Réponse réussie

200

Structure des éléments de l'array Receipt[]

Champ	Type	Obligatoire	Description
`id`	integer · int64	Non	Id.
`clientId`	integer · int64	Non	Nom du client.
`orderId`	integer · int64	Non	Nom de commande.
`organizationId`	integer · int64	Non	Identification de l'organisation.
`externalReceiptId`	string	Non	Identification de réception externe.
`fiscalNumber`	string	Non	Numéro fiscal.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Non	Le service de l'enregistrement des espèces.
`fnsUrl`	string	Non	Je suis en train de vous dire.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Non	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Non	Type de reçu.
`totalAmount`	number · double	Non	Montant total.
`createdDate`	string · date-time	Non	Date créée.
`completedDate`	string · date-time	Non	Date de finition.
`errorMessage`	string	Non	Message d'erreur.

[
  "string"
]

Les erreurs3

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required

Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied

Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown

Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

POST

Créer un reçu pour la commande

/api/receipt/order/{orderId}

Token avec accès à l'écriture

Créer un reçu pour commande à l'aide de POST /api/receipt/order/{orderId}.

Parametres de parcours

Champ	Type	Obligatoire	Description
`orderId`	integer · int64	Oui	Nom de commande.

Paramètres de requête

Champ	Type	Obligatoire	Description
`type`Valeur par défaut: INCOME	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Non	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());
    }
}

Réponse réussie

200

champs d'objet Receipt

Champ	Type	Obligatoire	Description
`id`	integer · int64	Non	Id.
`clientId`	integer · int64	Non	Nom du client.
`orderId`	integer · int64	Non	Nom de commande.
`organizationId`	integer · int64	Non	Identification de l'organisation.
`externalReceiptId`	string	Non	Identification de réception externe.
`fiscalNumber`	string	Non	Numéro fiscal.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Non	Le service de l'enregistrement des espèces.
`fnsUrl`	string	Non	Je suis en train de vous dire.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Non	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Non	Type de reçu.
`totalAmount`	number · double	Non	Montant total.
`createdDate`	string · date-time	Non	Date créée.
`completedDate`	string · date-time	Non	Date de finition.
`errorMessage`	string	Non	Message d'erreur.

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

Les erreurs3

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required

Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied

Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown

Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

GET

Obtenez le reçu

/api/receipt/{receiptId}

Token avec accès à la lecture

Obtenez le reçu à l'aide de GET /api/receipt/{receiptId}.

Parametres de parcours

Champ	Type	Obligatoire	Description
`receiptId`	integer · int64	Oui	Le reçu.

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

Réponse réussie

200

champs d'objet Receipt

Champ	Type	Obligatoire	Description
`id`	integer · int64	Non	Id.
`clientId`	integer · int64	Non	Nom du client.
`orderId`	integer · int64	Non	Nom de commande.
`organizationId`	integer · int64	Non	Identification de l'organisation.
`externalReceiptId`	string	Non	Identification de réception externe.
`fiscalNumber`	string	Non	Numéro fiscal.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Non	Le service de l'enregistrement des espèces.
`fnsUrl`	string	Non	Je suis en train de vous dire.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Non	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Non	Type de reçu.
`totalAmount`	number · double	Non	Montant total.
`createdDate`	string · date-time	Non	Date créée.
`completedDate`	string · date-time	Non	Date de finition.
`errorMessage`	string	Non	Message d'erreur.

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

Les erreurs3

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required

Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied

Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown

Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

GET

Mise à jour du statut de réception

/api/receipt/{receiptId}/update

Token avec accès à la lecture

Mise à jour de l'état de la réception à l'aide de GET /api/receipt/{receiptId}/update.

Parametres de parcours

Champ	Type	Obligatoire	Description
`receiptId`	integer · int64	Oui	Le reçu.

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

Réponse réussie

200

champs d'objet Receipt

Champ	Type	Obligatoire	Description
`id`	integer · int64	Non	Id.
`clientId`	integer · int64	Non	Nom du client.
`orderId`	integer · int64	Non	Nom de commande.
`organizationId`	integer · int64	Non	Identification de l'organisation.
`externalReceiptId`	string	Non	Identification de réception externe.
`fiscalNumber`	string	Non	Numéro fiscal.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Non	Le service de l'enregistrement des espèces.
`fnsUrl`	string	Non	Je suis en train de vous dire.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Non	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Non	Type de reçu.
`totalAmount`	number · double	Non	Montant total.
`createdDate`	string · date-time	Non	Date créée.
`completedDate`	string · date-time	Non	Date de finition.
`errorMessage`	string	Non	Message d'erreur.

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

Les erreurs3

Les erreurs d'application sont normalement renvoyées sous le nom JSON avec error, localMessage et params. Brancher sur XPRO TECTED4X; le texte localisé peut changer. Comment les erreurs d'application sont retournées ↑

401auth_required

Autentification requise

Authorization est manquant, vide ou contient un jeton non valide.

400error_access_denied

Accès refusé

Le jeton existe, mais son rôle ne peut pas effectuer cette opération.

500error_unknown

Une erreur inconnue s'est produite. Si le problème persiste, contactez le service d'assistance

Faillite interne: économiser le temps de la demande et le support de contact; ne réessayez pas aveuglément une mutation.

Flux de travail prêts à l'emploi

Commencez à utiliser le reçu

Structures de données

Comment les erreurs d'application sont retournées

Les points de fin

Obtenez des reçus par ordre

Parametres de parcours

Réponse réussie

Créer un reçu pour la commande

Parametres de parcours

Paramètres de requête

Réponse réussie

Obtenez le reçu

Parametres de parcours

Réponse réussie

Mise à jour du statut de réception

Parametres de parcours

Réponse réussie

Marque pour les demandes d'essai

Parametres réels de la demande

Réponse en direct API