Pedidos

Um Pedido é o que você obtém após um cliente finalizar a compra.
Com o DataEase você pode:

Corrigir preços, quantidades ou tags em centenas de pedidos.
Adicionar números de rastreamento, enviar faturas ou reembolsar linhas em massa.
Exportar todo o histórico de pedidos para relatórios ou contabilidade.

Guia de pedidos do Shopify aqui.

2. Exportar

Escolha CSV (melhor para arquivos muito grandes) ou Excel.
Selecione Pedido.
Escolha as colunas que você precisa-name, financialStatus, lineItemQuantity, etc.
Execute a tarefa e baixe seu arquivo.
Mais detalhes: Guia de exportação

3. Importar

Comandos

Comando da linha de pedido command → CREATE, UPDATE, REPLACE, DELETE, IGNORE
Comando do item da linha itemCommand → CREATE, UPDATE, MERGE, DELETE, IGNORE
Outros tipos de linha seguem o mesmo padrão.
Coluna especial action (apenas importação):
COMPLETE, CANCEL, SEND_CONFIRMATION, FULFILL, REFUND

Dica: Para CREATE você deve fornecer pelo menos email ou phone (ou um customerId existente).

Ao criar pedidos em uma loja de teste ou desenvolvimento, há um limite: até 5 novos pedidos por minuto.

Reembolsos nunca são enviados duas vezes. Se uma tentativa anterior do mesmo reembolso nesta importação falhou, o Shopify se recusa a repeti-la (IDEMPOTENCY_PREVIOUS_ATTEMPT_FAILED). O DataEase não tenta novamente com uma nova requisição (isso poderia reembolsar duas vezes): as linhas de reembolso recebem o erro “Refund was not applied…”. Verifique as linhas e execute a importação novamente.

Passos

Pegue o arquivo de exemplo: Order-import-sample.xlsx
Edite a linha de cabeçalho (LineType = ORDER), depois adicione linhas extras para LINE_ITEM, SHIPPING_LINE, etc.
Mapeie as colunas no DataEase, faça o upload e comece.
Instruções completas: Guia de importação

4. Referência de campos

Abaixo está uma lista resumida** das colunas mais usadas.
Linhas cinzas na sua exportação são apenas para exportação (não podem ser alteradas por importação).

Nível de pedido (LineType = ORDER)

id — ID do pedido. Necessário para UPDATE, REPLACE, DELETE.
command — Ação da linha: CREATE | UPDATE | REPLACE | DELETE | IGNORE.
currencyCode — Moeda da loja quando o pedido foi feito. Deixe em branco para usar o padrão da loja.
presentmentCurrencyCode — Moeda em que o comprador pagou (lojas com várias moedas).
email — Email do cliente para recibos.
phone — Número de telefone do cliente.
tags — Tags separadas por vírgula. Veja guia de tags.
tagsCommand — ADD, REMOVE ou REPLACE tags no pedido.
buyerAcceptsMarketing — true se o comprador optou por receber marketing.
poNumber — Número do pedido de compra.
taxesIncluded — true se os preços dos itens já incluírem impostos.
displayFinancialStatus — AUTHORIZED, PAID, REFUNDED, etc. (Apenas para exportação)
displayFulfillmentStatus — FULFILLED, PARTIALLY_FULFILLED, etc. (Apenas para exportação)

Itens de linha (LineType = LINE_ITEM)

lineItemVariantId — ID do variant para adicionar / atualizar. Deixe em branco para item personalizado.
lineItemQuantity — Quantidade pedida.
lineItemSku — SKU (usado para localizar o variant se variantId estiver em branco).
lineItemOriginalUnitPrice — Preço antes de descontos (moeda da loja).
lineItemAppliedDiscountValue — Valor do desconto nesta linha.
lineItemAppliedDiscountValueType — FIXED_AMOUNT ou PERCENTAGE.

Linhas de envio (LineType = SHIPPING_LINE)

shippingLineTitle — Nome do serviço de envio.
shippingLinePrice — Preço na moeda da loja.
shippingLinePresentmentPrice — Preço na moeda do comprador.

Cumprimentos (LineType = FULFILLMENT)

fulfillmentTrackingCompany — Transportadora de rastreamento (nome exato da lista do Shopify).
fulfillmentTrackingNumbers — Números de rastreamento (separados por vírgula se múltiplos).
fulfillmentLocationId — ID do local para deduzir o inventário.
fulfillmentNotifyCustomer — true para enviar confirmação de envio por email.

Transações e Reembolsos (LineType = TRANSACTION ou REFUND)

transactionKind — AUTHORIZATION | CAPTURE | REFUND | SALE | VOID.
transactionAmount — Valor na moeda da loja.
refundLineItemRestockType — RETURN ou CANCEL ao reabastecer itens.

Metafields

metafields — Colunas personalizadas para dados extras. Veja Guia de Metafields.

Campos apenas para exportação

Abaixo estão todas as colunas “apenas cinzas” extras que o DataEase exporta para Pedidos. Elas são somente leitura – você não pode alterá-las por importação, mas são úteis para relatórios, verificações de fraude, marketing e suporte.

Totais e preços do pedido

totalPrice — Total geral do pedido na moeda da loja (impostos + envio + descontos incluídos).
totalShippingPrice — Custo de envio antes de descontos ou reembolsos.
totalWeight — Peso total de todos os itens (gramas).
totalTax — Total de impostos cobrados no pedido.
subtotalPrice — Subtotal dos itens após descontos a nível de item, antes de impostos e envio.
currentSubtotalPrice — Subtotal após devoluções ou edições.
totalShopCurrencyDiscount — Todos os descontos (pedido + itens) na moeda da loja na criação.
totalPresentmentCurrencyDiscount — Desconto atual a nível de pedido na moeda do comprador.
currentTotalDuties — Taxas devidas após devoluções (nulo se não usado).
currentTotalAdditionalFees — Taxas extras (embalagem para presente, reciclagem, etc.) após devoluções.
originalTotalAdditionalFeesSet — Taxas extras no momento em que o pedido foi criado.
totalOutstandingSet — Saldo ainda a pagar (+) ou reembolsar (–) no pedido.
currentTotalPriceSet — Total geral final após quaisquer edições ou devoluções.

Status e metadados do pedido

publicationSource — Canal de vendas que criou o pedido (Loja Online, POS, etc.).
statusPageUrl — Link da página de “status do pedido” do cliente.
displayFulfillmentStatus — Estado amigável de cumprimento (FULFILLED, PARTIALLY_FULFILLED…).
clientIp — Endereço IP que fez o pedido.
canNotifyCustomer — true se existir um endereço de email para notificações.
daysToConversion — Dias desde a primeira visita à loja até a compra.
cancellationNote — Nota da equipe registrada quando o pedido foi cancelado.
riskRecommendation — Conselho de risco de fraude: ACCEPT, INVESTIGATE ou CANCEL.
createdAt — Data/hora em que o pedido foi feito.
updatedAt — Última vez que algo mudou no pedido.
cancelledAt — Quando o pedido foi cancelado (nulo se nunca).

Marketing / rastreamento de visitas

lastVisitLandingPage — Primeira página em que o comprador pousou na sessão de compra.
lastVisitSource — Fonte de marketing (Google, Email, Direto, etc.).
lastVisitSourceType — Tipo de tática de marketing (anúncio, social, referência…).
lastVisitUtmCampaign — Nome da campanha UTM.
lastVisitUtmContent — Tag de conteúdo UTM.
lastVisitUtmMedium — Meio UTM (banner, email, cpc…).
lastVisitUtmSource — Fonte UTM (google, newsletter…).
lastVisitUtmTerm — Termo de pesquisa UTM.

Instantâneo do cliente (campos apenas para exportação)

customerCreatedAt — Quando o registro do cliente foi criado pela primeira vez.
customerLocale — Idioma preferido do comprador.
customerNumberOfOrders — Contagem de pedidos ao longo da vida para este cliente.
customerState — Estado da conta – INVITED, ENABLED, DISABLED ou DECLINED.
customerAmountSpentAmount — Valor gasto ao longo da vida.
customerAmountSpentCurrencyCode — Moeda do gasto ao longo da vida.
customerTags — Tags já no perfil do cliente.
customerSmsMarketingConsent — Última atualização de consentimento de marketing por SMS.
customerEmailMarketingConsent — Última atualização de consentimento de marketing por email.
customerCompanyName — Nome da empresa B2B (se houver).
customerCompanyId — ID da empresa vinculada ao pedido.
customerCompanyExternalId — ID externo da empresa ERP/CRM.
customerLocationId — ID do local da empresa.
customerLocationExternalId — ID externo para o local da empresa.
customerLocationName — Nome amigável do local da empresa.

Informações extras de envio e endereço

shippingCity — Parte da cidade do endereço de envio.
shippingCountry — Nome do país do endereço de envio.
shippingProvince — Nome do estado/província do endereço de envio.

Análise de itens de linha

lineItemName — Título do produto com título do variant no momento da venda.
lineItemOriginalTotal — Total do item de linha antes de quaisquer descontos.
lineItemTotalPresentmentCurrencyDiscount — Desconto aplicado a esta linha (moeda do comprador).
lineItemVariantSku — SKU do variant capturado no momento do pedido.
lineItemVariantProductTags — Tags do produto para este variant (instantâneo).
lineItemVariantInventoryQuantity — Estoque disponível para o variant quando exportado.
lineItemOriginalUnitPrice — Preço unitário na criação do pedido (moeda da loja).
lineItemVariantProductHandle — Handle do produto registrado no momento da venda.
lineItemDiscountAllocations — Blob JSON de divisões de desconto neste item.
lineItemDiscountPerItem — Total de desconto por unidade na moeda da loja.
lineItemVariantProductType — Instantâneo do tipo de produto.
lineItemVariantWeightUnit — Unidade de peso (g, kg, oz, lb).
lineItemVariantWeight — Valor do peso.
lineItemVariantCost — Custo por unidade (requer permissão “ver custos do produto”).
lineItemVariantCountryCodeOfOrigin — Código do país de origem.
lineItemVariantHSCode — Código tarifário harmonizado (6–13 dígitos).
lineItemVariantProvinceCodeOfOrigin — Código do estado/província de origem.

Auditoria de cumprimento

fulfillmentStatus — Estado de cumprimento (SUCCESS, FAILURE, etc.).
fulfillmentName — Nome de referência (por exemplo, “F-1001”).
fulfillmentCreatedAt — Quando o registro de cumprimento foi feito.
fulfillmentUpdatedAt — Última alteração no registro de cumprimento.
fulfillmentDeliveredAt — Data em que o pacote foi entregue (se a transportadora atualizar).
fulfillmentEstimatedDeliveryAt — Data estimada de entrega.
fulfillmentInTransitAt — Quando a transportadora marcou o pacote como “em trânsito”.
fulfillmentRequiresShipping — true se qualquer linha neste cumprimento exigir envio.
fulfillmentTotalQuantity — Soma de todas as quantidades de itens de linha dentro deste cumprimento.
fulfillmentDisplayStatus — Status amigável (IN_TRANSIT, DELIVERED…).
fulfillmentCountry — Nome do país do local de cumprimento.

Detalhes da taxa de envio

shippingLineSource — De onde veio a taxa (Manual, App, Transportadora).
shippingLineDiscountedPrice — Preço de envio após descontos (moeda da loja).
shippingLineDiscountedPresentmentPrice — Preço de envio após descontos (moeda do comprador).

Análise de transações

transactionPaymentId — ID de referência de pagamento do gateway.
transactionCreatedAt — Quando o registro da transação foi feito.
transactionErrorCode — Código de erro do gateway se o pagamento falhou.
transactionAuthorizationExpiresAt — Quando uma autorização expirará (apenas Plus).
transactionFormattedGateway — Nome amigável do gateway (por exemplo, “Stripe”).
transactionManuallyCapturable — true se o pagamento puder ser capturado manualmente mais tarde.
transactionMaximumRefundableAmount — Valor reembolsável restante (para reembolsos sugeridos).
transactionMultiCapturable — true se múltiplas capturas forem permitidas.
transactionProcessedAt — Timestamp do processamento da transação.

Detalhes do cartão de pagamento (mascarado)

paymentDetailsAvsResultCode — Código de verificação de endereço do gateway.
paymentDetailsBin — Primeiros seis dígitos do cartão (BIN/IIN).
paymentDetailsNumber — Número do cartão mascarado (XXXX-XXXX-1234).
paymentDetailsName — Nome do titular do cartão.
paymentDetailsExpirationYear — Ano de validade do cartão.
paymentDetailsExpirationMonth — Mês de validade do cartão.
paymentDetailsCvvResultCode — Resultado da correspondência do CVV.
paymentDetailsCompany — Marca do cartão (Visa, MasterCard…).
paymentDetailsPaymentMethodName — Método específico do gateway (por exemplo, “visa_debit”).
paymentDetailsWallet — Carteira digital usada (APPLE_PAY, GOOGLE_PAY…).

Auditoria de reembolso

refundId — ID do registro de reembolso.
refundCreatedAt — Quando o reembolso foi feito.
refundedAmount — Valor total reembolsado (moeda da loja).
refundedPresentmentAmount — Valor total reembolsado (moeda do comprador).
refundLineItemLocationId — Local para onde o inventário foi devolvido.
refundLineItemRestocked — true se o estoque foi reabastecido.
refundLineItemRefundedAmount — Valor do reembolso para essa linha (moeda da loja).
refundLineItemRefundedPresentmentAmount — Valor do reembolso para essa linha (moeda do comprador).

5. Filtros

Use estes ao exportar para restringir o conjunto de resultados:

Id — ID exato do pedido.
Name — Número do pedido do Shopify (por exemplo, #1001).
CreatedAt — Data / intervalo de criação.
ProcessedAt — Data / intervalo de processamento do pagamento.
UpdatedAt — Data / intervalo da última alteração.
ClosedAt — Data / intervalo de fechamento do pedido.
CancelledAt — Data / intervalo de cancelamento.
CancelReason — Motivo do cancelamento (CUSTOMER, INVENTORY, …).
FinancialStatus — PENDING, PAID, PARTIALLY_PAID, REFUNDED, …
DisplayFinancialStatus — Status financeiro agregado para UI.
FulfillmentStatus — UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, …
DisplayFulfillmentStatus — Status de cumprimento agregado para UI.
OrderFulfillmentStatus — Filtro de status de envio (scheduled, in_progress, …).
ReturnStatus — NONE, PARTIALLY_RETURNED, RETURNED.
RiskLevel — LOW, MEDIUM, HIGH risco de fraude.
RiskRecommendation — ACCEPT, INVESTIGATE, CANCEL.
ChargebackStatus — NONE, UNDER_REVIEW, WON, LOST.
Gateway — Nome do gateway de pagamento (PayPal, Shopify Payments, …).
PaymentId — Identificador de pagamento específico.
PaymentProviderId — ID de pagamento do lado do provedor.
CreditCardLast4 — Últimos quatro dígitos do cartão.
TransactionKind — AUTHORIZATION, CAPTURE, REFUND, …
TransactionStatus — SUCCESS, FAILURE, PENDING.
Test — true / false - apenas pedidos de teste.
Channel — POS, Loja Online, Rascunho, etc.
ChannelId — ID interno do canal de vendas.
SalesChannel — Nome do canal legível por humanos (Shop App, IG Shop, …).
SourceName — Tag de origem (web, pos, api, draft_order).
SourceIdentifier — ID de pedido externo do POS / terceiro.
CheckoutToken — Token da sessão de checkout.
CartToken — ID do carrinho vinculado ao pedido.
DeliveryMethod — SHIPPING, LOCAL_PICKUP, LOCAL_DELIVERY.
FulfillmentLocationId — Local que cumpriu o pedido.
ReferenceLocationId — Referência de localização do POS / origem.
LocationId — Local da loja onde o pedido foi criado.
PoNumber — Número de referência do pedido de compra.
ConfirmationNumber — Número de confirmação / recibo externo.
Sku — Pedidos contendo um SKU específico.
SubtotalLineItemsQuantity — Quantidade total de itens (suporta intervalos).
DiscountCode — Pedidos que usaram um código de desconto específico.
Tag — Pedidos marcados com uma tag específica.
Email — Correspondência de email do cliente.
Phone — Correspondência de telefone do cliente.
CustomerId — Todos os pedidos de um cliente.
CustomerState — ENABLED, INVITED, DECLINED, DISABLED.
CompanyId — ID da empresa B2B.
FraudProtectionLevel — NOT_PROTECTED ou PROTECTED.
Status — OPEN, CLOSED, CANCELLED.
CartToken — Filtrar por token de carrinho original.
ChargebackStatus — Estado de chargeback do pedido.
lastVisitUtmMedium — Meio UTM capturado na compra.

Precisa de ajuda? Nossa equipe de suporte responde em até 24 horas.

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

discountCodes — Códigos de desconto aplicados ao pedido.
note — Nota interna sobre o pedido.
customAttributes — Atributos personalizados para o pedido em formato JSON.
retailLocationId — ID do local de varejo associado ao pedido.
isTest — Indica se o pedido é um pedido de teste.
refundOnCancellation — Se deve reembolsar o pedido ao cancelá-lo.
storeCreditRefundExpiration — Data de expiração para reembolsos de crédito na loja.
restockOnCancellation — Se deve reabastecer itens ao cancelar o pedido.
sourceUrl — URL de onde o pedido se originou.
lastVisitReferrerUrl — URL do último referenciador antes de o pedido ser feito.
inventoryBehaviour — Comportamento do inventário para o pedido.
sendFulfillmentReceipt — Se deve enviar um recibo de cumprimento ao cliente.
sendReceipt — Se deve enviar um recibo de pedido ao cliente.
notifyCustomerOnUpdate — Notificar o cliente quando o pedido for atualizado.
updateOrderStaffNote — Nota da equipe para atualizar no pedido.
freeShippingDiscountCode — Código de desconto para frete grátis.
fixedDiscountShopAmount — Valor fixo de desconto na moeda da loja.
fixedDiscountPresentmentAmount — Valor fixo de desconto na moeda de apresentação.
fixedDiscountCode — Código de desconto para um desconto de valor fixo.
percentageDiscountCode — Código de desconto para um desconto percentual.
percentageDiscountCodePercentage — Valor percentual do código de desconto.
orderFulfillmentLocationId — ID do local de cumprimento do pedido.
orderFulfillmentShipmentStatus — Status de envio do cumprimento do pedido.
orderFulfillmentNotifyCustomer — Notificar o cliente sobre o cumprimento do pedido.
orderFulfillmentTrackingCompany — Empresa de rastreamento para cumprimento do pedido.
orderFulfillmentTrackingNumber — Número de rastreamento para cumprimento do pedido.
customerEmail — Endereço de email do cliente.
customerFirstName — Primeiro nome do cliente.
customerLastName — Sobrenome do cliente.
customerNote — Nota do cliente.
customerPhone — Número de telefone do cliente.
customerTaxExempt — Indica se o cliente é isento de impostos.
billingFirstName — Primeiro nome para faturamento.
billingLastName — Sobrenome para faturamento.
billingName — Nome completo para faturamento.
billingCompany — Nome da empresa para faturamento.
billingPhone — Número de telefone para faturamento.
billingAddress1 — Primeira linha do endereço de faturamento.
billingAddress2 — Segunda linha do endereço de faturamento.
billingCity — Cidade para faturamento.
billingCountry — País para faturamento.
billingCountryCode — Código do país para faturamento.
billingZip — Código postal para faturamento.
billingProvince — Província para faturamento.
billingProvinceCode — Código da província para faturamento.
shippingFirstName — Primeiro nome para envio.
shippingLastName — Sobrenome para envio.
shippingName — Nome completo para envio.
shippingCompany — Nome da empresa para envio.
shippingPhone — Número de telefone para envio.
shippingAddress1 — Primeira linha do endereço de envio.
shippingAddress2 — Segunda linha do endereço de envio.
shippingCountryCode — Código do país para envio.
shippingZip — Código postal para envio.
shippingProvinceCode — Código da província para envio.
lineItemId — ID do item de linha.
lineItemTaxable — Indica se o item de linha é tributável.
lineItemTitle — Título do item de linha.
lineItemVariantBarcode — Código de barras do variant do item de linha.
lineItemVariantTitle — Título do variant do item de linha.
lineItemVendor — Fornecedor do item de linha.
lineItemUnitPrice — Preço unitário do item de linha.
lineItemUnitPresentmentPrice — Preço de apresentação da unidade do item de linha.
lineItemIsGiftCard — Indica se o item de linha é um cartão-presente.
lineItemRequiresShipping — Indica se o item de linha requer envio.
lineItemProductId — ID do produto do item de linha.
lineItemCustomAttributes — Atributos personalizados para o item de linha em formato JSON.
lineItemLocationId — ID do local para o item de linha.
LineItemQuantityRestock — Quantidade de reabastecimento para o item de linha.
LineItemAllowDuplicates — Permitir itens de linha duplicados.
fulfillmentId — ID do cumprimento.
fulfillmentTrackingUrls — URLs de rastreamento para o cumprimento.
fulfillmentAddress1 — Primeira linha do endereço de cumprimento.
fulfillmentAddress2 — Segunda linha do endereço de cumprimento.
fulfillmentCity — Cidade para cumprimento.
fulfillmentCountryCode — Código do país para cumprimento.
fulfillmentProvince — Província para cumprimento.
fulfillmentProvinceCode — Código da província para cumprimento.
fulfillmentZip — Código postal para cumprimento.
fulfillmentMessage — Mensagem para o cumprimento.
shippingLineId — ID da linha de envio.
shippingLineCode — Código da linha de envio.
transactionId — ID da transação.
transactionPresentmentAmount — Valor de apresentação da transação.
transactionAuthorizationCode — Código de autorização para a transação.
transactionGateway — Gateway de pagamento para a transação.
transactionTest — Indica se a transação é um teste.
transactionParentTransactionId — ID da transação pai.
transactionGiftCardId — ID do cartão-presente usado na transação.
transactionReceiptJson — Recibo da transação em formato JSON.
refundNote — Nota para o reembolso.
refundDiscrepancyReason — Motivo da discrepância do reembolso.
refundNotifyCustomer — Notificar o cliente sobre o reembolso.
refundFullShippingAmount — Reembolsar o valor total do envio.
refundShippingPresentmentAmount — Valor de apresentação para reembolso de envio.
lineType — Tipo de item de linha.
taxLines — Linhas de impostos associadas ao pedido.