Описание объектов API — различия между версиями

Материал из Mr.Doc
Перейти к: навигация, поиск
(→‎Организации (RefOrganization))
(→‎Организации (RefOrganization))
Строка 128: Строка 128:
 
!prefix
 
!prefix
 
|Префикс для генерации номеров документов.
 
|Префикс для генерации номеров документов.
 +
 +
|-
 +
!base_bank_account_id
 +
|Идентификатор основного банковского счета организации из справочника '''RefBankAccount'''.
 +
 +
|-
 +
!director_id
 +
|Идентификатор руководителя из справочника сотрудников '''RefPerson'''.
 +
 +
|-
 +
!chief_accountant_id
 +
|Идентификатор главного бухгалтера из справочника сотрудников '''RefPerson'''.
 +
 +
|-
 +
!certificate_date
 +
|Дата выдачи свидетельства о постановке на учет в формате SQL.
 +
 +
|-
 +
!certificate_number
 +
|Номер свидетельства о постановке на учет.
 +
 +
|-
 +
!phone
 +
|Телефон (11 цифр).
 +
 +
|-
 +
!email
 +
|Адрес электронной почты.
 +
 +
|-
 +
!legal_address_id
 +
|Идентификатор юридического адреса из справочника адресов '''RefAddress'''.
 +
 +
|-
 +
!actual_address_id
 +
|Идентификатор фактического адреса из справочника адресов '''RefAddress'''.
 +
 +
|-
 +
!other
 +
|Прочие контакты.
  
 
|}
 
|}

Версия 17:45, 7 марта 2014

Данная статья посвящена описанию доступных через API объектов и их атрибутов. Некоторые объекты системы имеют табличные части, в API они представлены, как вложенные индексированные массивы с элементами табличных частей.

Пример JSON 

{
    "main_field_1": "value_1",
    "main_field_2": "value_2",
    "table_part_name": [
        {
            "field_1": "value_3",
            "field_2": "value_4",
            "field_3": "value_5"
        },
        {
            "field_1": "value_6",
            "field_2": "value_7",
            "field_3": "value_8"
        }
    ]
}

Пример XML 

<?xml version="1.0" encoding="utf-8"?>
<root>
    <main_field_1>value_1</main_field_1>
    <main_field_2>value_2</main_field_2>
    <table_part_name list="true">
        <item>
            <field_1>value_3</field_1>
            <field_2>value_4</field_2>
            <field_3>value_5</field_3>
        </item>
        <item>
            <field_1>value_6</field_1>
            <field_2>value_7</field_2>
            <field_3>value_8</field_3>
        </item>
    </table_part_name>
</root>

В примерах выше атрибут "table_part_name" - табличная часть, в которой два элемента. "field_1", "field_2" и "field_3" - реквизиты элементов табличной части. В данной статье реквизиты табличных частей будут именоваться в формате "table_part_name.field_1".

Справочники

Организации (RefOrganization)

Имя атрибута Описание
id Идентификатор элемента справочника.
code Учетный код элемента справочника. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
name Наименование элемента справочника.
full_name Полное наименование элемента справочника. При создании, в случае отсутствия в переданных данных будет заполнен данными из атрибута "name".
is_predefined Булево значение - признак предопределенного элемента системы.
status_id Статус элемента справочника. Возможные значения: ПомеченНаУдаление, Активен. Значение по умолчанию - Активен.
append_user_id Идентификатор автора элемента из справочника RefUser.
append_date Дата и время создания элемента справочника в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в элемент справочника.
change_date Дата и время последнего изменения элемента справочника в SQL формате.
is_folder Булево значение - признак группы в справочнике.
parent_folder_id Идентификатор родительской группы из данного справочника.
comment Поле с произвольным текстом.
inn ИНН организации.
kpp КПП организации.
is_vat_payer Булево значение - признак плательщика НДС.
type_id Тип. Возможные значения: ЮрЛицо, ФизЛицо. Значение по умолчанию - "ЮрЛицо".
prefix Префикс для генерации номеров документов.
base_bank_account_id Идентификатор основного банковского счета организации из справочника RefBankAccount.
director_id Идентификатор руководителя из справочника сотрудников RefPerson.
chief_accountant_id Идентификатор главного бухгалтера из справочника сотрудников RefPerson.
certificate_date Дата выдачи свидетельства о постановке на учет в формате SQL.
certificate_number Номер свидетельства о постановке на учет.
phone Телефон (11 цифр).
email Адрес электронной почты.
legal_address_id Идентификатор юридического адреса из справочника адресов RefAddress.
actual_address_id Идентификатор фактического адреса из справочника адресов RefAddress.
other Прочие контакты.

Документы

Оприходование товаров (DocAcceptance)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
price_type_id Идентификатор типа цен из справочника RefPriceType.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
sum Сумма документа.
comment Поле с произвольным текстом.
products.product_id Идентификатор товара из справочника RefNomenclature.
products.sku_id Идентификатор модификации товара из справочника RefSku. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором основной модификации указанного товара.
products.unit_id Идентификатор единицы измерения товара из справочника RefUnit. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором базовой единицы измерения указанного товара.
products.factor Коэффициент - кол-во базовых единиц измерения номенклатуры в текущей единице измерения. При создании, в случае отсутствия в переданных данных будет заполнен коэффициентом указанной единицы измерения.
products.quantity Количество указанного товара.
products.price Цена указанного товара.
products.sum Сумма указанного товара. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.
products.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
products.vat_sum Сумма НДС указанного товара. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.

Поступление денежных средств через эквайера (DocAcquiringIn)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
contractor_id Идентификатор контрагента из справочника RefContractor.
contract_id Идентификатор договора с контрагентом из справочника RefContract. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным контрагентом в системе. При отсутствии такового, будет автоматически создан новый договор.
acquiring_contract_id Идентификатор договора с эквайером из справочника RefContract.
acquiring_payment_type_id Идентификатор вида оплаты через эквайера из справочника RefAcquiringPaymentType.
concession_percent Процент торговой уступки отчисляемый в пользу эквайера. При создании, в случае отсутствия в переданных данных будет заполнен на основании данных в виде оплаты.
concession_sum Сумма торговой уступки отчисляемый в пользу эквайера. При создании, в случае отсутствия в переданных данных будет рассчитан автоматически на основании суммы документа и процента торговой уступки.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
document_basis_id Идентификатор документа основания.
document_basis_type_id Тип документа основания. Возможные значения: DocSaleOrder и DocSale.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
sum Сумма документа.
comment Поле с произвольным текстом.
details.sale_order_id Идентификатор заказа покупателя DocSaleOrder.
details.sum Сумма платежа.
details.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
details.vat_sum Сумма НДС. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании суммы и ставки НДС.

Возврат денежных средств через эквайера (DocAcquiringOut)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
contractor_id Идентификатор контрагента из справочника RefContractor.
contract_id Идентификатор договора с контрагентом из справочника RefContract. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным контрагентом в системе. При отсутствии такового, будет автоматически создан новый договор.
acquiring_contract_id Идентификатор договора с эквайером из справочника RefContract.
acquiring_payment_type_id Идентификатор вида оплаты через эквайера из справочника RefAcquiringPaymentType.
concession_percent Процент торговой уступки отчисляемый в пользу эквайера. При создании, в случае отсутствия в переданных данных будет заполнен на основании данных в виде оплаты.
concession_sum Сумма торговой уступки отчисляемый в пользу эквайера. При создании, в случае отсутствия в переданных данных будет рассчитан автоматически на основании суммы документа и процента торговой уступки.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
document_basis_id Идентификатор документа основания.
document_basis_type_id Тип документа основания. Возможные значения: DocSaleOrder и DocSaleReturn.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
sum Сумма документа.
comment Поле с произвольным текстом.
details.sale_order_id Идентификатор заказа покупателя DocSaleOrder.
details.sum Сумма возврата.
details.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
details.vat_sum Сумма НДС. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании суммы и ставки НДС.

Платежное поручение входящее (DocBankOrderIn)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
contractor_id Идентификатор контрагента из справочника RefContractor.
contract_id Идентификатор договора с контрагентом из справочника RefContract. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным контрагентом в системе. При отсутствии такового, будет автоматически создан новый договор.
contractor_bank_account_id Идентификатор банковского счета контрагента из справочника RefBankAccount.
organization_bank_account_id Идентификатор банковского счета собственной организации из справочника RefBankAccount.
type_id Вид операции. Возможные значения: ОплатаОтПокупателя, ВозвратОтПоставщика, ПоступлениеОтЭквайера и ПрочееПоступление.
incoming_number Номер первичного документа, полученного из банка.
incoming_date Дата первичного документа, полученного из банка в SQL формате.
is_processed Булево значение, которое отражает факт проведения документа в банке.
process_date Дата в SQL формате, которая отражает дату проведения документа банком.
text_basis Назначение платежа.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
document_basis_id Идентификатор документа основания.
document_basis_type_id Тип документа основания. Возможные значения: DocSaleOrder, DocSale, DocPurchaseOrder и DocPurchaseReturn.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
sum Сумма документа.
comment Поле с произвольным текстом.
details.document_basis_id Идентификатор заказа покупателя DocSaleOrder или заказа поставщику DocPurchaseOrder.
details.document_basis_type_id Идентификатор типа заказа покупателя. Возможные значения: DocSaleOrder и DocPurchaseOrder.
details.money_flow_item_id Идентификатор статьи движения денежных средств из справочника RefMoneyFlowItem.
details.sum Сумма поступления.
details.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
details.vat_sum Сумма НДС. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании суммы и ставки НДС.

Платежное поручение исходящее (DocBankOrderOut)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
contractor_id Идентификатор контрагента из справочника RefContractor.
contract_id Идентификатор договора с контрагентом из справочника RefContract. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным контрагентом в системе. При отсутствии такового, будет автоматически создан новый договор.
contractor_bank_account_id Идентификатор банковского счета контрагента из справочника RefBankAccount.
organization_bank_account_id Идентификатор банковского счета собственной организации из справочника RefBankAccount.
type_id Вид операции. Возможные значения: ОплатаПоставщику, ВозвратПокупателю, ВозвратЭквайеру и ПрочееСписание.
incoming_number Номер первичного документа, полученного из банка.
incoming_date Дата первичного документа, полученного из банка в SQL формате.
is_processed Булево значение, которое отражает факт проведения документа в банке.
process_date Дата в SQL формате, которая отражает дату проведения документа банком.
text_basis Назначение платежа.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
document_basis_id Идентификатор документа основания.
document_basis_type_id Тип документа основания. Возможные значения: DocSaleOrder, DocSale, DocPurchaseOrder и DocPurchaseReturn.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
sum Сумма документа.
comment Поле с произвольным текстом.
details.document_basis_id Идентификатор заказа покупателя DocSaleOrder или заказа поставщику DocPurchaseOrder.
details.document_basis_type_id Идентификатор типа заказа покупателя. Возможные значения: DocSaleOrder и DocPurchaseOrder.
details.money_flow_item_id Идентификатор статьи движения денежных средств из справочника RefMoneyFlowItem.
details.sum Сумма списания.
details.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
details.vat_sum Сумма НДС. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании суммы и ставки НДС.

Заказ покупателя (DocSaleOrder)

Имя атрибута Описание
id Идентификатор документа.
date_time Дата документа в формате SQL. При создании, в случае отсутствия в переданных данных будет заполнена текущей датой.
number Учетный номер документа. При создании, в случае отсутствия в переданных данных будет сгенерирован автоматически.
status_id Статус документа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.
organization_id Идентификатор собственной организации из справочника RefOrganization. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.
contractor_id Идентификатор покупателя из справочника RefContractor.
contract_id Идентификатор договора с покупателем из справочника RefContract. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным покупателем в системе. При отсутствии такового, будет автоматически создан новый договор.
currency_id Идентификатор валюты из справочника RefCurrency. Значение по умолчанию - идентификатор валюты "Российский рубль".
price_type_id Идентификатор типа цен из справочника RefPriceType.
is_price_include_vat Булево значение - признак включение НДС в стоимость товаров и услуг.
external_number Номер заказа покупателя из внешней системы.
append_user_id Идентификатор автора документа из справочника RefUser.
append_date Дата и время создания документа в SQL формате.
change_user_id Идентификатор пользователя из справочника RefUser, который внес последние изменения в документ.
change_date Дата и время последнего изменения документа в SQL формате.
responsible_user_id Идентификатор пользователя из справочника RefUser, который является ответственным за документ. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором текущего авторизованного пользователя.
document_basis_id Идентификатор документа основания.
document_basis_type_id Тип документа основания. Возможные значения: (Отсутствуют).
sum Сумма документа.
comment Поле с произвольным текстом.
products.product_id Идентификатор товара из справочника RefNomenclature.
products.sku_id Идентификатор модификации товара из справочника RefSku. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором основной модификации указанного товара.
products.unit_id Идентификатор единицы измерения товара из справочника RefUnit. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором базовой единицы измерения указанного товара.
products.factor Коэффициент - кол-во базовых единиц измерения номенклатуры в текущей единице измерения. При создании, в случае отсутствия в переданных данных будет заполнен коэффициентом указанной единицы измерения.
products.quantity Количество заказанного товара.
products.price Цена заказанного товара.
products.sum Сумма заказанного товара. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.
products.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
products.vat_sum Сумма НДС заказанного товара. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.
services.service_id Идентификатор услуги из справочника RefNomenclature.
services.sku_id Идентификатор модификации услуги из справочника RefSku. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором основной модификации указанной услуги.
services.unit_id Идентификатор единицы измерения услуги из справочника RefUnit. При создании, в случае отсутствия в переданных данных будет заполнен идентификатором базовой единицы измерения указанной услуги.
services.factor Коэффициент - кол-во базовых единиц измерения номенклатуры в текущей единице измерения. При создании, в случае отсутствия в переданных данных будет заполнен коэффициентом указанной единицы измерения.
services.quantity Количество заказанных услуг.
services.price Цена заказанной услуги.
services.sum Сумма заказанных услуг. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.
services.vat_rate_id Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.
services.vat_sum Сумма НДС заказанных услуг. При создании, в случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.
services.execution_address_id Идентификатор адреса из справочника RefAddress, по которому будет оказана услуга. Например, адрес доставки.
services.execution_date_time Планируемая дата и время оказания услуги в SQL формате.
Источник — «http://wiki.mrdoc.org/index.php?title=Описание_объектов_API&oldid=281»