Kayıt

Kullanılabilir iş akışları

01

Kitsayı kullanmaya başlayın

Özel bir API token kullanın ve önce test verileri ile okuma işlemlerini doğrulayın.

Token sunucu tarafında tut ve Authorization başlığı gönder.
Gerekli parametreleri kontrol edin ve istek veya yanıt şeması genişletin.
Uygulama hatalarında HTTP durumunu ve sabit error alanını ele alın.

GETBildirme Al POSTSipariş için Belediye Oluştur GETKvitanı Al

Verim modeli

Veriler yapısı

Modeller burada bir kez listelenmiştir ve bunları kullanan uç noktalardan doğrudan genişletilebilir.

Receipt14 alanlar

idinteger · int64

Id.

read-only

clientIdinteger · int64

Müşteri kimliği.

read-only

orderIdinteger · int64

- Sipariş kimliği.

read-only

organizationIdinteger · int64

Teşkilat Kimliği.

read-only

externalReceiptIdstring

Dış Kitset Kimliği.

fiscalNumberstring

Vergi numarası.

cashRegisterServicestring

Nakit Kayıt Hizmetleri.

fnsUrlstring

- Fns Url.

statusstring

Status.

receiptTypestring

- Kits tip.

totalAmountnumber · double

Toplam miktar.

createdDatestring · date-time

Tarih yaratıldı.

read-only

completedDatestring · date-time

Tarih tamamlandı.

errorMessagestring

Hata Mesajı.

Hata sözleşmesi

Uygulama hataları nasıl iade edilir

error kodu her yerde aynıdır, kullanıcıya yönelik mesaj ise sunucu tarafından tercüme edilir. error etrafında uygulama mantığı oluşturun ve localMessage'i yalnızca görüntülemek için kullanın.

error

Entegre mantığı için sabit makine okunur kod.

localMessage

API token kullanıcısının dilinde görüntülemeye hazır mesaj.

params

Sunucu tarafından yerel mesaj şablonuna girilen değerler.

文

localMessage, API tokenine sahip olan kullanıcının lang alanını kullanır. Belgeleme dili ve Accept-Language başlığı değiştirmez; kullanıcıya dil yapılandırılmadığında Rusça kullanılır.

RUKullanıcı yerel ru

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

TRTürkçe (tr)

{
  "error": "error_brand_already_exists",
  "localMessage": "Base markası zaten mevcut",
  "params": {
    "name": "Base"
  }
}

Son noktaları

GET

Bildirme Al

/api/receipt/order/{orderId}

Okuma erişimi olan işaret

GET /api/receipt/order/{orderId}. kullanarak siparişle Kits alın

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`orderId`	integer · int64	Evet	- Sipariş kimliği.

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

Başarılı tepki

200

Array öğesi yapısı Receipt[]

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`orderId`	integer · int64	Hayır	- Sipariş kimliği.
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`externalReceiptId`	string	Hayır	Dış Kitset Kimliği.
`fiscalNumber`	string	Hayır	Vergi numarası.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Hayır	Nakit Kayıt Hizmetleri.
`fnsUrl`	string	Hayır	- Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Hayır	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Hayır	- Kits tip.
`totalAmount`	number · double	Hayır	Toplam miktar.
`createdDate`	string · date-time	Hayır	Tarih yaratıldı.
`completedDate`	string · date-time	Hayır	Tarih tamamlandı.
`errorMessage`	string	Hayır	Hata Mesajı.

[
  "string"
]

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

POST

Sipariş için Belediye Oluştur

/api/receipt/order/{orderId}

Yazma erişimli işaretleme

POST /api/receipt/order/{orderId}. kullanarak sipariş için makbuz oluştur

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`orderId`	integer · int64	Evet	- Sipariş kimliği.

Sorgulama parametreleri

Alan	Tür	Zorunlu	Açıklama
`type`Varsayılan değer: INCOME	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Hayır	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());
    }
}

Başarılı tepki

200

Nesne alanları Receipt

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`orderId`	integer · int64	Hayır	- Sipariş kimliği.
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`externalReceiptId`	string	Hayır	Dış Kitset Kimliği.
`fiscalNumber`	string	Hayır	Vergi numarası.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Hayır	Nakit Kayıt Hizmetleri.
`fnsUrl`	string	Hayır	- Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Hayır	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Hayır	- Kits tip.
`totalAmount`	number · double	Hayır	Toplam miktar.
`createdDate`	string · date-time	Hayır	Tarih yaratıldı.
`completedDate`	string · date-time	Hayır	Tarih tamamlandı.
`errorMessage`	string	Hayır	Hata Mesajı.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

Kvitanı Al

/api/receipt/{receiptId}

Okuma erişimi olan işaret

GET /api/receipt/{receiptId}. kullanarak Kits alın

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`receiptId`	integer · int64	Evet	- Kits.

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

Başarılı tepki

200

Nesne alanları Receipt

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`orderId`	integer · int64	Hayır	- Sipariş kimliği.
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`externalReceiptId`	string	Hayır	Dış Kitset Kimliği.
`fiscalNumber`	string	Hayır	Vergi numarası.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Hayır	Nakit Kayıt Hizmetleri.
`fnsUrl`	string	Hayır	- Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Hayır	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Hayır	- Kits tip.
`totalAmount`	number · double	Hayır	Toplam miktar.
`createdDate`	string · date-time	Hayır	Tarih yaratıldı.
`completedDate`	string · date-time	Hayır	Tarih tamamlandı.
`errorMessage`	string	Hayır	Hata Mesajı.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

GET

İlaç Durumu Güncelle

/api/receipt/{receiptId}/update

Okuma erişimi olan işaret

GET /api/receipt/{receiptId}/update. kullanarak İlaç Durumu güncelle

Yol parametreleri

Alan	Tür	Zorunlu	Açıklama
`receiptId`	integer · int64	Evet	- Kits.

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

Başarılı tepki

200

Nesne alanları Receipt

Alan	Tür	Zorunlu	Açıklama
`id`	integer · int64	Hayır	Id.
`clientId`	integer · int64	Hayır	Müşteri kimliği.
`orderId`	integer · int64	Hayır	- Sipariş kimliği.
`organizationId`	integer · int64	Hayır	Teşkilat Kimliği.
`externalReceiptId`	string	Hayır	Dış Kitset Kimliği.
`fiscalNumber`	string	Hayır	Vergi numarası.
`cashRegisterService`	stringNONE, EVOTOR, ATOL	Hayır	Nakit Kayıt Hizmetleri.
`fnsUrl`	string	Hayır	- Fns Url.
`status`	stringCREATED, PENDING, COMPLETED, FAILED, CANCELLED	Hayır	Status.
`receiptType`	stringINCOME, EXPENSE, REFUND, EXPENSE_REFUND	Hayır	- Kits tip.
`totalAmount`	number · double	Hayır	Toplam miktar.
`createdDate`	string · date-time	Hayır	Tarih yaratıldı.
`completedDate`	string · date-time	Hayır	Tarih tamamlandı.
`errorMessage`	string	Hayır	Hata Mesajı.

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

Hatalar3

Uygulama hataları error, localMessage ve params ile JSON olarak normalde iade edilir. error'e şubeler; yerel metin değişebilir. Uygulama hataları nasıl iade edilir ↑

401auth_required

Doğrulama Gerekli

Authorization eksik, boş veya geçersiz bir token içerir.

400error_access_denied

Erişim engellendi

Token var ama rolü bu işlemleri yapamaz.

500error_unknown

Bilinmeyen bir hata oluştu. Sorun tekrarlanırsa, destek birimine yazın

İç hata. İstek zamanını ve iletişim desteğini tasarruf et; mutasyonu körü körü görmeden tekrar deneme.

Kullanılabilir iş akışları

Kitsayı kullanmaya başlayın

Veriler yapısı

Uygulama hataları nasıl iade edilir

Son noktaları

Bildirme Al

Yol parametreleri

Başarılı tepki

Sipariş için Belediye Oluştur

Yol parametreleri

Sorgulama parametreleri

Başarılı tepki

Kvitanı Al

Yol parametreleri

Başarılı tepki

İlaç Durumu Güncelle

Yol parametreleri

Başarılı tepki

Test istekleri için işaret

Gerçek talep parametreleri

Canlı API tepkisi