InícioComércio eletrônico global Relatórios e analytics 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ório↕	Descrição↕	Casos de uso↕
Resumo do pagamento	Estruturado 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 pagamento	Estruturado 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 fatura	Estruturado 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 fatura	Estruturado 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.
Pedidos	Exibe 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 item	Lista 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 Cost	Audite 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

Estrutura

↕	Resumo do pagamento↕	Detalhes do pagamento↕	Pedidos↕	Pedidos com detalhes do item↕	Detalhamento 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 pagamento↕	Detalhes do pagamento↕	Pedidos↕	Pedidos com detalhes do item↕	Detalhamento 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:

Campo↕	Resumo do pagamento↕	Detalhes do pagamento↕	Pedidos↕	Pedidos com detalhes do item↕	Detalhamento 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:

Campo↕	Definição↕
`accountName`	Nome da conta com Zonos.
`orderAdditionalTarriffLines`	Taxa de despachante aduaneiro pelo trabalho adicional necessário para gerenciar e declarar múltiplos códigos tarifários (HS) na entrada alfandegária.
`addressLine1`	Primeira linha do endereço do destinatário.
`addressLine2`	Segunda linha do endereço do destinatário, se aplicável.
`advancement`	Taxa cobrada pelo adiantamento de taxas e impostos em nome do cliente.
`amount`	Valor monetário do item de linha ou encargo.
`amountDiscount`	Valor do desconto para o pedido.
`amountDutiesTaxesFees`	Quantidade de direitos, impostos e taxas aplicadas ao pedido.
`amountItem`	Valor para um único item.
`amountShipping`	Quantidade de frete em um pedido.
`amountTotal`	Valor de um único item multiplicado pela quantidade do item.
`arrivalDate`	Data em que o pagamento chegou à conta bancária do comerciante.
`brokerage`	Taxa de corretagem associada ao desembaraço aduaneiro.
`city`	Cidade do endereço do destinatário.
`country`	Código ISO do país de destino com duas letras.
`countryOfOrigin`	País onde o item foi fabricado ou produzido.
`countryOfOriginSource`	Fonte da informação do país de origem.
`currency`	Moeda utilizada para a transação, no formato ISO de 3 letras.
`customerName`	Nome do cliente que faz o pedido.
`customsDescription`	Descrição do item utilizado nas declarações aduaneiras.
`description`	Descrição do produto.
`detailType`	Motivo detalhado do valor do pedido (por exemplo, imposto, taxa de corretagem, taxa de conversão de moeda, taxa de processamento do comerciante, etc.)
`dimensionsUnit`	Unidade de medida (por exemplo, polegadas, cm).
`discountOrder`	Desconto aplicado ao pedido.
`dutyOrder`	Valor do imposto aplicado ao pedido.
`dutyTaxFeeOrder`	Valor total de taxas, impostos e taxas aplicadas ao pedido.
`fx`	Taxa de câmbio aplicada à transação.
`guarantee`	Valor garantido por Zonos.
`height`	Altura do item.
`hsCode`	Código do Sistema Harmonizado (HS) atribuído ao item.
`hsCodeSource`	Fonte da classificação do código HS.
`itemWeight`	Peso do item no pedido.
`itemWeightUnit`	Unidade de medida do peso do item (por exemplo, kg, lb).
`itemOrder`	Custo dos itens do pedido.
`landedCostGuarantee`	Custo do serviço de garantia de Landed Cost (inclui componentes de preços em $ e %).
`length`	Comprimento do item.
`merchantAdjustment`	Ajustes que o lojista inseriu/solicitou, normalmente por meio de regras.
`merchantSet`	Quaisquer buffers/ajustes definidos pelo comerciante.
`merchantFee`	Parcela do custo Checkout atribuída aos custos de processamento de pagamentos.
`memo`	Notas ou detalhes adicionais sobre o pagamento ou transação.
`name`	Nome do produto.
`orderDate`	Data em que o pedido foi feito, em UTC.
`orderDuty`	Valor do imposto para o pedido.
`orderFeeAdvancement`	Taxas de adiantamento do pedido.
`orderFeeBrokerage`	Taxas de corretagem para o pedido.
`orderFeeCarrier`	Taxas da transportadora para o pedido.
`orderFeeShopper`	Taxas cobradas do comprador.
`OrderFx`	Taxa de câmbio aplicada à transação.
`orderNumber`	Identificador exclusivo do pedido no sistema da Zonos.
`orderReference`	Número de referência adicional associado ao pedido, normalmente o número do pedido na plataforma de comércio eletrônico.
`orderStatus`	Status atual do pedido.
`orderTax`	Valor do imposto do pedido.
`orderTotal`	Valor total do pedido.
`other`	Encargos ou ajustes diversos relacionados à transação.
`otherCarrierFee`	Taxas adicionais cobradas pela transportadora, incluindo taxas de pré-pagamento (que a transportadora envia na fatura de remessa).
`packageWeight`	Peso total do pacote.
`packageWeightUnit`	Unidade de medida do peso da embalagem.
`payoutDate`	Data em que o pagamento foi emitido ao comerciante.
`payee`	Entidade que recebe o pagamento.
`payor`	Entidade responsável pela realização do pagamento.
`payoutNumber`	Corresponde ao ID de pagamento do Stripe.
`payoutTotal`	Valor total pago ao comerciante.
`postalCode`	Código postal ou CEP do endereço do destinatário.
`processing`	Método esperado para processar o pagamento alfandegário: `TAX_REMITTANCE` (remeter via identificação fiscal) ou `CUSTOMS_BILL` (pagar uma fatura alfandegária).
`productId`	Identificador exclusivo do produto.
`quantity`	Número de unidades do item no pedido.
`referenceNumber`	Faz referência ao número do pagamento (por exemplo, `po_1QcGXkGbPRfOWRJBfaa90A1A`) ou ao número da fatura (por exemplo, `584184EA-0000`).
`settled`	O valor da transação liquidada para o comerciante.
`shippingOrder`	Custo de envio do pedido.
`shippingService`	Método de envio ou serviço utilizado para entrega.
`sku`	Unidade de manutenção de estoque (SKU) do produto.
`state`	Estado ou região do endereço do destinatário.
`taxOrder`	Valor do imposto aplicado ao pedido.
`total`	O total do pedido (o total que o comprador pagou).
`totalItems`	O número total de itens no pedido.
`totalItemWeight`	Peso total de todos os itens do pedido.
`trackingNumber`	Número de rastreamento da remessa.
`transactionDate`	Data em que a transação foi registrada, em UTC.
`transactionFee`	Inclui custo para serviços Checkout, incluindo proteção contra fraude. Não inclui custos de processamento de pagamentos.
`transactionId`	Identificador exclusivo da transação.
`transactionType`	Tipos 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.
`weightUnit`	Unidade de medida para valores de peso.
`width`	Largura do item.

Casos de uso

Reconcilie pagamentos / Combine um único pagamento com seu extrato bancário

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).

Vá para Dashboard → Pagamentos.
Selecione o pagamento.
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.

Revise um pedido reembolsado

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

Vá para Dashboard → Relatórios.
Clique em Gerar ao lado do relatório Resumo de pagamentos.
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.
Clique em Gerar relatório.
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)↕
1234	`ORDER`	105.80	80.76	58.96	-58.96	-7.38	-9.88	169.30
1234	`ORDER_REFUND` (would show `ORDER_CANCEL` if this order had not shipped)	-105.80	-80.76	-58.96	58.96	7.37		-179.20

Neste exemplo:

O comerciante está usando a garantia Landed Cost da Zonos (valores na coluna Q, guarantee).
No momento do pedido, o comerciante recebeu o pagamento de itemOrder e shippingOrder menos as taxas da 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 a Zonos ainda será cobrada pela taxa do comerciante pelo provedor de pagamento.
- Direitos, 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.

Descubra quanto Zonos foi retido versus quanto você ganhou no pedido

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:

Vá para Dashboard → Relatórios.
Clique em Gerar ao lado do relatório Detalhes do pagamento.
Selecione seu período preferido.
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)↕
0123	ITEM	MERCHANT	SHOPPER	96.85
0123	SHIPPING	MERCHANT	SHOPPER	30.63
0123	MERCHANT_PROCESSING	ZONOS	MERCHANT	-6.72
0123	TRANSACTION_PERCENT	ZONOS	MERCHANT	-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).

Visualize dados trimestrais (pagamentos dentro de um determinado período)

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:

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

Verifique se os pedidos em Dashboard correspondem aos da plataforma de comércio eletrônico

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:

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.
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.

Cálculos de Landed Cost de auditoria

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:

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

Agendar uma demonstração