Документация для разработчиков
Темная тема

crm.externalchannel.activity.company

Scope: crm Права на выполнение: для всех

Описание

crm.externalchannel.activity.company

Cоздает дело "Документ от компании".

Параметры

См. параметры функций.

Пример вызова для Дела компании

BX24.callMethod(
	"crm.externalchannel.activity.company",
	{
		batch:[
			{
				agent{
					"fields":{
						"обновляемое поле":"значение",
						"ORIGIN_VERSION":"ascFSrbtJfIpEPIEPEnCg==",
						"ORIGIN_ID":"fff6e1b4-55bc-11d9-848a-00112f43529a-10001", 
					},
					"external_fields":{
						"EXTERNAL_URL":"company_id=2001",
					},
					"REQUISITE":[
						{
							"XML_ID":"faa1c2a9-55bc-11d9-848a-00112f43529a-40001",
							"RQ_ADDR":{
								"PRIMARY":{
									"ADDRESS_1":"#Улица, дом, корпус, строение#",
									"ADDRESS_2":"#Квартира / офис#",
									"CITY":"#Город#",
									"POSTAL_CODE":"#Почтовый индекс#",
									"REGION":"#Район#",
									"PROVINCE":"#Область#",
									"COUNTRY":"#Страна#",
									"COUNTRY_CODE":""
								},
								"HOME":{
									"ADDRESS_1":"#Улица, дом, корпус, строение#",
									"ADDRESS_2":"#Квартира / офис#",
									"CITY":"#Город#",
									"POSTAL_CODE":"#Почтовый индекс#",
									"REGION":"#Район#",
									"PROVINCE":"#Область#",
									"COUNTRY":"#Страна#",
									"COUNTRY_CODE":""
								},
								"REGISTERED":{
									"ADDRESS_1":"#Улица, дом, корпус, строение#",
									"ADDRESS_2":"#Квартира / офис#",
									"CITY":"#Город#",
									"POSTAL_CODE":"#Почтовый индекс#",
									"REGION":"#Район#",
									"PROVINCE":"#Область#",
									"COUNTRY":"#Страна#",
									"COUNTRY_CODE":""
								},
								"BENEFICIARY":{
									"ADDRESS_1":"#Улица, дом, корпус, строение#",
									"ADDRESS_2":"#Квартира / офис#",
									"CITY":"#Город#",
									"POSTAL_CODE":"#Почтовый индекс#",
									"REGION":"#Район#",
									"PROVINCE":"#Область#",
									"COUNTRY":"#Страна#",
									"COUNTRY_CODE":""
								}
							},
							"RQ_NAME":"#Организация#",
							"RQ_FIRST_NAME":"",
							"RQ_LAST_NAME":"",
							"RQ_SECOND_NAME":""
							"RQ_COMPANY_NAME":"#Сокращенное наименование организации#",
							"RQ_COMPANY_REG_DATE":"#Дата государственной регистрации#",
							"RQ_DIRECTOR":"#Ген. директор#",
							"RQ_ACCOUNTANT":"#Гл. бухгалтер#",
							"RQ_CEO_NAME":"",
							"RQ_CEO_WORK_POS":"",
							"RQ_CONTACT":"",
							"RQ_EMAIL":"",
							"RQ_PHONE":"",
							"RQ_FAX":"",
							"RQ_IDENT_DOC":""
							"RQ_IDENT_DOC_SER":"",
							"RQ_IDENT_DOC_NUM":"",
							"RQ_IDENT_DOC_DATE":"",
							"RQ_IDENT_DOC_ISSUED_BY":"",
							"RQ_IDENT_DOC_DEP_CODE":"",
							"RQ_INN":"#ИНН#",
							"RQ_KPP":"",
							"RQ_USRLE":"",
							"RQ_IFNS":"",
							"RQ_OGRN":"#ОГРН#",
							"RQ_OGRNIP":"#ОКПО#",
							"RQ_OKPO":"#ОКТМО#",
							"RQ_OKTMO":"",
							"RQ_OKVED":"",
							"RQ_EDRPOU":"",
							"RQ_DRFO":"",
							"RQ_KBE":"",
							"RQ_IIN":"",
							"RQ_BIN":"",
							"RQ_VAT_PAYER":"",
							"RQ_VAT_ID":"",
							"RQ_VAT_CERT_SER":"",
							"RQ_VAT_CERT_NUM":"",
							"RQ_VAT_CERT_DATE":"",
							"RQ_RESIDENCE_COUNTRY":"",
							"BANK_DETAILS":[
								{"
									"RQ_BANK_NAME":"#Наименование банка#",
									"RQ_BANK_ADDR":"#Адрес банка#",
									"RQ_BANK_ROUTE_NUM":"",
									"RQ_BIK":"#БИК#",
									"RQ_MFO":"",
									"RQ_ACC_NAME":"",
									"RQ_ACC_NUM":"#Расчетный счёт#",
									"RQ_IIK":"",
									"RQ_ACC_CURRENCY":"#Валюта счёта#",
									"RQ_COR_ACC_NUM":"#Кор. счёт#",
									"RQ_IBAN":"",
									"RQ_SWIFT":"#SWIFT#",
									"RQ_BIC":"",
									"COMMENTS":"#Комментарий#",
									"XML_ID":"caa2g4q8-55bc-11d9-848a-00112f43529a-50001"
								}
							]
						}
					]
				},
				activity{
					"fields":{
						"обновляемое поле":"значение"
					},
					"external_fields":{
						"NUMBER":"N-1\/20160518",
						"MANAGER":"",
						"TYPE_ID":"Реализация"
					}
				}
			}
		],
		params:{
			"CHANNEL_ID":"ext_channel.574b405083de90.99016531"
		}
	},
	function(result)
	{
		if(result.error())
			console.error(result.error());
		else
			console.dir(result.data());
	}
);

Для документов типа Реализация достаточно передавать следующий список полей:

batch:[
	{
		"agent":{
			"fields":{
				"обновляемое поле":"значение",
				...
			},
			"external_fields":{
				...
			}
			"activity":{
				"fields":{
					"ORIGIN_ID":"A_xmlid_1_1_20160516",
					"SUBJECT":"Название документа/дела на портале ",
					"START_TIME":"2016-05-20T12:00:50+04:00",
					"DESCRIPTION":"Произвольное описание документа/дела",
					"RESULT_VALUE":"1",
					"RESULT_SUM":"300",
					"RESULT_CURRENCY_ID":"RUB"
				},
				"external_fields":{
					"NUMBER":"N-1\/20160518",
					"MANAGER":"Иван Иванов",
				}
			}
		}
	}
],
params:{
	...
}

Удаление реквизитов

Если на обновление поступил контрагент без реквизитов, то есть отсутствует массив REQUISITE, то будут удалены все его реквизиты, включая банковские, и адреса. Если реквизиты переданы, но не переданы банковские BANK_DETAILS или адреса RQ_ADDR, то будет удалена та сущность, поле которой не передано.

Языковые ограничения

Поля реквизитов, на которые накладываются по умолчанию языковые ограничения.

Поля, которые будут доступны в форме редактирования реквизитов для языка RU и дефолтном наборе пресетов:

RQ_ADDR 
RQ_NAME 
RQ_FIRST_NAME 
RQ_LAST_NAME 
RQ_SECOND_NAME 
RQ_COMPANY_NAME 
RQ_COMPANY_FULL_NAME 
RQ_COMPANY_REG_DATE 
RQ_DIRECTOR 
RQ_ACCOUNTANT 
RQ_CEO_NAME 
RQ_CEO_WORK_POS 
RQ_CONTACT 
RQ_EMAIL 
RQ_PHONE 
RQ_FAX 
RQ_IDENT_DOC 
RQ_IDENT_DOC_SER 
RQ_IDENT_DOC_NUM 
RQ_IDENT_DOC_DATE 
RQ_IDENT_DOC_ISSUED_BY 
RQ_IDENT_DOC_DEP_CODE 
RQ_INN 
RQ_KPP 
RQ_USRLE 
RQ_IFNS 
RQ_OGRN 
RQ_OGRNIP 
RQ_OKPO 
RQ_OKTMO 
RQ_OKVED

Ограничения для банковских реквизитов для языка RU

RQ_BANK_NAME 
RQ_BANK_ADDR 
RQ_BIK 
RQ_ACC_NUM 
RQ_ACC_CURRENCY 
RQ_COR_ACC_NUM 
RQ_SWIFT


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024