Optima2 API v.2 REST

GET /api/v2/tax-deduction/document-type HTTP/1.1

HTTP/1.1 200 OK

[ {
  "id" : "RUSSIAN_PASSPORT",
  "code" : "21",
  "description" : "Паспорт гражданина Российской Федерации"
}, {
  "id" : "BIRTH_CERTIFICATE",
  "code" : "03",
  "description" : "Свидетельство о рождении"
}, {
  "id" : "MILITARY_ID",
  "code" : "07",
  "description" : "Военный билет"
}, {
  "id" : "TEMPORARY_MILITARY_ID",
  "code" : "08",
  "description" : "Временное удостоверение, выданное взамен военного билета"
}, {
  "id" : "FOREIGN_PASSPORT",
  "code" : "10",
  "description" : "Паспорт иностранного гражданина"
}, {
  "id" : "ASYLUM_APPLICATION_CERTIFICATE",
  "code" : "11",
  "description" : "Свидетельство о рассмотрении ходатайства о признании лица беженцем на территории Российской Федерации"
}, {
  "id" : "RESIDENCE_PERMIT",
  "code" : "12",
  "description" : "Вид на жительство в Российской Федерации"
}, {
  "id" : "REFUGEE_CERTIFICATE",
  "code" : "13",
  "description" : "Удостоверение беженца"
}, {
  "id" : "RUSSIAN_TEMPORARY_ID",
  "code" : "14",
  "description" : "Временное удостоверение личности гражданина Российской Федерации"
}, {
  "id" : "TEMPORARY_RESIDENCE_PERMIT",
  "code" : "15",
  "description" : "Разрешение на временное проживание в Российской Федерации"
}, {
  "id" : "TEMPORARY_ASYLUM_CERTIFICATE",
  "code" : "19",
  "description" : "Свидетельство о предоставлении временного убежища на территории Российской Федерации"
}, {
  "id" : "RUSSIAN_INTERNATIONAL_PASSPORT",
  "code" : "22",
  "description" : "Загранпаспорт гражданина Российской Федерации"
}, {
  "id" : "FOREIGN_BIRTH_CERTIFICATE",
  "code" : "23",
  "description" : "Свидетельство о рождении, выданное уполномоченным органом иностранного государства"
}, {
  "id" : "MILITARY_PERSONNEL_ID",
  "code" : "24",
  "description" : "Удостоверение личности военнослужащего Российской Федерации"
}, {
  "id" : "RESERVE_OFFICER_MILITARY_ID",
  "code" : "27",
  "description" : "Военный билет офицера запаса"
}, {
  "id" : "OTHER_DOCUMENTS",
  "code" : "91",
  "description" : "Иные документы <*>"
} ]

GET /api/v2/tax-deduction/precalculate?clientId=9000555999&yearFrom=2024&yearTo=2024 HTTP/1.1

HTTP/1.1 200 OK

[ {
  "year" : 2024,
  "legalEntityId" : 1,
  "legalEntityName" : "ИП Валеева Людмила Александровна",
  "legalEntityInn" : "644901490342",
  "legalEntityKpp" : "0",
  "sum" : 4000.0
}, {
  "year" : 2024,
  "legalEntityId" : 4,
  "legalEntityName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС\"",
  "legalEntityInn" : "6449026622",
  "legalEntityKpp" : "644901001",
  "sum" : 7000.0
} ]

POST /api/v2/tax-deduction/preview HTTP/1.1

{
  "taxpayerIsClient" : false,
  "patient" : {
    "id" : 9000555999,
    "inn" : null,
    "birthday" : "2020-04-25",
    "documentType" : "BIRTH_CERTIFICATE",
    "documentNumber" : "151351697341134",
    "documentIssuedOn" : "2020-04-26"
  },
  "representative" : {
    "id" : 9000666999,
    "inn" : null,
    "birthday" : "1990-02-25",
    "documentType" : "RUSSIAN_PASSPORT",
    "documentNumber" : "4015 445543",
    "documentIssuedOn" : "2010-03-12"
  },
  "keys" : [ {
    "year" : 2024,
    "legalEntityId" : 1
  }, {
    "year" : 2024,
    "legalEntityId" : 4
  } ]
}

HTTP/1.1 200 OK

[ {
  "legalEntity" : {
    "id" : 1,
    "shortName" : "ИП Валеева Людмила Александровна",
    "inn" : "644901490342",
    "kpp" : "0",
    "certificateNumber" : 1
  },
  "correctionNumber" : 0,
  "year" : 2024,
  "taxpayerIsClient" : false,
  "taxpayer" : {
    "id" : null,
    "familyName" : "Отцов",
    "firstName" : "Отец",
    "patronymicName" : "Отцович",
    "inn" : null,
    "birthday" : "1990-02-25",
    "documentCode" : "21",
    "documentNumber" : "4015 445543",
    "documentIssuedOn" : "2010-03-12"
  },
  "patient" : {
    "id" : null,
    "familyName" : "Вычетов",
    "firstName" : "Вычет",
    "patronymicName" : "Вычетович",
    "inn" : null,
    "birthday" : "2020-04-25",
    "documentCode" : "03",
    "documentNumber" : "151351697341134",
    "documentIssuedOn" : "2020-04-26"
  },
  "user" : {
    "id" : 9000000008,
    "firstName" : "topmanager",
    "familyName" : "topmanager",
    "patronymicName" : "topmanager",
    "fullName" : "topmanager topmanager topmanager",
    "shortName" : "topmanager t. t."
  },
  "sum" : 4000.0
}, {
  "legalEntity" : {
    "id" : 4,
    "shortName" : "ООО \"ПОКРОВСК-ОПТИКА ПЛЮС\"",
    "inn" : "6449026622",
    "kpp" : "644901001",
    "certificateNumber" : 1
  },
  "correctionNumber" : 0,
  "year" : 2024,
  "taxpayerIsClient" : false,
  "taxpayer" : {
    "id" : null,
    "familyName" : "Отцов",
    "firstName" : "Отец",
    "patronymicName" : "Отцович",
    "inn" : null,
    "birthday" : "1990-02-25",
    "documentCode" : "21",
    "documentNumber" : "4015 445543",
    "documentIssuedOn" : "2010-03-12"
  },
  "patient" : {
    "id" : null,
    "familyName" : "Вычетов",
    "firstName" : "Вычет",
    "patronymicName" : "Вычетович",
    "inn" : null,
    "birthday" : "2020-04-25",
    "documentCode" : "03",
    "documentNumber" : "151351697341134",
    "documentIssuedOn" : "2020-04-26"
  },
  "user" : {
    "id" : 9000000008,
    "firstName" : "topmanager",
    "familyName" : "topmanager",
    "patronymicName" : "topmanager",
    "fullName" : "topmanager topmanager topmanager",
    "shortName" : "topmanager t. t."
  },
  "sum" : 7000.0
} ]

POST /api/v2/tax-deduction HTTP/1.1

{
  "taxpayerIsClient" : false,
  "patient" : {
    "id" : 9000555999,
    "inn" : null,
    "birthday" : "2020-04-25",
    "documentType" : "BIRTH_CERTIFICATE",
    "documentNumber" : "151351697341134",
    "documentIssuedOn" : "2020-04-26"
  },
  "representative" : {
    "id" : 9000666999,
    "inn" : null,
    "birthday" : "1990-02-25",
    "documentType" : "RUSSIAN_PASSPORT",
    "documentNumber" : "4015 445543",
    "documentIssuedOn" : "2010-03-12"
  },
  "keys" : [ {
    "year" : 2024,
    "legalEntityId" : 1
  }, {
    "year" : 2024,
    "legalEntityId" : 4
  } ]
}

HTTP/1.1 200 OK