API ЮKassa
Помощь
Подключить ЮKassa
Метод listOrders
Описание
Получение перечня заказов и их свойств.
Формат запроса
Адрес для вызова операции
https://shop.yookassa.ru/webservice/mws/api/listOrders
Параметры запроса
ПараметрТипОписание
requestDTdateTimeДата и время запроса по часам системы магазина. Обязательный параметр.
outputFormatnormalizedString
Формат представления результата запроса. Допустимые значения — XML или CSV.
Необязательный параметр, значение по умолчанию: XML
csvDelimiterstring,
1 символ
Разделитель значений для формата CSV. Не может быть равен символу «"» (кавычка).
Необязательный параметр: значение по умолчанию «;» (точка с запятой).
shopIdlong
Идентификатор магазина, список заказов которого запрашивается.
Если параметр не задан, то возвращаются заказы по shopId, для которых у данного пользователя MWS имеется право получать список заказов.
orderCreatedDatetimeGreaterOrEqualdateTime
Нижняя граница времени создания заказа.
Выбираются заказы, время создания которых больше или равно значению этого параметра.
orderCreatedDatetimeLessOrEqualdateTime
Верхняя граница времени создания заказа.
Выбираются заказы, время создания которых меньше или равно значению этого параметра.
paidboolean
Если параметр имеет значение true, то возвращаются только оплаченные заказы.
Если параметр имеет значение false, то возвращаются только неоплаченные заказы.
Если параметр не задан, будут возвращены как оплаченные, так и неоплаченные заказы.
paymentDatetimeGreaterOrEqualdateTime
Нижняя граница времени оплаты заказа.
Выбираются заказы, время оплаты которых больше или равно значению этого параметра.
paymentDatetimeLessOrEqualdateTime
Верхняя граница времени оплаты заказа.
Выбираются заказы, время оплаты которых меньше или равно значению этого параметра.
invoiceIdlongУникальный номер транзакции в ЮKassa.
orderNumberstring,
до 64 символов
Уникальный номер заказа в системе магазина.
Использование параметра возможно, если сервис ЮKassa получает от магазина и хранит номера заказов.
outputFieldsstring,
до 4000 символов
Список свойств заказа, которые должны быть выведены в результате выполнения запроса.
Разделитель имен в списке — символ «;» (точка с запятой, без кавычек).
Значение по умолчанию
Полный список свойств заказа указан в разделе Формат ответа.
Особенности
В параметрах запроса списка заказов обязательно должно быть хотя бы одно из условий:
  • номер транзакции (invoiceId) и идентификатор магазина (shopId);
  • номер заказа (orderNumber) и идентификатор магазина (shopId);
  • диапазон времени создания заказа (orderCreatedDatetimeGreaterOrEqual и/или orderCreatedDatetimeLessOrEqual);
  • диапазон времени оплаты заказа (paymentDatetimeGreaterOrEqual и/или paymentDatetimeLessOrEqual).
При запросах по номеру транзакции (invoiceId) или номеру заказа (orderNumber) в запросе обязательно должен быть указан идентификатор магазина (shopId).
Для запросов, выборка в которых ограничена диапазоном времени создания или времени оплаты заказа, действуют следующие правила:
  • если задана только одна граница диапазона для времени создания или оплаты заказа, то значение второй берется по умолчанию. Значение по умолчанию для верхней границы — текущее время в ЮKassa, значение по умолчанию для нижней границы — время верхней границы, указанное в запросе, минус одни сутки;
  • если задан диапазон времени оплаты заказа, то в запросе обязательно должен присутствовать параметр paid со значением true;
  • длина диапазона времени, ограничивающего выборку, не должна превышать 31 день;
  • количество записей, попадающих в выборку, не должно превышать 10 000.
Формат ответа
ПараметрТипОписание
orderCountint
Количество заказов в результате.
Поле заголовка ответа. Присутствует в случае успешной выборки списка заказов (listOrders).
shopIdlongИдентификатор магазина, который ЮKassa выдала при подключении.
articleIdlongИдентификатор товара в ЮKassa.
shopNamestring,
до 64 символов
Название магазина.
articleNamestring,
до 128 символов
Название товара.
invoiceIdlongУникальный номер транзакции в ЮKassa.
orderNumberstring,
до 64 символов
Номер заказа в системе магазина.
Если ЮKassa получает от магазина номера заказов и хранит их, то данный параметр содержит номер заказа в системе магазина. Иначе это свойство содержит номер транзакции в ЮKassa.
paymentSystemOrderNumberstring,
до 40 символов
Идентификатор перевода в ЮKassa
Присутствует только для оплаченных заказов.
customerNumberstring,
до 64 символов
Идентификатор покупателя в системе магазина (присланный в платежной форме).
Это может быть уникальный логин, номер мобильного телефона, номер договора и т. п., зависит от магазина.
createdDatetimedateTimeМомент времени регистрации заказа на стороне ЮKassa.
paidbooleanИмеет значение true, если заказ оплачен, иначе false.
paymentDatetimedateTime
Момент времени оплаты заказа в ЮKassa.
Значение присутствует в ответе только для оплаченных заказов.
paymentAuthorizationTimelong
Номер заказа в процессинговом центре ЮKassa.
Значение присутствует в ответе только для оплаченных заказов.
payerCodeYMAccount
Номер счета плательщика.
Значение присутствует в ответе только для оплаченных заказов.
payerAddressstring,
до 33 символов
IP-адрес плательщика, если он известен.
Значение присутствует в ответе только для оплаченных заказов.
payeeCodeYMAccount
Номер счета получателя перевода при оплате заказа.
Значение присутствует в ответе только для оплаченных заказов.
paymentSystemDatetimedateTime
Момент времени регистрации оплаты заказа в процессинговом центре ЮKassa.
Значение присутствует в ответе только для оплаченных заказов.
avisoReceivedDatetimedateTime
Момент времени регистрации оплаты заказа в системе магазина.
Присутствует, если магазин на момент запроса получил уведомление о данном переводе.
avisoStatusintКод состояния уведомления о переводе. Список кодов состояний уведомления о переводе
avisoRegistryIdlongНомер реестра принятых платежей, в котором содержится данный заказ. Может отсутствовать в ответе.
orderSumAmountCurrencyAmountСумма заказа.
orderSumCurrencyPaycashCurrencyCodeКод валюты для orderSumAmount.
orderSumBankPaycashCurrencyBankКод процессингового центра для orderSumAmount.
contractAmountCurrencyAmountСумма к оплате в валюте счета плательщика. Может отсутствовать в ответе.
contractCurrencyCurrencyCodeКод валюты счета плательщика. Может отсутствовать в ответе.
paidSumAmountCurrencyAmount
Сумма, уплаченная плательщиком.
Значение присутствует в ответе только для оплаченных заказов.
paidSumCurrencyPaycashCurrencyCode
Код валюты для paidSumAmount.
Значение присутствует в ответе только для оплаченных заказов.
paidSumBankPaycashCurrencyBank
Код процессингового центра для paidSumAmount.
Значение присутствует в ответе только для оплаченных заказов.
shopSumAmountCurrencyAmountСумма, которая зачисляется на расчетный счет магазина: сумма заказа за вычетом комиссии ЮKassa.
shopSumCurrencyPaycashCurrencyCodeКод валюты для суммы, которая зачисляется на расчетный счет магазина.
shopSumBankPaycashCurrencyBankКод процессингового центра для суммы, которая зачисляется на расчетный счет магазина.
receivedSumAmountCurrencyAmount
Сумма, которую ЮKassa получает от плательщика.
Значение присутствует в ответе только для оплаченных заказов.
receivedSumCurrencyPaycashCurrencyCode
Код валюты для receivedSumAmount.
Значение присутствует в ответе только для оплаченных заказов.
receivedSumBankPaycashCurrencyBank
Код процессингового центра ЮKassa для receivedSumAmount.
Значение присутствует в ответе только для оплаченных заказов.
paymentFormParamsstring
Параметры платежной формы.
Значение присутствует в ответе только для магазинов, у которых установлена настройка «сохранять параметры платежной формы».
paymentTypenormalizedStringСпособ проведения платежа
agentIdlongСлужебный параметр в сервисе ЮKassa. Может отсутствовать в ответе.
uniLabelstringЕдиная метка операции в сервисе ЮKassa.
clearingstring
Статус подтверждения отложенного платежа магазином. Возможные значения:
  • none — платеж не подтвержден;
  • sale — платеж подтвержден;
  • cancel — платеж отменен.
Значение присутствует в ответе только, если магазин настроен на отложенные платежи и разрешена передача информации о таких платежах в ответе на listOrders.
environmentstring
Статус заказа, позволяет различать настоящие и тестовые операции. Возможные значения:
  • Live — настоящая операция;
  • Test — тестовая операция.
Примеры
Пример успешного ответа в формате XML
XML
<?xml version="1.0" encoding="utf-8"?>
<listOrdersResponse status="0" error="0"
                    processedDT="2011-08-02T14:50:25.089+03:00"
                    orderCount="2">
    <order shopId="1" articleId="2" invoiceId="2000024720731"
           shopName="Ваш магазин"
           articleName="Шапка-ушанка"
           orderNumber="14828233603000"
           paymentSystemOrderNumber="483536611593030008"
           customerNumber="800350518"
           createdDatetime="2011-08-02T14:43:30.676+03:00"
           paid="true"
           orderSumAmount="17.28"
           orderSumCurrencyPaycash="643"
           orderSumBankPaycash="1003"
           paidSumAmount="17.28"
           paidSumCurrencyPaycash="643"
           paidSumBankPaycash="1003"
           receivedSumAmount="17.28"
           receivedSumCurrencyPaycash="643"
           receivedSumBankPaycash="1003"
           shopSumAmount="17.28"
           shopSumCurrencyPaycash="643"
           shopSumBankPaycash="1003"
           paymentDatetime="2011-08-02T14:43:31.593+03:00"
           paymentAuthorizationTime="483536611593030008"
           payerCode="41003422841475"
           payerAddress="192.168.1.127"
           payeeCode="41003131475668"
           paymentSystemDatetime="2011-08-02T14:43:31.593+03:00"
           avisoReceivedDatetime="2011-08-02T14:43:31.298+03:00"
           avisoStatus="1000"
           paymentType="AC"
           agentId="200002"
           uniLabel="1cd18622-0004-5000-8000-01d1aac3555b"
           environment="Live"    
            />
    <order shopId="1" articleId="2" invoiceId="2000024720733"
           shopName="Ваш магазин"
           articleName="Шапка-ушанка"
           orderNumber="40522286348326"
           paymentSystemOrderNumber="483536613043117008"
           customerNumber="810844412"
           createdDatetime="2011-08-02T14:43:32.203+03:00"
           paid="false"
           orderSumAmount="2.08"
           orderSumCurrencyPaycash="643"
           orderSumBankPaycash="1003"
           paidSumAmount="2.07"
           paidSumCurrencyPaycash="643"
           paidSumBankPaycash="1003"
           environment="Live"    
            />
</listOrdersResponse>
Пример успешного ответа в формате CSV
status=0;error=0;processedDT=2011-08-02T14:46:58.096+03:00;orderCount=2

shopId;shopName;articleId;articleName;invoiceId;orderNumber;paymentSystemOrderNumber;customerNumber;createdDatetime;paid;orderSumAmount;
orderSumCurrencyPaycash;orderSumBankPaycash;paidSumAmount;paidSumCurrencyPaycash;paidSumBankPaycash;receivedSumAmount;receivedSumCurrencyPaycash;
receivedSumBankPaycash;shopSumAmount;shopSumCurrencyPaycash;shopSumBankPaycash;paymentDatetime;paymentAuthorizationTime;payerCode;payerAddress;payeeCode;
paymentSystemDatetime;avisoReceivedDatetime;avisoStatus;paymentType;agentId;uniLabel;environment

1;"Ваш магазин";2;"Шапка-ушанка";2000024717776;"2011.08.02 09:07:32";483512879684006008;97881;2011-08-02T08:07:59.148+03:00;true;10.15;643;1003;10.15;643;
1003;10.15;643;1003;10.15;643;1003;2011-08-02T08:07:59.684+03:00;483512879684006008;41003476047679;192.168.1.127;41003131475668;2011-08-02T08:07:59.684+03:00;
2011-08-02T08:07:59.660+03:00;1000;AC;200002;1cd12967-0001-5000-8000-000000034fd8;Live


1;"Ваш магазин";2;"Шапка-ушанка";2000024717780;2000024717780;483512937773006008;770367;2011-08-02T08:08:57.175+03:00;true;10.00;643;1003;10.00;643;
1003;10.00;643;1003;10.00;643;1003;2011-08-02T08:08:57.773+03:00;483512937773006008;41003494819180;192.168.1.127;41003131475668;2011-08-02T08:08:57.773+03:00;
2011-08-02T08:08:57.730+03:00;1000;AC;200002;1cd129a4-0001-5000-8000-000000034fe1;Live
Пример сообщения об ошибке в формате XML
XML
<listOrdersResponse
         status="3" error="111"
         processedDT="2011-07-02T20:38:01.000+04:00"
         techMessage="Неверное значение параметра requestDT"
         />
Пример сообщения об ошибке в формате CSV
status=3;error=111;processedDT=2011-07-21T13:20:14.869+04:00;”techMessage=Неверное значение параметра requestDT”
Что почитать еще
Коды состояний запросаКоды ошибокКоды состояний уведомления о переводеТипы данных