Поиск отправок по заданным критериям
====================================

.. code:: abap

    *"--------------------------------------------------------------------
    *"*"Локальный интерфейс:
    *"  IMPORTING
    *"     REFERENCE(IR_DIRECTION) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_RECORD_ID) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_SAP_OBJECT) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_OBJECT_ID) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_SAP_DOC_TYPE) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_CR_DATE) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_INV_NUMBER) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_INV_DATE) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_STATE) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_ID_OED) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_KUNNR) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_LIFNR) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"     REFERENCE(IR_INV_COR_NUM) TYPE  /TRL/XDE_T_RANGE OPTIONAL
    *"  EXPORTING
    *"     REFERENCE(ET_SHIPMENT_DATA) TYPE  /TRL/XDE_T_SHIPMENT_DATA
    *"  TABLES
    *"      ET_META_DATA STRUCTURE  /TRL/XDE_METDAT OPTIONAL
    *"  EXCEPTIONS
    *"      SELECTION_CRITERIA_NOT_SET
    *"      INVALID_PARAMETERS
    *"--------------------------------------------------------------------

Функциональный модуль ``/TRL/XDE_API_SEARCH_SHIPMENTS`` осуществляет поиск отправок по критериям, заданным во входных параметрах.

.. table:: Описание интерфейса функционального модуля ``/TRL/XDE_API_SEARCH_SHIPMENTS``
   :align: center
   :widths: 5 8
    
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | Параметр                           | Описание                                                                                              |
   +====================================+=======================================================================================================+
   | ``IMPORTING``                                                                                                                              |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_DIRECTION``                   | Диапазон направлений.                                                                                 |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_RECORD_ID``                   | Диапазон записей.                                                                                     |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_SAP_OBJECT``                  | Диапазон типов бизнес-объектов.                                                                       |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_OBJECT_ID``                   | Диапазон ключей бизнес-объектов.                                                                      |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_SAP_DOC_TYPE``                | Диапазон видов документов.                                                                            |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_CR_DATE``                     | Диапазон дат создания.                                                                                |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_INV_NUMBER``                  | Диапазон счетов-фактур (только для фактуры).                                                          |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_INV_DATE``                    | Диапазон дат счетов (только для фактуры).                                                             |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_STATE``                       | Диапазон состояний отправки.                                                                          |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_ID_OED``                      | Диапазон ID операторов.                                                                               |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_KUNNR``                       | Диапазон получателей.                                                                                 |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_LIFNR``                       | Диапазон отправителей.                                                                                |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``IR_INV_COR_NUM``                 | Диапазон  корректировочных счетов (только для фактуры).                                               |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``EXPORTING``                                                                                                                              |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``ET_SHIPMENT_DATA``               | Данные отправок.                                                                                      |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``TABLES``                                                                                                                                 |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``ET_META_DATA``                   | Метаданные.                                                                                           |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``EXCEPTIONS``                                                                                                                             |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``SELECTION_CRITERIA_NOT_SET``     | Не заполнены критерии поиска.                                                                         |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+
   | ``INVALID_PARAMETERS``             | Неверно указаны параметры поиска.                                                                     |
   +------------------------------------+-------------------------------------------------------------------------------------------------------+

Необходимо, чтобы хотя бы один из входных параметров был заполнен.

Если ни один из параметров не заполнен, будет вызвана особая ситуация ``SELECTION_CRITERIA_NOT_SET`` и работа ФМ закончится.

Выполняется выборка из таблицы ``/TRL/XDE_HEADER``, объединенной с таблицей ``/TRL/XDE_HDR_ATR``, по номеру GUID отправления. 
Если данные не будут найдены, работа ФМ закончится без ошибок.

Из выбранных данных удаляются те, для которых заполнен номер документа и этот документ отсутствует во входящем диапазоне счетов-фактур, 
либо те, для которых заполнена дата документа и эта дата отсутствует во входящем диапазоне дат счетов.

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