Pré-requisitos
Antes de começar, certifique-se de ter o seguinte:
- Uma assinatura ativa de Inclusive Pricing com a Zonos.
- Uma chave de API GraphQL Secret do seu Zonos Dashboard. Vá para Settings -> Integrations para encontrar suas chaves de API. A chave deve ter o prefixo
credential_livee não deve estar expirada.
Configuração inicial
Siga estas etapas para configurar o modelo de relatório de Inclusive Pricing pela primeira vez.
Copiar o modelo do Google Sheet
Abra o modelo de relatório de Inclusive Pricing e faça sua própria cópia em File -> Make a copy. Não solicite acesso de editor à planilha original.
Conectar sua chave de API
Na sua planilha copiada, clique em Zonos -> Update GraphQL API Key na barra de menu (ao lado de Help). Essa opção de menu pode demorar um minuto para aparecer depois de abrir a planilha.
Autorizar o script
Para novos usuários, aparecerá um diálogo de autorização. Clique em OK e siga as instruções para autorizar o script com sua conta do Google:
- Clique em Select all para conceder as permissões necessárias.
- Clique em Continue para concluir a autorização.
Inserir sua chave de API Secret
Após a autorização, um diálogo pedirá que você insira sua chave de API GraphQL Secret da Zonos. Você pode encontrá-la no Zonos Dashboard em Settings -> Integrations.
Certifique-se de copiar uma chave Secret válida com o prefixo credential_live. Chaves expiradas ou chaves Public causarão erros.
Obter pedidos
Clique em Zonos -> Fetch Orders na barra de menu.
Selecionar um intervalo de datas
Insira uma data de início e fim no diálogo, ou use uma das opções predefinidas (Last 30 days, This month, Last month, This year), depois clique em Fetch Orders.
Ao concluir, seus pedidos serão exibidos na aba Orders da planilha.
Nota: Para salvar um relatório como referência futura, clique com o botão direito na aba Orders e selecione Duplicate, depois renomeie conforme necessário. Você também pode exportar ou fazer uma cópia de toda a planilha.
Uso diário
Depois de concluir a configuração inicial, gerar novos relatórios é simples:
- Pule as etapas 1-3 — São um processo único.
- Pule a etapa 4, a menos que sua chave de API tenha expirado ou você precise obter dados de uma loja Zonos diferente.
- Repita as etapas 5 e 6 para obter pedidos de um novo intervalo de datas.
Erro 401 Unauthorized
Você pode ver um erro contendo HTTP fetch failed from 'order': 401: Unauthorized.
Solução: Certifique-se de usar uma chave de API GraphQL Secret válida do seu Zonos Dashboard. Este erro ocorre quando a chave está ausente, é inválida ou não é do tipo Secret.
Erro Security requirement failed
Você pode ver um erro contendo Security requirement failed.
Solução: Certifique-se de usar a chave de API GraphQL Secret (não uma chave Public) e que ela não tenha o status Expired. Vá para Settings -> Integrations no Zonos Dashboard para verificar o status da sua chave.
Nenhum pedido aparece
Nenhum pedido é exibido apesar de fornecer uma chave de API GraphQL Secret válida.
Solução: Este relatório só gera dados para pedidos com atributos de Inclusive Pricing. Se seus itens não contiverem campos reverseAmountDetail, não serão incluídos. Verifique se você processou pedidos de Inclusive Pricing dentro do intervalo de datas selecionado.
Exportar relatório de Inclusive Pricing
Gere um detalhamento de Inclusive Pricing por item usando um Google Sheet.
O modelo de relatório de Inclusive Pricing é um Google Sheet com um script integrado que consulta a API GraphQL da Zonos para seus pedidos e gera um relatório que mostra detalhamentos por item dos valores base e inclusivos. Isso é útil para qualquer comerciante que deseje visibilidade sobre como direitos, impostos e taxas são distribuídos entre os itens dos pedidos com Inclusive Pricing.