---
# System prepended metadata

title: Получение структуры данных по партнеру
tags: [Partnery-integration]

---

---
tags: Partnery-integration
title: Получение структуры данных по партнеру
---

# Получение структуры данных по партнеру

Запрашиваем данные по паретнеру

## 1. Запрос выполнения операции

### Request --->

#### URL:
Стандартный, [см. шаблон обращения](/qB913BdXR_yOg1YE7vwcIQ?book#URL)

#### Headers:
* **apikey**: ==[apikey](/qB913BdXR_yOg1YE7vwcIQ?both#URL)==
* **Content-type**: application/json; charset=utf-8
* **Mq-Jrb-Exchange**: BillingPartnersIntegration
* **Mq-Jrb-Routing-key**: PartnerAccount.==partnerID==
* **Mq-Jrb-Operation**: PartnerStructure
* **Mq-Jrb-Object**: ==partnerID==

:::info
:::spoiler Описание полей
==partnerID==: id аккаунта
:::

#### Body:
```json
{
    "partnerID": 999999
}
```

:::info
:::spoiler Описание полей
- **partnerID**: id аккаунта
:::

:::success
:::spoiler Пример
```json
{
   "partnerID": 999999
}
```
:::

---
### Response <---

Стандартный, [см. шаблон обращения](/NqB913BdXR_yOg1YE7vwcIQ?view#Response-lt—)

---

## 2. Получение результата

### Request --->
Стандартный, [см. шаблон обращения](/qB913BdXR_yOg1YE7vwcIQ?view#URL1)

### Response <---

#### Headers:
* **Content-type**: application/json; charset=utf-8
* **Mq-Jrb-Id**: ==[id](/qB913BdXR_yOg1YE7vwcIQ?view#Headers3)==
* **Mq-Jrb-Id-Result**: ==[id-result](/qB913BdXR_yOg1YE7vwcIQ?view#Headers3)==

#### Body:
```json
{
	"personal": {
		"partner": {
			"ID": 7,
			"name": "ФИО (01.01.1983)"
		        },
                "own_volume": 23640,
                "points": 7764
		},
	"lines": [
		{
			"partner": {
				"ID": 20,
				"name": "ФИО (08.02.1963)"
			},
			"line": 1,
			"summa": 0
		},
	]
}
 
```

:::info
:::spoiler Описание полей
- **personal:** личные данные партнера (структура)
    - **partner:**  партнер (структура)
        - **ID:** id аккаунта
        - **name:** ФИО (дата рождения)
    - **own_volume:** собственный объем

- **lines** партнеры по линиям (массив)
     - **Partner:** подчиненый партнер (структура)
        - **ID**: id аккаунта
        - **name**: ФИО (дата рождения)
    - **line:** на какой линии находится подчиненный партнер
    - **summa:** Объем


:::
:::warning
:::spoiler Пример тела ответа, если партнер **не** найден
```json
{
    "partner_exist": false
}
```
:::

:::success
:::spoiler Пример тела ответа, если партнер **найден**
```json
{
	"personal": {
		"partner": {
			"ID": 7,
			"name": "ГАЛАХОВ ЕВГЕНИЙ СЕРГЕЕВИЧ (01.01.1983)"
		},
		"own_volume": 65140
	},
	"lines": [
		{
			"partner": {
				"subordinate_partnerID": 20,
				"name": "СУРИНА ОЛЬГА ЮРЬЕВНА (08.02.1963)"
			},
			"line": 1,
			"summa": 0
		},
		{
			"partner": {
				"subordinate_partnerID": 14,
				"name": "КОЛЕДА СТАНИСЛАВ МИХАЙЛОВИЧ (16.07.1988)"
			},
			"line": 2,
			"summa": 2005
		},
		{
			"partner": {
				"subordinate_partnerID": 8,
				"name": "ЛИХАЧЕВА ОЛЬГА ВЛАДИМИРОВНА (01.04.1970)"
			},
			"line": 1,
			"summa": 15000
		},
		{
			"partner": {
				"subordinate_partnerID": 9,
				"name": "КУДРИЦКАЯ ЛАРИСА НИКОЛАЕВНА (02.12.1970)"
			},
			"line": 1,
			"summa": 17000
		}
	]
}
```
:::

:::danger
:::spoiler Примеры [ошибочных результатов](/NIkubqRkR5STebBQd8690g#Формат-ошибочных-результатов)
##### 1. В запросе не правильно указан ID, в следствие чего нельзя получить данные партнера
```json
{ 
    "description": "Incorrect incoming parameters: PartnerID='7'",
    "error": "PartnerIdentity.IncorrectParameters"
}
```
:::
---
