Requisitos previos
Antes de comenzar, asegúrese de tener lo siguiente:
- Una suscripción activa de Inclusive Pricing con Zonos.
- Una clave de API GraphQL Secret de su Zonos Dashboard. Vaya a Settings -> Integrations para encontrar sus claves de API. La clave debe tener el prefijo
credential_livey no debe estar caducada.
Configuración inicial
Siga estos pasos para configurar la plantilla de informe de Inclusive Pricing por primera vez.
Copiar la plantilla de Google Sheet
Abra la plantilla de informe de Inclusive Pricing y haga su propia copia yendo a File -> Make a copy. No solicite acceso de editor a la hoja original.
Conectar su clave de API
En su hoja copiada, haga clic en Zonos -> Update GraphQL API Key en la barra de menú (junto a Help). Esta opción de menú puede tardar un minuto en aparecer después de abrir la hoja.
Autorizar el script
Para usuarios nuevos, aparecerá un diálogo de autorización. Haga clic en OK y siga las indicaciones para autorizar el script con su cuenta de Google:
- Haga clic en Select all para conceder los permisos requeridos.
- Haga clic en Continue para completar la autorización.
Introducir su clave de API Secret
Después de la autorización, un diálogo le pedirá que introduzca su clave de API GraphQL Secret de Zonos. Puede encontrarla en su Zonos Dashboard en Settings -> Integrations.
Asegúrese de copiar una clave Secret válida con el prefijo credential_live. Las claves caducadas o las claves Public provocarán errores.
Obtener pedidos
Haga clic en Zonos -> Fetch Orders en la barra de menú.
Seleccionar un rango de fechas
Introduzca una fecha de inicio y fin en el diálogo, o use una de las opciones predefinidas (Last 30 days, This month, Last month, This year), luego haga clic en Fetch Orders.
Al completarse, sus pedidos se mostrarán en la pestaña Orders de la hoja.
Nota: Para guardar un informe como referencia futura, haga clic derecho en la pestaña Orders y seleccione Duplicate, luego renómbrela según sea necesario. También puede exportar o hacer una copia de toda la hoja de cálculo.
Uso diario
Después de completar la configuración inicial, generar nuevos informes es sencillo:
- Omita los pasos 1-3 — Son un proceso único.
- Omita el paso 4 a menos que su clave de API haya caducado o necesite obtener datos de una tienda Zonos diferente.
- Repita los pasos 5 y 6 para obtener pedidos de un nuevo rango de fechas.
Error 401 Unauthorized
Puede ver un error que contiene HTTP fetch failed from 'order': 401: Unauthorized.
Solución: Asegúrese de usar una clave de API GraphQL Secret válida de su Zonos Dashboard. Este error ocurre cuando la clave falta, no es válida o no es de tipo Secret.
Error Security requirement failed
Puede ver un error que contiene Security requirement failed.
Solución: Asegúrese de usar la clave de API GraphQL Secret (no una clave Public) y que no tenga un estado de Expired. Vaya a Settings -> Integrations en su Zonos Dashboard para verificar el estado de su clave.
No aparecen pedidos
No se muestran pedidos a pesar de proporcionar una clave de API GraphQL Secret válida.
Solución: Este informe solo genera datos para pedidos con atributos de Inclusive Pricing. Si sus artículos no contienen campos reverseAmountDetail, no se incluirán. Verifique que haya procesado pedidos de Inclusive Pricing dentro del rango de fechas seleccionado.
Exportar informe de Inclusive Pricing
Genere un desglose de Inclusive Pricing por artículo usando una Google Sheet.
La plantilla de informe de Inclusive Pricing es una Google Sheet con un script integrado que consulta la API GraphQL de Zonos para sus pedidos y genera un informe que muestra desgloses por artículo de los importes base e inclusivos. Esto es útil para cualquier comerciante que desee visibilidad sobre cómo se distribuyen aranceles, impuestos y tarifas entre los artículos de sus pedidos con Inclusive Pricing.