Tipos de relatórios
Existem vários relatórios disponíveis:
Relatório | Descrição | Casos de uso |
---|---|---|
Resumo de pagamento | Estruturado da mesma forma que o Resumo de pagamento disponível para cada pagamento, mas com uma 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 pedidos em seus pagamentos de forma geral, com cada pedido em sua própria linha. Veja taxas de transação e de comerciante. |
Detalhe do pagamento | Estruturado da mesma forma que o Detalhe do pagamento disponível para cada pagamento, mas com uma 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 a divisão do seu pagamento, incluindo o que foi retido antes que o pagamento fosse enviado para sua conta bancária. |
Resumo da fatura | Estruturado da mesma forma que o Resumo da fatura disponível para cada fatura, mas com um intervalo de datas. | Veja um resumo das cobranças que você recebeu na fatura. |
Detalhe da fatura | Estruturado da mesma forma que o Detalhe da fatura disponível para cada fatura, mas com um intervalo de datas. Cada cobrança individual tem sua própria linha no CSV. | Veja a divisão de todas as cobranças que você recebeu na fatura. |
Pedidos EM BREVE | Exibe todas as informações principais sobre um pedido, sem entrar em detalhes itemizados. | Analise pedidos para prever vendas, descobrir tendências geográficas e identificar padrões sazonais. |
Pedidos com detalhes dos itens EM BREVE | Lista todos os itens dentro 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. |
Landed Cost detalhamento EM BREVE | Exibe componentes de landed cost agrupados em categorias. | Declaração de impostos periódica, auditoria de cálculos de landed cost. |
- Vá para Dashboard -> Relatórios
- Passe o mouse sobre o relatório que você deseja e clique em Gerar.
- Selecione seu intervalo de datas preferido.
- Clique em Gerar relatório.
Resumo de pagamento | Detalhe do pagamento | Pedidos EM BREVE | Pedidos com detalhes dos itens EM BREVE | Landed cost detalhamento EM BREVE | |
---|---|---|---|---|---|
Cada pedido tem sua própria linha | |||||
Cada cobrança de pedido tem sua própria linha |
Resumo de pagamento | Detalhe do pagamento | Pedidos EM BREVE | Pedidos com detalhes dos itens EM BREVE | Detalhamento de Landed Cost EM BREVE | |
---|---|---|---|---|---|
Informações do cliente e número de rastreamento | |||||
Informações de pagamento | |||||
Taxas de transação e taxas do comerciante | |||||
Detalhes de impostos, taxas e encargos | |||||
Detalhes do item (Nome, SKU, código HS, etc.) | |||||
Contagem de itens do pedido e peso |
Abaixo estão os campos disponíveis em cada relatório:
Campo | Resumo do pagamento | Detalhe do pagamento | Pedidos EM BREVE | Pedidos com detalhes dos itens EM BREVE | Detalhamento de Landed Cost EM BREVE |
---|---|---|---|---|---|
accountName | |||||
orderAdditionalTarriffLines | |||||
addressLine1 | |||||
addressLine2 | |||||
amount | |||||
amountItem | |||||
amountTotal | |||||
arrivalDate | |||||
brokerage | |||||
city | |||||
country | |||||
countryOfOrigin | |||||
countryOfOriginSource | |||||
currency | |||||
customerName | |||||
customsDescription | |||||
description | |||||
detailType | |||||
dimensionsUnit | |||||
discountOrder | |||||
dutyOrder | |||||
dutyTaxFeeOrder | |||||
fx | |||||
guarantee | |||||
height | |||||
hsCode | |||||
hsCodeSource | |||||
itemWeight | |||||
itemWeightUnit | |||||
itemOrder | |||||
landedCostGuarantee | |||||
length | |||||
merchantAdjustment | |||||
merchantSet | |||||
merchantFee | |||||
memo | |||||
name | |||||
orderDate | |||||
orderNumber | |||||
orderStatus | |||||
orderReference | |||||
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 |
Abaixo estão as definições de cada campo nos relatórios:
Campo | Definição |
---|---|
accountName | Nome da conta com Zonos. |
orderAdditionalTarriffLines | Taxa do despachante aduaneiro pelo trabalho adicional necessário para gerenciar e declarar múltiplos códigos tarifários (HS) na entrada aduaneira. |
addressLine1 | Primeira linha do endereço do destinatário. |
addressLine2 | Segunda linha do endereço do destinatário, se aplicável. |
advancement | Taxa cobrada por antecipar impostos e taxas em nome do cliente. |
amount | Valor monetário do item ou cobrança. |
amountItem | Quantia para um único item. |
amountTotal | Quantia para um único item multiplicada pela quantidade do item. |
arrivalDate | Data em que o pagamento chegou à conta bancária do comerciante. |
brokerage | Taxa de corretagem associada à liberação aduaneira. |
city | Cidade do endereço do destinatário. |
country | Código do país de 2 letras ISO do destino. |
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 de 3 letras ISO. |
customerName | Nome do cliente que está fazendo o pedido. |
customsDescription | Descrição do item utilizada para declarações aduaneiras. |
description | Descrição do produto. |
detailType | Razão detalhada para o valor no 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 impostos, taxas e encargos aplicados ao pedido. |
fx | Taxa de câmbio rate 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 para o peso do item (por exemplo, kg, lb). |
itemOrder | Custo dos itens no pedido. |
landedCostGuarantee | Custo pelo serviço de garantia de landed cost (inclui componentes de preço tanto em $ quanto em %). |
length | Comprimento do item. |
merchantAdjustment | Ajustes que o comerciante inseriu/solicitou, tipicamente via regras. |
merchantSet | Quaisquer buffers/ajustes definidos pelo comerciante. |
merchantFee | Parte do custo de Checkout atribuída aos custos de processamento de pagamento. |
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. |
orderNumber | Identificador único para o pedido no sistema de Zonos. |
orderStatus | Status atual do pedido. |
orderReference | Número de referência adicional associado ao pedido, tipicamente o número do pedido na plataforma de ecommerce. |
other | Encargo ou ajuste diversos relacionados à transação. |
otherCarrierFee | Taxas adicionais cobradas pelo transportador, incluindo taxas de pré-pagamento (que o transportador envia na fatura de envio). |
packageWeight | Peso total do pacote. |
packageWeightUnit | Unidade de medida para o peso do pacote. |
payoutDate | Data em que o pagamento foi emitido ao comerciante. |
payee | Entidade que recebe o pagamento. |
payor | Entidade responsável por fazer o pagamento. |
payoutNumber | Corresponde ao id de pagamento do Stripe. |
payoutTotal | Valor total pago ao comerciante. |
postalCode | Código postal ou ZIP do endereço do destinatário. |
processing | Método esperado para processamento do pagamento de impostos: seja TAX_REMITTANCE (remit via ID fiscal) ou CUSTOMS_BILL (pagar uma fatura de customs). |
productId | Identificador único para o produto. |
quantity | Número de unidades do item no pedido. |
referenceNumber | Referencia o número de pagamento (por exemplo, po_1QcGXkGbPRfOWRJBfaa90A1A ) ou número da fatura (por exemplo, 584184EA-0000 ). |
settled | O valor da transação que foi liquidado para o comerciante. |
shippingOrder | Custo de envio para o pedido. |
shippingService | Método ou serviço de envio utilizado para a entrega. |
sku | Unidade de Manutenção de Estoque (SKU) para o 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 no pedido. |
trackingNumber | Número de rastreamento para a remessa. |
transactionDate | Data em que a transação foi registrada, em UTC. |
transactionFee | Inclui o custo pelos serviços de Checkout, incluindo proteção contra fraudes. Não inclui custos de processamento de pagamento. |
transactionId | Identificador único para a transação. |
transactionType | Tipos possíveis: ORDER , ORDER_REFUND , ORDER_CANCEL , CHARGE ou CREDIT . 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. |
Reconciliação de pagamentos / Correspondência de um único pagamento com seu extrato bancário
Qualquer um dos relatórios de pagamento pode ser usado para reconciliar com seu extrato bancário. É mais fácil baixar esses relatórios da página Pagamentos, para que contenham exatamente os pedidos conectados a esse pagamento (em vez da página Relatórios, que exige que você selecione o intervalo de datas).
- Vá para o Painel → Pagamentos.
- Selecione o pagamento.
- Clique em Exportar transações no canto superior direito, e escolha Resumo do pagamento ou Detalhe do pagamento no menu suspenso.
A soma da coluna settled
no Resumo do pagamento e no Detalhe do pagamento corresponderá ao valor total do pagamento mostrado no Painel.
Revisar um pedido reembolsado
Use o relatório de resumo de pagamento para visualizar seu pedido e seu reembolso.
- Vá para o Dashboard → Relatórios.
- Clique em Gerar ao lado do relatório de Resumo de pagamento.
- Selecione seu intervalo de datas preferido. Certifique-se de que o intervalo de datas inclua tanto a data do pedido quanto a data do reembolso para obter a visão completa.
- Clique em Gerar relatório.
- Filtre o relatório para o pedido em questão.
Exemplo
Vamos analisar um pedido como exemplo. Aqui está uma captura de tela de um download CSV do relatório de Resumo de pagamento, 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 (mostraria ORDER_CANCEL se este pedido não tivesse sido enviado) | -105.80 | -80.76 | -58.96 | 58.96 | 7.37 | -179.20 |
Neste exemplo:
- O comerciante está usando a garantia de Zonos de Landed Cost (valores na coluna Q,
guarantee
). - No momento do pedido, o comerciante recebeu pagamento por
itemOrder
eshippingOrder
menos as taxas de Zonos (transactionFee
emerchantFee
). Este valor, a soma das colunas M a T, corresponde ao valorsettled
na coluna U.- Impostos, taxas e encargos (
dutyTaxFeeOrder
) foram coletados, mas como o comerciante optou por que Zonos lidasse com isso, Zonos mantém esses fundos e paga diretamente à alfândega. Como resultado,dutyTaxFeeOrder
eguarantee
se cancelam (liquido para 0).
- Impostos, taxas e encargos (
- Quando o pedido foi reembolsado, Zonos reembolsou o comprador e recuperou os valores de
itemOrder
eshippingOrder
do comerciante. Zonos também reembolsou atransactionFee
, mas manteve amerchantFee
, uma vez que zonos ainda será cobrado pela taxa do comerciante pelo provedor de pagamento.- Impostos, taxas e encargos ainda não são responsabilidade do comerciante, portanto, não aparecem neste relatório. Zonos reembolsou esses valores ao comprador com base na solicitação de reembolso do comerciante, mas como esse reembolso foi de Zonos → comprador, não está refletido aqui.
Descubra quanto Zonos reteve vs quanto você ganhou no pedido
O relatório de Detalhes de pagamento pode ser usado para descobrir quanto você está pagando para Zonos, em comparação com quanto seus compradores estão pagando. No entanto, como você interpreta o relatório depende se você usa nossa garantia de Landed Cost. Escolha se você usa ou não abaixo.
Por padrão, os compradores pagam pela garantia de landed cost, enquanto os comerciantes pagam pelo custo dos serviços de checkout (como processamento de pagamento e proteção contra fraudes). O relatório de Detalhes de pagamento registra quem pagou por cada parte do pedido.
Para descobrir quanto você e seu comprador pagaram, primeiro baixe o relatório:
- Vá para o Dashboard → Relatórios.
- Clique em Gerar ao lado do relatório de Detalhes de pagamento.
- Selecione seu intervalo de datas preferido.
- Clique em Gerar relatório.
No relatório, filtre de acordo com o que você deseja saber:
- Para descobrir quanto seu comprador pagou por você pelo pedido, filtre o Pagador (coluna O) para
SHOPPER
e o Beneficiário (coluna N) paraMERCHANT
. Isso não incluirá custos de repasse como impostos e taxas. - Para descobrir quanto você pagou para Zonos do seu bolso, filtre o Pagador (coluna O) para
MERCHANT
e o Beneficiário (coluna N) para `ZONOS. Some esses valores. - Para descobrir quanto você ganhou no pedido, some todas as linhas do pedido (isso corresponderá à diferença dos dois totais acima).
Exemplo
Vamos analisar um pedido como exemplo. Aqui está uma captura de tela de um download CSV do relatório de Detalhes de pagamento, olhando para todas as linhas referentes a um único pedido, 0123.
orderNumber (I) | detailType (M) | payee (N) | payor (O) | amount (P, todos em 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 esses detalhes, vamos agrupar esses valores em ganhos e taxas.
Ganhos: Zonos coletou esses custos do comprador e depois os pagou ao comerciante.
- O subtotal do item, neste caso, $96.85 (
ITEM
). - O custo do envio, $30.63 (
SHIPPING
).
Taxas: Zonos coleta esses custos do comerciante—eles não estão incluídos no valor que o comprador pagou no checkout.
- Uma taxa de processamento do comerciante de $6.72 (
MERCHANT_PROCESSING
). - Uma taxa de transação de $4.94 (
TRANSACTION_PERCENT
).
Visualizar dados trimestrais (pagamentos dentro de um determinado período)
Relatórios de pagamento estão disponíveis para cada pagamento; no entanto, você pode querer reconciliar todos os pagamentos dentro 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 baixar os relatórios CSV de Resumo de Pagamento ou Detalhe de Pagamento, para qualquer intervalo de datas:
- Vá para o Dashboard → Relatórios.
- Clique em Gerar ao lado do relatório que você deseja.
- Selecione o intervalo de datas começando no início do trimestre e terminando no final do trimestre.
- Clique em Gerar relatório.
Verifique se os pedidos no Dashboard correspondem aos da plataforma de ecommerce
EM BREVE
Se você fez uma alteração recentemente, pode querer confirmar que todos os pedidos no Dashboard do Zonos também aparecem na sua plataforma de ecommerce. Para fazer isso:
- Baixe o relatório CSV de Pedidos.
- Vá para o Dashboard → Relatórios.
- Clique em Gerar ao lado do relatório de Pedidos.
- Selecione o intervalo de datas que você deseja verificar.
- Clique em Gerar relatório.
- Compare esses pedidos com o que você vê na sua plataforma de ecommerce.
Por favor, entre em contato com nossa equipe de suporte se você tiver algum problema com seus pedidos.
Auditar cálculos de landed cost
EM BREVE
Use o relatório de Detalhamento de Landed Cost para explorar os detalhes de nossos cálculos de landed cost sem lidar com tabelas verticais. Este relatório mostra cada custo individual que contribui para o total de landed cost de um pedido, com cada componente listado em sua própria coluna.
Para baixar o relatório de detalhamento de Landed cost:
- Vá para o Dashboard → Relatórios.
- Clique em Gerar ao lado do relatório de detalhamento de Landed cost.
- Selecione o intervalo de datas que corresponde ao da fatura do transportador.
- Clique em Gerar relatório.
Relatórios baixáveis para usuários do Checkout
Saiba como obter os dados de que você precisa a partir de relatórios baixáveis.
Relatórios baixáveis fornecem aos comerciantes do Checkout os dados necessários para reconciliação e análise. Esses relatórios, disponíveis em USD e personalizáveis por intervalo de datas, suportam 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.