.. _ainv_req:

Требования к передаваемым документам
====================================

.. important:: Для возможности проводки входящего формализованного документа
    (неформализованный документ провести нельзя) в его дополнительных данных 
    должна быть передана информация о заказе на поставку, предварительно 
    созданном в SAP-системе.

Данные, которые должны быть переданы с формализованным документом:

* **Номер заказа**;

* **Номера материалов**.

.. note:: Номера материалов должны быть переданы контрагентом в номенклатуре системы SAP. 


Передача номера заказа и кодов материала
----------------------------------------

Номер заказа и номер материала должны быть переданы контрагентом в качестве дополнительных данных 
к входящему документу. Дополнительные данные должны быть переданы в специализированных разделах 
xml-файла формализованного документа (инфополях). 

* Номер заказа должен быть передан как дополнительные данные к заголовку документа 
  в разделе ``ИнфПолФХЖ1`` под тегом ``order_num``.

* Номер материала должен быть передан как дополнительные данные к позиции 
  в разделе ``ИнфПолФХЖ2`` под тегом ``item_num``.

  .. note:: Передача номеров материалов не является обязательной. В случае если
            номера материалов не были переданы, функционал автофактурирования предусматривает
            ручное сопоставление позиций электронного документа с материалами учетной системы SAP.

.. attention:: Указанные в тегах ``ИнфПолФХЖ1`` и ``ИнфПолФХЖ2`` - 
             ``order_num`` и ``item_num`` **являются регистрозависимыми и**
             **должны быть переданы в нижнем регистре**.


.. _ainv_positions:

Сопоставление позиций электронного документа и документа SAP
------------------------------------------------------------

Если номер материала был передан в дополнительных данных к позиции электронного документа,
то позиция документа будет сопоставлена с соответствующей позицией документа закупки.

Если номер материала не был передан в дополнительных данных к позиции электронного документа,
то функционал автофактурирования выполнит поиск в настроечной таблице ``/TRL/XDE_ITM_MAP``.

.. note:: Для ведения таблицы ``/TRL/XDE_ITM_MAP`` в транзакции ``SM30``
          предусмотрен ракурс ведения ``/TRL/XDE_V_IT_MP``.


Сопоставление позиций производится по следующим значениям, 
которые могут присутствовать в электронном документе
(указаны в порядке приоритета):

#. **Код материала SAP**
    Код, присвоенный материалу системой SAP в ОЗМ.
    В xml-документе должен находиться в разделе ``ИнфПолФХЖ2`` под тегом ``item_num``.
    
    .. note:: Данный способ сопоставления не использует настроечную таблицу для сопоставления и является
              предпочтительным для использования.

#. **Код материала контрагента**
    Код, который контрагент использует для обозначения материала.
    В xml-документе должен находиться в разделе ``КодТов``.

#. **Артикул материала контрагента**
    Артикул, который контрагент использует для обозначения материала.
    В xml-документе должен находиться в разделе ``АртикулТов``.

#. **Текст материала контрагента**
    Текст, который контрагент использует для обозначения материала.
    В xml-документе должен находиться в разделе ``НаимТов``.

    .. warning:: Текст материала хранится и ведется в настроечной таблице ``/TRL/XDE_ITM_MAP``
                 в **верхнем регистре**. ``НаимТов`` в электронном документе также приводится к верхнему регистру
                 перед проверкой.

.. note:: Сопоставление позиций считается успешным, 
          если хотя бы по одному из пунктов выше было найдено соответствие.

.. _ainv_itm_map:

Ведение таблицы сопоставления позиций
-------------------------------------

Ведение таблицы ``/TRL/XDE_ITM_MAP`` производится в транзакции ``SM30`` через
ракурс ведения ``/TRL/XDE_V_IT_MP``.

.. list-table:: Поля ведения /TRL/XDE_ITM_MAP
   :widths: auto
   :header-rows: 1

   * - Имя поля
     - Ключ
     - Описание
   * - MATNR
     - X
     - Код, присвоенный материалу системой SAP в ОЗМ
   * - LIFNR
     - X
     - Код, присвоенный кредитору в системе SAP в ОЗК
   * - KMATN
     - 
     - Код, который контрагент использует для обозначения материала
   * - KMAKT
     - 
     - Текст, который контрагент использует для обозначения материала
   * - VCODE
     - 
     - Артикул, который контрагент использует для обозначения материала

.. note:: Материалы SAP ведутся в таблице в разрезе кредитора, что позволяет задать сопоставления
          материалов поставщиков, различные для каждого кредитора.

Ниже приведен пример заполнения.

.. image:: media/ainv3.png
   :scale: 56
   :align: center