.. _ainv_manual:

Запуск и работа с функционалом автофактурирования
=================================================

.. note:: Основным условием для запуска автофактурирования является
          переданный контрагентом номер заказа в номенклатуре SAP
          во входящем документе ``/TRL/XDE_INBOX``.
          Подробнее см. раздел :ref:`ainv_req`.

Доступ к функционалу автофактурирования находится на панели кнопок
журнала входящих документов ``/TRL/XDE_INBOX``.

.. image:: media/ainv1.png
   :scale: 100
   :align: center

Просмотреть подробные данные об автофактурировании, а также создать входящий счет-фактуру для единичного документа 
можно, используя соответствующую вкладку карточки документа журнала входящих документов. 

Успешное прохождение всех шагов автоматического фактурирования в логах
выглядит следующим образом.

.. image:: media/ainv7.png
   :scale: 87
   :align: center

Статусы автоматического фактурирования
--------------------------------------

Статусы отображаются в журнале входящих документов ``/TRL/XDE_INBOX``
в виде кода статуса и его описания в соответствующих столбцах.

.. image:: media/ainv6.png
   :scale: 100
   :align: center

Код статуса также доступен в карточке отправки на вкладке ``Автоматическое фактурирование``.

.. list-table:: Статусы автофактурирования
   :widths: auto
   :header-rows: 1

   * - Код статуса
     - Описание
   * - |-|
     - Автофактурирование не проводилось
   * - IS
     - Входящий счет создан
   * - ER
     - Ошибка при выполнении автофактурирования
   * - NA
     - Автофактурирование невозможно

.. important:: Автофактурирование невозможно выполнить для статусов IS, NA.


.. _ainv_manual_card:

Автофактурирование единичного документа
---------------------------------------

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

.. image:: media/ainv2.png
   :scale: 80
   :align: center

Изменение номера заказа
~~~~~~~~~~~~~~~~~~~~~~~

Поле ``Документ закупки`` доступно для изменения,
что подразумевает возможность ввода номера заказа, отличного
от переданного в теге ``order_num`` с входящим документом (присутствует средство поиска).

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

Привязка позиций
~~~~~~~~~~~~~~~~

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

.. attention:: Кнопка ``Привязать`` в таблице доступна только для позиций:
               
               * для которых не было найдено однозначное соответствие по таблице ``/TRL/XDE_ITM_MAP``;
               * для которых не был передан номер материала в номенклатуре SAP.
               
               Подробнее: :ref:`ainv_positions`

При нажатии кнопки появится список найденных позиций в электронном документе,
а также позиция отмены сопоставления.

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

Тестовый запуск
~~~~~~~~~~~~~~~

Если чекбокс |test_run| установлен, то при нажатии кнопки |create_inv|
вызов BAPI ``BAPI_GOODSMVT_CREATE`` (при необходимости проводки поступления материала)
будет выполнен в тестовом режиме без создания документа материала.

BAPI ``BAPI_INCOMINGINVOICE_CREATE`` для создания входящего счета также не будет вызван.

Таким образом, имеется возможность проверить сбор данных и 
выполнить проверки попозиционно (см. :ref:`ainv_checks`).

В логах будут записаны сообщения о тестовом запуске функционала и результатах проверок.

Мэппинг позиций
~~~~~~~~~~~~~~~

Если чекбокс |save_map| установлен, а среди позиций документа были те, по
которым было выполнено сопоставление позиций вручную (см. :ref:`ainv_positions`), 
то при запуске функционала кнопкой |create_inv| данные из входящего документа
для позиций, по которым было выполнено ручное соответствие, будут сохранены для
дальнейшего использования в настроечную таблицу ``/TRL/XDE_ITM_MAP``
(см. :ref:`ainv_itm_map`).

.. attention:: Данные по позиции будут сохранены в таблицу в разрезе отправителя электронного
               документа.

               При этом значения по позиции будут взяты из соответствующих тегов документа, при
               их наличии:

               * ``КодТов``
               * ``АртикулТов``
               * ``НаимТов``

История поступления материала
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Для просмотра истории поступления материала
для соответствующего закза на поставку 
на панели ALV автоматического фактурирования
предусмотрена кнопка |hist_pm|.

.. image:: media/ainv4.png
   :scale: 72
   :align: center

.. note:: Весь функционал окна истории поступления материала аналогичен функционалу
          соответствующей вкладки транзакции ``ME23N``.

Логирование событий
~~~~~~~~~~~~~~~~~~~

Функционалом предусмотрено два вида отображения
истории действий:

* |local_log|

    Вся текущая история автофактурирования сохраняется в глобальный лог.
    Окно локально лога появится автоматически при запуске автоматического фактурирования.
    Также окно можно вызвать через соответствующую кнопку на ALV.

    .. image:: media/ainv5.png
       :scale: 90
       :align: center

    .. note:: Локальный лог документа можно просматривать повторно, перемещаясь между документами,
              в рамках одного процесса (т.е. пока не выполнен выход из транзакции ``/TRL/XDE_INBOX``).

* |global_log|

    Отображение всей истории работы автофактурирования за любой период.
    Логи отображаются через стандартные средства.
    Возможен просмотр через транзакцию ``SLG1``.

    .. image:: media/ainv8.png
       :scale: 85
       :align: center


Массовое автофактурирование
---------------------------

Принцип работы функционала массового автофактурирования аналогичен единичному.
Доступ к функционалу автофактурирования находится на панели кнопок
журнала входящих документов ``/TRL/XDE_INBOX``.

.. image:: media/ainv1.png
   :scale: 100
   :align: center

.. attention:: Ограничения, накладываемые на массовое автофактурирование:
                
                * **Нет возможности изменить номер заказа.**
                * **Для всех позиций должно быть найдено однозначное соответствие.**        
                * **При возникновении ошибок по одному документу автофактурирование прерывается.**

                Подробнее о проверках и причинах приостановки автофактурирования см. 
                :ref:`ainv_checks`.



.. |save_map| image:: media/ainv9.png
   :width: 181
   :height: 21

.. |test_run| image:: media/ainv10.png
   :width: 121
   :height: 19

.. |hist_pm| image:: media/ainv11.png
   :width: 102
   :height: 28   

.. |local_log| image:: media/ainv12.png
   :width: 128
   :height: 27

.. |global_log| image:: media/ainv13.png
   :width: 145
   :height: 23

.. |create_inv| image:: media/ainv14.png
   :width: 199
   :height: 27

.. |-| unicode:: U+02014 .. длинное тире