• Данные передаются методом Добавление заказов
• Строки заказа формируется в порядке передачи пробирок с биоматериалом
• Рекомендуется передавать локальный код заказа (
  выделен красным цветом
  ), т.к. в этом случае на принимающей стороне не смогут изменить данные заказа - только удалить
• Локальный код заказа должен быть уникальным!
• В локальной программе рекомендуется запретить редактирование и удаление заказа после отправки данных в лабораторию
• Если во время метода Добавление заказов произошла ошибка - метод автоматически аннулирует действия - данные в лабораторию не передаются. Полученную ошибку метода рекомендуется довести до пользователя локальной системы

  POST: /zaks/ins
  {
   payload: {
        arr: [
          {
          zak: {
              cod:      '1051',
              bc:       '0071250922'
          },
          kard: {
              f:        'Иванов',
              i:        'Иван',
              o:        '',
              dr:       '01.01.2000',
              woman: 	0,
              work: 	'',
              email: 	'',
              phone: 	''
          },
          isl: [
               {
                cod:    '3.9.1.',
                nppbio: 2
               }
              ,
               {
                npp:    10
               }
              ,
               {
                npp:    11
               }
         ]
        },
        {
          zak: {
              cod:      '1052',
              bc:       '0071250923'
          },
          kard: {
              f:        'Сидоров',
              i:        'Сидор',
              o:        '',
              dr:       '01.01.2000',
              woman: 	0,
              work: 	'',
              email: 	'',
              phone: 	''
          },
          isl: [
               {
                cod:    '3.9.1.',
                nppbio: 2
               }
              ,
               {
                npp:    10
               }
              ,
               {
                npp:    11
               }
         ]
        }
      ]
  }
            

• Используется метод Список заказов применительно к одному заказу локальной системы
• Если получен статус заказа nppstatus=5 (Выполнен), используем метод Загрузка результатов лабораторных исследований и завершаем работу с заказом в локальной системе.
• У каждого исследования может быть несколько показателей.

  1.Запрос
  POST: /zak/lst
  {
   payload: {
    zak: {
     cod:      '1051'
    }
   }
  }
    Ответ
  {
   err: '',
   path: '/zak/lst',
   data: {
    caption: 'Список заказов',
    rows: [
      {
      npp: 32119,
      cod:      '1051'
      date_input: '24.12.2023 15:50',
      date_done: '25.12.2023 15:50',
      namestatus: 'Выполнен',
      nppstatus: 5
      }
    ]
   }
  }
  2.Загрузка результатов исследований
  POST: /zak/prn
  {
   payload: {
    zak: {
     cod:      '1051'
    }
   }
  }
    Ответ
  {
   err: '',
   path: '/zak/prn',
   data: {
    caption: 'Печать результата заказа',
    nppzak: 32119,
    codzak: '1051',
    header: {...}
   },
   rows: [ [Object], [Object], [Object] ]
   }
  }
            

• Если заказ не найден, то он был удален в лаборатории - это же действие необходимо выполнить в локальной системе!

  1.Запрос
  POST: /zak/lst
  {
   payload: {
    zak: {
     cod:      '1051'
    }
   }
  }
    Ответ
  {
   err: '',
   path: '/zak/lst',
   data: {
    caption: 'Список заказов',
    rows: null
   }
  }
    Удалить данные заказа 1051

    в локальной системе
            

• Информация об интервале дат заведения заказов

• Дата начала интервала.
• Если введена только одна дата date_beg - отчет за один день.
• Если введены даты date_beg и date_end - отчет за интервал.
• Если обе даты пустые или не передано параметров - список всех заказов.

• Дата окончания интервала.

• Код заказа.
• Если указан, то zak.cod игнорируется

• Локальный код заказа.

  {
   payload: {
    zak: {
     npp: 52881,
    }
   }
  }
            

  {
   payload: {
    zak: {
     cod: '1051',
    }
   }
  }
            

  {
   payload: {
    zak: {
     date_beg: '24.12.2023',
     date_end: '30.12.2023'
    }
   }
  }
            

  {
   "payload": {
    "zak": {
     "date_beg": '24.12.2023',
     "date_end": '30.12.2023'
    }
   }
  }
            

  {
   "payload": {}
  }
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Блок возвращаемых данных

• Наименование запроса

• Массив заказов

• Код заказа

• Дата заведения заказа

• Дата завершения заказа

• Статус заказа

• Код статуса заказа
• ОДин код может иметь несколько наименований-уточнений. Например Выполнен, Выполнен (отправлено), Выполнен (не отправлено)

  {
   err: '',
   path: '/zak/lst',
   data: {
    caption: 'Список заказов',
    rows: [
      {
      npp: 32119,
      cod: '',
      date_input: '24.12.2023 15:50',
      date_done: '',
      namestatus: 'Подтвержден',
      nppstatus: 2
      }
    ,
      {
      npp: 32120,
      cod: '',
      date_input: '24.12.2023 15:50',
      date_done: '',
      namestatus: 'Подтвержден',
      nppstatus: 2
      }
    ]
   }
  }
            

  {
   err: '',
   path: '/zak/lst',
   data: {
    caption: 'Список заказов',
    rows: null
   }
  }
            

• Блок параметров нового заказа

• Используемый в локальной информационной системе код заказа.
• Передаваемый код должен быть уникальным.
• Этот код можно использовать в других запросах.
• Рекомендуется передавать для обеспечения уникальности заказов.

• Блок описания пациента

• Фамилия.

• Имя.

• Отчество.

• Дата рождения.

• Пол.
• 1- женщина.
• 0- мужчина.

• Место работв.

• Электронная почта.

• Телефон для связи.

• Блок исследований
• Каждое исследование имеет уникальный числовой код (npp) и символьный код БИ (cod).
• Можно использовать и тот и другой код.
• Если указано оба кода, то будет использован числовой код npp.

• Уникальный числовой код исследования.
• Если передан, то является приоритетным.

• Уникальный символьный код исследования.
• Если передан вместе с числовым кодом, то игнорируется.

• Если у исследования использует несколько биоматериалов, то указание числового кода биоматериала обязательно.
• Смотреть справочник Исследования

  {
    payload:{
      zak: {
       cod: '123-У2023',
      },
      kard: {
       f: 'Иванов',
       i: 'Иван',
       o: 'Иванович',
       dr: '22.01.2000',
       woman: 0,
       work: 'work',
       email: 'email@mail.ru',
       phone: '8908111111'
      },
      isl:[
       {
        cod: '3.9.1.',
        nppbio: 2
       }
      ,
       {
        npp: 10
       }
      ,
       {
        npp: 11
       }
      ]

      }
    }
  }
          

  {
   "payload": {
    "kard": {
     "f":     "Иванов",
     "i":     "Иван",
     "o":     "Иванович",
     "dr":    "22.01.2024",
     "woman": 0,
     "work":  "work",
     "email": "email",
     "phone": "phone"
      },
    "isl": [
     {"npp":  2},
     {"npp":  10},
     {"npp":  11}
    ]
 }
}

            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Блок возвращаемых данных

• Наименование запроса

• Код пациента в картотеке.
• -1 - пустое значение.

• 0 - пациент уже был в картотеке.
• 1 - пациент был добавлен в картотеку.
• -1 - пустое значение.

• Код заказа.
• -1 - пустое значение.

• Кад заказа локальной информационной системы, если был передан.

• Кад статуса.

• Наименование статуса.

• Штрих код заказа.

  {
  err: '',
  path: '/zak/ins',
  data: {
   caption: 'Добавление заказа',
   nppkard: 28137,
   kard_inserted: 0,
   nppzak: 32128,
   codzak: '123-fftr212'
   nppstatus: 2
   namestatus: 'Подтвержден'
   bc: '1000000049199'
   }
  }
            

  {
  err: 'Локальный код заказа (123-fftr212) не уникален, ',
  path: '/zak/ins',
  data: {
   caption: 'Добавление заказа',
   nppkard: -1,
   kard_inserted: -1,
   nppzak: -1,
   codzak: '123-fftr212'
   nppstatus: 0
   namestatus: ''
   bc: ''
   }
  }
            

• Массив строк формата /zak/ins
• Массив данных запишется в базу данных только в случае отсутствия ошибок
• Рекомедуется использовать этот метод, т.к. по завершении запроса формируются данные штатива, штатив готов к передаче в лабораторию для проведения анализов и статус всего списка заказов устанавливатеся на "Исследуется"
• Передавать данные нужно в том порядке, в котором биоматериалы располагаются в штативе

  {
    payload:{
      arr: [
        {
        zak: { cod: 1, bc: '0303134' },
        kard: {
        f: 'ТЕСТ',
        i: 'МАРИНА',
        o: 'ВИКТОРОВНА',
        dr: '01.12.1987',
        woman: 1,
        work: '',
        email: '',
        phone: ''
        },
        isl: [ {"npp":63} ]
        }
      ,
        {
        zak: { cod: 2, bc: '0303135' },
        kard: {
        f: 'ТЕСТ',
        i: 'ИРИНА',
        o: 'ВИКТОРОВНА',
        dr: '01.12.1987',
        woman: 1,
        work: '',
        email: '',
        phone: ''
        },
        isl: [ {"npp":63} ]
        }
      ]
    }
  }
          

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке
• Выходит первая случившаяся ошибка, а не список всех ошибок

• строка запроса

• Блок возвращаемых данных

• Наименование запроса

• строки формата ответа из /zak/ins

 {
  err: '',
  path: '/zaks/ins',
  data: {
    caption: 'Добавление заказов',
    arr: [
      {
      nppkard: 28140,
      kard_inserted: 0,
      nppzak: 32159,
      codzak: '1',
      nppstatus: 2,
      namestatus: 'Подтвержден',
      bc: '1000000032159',
      err: ''
      }
    ,
      {
      nppkard: 28141,
      kard_inserted: 0,
      nppzak: 32160,
      codzak: '2',
      nppstatus: 2,
      namestatus: 'Подтвержден',
      bc: '1000000032160',
      err: ''
      }
    ]
    }
  }
            

  {
    err: 'rest_zaks_ins(Ошибка: XXXXXXXXXXX......',
    path: '/zaks/ins',
    data: { caption: 'Добавление заказов', arr: [] }
  }
            

• Информация об удаляемом заказе

• Код заказа в локальной информационной системе.

• Код заказа
• Если передан - в приоритете

 {
   "payload": {
      "zak": {
         "npp": 32126
      }
   }
 }
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Блок возвращаемых данных

• Наименование запроса

• Удаляемый код заказа

 {
   err: '',
   path: '/zak/del',
   data: {
      caption: 'Удаление заказа',
      nppzak: 32127
   }
 }
             

 {
   err: 'Не найден код заказа (32127)',
   path: '/zak/del',
   data: {
      caption: 'Удаление заказа',
      nppzak: 32127
    }
 }

             

• Информация о заказе

• Код заказа в локальной информационной системе.

• Код заказа
• Если передан - в приоритете

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Блок возвращаемых данных

• Наименование запроса

• Передаваемые поля дублируют структуру документа Результат лабораторных исследования
• Передаются значения всех полей для формирования документа Результат лабораторных исследования
• Дополнительное поле statusnorm может иметь значения: -1 ниже, 0 никакой, 1 норм, 2 выше, 3- ошибка!

  {
   err: '',
   path: '/zak/prn',
   data: {
    caption: 'Печать результата заказа',
    nppzak: 32067,
    codzak: '111',
    header: {
     namekard: 'ИАВНОВ И Б',
     namewoman: 'Мужчина',
     work: '-',
     input: '13.09.2023 18:10',
     done: '14.09.2023 02:34',
     nameorg: 'МЦ "XXXXX"',
     namebio: ' '
   },
   rows: [ [Object], [Object], [Object] ]
   }
  }

  где Object подобен

  {
   nppisl: 61,
   codisl: '20.80.',
   nameisl: 'Сифилис сум. АТ (IgG и IgM) (кач)',
   isl_method: 'Не указано',
   isl_equipment: 'Не указано',
   rem: '',
   rows: [
    {
      npppok: 26,
      namepok: 'Сифилис сум. АТ (IgG и IgM) (кач)',
      res: 'отрицательно',
      statusnorm: 1,  /*1-ok 0-bad*/
      nameed: 'отрицательно/положительно',
      norm: 'отрицательно'
    }
   ]
  }
            

  {
   err: 'Не найден код заказа (320671), ',
   path: '/zak/prn',
   data: {
    caption: 'Печать результата заказа',
    nppzak: 320671,
    codzak: '111',
    header: {
     namekard: null,
     namewoman: null,
     work: null,
     input: null,
     done: null,
     nameorg: null,
     namebio: null
    },
    rows: null
   }
  }
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Информация о запрашиваемом справочнике

• Строки справочника

  {
   err: '',
   path: '/dir/bio',
   table: {
    name: 'bio',
    caption: 'Биоматериалы',
    notes: 'Справочник вариантов биоматериалов для исследования из таблицы isl',
    rows: [
     [Object], [Object], [Object],
    ]
   }
  }

  где Object подобен

  { npp: 1, name: 'капиллярная кровь' }
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Информация о запрашиваемом справочнике

• Строки справочника

• Если у исследования заявлено количество биоматериалов больше одного, то при заказе исследования обязательно указывать код биоматериала. Смотреть Добавление заказа

  {
   err: '',
   path: '/dir/isl',
   table: {
    name: 'isl',
    caption: 'Исследования',
    notes: 'Справочник исследований',
    rows: [
     [Object], [Object], [Object],
    ]
   }
  }

  где Object подобен

  {
   npp: 257,
   cod: '08-017',
   name: 'Суммарные иммуноглобулины E (IgE) в сыворотке',
   bio_cnt: 1,
   bio: [ [Object2] ]
  },

  где Object2 подобен

  { npp: 2, name: 'венозная кровь' }
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Информация о запрашиваемом справочнике

• Строки справочника

  {
   err: '',
   path: '/dir/status',
   table: {
    name: 'status',
    caption: 'Статусы',
    notes: 'Справочник статусов заказов',
    rows: [
     [Object], [Object], [Object],
    ]
   }
  }

  где Object подобен

  { npp: 2, name: 'Подтвержден' },
            

• Если пустая строка, запрос выполнен
• Иначе сообщение об ошибке

• строка запроса

• Версия REST сервиса

• Версия SQL сервиса

  {
   err: '',
   path: '/ver',
   api: { ver: '01.01' },
   server: { ver: '01.02' }
  }