Pedidos Rascunho

Um Pedido Rascunho é um pedido que um comerciante cria para um cliente antes do pagamento.
Casos de uso com o DataEase:

Vendas por telefone ou chat – crie e envie um link de checkout por e-mail.
Ofertas de atacado ou pré-venda – adicione preços e itens personalizados.
Recrie pedidos ou faça cotações rápidas em massa.

Guia de pedidos rascunho do Shopify aqui.

2. Exportar

Escolha CSV (melhor para muitos itens de linha) ou Excel.
Selecione DraftOrder como a entidade.
Selecione colunas como tags, lineItemVariantId, customerEmail.
Execute a tarefa e baixe seu arquivo.

Detalhes: Guia de Exportação

3. Importar

Comandos

Comando de linha de pedido rascunho: CREATE, UPDATE, REPLACE, DELETE, IGNORE
Comando de item de linha: CREATE, UPDATE, MERGE, DELETE, IGNORE
Ação (opcional): COMPLETE, DUPLICATE, SEND_INVOICE

Regras

Pelo menos email ou phone (ou customerId) é necessário para CREATE.
A primeira linha (topRow = TRUE) é o cabeçalho do pedido; as linhas seguintes adicionam itens/endereços.
UPDATE ignora células em branco; REPLACE sobrescreve apenas com as colunas fornecidas.
Apenas uma ação por execução de importação.

Passos

Baixe o exemplo: DraftOrder-import-sample.xlsx
Edite a linha de cabeçalho e adicione linhas de itens.
Mapeie colunas no DataEase, faça o upload e inicie.

Ajuda completa: Guia de Importação

4. Referência de Campos

Abaixo você verá todas as colunas que pode usar. “Apenas importação” significa que o valor pode ser carregado, mas não é retornado na exportação.

Campos gerais do pedido

id — ID do pedido rascunho. Necessário para UPDATE, REPLACE, DELETE.
command — Ação principal da linha (CREATE, UPDATE, etc.).
acceptAutomaticDiscounts — true permite que o Shopify aplique automaticamente descontos da loja.
allowDiscountCodesInCheckout — true permite que os clientes insiram códigos de desconto no checkout.
presentmentCurrencyCode — Moeda em que o cliente pagará.
discountCodes — Lista de códigos no pedido.
email — Email do cliente para fatura.
phone — Telefone do cliente.
note — Nota interna para o pedido.
tags — Lista de tags.
tagsCommand — ADD, REMOVE ou REPLACE tags.
poNumber — Número do pedido de compra.
customAttributes — Informações meta de chave-valor mostradas ao cliente.
reserveInventoryUntil — Data ISO quando o estoque reservado é liberado.

Campos de item de linha (topRow = FALSE com valores de item)

lineItemUuid — ID único para a linha; obrigatório ao usar pacotes.
itemCommand — CREATE, UPDATE, MERGE, DELETE, IGNORE para esta linha.
lineItemVariantId — ID da variante (deixe em branco para item personalizado).
lineItemTitle — Título para item personalizado (ignorado se variantId estiver definido).
lineItemQuantity — Quantidade a ser adicionada.
lineItemOriginalUnitPrice — Preço antes dos descontos.
lineItemOriginalUnitPriceCurrency — Código da moeda de originalUnitPrice.
lineItemAppliedDiscountValue — Valor do desconto nesta linha.
lineItemAppliedDiscountValueType — FIXED_AMOUNT ou PERCENTAGE.

(campos semelhantes existem para peso, SKU, código de barras, etc.)

Link do cliente

customerId — ID do cliente existente. Se em branco, combine por email/telefone ou crie novo.
customerCompanyId — ID da empresa para pedidos B2B.

Endereços de cobrança e envio

billingAddress1 — Linha 1 do endereço de cobrança.
shippingAddress1 — Linha 1 do endereço de envio.

(cada endereço tem cidade correspondente, CEP, código da província, código do país, telefone, etc.)

Desconto no nível do pedido

appliedDiscountTitle — Nome do desconto personalizado do pedido.
appliedDiscountValue — Quantia do desconto (dinheiro ou porcentagem).
appliedDiscountValueType — FIXED_AMOUNT ou PERCENTAGE.

Linha de envio

shippingTitle — Título mostrado para o envio.
shippingLinePresentmentPrice — Custo de envio na moeda de apresentação.

Auxiliares apenas para importação

action — COMPLETE, DUPLICATE ou SEND_INVOICE após a importação das linhas. Apenas importação.
shippingLinePrice — Custo de envio na moeda da loja. Apenas importação.
useCustomerDefaultAddress — true para usar o endereço de cobrança/envio padrão do cliente. Apenas importação.

Metafields

metafields — Colunas de metafield personalizadas. Veja o Guia de Metafields.

5. Filtros

CreatedAt — Exporte pedidos rascunho criados em uma data ou intervalo.
CustomerId — Exporte rascunhos vinculados a um cliente.
Id — Exporte um único rascunho por ID.
Source — Filtre por fonte (API, POS, etc.).
Status — OPEN, INVOICE_SENT, COMPLETED.
Tag — Inclua rascunhos com tag correspondente.
UpdatedAt — Escolha o intervalo de data da última atualização.

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

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

currencyCode — Código da moeda para o pedido rascunho.
completedAt — Timestamp quando o pedido rascunho foi concluído.
name — Nome do pedido rascunho.
totalPrice — Preço total do pedido rascunho.
totalShippingPrice — Preço total de envio para o pedido rascunho.
totalWeight — Peso total do pedido rascunho.
totalTax — Total de impostos aplicados ao pedido rascunho.
subtotalPrice — Preço subtotal antes de impostos e descontos.
invoiceUrl — URL para a fatura do pedido rascunho.
invoiceSentAt — Timestamp quando a fatura foi enviada.
taxesIncluded — true se os impostos estão incluídos nos preços.
visibleToCustomer — true se o pedido rascunho é visível para o cliente.
warnings — Avisos relacionados ao pedido rascunho.
lineItemId — ID do item de linha no pedido rascunho.
lineItemName — Nome do item de linha.
lineItemOriginalTotal — Preço total original do item de linha.
lineItemTaxable — true se o item de linha é tributável.
lineItemTotalDiscount — Desconto total aplicado ao item de linha.
lineItemSku — SKU do item de linha.
lineItemVariantBarcode — Código de barras da variante do item de linha.
lineItemVariantTitle — Título da variante do item de linha.
lineItemVendor — Fornecedor do item de linha.
lineItemVariantPrice — Preço da variante do item de linha.
lineItemVariantProductTags — Tags do produto para a variante do item de linha.
lineItemVariantInventoryQuantity — Quantidade de inventário da variante do item de linha.
lineItemWeightUnit — Unidade de peso para o item de linha.
lineItemWeightValue — Valor do peso do item de linha.
lineItemIsGiftCard — true se o item de linha é um cartão-presente.
lineItemRequiresShipping — true se o item de linha requer envio.
lineItemProductId — ID do produto do item de linha.
lineItemProductHandle — Handle do produto do item de linha.
lineItemProductType — Tipo de produto do item de linha.
lineItemCustomAttributes — Atributos personalizados para o item de linha.
lineItemAppliedDiscountPresentmentAmount — Quantia de apresentação do desconto aplicado no item de linha.
lineItemAppliedDiscountShopAmount — Quantia da loja do desconto aplicado no item de linha.
lineItemAppliedDiscountDescription — Descrição do desconto aplicado no item de linha.
lineItemAppliedDiscountTitle — Título do desconto aplicado no item de linha.
customerEmail — Endereço de e-mail do cliente.
customerFirstName — Primeiro nome do cliente.
customerLastName — Último nome do cliente.
customerCreatedAt — Timestamp quando o cliente foi criado.
customerLocale — Localidade do cliente.
customerNote — Nota associada ao cliente.
customerPhone — Número de telefone do cliente.
customerNumberOfOrders — Número de pedidos feitos pelo cliente.
customerState — Estado do cliente.
customerAmountSpentAmount — Total gasto pelo cliente.
customerTags — Tags associadas ao cliente.
customerSmsMarketingConsent — true se o cliente consente com marketing por SMS.
customerEmailMarketingConsent — true se o cliente consente com marketing por e-mail.
customerTaxExempt — true se o cliente é isento de impostos.
customerCompanyName — Nome da empresa do cliente.
customerLocationId — ID da localização associada ao cliente.
customerContactId — ID de contato do cliente.
customerCompanyExternalId — ID externo da empresa do cliente.
billingName — Nome completo de cobrança.
billingFirstName — Primeiro nome para cobrança.
billingLastName — Último nome para cobrança.
billingCompany — Nome da empresa para cobrança.
billingPhone — Número de telefone para cobrança.
billingAddress2 — Segunda linha do endereço de cobrança.
billingCity — Cidade para cobrança.
billingCountry — País para cobrança.
billingCountryCode — Código do país para cobrança.
billingZip — CEP para cobrança.
billingProvince — Província para cobrança.
billingProvinceCode — Código da província para cobrança.
shippingName — Nome completo de envio.
shippingFirstName — Primeiro nome para envio.
shippingLastName — Último nome para envio.
shippingCompany — Nome da empresa para envio.
shippingPhone — Número de telefone para envio.
shippingAddress2 — Segunda linha do endereço de envio.
shippingCity — Cidade para envio.
shippingCountry — País para envio.
shippingCountryCode — Código do país para envio.
shippingZip — CEP para envio.
shippingProvince — Província para envio.
shippingProvinceCode — Código da província para envio.
appliedDiscountPresentmentAmount — Quantia de apresentação do desconto aplicado.
appliedDiscountShopAmount — Quantia da loja do desconto aplicado.
appliedDiscountDescription — Descrição do desconto aplicado.
shippingRateHandle — Handle para a taxa de envio.
taxLines — Linhas de impostos aplicadas ao pedido rascunho.