Actions29
- Объявление Actions
- Автозагрузка Actions
- Продвижение Actions
- Рейтинги и Отзывы Actions
Overview
This node integrates with the Avito API to retrieve detailed information about automatic upload reports, specifically focusing on write-off records related to advertisements. The operation "💰 Объявления: Списания Из Отчета" (Write-offs from Report) fetches paginated data about financial deductions associated with ads listed in a given report.
Typical use cases include:
- Auditing advertisement expenses by extracting detailed write-off entries.
- Automating financial reconciliation for ad campaigns on Avito.
- Filtering and analyzing costs per advertisement or package.
For example, a user can specify a report ID and retrieve all write-off records page by page, optionally filtering by specific ad IDs or Avito IDs, to monitor spending or detect anomalies.
Properties
| Name | Meaning |
|---|---|
| ID Отчета | Unique numeric identifier of the autoload report to query. Required. |
| Номер Страницы | Page number for pagination, starting at 0 (zero-based). Important: unlike other methods, this method uses zero-based page numbering. Required. |
| Количество На Странице | Number of write-off records to return per page. Must be between 1 and 200. Required. |
| Фильтры Списаний | Collection of filters to narrow down write-off records: • ID Объявлений — filter by ad IDs from the file, comma or pipe separated. • Avito ID — filter by Avito advertisement IDs, comma or pipe separated. |
| Включить Автоматическую Пагинацию | Boolean flag to enable automatic pagination, fetching all pages of write-off records automatically. |
| 💰 Информация о списаниях за объявления (Notice) | Informational notice describing pagination specifics, structure of write-off records, payment types, and filtering options. Not an input property but provides guidance in the UI. |
Output
The node outputs JSON objects representing individual write-off records with the following key fields:
ad_id: Advertisement ID from the source file.avito_id: Advertisement ID on Avito platform.placement_cost: Cost charged for the placement.package_id: Package ID if the cost was deducted from a package.payment_type: Type of payment used for the write-off. Possible values:wallet— deduction from wallet balance.package— deduction from a placement package.free— free placement without charge.
If automatic pagination is enabled, the output will include all matching records across pages.
No binary data output is indicated for this operation.
Dependencies
- Requires an API authentication token credential for Avito's OAuth2 API.
- The node depends on internal routing utilities to handle the autoload resource operations.
- No additional external services beyond Avito API are required.
Troubleshooting
- Incorrect Pagination: Since page numbering starts at 0, setting the page number incorrectly (e.g., starting at 1) will result in missing or empty results. Always start from 0.
- Invalid Filters: Providing malformed filter strings (wrong separators or invalid IDs) may cause no results or errors.
- API Authentication Errors: Ensure the API key or OAuth2 token is valid and has sufficient permissions.
- Exceeded Page Size Limits: The maximum number of records per page is 200; exceeding this limit may cause errors.
- Network or API Rate Limits: Large data requests with automatic pagination might hit rate limits; consider enabling error handling or delays.
Common error messages typically relate to invalid parameters or authentication failures. Verify inputs and credentials accordingly.
Links and References
- Avito API Documentation (general reference, actual URL may vary)
- Pagination best practices and API usage notes should be consulted in Avito's official docs.