DOCS

Para usuários do Checkout

Relatórios para download para usuários Checkout

Saiba como obter os dados necessários a partir de relatórios para download.

Os relatórios para download fornecem aos comerciantes Checkout os dados necessários para reconciliação e análise. Esses relatórios, disponíveis em dólares americanos e personalizáveis ​​por intervalo de datas, oferecem suporte a casos de uso comuns, como declaração de impostos, verificação de pedidos, análise de cobranças e obtenção de insights de negócios. A data e hora de todos os relatórios estão em UTC.

Tipos de relatórios 

Existem vários relatórios disponíveis:

RelatórioDescriçãoCasos de uso
Resumo do pagamentoEstruturado da mesma forma que o relatório Payout summary disponível para cada pagamento, mas com seleção de intervalo de datas. A versão legada também está disponível até 31 de julho de 2025 para que você possa atualizar qualquer mapeamento que faça referência a este relatório.Analise os pedidos em seus pagamentos em alto nível, com cada pedido em sua própria linha. Veja taxas de transação e comerciante.
Detalhes do pagamentoEstruturado da mesma forma que o relatório Payout detail disponível para cada pagamento, mas com seleção de intervalo de datas. A versão legada também está disponível até 31 de julho de 2025 para que você possa atualizar qualquer mapeamento que faça referência a este relatório.Veja o detalhamento do seu pagamento, incluindo o que foi retido antes de o pagamento ser enviado para sua conta bancária.
Resumo da faturaEstruturado da mesma forma que o relatório Invoice summary disponível para cada fatura, mas com intervalo de datas.Veja um resumo das cobranças que lhe foram faturadas.
Detalhes da faturaEstruturado da mesma forma que o relatório Invoice detail disponível para cada fatura, mas com intervalo de datas. Cada cobrança individual tem sua própria linha no CSV.Veja o detalhamento de todas as cobranças faturadas.
PedidosExibe todas as informações importantes sobre um pedido, sem entrar em detalhes detalhados.Analise pedidos para prever vendas, descobrir tendências geográficas e identificar padrões sazonais.
Pedidos com detalhes do itemLista todos os itens de um pedido (cada item em sua própria linha). Inclui informações do item, como quantidade, sku, dimensões, código HS, etc.Analise pedidos para determinar quais produtos vendem melhor em cada país.
Detalhamento do Landed CostAudite os cálculos dos Landed Cost com detalhamentos de impostos, taxas e taxas.Declaração periódica de impostos, auditoria de cálculos de Landed Cost.
Exportar um relatório
  1. Vá para Dashboard -> Reports
  2. Passe o mouse sobre o relatório desejado e clique em Gerar.
  3. Selecione seu período preferido.
  4. Clique em Gerar relatório.
Estrutura
Resumo do pagamentoDetalhes do pagamentoPedidosPedidos com detalhes do itemDetalhamento do Landed Cost
Cada pedido tem sua própria linha
Cada cobrança do pedido tem sua própria linha
Informações disponíveis (resumidas)
Resumo do pagamentoDetalhes do pagamentoPedidosPedidos com detalhes do itemDetalhamento do Landed Cost
Informações do cliente e número de rastreamento
Informações de pagamento
Taxas de transação e taxas de comerciante
Detalhes de deveres, impostos e taxas
Detalhes do item (nome, SKU, código HS, etc.)
Contagem e peso dos itens do pedido
Todos os campos disponíveis

Abaixo estão os campos disponíveis em cada relatório:

CampoResumo do pagamentoDetalhes do pagamentoPedidosPedidos com detalhes do itemDetalhamento do Landed Cost
accountName
orderAdditionalTariffLines
addressLine1
addressLine2
amount
amountDiscount
amountDutiesTaxesFees
amountItem
amountShipping
amountTotal
arrivalDate
brokerage
city
country
countryCode
countryOfOrigin
countryOfOriginSource
currency
currencyCode
customerName
customsDescription
description
detailType
dimensionsUnit
discountOrder
dutyOrder
dutyTaxFeeOrder
fx
guarantee
height
hsCode
hsCodeSource
itemWeight
itemWeightUnit
itemOrder
landedCostGuarantee
length
merchantAdjustment
merchantSet
merchantFee
memo
name
orderDate
orderDuty
orderFeeAdvancement
orderFeeBrokerage
orderFeeCarrier
orderFeeShopper
orderFx
orderNumber
orderReference
orderStatus
orderTax
orderTotal
other
otherCarrierFee
packageWeight
packageWeightUnit
payee
payor
payoutDate
payoutNumber
payoutTotal
postalCode
processing
productId
quantity
referenceNumber
settled
shippingOrder
shippingService
sku
state
taxOrder
total
totalItems
totalItemWeight
trackingNumber
transactionDate
transactionFee
transactionId
transactionType
weightUnit
width
Definições de campo

Abaixo estão as definições de cada campo nos relatórios:

CampoDefinição
accountNameNome da conta com Zonos.
orderAdditionalTarriffLinesTaxa de despachante aduaneiro pelo trabalho adicional necessário para gerenciar e declarar múltiplos códigos tarifários (HS) na entrada alfandegária.
addressLine1Primeira linha do endereço do destinatário.
addressLine2Segunda linha do endereço do destinatário, se aplicável.
advancementTaxa cobrada pelo adiantamento de taxas e impostos em nome do cliente.
amountValor monetário do item de linha ou encargo.
amountDiscountValor do desconto para o pedido.
amountDutiesTaxesFeesQuantidade de direitos, impostos e taxas aplicadas ao pedido.
amountItemValor para um único item.
amountShippingQuantidade de frete em um pedido.
amountTotalValor de um único item multiplicado pela quantidade do item.
arrivalDateData em que o pagamento chegou à conta bancária do comerciante.
brokerageTaxa de corretagem associada ao desembaraço aduaneiro.
cityCidade do endereço do destinatário.
countryCódigo ISO do país de destino com duas letras.
countryOfOriginPaís onde o item foi fabricado ou produzido.
countryOfOriginSourceFonte da informação do país de origem.
currencyMoeda utilizada para a transação, no formato ISO de 3 letras.
customerNameNome do cliente que faz o pedido.
customsDescriptionDescrição do item utilizado nas declarações aduaneiras.
descriptionDescrição do produto.
detailTypeMotivo detalhado do valor do pedido (por exemplo, imposto, taxa de corretagem, taxa de conversão de moeda, taxa de processamento do comerciante, etc.)
dimensionsUnitUnidade de medida (por exemplo, polegadas, cm).
discountOrderDesconto aplicado ao pedido.
dutyOrderValor do imposto aplicado ao pedido.
dutyTaxFeeOrderValor total de taxas, impostos e taxas aplicadas ao pedido.
fxTaxa de câmbio aplicada à transação.
guaranteeValor garantido por Zonos.
heightAltura do item.
hsCodeCódigo do Sistema Harmonizado (HS) atribuído ao item.
hsCodeSourceFonte da classificação do código HS.
itemWeightPeso do item no pedido.
itemWeightUnitUnidade de medida do peso do item (por exemplo, kg, lb).
itemOrderCusto dos itens do pedido.
landedCostGuaranteeCusto do serviço de garantia de Landed Cost (inclui componentes de preços em $ e %).
lengthComprimento do item.
merchantAdjustmentAjustes que o lojista inseriu/solicitou, normalmente por meio de regras.
merchantSetQuaisquer buffers/ajustes definidos pelo comerciante.
merchantFeeParcela do custo Checkout atribuída aos custos de processamento de pagamentos.
memoNotas ou detalhes adicionais sobre o pagamento ou transação.
nameNome do produto.
orderDateData em que o pedido foi feito, em UTC.
orderDutyValor do imposto para o pedido.
orderFeeAdvancementTaxas de adiantamento do pedido.
orderFeeBrokerageTaxas de corretagem para o pedido.
orderFeeCarrierTaxas da transportadora para o pedido.
orderFeeShopperTaxas cobradas do comprador.
OrderFxTaxa de câmbio aplicada à transação.
orderNumberIdentificador exclusivo do pedido no sistema Zonos'.
orderReferenceNúmero de referência adicional associado ao pedido, normalmente o número do pedido na plataforma de comércio eletrônico.
orderStatusStatus atual do pedido.
orderTaxValor do imposto do pedido.
orderTotalValor total do pedido.
otherEncargos ou ajustes diversos relacionados à transação.
otherCarrierFeeTaxas adicionais cobradas pela transportadora, incluindo taxas de pré-pagamento (que a transportadora envia na fatura de remessa).
packageWeightPeso total do pacote.
packageWeightUnitUnidade de medida do peso da embalagem.
payoutDateData em que o pagamento foi emitido ao comerciante.
payeeEntidade que recebe o pagamento.
payorEntidade responsável pela realização do pagamento.
payoutNumberCorresponde ao ID de pagamento do Stripe.
payoutTotalValor total pago ao comerciante.
postalCodeCódigo postal ou CEP do endereço do destinatário.
processingMétodo esperado para processar o pagamento alfandegário: TAX_REMITTANCE (remeter via identificação fiscal) ou CUSTOMS_BILL (pagar uma fatura alfandegária).
productIdIdentificador exclusivo do produto.
quantityNúmero de unidades do item no pedido.
referenceNumberFaz referência ao número do pagamento (por exemplo, po_1QcGXkGbPRfOWRJBfaa90A1A) ou ao número da fatura (por exemplo, 584184EA-0000).
settledO valor da transação liquidada para o comerciante.
shippingOrderCusto de envio do pedido.
shippingServiceMétodo de envio ou serviço utilizado para entrega.
skuUnidade de manutenção de estoque (SKU) do produto.
stateEstado ou região do endereço do destinatário.
taxOrderValor do imposto aplicado ao pedido.
totalO total do pedido (o total que o comprador pagou).
totalItemsO número total de itens no pedido.
totalItemWeightPeso total de todos os itens do pedido.
trackingNumberNúmero de rastreamento da remessa.
transactionDateData em que a transação foi registrada, em UTC.
transactionFeeInclui custo para serviços Checkout, incluindo proteção contra fraude. Não inclui custos de processamento de pagamentos.
transactionIdIdentificador exclusivo da transação.
transactionTypeTipos possíveis: ORDER, ORDER_REFUND, ORDER_CANCEL, CHARGE ou CREDIT. As faturas têm outro tipo, STRIPE, que está relacionado a custos de assinatura, taxas de plataforma ou créditos CTP.
weightUnitUnidade de medida para valores de peso.
widthLargura do item.

Qualquer um dos relatórios de pagamento pode ser usado para conciliar com seu extrato bancário. É mais fácil baixá-los na página Pagamentos, para que contenham exatamente os pedidos vinculados a esse pagamento (em vez da página Relatórios, onde você seleciona o intervalo de datas).

  1. Vá para Dashboard → Pagamentos.
  2. Selecione o pagamento.
  3. Clique em Exportar transações no canto superior direito e escolha Resumo do pagamento ou Detalhes do pagamento no menu suspenso.

A soma da coluna settled no Resumo do pagamento e nos Detalhes do pagamento corresponderá ao valor total do pagamento mostrado em Dashboard.

Use o relatório de resumo de pagamentos para visualizar seu pedido e seu reembolso.

  1. Vá para Dashboard → Relatórios.
  2. Clique em Gerar ao lado do relatório Resumo de pagamentos.
  3. Selecione seu período preferido. Certifique-se de que o intervalo de datas inclua a data do pedido e a data do reembolso para obter uma visão completa.
  4. Clique em Gerar relatório.
  5. Filtre o relatório do pedido em questão.

Exemplo 

Vejamos um pedido como exemplo. Aqui está um instantâneo de um download em CSV do relatório Resumo de pagamentos, filtrado para o pedido 1234, onde um reembolso total foi emitido.

orderNumber (I)transactionType (L)itemOrder (M)shippingOrder (N)dutyTaxFeeOrder (P)guarantee (Q)transactionFee (R)merchantFee (S)settled (U)
1234ORDER105.8080.7658.96-58.96-7.38-9.88169.30
1234ORDER_REFUND (would show ORDER_CANCEL if this order had not shipped)-105.80-80.76-58.9658.967.37-179.20

Neste exemplo:

  • O comerciante está usando a garantia Zonos' Landed Cost (valores na coluna Q, guarantee).
  • No momento do pedido, o comerciante recebeu o pagamento de itemOrder e shippingOrder menos taxas de Zonos' (transactionFee e merchantFee). Este valor, a soma das colunas M a T, corresponde ao valor settled na coluna U.
    • Direitos, impostos e taxas (dutyTaxFeeOrder) foram cobrados, mas como o comerciante optou por Zonos para lidar com eles, Zonos mantém esses fundos e paga a alfândega diretamente. Como resultado, dutyTaxFeeOrder e guarantee cancelam-se (resultado em 0).
  • Quando o pedido foi reembolsado, Zonos reembolsou o comprador e retirou os valores itemOrder e shippingOrder do comerciante. Zonos também reembolsou o transactionFee, mas manteve o merchantFee, uma vez que os zonanos ainda serão cobrados pela taxa do comerciante pelo provedor de pagamento.
    • Impostos, impostos e taxas ainda não são de responsabilidade do comerciante, por isso não aparecem neste relatório. Zonos os reembolsou ao comprador com base na solicitação de reembolso do comerciante, mas como esse reembolso foi Zonos → comprador, não está refletido aqui.

O relatório Detalhes do pagamento pode ser usado para descobrir quanto você está pagando para Zonos em comparação com quanto seus clientes estão pagando. No entanto, a forma como você interpreta o relatório depende se você usa nossa garantia Landed Cost. Escolha se você faz ou não abaixo.

Por padrão, os compradores pagam pela garantia do Landed Cost, enquanto os comerciantes pagam pelo custo dos serviços de checkout (como processamento de pagamentos e proteção contra fraudes). O relatório Detalhes do pagamento registra quem pagou por cada parte do pedido.

Para saber quanto você e seu comprador pagaram, primeiro baixe o relatório:

  1. Vá para Dashboard → Relatórios.
  2. Clique em Gerar ao lado do relatório Detalhes do pagamento.
  3. Selecione seu período preferido.
  4. Clique em Gerar relatório.

No relatório, filtre de acordo com o que deseja saber:

  • Para saber quanto seu comprador pagou pelo pedido, filtre o Pagador (coluna O) para SHOPPER e o Beneficiário (coluna N) para MERCHANT. Isso não incluirá custos de repasse, como taxas e impostos.
  • Para saber quanto você pagou do próprio bolso para Zonos, filtre o Pagador (coluna O) para MERCHANT e o Beneficiário (coluna N) para ZONOS. Some esses valores.
  • Para saber quanto você ganhou no pedido, some todas as linhas do pedido (isso corresponderá à diferença dos dois totais acima).

Exemplo

Vejamos um pedido como exemplo. Aqui está um instantâneo de um download CSV do relatório Detalhes do pagamento, analisando todas as linhas pertencentes a um único pedido, 0123.

orderNumber (I)detailType (M)payee (N)payor (O)amount (P, all in USD)
0123ITEMCOMERCIANTECOMPRADOR96.85
0123ENVIOCOMERCIANTECOMPRADOR30.63
0123MERCHANT_PROCESSINGZONOSCOMERCIANTE-6.72
0123TRANSACTION_PERCENTZONOSCOMERCIANTE-4.94

Para entender esse detalhe, vamos agrupá-lo em ganhos e taxas.

Ganhos: Zonos recolheu esses custos do comprador e depois os pagou ao comerciante.

  • O subtotal do item, neste caso, US$ 96,85 (ITEM).
  • O custo do frete, $ 30,63 (SHIPPING).

Taxas: Zonos coleta esses custos do comerciante – eles não estão incluídos no valor que o comprador pagou na finalização da compra.

  • Uma taxa de processamento comercial de US$ 6,72 (MERCHANT_PROCESSING).
  • Uma taxa de transação de US$ 4,94 (TRANSACTION_PERCENT).

Os relatórios de pagamento estão disponíveis para cada pagamento; no entanto, você pode querer reconciliar todos os pagamentos do último trimestre, por exemplo. Em vez de baixar vários relatórios de pagamento, você pode facilmente baixar um relatório com o intervalo de datas desejado.

Para fazer download dos relatórios CSV Resumo do pagamento ou Detalhes do pagamento, para qualquer período:

  1. Vá para Dashboard → Relatórios.
  2. Clique em Gerar ao lado do relatório desejado.
  3. Selecione o intervalo de datas que começa no início do trimestre e termina no final do trimestre.
  4. Clique em Gerar relatório.

Se você fez uma alteração recentemente, pode querer confirmar se todos os pedidos no Zonos Dashboard também aparecem na sua plataforma de comércio eletrônico. Para fazer isso:

  1. Baixe o relatório CSV de Pedidos.
    1. Vá para Dashboard → Relatórios.
    2. Clique em Gerar ao lado do relatório Pedidos.
    3. Selecione o intervalo de datas que deseja verificar.
    4. Clique em Gerar relatório.
  2. Compare esses pedidos com o que você vê na sua plataforma de comércio eletrônico.

Entre em contato com nossa equipe de suporte se tiver algum problema com seus pedidos.

Use o relatório Landed Cost Detalhamento para explorar os detalhes de nossos cálculos de custo no destino sem lidar com tabelas verticais. Este relatório mostra cada custo individual que contribui para o custo total no destino de um pedido, com cada componente listado em sua própria coluna.

Para baixar o relatório Landed cost de detalhamento:

  1. Vá para Dashboard → Relatórios.
  2. Clique em Gerar ao lado do relatório Landed cost detalhamento.
  3. Selecione o intervalo de datas que corresponde ao da fatura da operadora.
  4. Clique em Gerar relatório.

Esta página foi útil?