2.1.4.2. Файл card.xml
 
Каждый документ в ТКТ должен сопровождаться описанием в виде файла card.xml. Главное назначение этого файла - предоставить информацию о типе документа, его отправителе и получателе.
XSD схему для card.xml можно скачать по ссылке:
https://invoice-old.taxcom.ru/Options/DownloadApplication.ashx?appName=SchemasB2BContainer
Файл Card.xml включает в себя:
•
ID документа в системе Такском-Доклайнз (InternalId) - не требует заполнения, автоматически заполняется при отправке.
•
ID документа в ERP или учётной системе (ExternalIdentifier) - необязательный параметр. Этот идентификатор помогает связать документ с конкретным документооборотом.
•
Type - см. таблицы ниже.
•
Признак "необходима подпись второй стороны" (ResignRequired), позволяющий отличить односторонний документ от двухстороннего, см. п. 2.1.3. Регламенты ЭДО, транзакции и документообороты.
•
Идентификаторы и ИНН/КПП (Abonent Id и INN) Отправителя (Sender) и Получателя (Recipient).
•
Блок Description,  который не является обязательным и содержит необязательные атрибуты:
o
Атрибут Title – заголовок неформализованного документа или тема письма в формате текстовой строки неограниченной длины. В случае ошибки, например, ошибки подписи (некорректная цифровая подпись), в поле Title блока Description может быть записано слово  “Ошибка”, а в поле Comment этого же блока Description – описание ошибки.
o
Атрибут Comment – текст сопроводительного письма или пояснения к неформализованному документу в формате текстовой строки неограниченной длины.
o
Атрибут Date – дата документа в формате ГГГГ-ММ-ДД, например, 2015-08-27. После отправки формализованного документа этот параметр автоматически получит значение даты отправляемого документа, извлеченное из файла документа, с нулевым значением времени, например, 2015-08-27 00:00:00. Для неформализованного документа в системе Такском-Файлер значение параметра Date записывается без значения времени, например, 2015-08-27. Нарушение указанного формата даты при попытке отправки неформализованного документа приводит к ошибке.
o
Блок данных AdditionalData, который необходим для:
1. Уточнения типа неформализованного сообщения.
2. Передачи дополнительной информации при отправке с любым типом сообщения
Для формализованных сообщений наличие данного блока не является обязательным.
Если блок AdditionalData присутствует, то он должен содержать не менее одного вложенного атрибута.
Параметр DocumentType блока данных AdditionalData - это параметр, определяющий тип документа, он обязателен только в случае использования значения Other атрибута Name тега Type.
Система позволяет обойтись без использования параметра DocumentType (за счёт использования параметра Name тега Type). Использование параметра DocumentType не рекомендуется, но поддерживается для обеспечения совместимости с ранними версиями ПО.
В случае противоречия в значениях атрибутов Name тега Type и DocumentType блока данных AdditionalData тип документа определяет значение DocumentType блока данных AdditionalData.
Необязательные параметры блока данных AdditionalData, используемые в пользовательском интерфейсе системы Такском-Файлер:
  • LinkedDocument - docflowId документа, отправлявшегося ранее через систему Доклайнз и имеющего связь с данным.
  •  WarrantPath - необязательный параметр, в значении которого передается путь до файла описателя МЧД warrant.xml.
  •  WarrantMetaID – необязательный параметр, в значении которого передается регистрационный номер МЧД (36 символов), привязанной к сотруднику в системе «Такском-Доклайнз» или «Такском-Файлер». В случае его указания структуру warrant.xml  и  файл МЧД в контейнере указывать не требуется.
 
Данные отправителя документа или контактного лица, к которому следует обратиться, если есть вопросы по данному документу:
▪
DealNumber - номер сделки в формате текстовой строки длиной до 255 символов.
▪
SenderDepartment - данные о подразделении или должности в формате текстовой строки.
▪
SenderFullName - Ф.И.О. в формате текстовой строки.
▪
SenderContact - любая контактная информация: адрес электронной почты, номер телефона, ... в формате текстовой строки.
 
Данные адресата документа или иного лица организации получателя, к которому следует обратиться, если есть вопросы по данному документу, которые могут быть использованы для автоматической маршрутизации на стороне получателя документа:
▪
ReceiverDepartment - данные о подразделении или должности в формате текстовой строки.
▪
ReceiverFullName - Ф.И.О. в формате текстовой строки.
▪
ReceiverContact - любая контактная информация: адрес электронной почты, номер телефона, ... в формате текстовой строки.
Данные документа, который описывает файл Card.xml, в том же формате, в котором они присутствуют в этом документе, за исключением дат:
▪
Сумма документа, который описывает данный файл card.xml.
▪
Номер документа, который описывает данный файл card.xml.
▪
ДатаСчФ - дата счёта-фактуры в формате ГГГГ-ММ-ДД.
▪
НомИспрСчФ - номер исправления счёта-фактуры в формате строки.
▪
ДатаИспрСчФ - дата исправления счёта-фактуры в формате  ГГГГ-ММ-ДД.
▪
НомКСФ - номер корректировочного счёта-фактуры.
▪
ДатаКСФ - дата корректировочного счёта-фактуры в формате ГГГГ-ММ-ДД.
▪
НомИспрКСФ - номер исправления корректировочного счёта-фактуры.
▪
ДатаИспрКСФ - дата исправления корректировочного счёта-фактуры в формате ГГГГ-ММ-ДД.
▪
НомИспрСФ - номер исправления счёта-фактуры.
▪
ДатаИспрСФ - дата исправления счёта-фактуры в формате ГГГГ-ММ-ДД.
Эти данные, если их значения не являются пустыми, автоматически извлекаются из документа и записываются в блок AdditionalData после отправки документа.
Для того, чтобы в черновике документа поля "Номер" и "Дата" могли быть отредактированы получателем, отправителю необходимо в card.xml в теге <AdditionalData> оставить пустыми поля  их значений. Пример:
Для удобства определения, что в документообороте использовалась МЧД, карточка, описывающая документ (Card.xml), может содержать необязательный параметр WarrantPath, в значении которого передается путь до файла описателя МЧД warrant.xml.  
 
Использование перечисленных выше параметров в иной интерпретации может привести к ошибкам.
Атрибут Name из тега Type может принимать значения из приведенной таблицы в зависимости от кода транзакции в файле meta.xml и типа документа:
Тип документа или служебного сообщения
Код транзакции (TransactionCode)
Значение атрибута Name тега Type
Счёт-фактура, исправительный счёт-фактура (устаревший тип)
Invoice
Invoice
Корректировочный счёт-фактура (устаревший тип)
Invoice
CorrectiveInvoice
Счет-фактура, применяемый при расчетах на добавленную стоимость (документ с функцией «СЧФ».)
Invoice
ExpInvoice
Счет-фактура и документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг). Информация продавца. (Документ с функцией «СЧФДОП».)
Invoice
ExpInvoiceAndPrimary
AccountingDocumentVendor
Счет-фактура и документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг). Информация покупателя.  (Документ с функцией «СЧФДОП».)
CustomerInformation
ExpInvoiceAndPrimary
AccountingDocumentCustomer
Документ об отгрузке товаров (выполнении работ), передаче имущественных прав (документ об оказании услуг). Информация продавца. (Документ с функцией «ДОП».)
Invoice
PrimaryAccounting
DocumentVendor
Документ об отгрузке товаров (выполнении работ). (Документ с функцией «ДОП», информация покупателя.)
CustomerInformation
PrimaryAccounting
DocumentCustomer
Корректировочный счет-фактура применяемый при расчетах по налогу на добавленную стоимость. (Документ с функцией «КССЧФ».)
Invoice
CorExpInvoice
Корректировочный счет-фактура и документ об изменении стоимости. Информация продавца. (Документ с функцией «КСЧФДИС».)
Invoice
CorExpInvoiceAndPrimary
AccountingDocumentVendor
Корректировочный счет-фактура и документ об изменении стоимости. Информация покупателя. (Документ с функцией «КСЧФДИС».)
CustomerInformation
CorExpInvoiceAndPrimary
AccountingDocumentCustomer
Документ об изменении стоимости. Информация продавца. (Документ с функцией «ДИС».)
Invoice
CorPrimaryAccountingDocumentVendor
Документ об изменении стоимости. Информация покупателя. (Документ с функцией «ДИС».)
CustomerInformation
CorPrimaryAccountingDocumentCustomer
Акт о выполнении работ (оказании услуг) – титул продавца
VendorTitle
FormalizedStatementVendor
Акт о выполнении работ (оказании услуг) – титул покупателя
CustomerTitle
FormalizedStatementCustomer
Документ о передаче результатов работ - титул исполнителя
VendorTitle
FormalizedWorkResultVendor
Документ о передаче результатов работ - титул заказчика
CustomerTitle
FormalizedWorkResultCustomer
Товарная накладная (ТОРГ-12) – титул продавца
VendorTitle
FormalizedConsignmentVendor
Товарная накладная (ТОРГ-12) – титул покупателя
CustomerTitle
FormalizedConsignmentCustomer
Документ о передаче товаров при торговых операциях - титул продавца
VendorTitle
FormalizedTradingVendor
Документ о передаче товаров при торговых операциях - титул покупателя
CustomerTitle
FormalizedTradingCustomer
Акт сверки взаимных расчетов (информация отправителя)
VendorTitle
FormalizedReconciliationActSender
 
Акт сверки взаимных расчетов (информация получателя)
CustomerTitle
FormalizedReconciliationActReceiver
 
Акт о приемке выполненных работ (информация подрядчика)
VendorTitle
FormalizedKC2Contractor
 
Акт о приемке выполненных работ (информация заказчика)
CustomerTitle
FormalizedKC2Customer
 
Транспортная накладная (информация грузоотправителя)
 EPDDocument
 T1_TRNACLGROT
Транспортная накладная (информация перевозчика, принявшего груз)
 EPDDocument
T2_TRNACLPPRIN
Транспортная накладная (информация грузополучателя)
 EPDDocument
T3_TRNACLGRPO
Транспортная накладная (информация перевозчика, выдавшего груз грузополучателю)
 EPDDocument
T4_TRNACLPVYN
Транспортная накладная (информация перевозчика об изменении финансового состояния в результате перевозки)
 EPDDocument
T5_TRNPUDPER
Транспортная накладная (информация грузоотправителя о согласии со стоимостью услуг перевозки)
 EPDDocument
T6_TRNPUDGO
Транспортная накладная (информация о переадресовке)
 EPDDocument
T7_TRNPEREADR
Транспортная накладная (информация о заменах водителя (водителей) и (или) транспортного средства)
 EPDDocument
T8_TRNZAMEN
Товарная накладная
MainDocument
Consignment
Счёт
MainDocument
Account
Платёжное поручение
MainDocument
PaymentOrder
Договор, соглашение
MainDocument
Contract
Акт
MainDocument
Statement
Приложение к акту
MainDocument
StatementAppendix
Гарантийное письмо
MainDocument
GuaranteeLetter
Другие типы документов
MainDocument
ReconciliationStatement;
 OffsettingStatement;
Ks11;
Ks2;
Ks3;
Report;
Notification;
Sheet;
 EdoAgreement;
Registry;
 InvoiceForPayment;
Other
Specification
AdditionalAgreement
Подтверждение (служебное сообщение)
PostDateConfirmation, SendConfirmation, ReceiveNoticePostDateConfirmation, CustomerInformationPostDateConfirmation
SendingTimeConfirmation
Извещение (служебное сообщение)
PostDateConfirmationReceiveNotice, SendConfirmationReceiveNotice, ReceiveNotice, ReceiveNoticePostDateConfirmationReceiveNotice,  CorrectionNoticeReceiveNotice,
CustomerInformationPostDateConfirmationReceiveNotice, CustomerTitleReceiveNotice
ReceiveNotification
CorrectionNotice
SpecificationNotice
Уведомление об уточнении.(служебное сообщение)
MainDocumentReject
SpecificationNotice
Предложение об аннулировании (служебное сообщение)
CancellationOffer
CancellationOffer
Подтверждении аннулирования (служебное сообщение)
CancellationOfferResign
SpecificationNotice
Отклонение аннулирования (служебное сообщение)
CancellationOfferReject
SpecificationNotice
Квитанция о приеме от системы ИС МП (служебное сообщение)
TracingAccepted
TracingAccepted
Уведомление об ошибке от системы ИС МП (служебное сообщение)
TracingRejected
TracingRejected
Квитанция о положительной проверке МОД от системы ИС МТ (служебное сообщение).
TracingAcceptedMod
TracingAcceptedMod
Уведомление об ошибке при проверке МОД  от системы ИС МТ (служебное сообщение).
TracingRejectedMod
TracingRejectedMod
Квитанция о приеме Предложения об аннулировании от ИС МП.(служебное сообщение)
TracingCancellationAccepted
TracingCancellationAccepted
Уведомление об ошибке Предложения об аннулировании от ИС МП(служебное сообщение)
TracingCancellationRejected
TracingCancellationRejected
 
Атрибут DocumentType из тега AdditionalData для неформализованных сообщений типа Other уточняет значение типа сообщения, указанное атрибутом Name тега Type, ниже в таблице  приведены его допустимые значения.
Значение атрибута DocumentType тега AdditionalData играет главную роль при определении типа документа в случае, если вместе со значением этого атрибута для документа указано значение атрибута Name тега Type.
Использование DocumentType было необходимо в предыдущей версии системы, когда список значений параметра Name тега Type был меньше. Теперь список значений параметра Name тега Type расширен таким образом, что можно обойтись без использования DocumentType, что и рекомендуется.
Значение атрибута Name тега Type
Значение атрибута DocumentType тега AdditionalData
Тип документа
Other
ReconciliationStatement
Акт сверки
OffsettingStatement
Акт взаимозачета
Ks11
КС-11
Ks2
КС-2
Ks3
КС-3
Report
Отчет
Notification
Уведомление
Sheet
Ведомость
EdoAgreement
Соглашение об ЭДО
Registry
Реестр для факторинга (создание в Такском-Файлере путём  заполнения электронного бланка не предусмотрено)
InvoiceForPayment
Счет на оплату (создание в Такском-Файлере путём  заполнения электронного бланка не предусмотрено)
Other
Письмо
Specification
Спецификация
AdditionalAgreement
Дополнительное соглашение
AgentReport
Отчет агента
Invoice
Invoice
Счёт-фактура, исправительный счёт-фактура
CorrectiveInvoice
CorrectiveInvoice
Корректировочный счёт-фактура
Statement
Statement
Акт
FormalizedStatementVendor
FormalizedStatementVendor
Акт о выполнении работ (оказании услуг) – титул продавца
FormalizedStatementCustomer
FormalizedStatementCustomer
Акт о выполнении работ (оказании услуг) – титул покупателя
FormalizedConsignmentVendor
FormalizedConsignmentVendor
Товарная накладная (ТОРГ-12) – титул продавца
FormalizedConsignmentCustomer
FormalizedConsignmentCustomer
Товарная накладная (ТОРГ-12) – титул покупателя
FormalizedWorkResultVendor
FormalizedWorkResultVendor
Документ о передаче результатов работ - титул исполнителя
FormalizedWorkResultCustomer
FormalizedWorkResultCustomer
Документ о передаче результатов работ - титул заказчика
FormalizedTradingVendor
FormalizedTradingVendor
Документ о передаче товаров при торговых операциях - титул продавца
FormalizedTradingCustomer
FormalizedTradingCustomer
Документ о передаче товаров при торговых операциях - титул покупателя
FormalizedReconciliationActSender
FormalizedReconciliationActSender
Акт сверки взаимных расчетов (информация отправителя)
FormalizedReconciliationActReceiver
FormalizedReconciliationActReceiver
Акт сверки взаимных расчетов (информация получателя)
FormalizedKC2Contractor
FormalizedKC2Contractor
Акт о приемке выполненных работ (информация подрядчика)
FormalizedKC2Customer
FormalizedKC2Customer
Акт о приемке выполненных работ (информация заказчика)
Consignment
Consignment
Товарная накладная
Account
Account
Счёт
PaymentOrder
PaymentOrder
Платёжное поручение
Contract
Contract
Договор, соглашение
GuaranteeLetter
GuaranteeLetter
Гарантийное письмо
StatementAppendix
StatementAppendix
Приложение к акту
ExpInvoice
ExpInvoice
Счет-фактура
ExpInvoiceAndPrimary
AccountingDocumentVendor
ExpInvoiceAndPrimaryAccounting
DocumentVendor
Счет-фактура и отгрузка товаров. Титул продавца.
ExpInvoiceAndPrimary
AccountingDocumentCustomer
ExpInvoiceAndPrimaryAccounting
DocumentCustomer
Счет-фактура и отгрузка товаров. Титул покупателя.
PrimaryAccounting
DocumentVendor
PrimaryAccountingDocumentVendor
Отгрузка товаров (оказание услуг). Титул продавца.
PrimaryAccounting
DocumentCustomer
PrimaryAccountingDocumentCustomer
Отгрузка товаров (оказание услуг). Титул покупателя.
CorExpInvoice
CorExpInvoice
Корректировочный счет-фактура
CorExpInvoiceAndPrimary
AccountingDocumentVendor
CorExpInvoiceAndPrimary
AccountingDocumentVendor
Корректировочный счет-фактура и изменение стоимости. Титул продавца.
CorExpInvoiceAndPrimary
AccountingDocumentCustomer
CorExpInvoiceAndPrimary
AccountingDocumentCustomer
Корректировочный счет-фактура и изменение стоимости. Титул покупателя.
CorPrimaryAccounting
DocumentVendor
CorPrimaryAccountingDocumentVendor
Изменение стоимости. Титул продавца.
CorPrimaryAccounting
DocumentCustomer
CorPrimaryAccountingDocumentCustomer
Изменение стоимости. Титул покупателя.
 
Значение атрибута Name тега Type
Значение атрибута DocumentType тега AdditionalData
Тип документа согласно РОСЭУ версии 1.1.4
PrimaryAccounting
DocumentVendor
PrimaryAccountingDocumentVendor
ДОППродавец
PrimaryAccountingDocumentVendorConsignment
ДОППродавецНакладная
PrimaryAccountingDocumentVendorWorkResult
ДОППродавецАкт
PrimaryAccounting
DocumentCustomer
PrimaryAccountingDocumentCustomer
ДОППокупатель
PrimaryAccountingDocumentCustomerConsignment
ДОППокупательНакладная
PrimaryAccountingDocumentCustomerWorkResult
ДОППокупательАкт
CorPrimaryAccounting
DocumentVendor
CorPrimaryAccountingDocumentVendor
КорДИСПродавец
CorPrimaryAccountingDocumentVendorConsignment
КорДИСПродавецНакладная
CorPrimaryAccountingDocumentVendorWorkResult
КорДИСПродавецАкт
CorPrimaryAccounting
DocumentCustomer
CorPrimaryAccountingDocumentCustomer
КорДИСПокупатель
CorPrimaryAccountingDocumentCustomerConsignment
КорДИСПокупательНакладная
CorPrimaryAccountingDocumentCustomerWorkResult
КорДИСПокупательАкт
 
Файл card.xml должен содержать:
  •  
В качестве первой строки:  <?xml version="1.0" encoding = "windows-1251"?>
  •  
“Xmlns: http://api-invoice.taxcom.ru/card”
 
Примеры использования файла Card.xml для передачи дополнительных параметров:
Пример 1. Использование файла Card.xml для передачи основных атрибутов счёта-фактуры и связи этого счёта-фактуры с другим документом
<?xml version="1.0" encoding="windows-1251" ?>
<Card xmlns="http://api-invoice.taxcom.ru/card">
<Identifiers InternalId="888db2fa-d4d9-4283-8e59-077ced9ef353" />
<Type Name="Invoice" ResignRequired="false" />
<Description Title="" Date="2013-05-23 00:00:00">
   <AdditionalData>
<AdditionalParameter Name="DocumentType" Value="Invoice"/>
<AdditionalParameter Name="DealNumber" Value="115БН/11.15" />
       <AdditionalParameter Name="Сумма" Value="1000.00" />
       <AdditionalParameter Name="Номер" Value="1233" />
       <AdditionalParameter Name="ДатаСчФ" Value="2013-05-23" />
       <AdditionalParameter Name="НомИспрСчФ" Value="" />
       <AdditionalParameter Name="ДатаИспрСчФ" Value="" />
      <AdditionalParameter Name="LinkedDocument" Value="540b0bc0-098d-4208-8754-6319aa423122" />
   </AdditionalData>
</Description>
<Sender>
   <Abonent Id="2AL-072439A8-4900-436A-920A-0583E0803F20-00000" Name=""ООО Защита"" Inn="6315629971" Kpp="213201001" />
</Sender>
<Receiver>
   <Abonent Id="2AL-93C4DFF6-FE2C-4075-B4FC-5B4C5519D529-00000" Name="ОАО Тульские пряники" Inn="6312012764" />
</Receiver>
</Card>
Пример 2. Использование файла Card.xml для передачи информации об отправителе и получателе
<?xml version="1.0" encoding="windows-1251"?>
<Card xmlns="http://api-invoice.taxcom.ru/card">
 <Identifiers InternalId="fe2bee40-7ab0-43b7-96b6-d07d3f402a30" />
 <Type Name="Invoice" ResignRequired="false" />
 <Description Title="" Date="2015-09-24 00:00:00">
  <AdditionalData>
<AdditionalParameter Name="DocumentType" Value="Invoice"/>
     <AdditionalParameter Name="Сумма" Value="1220" />
     <AdditionalParameter Name="Номер" Value="0025" />
     <AdditionalParameter Name="ДатаСчФ" Value="2015-09-24" />
     <AdditionalParameter Name="НомИспрСчФ" Value="" />
     <AdditionalParameter Name="ДатаИспрСчФ" Value="" />
     <AdditionalParameter Name="SenderDepartment" Value="бухгалтерия" />
     <AdditionalParameter Name="SenderFullName" Value="Иванов Иван Иванович" />
     <AdditionalParameter Name="SenderContact" Value="тел. 495-122-33-44" />
     <AdditionalParameter Name="ReceiverDepartment" Value="склад" />
     <AdditionalParameter Name="ReceiverFullName" Value="Петров Петр Петрович" />
     <AdditionalParameter Name="ReceiverContact" Value="PetrovPP@mail.ru" />
   </AdditionalData>
 </Description>
 <Sender>
   <Abonent Id="2AL-FAC981E9-3DF2-4F23-8099-328E4D1F7FCA-00000" Name="ФГУП &quot;КожСетьПроект&quot;" Inn="7702306803" Kpp="770201001" />
 </Sender>
 <Receiver>
   <Abonent Id="2AL-6E43FCA3-0BF6-46E9-8897-87BE9CEE84DD-00000" Name="НИПИ &quot;ГосПупперРег&quot;" Inn="3444868570" Kpp="344401001" ContractNumber="123 тестовый" />
 </Receiver>
</Card>