Actions19
- Atualizar Webhook
- Consultar Afiliado
- Consultar Estatísticas De Vendas
- Consultar Produto
- Consultar Saldo Específico
- Consultar Saque
- Consultar Venda
- Consultar Webhook
- Criar Webhook
- Deletar Webhook
- Editar Afiliado
- Listar Afiliados
- Listar Participantes
- Listar Produtos
- Listar Saques
- Listar Vendas
- Listar Webhooks
- Realizar Saque
- Reembolsar Venda
Overview
This node interacts with the Kiwify API to retrieve sales statistics data. Specifically, the "Consultar Estatísticas De Vendas" operation allows users to fetch aggregated sales statistics within a specified date range, optionally filtered by a specific product ID.
Typical use cases include:
- Analyzing sales performance over a given period.
- Monitoring sales trends for a particular product.
- Generating reports on sales metrics for business insights.
For example, a user can specify a start and end date to get total sales, revenue, or other aggregated metrics from Kiwify's platform, optionally narrowing down the data to a single product by providing its ID.
Properties
| Name | Meaning |
|---|---|
| ID Do Produto | Optional. The product ID to filter sales statistics for a specific product. |
| Data De Início | Required. The start date (format YYYY-MM-DD) for the sales statistics query. |
| Data De Fim | Required. The end date (format YYYY-MM-DD) for the sales statistics query. |
Output
The output is a JSON object containing the sales statistics data returned by the Kiwify API for the specified date range and optional product filter. This typically includes aggregated metrics such as total sales count, revenue, and other relevant statistics.
The node does not output binary data; all results are structured JSON suitable for further processing or reporting within n8n workflows.
Dependencies
- Requires an API key credential for authenticating with the Kiwify API.
- The node uses OAuth token retrieval internally by exchanging client credentials for an access token.
- Requires configuration of the Kiwify account ID and client credentials in n8n credentials settings.
- Makes HTTP requests to the public Kiwify API endpoints.
Troubleshooting
- Authentication errors: If the node fails to authenticate, verify that the API credentials (client ID, client secret, and account ID) are correctly configured and valid.
- Invalid date format: Ensure that the start and end dates are provided in the required
YYYY-MM-DDformat. - Empty or incorrect product ID: If filtering by product ID, confirm that the ID exists and is correct; otherwise, the API may return no data.
- API rate limits or downtime: Temporary failures might occur due to API limits or service unavailability; retrying after some time may resolve these issues.
- Error messages from the API: The node surfaces error messages from the Kiwify API. Review these messages to understand issues like invalid parameters or permission problems.
Links and References
- Kiwify API Documentation (official API docs, for detailed endpoint info)
- n8n Documentation (for general usage of custom nodes and credentials setup)