Заказы
Заказ — это то, что вы получаете после оформления заказа клиентом.
С помощью DataEase вы можете:
- Исправлять цены, количество или теги в сотнях заказов.
- Добавлять номера отслеживания, отправлять счета или возвращать позиции массово.
- Экспортировать полную историю заказов для отчетов или бухгалтерии.
Руководство по заказам Shopify здесь.
Содержание
Section titled “Содержание”2. Экспорт
Section titled “2. Экспорт”- Выберите CSV (лучше для очень больших файлов) или Excel.
- Выберите Order.
- Выберите нужные столбцы — name, financialStatus, lineItemQuantity и т. д.
- Запустите задачу и скачайте файл.
Подробнее: Руководство по экспорту
3. Импорт
Section titled “3. Импорт”Команды
Section titled “Команды”Строка заказа command → CREATE, UPDATE, REPLACE, DELETE, IGNORE
Строка позиции itemCommand → CREATE, UPDATE, MERGE, DELETE, IGNORE
Другие типы строк следуют той же схеме.
Специальный столбец action (только для импорта):
COMPLETE, CANCEL, SEND_CONFIRMATION, FULFILL, REFUND
Совет: Для CREATE необходимо указать как минимум email или phone (или существующий customerId).
При создании заказов в тестовом или dev магазине есть ограничение: до 5 новых заказов в минуту.
Возвраты никогда не отправляются дважды. Если более ранняя попытка того же возврата в этом импорте завершилась неудачей, Shopify отказывается повторять её (
IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED). DataEase не повторяет её новым запросом (это могло бы вернуть деньги дважды): строки возврата получают ошибку “Refund was not applied…”. Проверьте строки и запустите импорт снова.
Шаги
- Возьмите пример файла: Order-import-sample.xlsx
- Отредактируйте строку заголовка (LineType =
ORDER), затем добавьте дополнительные строки дляLINE_ITEM,SHIPPING_LINEи т. д. - Сопоставьте столбцы в DataEase, загрузите и начните.
Полные инструкции: Руководство по импорту
4. Справочник полей
Section titled “4. Справочник полей”Ниже приведен сокращенный список наиболее используемых столбцов.
Серые строки в вашем экспорте — только для экспорта (не могут быть изменены при импорте).
Уровень заказа (LineType = ORDER)
Section titled “Уровень заказа (LineType = ORDER)”-
id— ID заказа. Необходим для UPDATE, REPLACE, DELETE. -
command— Действие строки: CREATE | UPDATE | REPLACE | DELETE | IGNORE. -
currencyCode— Валюта магазина на момент размещения заказа. Оставьте пустым, чтобы использовать валюту по умолчанию. -
presentmentCurrencyCode— Валюта, в которой покупатель оплатил (для магазинов с несколькими валютами). -
email— Электронная почта клиента для квитанций. -
phone— Номер телефона клиента. -
tags— Теги, разделенные запятыми. См. руководство по тегам. -
tagsCommand— ADD, REMOVE или REPLACE теги в заказе. -
buyerAcceptsMarketing—true, если покупатель согласился на маркетинг. -
poNumber— Номер заказа на покупку. -
taxesIncluded—true, если цены на товары уже включают налог. -
displayFinancialStatus— AUTHORIZED, PAID, REFUNDED и т. д. (Только для экспорта) -
displayFulfillmentStatus— FULFILLED, PARTIALLY_FULFILLED и т. д. (Только для экспорта)
Позиции (LineType = LINE_ITEM)
Section titled “Позиции (LineType = LINE_ITEM)”-
lineItemVariantId— ID варианта для добавления/обновления. Оставьте пустым для пользовательского товара. -
lineItemQuantity— Заказанное количество. -
lineItemSku— SKU (используется для поиска варианта, если variantId пуст). -
lineItemOriginalUnitPrice— Цена до скидок (валюта магазина). -
lineItemAppliedDiscountValue— Значение скидки на эту позицию. -
lineItemAppliedDiscountValueType—FIXED_AMOUNTилиPERCENTAGE.
Линии доставки (LineType = SHIPPING_LINE)
Section titled “Линии доставки (LineType = SHIPPING_LINE)”-
shippingLineTitle— Название службы доставки. -
shippingLinePrice— Цена в валюте магазина. -
shippingLinePresentmentPrice— Цена в валюте покупателя.
Исполнения (LineType = FULFILLMENT)
Section titled “Исполнения (LineType = FULFILLMENT)”-
fulfillmentTrackingCompany— Перевозчик для отслеживания (точное название из списка Shopify). -
fulfillmentTrackingNumbers— Номера отслеживания (разделенные запятыми, если несколько). -
fulfillmentLocationId— ID местоположения для вычета инвентаря. -
fulfillmentNotifyCustomer—true, чтобы отправить подтверждение доставки по электронной почте.
Транзакции и возвраты (LineType = TRANSACTION или REFUND)
Section titled “Транзакции и возвраты (LineType = TRANSACTION или REFUND)”-
transactionKind— AUTHORIZATION | CAPTURE | REFUND | SALE | VOID. -
transactionAmount— Сумма в валюте магазина. -
refundLineItemRestockType— RETURN или CANCEL при возврате товаров на склад.
Метаполя
Section titled “Метаполя”metafields— Пользовательские столбцы для дополнительных данных. См. руководство по метаполям.
Поля только для экспорта
Section titled “Поля только для экспорта”Ниже приведены все дополнительные «только серые» столбцы, которые DataEase экспортирует для заказов. Они только для чтения — вы не можете изменить их при импорте, но они полезны для отчетов, проверки на мошенничество, маркетинга и поддержки.
Итого по заказу и цены
Section titled “Итого по заказу и цены”totalPrice— Общая сумма заказа в валюте магазина (включая налоги + доставку + скидки).totalShippingPrice— Стоимость доставки до скидок или возвратов.totalWeight— Общий вес всех товаров (в граммах).totalTax— Общая сумма налога, начисленного на заказ.subtotalPrice— Промежуточный итог после скидок на уровне товара, до налогов и доставки.currentSubtotalPrice— Промежуточный итог после возвратов или изменений.totalShopCurrencyDiscount— Все скидки (заказ + товары) в валюте магазина на момент создания.totalPresentmentCurrencyDiscount— Текущая скидка на уровне заказа в валюте покупателя.currentTotalDuties— Пошлины, подлежащие уплате после возвратов (null, если не используется).currentTotalAdditionalFees— Дополнительные сборы (упаковка подарков, утилизация и т. д.) после возвратов.originalTotalAdditionalFeesSet— Дополнительные сборы на момент создания заказа.totalOutstandingSet— Остаток, который еще нужно оплатить (+) или вернуть (–) по заказу.currentTotalPriceSet— Итоговая сумма после любых изменений или возвратов.
Статус заказа и метаданные
Section titled “Статус заказа и метаданные”publicationSource— Канал продаж, создавший заказ (Интернет-магазин, POS и т. д.).statusPageUrl— Ссылка на страницу статуса заказа для клиента.displayFulfillmentStatus— Дружественный статус выполнения (FULFILLED, PARTIALLY_FULFILLED…).clientIp— IP-адрес, с которого был размещен заказ.canNotifyCustomer—true, если существует адрес электронной почты для уведомлений.daysToConversion— Дни с момента первого посещения магазина до покупки.cancellationNote— Примечание персонала, записанное при отмене заказа.riskRecommendation— Рекомендация по риску мошенничества: ACCEPT, INVESTIGATE или CANCEL.createdAt— Дата/время создания заказа.updatedAt— Последнее изменение в заказе.cancelledAt— Когда заказ был отменен (null, если никогда).
Маркетинг / отслеживание посещений
Section titled “Маркетинг / отслеживание посещений”lastVisitLandingPage— Первая страница, на которую покупатель попал в своей сессии покупки.lastVisitSource— Источник маркетинга (Google, Email, Direct и т. д.).lastVisitSourceType— Тип маркетинговой тактики (реклама, социальные сети, реферал…).lastVisitUtmCampaign— Название кампании UTM.lastVisitUtmContent— Тег контента UTM.lastVisitUtmMedium— Среда UTM (баннер, email, cpc…).lastVisitUtmSource— Источник UTM (google, newsletter…).lastVisitUtmTerm— Поисковый термин UTM.
Снимок клиента (поля только для экспорта)
Section titled “Снимок клиента (поля только для экспорта)”customerCreatedAt— Когда была впервые создана запись клиента.customerLocale— Предпочтительный язык покупателя.customerNumberOfOrders— Общее количество заказов этого клиента.customerState— Состояние учетной записи — INVITED, ENABLED, DISABLED или DECLINED.customerAmountSpentAmount— Сумма всех расходов за всю жизнь.customerAmountSpentCurrencyCode— Валюта всех расходов за всю жизнь.customerTags— Теги, уже имеющиеся в профиле клиента.customerSmsMarketingConsent— Время последнего обновления согласия на SMS-маркетинг.customerEmailMarketingConsent— Время последнего обновления согласия на email-маркетинг.customerCompanyName— Название компании B2B (если есть).customerCompanyId— ID компании, связанной с заказом.customerCompanyExternalId— Внешний ID компании в ERP/CRM.customerLocationId— ID местоположения компании.customerLocationExternalId— Внешний ID местоположения компании.customerLocationName— Дружественное название местоположения компании.
Дополнительная информация о доставке и адресе
Section titled “Дополнительная информация о доставке и адресе”shippingCity— Город доставки.shippingCountry— Название страны доставки.shippingProvince— Название штата/провинции доставки.
Аналитика по позициям
Section titled “Аналитика по позициям”lineItemName— Название продукта с названием варианта на момент продажи.lineItemOriginalTotal— Общая сумма по позиции до любых скидок.lineItemTotalPresentmentCurrencyDiscount— Скидка, примененная к этой позиции (валюта покупателя).lineItemVariantSku— SKU варианта, зафиксированный на момент заказа.lineItemVariantProductTags— Теги продукта для этого варианта (снимок).lineItemVariantInventoryQuantity— Запас на момент экспорта.lineItemOriginalUnitPrice— Цена за единицу на момент создания заказа (валюта магазина).lineItemVariantProductHandle— Обозначение продукта, зафиксированное на момент продажи.lineItemDiscountAllocations— JSON-объект распределения скидок на этот товар.lineItemDiscountPerItem— Общая скидка на единицу в валюте магазина.lineItemVariantProductType— Снимок типа продукта.lineItemVariantWeightUnit— Единица измерения веса (г, кг, унция, фунт).lineItemVariantWeight— Значение веса.lineItemVariantCost— Стоимость за единицу (требуется разрешение “просмотр стоимости продуктов”).lineItemVariantCountryCodeOfOrigin— Код страны происхождения.lineItemVariantHSCode— Гармонизированный тарифный код (6–13 цифр).lineItemVariantProvinceCodeOfOrigin— Код провинции/штата происхождения.
Аудит выполнения
Section titled “Аудит выполнения”fulfillmentStatus— Статус выполнения (SUCCESS, FAILURE и т. д.).fulfillmentName— Справочное название (например, “F-1001”).fulfillmentCreatedAt— Когда была создана запись выполнения.fulfillmentUpdatedAt— Последнее изменение записи выполнения.fulfillmentDeliveredAt— Дата доставки посылки (если перевозчик обновляет).fulfillmentEstimatedDeliveryAt— Предполагаемая дата доставки.fulfillmentInTransitAt— Когда перевозчик отметил посылку как “в пути”.fulfillmentRequiresShipping—true, если любая строка в этом выполнении требует доставки.fulfillmentTotalQuantity— Сумма всех количеств позиций в этом выполнении.fulfillmentDisplayStatus— Дружественный статус (IN_TRANSIT, DELIVERED…).fulfillmentCountry— Название страны местоположения выполнения.
Детали тарифов на доставку
Section titled “Детали тарифов на доставку”shippingLineSource— Откуда пришел тариф (Ручной, Приложение, Перевозчик).shippingLineDiscountedPrice— Цена доставки после скидок (валюта магазина).shippingLineDiscountedPresentmentPrice— Цена доставки после скидок (валюта покупателя).
Аналитика транзакций
Section titled “Аналитика транзакций”transactionPaymentId— Справочный ID платежа от шлюза.transactionCreatedAt— Когда была создана запись транзакции.transactionErrorCode— Код ошибки шлюза, если платеж не удался.transactionAuthorizationExpiresAt— Когда истечет авторизация (только Plus).transactionFormattedGateway— Дружественное название шлюза (например, “Stripe”).transactionManuallyCapturable—true, если платеж можно захватить вручную позже.transactionMaximumRefundableAmount— Оставшаяся сумма для возврата (для предложенных возвратов).transactionMultiCapturable—true, если разрешены множественные захваты.transactionProcessedAt— Время обработки транзакции.
Детали платежной карты (замаскированы)
Section titled “Детали платежной карты (замаскированы)”paymentDetailsAvsResultCode— Код проверки адреса от шлюза.paymentDetailsBin— Первые шесть цифр карты (BIN/IIN).paymentDetailsNumber— Замаскированный номер карты (XXXX-XXXX-1234).paymentDetailsName— Имя владельца карты.paymentDetailsExpirationYear— Год истечения срока действия карты.paymentDetailsExpirationMonth— Месяц истечения срока действия карты.paymentDetailsCvvResultCode— Результат проверки CVV.paymentDetailsCompany— Бренд карты (Visa, MasterCard…).paymentDetailsPaymentMethodName— Метод, специфичный для шлюза (например, “visa_debit”).paymentDetailsWallet— Используемый цифровой кошелек (APPLE_PAY, GOOGLE_PAY…).
Аудит возвратов
Section titled “Аудит возвратов”refundId— ID записи возврата.refundCreatedAt— Когда был сделан возврат.refundedAmount— Общая сумма возврата (валюта магазина).refundedPresentmentAmount— Общая сумма возврата (валюта покупателя).refundLineItemLocationId— Местоположение, куда был возвращен инвентарь.refundLineItemRestocked—true, если запас был возвращен на склад.refundLineItemRefundedAmount— Сумма возврата для этой позиции (валюта магазина).refundLineItemRefundedPresentmentAmount— Сумма возврата для этой позиции (валюта покупателя).
5. Фильтры
Section titled “5. Фильтры”Используйте их при экспорте, чтобы сузить набор результатов:
Id— Точный ID заказа.Name— Номер заказа Shopify (например, #1001).CreatedAt— Дата/диапазон создания.ProcessedAt— Дата/диапазон обработки платежа.UpdatedAt— Дата/диапазон последнего изменения.ClosedAt— Дата/диапазон закрытия заказа.CancelledAt— Дата/диапазон отмены.CancelReason— Причина отмены (CUSTOMER, INVENTORY, …).FinancialStatus— PENDING, PAID, PARTIALLY_PAID, REFUNDED, …DisplayFinancialStatus— Сводный финансовый статус для UI.FulfillmentStatus— UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, …DisplayFulfillmentStatus— Сводный статус выполнения для UI.OrderFulfillmentStatus— Фильтр статуса отправки (scheduled, in_progress, …).ReturnStatus— NONE, PARTIALLY_RETURNED, RETURNED.RiskLevel— LOW, MEDIUM, HIGH риск мошенничества.RiskRecommendation— ACCEPT, INVESTIGATE, CANCEL.ChargebackStatus— NONE, UNDER_REVIEW, WON, LOST.Gateway— Название платежного шлюза (PayPal, Shopify Payments, …).PaymentId— Специфический идентификатор платежа.PaymentProviderId— ID платежа на стороне провайдера.CreditCardLast4— Последние четыре цифры карты.TransactionKind— AUTHORIZATION, CAPTURE, REFUND, …TransactionStatus— SUCCESS, FAILURE, PENDING.Test— true / false - только тестовые заказы.Channel— POS, Интернет-магазин, Черновик и т. д.ChannelId— Внутренний ID канала продаж.SalesChannel— Читаемое название канала (Shop App, IG Shop, …).SourceName— Тег источника (web, pos, api, draft_order).SourceIdentifier— Внешний ID заказа POS / третьей стороны.CheckoutToken— Токен сессии оформления заказа.CartToken— ID корзины, связанный с заказом.DeliveryMethod— SHIPPING, LOCAL_PICKUP, LOCAL_DELIVERY.FulfillmentLocationId— Местоположение, выполнившее заказ.ReferenceLocationId— Справочное местоположение POS / происхождения.LocationId— Местоположение магазина, где был создан заказ.PoNumber— Справочный номер заказа на покупку.ConfirmationNumber— Внешний номер подтверждения / квитанции.Sku— Заказы, содержащие определенный SKU.SubtotalLineItemsQuantity— Общее количество товаров (поддерживает диапазоны).DiscountCode— Заказы, использовавшие данный код скидки.Tag— Заказы, помеченные определенным тегом.Email— Соответствие электронной почты клиента.Phone— Соответствие номера телефона клиента.CustomerId— Все заказы для одного клиента.CustomerState— ENABLED, INVITED, DECLINED, DISABLED.CompanyId— ID компании B2B.FraudProtectionLevel— NOT_PROTECTED или PROTECTED.Status— OPEN, CLOSED, CANCELLED.CartToken— Фильтр по оригинальному токену корзины.ChargebackStatus— Статус возврата платежа по заказу.lastVisitUtmMedium— Среда UTM, зафиксированная при покупке.
Нужна помощь? Наша служба поддержки отвечает в течение 24 часов.
Дополнительные поля
Section titled “Дополнительные поля”Больше столбцов, которые поддерживает DataEase для этой сущности:
discountCodes— Примененные к заказу коды скидок.note— Внутреннее примечание о заказе.customAttributes— Пользовательские атрибуты для заказа в формате JSON.retailLocationId— ID розничного местоположения, связанного с заказом.isTest— Указывает, является ли заказ тестовым.refundOnCancellation— Возвращать ли средства при отмене заказа.storeCreditRefundExpiration— Дата истечения срока действия возврата в виде кредита магазина.restockOnCancellation— Возвращать ли товары на склад при отмене заказа.sourceUrl— URL, откуда произошел заказ.lastVisitReferrerUrl— URL последнего реферера перед размещением заказа.inventoryBehaviour— Поведение инвентаря для заказа.sendFulfillmentReceipt— Отправлять ли квитанцию о выполнении клиенту.sendReceipt— Отправлять ли квитанцию о заказе клиенту.notifyCustomerOnUpdate— Уведомлять клиента при обновлении заказа.updateOrderStaffNote— Примечание персонала для обновления в заказе.freeShippingDiscountCode— Код скидки на бесплатную доставку.fixedDiscountShopAmount— Фиксированная сумма скидки в валюте магазина.fixedDiscountPresentmentAmount— Фиксированная сумма скидки в валюте покупателя.fixedDiscountCode— Код скидки на фиксированную сумму.percentageDiscountCode— Код скидки на процент.percentageDiscountCodePercentage— Процентное значение кода скидки.orderFulfillmentLocationId— ID местоположения выполнения заказа.orderFulfillmentShipmentStatus— Статус отправки выполнения заказа.orderFulfillmentNotifyCustomer— Уведомлять клиента о выполнении заказа.orderFulfillmentTrackingCompany— Компания для отслеживания выполнения заказа.orderFulfillmentTrackingNumber— Номер отслеживания выполнения заказа.customerEmail— Адрес электронной почты клиента.customerFirstName— Имя клиента.customerLastName— Фамилия клиента.customerNote— Примечание от клиента.customerPhone— Номер телефона клиента.customerTaxExempt— Указывает, освобожден ли клиент от налогов.billingFirstName— Имя для выставления счета.billingLastName— Фамилия для выставления счета.billingName— Полное имя для выставления счета.billingCompany— Название компании для выставления счета.billingPhone— Номер телефона для выставления счета.billingAddress1— Первая строка адреса для выставления счета.billingAddress2— Вторая строка адреса для выставления счета.billingCity— Город для выставления счета.billingCountry— Страна для выставления счета.billingCountryCode— Код страны для выставления счета.billingZip— Почтовый индекс для выставления счета.billingProvince— Провинция для выставления счета.billingProvinceCode— Код провинции для выставления счета.shippingFirstName— Имя для доставки.shippingLastName— Фамилия для доставки.shippingName— Полное имя для доставки.shippingCompany— Название компании для доставки.shippingPhone— Номер телефона для доставки.shippingAddress1— Первая строка адреса для доставки.shippingAddress2— Вторая строка адреса для доставки.shippingCountryCode— Код страны для доставки.shippingZip— Почтовый индекс для доставки.shippingProvinceCode— Код провинции для доставки.lineItemId— ID позиции.lineItemTaxable— Указывает, облагается ли позиция налогом.lineItemTitle— Название позиции.lineItemVariantBarcode— Штрих-код варианта позиции.lineItemVariantTitle— Название варианта позиции.lineItemVendor— Поставщик позиции.lineItemUnitPrice— Цена за единицу позиции.lineItemUnitPresentmentPrice— Цена за единицу позиции в валюте покупателя.lineItemIsGiftCard— Указывает, является ли позиция подарочной картой.lineItemRequiresShipping— Указывает, требует ли позиция доставки.lineItemProductId— ID продукта позиции.lineItemCustomAttributes— Пользовательские атрибуты для позиции в формате JSON.lineItemLocationId— ID местоположения позиции.LineItemQuantityRestock— Количество для возврата на склад позиции.LineItemAllowDuplicates— Разрешить дублирование позиций.fulfillmentId— ID выполнения.fulfillmentTrackingUrls— URL-адреса отслеживания выполнения.fulfillmentAddress1— Первая строка адреса выполнения.fulfillmentAddress2— Вторая строка адреса выполнения.fulfillmentCity— Город выполнения.fulfillmentCountryCode— Код страны выполнения.fulfillmentProvince— Провинция выполнения.fulfillmentProvinceCode— Код провинции выполнения.fulfillmentZip— Почтовый индекс выполнения.fulfillmentMessage— Сообщение для выполнения.shippingLineId— ID линии доставки.shippingLineCode— Код линии доставки.transactionId— ID транзакции.transactionPresentmentAmount— Сумма транзакции в валюте покупателя.transactionAuthorizationCode— Код авторизации транзакции.transactionGateway— Платежный шлюз для транзакции.transactionTest— Указывает, является ли транзакция тестовой.transactionParentTransactionId— ID родительской транзакции.transactionGiftCardId— ID подарочной карты, использованной в транзакции.transactionReceiptJson— Квитанция транзакции в формате JSON.refundNote— Примечание к возврату.refundDiscrepancyReason— Причина расхождения в возврате.refundNotifyCustomer— Уведомлять клиента о возврате.refundFullShippingAmount— Возврат полной суммы доставки.refundShippingPresentmentAmount— Сумма возврата доставки в валюте покупателя.lineType— Тип позиции.taxLines— Налоговые линии, связанные с заказом.