Это продолжение статьи "Первые шаги". Рекомендуем сначала ознакомиться с ней.

Обмен данными с сервером Reteko можно выполнять с помощью сетевой утилиты cURL с поддержкой SSL.

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

Для начала работы распакуйте архив с утилитой в корневую директорию диска C. Для удобства работы рекомендуем скопировать сертификат .crt и файл импорта в директорию C:\Curl.

Для выполнения запроса откройте командную строку Windows (Пуск -> Все программы -> Стандартные -> Выполнить. В появившемся окне введите cmd и нажмите «Ок»).

Перейдите в директорию с утилитой Curl с помощью команды “cd C:\Curl”.

 

Импорт: 

Сформируйте файл прайс-листа согласно формату, представленному в статье "Первые шаги".

С помощью командной строки выполните следующий запрос: 

curl --cert certfile.crt -k -F file=@import.xml  https://api.reteko.com/import

где:

certfile.crt - файл клиентского сертификата

import.xml - файл прайс-листа (допускается импорт файлов с расширением .xls).

Сервер должен прислать один из следующих вариантов ответа:

{"msg":"ok","ok":1} импорт файла выполнен успешно
{"msg":"error_type","ok":0} при выполнении запроса произошла. Описание возможных ошибок можете посмотреть в отдельной статье.

В случае хранения файлов сертификата и прайс-листов в месте, отличном от директории C:\Curl ,  в запросе необходимо указать путь к этим файлам, например:

curl --cert D:\Certificates\certfile.crt -k -F file=@D:\Work\Prices\import.xml https://api.reteko.com/import

  

Экспорт:

Экспорт данных выполняется через командную строку со следующими параметрами:

  • type - тип отчета. Возможные значения: c - чеки, z - Z-отчеты, a - все отчеты. По умолчанию возвращаются все отчеты
  • from - начальная дата экспортируемых чеков. Формат поля - YYYY-MM-DD-HH
  • to - конечная дата экспортируемых чеков. Формат тот же.
  • serial - серийный номер кассы. Если необходимо получить данные по нескольким кассам, возможно в запросе указывать несколько параметров serial через амперсанд ("&").
  • export_type - тип экспорта. Возможные значения xml, xls, xlsx, по умолчанию - xml. Этот параметр необязателен.

Пример запроса:

curl --cert certfile.crt -k -o prod.zip https://api.reteko.com/export?serial=4101101004"&"from=2012-10-04-00"&"to=2012-10-05-23"&"sale_cash=Y"&"sale_card=Y"&"export_type=xml"&"type=a 

где:

prod.zip – файл отчета (задается любое имя архива),

certfile.crt - файл клиентского сертификата.

Архив с данными будет загружен в директорию, содержащую утилиту Curl.

Если вы храните сертификат не в директории C:\Curl, или хотите загрузить данные в другую директорию, в запросе необходимо указать путь к файлам, например: 

curl --cert D:\Certificates\certfile.crt -k -o D:\Work\Data\prod.zip https://api.reteko.com/export?serial=4101101004"&"from=2012-10-04-00"&"to=2012-10-05-23"&"sale_cash=Y"&"sale_card=Y"&"export_type=xml"&"type=a" 

Возникла ошибка при импорте или экспорте? Поищите ее в статье "Ошибки".