InícioComércio eletrónico global Relatórios e analytics Para utilizadores do Checkout

Relatórios transferíveis para utilizadores do Checkout

Saiba como obter os dados de que necessita a partir dos relatórios transferíveis.

Os relatórios transferíveis fornecem aos comerciantes do Checkout os dados de que necessitam para conciliação e análise. Estes relatórios, disponíveis em USD e personalizáveis por intervalo de datas, suportam casos de utilização comuns, como a declaração de impostos, a verificação de encomendas, a análise de cobranças e a obtenção de informações sobre o negócio. A data e a hora de todos os relatórios estão em UTC.

Tipos de relatórios

Estão disponíveis vários relatórios:

Relatório↕	Descrição↕	Casos de utilização↕
Resumo do pagamento	Estruturado da mesma forma que o relatório Resumo do pagamento disponível para cada pagamento, mas com seleção de intervalo de datas. A versão antiga também está disponível até 31 de julho de 2025, para que possa atualizar quaisquer mapeamentos que façam referência a este relatório.	Analise as encomendas incluídas nos seus pagamentos de forma geral, com cada encomenda na sua própria linha. Consulte as taxas de transação e as taxas de comerciante.
Detalhe do pagamento	Estruturado da mesma forma que o relatório Detalhe do pagamento disponível para cada pagamento, mas com seleção de intervalo de datas. A versão antiga também está disponível até 31 de julho de 2025, para que possa atualizar quaisquer mapeamentos que façam referência a este relatório.	Consulte a discriminação do seu pagamento, incluindo o que foi retido antes de o pagamento ser enviado para a sua conta bancária.
Resumo da fatura	Estruturado da mesma forma que o relatório Resumo da fatura disponível para cada fatura, mas com intervalo de datas.	Consulte um resumo das cobranças que lhe foram faturadas.
Detalhe da fatura	Estruturado da mesma forma que o relatório Detalhe da fatura disponível para cada fatura, mas com intervalo de datas. Cada cobrança individual tem a sua própria linha no CSV.	Consulte a discriminação de todas as cobranças que lhe foram faturadas.
Encomendas	Apresenta todas as informações principais sobre uma encomenda, sem entrar em detalhes por artigo.	Analise as encomendas para prever vendas, identificar tendências geográficas e reconhecer padrões sazonais.
Encomendas com detalhes dos artigos	Lista todos os artigos de uma encomenda (cada artigo na sua própria linha). Inclui informações do artigo, como quantidade, SKU, dimensões, código HS, etc.	Analise as encomendas para determinar quais os produtos que mais vendem em cada país.
Discriminação do Landed Cost	Audite os cálculos do landed cost com a discriminação de direitos aduaneiros, impostos e taxas.	Declaração periódica de impostos, auditoria dos cálculos do landed cost.

Exportar um relatório

Estrutura

↕	Resumo do pagamento↕	Detalhe do pagamento↕	Encomendas↕	Encomendas com detalhes dos artigos↕	Discriminação do Landed Cost↕
Cada encomenda tem a sua própria linha
Cada cobrança da encomenda tem a sua própria linha

Informações disponíveis (resumo)

↕	Resumo do pagamento↕	Detalhe do pagamento↕	Encomendas↕	Encomendas com detalhes dos artigos↕	Discriminação do Landed Cost↕
Informações do cliente e número de seguimento
Informações do pagamento
Taxas de transação e taxas de comerciante
Detalhes de direitos aduaneiros, impostos e taxas
Detalhes do artigo (nome, SKU, código HS, etc.)
Número de artigos e peso da encomenda

Todos os campos disponíveis

Seguem-se os campos disponíveis em cada relatório:

Campo↕	Resumo do pagamento↕	Detalhe do pagamento↕	Encomendas↕	Encomendas com detalhes dos artigos↕	Discriminação 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 dos campos

Seguem-se as definições de cada campo dos relatórios:

Campo↕	Definição↕
`accountName`	Nome da conta na Zonos.
`orderAdditionalTarriffLines`	Taxa do despachante aduaneiro pelo trabalho adicional necessário para gerir e declarar vários códigos pautais (HS) na declaração aduaneira.
`addressLine1`	Primeira linha da morada do destinatário.
`addressLine2`	Segunda linha da morada do destinatário, se aplicável.
`advancement`	Taxa cobrada pelo adiantamento de direitos aduaneiros e impostos em nome do cliente.
`amount`	Valor monetário da linha ou da cobrança.
`amountDiscount`	Valor do desconto da encomenda.
`amountDutiesTaxesFees`	Valor dos direitos aduaneiros, impostos e taxas aplicados à encomenda.
`amountItem`	Valor de um único artigo.
`amountShipping`	Valor do envio de uma encomenda.
`amountTotal`	Valor de um único artigo multiplicado pela quantidade desse artigo.
`arrivalDate`	Data em que o pagamento chegou à conta bancária do comerciante.
`brokerage`	Taxa de corretagem associada ao desalfandegamento.
`city`	Cidade da morada do destinatário.
`country`	Código ISO de 2 letras do país de destino.
`countryOfOrigin`	País onde o artigo foi fabricado ou produzido.
`countryOfOriginSource`	Origem da informação sobre o país de origem.
`currency`	Moeda utilizada na transação, no formato ISO de 3 letras.
`customerName`	Nome do cliente que faz a encomenda.
`customsDescription`	Descrição do artigo utilizada nas declarações aduaneiras.
`description`	Descrição do produto.
`detailType`	Motivo detalhado do valor na encomenda (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 à encomenda.
`dutyOrder`	Valor dos direitos aduaneiros aplicados à encomenda.
`dutyTaxFeeOrder`	Valor total dos direitos aduaneiros, impostos e taxas aplicados à encomenda.
`fx`	Taxa de câmbio aplicada à transação.
`guarantee`	Valor garantido pela Zonos.
`height`	Altura do artigo.
`hsCode`	Código do Sistema Harmonizado (HS) atribuído ao artigo.
`hsCodeSource`	Origem da classificação do código HS.
`itemWeight`	Peso do artigo na encomenda.
`itemWeightUnit`	Unidade de medida do peso do artigo (por exemplo, kg, lb).
`itemOrder`	Custo dos artigos da encomenda.
`landedCostGuarantee`	Custo do serviço de garantia do landed cost (inclui as componentes de preço em $ e em %).
`length`	Comprimento do artigo.
`merchantAdjustment`	Ajustes que o comerciante introduziu/solicitou, normalmente através de regras.
`merchantSet`	Quaisquer margens/ajustes definidos pelo comerciante.
`merchantFee`	Parte do custo do Checkout atribuída aos custos de processamento de pagamentos.
`memo`	Notas ou detalhes adicionais sobre o pagamento ou a transação.
`name`	Nome do produto.
`orderDate`	Data em que a encomenda foi efetuada, em UTC.
`orderDuty`	Valor dos direitos aduaneiros da encomenda.
`orderFeeAdvancement`	Taxas de adiantamento da encomenda.
`orderFeeBrokerage`	Taxas de corretagem da encomenda.
`orderFeeCarrier`	Taxas da transportadora da encomenda.
`orderFeeShopper`	Taxas cobradas ao comprador.
`OrderFx`	Taxa de câmbio aplicada à transação.
`orderNumber`	Identificador único da encomenda no sistema da Zonos.
`orderReference`	Número de referência adicional associado à encomenda, normalmente o número da encomenda na plataforma de comércio eletrónico.
`orderStatus`	Estado atual da encomenda.
`orderTax`	Valor do imposto da encomenda.
`orderTotal`	Valor total da encomenda.
`other`	Cobrança ou ajuste diverso relacionado com a transação.
`otherCarrierFee`	Taxas adicionais cobradas pela transportadora, incluindo taxas de pré-pagamento (que a transportadora envia na fatura de envio).
`packageWeight`	Peso total da embalagem.
`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 por efetuar o pagamento.
`payoutNumber`	Corresponde ao ID do pagamento no Stripe.
`payoutTotal`	Valor total pago ao comerciante.
`postalCode`	Código postal da morada do destinatário.
`processing`	Método previsto para o processamento do pagamento aduaneiro: `TAX_REMITTANCE` (entrega através do número de identificação fiscal) ou `CUSTOMS_BILL` (pagamento de uma fatura aduaneira).
`productId`	Identificador único do produto.
`quantity`	Número de unidades do artigo na encomenda.
`referenceNumber`	Faz referência ao número do pagamento (por exemplo, `po_1QcGXkGbPRfOWRJBfaa90A1A`) ou ao número da fatura (por exemplo, `584184EA-0000`).
`settled`	Valor da transação liquidado ao comerciante.
`shippingOrder`	Custo de envio da encomenda.
`shippingService`	Método ou serviço de envio utilizado para a entrega.
`sku`	Unidade de manutenção de stock (SKU) do produto.
`state`	Distrito, estado ou região da morada do destinatário.
`taxOrder`	Valor do imposto aplicado à encomenda.
`total`	Total da encomenda (o total pago pelo comprador).
`totalItems`	Número total de artigos na encomenda.
`totalItemWeight`	Peso total de todos os artigos da encomenda.
`trackingNumber`	Número de seguimento da remessa.
`transactionDate`	Data em que a transação foi registada, em UTC.
`transactionFee`	Inclui o custo dos serviços do Checkout, incluindo a proteção contra fraude. Não inclui os custos de processamento de pagamentos.
`transactionId`	Identificador único da transação.
`transactionType`	Tipos possíveis: `ORDER`, `ORDER_REFUND`, `ORDER_CANCEL`, `CHARGE` ou `CREDIT`. As faturas têm outro tipo, `STRIPE`, relacionado com custos de subscrição, taxas da plataforma ou créditos CTP.
`weightUnit`	Unidade de medida dos valores de peso.
`width`	Largura do artigo.

Casos de utilização

Conciliar pagamentos / Fazer corresponder um único pagamento ao seu extrato bancário

Qualquer um dos relatórios de pagamento pode ser utilizado para a conciliação com o seu extrato bancário. É mais fácil transferi-los a partir da página Pagamentos, para que contenham exatamente as encomendas associadas a esse pagamento (em vez da página Relatórios, onde tem de selecionar o intervalo de datas).

Aceda a Dashboard → Pagamentos.
Selecione o pagamento.
Clique em Exportar transações no canto superior direito e escolha Resumo do pagamento ou Detalhe do pagamento no menu pendente.

A soma da coluna settled no Resumo do pagamento e no Detalhe do pagamento corresponde ao montante total do pagamento apresentado no Dashboard.

Rever uma encomenda reembolsada

Utilize o relatório Resumo do pagamento para ver a sua encomenda e o respetivo reembolso.

Aceda a Dashboard → Relatórios.
Clique em Gerar junto ao relatório Resumo do pagamento.
Selecione o intervalo de datas pretendido. Certifique-se de que o intervalo de datas inclui tanto a data da encomenda como a data do reembolso, para obter a visão completa.
Clique em Gerar relatório.
Filtre o relatório pela encomenda em questão.

Exemplo

Vejamos uma encomenda como exemplo. Segue-se um excerto de uma transferência em CSV do relatório Resumo do pagamento, filtrado pela encomenda 1234, para a qual foi emitido um reembolso total.

`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` (apareceria `ORDER_CANCEL` se esta encomenda não tivesse sido enviada)	-105.80	-80.76	-58.96	58.96	7.37		-179.20

Neste exemplo:

O comerciante utiliza a garantia do Landed Cost da Zonos (valores na coluna Q, guarantee).
No momento da encomenda, o comerciante recebeu o pagamento de itemOrder e shippingOrder, deduzidas as taxas da Zonos (transactionFee e merchantFee). Este montante, a soma das colunas M a T, corresponde ao valor settled na coluna U.
- Os direitos aduaneiros, impostos e taxas (dutyTaxFeeOrder) foram cobrados, mas, como o comerciante optou por deixar a Zonos tratar deles, a Zonos retém esses fundos e paga diretamente à alfândega. Por conseguinte, dutyTaxFeeOrder e guarantee anulam-se mutuamente (saldo de 0).
Quando a encomenda foi reembolsada, a Zonos reembolsou o comprador e recuperou junto do comerciante os montantes de itemOrder e shippingOrder. A Zonos também reembolsou a transactionFee, mas manteve a merchantFee, uma vez que a taxa de comerciante continuará a ser faturada à Zonos pelo prestador de serviços de pagamento.
- Os direitos aduaneiros, impostos e taxas continuam a não ser da responsabilidade do comerciante, pelo que não aparecem neste relatório. A Zonos reembolsou-os ao comprador com base no pedido de reembolso do comerciante, mas, como esse reembolso foi da Zonos → comprador, não está refletido aqui.

Saber quanto a Zonos reteve e quanto ganhou com a encomenda

O relatório Detalhe do pagamento pode ser utilizado para saber quanto está a pagar à Zonos e quanto os seus compradores estão a pagar. No entanto, a forma de interpretar o relatório depende de utilizar ou não a nossa garantia do Landed Cost. Escolha abaixo a opção que se aplica.

Por predefinição, os compradores pagam a garantia do landed cost, enquanto os comerciantes pagam o custo dos serviços de checkout (como o processamento de pagamentos e a proteção contra fraude). O relatório Detalhe do pagamento regista quem pagou cada parte da encomenda.

Para saber quanto o comerciante e o comprador pagaram, transfira primeiro o relatório:

Aceda a Dashboard → Relatórios.
Clique em Gerar junto ao relatório Detalhe do pagamento.
Selecione o intervalo de datas pretendido.
Clique em Gerar relatório.

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

Para saber quanto o comprador lhe pagou pela encomenda, filtre o Pagador (coluna O) por SHOPPER e o Beneficiário (coluna N) por MERCHANT. Isto não inclui custos repassados, como direitos aduaneiros e impostos.
Para saber quanto pagou à Zonos do seu próprio bolso, filtre o Pagador (coluna O) por MERCHANT e o Beneficiário (coluna N) por ZONOS. Some esses valores.
Para saber quanto ganhou com a encomenda, some todas as linhas da encomenda (o resultado corresponde à diferença entre os dois totais acima).

Exemplo

Vejamos uma encomenda como exemplo. Segue-se um excerto de uma transferência em CSV do relatório Detalhe do pagamento, com todas as linhas relativas a uma única encomenda, a 0123.

`orderNumber` (I)↕	`detailType` (M)↕	`payee` (N)↕	`payor` (O)↕	`amount` (P, tudo 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 interpretar este detalhe, vamos agrupar as linhas em ganhos e taxas.

Ganhos: a Zonos cobrou estes custos ao comprador e depois pagou-os ao comerciante.

O subtotal dos artigos, neste caso, 96,85 USD (ITEM).
O custo do envio, 30,63 USD (SHIPPING).

Taxas: a Zonos cobra estes custos ao comerciante; não estão incluídos no montante que o comprador pagou no checkout.

Uma taxa de processamento do comerciante de 6,72 USD (MERCHANT_PROCESSING).
Uma taxa de transação de 4,94 USD (TRANSACTION_PERCENT).

Ver dados trimestrais (pagamentos num determinado período)

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

Para transferir os relatórios CSV Resumo do pagamento ou Detalhe do pagamento para qualquer intervalo de datas:

Aceda a Dashboard → Relatórios.
Clique em Gerar junto ao relatório pretendido.
Selecione o intervalo de datas com início no começo do trimestre e fim no final do trimestre.
Clique em Gerar relatório.

Verificar se as encomendas no Dashboard correspondem às da plataforma de comércio eletrónico

Se fez uma alteração recentemente, pode querer confirmar que todas as encomendas no Zonos Dashboard também aparecem na sua plataforma de comércio eletrónico. Para tal:

Transfira o relatório CSV Encomendas.
1. Aceda a Dashboard → Relatórios.
2. Clique em Gerar junto ao relatório Encomendas.
3. Selecione o intervalo de datas que pretende verificar.
4. Clique em Gerar relatório.
Compare estas encomendas com as que vê na sua plataforma de comércio eletrónico.

Contacte a nossa equipa de apoio se tiver algum problema com as suas encomendas.

Auditar os cálculos do landed cost

Utilize o relatório Discriminação do Landed Cost para explorar os detalhes dos nossos cálculos do landed cost sem ter de lidar com tabelas verticais. Este relatório mostra cada custo individual que contribui para o landed cost total de uma encomenda, com cada componente apresentada na sua própria coluna.

Para transferir o relatório Discriminação do landed cost:

Aceda a Dashboard → Relatórios.
Clique em Gerar junto ao relatório Discriminação do landed cost.
Selecione o intervalo de datas correspondente ao da fatura da transportadora.
Clique em Gerar relatório.

Marcar uma demonstração