475 lines
12 KiB
Go
475 lines
12 KiB
Go
package ozon
|
|
|
|
import (
|
|
"net/http"
|
|
"time"
|
|
|
|
core "github.com/diphantxm/ozon-api-client"
|
|
)
|
|
|
|
type Reports struct {
|
|
client *core.Client
|
|
}
|
|
|
|
type GetReportsListParams struct {
|
|
// Page number
|
|
Page int32 `json:"page"`
|
|
|
|
// The number of values on the page:
|
|
// - default value is 100,
|
|
// - maximum value is 1000
|
|
PageSize int32 `json:"page_size"`
|
|
|
|
// Default: "ALL"
|
|
// Report type:
|
|
// - ALL — all reports,
|
|
// - SELLER_PRODUCTS — products report,,
|
|
// - SELLER_TRANSACTIONS — transactions report,
|
|
// - SELLER_PRODUCT_PRICES — product prices report,
|
|
// - SELLER_STOCK — stocks report,
|
|
// - SELLER_PRODUCT_MOVEMENT — products movement report,
|
|
// - SELLER_RETURNS — returns report,
|
|
// - SELLER_POSTINGS — shipments report,
|
|
// - SELLER_FINANCE — financial report
|
|
ReportType string `json:"report_type"`
|
|
}
|
|
|
|
type GetReportsListResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Array with generated reports
|
|
Reports []struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
|
|
// Report creation date
|
|
CreatedAt time.Time `json:"created_at"`
|
|
|
|
// Error code when generating the report
|
|
Error string `json:"error"`
|
|
|
|
// Link to CSV file
|
|
File string `json:"file"`
|
|
|
|
// Array with the filters specified when the seller created the report
|
|
Params struct {
|
|
} `json:"params"`
|
|
|
|
// Report type:
|
|
// - SELLER_PRODUCTS — products report,
|
|
// - SELLER_TRANSACTIONS — transactions report,
|
|
// - SELLER_PRODUCT_PRICES — product prices report,
|
|
// - SELLER_STOCK — stocks report,
|
|
// - SELLER_PRODUCT_MOVEMENT — products movement report,
|
|
// - SELLER_RETURNS — returns report,
|
|
// - SELLER_POSTINGS — shipments report,
|
|
// - SELLER_FINANCE — financial report
|
|
ReportType string `json:"report_type"`
|
|
|
|
// Report generation status
|
|
// - `success`
|
|
// - `failed`
|
|
Status string `json:"status"`
|
|
} `json:"reports"`
|
|
|
|
// Total number of reports
|
|
Total int32 `json:"total"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Returns the list of reports that have been generated before
|
|
func (c Reports) GetList(params *GetReportsListParams) (*GetReportsListResponse, error) {
|
|
url := "/v1/report/list"
|
|
|
|
resp := &GetReportsListResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetReportDetailsParams struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
}
|
|
|
|
type GetReportDetailsResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Report details
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
|
|
// Report creation date
|
|
CreatedAt time.Time `json:"created_at"`
|
|
|
|
// Error code when generating the report
|
|
Error string `json:"error"`
|
|
|
|
// Link to CSV file
|
|
File string `json:"file"`
|
|
|
|
// Array with the filters specified when the seller created the report
|
|
Params map[string]string `json:"params"`
|
|
|
|
// Report type:
|
|
// - SELLER_PRODUCTS — products report,
|
|
// - SELLER_TRANSACTIONS — transactions report,
|
|
// - SELLER_PRODUCT_PRICES — product prices report,
|
|
// - SELLER_STOCK — stocks report,
|
|
// - SELLER_PRODUCT_MOVEMENT — products movement report,
|
|
// - SELLER_RETURNS — returns report,
|
|
// - SELLER_POSTINGS — shipments report,
|
|
// - SELLER_FINANCE — financial report
|
|
ReportType string `json:"report_type"`
|
|
|
|
// Report generation status:
|
|
// - success
|
|
// - failed
|
|
Status string `json:"status"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Returns information about a created report by its identifier
|
|
func (c Reports) GetReportDetails(params *GetReportDetailsParams) (*GetReportDetailsResponse, error) {
|
|
url := "/v1/report/info"
|
|
|
|
resp := &GetReportDetailsResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetFinancialReportParams struct {
|
|
// Report generation period
|
|
Date GetFinancialReportDatePeriod `json:"date"`
|
|
|
|
// Number of the page returned in the request
|
|
Page int64 `json:"page"`
|
|
|
|
// Number of items on the page
|
|
PageSize int64 `json:"page_size"`
|
|
}
|
|
|
|
type GetFinancialReportDatePeriod struct {
|
|
// Date from which the report is calculated
|
|
From time.Time `json:"from"`
|
|
|
|
// Date up to which the report is calculated
|
|
To time.Time `json:"to"`
|
|
}
|
|
|
|
type GetFinancialReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Reports list
|
|
CashFlows []struct {
|
|
// Period data
|
|
Period struct {
|
|
// Period identifier
|
|
Id int64 `json:"id"`
|
|
|
|
// Period start
|
|
Begin time.Time `json:"begin"`
|
|
|
|
// Period end
|
|
End time.Time `json:"end"`
|
|
} `json:"period"`
|
|
|
|
// Sum of sold products prices
|
|
OrdersAmount float64 `json:"order_amount"`
|
|
|
|
// Sum of returned products prices
|
|
ReturnsAmount float64 `json:"returns_amount"`
|
|
|
|
// Ozon sales commission
|
|
CommissionAmount float64 `json:"commission_amount"`
|
|
|
|
// Additional services cost
|
|
ServicesAmount float64 `json:"services_amount"`
|
|
|
|
// Logistic services cost
|
|
ItemDeliveryAndReturnAmount float64 `json:"item_delivery_and_return_amount"`
|
|
|
|
// Code of the currency used to calculate the commissions
|
|
CurrencyCode string `json:"currency_code"`
|
|
} `json:"cash_flows"`
|
|
|
|
// Number of pages with reports
|
|
PageCount int64 `json:"page_count"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Returns information about a created report by its identifier
|
|
func (c Reports) GetFinancial(params *GetFinancialReportParams) (*GetFinancialReportResponse, error) {
|
|
url := "/v1/finance/cash-flow-statement/list"
|
|
|
|
resp := &GetFinancialReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetProductsReportParams struct {
|
|
// Default: "DEFAULT"
|
|
// Response language:
|
|
// - RU — Russian
|
|
// - EN — English
|
|
Language string `json:"language" default:"DEFAULT"`
|
|
|
|
// Product identifier in the seller's system
|
|
OfferId []string `json:"offer_id"`
|
|
|
|
// Search by record content, checks for availability
|
|
Search string `json:"search"`
|
|
|
|
// Product identifier in the Ozon system, SKU
|
|
SKU []int64 `json:"sku"`
|
|
|
|
// Default: "ALL"
|
|
// Filter by product visibility
|
|
Visibility string `json:"visibility" default:"ALL"`
|
|
}
|
|
|
|
type GetProductsReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Method for getting a report with products data. For example, Ozon ID, number of products, prices, status
|
|
func (c Reports) GetProducts(params *GetProductsReportParams) (*GetProductsReportResponse, error) {
|
|
url := "/v1/report/products/create"
|
|
|
|
resp := &GetProductsReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetStocksReportParams struct {
|
|
// Default: "DEFAULT"
|
|
// Response language:
|
|
// - RU — Russian
|
|
// - EN — English
|
|
Language string `json:"language" default:"DEFAULT"`
|
|
}
|
|
|
|
type GetStocksReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Report with information about the number of available and reserved products in stock
|
|
func (c Reports) GetStocks(params *GetStocksReportParams) (*GetStocksReportResponse, error) {
|
|
url := "/v1/report/stock/create"
|
|
|
|
resp := &GetStocksReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetProductsMovementReportParams struct {
|
|
// Date from which the data will be in the report
|
|
DateFrom time.Time `json:"date_from"`
|
|
|
|
// Date up to which the data will be in the report
|
|
DateTo time.Time `json:"date_to"`
|
|
|
|
// Default: "DEFAULT"
|
|
// Response language:
|
|
// - RU — Russian
|
|
// - EN — English
|
|
Language string `json:"language" default:"DEFAULT"`
|
|
}
|
|
|
|
type GetProductsMovementReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Report with complete information on products, as well as the number of products with statuses:
|
|
// - products with defects or in inventory,
|
|
// - products in transit between the fulfillment centers,
|
|
// - products in delivery,
|
|
// - products to be sold
|
|
func (c Reports) GetProductsMovement(params *GetProductsMovementReportParams) (*GetProductsMovementReportResponse, error) {
|
|
url := "/v1/report/products/movement/create"
|
|
|
|
resp := &GetProductsMovementReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetReturnsReportParams struct {
|
|
// Filter
|
|
Filter GetReturnsReportsFilter `json:"filter"`
|
|
|
|
// Default: "DEFAULT"
|
|
// Response language:
|
|
// - RU — Russian
|
|
// - EN — English
|
|
Language string `json:"language" default:"DEFAULT"`
|
|
}
|
|
|
|
type GetReturnsReportsFilter struct {
|
|
// Order delivery scheme: fbs — delivery from seller's warehouse
|
|
DeliverySchema string `json:"delivery_schema"`
|
|
|
|
// Order identifier
|
|
OrderId int64 `json:"order_id"`
|
|
|
|
// Order status
|
|
Status string `json:"status"`
|
|
}
|
|
|
|
type GetReturnsReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// The report contains information about returned products that were accepted from the customer, ready for pickup, or delivered to the seller.
|
|
//
|
|
// The method is only suitable for orders shipped from the seller's warehouse
|
|
func (c Reports) GetReturns(params *GetReturnsReportParams) (*GetReturnsReportResponse, error) {
|
|
url := "/v1/report/returns/create"
|
|
|
|
resp := &GetReturnsReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
type GetShipmentReportParams struct {
|
|
// Filter
|
|
Filter GetShipmentReportFilter `json:"filter"`
|
|
|
|
// Default: "DEFAULT"
|
|
// Response language:
|
|
// - RU — Russian
|
|
// - EN — English
|
|
Language string `json:"language"`
|
|
}
|
|
|
|
type GetShipmentReportFilter struct {
|
|
// Cancellation reason identifier
|
|
CancelReasonId []int64 `json:"cancel_reason_id"`
|
|
|
|
// Work scheme: FBO or FBS.
|
|
//
|
|
// To get an FBO scheme report, pass fbo in this parameter. For an FBS scheme report pass fbs
|
|
DeliverySchema []string `json:"delivery_schema"`
|
|
|
|
// Product identifier
|
|
OfferId string `json:"offer_id"`
|
|
|
|
// Order processing start date and time
|
|
ProcessedAtFrom time.Time `json:"processed_at_from"`
|
|
|
|
// Time when the order appeared in your personal account
|
|
ProcessedAtTo time.Time `json:"processed_at_to"`
|
|
|
|
// Product identifier in the Ozon system, SKU
|
|
SKU []int64 `json:"sku"`
|
|
|
|
// Status text
|
|
StatusAlias []string `json:"status_alias"`
|
|
|
|
// Numerical status
|
|
Statuses []int64 `json:"statused"`
|
|
|
|
// Product name
|
|
Title string `json:"title"`
|
|
}
|
|
|
|
type GetShipmentReportResponse struct {
|
|
core.CommonResponse
|
|
|
|
// Method result
|
|
Result struct {
|
|
// Unique report identifier
|
|
Code string `json:"code"`
|
|
} `json:"result"`
|
|
}
|
|
|
|
// Shipment report with orders details:
|
|
// - order statuses
|
|
// - processing start date
|
|
// - order numbers
|
|
// - shipment numbers
|
|
// - shipment costs
|
|
// - shipments contents
|
|
func (c Reports) GetShipment(params *GetShipmentReportParams) (*GetShipmentReportResponse, error) {
|
|
url := "/v1/report/postings/create"
|
|
|
|
resp := &GetShipmentReportResponse{}
|
|
|
|
response, err := c.client.Request(http.MethodPost, url, params, resp)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
response.CopyCommonResponse(&resp.CommonResponse)
|
|
|
|
return resp, nil
|
|
}
|