通过可编辑的独立合同来支持本页面. 在生产使用之前,验证使用测试数据的写作操作.
/api/finance
准备使用的工作流程
准备使用的工作流程
数据模型
数据结构
模型在此列出一次,并且可以直接从使用它们的终端点扩展.
Account8 字段
accountIdinteger · int64账户身份证.
namestring姓名.
numberstring号码.
clientIdinteger · int64客户身份证.
organizationIdinteger · int64组织身份证.
bankBank银行.
accountNumberAccount账号号.
accountNameAccount账户名称
Address15 字段
idinteger · int32Id.
postCodestring邮政代码.
countryCountry乡村.
regionRegion地区.
regionIdinteger · int32区域ID
streetstring路上.
housestring房子.
districtstring地区.
citystring城市.
localitystring地方.
buildingstring建筑物.
flatstring没有什么.
shortstring短暂.
addressIdAddress联系方式
fullstring满满.
Bank11 字段
bikstring骑自行车.
namestring姓名.
addressstring现在,我有个地址.
isBankboolean是银行.
accountstring账户.
integrationstring整合.
bankBikBank银行车.
bankNameBank银行名字.
bankAddressBank银行地址.
bankAccountBank银行账户.
bankIntegrationBank银行集成.
Contractor14 字段
idinteger · int64Id.
namestring姓名.
必填versionIdinteger · int64版本ID.
clientIdinteger · int64客户身份证.
read-onlycreatedUserstring创建用户.
read-onlylastIncomeDatestring · date-time收益日期.
read-onlydeletedboolean删除了.
read-onlyorganizationIdinteger · int64组织身份证.
phoneNumberstring电话号码.
emailstring电子邮件.
contactNamestring联系人名字
moySkladIdstring子子的身份.
urlstring查看一个URL.
organizationOrganization组织.
read-onlyCountry6 字段
countryIdinteger · int32国家的身份证.
namestring姓名.
code2string代码2
code3string代码3
namesobject他们的名字.
printNamestring打印名字.
ExpenditureObject7 字段
expenditureIdinteger · int64支出身份
namestring姓名.
typestringType.
clientIdinteger · int64客户身份证.
isCommonboolean常见的.
expenditureNameExpenditureObject支出名称
expenditureTypeExpenditureObject支出类型
Organization33 字段
idinteger · int64Id.
read-onlynamestring姓名.
必填shortNamestring简短名字.
taxTypestring税收类型.
taxRateinteger · int32税率.
taxNdsinteger · int32税收.
inputTaxNdsinteger · int32输入税税.
outputTaxNdsinteger · int32产出税法
enableNewTaxCalculationboolean启用新的税收计算.
useNdsCostPriceboolean使用NDS成本价格.
innstring酒店.
必填kppstring现在,我们要去.
bankstring银行.
bikstring骑自行车.
corrBillstring科尔比尔.
billNumberstring账号号.
stampPathstring邮票路径.
read-onlystampUrlstring邮票URL.
read-onlystampSizeinteger · int32邮票大小.
read-onlystampWidthinteger · int32盖章宽度.
read-onlystampHeightinteger · int32邮票高度.
read-onlysignaturePathstring签字之路.
read-onlysignatureUrlstring签字的URL.
read-onlysignatureSizeinteger · int32签名大小.
read-onlysignatureWidthinteger · int32签字宽度.
read-onlysignatureHeightinteger · int32签字高度.
read-onlyipPersonPerson个人.
formstring形式.
必填ipboolean,我知道.
clientIdinteger · int64客户身份证.
read-onlyaddressAddress现在,我有个地址.
phoneNumberstring电话号码.
addressFullstring地址是完整的.
read-onlyPerson14 字段
personIdinteger · int64个人身份证.
read-onlyfirstNamestring姓名
必填lastNamestring姓名
必填surNamestring苏尔名
clientIdinteger · int64客户身份证.
read-onlypositionPersonPosition位置.
必填versionIdinteger · int64版本ID.
read-onlycreatedUserstring创建用户.
read-onlycreatedDatestring · date-time创造日期.
read-onlydeletedboolean删除了.
read-onlyuserIdinteger · int32用户身份证
read-onlyhasChangesboolean有变化.
fullNamestring完整名字.
read-onlyshortNamestring简短名字.
read-onlyPersonPosition7 字段
idinteger · int64Id.
read-onlynamestring姓名.
必填deletedboolean删除了.
read-onlyclientIdinteger · int64客户身份证.
read-onlydefaultJobIdinteger · int64默认工作身份证.
createdUserstring创建用户.
read-onlycreatedDatestring · date-time创造日期.
read-onlyRegion4 字段
regionIdinteger · int32区域ID
countryIdinteger · int32国家的身份证.
namestring姓名.
regionSynonymsRegionSynonym[]区域同义词
RegionSynonym4 字段
idinteger · int64Id.
regionIdinteger · int64区域ID
synonymstring标语是同义词.
servicestring服务.
Transaction42 字段
transactionIdinteger · int64交易身份证
clientIdinteger · int64客户身份证.
expenditureIdinteger · int64支出身份
expenditureExpenditureObject费用.
directionstring方向.
scheduleIdinteger · int64时间表的身份证.
commentstring评论.
contractorIdinteger · int64承包商身份证.
contractorContractor承包商.
recipientKppinteger · int64收件人 Kpp.
recipientInninteger · int64收件人旅馆.
recipientAccountstring收件人账户
recipientNamestring收件人名
payerKppinteger · int64付款人Kpp.
payerInninteger · int64付款人旅馆.
payerAccountstring付款人账户.
payerNamestring付款人名字.
kbkstring现在,我们要去.
recipientAgentBikinteger · int64收件人Bik代理.
recipientAgentAccountstring收件人代理账户.
recipientAgentNamestring收件人代理名字.
payerAgentBikinteger · int64支付人代理Bik.
payerAgentAccountstring付款代理账户.
payerAgentNamestring付款人代理名字.
accountCurrencystring账户货币
paymentAmountRubnumber · double支付金额
paymentAmountnumber · double付款金额
paymentPurposestring支付目的
paymentDocumentCodestring支付文件代码
paymentDocumentNumberinteger · int64支付文件号码.
datestring · date-time约会.
accountIdinteger · int64账户身份证.
accountAccount账户.
organizationIdinteger · int64组织身份证.
deletedboolean删除了.
includeInPnlboolean加入Pnl中.
incomeIdinteger · int64收入证.
expenditureOperationTypestring支出运营类型
isSuppliersPurchaseTransactionboolean供应商购买交易.
productIdinteger · int64产品身份证
articlestring关于此的文章.
barcodestring条码.
TransactionSchedule18 字段
scheduleIdinteger · int64时间表的身份证.
directionstring方向.
commentstring评论.
accountIdinteger · int64账户身份证.
accountAccount账户.
datestring · date-time约会.
paymentAmountnumber · double付款金额
frequencystring频率.
contractorIdinteger · int64承包商身份证.
expenditureIdinteger · int64支出身份
expenditureExpenditureObject费用.
contractorContractor承包商.
clientIdinteger · int64客户身份证.
organizationIdinteger · int64组织身份证.
creatorstring创造者.
createdDatestring · date-time创造日期.
contractorInnstring承包商酒店.
includeInPnlboolean加入Pnl中.
TmsTask25 字段
idinteger · int64Id.
read-onlystatusstringStatus.
read-onlytypestringType.
read-onlynamestring姓名.
clientIdinteger · int64客户身份证.
entityIdinteger · int64实体身份证
progressinteger · int32进步.
processedQuantityinteger · int32处理量
organizationIdinteger · int64组织身份证.
priorityinteger · int32优先考虑.
propertiesstring房产.
messagestring信息.
messageParamsstring消息帕拉姆.
createdDatestring · date-time创造日期.
startDatestring · date-time开始日期.
finishDatestring · date-time终结日期.
urlstring查看一个URL.
inputFileUrlstring输入文件URL.
retryNumberinteger · int32复试号码.
userIdinteger · int32用户身份证
retryDatestring · date-time试一次.
debugboolean调试.
forcedStartboolean强迫开始.
servicestring服务.
langstringLang.
TransactionFilter17 字段
limitinteger · int32限制.
pageinteger · int32页面.
countboolean伯爵.
sortBystring排序了.
ascendingboolean升高.
querystring问问.
dateFromstring · date-time时间从.
dateTostring · date-time约会到.
organizationIdinteger · int64组织身份证.
organizationIdsinteger[]组织身份证.
servicesstring[]服务.
directionstring方向.
incomeIdinteger · int64收入证.
contractorIdinteger · int64承包商身份证.
timeZoneinteger · int32时间区.
showIncomesboolean收益节目.
accountIdinteger · int64账户身份证.
PeriodTransactionResponse5 字段
startDatestring · date-time开始日期.
必填endDatestring · date-time终结日期.
必填transactionsTransactionStructure[]交易.
必填totalCostnumber · double总成本.
percentDiffnumber · double百分比差异
TransactionStructure10 字段
idinteger · int32Id.
namestring姓名.
costnumber · double价格.
totalSalesnumber · double总销售额.
percentnumber · double百分比.
absPercentnumber · double部百分比.
costWithoutSppnumber · double没有Spp的成本.
totalSalesWithoutSppnumber · double没有Spp的总销售额.
percentWithoutSppnumber · double百分比没有Spp.
directionstring方向.
必填TransactionStructureResponse3 字段
currentPeriodPeriodTransactionResponse现在的时间
必填previousPeriodPeriodTransactionResponse之前的时期.
differencePeriodTransactionResponse差异是什么?
FindResponseTransaction1 字段
rowsTransaction[]排列.
TransactionSchedulerFilter6 字段
limitinteger · int32限制.
pageinteger · int32页面.
countboolean伯爵.
sortBystring排序了.
ascendingboolean升高.
querystring问问.
FindResponseTransactionSchedule1 字段
rowsTransactionSchedule[]排列.
AnalyticsRequest74 字段
periodstring时间.
dateFromstring · date-time时间从.
必填dateTostring · date-time约会到.
必填servicesstring[]服务.
categoriesinteger[]类别.
brandsinteger[]品牌.
clientOrganizationIdinteger · int64客户组织身份证.
organizationsinteger[]组织.
idsinteger[]身份证.
typestringType.
typesstring[]类型.
statusstringStatus.
timeZoneinteger · int32时间区.
previousDateFromstring · date-time之前的日期.
clientOrganizationIdsinteger[]客户组织的身份证.
ignoreCreditboolean忽略信用.
productAnalyticFieldstring产品分析领域
必填querystring问问.
withDuplicateboolean通过复制.
withBonusboolean带着士.
byOrgAndServiceboolean通过组织和服务.
byOrderTypeboolean按顺序类型.
limitinteger · int32限制.
pageinteger · int32页面.
sortBystring排序了.
ascendingboolean升高.
idinteger · int64Id.
isMarketPlaceStructureboolean市场结构.
isDashboardboolean是仪表板.
analyticsFieldstring分析领域.
planDayCountinteger · int32计划日计.
daysToSupplyinteger · int32供应时间.
plannedSupplyDatestring · date-time预计供应日期.
groupByViewboolean按视角组分.
warehousesinteger[]仓库.
salesModelsstring[]销售模式.
aggregationstring集成.
columnsFileExportColumn[]列表.
regionsstring[]地区.
groupboolean集团.
calculationByOrdersboolean根据命令计算.
sourceReportstring来源报告
skipDayWithoutStocksboolean没有股票的节日.
replaceSetsByComponentsboolean取代组件以组件.
distributeFbsByWarehouseboolean根据仓库分发FBS.
distributeFbsStockboolean发行联邦调查局股票.
ignoreDumpingboolean忽略.
isSaleStructureboolean销售结构.
isAveragePerOneUnitboolean平均每一个单位.
updateDateboolean更新日期.
useWeightedGroupboolean使用权重组.
isFindirRequestboolean是Findir请求.
brandIdsinteger[]品牌身份证.
categoryIdsinteger[]类别的身份证.
articlesstring[]文章.
colorsstring[]颜色.
sizesstring[]尺寸.
barcodesstring[]条码.
tagIdsinteger[]标签身份证.
penaltyFromnumber · double罚款从.
penaltyTonumber · double惩罚到.
logisticsFromnumber · double后勤公司
logisticsTonumber · double后勤到.
marginFromnumber · double边缘从.
marginTonumber · double边缘到.
salesAmountFromnumber · double销售额从
salesAmountTonumber · double销售额到
totalSalesAmountFromnumber · double总销售额从
totalSalesAmountTonumber · double总销售额到
grossProfitFromnumber · double总利.
grossProfitTonumber · double总利到.
taxNdsinteger · int32税收.
useOsnoboolean用奥斯诺.
unmatchboolean没有匹配.
FileExportColumn5 字段
idinteger · int64Id.
fileExportIdinteger · int64文件出口身份证
columnNamestring列名
columnOrderinteger · int32列队的命令.
isEnabledboolean已启用.
错误合同
如何返回应用错误
编程的代码在每个地方都相同,而用户面向的消息由服务器翻译. 建立在error周围的应用逻辑,仅用于显示.
鱼类稳定机器可读的代码用于集成逻辑.
鱼类在API代币用户语言中显示准备的消息.
鱼类服务器在本地化消息模板中插入的值.
localMessage使用了 API代币的用户的lang字段.文档语言和 Accept-Language标题不会改变它;当用户没有语言配置时,使用俄语.
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}{
"error": "error_brand_already_exists",
"localMessage": "品牌 Base 已经存在",
"params": {
"name": "Base"
}
}终点
终点
交易的位置
/api/finance/transaction/{id}使用 PUT 输入交易
路径参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 是 | Id. |
要求机构
application/json对象场Transaction
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transactionId |
integer · int64 | 否 | 交易身份证 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditureId |
integer · int64 | 否 | 支出身份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditure |
ExpenditureObject | 否 | 费用. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
directionscheduleIdcommentcontractorIdcontractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
recipientKpprecipientInnrecipientAccountrecipientNamepayerKpppayerInnpayerAccountpayerNamekbkrecipientAgentBikrecipientAgentAccountrecipientAgentNamepayerAgentBikpayerAgentAccountpayerAgentNameaccountCurrencypaymentAmountRubpaymentAmountpaymentPurposepaymentDocumentCodepaymentDocumentNumberdateaccountIdaccount
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNameorganizationIddeletedincludeInPnlincomeIdexpenditureOperationTypeisSuppliersPurchaseTransactionproductIdarticlebarcodecurl --request PUT 'https://api.selsup.ru/api/finance/transaction/1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}'
const response = await fetch('https://api.selsup.ru/api/finance/transaction/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}),
});
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/finance/transaction/1001', {
method: 'PUT',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}),
});
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.put(
'https://api.selsup.ru/api/finance/transaction/1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'transactionId': 1001,
'clientId': 1001,
'expenditureId': 1001,
'expenditure': 'string',
'direction': 'DEBIT',
'scheduleId': 1001
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/transaction/1001',
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("PUT", "https://api.selsup.ru/api/finance/transaction/1001", strings.NewReader(`{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/transaction/1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString("""
{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
Transaction
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transactionId |
integer · int64 | 否 | 交易身份证 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditureId |
integer · int64 | 否 | 支出身份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditure |
ExpenditureObject | 否 | 费用. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
directionscheduleIdcommentcontractorIdcontractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
recipientKpprecipientInnrecipientAccountrecipientNamepayerKpppayerInnpayerAccountpayerNamekbkrecipientAgentBikrecipientAgentAccountrecipientAgentNamepayerAgentBikpayerAgentAccountpayerAgentNameaccountCurrencypaymentAmountRubpaymentAmountpaymentPurposepaymentDocumentCodepaymentDocumentNumberdateaccountIdaccount
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNameorganizationIddeletedincludeInPnlincomeIdexpenditureOperationTypeisSuppliersPurchaseTransactionproductIdarticlebarcode{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}错误16
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_comment_max_length应用逻辑中使用稳定的error_comment_max_length代码;localMessage包含上述翻译.
error_contractor_not_found应用逻辑中使用稳定的error_contractor_not_found代码;localMessage包含上述翻译.
error_date_not_found应用逻辑中使用稳定的error_date_not_found代码;localMessage包含上述翻译.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_sum应用逻辑中使用稳定的error_empty_sum代码;localMessage包含上述翻译.
error_expenditure_type_not_found应用逻辑中使用稳定的error_expenditure_type_not_found代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_no_correct_sum应用逻辑中使用稳定的error_no_correct_sum代码;localMessage包含上述翻译.
error_no_correct_sum_rub应用逻辑中使用稳定的error_no_correct_sum_rub代码;localMessage包含上述翻译.
error_organization_not_found应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.
error_product_not_found应用逻辑中使用稳定的error_product_not_found代码;localMessage包含上述翻译.
error_transaction_id_not_found应用逻辑中使用稳定的error_transaction_id_not_found代码;localMessage包含上述翻译.
error_wrong_sum应用逻辑中使用稳定的error_wrong_sum代码;localMessage包含上述翻译.
更新时间表
/api/finance/updateSchedule使用 POST /api/finance/updateSchedule. 更新时间表
要求机构
application/json对象场TransactionSchedule
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
scheduleId |
integer · int64 | 否 | 时间表的身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
direction |
stringDEBIT, CREDIT | 否 | 方向. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comment |
string | 否 | 评论. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account |
Account | 否 | 账户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamedatepaymentAmountfrequencycontractorIdexpenditureIdexpenditure
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
contractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
clientIdorganizationIdcreatorcreatedDatecontractorInnincludeInPnlcurl --request POST 'https://api.selsup.ru/api/finance/updateSchedule' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}'
const response = await fetch('https://api.selsup.ru/api/finance/updateSchedule', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}),
});
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/finance/updateSchedule', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}),
});
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/finance/updateSchedule',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'scheduleId': 1001,
'direction': 'DEBIT',
'comment': 'string',
'accountId': 1001,
'account': 'string',
'date': '2026-01-15T12:00:00Z'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/updateSchedule',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/updateSchedule", strings.NewReader(`{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/updateSchedule"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
TransactionSchedule
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
scheduleId |
integer · int64 | 否 | 时间表的身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
direction |
stringDEBIT, CREDIT | 否 | 方向. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comment |
string | 否 | 评论. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account |
Account | 否 | 账户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamedatepaymentAmountfrequencycontractorIdexpenditureIdexpenditure
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
contractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
clientIdorganizationIdcreatorcreatedDatecontractorInnincludeInPnl{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}错误13
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_comment_max_length应用逻辑中使用稳定的error_comment_max_length代码;localMessage包含上述翻译.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_expenditure应用逻辑中使用稳定的error_empty_expenditure代码;localMessage包含上述翻译.
error_empty_frequency应用逻辑中使用稳定的error_empty_frequency代码;localMessage包含上述翻译.
error_empty_sum应用逻辑中使用稳定的error_empty_sum代码;localMessage包含上述翻译.
error_empty_transaction_comment应用逻辑中使用稳定的error_empty_transaction_comment代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_organization_not_found应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.
error_wrong_date应用逻辑中使用稳定的error_wrong_date代码;localMessage包含上述翻译.
error_wrong_sum应用逻辑中使用稳定的error_wrong_sum代码;localMessage包含上述翻译.
更新支出
/api/finance/updateExpenditure使用 POST /api/finance/updateExpenditure. 更新支出
要求机构
application/json对象场ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
curl --request POST 'https://api.selsup.ru/api/finance/updateExpenditure' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}'
const response = await fetch('https://api.selsup.ru/api/finance/updateExpenditure', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}),
});
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/finance/updateExpenditure', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}),
});
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/finance/updateExpenditure',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'expenditureId': 1001,
'name': 'Example',
'type': 'DEBIT',
'clientId': 1001,
'isCommon': False,
'expenditureName': 'Example'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/updateExpenditure',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/updateExpenditure", strings.NewReader(`{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/updateExpenditure"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}错误7
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_name应用逻辑中使用稳定的error_empty_name代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_not_uniq_expenditure应用逻辑中使用稳定的error_not_uniq_expenditure代码;localMessage包含上述翻译.
更新账户
/api/finance/updateAccount使用 POST 更新账户
要求机构
application/json对象场Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamecurl --request POST 'https://api.selsup.ru/api/finance/updateAccount' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}'
const response = await fetch('https://api.selsup.ru/api/finance/updateAccount', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}),
});
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/finance/updateAccount', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}),
});
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/finance/updateAccount',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'accountId': 1001,
'name': 'Example',
'number': 'string',
'clientId': 1001,
'organizationId': 1001,
'bank': 'string'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/updateAccount',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/updateAccount", strings.NewReader(`{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/updateAccount"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountName{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}错误8
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_empty_account_name应用逻辑中使用稳定的error_empty_account_name代码;localMessage包含上述翻译.
error_empty_account_number应用逻辑中使用稳定的error_empty_account_number代码;localMessage包含上述翻译.
error_empty_bank应用逻辑中使用稳定的error_empty_bank代码;localMessage包含上述翻译.
error_empty_organization应用逻辑中使用稳定的error_empty_organization代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
交易后
/api/finance/transaction使用 POST /api/finance/transaction.进行后期交易
要求机构
application/json对象场Transaction
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transactionId |
integer · int64 | 否 | 交易身份证 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditureId |
integer · int64 | 否 | 支出身份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditure |
ExpenditureObject | 否 | 费用. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
directionscheduleIdcommentcontractorIdcontractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
recipientKpprecipientInnrecipientAccountrecipientNamepayerKpppayerInnpayerAccountpayerNamekbkrecipientAgentBikrecipientAgentAccountrecipientAgentNamepayerAgentBikpayerAgentAccountpayerAgentNameaccountCurrencypaymentAmountRubpaymentAmountpaymentPurposepaymentDocumentCodepaymentDocumentNumberdateaccountIdaccount
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNameorganizationIddeletedincludeInPnlincomeIdexpenditureOperationTypeisSuppliersPurchaseTransactionproductIdarticlebarcodecurl --request POST 'https://api.selsup.ru/api/finance/transaction' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}'
const response = await fetch('https://api.selsup.ru/api/finance/transaction', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}),
});
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/finance/transaction', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}),
});
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/finance/transaction',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'transactionId': 1001,
'clientId': 1001,
'expenditureId': 1001,
'expenditure': 'string',
'direction': 'DEBIT',
'scheduleId': 1001
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/transaction',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/transaction", strings.NewReader(`{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/transaction"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
Transaction
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transactionId |
integer · int64 | 否 | 交易身份证 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditureId |
integer · int64 | 否 | 支出身份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditure |
ExpenditureObject | 否 | 费用. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
directionscheduleIdcommentcontractorIdcontractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
recipientKpprecipientInnrecipientAccountrecipientNamepayerKpppayerInnpayerAccountpayerNamekbkrecipientAgentBikrecipientAgentAccountrecipientAgentNamepayerAgentBikpayerAgentAccountpayerAgentNameaccountCurrencypaymentAmountRubpaymentAmountpaymentPurposepaymentDocumentCodepaymentDocumentNumberdateaccountIdaccount
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNameorganizationIddeletedincludeInPnlincomeIdexpenditureOperationTypeisSuppliersPurchaseTransactionproductIdarticlebarcode{
"transactionId": 1001,
"clientId": 1001,
"expenditureId": 1001,
"expenditure": "string",
"direction": "DEBIT",
"scheduleId": 1001
}错误12
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_comment_max_length应用逻辑中使用稳定的error_comment_max_length代码;localMessage包含上述翻译.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_sum应用逻辑中使用稳定的error_empty_sum代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_no_correct_sum应用逻辑中使用稳定的error_no_correct_sum代码;localMessage包含上述翻译.
error_no_correct_sum_rub应用逻辑中使用稳定的error_no_correct_sum_rub代码;localMessage包含上述翻译.
error_organization_not_found应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.
error_product_not_found应用逻辑中使用稳定的error_product_not_found代码;localMessage包含上述翻译.
error_wrong_sum应用逻辑中使用稳定的error_wrong_sum代码;localMessage包含上述翻译.
删除交易
/api/finance/transaction使用 DELETE 删除交易
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer[] | 是 | Id. |
curl --request DELETE 'https://api.selsup.ru/api/finance/transaction?id=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/transaction?id=1001', {
method: 'DELETE',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const response: Response = await fetch('https://api.selsup.ru/api/finance/transaction?id=1001', {
method: 'DELETE',
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');
}
import os
import requests
response = requests.delete(
'https://api.selsup.ru/api/finance/transaction?id=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/transaction?id=1001',
CURLOPT_CUSTOMREQUEST => 'DELETE',
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("DELETE", "https://api.selsup.ru/api/finance/transaction?id=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/finance/transaction?id=1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.method("DELETE", 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答案没有身体.
错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
删除时间表
/api/finance/removeSchedule使用 POST /api/finance/removeSchedule.删除时间表
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
scheduleId |
integer · int64 | 是 | 时间表的身份证. |
curl --request POST 'https://api.selsup.ru/api/finance/removeSchedule?scheduleId=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/removeSchedule?scheduleId=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 response: Response = await fetch('https://api.selsup.ru/api/finance/removeSchedule?scheduleId=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');
}
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/finance/removeSchedule?scheduleId=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/removeSchedule?scheduleId=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/finance/removeSchedule?scheduleId=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/finance/removeSchedule?scheduleId=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答案没有身体.
错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
减少支出
/api/finance/removeExpenditure使用 POST 删除 /api/finance/removeExpenditure. 的支出
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 是 | 支出身份 |
curl --request POST 'https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=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 response: Response = await fetch('https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=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');
}
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/removeExpenditure?expenditureId=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/finance/removeExpenditure?expenditureId=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/finance/removeExpenditure?expenditureId=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答案没有身体.
错误6
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_can`t_remove_object_of_expenditure应用逻辑中使用稳定的error_can`t_remove_object_of_expenditure代码;localMessage包含上述翻译.
error_expenditure_not_has_been_remove应用逻辑中使用稳定的error_expenditure_not_has_been_remove代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
删除账户
/api/finance/removeAccount使用 POST /api/finance/removeAccount. 删除帐户
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
accountId |
integer · int64 | 是 | 账户身份证. |
curl --request POST 'https://api.selsup.ru/api/finance/removeAccount?accountId=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/removeAccount?accountId=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 response: Response = await fetch('https://api.selsup.ru/api/finance/removeAccount?accountId=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');
}
import os
import requests
response = requests.post(
'https://api.selsup.ru/api/finance/removeAccount?accountId=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
)
response.raise_for_status()
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/removeAccount?accountId=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/finance/removeAccount?accountId=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/finance/removeAccount?accountId=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答案没有身体.
错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
进口交易
/api/finance/importTransactions使用 POST /api/finance/importTransactions. 导入交易
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
accountId |
integer · int64 | 是 | 账户身份证. |
startDate |
string | 否 | 开始日期. |
curl --request POST 'https://api.selsup.ru/api/finance/importTransactions?accountId=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/importTransactions?accountId=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/finance/importTransactions?accountId=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/finance/importTransactions?accountId=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/finance/importTransactions?accountId=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/finance/importTransactions?accountId=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/finance/importTransactions?accountId=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
对象场
TmsTask
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
status |
stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION | 否 | Status. |
type |
stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT | 否 | Type. |
name |
string | 否 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
entityId |
integer · int64 | 否 | 实体身份证 |
progress |
integer · int32 | 否 | 进步. |
processedQuantity |
integer · int32 | 否 | 处理量 |
organizationId |
integer · int64 | 否 | 组织身份证. |
priority |
integer · int32 | 否 | 优先考虑. |
properties |
string | 否 | 房产. |
message |
string | 否 | 信息. |
messageParams |
string | 否 | 消息帕拉姆. |
createdDate |
string · date-time | 否 | 创造日期. |
startDate |
string · date-time | 否 | 开始日期. |
finishDate |
string · date-time | 否 | 终结日期. |
url |
string | 否 | 查看一个URL. |
inputFileUrl |
string | 否 | 输入文件URL. |
retryNumber |
integer · int32 | 否 | 复试号码. |
userId |
integer · int32 | 否 | 用户身份证 |
retryDate |
string · date-time | 否 | 试一次. |
debug |
boolean | 否 | 调试. |
forcedStart |
boolean | 否 | 强迫开始. |
service |
stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC | 否 | 服务. |
lang |
string | 否 | Lang. |
{
"id": 1001,
"status": "CREATED",
"type": "WILDBERRIES_CREATE_CARD",
"name": "Example",
"clientId": 1001,
"entityId": 1001
}错误3
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
从Excel文件中导入交易
/api/finance/importTransactionFromExcelFile使用POST/api/finance/importTransactionFromExcelFile.从Excel文件中导入交易
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
clientOrganizationId |
integer · int64 | 是 | 客户组织身份证. |
要求机构
multipart/form-data| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
file |
string · binary | 是 | 文件. |
curl --request POST 'https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001' \
--header 'Authorization: YOUR_API_TOKEN' \
--form 'file=@./file.bin'
const form = new FormData();
form.append('file', fileInput.files[0]);
const response = await fetch('https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN },
body: form,
});
if (!response.ok) {
const error = await response.json();
throw new Error(error.error || 'selsup_request_failed');
}
const result = await response.json();
const form: FormData = new FormData();
form.append('file', fileInput.files![0]);
const response: Response = await fetch('https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001', {
method: 'POST',
headers: { Authorization: process.env.SELSUP_API_TOKEN! },
body: form,
});
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/finance/importTransactionFromExcelFile?clientOrganizationId=1001',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
files={'file': open('./logo.png', 'rb')},
)
response.raise_for_status()
result = response.json()
<?php
$payload = ['file' => new CURLFile('./logo.png')];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN')],
CURLOPT_POSTFIELDS => $payload,
]);
$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 (
"bytes"
"fmt"
"io"
"mime/multipart"
"net/http"
"os"
"path/filepath"
)
func main() {
var body bytes.Buffer
writer := multipart.NewWriter(&body)
file, err := os.Open("./logo.png")
if err != nil { panic(err) }
defer file.Close()
part, err := writer.CreateFormFile("file", filepath.Base(file.Name()))
if err != nil { panic(err) }
if _, err = io.Copy(part, file); err != nil { panic(err) }
writer.Close()
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001", &body)
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", writer.FormDataContentType())
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;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class SelSupExample {
public static void main(String[] args) throws Exception {
String boundary = "SelSupBoundary" + System.currentTimeMillis();
byte[] file = Files.readAllBytes(Path.of("./logo.png"));
byte[] head = ("--" + boundary + "\r\n" +
"Content-Disposition: form-data; name=\"file\"; filename=\"logo.png\"\r\n" +
"Content-Type: image/png\r\n\r\n").getBytes(StandardCharsets.UTF_8);
byte[] tail = ("\r\n--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8);
byte[] payload = new byte[head.length + file.length + tail.length];
System.arraycopy(head, 0, payload, 0, head.length);
System.arraycopy(file, 0, payload, head.length, file.length);
System.arraycopy(tail, 0, payload, head.length + file.length, tail.length);
HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.selsup.ru/api/finance/importTransactionFromExcelFile?clientOrganizationId=1001"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "multipart/form-data; boundary=" + boundary)
.method("POST", HttpRequest.BodyPublishers.ofByteArray(payload))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
TmsTask
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
status |
stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION | 否 | Status. |
type |
stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT | 否 | Type. |
name |
string | 否 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
entityId |
integer · int64 | 否 | 实体身份证 |
progress |
integer · int32 | 否 | 进步. |
processedQuantity |
integer · int32 | 否 | 处理量 |
organizationId |
integer · int64 | 否 | 组织身份证. |
priority |
integer · int32 | 否 | 优先考虑. |
properties |
string | 否 | 房产. |
message |
string | 否 | 信息. |
messageParams |
string | 否 | 消息帕拉姆. |
createdDate |
string · date-time | 否 | 创造日期. |
startDate |
string · date-time | 否 | 开始日期. |
finishDate |
string · date-time | 否 | 终结日期. |
url |
string | 否 | 查看一个URL. |
inputFileUrl |
string | 否 | 输入文件URL. |
retryNumber |
integer · int32 | 否 | 复试号码. |
userId |
integer · int32 | 否 | 用户身份证 |
retryDate |
string · date-time | 否 | 试一次. |
debug |
boolean | 否 | 调试. |
forcedStart |
boolean | 否 | 强迫开始. |
service |
stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC | 否 | 服务. |
lang |
string | 否 | Lang. |
{
"id": 1001,
"status": "CREATED",
"type": "WILDBERRIES_CREATE_CARD",
"name": "Example",
"clientId": 1001,
"entityId": 1001
}错误7
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.
error_file_is_empty应用逻辑中使用稳定的error_file_is_empty代码;localMessage包含上述翻译.
error_max_upload_size_exceeded应用逻辑中使用稳定的error_max_upload_size_exceeded代码;localMessage包含上述翻译.
error_wrong_excel应用逻辑中使用稳定的error_wrong_excel代码;localMessage包含上述翻译.
获取账户列表
/api/finance/getAccountList使用 POST /api/finance/getAccountList.获取帐户列表
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bank |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 是 | 银行. |
curl --request POST 'https://api.selsup.ru/api/finance/getAccountList?bank=SBER' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/getAccountList?bank=SBER', {
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/finance/getAccountList?bank=SBER', {
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/finance/getAccountList?bank=SBER',
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/finance/getAccountList?bank=SBER',
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/finance/getAccountList?bank=SBER", 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/finance/getAccountList?bank=SBER"))
.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
阵列项结构
Account[]
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountName[
"string"
]错误12
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_bank_integration应用逻辑中使用稳定的error_no_bank_integration代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_remote_error应用逻辑中使用稳定的error_remote_error代码;localMessage包含上述翻译.
error_sberbank_api应用逻辑中使用稳定的error_sberbank_api代码;localMessage包含上述翻译.
error_service_not_supported应用逻辑中使用稳定的error_service_not_supported代码;localMessage包含上述翻译.
error_tbank应用逻辑中使用稳定的error_tbank代码;localMessage包含上述翻译.
error_tbank_request应用逻辑中使用稳定的error_tbank_request代码;localMessage包含上述翻译.
error_tochka_request应用逻辑中使用稳定的error_tochka_request代码;localMessage包含上述翻译.
error_token_expired_or_revoked应用逻辑中使用稳定的error_token_expired_or_revoked代码;localMessage包含上述翻译.
添加时间表
/api/finance/addSchedule使用 POST /api/finance/addSchedule.添加时间表
要求机构
application/json对象场TransactionSchedule
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
scheduleId |
integer · int64 | 否 | 时间表的身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
direction |
stringDEBIT, CREDIT | 否 | 方向. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comment |
string | 否 | 评论. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account |
Account | 否 | 账户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamedatepaymentAmountfrequencycontractorIdexpenditureIdexpenditure
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
contractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
clientIdorganizationIdcreatorcreatedDatecontractorInnincludeInPnlcurl --request POST 'https://api.selsup.ru/api/finance/addSchedule' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}'
const response = await fetch('https://api.selsup.ru/api/finance/addSchedule', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}),
});
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/finance/addSchedule', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}),
});
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/finance/addSchedule',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'scheduleId': 1001,
'direction': 'DEBIT',
'comment': 'string',
'accountId': 1001,
'account': 'string',
'date': '2026-01-15T12:00:00Z'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/addSchedule',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/addSchedule", strings.NewReader(`{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/addSchedule"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
TransactionSchedule
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
scheduleId |
integer · int64 | 否 | 时间表的身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
direction |
stringDEBIT, CREDIT | 否 | 方向. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comment |
string | 否 | 评论. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account |
Account | 否 | 账户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamedatepaymentAmountfrequencycontractorIdexpenditureIdexpenditure
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
contractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 是 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
versionId |
integer · int64 | 否 | 版本ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
createdUser |
string | 否 | 创建用户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lastIncomeDate |
string · date-time | 否 | 收益日期. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
deleted |
boolean | 否 | 删除了. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
phoneNumber |
string | 否 | 电话号码. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
email |
string | 否 | 电子邮件. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
contactName |
string | 否 | 联系人名字 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
moySkladId |
string | 否 | 子子的身份. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
url |
string | 否 | 查看一个URL. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
organization |
Organization | 否 | 组织. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
shortName |
string | 否 | 简短名字. |
taxType |
stringYSN, YSN_CONSUMPTION, AUSN, AUSN_CONSUMPTION, OSNO, SELF_EMPLOYED | 否 | 税收类型. |
taxRate |
integer · int32 | 否 | 税率. |
taxNds |
integer · int32 | 否 | 税收. |
inputTaxNds |
integer · int32 | 否 | 输入税税. |
outputTaxNds |
integer · int32 | 否 | 产出税法 |
enableNewTaxCalculation |
boolean | 否 | 启用新的税收计算. |
useNdsCostPrice |
boolean | 否 | 使用NDS成本价格. |
inn |
string | 是 | 酒店. |
kpp |
string | 否 | 现在,我们要去. |
bank |
string | 否 | 银行. |
bik |
string | 否 | 骑自行车. |
corrBill |
string | 否 | 科尔比尔. |
billNumber |
string | 否 | 账号号. |
stampPath |
string | 否 | 邮票路径. |
stampUrl |
string | 否 | 邮票URL. |
stampSize |
integer · int32 | 否 | 邮票大小. |
stampWidth |
integer · int32 | 否 | 盖章宽度. |
stampHeight |
integer · int32 | 否 | 邮票高度. |
signaturePath |
string | 否 | 签字之路. |
signatureUrl |
string | 否 | 签字的URL. |
signatureSize |
integer · int32 | 否 | 签名大小. |
signatureWidth |
integer · int32 | 否 | 签字宽度. |
signatureHeight |
integer · int32 | 否 | 签字高度. |
ipPerson |
Person | 否 | 个人. |
form |
stringOOO, IP, SELF_EMPLOYED | 是 | 形式. |
ip |
boolean | 否 | ,我知道. |
clientId |
integer · int64 | 否 | 客户身份证. |
address |
Address | 否 | 现在,我有个地址. |
phoneNumber |
string | 否 | 电话号码. |
addressFull |
string | 否 | 地址是完整的. |
clientIdorganizationIdcreatorcreatedDatecontractorInnincludeInPnl{
"scheduleId": 1001,
"direction": "DEBIT",
"comment": "string",
"accountId": 1001,
"account": "string",
"date": "2026-01-15T12:00:00Z"
}错误16
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.
error_comment_max_length应用逻辑中使用稳定的error_comment_max_length代码;localMessage包含上述翻译.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_expenditure应用逻辑中使用稳定的error_empty_expenditure代码;localMessage包含上述翻译.
error_empty_frequency应用逻辑中使用稳定的error_empty_frequency代码;localMessage包含上述翻译.
error_empty_sum应用逻辑中使用稳定的error_empty_sum代码;localMessage包含上述翻译.
error_empty_transaction_comment应用逻辑中使用稳定的error_empty_transaction_comment代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_no_correct_sum应用逻辑中使用稳定的error_no_correct_sum代码;localMessage包含上述翻译.
error_no_correct_sum_rub应用逻辑中使用稳定的error_no_correct_sum_rub代码;localMessage包含上述翻译.
error_organization_not_found应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.
error_wrong_date应用逻辑中使用稳定的error_wrong_date代码;localMessage包含上述翻译.
error_wrong_sum应用逻辑中使用稳定的error_wrong_sum代码;localMessage包含上述翻译.
增加支出
/api/finance/addExpenditure使用POSTX/api/finance/addExpenditure.增加支出
要求机构
application/json对象场ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
curl --request POST 'https://api.selsup.ru/api/finance/addExpenditure' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}'
const response = await fetch('https://api.selsup.ru/api/finance/addExpenditure', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}),
});
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/finance/addExpenditure', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}),
});
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/finance/addExpenditure',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'expenditureId': 1001,
'name': 'Example',
'type': 'DEBIT',
'clientId': 1001,
'isCommon': False,
'expenditureName': 'Example'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/addExpenditure',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/addExpenditure", strings.NewReader(`{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/addExpenditure"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
{
"expenditureId": 1001,
"name": "Example",
"type": "DEBIT",
"clientId": 1001,
"isCommon": false,
"expenditureName": "Example"
}错误7
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_empty_direction应用逻辑中使用稳定的error_empty_direction代码;localMessage包含上述翻译.
error_empty_name应用逻辑中使用稳定的error_empty_name代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_not_uniq_expenditure应用逻辑中使用稳定的error_not_uniq_expenditure代码;localMessage包含上述翻译.
添加帐户
/api/finance/addAccount使用 POST /api/finance/addAccount. 添加帐户
要求机构
application/json对象场Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountNamecurl --request POST 'https://api.selsup.ru/api/finance/addAccount' \
--header 'Authorization: YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}'
const response = await fetch('https://api.selsup.ru/api/finance/addAccount', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}),
});
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/finance/addAccount', {
method: 'POST',
headers: {
Authorization: process.env.SELSUP_API_TOKEN!,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}),
});
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/finance/addAccount',
headers={'Authorization': os.environ['SELSUP_API_TOKEN']},
json={
'accountId': 1001,
'name': 'Example',
'number': 'string',
'clientId': 1001,
'organizationId': 1001,
'bank': 'string'
},
)
response.raise_for_status()
result = response.json()
<?php
$payload = <<<'JSON'
{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}
JSON;
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.selsup.ru/api/finance/addAccount',
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: ' . getenv('SELSUP_API_TOKEN'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $payload,
]);
$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"
"strings"
)
func main() {
req, err := http.NewRequest("POST", "https://api.selsup.ru/api/finance/addAccount", strings.NewReader(`{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}`))
if err != nil { panic(err) }
req.Header.Set("Authorization", os.Getenv("SELSUP_API_TOKEN"))
req.Header.Set("Content-Type", "application/json")
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/finance/addAccount"))
.header("Authorization", System.getenv("SELSUP_API_TOKEN"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}
"""))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
成功的反应
200
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountName{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}错误9
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_empty_account_name应用逻辑中使用稳定的error_empty_account_name代码;localMessage包含上述翻译.
error_empty_account_number应用逻辑中使用稳定的error_empty_account_number代码;localMessage包含上述翻译.
error_empty_bank应用逻辑中使用稳定的error_empty_bank代码;localMessage包含上述翻译.
error_empty_organization应用逻辑中使用稳定的error_empty_organization代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
error_organization_not_found应用逻辑中使用稳定的error_organization_not_found代码;localMessage包含上述翻译.
下载交易进口模板
/api/finance/transaction/template使用 GET /api/finance/transaction/template. 下载交易进口模板
curl --request GET 'https://api.selsup.ru/api/finance/transaction/template' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/transaction/template', {
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/finance/transaction/template', {
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/finance/transaction/template',
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/finance/transaction/template',
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/finance/transaction/template", 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/finance/transaction/template"))
.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"string"错误5
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
获取交易结构
/api/finance/transaction/structure使用 GET 获取交易结构
查询参数
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
filter |
TransactionFilter | 是 | 选器. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
limit |
integer · int32 | 否 | 限制. |
page |
integer · int32 | 否 | 页面. |
count |
boolean | 否 | 伯爵. |
sortBy |
string | 否 | 排序了. |
ascending |
boolean | 否 | 升高. |
query |
string | 否 | 问问. |
dateFrom |
string · date-time | 否 | 时间从. |
dateTo |
string · date-time | 否 | 约会到. |
organizationId |
integer · int64 | 否 | 组织身份证. |
organizationIds |
integer[] | 否 | 组织身份证. |
services |
string[] | 否 | 服务. |
direction |
stringDEBIT, CREDIT | 否 | 方向. |
incomeId |
integer · int64 | 否 | 收入证. |
contractorId |
integer · int64 | 否 | 承包商身份证. |
timeZone |
integer · int32 | 否 | 时间区. |
showIncomes |
boolean | 否 | 收益节目. |
accountId |
integer · int64 | 否 | 账户身份证. |
includePreviousPeriod默认值: falsecurl --request GET 'https://api.selsup.ru/api/finance/transaction/structure?filter=%5Bobject+Object%5D' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/transaction/structure?filter=%5Bobject+Object%5D', {
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/finance/transaction/structure?filter=%5Bobject+Object%5D', {
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/finance/transaction/structure?filter=%5Bobject+Object%5D',
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/finance/transaction/structure?filter=%5Bobject+Object%5D',
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/finance/transaction/structure?filter=%5Bobject+Object%5D", 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/finance/transaction/structure?filter=%5Bobject+Object%5D"))
.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
对象场
TransactionStructureResponse
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
currentPeriod |
PeriodTransactionResponse | 是 | 现在的时间 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startDate |
string · date-time | 是 | 开始日期. | ||||||||||||||||||||||||||||||||||||||||||||
endDate |
string · date-time | 是 | 终结日期. | ||||||||||||||||||||||||||||||||||||||||||||
transactions |
TransactionStructure[] | 是 | 交易. | ||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
cost |
number · double | 否 | 价格. |
totalSales |
number · double | 否 | 总销售额. |
percent |
number · double | 否 | 百分比. |
absPercent |
number · double | 否 | 部百分比. |
costWithoutSpp |
number · double | 否 | 没有Spp的成本. |
totalSalesWithoutSpp |
number · double | 否 | 没有Spp的总销售额. |
percentWithoutSpp |
number · double | 否 | 百分比没有Spp. |
direction |
stringDEBIT, CREDIT | 是 | 方向. |
totalCostpercentDiffpreviousPeriod
对象场
PeriodTransactionResponse
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startDate |
string · date-time | 是 | 开始日期. | ||||||||||||||||||||||||||||||||||||||||||||
endDate |
string · date-time | 是 | 终结日期. | ||||||||||||||||||||||||||||||||||||||||||||
transactions |
TransactionStructure[] | 是 | 交易. | ||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
cost |
number · double | 否 | 价格. |
totalSales |
number · double | 否 | 总销售额. |
percent |
number · double | 否 | 百分比. |
absPercent |
number · double | 否 | 部百分比. |
costWithoutSpp |
number · double | 否 | 没有Spp的成本. |
totalSalesWithoutSpp |
number · double | 否 | 没有Spp的总销售额. |
percentWithoutSpp |
number · double | 否 | 百分比没有Spp. |
direction |
stringDEBIT, CREDIT | 是 | 方向. |
totalCostpercentDiffdifference
对象场
PeriodTransactionResponse
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startDate |
string · date-time | 是 | 开始日期. | ||||||||||||||||||||||||||||||||||||||||||||
endDate |
string · date-time | 是 | 终结日期. | ||||||||||||||||||||||||||||||||||||||||||||
transactions |
TransactionStructure[] | 是 | 交易. | ||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
cost |
number · double | 否 | 价格. |
totalSales |
number · double | 否 | 总销售额. |
percent |
number · double | 否 | 百分比. |
absPercent |
number · double | 否 | 部百分比. |
costWithoutSpp |
number · double | 否 | 没有Spp的成本. |
totalSalesWithoutSpp |
number · double | 否 | 没有Spp的总销售额. |
percentWithoutSpp |
number · double | 否 | 百分比没有Spp. |
direction |
stringDEBIT, CREDIT | 是 | 方向. |
totalCostpercentDiff{
"currentPeriod": "string",
"previousPeriod": "string",
"difference": "string"
}错误3
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
交易查找
/api/finance/transaction/find使用 GET 查找交易
查询参数
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
filter |
TransactionFilter | 是 | 选器. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
limit |
integer · int32 | 否 | 限制. |
page |
integer · int32 | 否 | 页面. |
count |
boolean | 否 | 伯爵. |
sortBy |
string | 否 | 排序了. |
ascending |
boolean | 否 | 升高. |
query |
string | 否 | 问问. |
dateFrom |
string · date-time | 否 | 时间从. |
dateTo |
string · date-time | 否 | 约会到. |
organizationId |
integer · int64 | 否 | 组织身份证. |
organizationIds |
integer[] | 否 | 组织身份证. |
services |
string[] | 否 | 服务. |
direction |
stringDEBIT, CREDIT | 否 | 方向. |
incomeId |
integer · int64 | 否 | 收入证. |
contractorId |
integer · int64 | 否 | 承包商身份证. |
timeZone |
integer · int32 | 否 | 时间区. |
showIncomes |
boolean | 否 | 收益节目. |
accountId |
integer · int64 | 否 | 账户身份证. |
curl --request GET 'https://api.selsup.ru/api/finance/transaction/find?filter=%5Bobject+Object%5D' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/transaction/find?filter=%5Bobject+Object%5D', {
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/finance/transaction/find?filter=%5Bobject+Object%5D', {
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/finance/transaction/find?filter=%5Bobject+Object%5D',
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/finance/transaction/find?filter=%5Bobject+Object%5D',
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/finance/transaction/find?filter=%5Bobject+Object%5D", 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/finance/transaction/find?filter=%5Bobject+Object%5D"))
.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
对象场
FindResponseTransaction
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
Transaction[] | 否 | 排列. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
transactionId |
integer · int64 | 否 | 交易身份证 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditureId |
integer · int64 | 否 | 支出身份 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
expenditure |
ExpenditureObject | 否 | 费用. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
directionscheduleIdcommentcontractorIdcontractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
versionId |
integer · int64 | 否 | 版本ID. |
clientId |
integer · int64 | 否 | 客户身份证. |
createdUser |
string | 否 | 创建用户. |
lastIncomeDate |
string · date-time | 否 | 收益日期. |
deleted |
boolean | 否 | 删除了. |
organizationId |
integer · int64 | 否 | 组织身份证. |
phoneNumber |
string | 否 | 电话号码. |
email |
string | 否 | 电子邮件. |
contactName |
string | 否 | 联系人名字 |
moySkladId |
string | 否 | 子子的身份. |
url |
string | 否 | 查看一个URL. |
organization |
Organization | 否 | 组织. |
recipientKpprecipientInnrecipientAccountrecipientNamepayerKpppayerInnpayerAccountpayerNamekbkrecipientAgentBikrecipientAgentAccountrecipientAgentNamepayerAgentBikpayerAgentAccountpayerAgentNameaccountCurrencypaymentAmountRubpaymentAmountpaymentPurposepaymentDocumentCodepaymentDocumentNumberdateaccountIdaccount
对象场
Account
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. |
name |
string | 否 | 姓名. |
number |
string | 否 | 号码. |
clientId |
integer · int64 | 否 | 客户身份证. |
organizationId |
integer · int64 | 否 | 组织身份证. |
bank |
Bank | 否 | 银行. |
accountNumber |
Account | 否 | 账号号. |
accountName |
Account | 否 | 账户名称 |
organizationIddeletedincludeInPnlincomeIdexpenditureOperationTypeisSuppliersPurchaseTransactionproductIdarticlebarcode{
"rows": "string"
}错误6
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.
error_max_page应用逻辑中使用稳定的error_max_page代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
按照指导获取交易结构
/api/finance/getTransactionStructureByDirection使用 GET /api/finance/getTransactionStructureByDirection. 获得交易结构按方向
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
query |
string | 否 | 问问. |
dateFrom |
string · date-time | 否 | 时间从. |
dateTo |
string · date-time | 否 | 约会到. |
organizationId |
integer · int64 | 否 | 组织身份证. |
organizationIds |
integer[] | 否 | 组织身份证. |
services |
string[] | 否 | 服务. |
direction |
stringDEBIT, CREDIT | 否 | 方向. |
incomeId |
integer · int64 | 否 | 收入证. |
contractorId |
integer · int64 | 否 | 承包商身份证. |
timeZone |
integer · int32 | 否 | 时间区. |
showIncomes |
boolean | 否 | 收益节目. |
accountId |
integer · int64 | 否 | 账户身份证. |
limit |
integer · int32 | 否 | 限制. |
page |
integer · int32 | 否 | 页面. |
count |
boolean | 否 | 伯爵. |
sortBy |
string | 否 | 排序了. |
ascending |
boolean | 否 | 升高. |
curl --request GET 'https://api.selsup.ru/api/finance/getTransactionStructureByDirection?limit=50&page=1' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/getTransactionStructureByDirection?limit=50&page=1', {
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/finance/getTransactionStructureByDirection?limit=50&page=1', {
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/finance/getTransactionStructureByDirection?limit=50&page=1',
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/finance/getTransactionStructureByDirection?limit=50&page=1',
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/finance/getTransactionStructureByDirection?limit=50&page=1", 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/finance/getTransactionStructureByDirection?limit=50&page=1"))
.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
阵列项结构
TransactionStructure[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int32 | 否 | Id. |
name |
string | 否 | 姓名. |
cost |
number · double | 否 | 价格. |
totalSales |
number · double | 否 | 总销售额. |
percent |
number · double | 否 | 百分比. |
absPercent |
number · double | 否 | 部百分比. |
costWithoutSpp |
number · double | 否 | 没有Spp的成本. |
totalSalesWithoutSpp |
number · double | 否 | 没有Spp的总销售额. |
percentWithoutSpp |
number · double | 否 | 百分比没有Spp. |
direction |
stringDEBIT, CREDIT | 是 | 方向. |
[
"string"
]错误5
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_direction_cant_find应用逻辑中使用稳定的error_direction_cant_find代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
获得银行账户
/api/finance/getAccounts使用 GET 获得银行账户
curl --request GET 'https://api.selsup.ru/api/finance/getAccounts' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/getAccounts', {
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/finance/getAccounts', {
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/finance/getAccounts',
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/finance/getAccounts',
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/finance/getAccounts", 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/finance/getAccounts"))
.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
阵列项结构
Account[]
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountName[
"string"
]错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
根据ID查看账号
/api/finance/getAccountById使用 GET /api/finance/getAccountById.获取账号按ID
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 是 | Id. |
curl --request GET 'https://api.selsup.ru/api/finance/getAccountById?id=1001' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/getAccountById?id=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/finance/getAccountById?id=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/finance/getAccountById?id=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/finance/getAccountById?id=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/finance/getAccountById?id=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/finance/getAccountById?id=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
对象场
Account
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
name |
string | 否 | 姓名. | ||||||||||||||||||||||||||||||||||||||||||||||||
number |
string | 否 | 号码. | ||||||||||||||||||||||||||||||||||||||||||||||||
clientId |
integer · int64 | 否 | 客户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
organizationId |
integer · int64 | 否 | 组织身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||
bank |
Bank | 否 | 银行. | ||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
accountNumberaccountName{
"accountId": 1001,
"name": "Example",
"number": "string",
"clientId": 1001,
"organizationId": 1001,
"bank": "string"
}错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
找时间表
/api/finance/findSchedule使用 GET 找到时间表
查询参数
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
filter |
TransactionSchedulerFilter | 是 | 选器. | ||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
limit |
integer · int32 | 否 | 限制. |
page |
integer · int32 | 否 | 页面. |
count |
boolean | 否 | 伯爵. |
sortBy |
string | 否 | 排序了. |
ascending |
boolean | 否 | 升高. |
query |
string | 否 | 问问. |
curl --request GET 'https://api.selsup.ru/api/finance/findSchedule?filter=%5Bobject+Object%5D' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/findSchedule?filter=%5Bobject+Object%5D', {
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/finance/findSchedule?filter=%5Bobject+Object%5D', {
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/finance/findSchedule?filter=%5Bobject+Object%5D',
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/finance/findSchedule?filter=%5Bobject+Object%5D',
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/finance/findSchedule?filter=%5Bobject+Object%5D", 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/finance/findSchedule?filter=%5Bobject+Object%5D"))
.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
对象场
FindResponseTransactionSchedule
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
rows |
TransactionSchedule[] | 否 | 排列. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
scheduleId |
integer · int64 | 否 | 时间表的身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
direction |
stringDEBIT, CREDIT | 否 | 方向. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
comment |
string | 否 | 评论. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountId |
integer · int64 | 否 | 账户身份证. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
account |
Account | 否 | 账户. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
accountId |
integer · int64 | 否 | 账户身份证. |
name |
string | 否 | 姓名. |
number |
string | 否 | 号码. |
clientId |
integer · int64 | 否 | 客户身份证. |
organizationId |
integer · int64 | 否 | 组织身份证. |
bank |
Bank | 否 | 银行. |
accountNumber |
Account | 否 | 账号号. |
accountName |
Account | 否 | 账户名称 |
datepaymentAmountfrequencycontractorIdexpenditureIdexpenditure
对象场
ExpenditureObject
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
contractor
对象场
Contractor
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
name |
string | 是 | 姓名. |
versionId |
integer · int64 | 否 | 版本ID. |
clientId |
integer · int64 | 否 | 客户身份证. |
createdUser |
string | 否 | 创建用户. |
lastIncomeDate |
string · date-time | 否 | 收益日期. |
deleted |
boolean | 否 | 删除了. |
organizationId |
integer · int64 | 否 | 组织身份证. |
phoneNumber |
string | 否 | 电话号码. |
email |
string | 否 | 电子邮件. |
contactName |
string | 否 | 联系人名字 |
moySkladId |
string | 否 | 子子的身份. |
url |
string | 否 | 查看一个URL. |
organization |
Organization | 否 | 组织. |
clientIdorganizationIdcreatorcreatedDatecontractorInnincludeInPnl{
"rows": "string"
}错误5
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.
error_no_client应用逻辑中使用稳定的error_no_client代码;localMessage包含上述翻译.
收取支出
/api/finance/fetchExpenditure使用GETX/api/finance/fetchExpenditure.的支出
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
query |
string | 是 | 问问. |
direction |
stringDEBIT, CREDIT | 否 | 方向. |
limit |
integer · int32 | 是 | 限制. |
curl --request GET 'https://api.selsup.ru/api/finance/fetchExpenditure?query=string&limit=50' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/fetchExpenditure?query=string&limit=50', {
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/finance/fetchExpenditure?query=string&limit=50', {
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/finance/fetchExpenditure?query=string&limit=50',
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/finance/fetchExpenditure?query=string&limit=50',
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/finance/fetchExpenditure?query=string&limit=50", 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/finance/fetchExpenditure?query=string&limit=50"))
.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
阵列项结构
ExpenditureObject[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
expenditureId |
integer · int64 | 否 | 支出身份 |
name |
string | 否 | 姓名. |
type |
stringDEBIT, CREDIT | 否 | Type. |
clientId |
integer · int64 | 否 | 客户身份证. |
isCommon |
boolean | 否 | 常见的. |
expenditureName |
ExpenditureObject | 否 | 支出名称 |
expenditureType |
ExpenditureObject | 否 | 支出类型 |
[
"string"
]错误3
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
带来银行
/api/finance/fetchBank使用GET/api/finance/fetchBank.的Fetch Bank
查询参数
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
query |
string | 否 | 问问. |
limit |
integer · int32 | 是 | 限制. |
curl --request GET 'https://api.selsup.ru/api/finance/fetchBank?limit=50' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/fetchBank?limit=50', {
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/finance/fetchBank?limit=50', {
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/finance/fetchBank?limit=50',
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/finance/fetchBank?limit=50',
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/finance/fetchBank?limit=50", 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/finance/fetchBank?limit=50"))
.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
阵列项结构
Bank[]
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
bik |
string | 否 | 骑自行车. |
name |
string | 否 | 姓名. |
address |
string | 否 | 现在,我有个地址. |
isBank |
boolean | 否 | 是银行. |
account |
string | 否 | 账户. |
integration |
stringSBER, TOCHKA, TBANK, ALFA_BANK | 否 | 整合. |
bankBik |
Bank | 否 | 银行车. |
bankName |
Bank | 否 | 银行名字. |
bankAddress |
Bank | 否 | 银行地址. |
bankAccount |
Bank | 否 | 银行账户. |
bankIntegration |
Bank | 否 | 银行集成. |
[
"string"
]错误3
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
在Excel文件中输出交易
/api/finance/exportTransactionInExcelFile使用GET/api/finance/exportTransactionInExcelFile.的Export 事务
查询参数
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
request |
AnalyticsRequest | 是 | 要求. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
对象场
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
period |
stringDAY, WEEK, MONTH, QUARTER, YEAR, MONTH_3, MONTH_6, END_OF_TARIFF, MONTH_7, MONTH_14, YEAR_2 | 否 | 时间. | ||||||||||||||||||||||||
dateFrom |
string · date-time | 是 | 时间从. | ||||||||||||||||||||||||
dateTo |
string · date-time | 是 | 约会到. | ||||||||||||||||||||||||
services |
string[] | 否 | 服务. | ||||||||||||||||||||||||
categories |
integer[] | 否 | 类别. | ||||||||||||||||||||||||
brands |
integer[] | 否 | 品牌. | ||||||||||||||||||||||||
clientOrganizationId |
integer · int64 | 否 | 客户组织身份证. | ||||||||||||||||||||||||
organizations |
integer[] | 否 | 组织. | ||||||||||||||||||||||||
ids |
integer[] | 否 | 身份证. | ||||||||||||||||||||||||
type |
stringFBM, FBS, INCOME, RETAIL, WHOLESALE, FBO, MOVEMENT, WRITE_OFF, PRODUCTION | 否 | Type. | ||||||||||||||||||||||||
types |
string[] | 否 | 类型. | ||||||||||||||||||||||||
status |
stringCREATED, REVOKING, REVOKED, ORDER_CREATED, CARDS_CREATED, BOX_BARCODES, IMAGES_UPLOADED, INVOICE_UPLOADED, READY_TO_SUPPLY, SUPPLIED, FINISHED, COLLECTED, SEND, DELIVERY, REFUND, COLLECTING, PACKING, PAYMENT_REQUIRED, CANCELED, CONTROVERSIAL, OVERDUE, READY_FOR_PICKUP, WAITING_SUPPLY, PICK_UP_REFUND, REFUND_RECEIVED, DELETED, RESTORE, PRODUCTION_CONFIRMED | 否 | Status. | ||||||||||||||||||||||||
timeZone |
integer · int32 | 否 | 时间区. | ||||||||||||||||||||||||
previousDateFrom |
string · date-time | 否 | 之前的日期. | ||||||||||||||||||||||||
clientOrganizationIds |
integer[] | 否 | 客户组织的身份证. | ||||||||||||||||||||||||
ignoreCredit |
boolean | 否 | 忽略信用. | ||||||||||||||||||||||||
productAnalyticField |
stringBARCODE, COLOR, ARTICLE, BRAND, CATEGORY | 是 | 产品分析领域 | ||||||||||||||||||||||||
query |
string | 否 | 问问. | ||||||||||||||||||||||||
withDuplicate |
boolean | 否 | 通过复制. | ||||||||||||||||||||||||
withBonus |
boolean | 否 | 带着士. | ||||||||||||||||||||||||
byOrgAndService |
boolean | 否 | 通过组织和服务. | ||||||||||||||||||||||||
byOrderType |
boolean | 否 | 按顺序类型. | ||||||||||||||||||||||||
limit |
integer · int32 | 否 | 限制. | ||||||||||||||||||||||||
page |
integer · int32 | 否 | 页面. | ||||||||||||||||||||||||
sortBy |
string | 否 | 排序了. | ||||||||||||||||||||||||
ascending |
boolean | 否 | 升高. | ||||||||||||||||||||||||
id |
integer · int64 | 否 | Id. | ||||||||||||||||||||||||
isMarketPlaceStructure |
boolean | 否 | 市场结构. | ||||||||||||||||||||||||
isDashboard |
boolean | 否 | 是仪表板. | ||||||||||||||||||||||||
analyticsField |
stringPRODUCT, MODEL, GROUP, ORGANIZATION, CLIENT, CATEGORY, PRODUCT_VIEW, BRAND, REGION, WAREHOUSE | 否 | 分析领域. | ||||||||||||||||||||||||
planDayCount |
integer · int32 | 否 | 计划日计. | ||||||||||||||||||||||||
daysToSupply |
integer · int32 | 否 | 供应时间. | ||||||||||||||||||||||||
plannedSupplyDate |
string · date-time | 否 | 预计供应日期. | ||||||||||||||||||||||||
groupByView |
boolean | 否 | 按视角组分. | ||||||||||||||||||||||||
warehouses |
integer[] | 否 | 仓库. | ||||||||||||||||||||||||
salesModels |
string[] | 否 | 销售模式. | ||||||||||||||||||||||||
aggregation |
stringWAREHOUSE, WAREHOUSE_PRODUCT | 否 | 集成. | ||||||||||||||||||||||||
columns |
FileExportColumn[] | 否 | 列表. | ||||||||||||||||||||||||
阵列项结构
|
|||||||||||||||||||||||||||
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
fileExportId |
integer · int64 | 否 | 文件出口身份证 |
columnName |
string | 否 | 列名 |
columnOrder |
integer · int32 | 否 | 列队的命令. |
isEnabled |
boolean | 否 | 已启用. |
regionsgroupcalculationByOrderssourceReportskipDayWithoutStocksreplaceSetsByComponentsdistributeFbsByWarehousedistributeFbsStockignoreDumpingisSaleStructureisAveragePerOneUnitupdateDateuseWeightedGroupisFindirRequestbrandIdscategoryIdsarticlescolorssizesbarcodestagIdspenaltyFrompenaltyTologisticsFromlogisticsTomarginFrommarginTosalesAmountFromsalesAmountTototalSalesAmountFromtotalSalesAmountTogrossProfitFromgrossProfitTotaxNdsuseOsnounmatchcurl --request GET 'https://api.selsup.ru/api/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D' \
--header 'Authorization: YOUR_API_TOKEN'
const response = await fetch('https://api.selsup.ru/api/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D', {
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/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D', {
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/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D',
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/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D',
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/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D", 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/finance/exportTransactionInExcelFile?request=%5Bobject+Object%5D"))
.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
对象场
TmsTask
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
id |
integer · int64 | 否 | Id. |
status |
stringCREATED, RUNNING, FINISHED, ERROR, RESTARTING, INTERRUPTING, INTERRUPTED, STOPPED, EXCEPTION | 否 | Status. |
type |
stringWILDBERRIES_CREATE_CARD, NATIONAL_CATALOG_CREATE_CARD, OZON_CREATE_CARD, OZON_CARDS_IMPORT, IMPORT_FBS_ORDERS, UPLOAD_PHOTOGRAPHY, WILDBERRIES_UPDATE_PRICE, WILDBERRIES_CARD_IMPORT, WILDBERRIES_CARD_UPDATE, SELSUP_STOCKS, REFRESH_PHOTOGRAPHY, SUPPLYING_QUANTITY_TASK, EXPORT_PRICE, OZON_UPDATE_PRICE, WILDBERRIES_FILE_TASK, YANDEX_MARKET_CARD_CREATE, OZON_CARD_UPDATE_TASK, OZON_IMPORT_STAT_TASK, WILDBERRIES_PROFIT_STAT_TASK, ALIEXPRESS_CREATE_CARD_TASK, ALIEXPRESS_UPDATE_CARD_TASK, PRICES_IMPORT_TASK, WILDBERRIES_PRICES_TASK, YANDEX_MARKET_CARD_IMPORT, STOCKS_UPDATE, WILDBERRIES_STOCKS_IMPORT_TASK, WILDBERRIES_ORDERS_AND_SALES_TASK, WILDBERRIES_INCOMES_IMPORT_TASK, OZON_STOCKS_IMPORT_TASK, TURNOVER_DOCUMENTS_TASK, INTRODUCE_WMS_ITEMS_TASK, PRODUCTS_FILE_TASK, MODELS_FILE_TASK, UPDATE_PRODUCT_CODES_TASK, INTRODUCE_CODES_TASK, PRODUCTS_IMPORT_TASK, PRICES_FILE_TASK, YANDEX_MARKET_UPDATE_PRICE_TASK, IMPORT_STOCKS_TASK, MOY_SKLAD_EXPORT_ORDERS, MERGE_PRODUCTS_TASK, PRODUCTS_WILDBERRIES_EXCEL_IMPORT_TASK, MOY_SKLAD_CREATE_CARD, IMPORT_FBO_STOCKS_FROM_FILE, CREATE_WMS_ITEMS, MOY_SKLAD_CARDS_IMPORT, PROMOTION_FILE, UNUSED_1, UNUSED, PRODUCT_ANALYTICS_FILE_TASK, PROMOTION_RESET_FILE, MOY_SKLAD_IMPORT_ORDERS, FINANCE_REPORT_FILE_TASK, YML_FILE_EXPORT, PRODUCT_BALANCE_REPORT_FILE_TASK, CURRENT_PRODUCT_BALANCE_FILE_TASK, IMPORT_TRANSACTIONS, MATCH_UNREGISTERED_PROFIT_REPORT_TASK, UPDATE_AVERAGE_SERVICE_EXPENSES_TASK, YANDEX_MARKET_ORDER_IMPORT_STAT_TASK, ABC_REPORT_FILE_TASK, MODEL_CONTRACTORS_IMPORT, MODEL_CONTRACTORS_EXPORT, BANK_TRANSACTION_IMPORT_FILE_TASK, YML_IMPORT_TASK, SALES_DYNAMIC_REPORT_FILE_TASK, UPDATE_FBS_ORDERS, EXPORT_TRANSACTION_IN_EXCEL_FILE_TASK, IMPORT_TRANSACTION_FROM_EXCEL_FILE_TASK, EXPORT_PROFIT_REPORT_FILE_TASK, IMPORT_PROFIT_REPORT_FROM_EXCEL_FILE_TASK, IMPORT_REALIZATION_REPORT_TASK, STOCK_RECONCILIATION, ORDER_REPORT_FILE_TASK, GET_WB_FBO_ORDER_FROM_PROFIT_REPORT_TASK, TO_QUANTITY_STORAGE_METHOD, APPLY_RECONCILIATION, OZON_IMPORT_FBO_ORDERS_TASK, UPDATE_PURCHASE_PRICE_IN_PROFIT_REPORT_TASK, FBS_LABELS, MERGE_PRODUCT_STOCKS, CREATE_ORDER_FROM_FILE, ALIEXPRESS_CARD_IMPORT, PRICE_LIST_IMPORT, WB_STOCK_REPORT_FILE, CONTRACTORS_REPORT_FILE, PRODUCTS_SBER_MEGA_MARKET_EXCEL_IMPORT_TASK, EXPORT_PROBLEMATIC_PRODUCT_REPORT, PLAN_SUPPLY_REPORT_TASK, PLAN_FACT_SALES_REPORT_FILE, IMPORT_PLAN_SALES_FROM_EXCEL_FILE_TASK, EXPORT_PLAN_SALES_EXCEL_FILE_TASK, ORDERS_TO_BUY_FILE_TASK, MERGE_PRICE_ON_OTHER_MP_TASK, MATCH_PRODUCT_LAST_OPERATION_DATE_TASK, PROBLEMATIC_PRODUCT_PRICE_FILE_TASK, CATEGORIES_IMPORT_EXCEL_TASK, AVITO_CARD_IMPORT, UPDATE_OLD_WB_ORDER_STATUSES_TASK, PRESTA_SHOP_IMPORT_TASK, PRODUCTS_AVITO_EXCEL_IMPORT_TASK, FBO_STOCK_RECONCILIATION_TASK, APPLY_FBO_RECONCILIATION_TASK, EXPORT_REPRICE_PRODUCT_CONFIG_TASK, IMPORT_REPRICE_PRODUCT_CONFIG_TASK, OZON_CASH_FLOW_STATEMENT_IMPORT_TASK, IMPORT_PROMOTION_STRATEGY_FILE_TASK, UPDATE_ORDER_DELIVERY_INFO_TASK, BILLING_OPERATION_TASK, SET_PURCHASE_PERCENT_TASK, REMOVE_PRODUCT_IMAGES_TASK, STRUCTURE_TURNOVER_TASK, OZON_NEW_UPDATE_PRICE, REPLACE_PRODUCT_IMAGE_TASK, UPDATE_OZON_PROMOTION_DATA_TASK, WILDBERRIES_IMPORT_CAMPAIGN_TASK, WILDBERRIES_STORAGE_REPORT_TASK, WEBASYST_LINK_ARTICLE_TASK, DELIVERY_SERVICE_LABELS, HAND_ON_PULSE_FILE_TASK, ITEMS_INCOME_EXCEL_TASK, UPDATE_SETS_EXCEL_TASK, DELETE_PROFIT_REPORTS_BY_FILE_HISTORY_IDS_TASK, EXPORT_PRODUCT_SETS_TASK, AMAZON_CARD_IMPORT, IMPORT_ACCEPTED_PRODUCTS_TASK, ADD_ORDER_PRODUCT_FROM_FILE_TASK, EXPORT_ITEM_HISTORY_FILE_TASK, WILDBERRIES_IMPORT_CAMPAIGN_BY_EXCEL_TASK, REMOVE_CLIENT_ORGANIZATION, EBAY_CARD_IMPORT_TASK, PRODUCTS_IMPORT_FROM_ORGANIZATION_TASK, IMPORT_FBO_ORDERS, LAMODA_CARD_IMPORT, UPDATE_WB_PROMOTION_DATA_TASK, IMPORT_RETURNS_REPORT_TASK, UPDATE_PROMOTION_DATA_TASK, RESTORE_CLIENT_ORGANIZATION, LEROY_MERLIN_CARD_IMPORT, YANDEX_MARKET_STOCKS_IMPORT_TASK, WILDBERRIES_IMPORT_NM_REPORT_TASK, ORDER_ANALYTICS_FILE_TASK, CLIENT_DATABASE_MOVE_TASK, FAST_CARD_IMPORT, EXPORT_PRODUCT_CODE, INSALES_CARD_IMPORT_TASK, REMOVE_PRODUCT_VIDEOS_TASK, UPDATE_CARDS_TASK, FIND_UNPROFITABLE_PRODUCTS_TASK, FIND_UNPURCHASED_PRODUCTS_TASK, WALMART_CARD_IMPORT, PRODUCT_GROUPS_TASK, CONTRACTOR_ARTICLE_EXPORT_TASK, CONTRACTOR_ARTICLE_IMPORT_TASK, CURRENCY_CONVERSION_TASK, UPDATE_SUPPLY_PLAN_REPORT_TASK, EXPORT_SUPPLY_PLAN_REPORT_FILE_TASK, CHECK_STOCK_ORDER, PHOTOGRAPHY_EXCEL, PREPARE_FINDIR_DATA_TASK, CARD_SPLITTING_TASK, EXPORT_IMAGE_UPDATES_TEMPLATE_TASK, IMPORT_IMAGE_UPDATES_TASK, PREPARE_PRODUCT_HAND_ON_PULSE_TASK, UPDATE_OZON_AVERAGE_DELIVERY_TIME, UPDATE_COMMISSIONS_TASK, WOOCOMMERCE_CARD_IMPORT, UPDATE_FBS_STOCKS_HISTORY, RETURNS_FILE_TASK, FAST_PRODUCTS_IMPORT_TASK, ANALYZE_PRODUCT_CARDS_TASK, DETMIR_CARD_IMPORT, MATCH_OZON_REALIZATION_REPORT_TASK, MAGNIT_IMPORT_PRODUCTS_TASK, UPDATE_PURCHASE_PRICE_FROM_STOCKS_IN_PROFIT_REPORT_TASK, MOY_SKLAD_FBO_MP_DATES_FIX, PRICE_HISTORY_FILE_TASK, FBM_ORDERS_IMPORT_TASK, UZUM_IMPORT_PRODUCTS_TASK, OPENCART_CARD_IMPORT, CARDS_IMPORT, OZON_CROSSDOCK_TRANSIT_ROUTES_TASK, UNUSED_2, OZON_IMPORT_SALES_FUNNEL_REPORT_TASK, WRITE_OFF_PRODUCTS_FILE_TASK, CLIENT_DATABASE_CREATE_TASK, UPDATE_FBS_LABELS_TASK, REBUILD_PROFIT_REPORT_HOURLY_AGGREGATE_TASK, OZON_IMPORT_CAMPAIGN_TASK, EXPORT_SUPPLY_PLAN_FILE_TASK, IMPORT_SUPPLY_PLAN_FILE_TASK, CREATE_SERVICE_CARDS, WAREHOUSE_ECONOMICS_FILE_TASK, UPDATE_WILDBERRIES_ACQUIRING_RATE_TASK, PRODUCT_SALES_FORECAST_TASK, UPDATE_PRODUCT_CODES_STATUSES_TASK, MARKETPLACE_UPDATE_PRICE_TASK, UZUM_IMPORT_STAT_TASK, CAMPAIGN_STATS_FILE_TASK, OZON_FBO_WORKFLOW_TASK, EXPORT_CERTIFICATE_TEMPLATE_TASK, IMPORT_CERTIFICATES_TASK, REBUILD_LOCAL_ORDER_PROFIT_REPORT_TASK, SHOPIFY_CARD_IMPORT | 否 | Type. |
name |
string | 否 | 姓名. |
clientId |
integer · int64 | 否 | 客户身份证. |
entityId |
integer · int64 | 否 | 实体身份证 |
progress |
integer · int32 | 否 | 进步. |
processedQuantity |
integer · int32 | 否 | 处理量 |
organizationId |
integer · int64 | 否 | 组织身份证. |
priority |
integer · int32 | 否 | 优先考虑. |
properties |
string | 否 | 房产. |
message |
string | 否 | 信息. |
messageParams |
string | 否 | 消息帕拉姆. |
createdDate |
string · date-time | 否 | 创造日期. |
startDate |
string · date-time | 否 | 开始日期. |
finishDate |
string · date-time | 否 | 终结日期. |
url |
string | 否 | 查看一个URL. |
inputFileUrl |
string | 否 | 输入文件URL. |
retryNumber |
integer · int32 | 否 | 复试号码. |
userId |
integer · int32 | 否 | 用户身份证 |
retryDate |
string · date-time | 否 | 试一次. |
debug |
boolean | 否 | 调试. |
forcedStart |
boolean | 否 | 强迫开始. |
service |
stringNONE, WILDBERRIES, OZON, YANDEX_MARKET, FAMILIYA, NATIONAL_CATALOG, ALIEXPRESS, OTHER, MOY_SKLAD, SBER_MEGA_MARKET, CISLINK, ONE_C, AVITO, LEROY_MERLIN, DETMIR, KAZAN_EXPRESS, EVOTOR, WEBASYST, AMAZON, EBAY, SIMALAND, INSALES, LAMODA, OZON_PERFORMANCE, WALMART, GOOGLE, YANDEX_DISC, EMAIL, WOOCOMMERCE, MAGNIT, OPENCART, M_VIDEO, TAKEALOT, UZUM, SHOPIFY, MAKRO, YANDEX_KIT, BOB_SHOP, KASPI, DIADOC | 否 | 服务. |
lang |
string | 否 | Lang. |
{
"id": 1001,
"status": "CREATED",
"type": "WILDBERRIES_CREATE_CARD",
"name": "Example",
"clientId": 1001,
"entityId": 1001
}错误4
应用错误通常以 JSON, error,localMessage和 params为回归. 如何返回应用错误 ↑
auth_requiredAuthorization 缺失,空,或包含无效的代币.
error_access_denied代币存在,但它的作用不能执行这个操作.
error_unknown节省请求时间和联系支持;不要盲目重新尝试突变.
error_analytics_access_denied应用逻辑中使用稳定的error_analytics_access_denied代码;localMessage包含上述翻译.