fakz9/ozon-api-client
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

flat structures

Browse Source
This commit is contained in:
diPhantxm
2023-06-23 20:35:22 +03:00
committed by Kirill
parent e7290069f5
commit f81e4ed350
17 changed files with 3120 additions and 2648 deletions
Download Patch File Download Diff File Expand all files Collapse all files

108
ozon/analytics.go
View File

@@ -22,16 +22,7 @@ type GetAnalyticsDataParams struct {
Dimension []GetAnalyticsDataDimension `json:"dimension"`
// Filters
Filters []struct {
// Sorting parameter. You can pass any attribute from the `dimension` and `metric` parameters except the `brand` attribute
Key string `json:"key"`
// Comparison operation
Operation GetAnalyticsDataFilterOperation `json:"operation"`
// Value for comparison
Value string `json:"value"`
} `json:"filters"`
Filters []GetAnalyticsDataFilter `json:"filters"`
// Number of items in the respones:
// - maximum is 1000,
@@ -48,6 +39,17 @@ type GetAnalyticsDataParams struct {
Sort []GetAnalyticsDataSort `json:"sort"`
}
type GetAnalyticsDataFilter struct {
// Sorting parameter. You can pass any attribute from the `dimension` and `metric` parameters except the `brand` attribute
Key string `json:"key"`
// Comparison operation
Operation GetAnalyticsDataFilterOperation `json:"operation"`
// Value for comparison
Value string `json:"value"`
}
// Report sorting settings
type GetAnalyticsDataSort struct {
// Metric by which the method result will be sorted
@@ -61,30 +63,36 @@ type GetAnalyticsDataResponse struct {
core.CommonResponse
// Method result
Result struct {
// Data array
Data []struct {
// Data grouping in the report
Dimensions []struct {
// Identifier
Id string `json:"id"`
// Name
Name string `json:"name"`
} `json:"dimensions"`
// Metric values list
Metrics []float64 `json:"metrics"`
} `json:"data"`
// Total and average metrics values
Totals []float64 `json:"totals"`
} `json:"result"`
Result GetAnalyticsDataResult `json:"result"`
// Report creation time
Timestamp string `json:"timestamp"`
}
type GetAnalyticsDataResult struct {
// Data array
Data []GetAnalyticsDataResultData `json:"data"`
// Total and average metrics values
Totals []float64 `json:"totals"`
}
type GetAnalyticsDataResultData struct {
// Data grouping in the report
Dimensions []GetAnalyticsDataResultDimension `json:"dimensions"`
// Metric values list
Metrics []float64 `json:"metrics"`
}
type GetAnalyticsDataResultDimension struct {
// Identifier
Id string `json:"id"`
// Name
Name string `json:"name"`
}
// Specify the period and metrics that are required. The response will contain analytical data grouped by the `dimensions` parameter.
func (c Analytics) GetAnalyticsData(params *GetAnalyticsDataParams) (*GetAnalyticsDataResponse, error) {
url := "/v1/analytics/data"
@@ -117,31 +125,35 @@ type GetStocksOnWarehousesResponse struct {
core.CommonResponse
// Method result
Result struct {
// Information about products and stocks
Rows []struct {
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
Result GetStocksOnWarehousesResult `json:"result"`
}
// Product identifier in the seller's system
ItemCode string `json:"item_code"`
type GetStocksOnWarehousesResult struct {
// Information about products and stocks
Rows []GetStocksOnWarehousesResultRow `json:"rows"`
}
// Product name in the Ozon system
ItemName string `json:"item_name"`
type GetStocksOnWarehousesResultRow struct {
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Product amount available for sale on Ozon
FreeToSellAmount int64 `json:"free_to_sell_amount"`
// Product identifier in the seller's system
ItemCode string `json:"item_code"`
// Product amount specified for confirmed future supplies
PromisedAmount int64 `json:"promised_amount"`
// Product name in the Ozon system
ItemName string `json:"item_name"`
// Product amount reserved for purchase, returns, and transportation between warehouses
ReservedAmount int64 `json:"reserved_amount"`
// Product amount available for sale on Ozon
FreeToSellAmount int64 `json:"free_to_sell_amount"`
// Name of the warehouse where the products are stored
WarehouseName string `json:"warehouse_name"`
} `json:"rows"`
} `json:"result"`
// Product amount specified for confirmed future supplies
PromisedAmount int64 `json:"promised_amount"`
// Product amount reserved for purchase, returns, and transportation between warehouses
ReservedAmount int64 `json:"reserved_amount"`
// Name of the warehouse where the products are stored
WarehouseName string `json:"warehouse_name"`
}
// Report on stocks and products movement at Ozon warehouses

30
ozon/brands.go
View File

@@ -22,21 +22,25 @@ type ListCertifiedBrandsResponse struct {
core.CommonResponse
// Method result
Result struct {
// Certified brands details
BrandCertification []struct {
// Brand name
BrandName string `json:"brand_name"`
Result ListCertifiedBrandsResult `json:"result"`
}
// Indication that the certificate is required:
// - true if the certificate is required;
// - false if not
HasCertificate bool `json:"has_certificate"`
} `json:"brand_certification"`
type ListCertifiedBrandsResult struct {
// Certified brands details
BrandCertification []ListCertifiedBrandsResultCertificate `json:"brand_certification"`
// Total number of brands
Total int64 `json:"total"`
} `json:"result"`
// Total number of brands
Total int64 `json:"total"`
}
type ListCertifiedBrandsResultCertificate struct {
// Brand name
BrandName string `json:"brand_name"`
// Indication that the certificate is required:
// - true if the certificate is required;
// - false if not
HasCertificate bool `json:"has_certificate"`
}
// List of certified brands

58
ozon/cancellations.go
View File

@@ -31,13 +31,7 @@ type CancellationInfo struct {
PostingNumber string `json:"posting_number"`
// Cancellation reason
CancellationReason struct {
// Cancellation reason identifier
Id int64 `json:"id"`
// Cancellation reason name
Name string `json:"name"`
} `json:"cancellation_reason"`
CancellationReason CancellationInfoReason `json:"cancellation_reason"`
// Cancellation request creation date
CancelledAt time.Time `json:"cancelled_at"`
@@ -49,16 +43,7 @@ type CancellationInfo struct {
TPLIntegrationType string `json:"tpl_integration_type"`
// Cancellation request status
State struct {
// Status identifier
Id int64 `json:"id"`
// Status name
Name string `json:"name"`
// Request status
State string `json:"state"`
} `json:"state"`
State CancellationInfoState `json:"state"`
// Cancellation initiator
CancellationInitiator string `json:"cancellation_initiator"`
@@ -76,6 +61,25 @@ type CancellationInfo struct {
AutoApproveDate time.Time `json:"auto_approve_date"`
}
type CancellationInfoReason struct {
// Cancellation reason identifier
Id int64 `json:"id"`
// Cancellation reason name
Name string `json:"name"`
}
type CancellationInfoState struct {
// Status identifier
Id int64 `json:"id"`
// Status name
Name string `json:"name"`
// Request status
State string `json:"state"`
}
// Method for getting information about a rFBS cancellation request
func (c Cancellations) GetInfo(params *GetCancellationInfoParams) (*GetCancellationInfoResponse, error) {
url := "/v1/delivery-method/list"
@@ -134,16 +138,18 @@ type ListCancellationsResponse struct {
Total int32 `json:"total"`
// Counter of requests in different statuses
Counters struct {
// Number of requests for approval
OnApproval int64 `json:"on_approval"`
Counters ListCancellationResponseCounters `json:"counters"`
}
// Number of approved requests
Approved int64 `json:"approved"`
type ListCancellationResponseCounters struct {
// Number of requests for approval
OnApproval int64 `json:"on_approval"`
// Number of rejected requests
Rejected int64 `json:"rejected"`
} `json:"counters"`
// Number of approved requests
Approved int64 `json:"approved"`
// Number of rejected requests
Rejected int64 `json:"rejected"`
}
// Method for getting a list of rFBS cancellation requests
@@ -190,7 +196,7 @@ func (c Cancellations) Approve(params *ApproveRejectCancellationsParams) (*Appro
}
// The method allows to reject an rFBS cancellation request in the ON_APPROVAL status. Explain your decision in the comment parameter.
//
//
// The order will remain in the same status and must be delivered to the customer
func (c Cancellations) Reject(params *ApproveRejectCancellationsParams) (*ApproveRejectCancellationsResponse, error) {
url := "/v1/conditional-cancellation/reject"

120
ozon/categories.go
View File

@@ -22,16 +22,18 @@ type GetProductTreeResponse struct {
core.CommonResponse
// Category list
Result []struct {
// Category identifier
CategoryId int64 `json:"category_id"`
Result []GetProductTreeResult `json:"result"`
}
// Subcategory tree
Children []GetProductTreeResponse `json:"children"`
type GetProductTreeResult struct {
// Category identifier
CategoryId int64 `json:"category_id"`
// Category name
Title string `json:"title"`
} `json:"result"`
// Subcategory tree
Children []GetProductTreeResponse `json:"children"`
// Category name
Title string `json:"title"`
}
// Returns product categories in the tree view.
@@ -67,58 +69,62 @@ type GetCategoryAttributesResponse struct {
core.CommonResponse
// Method result
Result []struct {
// Array of product characteristics
Attributes []struct {
// Indication that the dictionary attribute values depend on the category:
// - true — the attribute has its own set of values for each category.
// - false — the attribute has the same set of values for all categories
CategoryDependent bool `json:"category_dependent"`
Result []GetCategoryAttributesResult `json:"result"`
}
// Characteristic description
Description string `json:"description"`
type GetCategoryAttributesResult struct {
// Array of product characteristics
Attributes []GetCategoryAttributesResultAttribute `json:"attributes"`
// Directory identifier
DictionaryId int64 `json:"dictionary_id"`
// Category identifier
CategoryId int64 `json:"category_id"`
}
// Characteristics group identifier
GroupId int64 `json:"group_id"`
type GetCategoryAttributesResultAttribute struct {
// Indication that the dictionary attribute values depend on the category:
// - true — the attribute has its own set of values for each category.
// - false — the attribute has the same set of values for all categories
CategoryDependent bool `json:"category_dependent"`
// Characteristics group name
GroupName string `json:"group_name"`
// Characteristic description
Description string `json:"description"`
// Document generation task number
Id int64 `json:"id"`
// Directory identifier
DictionaryId int64 `json:"dictionary_id"`
// Indicates that the attribute is aspect. An aspect attribute is a characteristic that distinguishes products of the same model.
//
// For example, clothes and shoes of the same model may have different colors and sizes. That is, color and size are aspect attributes.
//
// Values description:
// - true — the attribute is aspect and cannot be changed after the products are delivered to the warehouse or sold from the seller's warehouse.
// - false — the attribute is not aspect and can be changed at any time
IsAspect bool `json:"is_aspect"`
// Characteristics group identifier
GroupId int64 `json:"group_id"`
// Indicates that the characteristic is a set of values:
// - true — the characteristic is a set of values,
// - false — the characteristic consists of a single value
IsCollection bool `json:"is_collection"`
// Characteristics group name
GroupName string `json:"group_name"`
// Indicates that the characteristic is mandatory:
// - true — a mandatory characteristic,
// - false — you can leave the characteristic out
IsRequired bool `json:"is_required"`
// Document generation task number
Id int64 `json:"id"`
// Name
Name string `json:"name"`
// Indicates that the attribute is aspect. An aspect attribute is a characteristic that distinguishes products of the same model.
//
// For example, clothes and shoes of the same model may have different colors and sizes. That is, color and size are aspect attributes.
//
// Values description:
// - true — the attribute is aspect and cannot be changed after the products are delivered to the warehouse or sold from the seller's warehouse.
// - false — the attribute is not aspect and can be changed at any time
IsAspect bool `json:"is_aspect"`
// Characteristic type
Type string `json:"type"`
} `json:"attributes"`
// Indicates that the characteristic is a set of values:
// - true — the characteristic is a set of values,
// - false — the characteristic consists of a single value
IsCollection bool `json:"is_collection"`
// Category identifier
CategoryId int64 `json:"category_id"`
} `json:"result"`
// Indicates that the characteristic is mandatory:
// - true — a mandatory characteristic,
// - false — you can leave the characteristic out
IsRequired bool `json:"is_required"`
// Name
Name string `json:"name"`
// Characteristic type
Type string `json:"type"`
}
// Getting characteristics for specified product category.
@@ -167,14 +173,16 @@ type GetAttributeDictionaryResponse struct {
HasNext bool `json:"has_next"`
// Method result
Result []struct {
Id int64 `json:"id"`
Info string `json:"info"`
Picture string `json:"picture"`
Result []GetAttributeDictionaryResult `json:"result"`
}
// Product characteristic value
Value string `json:"value"`
} `json:"result"`
type GetAttributeDictionaryResult struct {
Id int64 `json:"id"`
Info string `json:"info"`
Picture string `json:"picture"`
// Product characteristic value
Value string `json:"value"`
}
// You can use the `/v3/category/attribute` method to check if an attribute has a nested directory.

296
ozon/certificates.go
View File

@@ -15,25 +15,31 @@ type ListOfAccordanceTypesResponse struct {
core.CommonResponse
// Accordance types
Result struct {
// Main accordance types
Base []struct {
// Accordance type code
Code string `json:"code"`
Result ListOfAccordanceTypesResult `json:"result"`
}
// Accordance type description
Title string `json:"title"`
} `json:"base"`
type ListOfAccordanceTypesResult struct {
// Main accordance types
Base []ListOfAccordanceTypesResultBase `json:"base"`
// Main accordance types related to dangerous products
Hazard []struct {
// Accordance type code
Code string `json:"code"`
// Main accordance types related to dangerous products
Hazard []ListOfAccordanceTypesResultHazard `json:"hazard"`
}
// Accordance type description
Title string `json:"title"`
} `json:"hazard"`
} `json:"result"`
type ListOfAccordanceTypesResultBase struct {
// Accordance type code
Code string `json:"code"`
// Accordance type description
Title string `json:"title"`
}
type ListOfAccordanceTypesResultHazard struct {
// Accordance type code
Code string `json:"code"`
// Accordance type description
Title string `json:"title"`
}
// List of accordance types (version 2)
@@ -55,13 +61,15 @@ type DirectoryOfDocumentTypesResponse struct {
core.CommonResponse
// List of certificate types and names
Result []struct {
// Certificate name
Name string `json:"name"`
Result []DirectoryOfDocumentTypesResult `json:"result"`
}
// Certificate type
Value string `json:"value"`
} `json:"result"`
type DirectoryOfDocumentTypesResult struct {
// Certificate name
Name string `json:"name"`
// Certificate type
Value string `json:"value"`
}
// Directory of document types
@@ -91,19 +99,23 @@ type ListOfCertifiedCategoriesResponse struct {
core.CommonResponse
// Method result
Result struct {
// Certified categories details
Certification []struct {
// Category name
CategoryName string `json:"category_name"`
Result ListOfCertifiedCategoriesResult `json:"reult"`
}
// Indication of a mandatory category
IsRequired bool `json:"is_required"`
} `json:"certification"`
type ListOfCertifiedCategoriesResult struct {
// Certified categories details
Certification []ListOfCertifiedCategoriesResultCert `json:"certification"`
// Total number of categories
Total int64 `json:"total"`
} `json:"reult"`
// Total number of categories
Total int64 `json:"total"`
}
type ListOfCertifiedCategoriesResultCert struct {
// Category name
CategoryName string `json:"category_name"`
// Indication of a mandatory category
IsRequired bool `json:"is_required"`
}
// List of certified categories
@@ -160,15 +172,17 @@ type DeleteCertificateResponse struct {
core.CommonResponse
// Result of deleting the certificate
Result struct {
// Indication that a certificate has been deleted:
// - true — deleted
// - false — not deleted
IsDelete bool `json:"is_delete"`
Result DeleteCertificateResult `json:"result"`
}
// Description of errors during certificate deletion
ErrorMessage string `json:"error_message"`
} `json:"result"`
type DeleteCertificateResult struct {
// Indication that a certificate has been deleted:
// - true — deleted
// - false — not deleted
IsDelete bool `json:"is_delete"`
// Description of errors during certificate deletion
ErrorMessage string `json:"error_message"`
}
// Delete certificate
@@ -195,40 +209,42 @@ type GetCertificateInfoResponse struct {
core.CommonResponse
// Certificate information
Result struct {
// Identifier
CertificateId int32 `json:"certificate_id"`
Result GetCertificateInfoResult `json:"result"`
}
// Number
CertificateNumber string `json:"certificate_number"`
type GetCertificateInfoResult struct {
// Identifier
CertificateId int32 `json:"certificate_id"`
// Name
CertificateName string `json:"certificate_name"`
// Number
CertificateNumber string `json:"certificate_number"`
// Type
TypeCode string `json:"type_code"`
// Name
CertificateName string `json:"certificate_name"`
// Status
StatusCode string `json:"status_code"`
// Type
TypeCode string `json:"type_code"`
// Accordance type
AccordanceTypeCode string `json:"accordance_type_code"`
// Status
StatusCode string `json:"status_code"`
// Certificate rejection reason
RejectionReasonCode string `json:"rejectio_reason_code"`
// Accordance type
AccordanceTypeCode string `json:"accordance_type_code"`
// Moderator's comment
VerificationComment string `json:"verification_comment"`
// Certificate rejection reason
RejectionReasonCode string `json:"rejectio_reason_code"`
// Issue date
IssueDate time.Time `json:"issue_date"`
// Moderator's comment
VerificationComment string `json:"verification_comment"`
// Expire date
ExpireDate time.Time `json:"expire_date"`
// Issue date
IssueDate time.Time `json:"issue_date"`
// Number of products associated with a certificate
ProductsCount int32 `json:"products_count"`
} `json:"result"`
// Expire date
ExpireDate time.Time `json:"expire_date"`
// Number of products associated with a certificate
ProductsCount int32 `json:"products_count"`
}
// Certificate information
@@ -268,46 +284,50 @@ type ListCertificatesResponse struct {
core.CommonResponse
// Certificates
Result struct {
// Сertificate information
Certificates []struct {
// Identifier
CertificateId int32 `json:"certificate_id"`
Result ListCertificatesResult `json:"result"`
}
// Number
CertificateNumber string `json:"certificate_number"`
type ListCertificatesResult struct {
// Сertificate information
Certificates []ListCertificatesResultCert `json:"certificates"`
// Name
CertificateName string `json:"certificate_name"`
// Number of pages
PageCount int32 `json:"page_count"`
}
// Type
TypeCode string `json:"type"`
type ListCertificatesResultCert struct {
// Identifier
CertificateId int32 `json:"certificate_id"`
// Status
StatusCode string `json:"status_code"`
// Number
CertificateNumber string `json:"certificate_number"`
// Accordance type
AccordanceTypecode string `json:"accordance_type_code"`
// Name
CertificateName string `json:"certificate_name"`
// Certificate rejection reason
RejectionReasonCode string `json:"rejectio_reason_code"`
// Type
TypeCode string `json:"type"`
// Moderator's comment
VerificationComment string `json:"verification_comment"`
// Status
StatusCode string `json:"status_code"`
// Issue date
IssueDate time.Time `json:"issue_data"`
// Accordance type
AccordanceTypecode string `json:"accordance_type_code"`
// Expire date
ExpireDate time.Time `json:"expire_date"`
// Certificate rejection reason
RejectionReasonCode string `json:"rejectio_reason_code"`
// Number of products associated with a certificate
ProductsCount int32 `json:"products_count"`
} `json:"certificates"`
// Moderator's comment
VerificationComment string `json:"verification_comment"`
// Number of pages
PageCount int32 `json:"page_count"`
} `json:"result"`
// Issue date
IssueDate time.Time `json:"issue_data"`
// Expire date
ExpireDate time.Time `json:"expire_date"`
// Number of products associated with a certificate
ProductsCount int32 `json:"products_count"`
}
// Certificates list
@@ -329,13 +349,15 @@ type ProductStatusesResponse struct {
core.CommonResponse
// Product statuses
Result []struct {
// Product status code when linking it to the certificate
Code string `json:"code"`
Result []ProductStatusesResult `json:"result"`
}
// Status description
Name string `json:"name"`
} `json:"result"`
type ProductStatusesResult struct {
// Product status code when linking it to the certificate
Code string `json:"code"`
// Status description
Name string `json:"name"`
}
func (c Certificates) ProductStatuses() (*ProductStatusesResponse, error) {
@@ -370,19 +392,21 @@ type ListProductsForCertificateResponse struct {
core.CommonResponse
// Method result
Result struct {
// List of products
Items []struct {
// Product identifier
ProductId int64 `json:"product_id"`
Result ListProductsForCertificateResult `json:"result"`
}
// Status of the product processing when binding to a certificate
ProductStatusCode string `json:"product_status_code"`
} `json:"items"`
type ListProductsForCertificateResult struct {
// List of products
Items []struct {
// Product identifier
ProductId int64 `json:"product_id"`
// Number of products found
Count int64 `json:"count"`
} `json:"result"`
// Status of the product processing when binding to a certificate
ProductStatusCode string `json:"product_status_code"`
} `json:"items"`
// Number of products found
Count int64 `json:"count"`
}
// A method for getting a list of possible statuses of products when binding them to a certificate
@@ -412,18 +436,20 @@ type UnlinkFromProductResponse struct {
core.CommonResponse
// Method result
Result []struct {
// Error message when unbinding a product
Error string `json:"error"`
Result []UnlinkFromProductResult `json:"result"`
}
// Product identifier
ProductId int64 `json:"product_id"`
type UnlinkFromProductResult struct {
// Error message when unbinding a product
Error string `json:"error"`
// Indication that the product was unbound from a certificate:
// - true — it was unbound,
// - false — it is still bound
Updated bool `json:"updated"`
} `json:"result"`
// Product identifier
ProductId int64 `json:"product_id"`
// Indication that the product was unbound from a certificate:
// - true — it was unbound,
// - false — it is still bound
Updated bool `json:"updated"`
}
// Unbind products from a certificate
@@ -445,13 +471,15 @@ type PossibleRejectReasonsResponse struct {
core.CommonResponse
// Certificate rejection reasons
Result []struct {
// Сode of a certificate rejection reason
Code string `json:"code"`
Result []PossibleRejectReasonsResult `json:"result"`
}
// Description of a certificate rejection reason
Name string `json:"name"`
} `json:"result"`
type PossibleRejectReasonsResult struct {
// Сode of a certificate rejection reason
Code string `json:"code"`
// Description of a certificate rejection reason
Name string `json:"name"`
}
// Possible certificate rejection reasons
@@ -473,13 +501,15 @@ type PossibleStatusesResponse struct {
core.CommonResponse
// Possible certificate statuses
Result []struct {
// Certificate status code
Code string `json:"code"`
Result []PossibleStatusesResult `json:"result"`
}
// Status description
Name string `json:"name"`
} `json:"result"`
type PossibleStatusesResult struct {
// Certificate status code
Code string `json:"code"`
// Status description
Name string `json:"name"`
}
func (c Certificates) PossibleStatuses() (*PossibleStatusesResponse, error) {

256
ozon/chats.go
View File

@@ -38,36 +38,7 @@ type ListChatsResponse struct {
core.CommonResponse
// Chats data
Chats []struct {
// Chat data
Chat struct {
// Chat identifier
ChatId string `json:"chat_id"`
// Chat status:
// - All
// - Opened
// - Closed
ChatStatus string `json:"chat_status"`
// Chat type:
// - Seller_Support — support chat
// - Buyer_Seller — chat with a customer
ChatType string `json:"chat_type"`
// Chat creation date
CreatedAt time.Time `json:"created_at"`
} `json:"chat"`
// Identifier of the first unread chat message
FirstUnreadMessageId string `json:"first_unread_message_id"`
// Identifier of the last message in the chat
LastMessageId string `json:"last_message_id"`
// Number of unread messages in the chat
UnreadCount int64 `json:"unread_count"`
} `json:"chats"`
Chats []ListChatsChat `json:"chats"`
// Total number of chats
TotalChatsCount int64 `json:"total_chats_count"`
@@ -76,6 +47,39 @@ type ListChatsResponse struct {
TotalUnreadCount int64 `json:"total_unread_count"`
}
type ListChatsChat struct {
// Chat data
Chat ListChatsChatData `json:"chat"`
// Identifier of the first unread chat message
FirstUnreadMessageId string `json:"first_unread_message_id"`
// Identifier of the last message in the chat
LastMessageId string `json:"last_message_id"`
// Number of unread messages in the chat
UnreadCount int64 `json:"unread_count"`
}
type ListChatsChatData struct {
// Chat identifier
ChatId string `json:"chat_id"`
// Chat status:
// - All
// - Opened
// - Closed
ChatStatus string `json:"chat_status"`
// Chat type:
// - Seller_Support — support chat
// - Buyer_Seller — chat with a customer
ChatType string `json:"chat_type"`
// Chat creation date
CreatedAt time.Time `json:"created_at"`
}
// Returns information about chats by specified filters
func (c Chats) List(params *ListChatsParams) (*ListChatsResponse, error) {
url := "/v2/chat/list"
@@ -179,33 +183,37 @@ type ChatHistoryResponse struct {
HasNext bool `json:"has_next"`
// An array of messages sorted according to the direction parameter in the request body
Messages []struct {
// Message creation date
CreatedAt time.Time `json:"created_at"`
Messages []ChatHistoryMessage `json:"messages"`
}
// Array with message content in Markdown format
Data []string `json:"data"`
type ChatHistoryMessage struct {
// Message creation date
CreatedAt time.Time `json:"created_at"`
// Indication of the read message
IsRead bool `json:"is_read"`
// Array with message content in Markdown format
Data []string `json:"data"`
// Message identifier
MessageId string `json:"message_id"`
// Indication of the read message
IsRead bool `json:"is_read"`
// Chat participant identifier
User struct {
// Chat participant identifier
Id string `json:"id"`
// Message identifier
MessageId string `json:"message_id"`
// Chat participant type:
// - customer
// - seller
// - crm—system messages
// - courier
// - support
Type string `json:"type"`
} `json:"user"`
} `json:"messages"`
// Chat participant identifier
User ChatHistoryMessageUser `json:"user"`
}
type ChatHistoryMessageUser struct {
// Chat participant identifier
Id string `json:"id"`
// Chat participant type:
// - customer
// - seller
// - crm—system messages
// - courier
// - support
Type string `json:"type"`
}
// Chat history
@@ -238,80 +246,94 @@ type UpdateChatResponse struct {
core.CommonResponse
// Method result
Result []struct {
// An order or a product user wrote about in the chat
Context struct {
// Product inforamtion
Item struct {
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
} `json:"item"`
Result []UpdateChatResult `json:"result"`
}
// Order information
Order struct {
// Order number
OrderNumber string `json:"order_number"`
type UpdateChatResult struct {
// An order or a product user wrote about in the chat
Context UpdateChatResultContext `json:"context"`
// Shipment information
Postings []struct {
// Delivery scheme:
// - FBO
// - FBS
// - RFBS
// - Crossborder
DeliverySchema string `json:"delivery_schema"`
// Creation date and time
CreatedAt time.Time `json:"created_at"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Information about the file in the chat. Displayed only for `type = file`
File UpdateChatResultFile `json:"file"`
// List of product identifiers in the shipment
SKUList []int64 `json:"sku_list"`
} `json:"postings"`
} `json:"order"`
} `json:"context"`
// File identifier
Id uint64 `json:"id"`
// Creation date and time
CreatedAt time.Time `json:"created_at"`
// Message. Displayed only for `type = text`
Text string `json:"text"`
// Information about the file in the chat. Displayed only for `type = file`
File struct {
// File type
Mime string `json:"mime"`
// Message type:
// - text
// - file
Type string `json:"type"`
// File name
Name string `json:"name"`
// Chat participant information
User UpdateChatResultUser `json:"user"`
}
// File size in bytes
Size int64 `json:"size"`
type UpdateChatResultContext struct {
// Product inforamtion
Item UpdateChatResultContextItem `json:"item"`
// File URL
URL string `json:"url"`
} `json:"file"`
// Order information
Order UpdateChatResultContextOrder `json:"order"`
}
// File identifier
Id uint64 `json:"id"`
type UpdateChatResultContextItem struct {
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
}
// Message. Displayed only for `type = text`
Text string `json:"text"`
type UpdateChatResultContextOrder struct {
// Order number
OrderNumber string `json:"order_number"`
// Message type:
// - text
// - file
Type string `json:"type"`
// Shipment information
Postings []UpdateChatResultContextOrderPosting `json:"postings"`
}
// Chat participant information
User struct {
// Chat participant identifier
Id string `json:"id"`
type UpdateChatResultContextOrderPosting struct {
// Delivery scheme:
// - FBO
// - FBS
// - RFBS
// - Crossborder
DeliverySchema string `json:"delivery_schema"`
// Chat participant chat:
// - customer
// - seller
// - crm—system messages
// - courier
Type string `json:"type"`
} `json:"user"`
} `json:"result"`
// Shipment number
PostingNumber string `json:"posting_number"`
// List of product identifiers in the shipment
SKUList []int64 `json:"sku_list"`
}
type UpdateChatResultFile struct {
// File type
Mime string `json:"mime"`
// File name
Name string `json:"name"`
// File size in bytes
Size int64 `json:"size"`
// File URL
URL string `json:"url"`
}
type UpdateChatResultUser struct {
// Chat participant identifier
Id string `json:"id"`
// Chat participant chat:
// - customer
// - seller
// - crm—system messages
// - courier
Type string `json:"type"`
}
// Update chat
@@ -338,10 +360,12 @@ type CreateNewChatResponse struct {
core.CommonResponse
//Method result
Result struct {
// Chat identifier
ChatId string `json:"chat_id"`
} `json:"result"`
Result CreateNewChatResult `json:"result"`
}
type CreateNewChatResult struct {
// Chat identifier
ChatId string `json:"chat_id"`
}
// Creates a new chat on the shipment with the customer. For example, to clarify the address or the product model

344
ozon/fbo.go
View File

@@ -56,69 +56,75 @@ type GetFBOShipmentsListResponse struct {
core.CommonResponse
// Shipments list
Result []struct {
// Additional data for shipment list
AdditionalData []struct {
Key string `json:"key"`
Value string `json:"value"`
} `json:"additional_data"`
Result []GetFBOShipmentsListResult `json:"result"`
}
// Analytical data
AnalyticsData struct {
// Delivery city
City string `json:"city"`
type GetFBOShipmentsListResult struct {
// Additional data for shipment list
AdditionalData []GetFBOShipmentsListResultAdditionalData `json:"additional_data"`
// Delivery method
DeliveryType string `json:"delivery_type"`
// Analytical data
AnalyticsData GetFBOShipmentsListResultAnalyticsData `json:"analytics_data"`
// Indication that the recipient is a legal person
// * true — a legal person,
// * false — a natural person.
IsLegal bool `json:"is_legal"`
// Shipment cancellation reason identifier
CancelReasonId int64 `json:"cancel_reason_id"`
// Premium subscription
IsPremium bool `json:"is_premium"`
// Date and time of shipment creation
CreatedAt time.Time `json:"created_at"`
// Payment method
PaymentTypeGroupName string `json:"payment_type_group_name"`
// Financial data
FinancialData FBOFinancialData `json:"financial_data"`
// Delivery region
Region string `json:"region"`
// Date and time of shipment processing start
InProccessAt time.Time `json:"in_process_at"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// Identifier of the order to which the shipment belongs
OrderId int64 `json:"order_id"`
// Name of the warehouse from which the order is shipped
WarehouseName string `json:"warehouse_name"`
} `json:"analytics_data"`
// Number of the order to which the shipment belongs
OrderNumber string `json:"order_number"`
// Shipment cancellation reason identifier
CancelReasonId int64 `json:"cancel_reason_id"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Date and time of shipment creation
CreatedAt time.Time `json:"created_at"`
// Number of products in the shipment
Products []FBOPostingProduct `json:"products"`
// Financial data
FinancialData FBOFinancialData `json:"financial_data"`
// Shipment status
Status string `json:"status"`
}
// Date and time of shipment processing start
InProccessAt time.Time `json:"in_process_at"`
type GetFBOShipmentsListResultAdditionalData struct {
Key string `json:"key"`
Value string `json:"value"`
}
// Identifier of the order to which the shipment belongs
OrderId int64 `json:"order_id"`
type GetFBOShipmentsListResultAnalyticsData struct {
// Delivery city
City string `json:"city"`
// Number of the order to which the shipment belongs
OrderNumber string `json:"order_number"`
// Delivery method
DeliveryType string `json:"delivery_type"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Indication that the recipient is a legal person
// * true — a legal person,
// * false — a natural person.
IsLegal bool `json:"is_legal"`
// Number of products in the shipment
Products []FBOPostingProduct `json:"products"`
// Premium subscription
IsPremium bool `json:"is_premium"`
// Shipment status
Status string `json:"status"`
} `json:"result"`
// Payment method
PaymentTypeGroupName string `json:"payment_type_group_name"`
// Delivery region
Region string `json:"region"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// Name of the warehouse from which the order is shipped
WarehouseName string `json:"warehouse_name"`
}
type FBOPostingProduct struct {
@@ -196,69 +202,75 @@ type GetShipmentDetailsResponse struct {
core.CommonResponse
// Method result
Result struct {
// Additional data
AdditionalData []struct {
Key string `json:"key"`
Value string `json:"value"`
} `json:"additional_data"`
Result GetShipmentDetailsResult `json:"result"`
}
// Analytical data
AnalyticsData struct {
// Delivery city
City string `json:"Delivery city"`
type GetShipmentDetailsResult struct {
// Additional data
AdditionalData []GetShipmentDetailsResultAdditionalData `json:"additional_data"`
// Delivery method
DeliveryType string `json:"delivery_type"`
// Analytical data
AnalyticsData GetShipmentDetailsResultAnalyticsData `json:"analytics_data"`
// Indication that the recipient is a legal person:
// - true — a legal person
// - false — a natural person
IsLegal bool `json:"is_legal"`
// Shipment cancellation reason identifier
CancelReasonId int64 `json:"cancel_reason_id"`
// Premium subscription
IsPremium bool `json:"is_premium"`
// Date and time of shipment creation
CreatedAt time.Time `json:"created_at"`
// Payment method
PaymentTypeGroupName string `json:"payment_type_group_name"`
// Financial data
FinancialData FBOFinancialData `json:"financial_data"`
// Delivery region
Region string `json:"region"`
// Date and time of shipment processing start
InProcessAt time.Time `json:"in_process_at"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// Identifier of the order to which the shipment belongs
OrderId int64 `json:"order_id"`
// Name of the warehouse from which the order is shipped
WarehouseName string `json:"warehouse_name"`
} `json:"analytics_data"`
// Number of the order to which the shipment belongs
OrderNumber string `json:"order_number"`
// Shipment cancellation reason identifier
CancelReasonId int64 `json:"cancel_reason_id"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Date and time of shipment creation
CreatedAt time.Time `json:"created_at"`
// Number of products in the shipment
Products []FBOPostingProduct `json:"products"`
// Financial data
FinancialData FBOFinancialData `json:"financial_data"`
// Shipment status
Status string `json:"status"`
}
// Date and time of shipment processing start
InProcessAt time.Time `json:"in_process_at"`
type GetShipmentDetailsResultAdditionalData struct {
Key string `json:"key"`
Value string `json:"value"`
}
// Identifier of the order to which the shipment belongs
OrderId int64 `json:"order_id"`
type GetShipmentDetailsResultAnalyticsData struct {
// Delivery city
City string `json:"Delivery city"`
// Number of the order to which the shipment belongs
OrderNumber string `json:"order_number"`
// Delivery method
DeliveryType string `json:"delivery_type"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Indication that the recipient is a legal person:
// - true — a legal person
// - false — a natural person
IsLegal bool `json:"is_legal"`
// Number of products in the shipment
Products []FBOPostingProduct `json:"products"`
// Premium subscription
IsPremium bool `json:"is_premium"`
// Shipment status
Status string `json:"status"`
} `json:"result"`
// Payment method
PaymentTypeGroupName string `json:"payment_type_group_name"`
// Delivery region
Region string `json:"region"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// Name of the warehouse from which the order is shipped
WarehouseName string `json:"warehouse_name"`
}
// Returns information about the shipment by its identifier
@@ -307,13 +319,7 @@ type SupplyRequestCommonResponse struct {
CreatedAt string `json:"created_at"`
// Local time supply interval
LocalTimeslot struct {
// Interval start
From string `json:"from"`
// Interval end
To string `json:"to"`
} `json:"local_timeslot"`
LocalTimeslot SupplyRequestCommonResponseLocalTimeslot `json:"local_timeslot"`
// Date from which you want to bring the supply to the warehouse. Only for supplies via vDC
PreferredSupplyDataFrom string `json:"preferred_supply_data_from"`
@@ -331,16 +337,7 @@ type SupplyRequestCommonResponse struct {
SupplyOrderNumber string `json:"supply_order_number"`
// Supply warehouse
SupplyWarehouse struct {
// Warehouse address
Address string `json:address"`
// Warehouse name
Name string `json:"name"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
} `json:"supply_warehouse"`
SupplyWarehouse SupplyRequestCommonResponseSupplyWarehouse `json:"supply_warehouse"`
// time_left_to_prepare_supply
TimeLeftToPrepareSupply int64 `json:"time_left_to_prepare_supply"`
@@ -355,6 +352,25 @@ type SupplyRequestCommonResponse struct {
TotalQuantity int32 `json:"total_quantity"`
}
type SupplyRequestCommonResponseLocalTimeslot struct {
// Interval start
From string `json:"from"`
// Interval end
To string `json:"to"`
}
type SupplyRequestCommonResponseSupplyWarehouse struct {
// Warehouse address
Address string `json:"address"`
// Warehouse name
Name string `json:"name"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
}
// Method for getting a list of supply requests to the Ozon warehouse.
// Requests with supply both to a specific warehouse and via a virtual
// distribution center (vDC) are taken into account
@@ -383,19 +399,21 @@ type GetSupplyRequestInfoResponse struct {
SupplyRequestCommonResponse
// Driver and car information
VehicleInfo struct {
// Driver name
DriverName string `json:"driver_name"`
VehicleInfo GetSupplyRequestInfoVehicle `json:"vehicle_info"`
}
// Driver phone number
DriverPhone string `json:"driver_phone"`
type GetSupplyRequestInfoVehicle struct {
// Driver name
DriverName string `json:"driver_name"`
// Car model
VehicleModel string `json:"vehicle_model"`
// Driver phone number
DriverPhone string `json:"driver_phone"`
// Car number
VehicleNumber string `json:"vehicle_number"`
} `json:"vehicle_info"`
// Car model
VehicleModel string `json:"vehicle_model"`
// Car number
VehicleNumber string `json:"vehicle_number"`
}
// Method for getting detailed information on a supply request.
@@ -435,27 +453,29 @@ type ListProductsInSupplyRequestResponse struct {
HasNext bool `json:"has_next"`
// Products list
Items []struct {
// Link to product image
IconPath string `json:"icon_path"`
// Product name
Name string `json:"name"`
// Product ID
OfferId string `json:"offer_id"`
// Product quantity
Quantity int64 `json:"quantity"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
} `json:"items"`
Items []ListProductsInSupplyRequestItem `json:"items"`
// Total number of products in the request
TotalItemsCount int32 `json:"total_items_count"`
}
type ListProductsInSupplyRequestItem struct {
// Link to product image
IconPath string `json:"icon_path"`
// Product name
Name string `json:"name"`
// Product ID
OfferId string `json:"offer_id"`
// Product quantity
Quantity int64 `json:"quantity"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
}
// List of products in the sullpy request
func (c FBO) ListProductsInSupplyRequest(params *ListProductsInSupplyRequestParams) (*ListProductsInSupplyRequestResponse, error) {
url := "/v1/supply-order/items"
@@ -475,34 +495,42 @@ type GetWarehouseWorkloadResponse struct {
core.CommonResponse
// Method result
Result []struct {
// Workload
Schedule struct {
// Data on the products quantity supplied to the warehouse
Capacity []struct {
// Period start, local time
Start time.Time `json:"start"`
Result []GetWarehouseWorkloadResult `json:"result"`
}
// Period end, local time
End time.Time `json:"end"`
type GetWarehouseWorkloadResult struct {
// Workload
Schedule GetWarehouseWorkloadResultSchedule `json:"schedule"`
// Average number of products that the warehouse can accept per day for the period
Value int32 `json:"value"`
} `json:"capacity"`
// Warehouse
Warehouse GetWarehouseWorkloadResultWarehouse `json:"warehouse"`
}
// The closest available date for supply, local time
Date time.Time `json:"date"`
} `json:"schedule"`
type GetWarehouseWorkloadResultSchedule struct {
// Data on the products quantity supplied to the warehouse
Capacity []GetWarehouseWorkloadResultScheduleCapacity `json:"capacity"`
// Warehouse
Warehouse struct {
// Warehouse identifier
Id string `json:"id"`
// The closest available date for supply, local time
Date time.Time `json:"date"`
}
// Warehouse name
Name string `json:"name"`
} `json:"warehouse"`
} `json:"result"`
type GetWarehouseWorkloadResultScheduleCapacity struct {
// Period start, local time
Start time.Time `json:"start"`
// Period end, local time
End time.Time `json:"end"`
// Average number of products that the warehouse can accept per day for the period
Value int32 `json:"value"`
}
type GetWarehouseWorkloadResultWarehouse struct {
// Warehouse identifier
Id string `json:"id"`
// Warehouse name
Name string `json:"name"`
}
// Method returns a list of active Ozon warehouses with information about their average workload in the nearest future

1198
ozon/fbs.go
View File

File diff suppressed because it is too large Load Diff

376
ozon/finance.go
View File

@@ -20,126 +20,132 @@ type ReportOnSoldProductsResponse struct {
core.CommonResponse
// Query result
Result []struct {
// Report title page
Header []struct {
// Report ID
Id string `json:"num"`
Result []ReportonSoldProductsResult `json:"result"`
}
// Report generation date
DocDate string `json:"doc_date"`
type ReportonSoldProductsResult struct {
// Report title page
Header []ReportOnSoldProductsResultHeader `json:"header"`
// Date of the offer agreement
ContractDate string `json:"contract_date"`
// Report table
Rows []ReportOnSoldProductsResultRow `json:"rows"`
}
// Offer agreement number
ContractNum string `json:"contract_num"`
type ReportOnSoldProductsResultHeader struct {
// Report ID
Id string `json:"num"`
// Currency of your prices
CurrencyCode string `json:"currency_code"`
// Report generation date
DocDate string `json:"doc_date"`
// Amount to accrue
DocAmount float64 `json:"doc_amount"`
// Date of the offer agreement
ContractDate string `json:"contract_date"`
// Amount to accrue with VAT
VATAmount float64 `json:"vat_amount"`
// Offer agreement number
ContractNum string `json:"contract_num"`
// Payer's TIN
PayerINN string `json:"payer_inn"`
// Currency of your prices
CurrencyCode string `json:"currency_code"`
// Payer's Tax Registration Reason Code (KPP)
PayerKPP string `json:"payer_kpp"`
// Amount to accrue
DocAmount float64 `json:"doc_amount"`
// Payer's name
PayerName string `json:"payer_name"`
// Amount to accrue with VAT
VATAmount float64 `json:"vat_amount"`
// Recipient's TIN
RecipientINN string `json:"rcv_inn"`
// Payer's TIN
PayerINN string `json:"payer_inn"`
// Recipient's Tax Registration Reason Code (KPP)
RecipientKPP string `json:"rcv_kpp"`
// Payer's Tax Registration Reason Code (KPP)
PayerKPP string `json:"payer_kpp"`
// Recipient's name
RecipientName string `json:"rcv_name"`
// Payer's name
PayerName string `json:"payer_name"`
// Period start in the report
StartDate string `json:"start_date"`
// Recipient's TIN
RecipientINN string `json:"rcv_inn"`
// Period end in the report
StopDate string `json:"stop_date"`
} `json:"header"`
// Recipient's Tax Registration Reason Code (KPP)
RecipientKPP string `json:"rcv_kpp"`
// Report table
Rows []struct {
// Row number
RowNumber int32 `json:"row_number"`
// Recipient's name
RecipientName string `json:"rcv_name"`
// Product ID
ProductId int64 `json:"product_id"`
// Period start in the report
StartDate string `json:"start_date"`
// Product name
ProductName string `json:"product_name"`
// Period end in the report
StopDate string `json:"stop_date"`
}
// Product barcode
Barcode string `json:"barcode"`
type ReportOnSoldProductsResultRow struct {
// Row number
RowNumber int32 `json:"row_number"`
// Product identifier in the seller's system
OfferId string `json:"offer_id"`
// Product ID
ProductId int64 `json:"product_id"`
// Sales commission by category
CommissionPercent float64 `json:"commission_percent"`
// Product name
ProductName string `json:"product_name"`
// Seller's price with their discount
Price float64 `json:"price"`
// Product barcode
Barcode string `json:"barcode"`
// Selling price: the price at which the customer purchased the product. For sold products
PriceSale float64 `json:"price_sale"`
// Product identifier in the seller's system
OfferId string `json:"offer_id"`
// Sold for amount.
//
// Sold products cost considering the quantity and regional coefficients. Calculation is made by the sale_amount price
SaleAmount float64 `json:"sale_amount"`
// Sales commission by category
CommissionPercent float64 `json:"commission_percent"`
// Commission for sold products, including discounts and extra charges
SaleCommission float64 `json:"sale_commission"`
// Seller's price with their discount
Price float64 `json:"price"`
// Extra charge at the expense of Ozon.
//
// Amount that Ozon will compensate the seller if the Ozon discount is greater than or equal to the sales commission
SaleDiscount float64 `json:"sale_discount"`
// Selling price: the price at which the customer purchased the product. For sold products
PriceSale float64 `json:"price_sale"`
// Total accrual for the products sold.
//
// Amount after deduction of sales commission, application of discounts and extra charges
SalePriceSeller float64 `json:"sale_price_seller"`
// Sold for amount.
//
// Sold products cost considering the quantity and regional coefficients. Calculation is made by the sale_amount price
SaleAmount float64 `json:"sale_amount"`
// Quantity of products sold at the price_sale price
SaleQuantity int32 `json:"sale_qty"`
// Commission for sold products, including discounts and extra charges
SaleCommission float64 `json:"sale_commission"`
// Price at which the customer purchased the product. For returned products
ReturnSale float64 `json:"return_sale"`
// Extra charge at the expense of Ozon.
//
// Amount that Ozon will compensate the seller if the Ozon discount is greater than or equal to the sales commission
SaleDiscount float64 `json:"sale_discount"`
// Cost of returned products, taking into account the quantity and regional coefficients.
// Calculation is carried out at the return_sale price
ReturnAmount float64 `json:"return_amount"`
// Total accrual for the products sold.
//
// Amount after deduction of sales commission, application of discounts and extra charges
SalePriceSeller float64 `json:"sale_price_seller"`
// Commission including the quantity of products, discounts and extra charges.
// Ozon compensates it for the returned products
ReturnCommission float64 `json:"return_commission"`
// Quantity of products sold at the price_sale price
SaleQuantity int32 `json:"sale_qty"`
// Extra charge at the expense of Ozon.
//
// Amount of the discount at the expense of Ozon on returned products.
// Ozon will compensate it to the seller if the Ozon discount is greater than or equal to the sales commission
ReturnDiscount float64 `json:"return_discount"`
// Price at which the customer purchased the product. For returned products
ReturnSale float64 `json:"return_sale"`
// Amount charged to the seller for returned products after deducing sales commissions, applying discounts and extra charges
ReturnPriceSeller float64 `json:"return_price_seller"`
// Cost of returned products, taking into account the quantity and regional coefficients.
// Calculation is carried out at the return_sale price
ReturnAmount float64 `json:"return_amount"`
// Quantity of returned products
ReturnQuantity int32 `json:"return_qty"`
} `json:"rows"`
} `json:"result"`
// Commission including the quantity of products, discounts and extra charges.
// Ozon compensates it for the returned products
ReturnCommission float64 `json:"return_commission"`
// Extra charge at the expense of Ozon.
//
// Amount of the discount at the expense of Ozon on returned products.
// Ozon will compensate it to the seller if the Ozon discount is greater than or equal to the sales commission
ReturnDiscount float64 `json:"return_discount"`
// Amount charged to the seller for returned products after deducing sales commissions, applying discounts and extra charges
ReturnPriceSeller float64 `json:"return_price_seller"`
// Quantity of returned products
ReturnQuantity int32 `json:"return_qty"`
}
// Returns information on products sold and returned within a month. Canceled or non-purchased products are not included.
@@ -196,40 +202,42 @@ type GetTotalTransactionsSumResponse struct {
core.CommonResponse
// Method result
Result struct {
// Total cost of products and returns for specified period
AccrualsForSale float64 `json:"accruals_for_sale"`
Result GetTotalTransactionsSumResult `json:"result"`
}
// Compensations
CompensationAmount float64 `json:"compensatino_amount"`
type GetTotalTransactionsSumResult struct {
// Total cost of products and returns for specified period
AccrualsForSale float64 `json:"accruals_for_sale"`
// Charges for delivery and returns when working under rFBS scheme
MoneyTransfer float64 `json:"money_transfer"`
// Compensations
CompensationAmount float64 `json:"compensatino_amount"`
// Other accurals
OthersAmount float64 `json:"others_amount"`
// Charges for delivery and returns when working under rFBS scheme
MoneyTransfer float64 `json:"money_transfer"`
// Cost of shipment processing, orders packaging, pipeline and last mile services, and delivery cost before the new commissions and rates applied from February 1, 2021.
//
// Pipeline is delivery of products from one cluster to another.
//
// Last mile is products delivery to the pick-up point, parcle terminal, or by courier
ProcessingAndDelivery float64 `json:"processing_and_delivery"`
// Other accurals
OthersAmount float64 `json:"others_amount"`
// Cost of reverse pipeline, returned, canceled and unredeemed orders processing, and return cost before the new commissions and rates applied from February 1, 2021.
//
// Pipeline is delivery of products from one cluster to another.
//
// Last mile is products delivery to the pick-up point, parcle terminal, or by courier
RefundsAndCancellations float64 `json:"refunds_and_cancellations"`
// Cost of shipment processing, orders packaging, pipeline and last mile services, and delivery cost before the new commissions and rates applied from February 1, 2021.
//
// Pipeline is delivery of products from one cluster to another.
//
// Last mile is products delivery to the pick-up point, parcle terminal, or by courier
ProcessingAndDelivery float64 `json:"processing_and_delivery"`
// The commission withheld when the product was sold and refunded when the product was returned
SaleCommission float64 `json:"sale_commission"`
// Cost of reverse pipeline, returned, canceled and unredeemed orders processing, and return cost before the new commissions and rates applied from February 1, 2021.
//
// Pipeline is delivery of products from one cluster to another.
//
// Last mile is products delivery to the pick-up point, parcle terminal, or by courier
RefundsAndCancellations float64 `json:"refunds_and_cancellations"`
// The additional services cost that are not directly related to deliveries and returns.
// For example, promotion or product placement
ServicesAmount float64 `json:"services_amount"`
} `json:"result"`
// The commission withheld when the product was sold and refunded when the product was returned
SaleCommission float64 `json:"sale_commission"`
// The additional services cost that are not directly related to deliveries and returns.
// For example, promotion or product placement
ServicesAmount float64 `json:"services_amount"`
}
// Returns total sums for transactions for specified period
@@ -247,7 +255,7 @@ func (c Finance) GetTotalTransactionsSum(params *GetTotalTransactionsSumParams)
return resp, nil
}
type ListTransactionsParams struct{
type ListTransactionsParams struct {
// Filter
Filter ListTransactionsFilter `json:"filter"`
@@ -258,7 +266,7 @@ type ListTransactionsParams struct{
PageSize int64 `json:"page_size"`
}
type ListTransactionsFilter struct{
type ListTransactionsFilter struct {
// Filter by date
Date ListTransactionsFilterDate `json:"date"`
@@ -272,105 +280,115 @@ type ListTransactionsFilter struct{
TransactionType string `json:"transaction_type"`
}
type ListTransactionsFilterDate struct{
type ListTransactionsFilterDate struct {
// Period start.
//
//
// Format: YYYY-MM-DDTHH:mm:ss.sssZ.
// Example: 2019-11-25T10:43:06.51
From time.Time `json:"from"`
// Period end.
//
//
// Format: YYYY-MM-DDTHH:mm:ss.sssZ.
// Example: 2019-11-25T10:43:06.51
To time.Time `json:"to"`
}
type ListTransactionsResponse struct{
type ListTransactionsResponse struct {
core.CommonResponse
// Method result
Result struct{
// Transactions infromation
Operations []struct{
// Cost of the products with seller's discounts applied
AccrualsForSale float64 `json:"accruals_for_sale"`
Result ListTransactionsResult `json:"result"`
}
// Total transaction sum
Amount float64 `json:"amount"`
type ListTransactionsResult struct {
// Transactions infromation
Operations []ListTransactionsResultOperation `json:"operations"`
// Delivery cost for charges by rates that were in effect until February 1, 2021, and for charges for bulky products
DeliveryCharge float64 `json:"delivery_charge"`
// Number of pages
PageCount int64 `json:"page_count"`
// Product information
Items []struct{
// Product name
Name string `json:"name"`
// Number of products
RowCount int64 `json:"row_count"`
}
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
} `json:"items"`
type ListTransactionsResultOperation struct {
// Cost of the products with seller's discounts applied
AccrualsForSale float64 `json:"accruals_for_sale"`
// Operation date
OperationDate string `json:"operation_date"`
// Total transaction sum
Amount float64 `json:"amount"`
// Operation identifier
OperationId int64 `json:"operation_id"`
// Delivery cost for charges by rates that were in effect until February 1, 2021, and for charges for bulky products
DeliveryCharge float64 `json:"delivery_charge"`
// Operation type
OperationType string `json:"operation_type"`
// Product information
Items []ListTransactionsResultOperationItem `json:"items"`
// Operation type name
OperationTypeName string `json:"operation_type_name"`
// Operation date
OperationDate string `json:"operation_date"`
// Shipment information
Posting struct{
// Delivery scheme:
// - FBO — delivery to Ozon warehouse
// - FBS — delivery from seller's warehouse
// - RFBS — delivery service of seller's choice
// - Crossborder — delivery from abroad
DeliverySchema string `json:"delivery_schema"`
// Operation identifier
OperationId int64 `json:"operation_id"`
// Date the product was accepted for processing
OrderDate string `json:"order_date"`
// Operation type
OperationType string `json:"operation_type"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Operation type name
OperationTypeName string `json:"operation_type_name"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
} `json:"posting"`
// Shipment information
Posting ListTransactionsResultOperationPosting `json:"posting"`
// Returns and cancellation cost for charges by rates that were in effect until February 1, 2021, and for charges for bulky products
ReturnDeliveryCharge float64 `json:"return_delivery_charge"`
// Returns and cancellation cost for charges by rates that were in effect until February 1, 2021, and for charges for bulky products
ReturnDeliveryCharge float64 `json:"return_delivery_charge"`
// Sales commission or sales commission refund
SaleCommission float64 `json:"sale_commission"`
// Sales commission or sales commission refund
SaleCommission float64 `json:"sale_commission"`
// Additional services
Services []struct{
// Service name
Name string `json:"name"`
// Additional services
Services []ListTransactionsResultOperationService `json:"services"`
// Price
Price float64 `json:"price"`
} `json:"services"`
// Transaction type
Type string `json:"type"`
}
// Transaction type
Type string `json:"type"`
} `json:"operations"`
type ListTransactionsResultOperationItem struct {
// Product name
Name string `json:"name"`
// Number of pages
PageCount int64 `json:"page_count"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
}
// Number of products
RowCount int64 `json:"row_count"`
} `json:"result"`
type ListTransactionsResultOperationPosting struct {
// Delivery scheme:
// - FBO — delivery to Ozon warehouse
// - FBS — delivery from seller's warehouse
// - RFBS — delivery service of seller's choice
// - Crossborder — delivery from abroad
DeliverySchema string `json:"delivery_schema"`
// Date the product was accepted for processing
OrderDate string `json:"order_date"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
}
type ListTransactionsResultOperationService struct {
// Service name
Name string `json:"name"`
// Price
Price float64 `json:"price"`
}
// Returns detailed information on all accruals. The maximum period for which you can get information in one request is 1 month.
//
//
// If you don't specify the posting_number in request, the response contains all shipments for the specified period or shipments of a certain type
func (c Finance) ListTransactions(params *ListTransactionsParams) (*ListTransactionsResponse, error) {
url := "/v3/finance/transaction/list"

10
ozon/invoices.go
View File

@@ -49,10 +49,12 @@ type GetProformaLinkResponse struct {
core.CommonResponse
// Method result
Result struct {
// Proforma invoice link
FileURL string `json:"file_url"`
} `json:"result"`
Result GetProformaLinkResult `json:"result"`
}
type GetProformaLinkResult struct {
// Proforma invoice link
FileURL string `json:"file_url"`
}
// Get a proforma invoice link

1434
ozon/products.go
View File

File diff suppressed because it is too large Load Diff

446
ozon/promotions.go
View File

@@ -15,59 +15,61 @@ type GetAvailablePromotionsResponse struct {
core.CommonResponse
// Method result
Result []struct {
// Promotion identifier
Id float64 `json:"id"`
Result []GetAvailablePromotionsResult `json:"result"`
}
// Promotion name
Title string `json:"title"`
type GetAvailablePromotionsResult struct {
// Promotion identifier
Id float64 `json:"id"`
// Promotion type
ActionType string `json:"action_type"`
// Promotion name
Title string `json:"title"`
// Promotion description
Description string `json:"description"`
// Promotion type
ActionType string `json:"action_type"`
// Promotion start date
DateStart string `json:"date_start"`
// Promotion description
Description string `json:"description"`
// Promotion end date
DateEnd string `json:"date_end"`
// Promotion start date
DateStart string `json:"date_start"`
// Promotion freeze date.
//
// If the field is filled, the seller can't increase prices, change the list of products, or decrease the number of product units in the promotion.
//
// The seller can lower prices and increase the product units number in the promotion
FreezeDate string `json:"freeze_date"`
// Promotion end date
DateEnd string `json:"date_end"`
// Number of products that can participate in the promotion
PotentialProductsCount float64 `json:"potential_products_count"`
// Promotion freeze date.
//
// If the field is filled, the seller can't increase prices, change the list of products, or decrease the number of product units in the promotion.
//
// The seller can lower prices and increase the product units number in the promotion
FreezeDate string `json:"freeze_date"`
// Number of products that participate in the promotion
ParticipatingProductsCount float64 `json:"participating_products_count"`
// Number of products that can participate in the promotion
PotentialProductsCount float64 `json:"potential_products_count"`
// Whether or not you participate in the promotion
IsParticipating bool `json:"participating"`
// Number of products that participate in the promotion
ParticipatingProductsCount float64 `json:"participating_products_count"`
// Indication that customers need a promo code to participate in the promotion
IsVoucherAction bool `json:"is_voucher_action"`
// Whether or not you participate in the promotion
IsParticipating bool `json:"participating"`
// Number of blocked products
BannedProductsCount float64 `json:"banned_products_count"`
// Indication that customers need a promo code to participate in the promotion
IsVoucherAction bool `json:"is_voucher_action"`
// Indication of the promotion is with the target audience
WithTargeting bool `json:"with_targeting"`
// Number of blocked products
BannedProductsCount float64 `json:"banned_products_count"`
// Order amount
OrderAmount float64 `json:"order_amount"`
// Indication of the promotion is with the target audience
WithTargeting bool `json:"with_targeting"`
// Discount type
DiscountType string `json:"discount_type"`
// Order amount
OrderAmount float64 `json:"order_amount"`
// Discount size
DiscountValue float64 `json:"discount_value"`
} `json:"result"`
// Discount type
DiscountType string `json:"discount_type"`
// Discount size
DiscountValue float64 `json:"discount_value"`
}
// A method for getting a list of promotions that you can participate in
@@ -108,19 +110,23 @@ type AddProductToPromotionResponse struct {
core.CommonResponse
// Method result
Result struct {
// List of product identifiers that were added to the promotion
ProductIds []float64 `json:"product_ids"`
Result AddProductToPromotionResult `json:"result"`
}
// List of products that weren't added to the promotion
Rejected []struct {
// Product identifier
ProductId float64 `json:"product_id"`
type AddProductToPromotionResult struct {
// List of product identifiers that were added to the promotion
ProductIds []float64 `json:"product_ids"`
// Reason why the product wasn't added to the promotion
Reason string `json:"reason"`
} `json:"rejected"`
} `json:"result"`
// List of products that weren't added to the promotion
Rejected []AddProductToPromotionResultRejected `json:"rejected"`
}
type AddProductToPromotionResultRejected struct {
// Product identifier
ProductId float64 `json:"product_id"`
// Reason why the product wasn't added to the promotion
Reason string `json:"reason"`
}
// A method for adding products to an available promotion
@@ -154,13 +160,15 @@ type ProductsAvailableForPromotionResponse struct {
core.CommonResponse
// Method result
Result struct {
// Products list
Products []PromotionProduct `json:"products"`
Result ProductsAvailableForPromotionResult `json:"result"`
}
// Total number of products that can participate in the promotion
Total float64 `json:"total"`
} `json:"result"`
type ProductsAvailableForPromotionResult struct {
// Products list
Products []PromotionProduct `json:"products"`
// Total number of products that can participate in the promotion
Total float64 `json:"total"`
}
type PromotionProduct struct {
@@ -216,13 +224,15 @@ type ProductsInPromotionResponse struct {
core.CommonResponse
// Method result
Result struct {
// Products list
Products []PromotionProduct `json:"products"`
Result ProductsInPromotionResult `json:"reuslt"`
}
// Total number of products that can participate in the promotion
Total float64 `json:"total"`
} `json:"reuslt"`
type ProductsInPromotionResult struct {
// Products list
Products []PromotionProduct `json:"products"`
// Total number of products that can participate in the promotion
Total float64 `json:"total"`
}
// A method for getting the list of products participating in the promotion by its identifier
@@ -252,19 +262,23 @@ type RemoveProductFromPromotionResponse struct {
core.CommonResponse
// Method result
Result struct {
// List of product identifiers that were removed from the promotion
ProductIds []float64 `json:"product_ids"`
Result RemoveProductFromPromotionResult `json:"result"`
}
// List of product identifiers that weren't removed from the promotion
Rejected []struct {
// Product identifier
ProductId float64 `json:"product_id"`
type RemoveProductFromPromotionResult struct {
// List of product identifiers that were removed from the promotion
ProductIds []float64 `json:"product_ids"`
// Reason why the product wasn't removed from the promotion
Reason string `json:"reason"`
} `json:"rejected"`
} `json:"result"`
// List of product identifiers that weren't removed from the promotion
Rejected []RemoveProductFromPromotionResultRejected `json:"rejected"`
}
type RemoveProductFromPromotionResultRejected struct {
// Product identifier
ProductId float64 `json:"product_id"`
// Reason why the product wasn't removed from the promotion
Reason string `json:"reason"`
}
// A method for removing products from the promotion
@@ -286,33 +300,35 @@ type ListHotSalePromotionsResponse struct {
core.CommonResponse
// Method result
Result []struct {
// Promotion end date
DateEnd string `json:"date_end"`
Result []ListHotSalePromotionsResult `json:"result"`
}
// Promotion start date
DateStart string `json:"date_start"`
type ListHotSalePromotionsResult struct {
// Promotion end date
DateEnd string `json:"date_end"`
// Promotion description
Description string `json:"description"`
// Promotion start date
DateStart string `json:"date_start"`
// Promotion freeze date.
//
// If the field is filled, the seller can't increase prices, change the list of products,
// or decrease the number of product units in the promotion.
//
// The seller can lower prices and increase the product units number in the promotion
FreezeDate string `json:"freeze_date"`
// Promotion description
Description string `json:"description"`
// Hot Sale promotion identifier
HotsaleId float64 `json:"hotsale_id"`
// Promotion freeze date.
//
// If the field is filled, the seller can't increase prices, change the list of products,
// or decrease the number of product units in the promotion.
//
// The seller can lower prices and increase the product units number in the promotion
FreezeDate string `json:"freeze_date"`
// Indication that you participate in this promotion
IsParticipating bool `json:"is_participating"`
// Hot Sale promotion identifier
HotsaleId float64 `json:"hotsale_id"`
// Promotion name
Title string `json:"title"`
} `json:"result"`
// Indication that you participate in this promotion
IsParticipating bool `json:"is_participating"`
// Promotion name
Title string `json:"title"`
}
// List of available Hot Sale promotions
@@ -345,34 +361,38 @@ type ProductsAvailableForHotSalePromotionResponse struct {
core.CommonResponse
// Method result
Result struct {
// Products list
Products []struct {
// Promotional product price
ActionPrice float64 `json:"action_price"`
Result ProductsAvailableForHotSalePromotionResult `json:"result"`
}
// Date when the product participates in the promotion in the YYYY-MM-DD format
DateDayPromo string `json:"date_day_promo"`
type ProductsAvailableForHotSalePromotionResult struct {
// Products list
Products []ProductsAvailableForHotSalePromotionResultProduct `json:"products"`
// Product identifier
Id float64 `json:"id"`
// Total number of products that are available for the promotion
Total float64 `json:"total"`
}
// Indication that product participates in the promotion
IsActive bool `json:"is_active"`
type ProductsAvailableForHotSalePromotionResultProduct struct {
// Promotional product price
ActionPrice float64 `json:"action_price"`
// Maximum possible promotional price of the product
MaxActionPrice float64 `json:"max_action_type"`
// Date when the product participates in the promotion in the YYYY-MM-DD format
DateDayPromo string `json:"date_day_promo"`
// Minimum number of product units in a stock discount type promotion
MinStock float64 `json:"min_stock"`
// Product identifier
Id float64 `json:"id"`
// Number of product units in a stock discount type promotion
Stock float64 `json:"stock"`
} `json:"products"`
// Indication that product participates in the promotion
IsActive bool `json:"is_active"`
// Total number of products that are available for the promotion
Total float64 `json:"total"`
} `json:"result"`
// Maximum possible promotional price of the product
MaxActionPrice float64 `json:"max_action_type"`
// Minimum number of product units in a stock discount type promotion
MinStock float64 `json:"min_stock"`
// Number of product units in a stock discount type promotion
Stock float64 `json:"stock"`
}
// Method for getting a list of products that can participate or are already participating in the Hot Sale promotion
@@ -413,16 +433,20 @@ type ProductsToHotSaleResponse struct {
core.CommonResponse
// Method result
Result struct {
// List of products that haven't been added to the promotion
Rejected []struct {
//Product identifier
ProductId float64 `json:"product_id"`
Result ProductsToHotSaleResult `json:"result"`
}
// Reason why the product hasn't been added to the promotion
Reason string `json:"reason"`
} `json:"rejected"`
} `json:"result"`
type ProductsToHotSaleResult struct {
// List of products that haven't been added to the promotion
Rejected []ProductsToHotSaleResultRejected `json:"rejected"`
}
type ProductsToHotSaleResultRejected struct {
//Product identifier
ProductId float64 `json:"product_id"`
// Reason why the product hasn't been added to the promotion
Reason string `json:"reason"`
}
func (c Promotions) AddProductsToHotSale(params *AddProductsToHotSaleParams) (*ProductsToHotSaleResponse, error) {
@@ -477,112 +501,114 @@ type ListDiscountRequestsResponse struct {
core.CommonResponse
// List of requests
Result []struct {
// Request ID
Id uint64 `json:"id"`
Result []ListDiscountRequestsResult `json:"result"`
}
// Request created date
CreatedAt time.Time `json:"created_at"`
type ListDiscountRequestsResult struct {
// Request ID
Id uint64 `json:"id"`
// End time of the request
EndAt time.Time `json:"end_at"`
// Request created date
CreatedAt time.Time `json:"created_at"`
// Time to change the decision
EditedTill time.Time `json:"edited_till"`
// End time of the request
EndAt time.Time `json:"end_at"`
// Request status
Status string `json:"status"`
// Time to change the decision
EditedTill time.Time `json:"edited_till"`
// Customer's name
CustomerName string `json:"customer_name"`
// Request status
Status string `json:"status"`
// Product identifier in the Ozon system, SKU
SKU uint64 `json:"sku"`
// Customer's name
CustomerName string `json:"customer_name"`
// Customer's comment on the request
UserComment string `json:"user_comment"`
// Product identifier in the Ozon system, SKU
SKU uint64 `json:"sku"`
// Seller's comment on the request
SellerComment string `json:"seller_comment"`
// Customer's comment on the request
UserComment string `json:"user_comment"`
// Requested price
RequestedPrice float64 `json:"requested_price"`
// Seller's comment on the request
SellerComment string `json:"seller_comment"`
// Approved price
ApprovedPrice float64 `json:"approved_price"`
// Requested price
RequestedPrice float64 `json:"requested_price"`
// Product price before all discounts
OriginalPrice float64 `json:"original_price"`
// Approved price
ApprovedPrice float64 `json:"approved_price"`
// Discount in rubles
Discount float64 `json:"discount"`
// Product price before all discounts
OriginalPrice float64 `json:"original_price"`
// Discount percentage
DiscountPercent float64 `json:"discount_percent"`
// Discount in rubles
Discount float64 `json:"discount"`
// Base price at which a product is selling on Ozon, if not eligible for a promotion
BasePrice float64 `json:"base_price"`
// Discount percentage
DiscountPercent float64 `json:"discount_percent"`
// The minimum price after auto-application of discounts and promotions
MinAutoPrice float64 `json:"min_auto_price"`
// Base price at which a product is selling on Ozon, if not eligible for a promotion
BasePrice float64 `json:"base_price"`
// ID of the previous customer request for this product
PrevTaskId uint64 `json:"prev_task_id"`
// The minimum price after auto-application of discounts and promotions
MinAutoPrice float64 `json:"min_auto_price"`
// If product is damaged — true
IsDamaged bool `json:"is_damaged"`
// ID of the previous customer request for this product
PrevTaskId uint64 `json:"prev_task_id"`
// Moderation date: review, approval or decline of the request
ModeratedAt time.Time `json:"moderated_at"`
// If product is damaged — true
IsDamaged bool `json:"is_damaged"`
// Discount in rubles approved by the seller. Pass the value 0 if the seller did not approve the request
ApprovedDiscount float64 `json:"approved_discount"`
// Moderation date: review, approval or decline of the request
ModeratedAt time.Time `json:"moderated_at"`
// Discount percentage approved by the seller. Pass the value 0 if the seller did not approve the request
ApprovedDiscountPercent float64 `json:"approved_discount_percent"`
// Discount in rubles approved by the seller. Pass the value 0 if the seller did not approve the request
ApprovedDiscount float64 `json:"approved_discount"`
// Whether the customer has purchased the product. true if purchased
IsPurchased bool `json:"is_purchased"`
// Discount percentage approved by the seller. Pass the value 0 if the seller did not approve the request
ApprovedDiscountPercent float64 `json:"approved_discount_percent"`
// Whether the request was moderated automatically. true if moderation was automatic
IsAutoModerated bool `json:"is_auto_moderated"`
// Whether the customer has purchased the product. true if purchased
IsPurchased bool `json:"is_purchased"`
// Product identifier in the seller's system
OfferId string `json:"offer_id"`
// Whether the request was moderated automatically. true if moderation was automatic
IsAutoModerated bool `json:"is_auto_moderated"`
// Email of the user who processed the request
Email string `json:"email"`
// Product identifier in the seller's system
OfferId string `json:"offer_id"`
// Last name of the user who processed the request
LastName string `json:"last_name"`
// Email of the user who processed the request
Email string `json:"email"`
// First name of the user who processed the request
FirstName string `json:"first_name"`
// Last name of the user who processed the request
LastName string `json:"last_name"`
// Patronymic of the user who processed the request
Patronymic string `json:"patronymic"`
// First name of the user who processed the request
FirstName string `json:"first_name"`
// Approved minimum quantity of products
ApprovedQuantityMin uint64 `json:"approved_quantity_min"`
// Patronymic of the user who processed the request
Patronymic string `json:"patronymic"`
// Approved maximum quantity of products
ApprovedQuantityMax uint64 `json:"approved_quantity_max"`
// Approved minimum quantity of products
ApprovedQuantityMin uint64 `json:"approved_quantity_min"`
// Requested minimum number of products
RequestedQuantityMin uint64 `json:"requested_quantity_min"`
// Approved maximum quantity of products
ApprovedQuantityMax uint64 `json:"approved_quantity_max"`
// Requested maximum number of products
RequestedQuantityMax uint64 `json:"requested_quantity_max"`
// Requested minimum number of products
RequestedQuantityMin uint64 `json:"requested_quantity_min"`
// Requested price with fee
RequestedPriceWithFee float64 `json:"requested_price_with_fee"`
// Requested maximum number of products
RequestedQuantityMax uint64 `json:"requested_quantity_max"`
// Approved price with fee
ApprovedPriceWithFee float64 `json:"approved_price_with_fee"`
// Requested price with fee
RequestedPriceWithFee float64 `json:"requested_price_with_fee"`
// Approved price fee percent
ApprovedPriceFeePercent float64 `json:"approved_price_fee_percent"`
} `json:"result"`
// Approved price with fee
ApprovedPriceWithFee float64 `json:"approved_price_with_fee"`
// Approved price fee percent
ApprovedPriceFeePercent float64 `json:"approved_price_fee_percent"`
}
// Method for getting a list of products that customers want to buy with discount
@@ -626,22 +652,26 @@ type DiscountRequestResponse struct {
core.CommonResponse
// Method result
Result struct {
// Errors when creating a request
FailDetails []struct {
// Request ID
TaskId uint64 `json:"task_id"`
Result DiscountRequestResult `json:"result"`
}
// Error message
ErrorForUser string `json:"error_for_user"`
} `json:"fail_details"`
type DiscountRequestResult struct {
// Errors when creating a request
FailDetails []DiscountRequestResultFailDetail `json:"fail_details"`
// The number of requests with a successful status change
SuccessCount int32 `json:"success_count"`
// The number of requests with a successful status change
SuccessCount int32 `json:"success_count"`
// The number of requests that failed to change their status
FailCount int32 `json:"fail_count"`
} `json:"result"`
// The number of requests that failed to change their status
FailCount int32 `json:"fail_count"`
}
type DiscountRequestResultFailDetail struct {
// Request ID
TaskId uint64 `json:"task_id"`
// Error message
ErrorForUser string `json:"error_for_user"`
}
// You can approve applications in statuses:

214
ozon/rating.go
View File

@@ -15,73 +15,79 @@ type GetCurrentSellerRatingInfoResponse struct {
core.CommonResponse
// Rating groups list
Groups []struct {
// Ratings group name
GroupName string `json:"group_name"`
Groups []GetCurrentSellerRatingInfoGroup `json:"groups"`
}
// Ratings list
Items []struct {
type GetCurrentSellerRatingInfoGroup struct {
// Ratings group name
GroupName string `json:"group_name"`
// Rating change: the ratio of the previous value to the current one
Change struct {
// How the rating value has changed:
// - DIRECTION_UNKNOWN — unknown.
// - DIRECTION_NONE — has not changed.
// - DIRECTION_RISE — has increased.
// - DIRECTION_FALL — has dropped.
Direction string `json:"direction"`
// Ratings list
Items []GetCurrentSellerRatingInfoGroupItem `json:"items"`
// What the change means:
// - MEANING_UNKNOWN — unknown.
// - MEANING_NONE — neutral.
// - MEANING_GOOD — the indicator is improving, everything is good.
// - MEANING_BAD — the indicator is dropping, you should do something.
Meaning string `json:"meaning"`
} `json:"change"`
// An indication that the penalty points balance is exceeded
PenaltyScoreExceeded bool `json:"penalty_score_exceeded"`
// Current rating value
CurrentValue float64 `json:"current_value"`
// An indication that you participate in the Premium program
Premium bool `json:"premium"`
}
// Rating name
Name string `json:"name"`
type GetCurrentSellerRatingInfoGroupItem struct {
// Previous rating value
PastValue float64 `json:"past_value"`
// Rating change: the ratio of the previous value to the current one
Change GetCurrentSellerRatingInfoGroupItemChange `json:"change"`
// System rating name
Rating string `json:"rating"`
// Current rating value
CurrentValue float64 `json:"current_value"`
// What should be the rating value to be considered good:
// - UNKNOWN_DIRECTION — unknown.
// - NEUTRAL — doesn't matter.
// - HIGHER_IS_BETTER — the higher the better.
// - LOWER_IS_BETTER — the lower the better.
RatingDirection string `json:"rating_direction"`
// Rating name
Name string `json:"name"`
// Rating status:
// - UNKNOWN_STATUS — unknown status.
// - OK — everything is OK.
// - WARNING — indicators require attention.
// - CRITICAL — critical rating
Status string `json:"status"`
// Previous rating value
PastValue float64 `json:"past_value"`
// Value type:
// - UNKNOWN_VALUE — unknown,
// - INDEX,
// - PERCENT,
// - TIME,
// - RATIO — coefficient,
// - REVIEW_SCORE — score,
// - COUNT
ValueType string `json:"value_type"`
} `json:"items"`
// System rating name
Rating string `json:"rating"`
// An indication that the penalty points balance is exceeded
PenaltyScoreExceeded bool `json:"penalty_score_exceeded"`
// What should be the rating value to be considered good:
// - UNKNOWN_DIRECTION — unknown.
// - NEUTRAL — doesn't matter.
// - HIGHER_IS_BETTER — the higher the better.
// - LOWER_IS_BETTER — the lower the better.
RatingDirection string `json:"rating_direction"`
// An indication that you participate in the Premium program
Premium bool `json:"premium"`
} `json:"groups"`
// Rating status:
// - UNKNOWN_STATUS — unknown status.
// - OK — everything is OK.
// - WARNING — indicators require attention.
// - CRITICAL — critical rating
Status string `json:"status"`
// Value type:
// - UNKNOWN_VALUE — unknown,
// - INDEX,
// - PERCENT,
// - TIME,
// - RATIO — coefficient,
// - REVIEW_SCORE — score,
// - COUNT
ValueType string `json:"value_type"`
}
type GetCurrentSellerRatingInfoGroupItemChange struct {
// How the rating value has changed:
// - DIRECTION_UNKNOWN — unknown.
// - DIRECTION_NONE — has not changed.
// - DIRECTION_RISE — has increased.
// - DIRECTION_FALL — has dropped.
Direction string `json:"direction"`
// What the change means:
// - MEANING_UNKNOWN — unknown.
// - MEANING_NONE — neutral.
// - MEANING_GOOD — the indicator is improving, everything is good.
// - MEANING_BAD — the indicator is dropping, you should do something.
Meaning string `json:"meaning"`
}
func (c Rating) GetCurrentSellerRatingInfo() (*GetCurrentSellerRatingInfoResponse, error) {
@@ -116,61 +122,71 @@ type GetSellerRatingInfoPeriodResponse struct {
core.CommonResponse
// Information on the Premium program penalty points
PremiumScores []struct {
// Rating name
Rating string `json:"rating"`
// Information on penalty points
Scores []struct {
// Date when the penalty points were received
Date time.Time `json:"date"`
// Rating value for which the penalty points were received
RatingValue float64 `json:"rating_value"`
// Number of received penalty points
Value int32 `json:"value"`
} `json:"scores"`
} `json:"premium_scores"`
PremiumScores []GetSellerRatingInfoPeriodPremiumScores `json:"premium_scores"`
// Information on the seller ratings
Ratings []struct {
// Rating threshold, after which sales will be blocked
DangerThreshold float64 `json:"danger_threshold"`
Ratings []GetSellerRatingInfoPeriodRating `json:"ratings"`
}
// Rating threshold for participation in the Premium program
PremiumThreshold float64 `json:"premium_threshold"`
type GetSellerRatingInfoPeriodPremiumScores struct {
// Rating name
Rating string `json:"rating"`
// Rating system name
Rating string `json:"rating"`
// Information on penalty points
Scores []GetSellerRatingInfoPeriodPremiumScore `json:"scores"`
}
// Rating values list
Values []struct {
// Rating calculation start date
DateFrom time.Time `json:"date_from"`
type GetSellerRatingInfoPeriodPremiumScore struct {
// Date when the penalty points were received
Date time.Time `json:"date"`
// Rating calculation end date
DateTo time.Time `json:"date_to"`
// Rating value for which the penalty points were received
RatingValue float64 `json:"rating_value"`
// Rating status
Status struct {
// Indication if the rating threshold for blocking is exceeded
Danger bool `json:"danger"`
// Number of received penalty points
Value int32 `json:"value"`
}
// Indication whether the threshold for participation in the Premium program has been reached
Premium bool `json:"premium"`
type GetSellerRatingInfoPeriodRating struct {
// Rating threshold, after which sales will be blocked
DangerThreshold float64 `json:"danger_threshold"`
// Indication of a warning that the threshold for blocking may be exceeded
Warning bool `json:"warning"`
} `json:"status"`
// Rating threshold for participation in the Premium program
PremiumThreshold float64 `json:"premium_threshold"`
// Rating value
Value float64 `json:"value"`
} `json:"values"`
// Rating system name
Rating string `json:"rating"`
// Rating threshold, after which a warning about possible blocking appears
WarningThreshold float64 `json:"warning_threshold"`
} `json:"ratings"`
// Rating values list
Values []GetSellerRatingInfoPeriodRatingValue `json:"values"`
// Rating threshold, after which a warning about possible blocking appears
WarningThreshold float64 `json:"warning_threshold"`
}
type GetSellerRatingInfoPeriodRatingValue struct {
// Rating calculation start date
DateFrom time.Time `json:"date_from"`
// Rating calculation end date
DateTo time.Time `json:"date_to"`
// Rating status
Status GetSellerRatingInfoPeriodRatingValueStatus `json:"status"`
// Rating value
Value float64 `json:"value"`
}
type GetSellerRatingInfoPeriodRatingValueStatus struct {
// Indication if the rating threshold for blocking is exceeded
Danger bool `json:"danger"`
// Indication whether the threshold for participation in the Premium program has been reached
Premium bool `json:"premium"`
// Indication of a warning that the threshold for blocking may be exceeded
Warning bool `json:"warning"`
}
func (c Rating) GetSellerRatingInfoForPeriod(params *GetSellerRatingInfoForPeriodParams) (*GetSellerRatingInfoPeriodResponse, error) {

416
ozon/reports.go
View File

@@ -38,45 +38,49 @@ type GetReportsListResponse struct {
core.CommonResponse
// Method result
Result struct {
// Array with generated reports
Reports []struct {
// Unique report identifier
Code string `json:"code"`
Result GetReportsListResult `json:"result"`
}
// Report creation date
CreatedAt time.Time `json:"created_at"`
type GetReportsListResult struct {
// Array with generated reports
Reports []GetReportsListResultReport `json:"reports"`
// Error code when generating the report
Error string `json:"error"`
// Total number of reports
Total int32 `json:"total"`
}
// Link to CSV file
File string `json:"file"`
type GetReportsListResultReport struct {
// Unique report identifier
Code string `json:"code"`
// Array with the filters specified when the seller created the report
Params struct {
} `json:"params"`
// Report creation date
CreatedAt time.Time `json:"created_at"`
// 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"`
// Error code when generating the report
Error string `json:"error"`
// Report generation status
// - `success`
// - `failed`
Status string `json:"status"`
} `json:"reports"`
// Link to CSV file
File string `json:"file"`
// Total number of reports
Total int32 `json:"total"`
} `json:"result"`
// 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"`
}
// Returns the list of reports that have been generated before
@@ -103,38 +107,40 @@ type GetReportDetailsResponse struct {
core.CommonResponse
// Report details
Result struct {
// Unique report identifier
Code string `json:"code"`
Result GetReportDetailResult `json:"result"`
}
// Report creation date
CreatedAt time.Time `json:"created_at"`
type GetReportDetailResult struct {
// Unique report identifier
Code string `json:"code"`
// Error code when generating the report
Error string `json:"error"`
// Report creation date
CreatedAt time.Time `json:"created_at"`
// Link to CSV file
File string `json:"file"`
// Error code when generating the report
Error string `json:"error"`
// Array with the filters specified when the seller created the report
Params map[string]string `json:"params"`
// Link to CSV file
File string `json:"file"`
// 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"`
// Array with the filters specified when the seller created the report
Params map[string]string `json:"params"`
// Report generation status:
// - success
// - failed
Status string `json:"status"`
} `json:"result"`
// 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"`
}
// Returns information about a created report by its identifier
@@ -178,136 +184,170 @@ type GetFinancialReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Reports list
CashFlows []struct {
// Period data
Period struct {
// Period identifier
Id int64 `json:"id"`
Result GetFinancialResultResult `json:"result"`
}
// Period start
Begin time.Time `json:"begin"`
type GetFinancialResultResult struct {
// Reports list
CashFlows []GetFinancialResultResultCashflow `json:"cash_flows"`
// Period end
End time.Time `json:"end"`
} `json:"period"`
// Detailed info
Details GetFinancialResultResultDetail `json:"details"`
// Sum of sold products prices
OrdersAmount float64 `json:"order_amount"`
// Number of pages with reports
PageCount int64 `json:"page_count"`
}
// Sum of returned products prices
ReturnsAmount float64 `json:"returns_amount"`
type GetFinancialResultResultCashflow struct {
// Period data
Period GetFinancialResultResultCashflowPeriod `json:"period"`
// Ozon sales commission
CommissionAmount float64 `json:"commission_amount"`
// Sum of sold products prices
OrdersAmount float64 `json:"order_amount"`
// Additional services cost
ServicesAmount float64 `json:"services_amount"`
// Sum of returned products prices
ReturnsAmount float64 `json:"returns_amount"`
// Logistic services cost
ItemDeliveryAndReturnAmount float64 `json:"item_delivery_and_return_amount"`
// Ozon sales commission
CommissionAmount float64 `json:"commission_amount"`
// Code of the currency used to calculate the commissions
CurrencyCode string `json:"currency_code"`
} `json:"cash_flows"`
// Additional services cost
ServicesAmount float64 `json:"services_amount"`
// Detailed info
Details struct {
// Balance on the beginning of period
BeginBalanceAmount float64 `json:"begin_balance_amount"`
// Logistic services cost
ItemDeliveryAndReturnAmount float64 `json:"item_delivery_and_return_amount"`
// Orders
Delivery struct {
Total float64 `json:"total"`
// Code of the currency used to calculate the commissions
CurrencyCode string `json:"currency_code"`
}
Amount float64 `json:"amount"`
type GetFinancialResultResultCashflowPeriod struct {
// Period identifier
Id int64 `json:"id"`
DeliveryServices struct {
Total float64 `json:"total"`
// Period start
Begin time.Time `json:"begin"`
Items []struct {
Name DetailsDeliveryItemName `json:"name"`
// Period end
End time.Time `json:"end"`
}
Price float64 `json:"price"`
} `json:"items"`
} `json:"delivery_services"`
} `json:"delivery"`
type GetFinancialResultResultDetail struct {
// Balance on the beginning of period
BeginBalanceAmount float64 `json:"begin_balance_amount"`
InvoiceTransfer float64 `json:"invoice_transfer"`
// Orders
Delivery GetFinancialResultResultDetailDelivery `json:"delivery"`
Loan float64 `json:"loan"`
InvoiceTransfer float64 `json:"invoice_transfer"`
Payments []struct {
CurrencyCode string `json:"currency_code"`
Loan float64 `json:"loan"`
Payment float64 `json:"payment"`
} `json:"payments"`
Payments []GetFinancialResultResultDetailPayment `json:"payments"`
Period struct {
Begin time.Time `json:"begin"`
Period GetFinancialResultResultDetailPeriod `json:"period"`
End time.Time `json:"end"`
Return GetFinancialResultResultDetailReturn `json:"return"`
Id int64 `json:"id"`
} `json:"period"`
RFBS GetFinancialResultResultDetailRFBS `json:"rfbs"`
Return struct {
Total float64 `json:"total"`
Services GetFinancialResultResultDetailService `json:"services"`
Amount float64 `json:"amount"`
Others GetFinancialResultResultDetailOthers `json:"others"`
ReturnServices struct {
Total float64 `json:"total"`
EndBalanceAmount float64 `json:"end_balance_amount"`
}
Items []struct {
Name DetailsReturnServiceName `json:"name"`
type GetFinancialResultResultDetailDelivery struct {
Total float64 `json:"total"`
Price float64 `json:"price"`
} `json:"items"`
} `json:"return_services"`
} `json:"return"`
Amount float64 `json:"amount"`
RFBS struct {
Total float64 `json:"total"`
DeliveryServices GetFinancialResultResultDetailDeliveryServices `json:"delivery_services"`
}
TransferDelivery float64 `json:"transfer_delivery"`
type GetFinancialResultResultDetailDeliveryServices struct {
Total float64 `json:"total"`
TransferDeliveryReturn float64 `json:"transfer_delivery_return"`
Items []GetFinancialResultResultDetailDeliveryServicesItem `json:"items"`
}
CompensationDeliveryReturn float64 `json:"compensation_delivery_return"`
type GetFinancialResultResultDetailDeliveryServicesItem struct {
Name DetailsDeliveryItemName `json:"name"`
PartialCompensation float64 `json:"partial_compensation"`
Price float64 `json:"price"`
}
PartialCompensationReturn float64 `json:"partial_compensation_return"`
} `json:"rfbs"`
type GetFinancialResultResultDetailPayment struct {
CurrencyCode string `json:"currency_code"`
Services struct {
Total float64 `json:"total"`
Payment float64 `json:"payment"`
}
Items []struct {
Name DetailsServiceItemName `json:"name"`
type GetFinancialResultResultDetailPeriod struct {
Begin time.Time `json:"begin"`
Price float64 `json:"price"`
} `json:"items"`
} `json:"services"`
End time.Time `json:"end"`
Others struct {
Total float64 `json:"total"`
Id int64 `json:"id"`
}
Items []struct {
Name DetailsOtherItemName `json:"name"`
type GetFinancialResultResultDetailReturn struct {
Total float64 `json:"total"`
Price float64 `json:"price"`
} `json:"items"`
} `json:"others"`
Amount float64 `json:"amount"`
EndBalanceAmount float64 `json:"end_balance_amount"`
} `json:"details"`
ReturnServices GetFinancialResultResultDetailReturnServices `json:"return_services"`
}
// Number of pages with reports
PageCount int64 `json:"page_count"`
} `json:"result"`
type GetFinancialResultResultDetailReturnServices struct {
Total float64 `json:"total"`
Items []GetFinancialResultResultDetailReturnServicesItem `json:"items"`
}
type GetFinancialResultResultDetailReturnServicesItem struct {
Name DetailsReturnServiceName `json:"name"`
Price float64 `json:"price"`
}
type GetFinancialResultResultDetailRFBS struct {
Total float64 `json:"total"`
TransferDelivery float64 `json:"transfer_delivery"`
TransferDeliveryReturn float64 `json:"transfer_delivery_return"`
CompensationDeliveryReturn float64 `json:"compensation_delivery_return"`
PartialCompensation float64 `json:"partial_compensation"`
PartialCompensationReturn float64 `json:"partial_compensation_return"`
}
type GetFinancialResultResultDetailService struct {
Total float64 `json:"total"`
Items []GetFinancialResultResultDetailServiceItem `json:"items"`
}
type GetFinancialResultResultDetailServiceItem struct {
Name DetailsServiceItemName `json:"name"`
Price float64 `json:"price"`
}
type GetFinancialResultResultDetailOthers struct {
Total float64 `json:"total"`
Items []GetFinancialResultResultDetailOthersItem `json:"items"`
}
type GetFinancialResultResultDetailOthersItem struct {
Name DetailsOtherItemName `json:"name"`
Price float64 `json:"price"`
}
// Returns information about a created report by its identifier
@@ -350,10 +390,12 @@ type GetProductsReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Unique report identifier
Code string `json:"code"`
} `json:"result"`
Result GetProductsReportResult `json:"result"`
}
type GetProductsReportResult struct {
// Unique report identifier
Code string `json:"code"`
}
// Method for getting a report with products data. For example, Ozon ID, number of products, prices, status
@@ -383,10 +425,12 @@ type GetStocksReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Unique report identifier
Code string `json:"code"`
} `json:"result"`
Result GetStocksReportResult `json:"result"`
}
type GetStocksReportResult struct {
// Unique report identifier
Code string `json:"code"`
}
// Report with information about the number of available and reserved products in stock
@@ -422,10 +466,12 @@ type GetProductsMovementReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Unique report identifier
Code string `json:"code"`
} `json:"result"`
Result GetProductsMovementReportResult `json:"result"`
}
type GetProductsMovementReportResult struct {
// Unique report identifier
Code string `json:"code"`
}
// Report with complete information on products, as well as the number of products with statuses:
@@ -473,10 +519,12 @@ type GetReturnsReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Unique report identifier
Code string `json:"code"`
} `json:"result"`
Result GetReturnReportResult `json:"result"`
}
type GetReturnReportResult struct {
// Unique report identifier
Code string `json:"code"`
}
// The report contains information about returned products that were accepted from the customer, ready for pickup, or delivered to the seller.
@@ -542,10 +590,12 @@ type GetShipmentReportResponse struct {
core.CommonResponse
// Method result
Result struct {
// Unique report identifier
Code string `json:"code"`
} `json:"result"`
Result GetShipmentReportResult `json:"result"`
}
type GetShipmentReportResult struct {
// Unique report identifier
Code string `json:"code"`
}
// Shipment report with orders details:
@@ -603,23 +653,25 @@ type ReportOnDiscountedProductsResponse struct {
core.CommonResponse
// Report information
Report struct {
// Report creation date
CreatedAt time.Time `json:"created_at"`
Report ReportonDiscountedProductsReport `json:"report"`
}
// Link to report file
File string `json:"file"`
type ReportonDiscountedProductsReport struct {
// Report creation date
CreatedAt time.Time `json:"created_at"`
// Report status:
// - success — created
// - pending — waiting to be processed
// - processing — processed
// - failed — generation error
Status string `json:"status"`
// Link to report file
File string `json:"file"`
// Report generation error code
Error string `json:"error"`
} `json:"report"`
// Report status:
// - success — created
// - pending — waiting to be processed
// - processing — processed
// - failed — generation error
Status string `json:"status"`
// Report generation error code
Error string `json:"error"`
}
// By report identifier, returns information about the report generated earlier

168
ozon/returns.go
View File

@@ -38,40 +38,42 @@ type GetFBOReturnsResponse struct {
LastId int64 `json:"last_id"`
// Returns information
Returns []struct {
// Time when a return was received from the customer
AcceptedFromCustomerMoment time.Time `json:"accepted_from_customer_moment"`
Returns []GetFBOReturnsReturn `json:"returns"`
}
// Seller identifier
CompanyId int64 `json:"company_id"`
type GetFBOReturnsReturn struct {
// Time when a return was received from the customer
AcceptedFromCustomerMoment time.Time `json:"accepted_from_customer_moment"`
// Current return location
CurrentPlaceName string `json:"current_place_name"`
// Seller identifier
CompanyId int64 `json:"company_id"`
// Return destination
DestinationPlaceName string `json:"dst_place_name"`
// Current return location
CurrentPlaceName string `json:"current_place_name"`
// Return identifier
Id int64 `json:"id"`
// Return destination
DestinationPlaceName string `json:"dst_place_name"`
// Indication that the package has been opened. true, if it has been
IsOpened bool `json:"is_opened"`
// Return identifier
Id int64 `json:"id"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Indication that the package has been opened. true, if it has been
IsOpened bool `json:"is_opened"`
// Return reason
ReturnReasonName string `json:"return_reason_name"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Return delivery time to the Ozon warehouse
ReturnedToOzonMoment time.Time `json:"returned_to_ozon_moment"`
// Return reason
ReturnReasonName string `json:"return_reason_name"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Return delivery time to the Ozon warehouse
ReturnedToOzonMoment time.Time `json:"returned_to_ozon_moment"`
// Return status
Status string `json:"status_name"`
} `json:"returns"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Return status
Status string `json:"status_name"`
}
// Method for getting information on returned products that are sold from the Ozon warehouse
@@ -150,88 +152,92 @@ type GetFBSReturnsFilterTimeRange struct {
type GetFBSReturnsResponse struct {
core.CommonResponse
Result struct {
// Elements counter in the response
Count int64 `json:"count"`
Result GetFBSReturnsResult `json:"result"`
}
// Returns information
Returns []struct {
// Time of receiving the return from the customer
AcceptedFromCustomerAmount string `json:"accepted_from_customer_amount"`
type GetFBSReturnsResult struct {
// Elements counter in the response
Count int64 `json:"count"`
// Bottom barcode on the product label
ClearingId int64 `json:"clearing_id"`
// Returns information
Returns []GetFBSReturnResultReturn `json:"returns"`
}
// Commission fee
Commission float64 `json:"commission"`
type GetFBSReturnResultReturn struct {
// Time of receiving the return from the customer
AcceptedFromCustomerAmount string `json:"accepted_from_customer_amount"`
// Commission percentage
CommissionPercent float64 `json:"commission_percent"`
// Bottom barcode on the product label
ClearingId int64 `json:"clearing_id"`
// Return identifier
Id int64 `json:"id"`
// Commission fee
Commission float64 `json:"commission"`
// If the product is in transit — true
IsMoving bool `json:"is_moving"`
// Commission percentage
CommissionPercent float64 `json:"commission_percent"`
// Indication that the package has been opened. true, if it has been
IsOpened bool `json:"is_opened"`
// Return identifier
Id int64 `json:"id"`
// Last day of free storage
LastFreeWaitingDay string `json:"last_free_waiting_day"`
// If the product is in transit — true
IsMoving bool `json:"is_moving"`
// ID of the warehouse the product is being transported to
PlaceId int64 `json:"place_id"`
// Indication that the package has been opened. true, if it has been
IsOpened bool `json:"is_opened"`
// Name of the warehouse the product is being transported to
MovingToPlaceName string `json:"moving_to_place_name"`
// Last day of free storage
LastFreeWaitingDay string `json:"last_free_waiting_day"`
// Delivery cost
PickingAmount float64 `json:"picking_amount"`
// ID of the warehouse the product is being transported to
PlaceId int64 `json:"place_id"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Name of the warehouse the product is being transported to
MovingToPlaceName string `json:"moving_to_place_name"`
// Current product price without a discount
Price float64 `json:"price"`
// Delivery cost
PickingAmount float64 `json:"picking_amount"`
// Product price without commission
PriceWithoutCommission float64 `json:"price_without_commission"`
// Shipment number
PostingNumber string `json:"posting_number"`
// Product identifier
ProductId int64 `json:"product_id"`
// Current product price without a discount
Price float64 `json:"price"`
// Product name
ProductName string `json:"product_name"`
// Product price without commission
PriceWithoutCommission float64 `json:"price_without_commission"`
// Product quantity
Quantity int64 `json:"quantity"`
// Product identifier
ProductId int64 `json:"product_id"`
// Product return date
ReturnDate string `json:"return_date"`
// Product name
ProductName string `json:"product_name"`
// Return reason
ReturnReasonName string `json:"return_reason_name"`
// Product quantity
Quantity int64 `json:"quantity"`
// Date when the product is ready to be handed over to the seller
WaitingForSellerDate string `json:"waiting_for_seller_date_time"`
// Product return date
ReturnDate string `json:"return_date"`
// Date of handing over the product to the seller
ReturnedToSellerDate string `json:"returned_to_seller_date_time"`
// Return reason
ReturnReasonName string `json:"return_reason_name"`
// Return storage period in days
WaitingForSellerDays int64 `json:"waiting_for_seller_days"`
// Date when the product is ready to be handed over to the seller
WaitingForSellerDate string `json:"waiting_for_seller_date_time"`
// Return storage cost
ReturnsKeepingCost float64 `json:"returns_keeping_cost"`
// Date of handing over the product to the seller
ReturnedToSellerDate string `json:"returned_to_seller_date_time"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Return storage period in days
WaitingForSellerDays int64 `json:"waiting_for_seller_days"`
// Return status
Status string `json:"status"`
} `json:"returns"`
} `json:"result"`
// Return storage cost
ReturnsKeepingCost float64 `json:"returns_keeping_cost"`
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Return status
Status string `json:"status"`
}
// Method for getting information on returned products that are sold from the seller's warehouse

142
ozon/strategies.go
View File

@@ -19,15 +19,17 @@ type ListCompetitorsParams struct {
type ListCompetitorsResponse struct {
core.CommonResponse
Competitors []struct {
Name string `json:"name"`
Id int64 `json:"id"`
} `json:"competitors"`
Competitors []ListCompetitorsCompetitor `json:"competitors"`
Total int32 `json:"total"`
}
type ListCompetitorsCompetitor struct {
Name string `json:"name"`
Id int64 `json:"id"`
}
func (c Strategies) ListCompetitors(params *ListCompetitorsParams) (*ListCompetitorsResponse, error) {
url := "/v1/pricing-strategy/competitors/list"
@@ -51,27 +53,29 @@ type ListStrategiesParams struct {
type ListStrategiesResponse struct {
core.CommonResponse
Strategies []struct {
Id string `json:"id"`
Name string `json:"name"`
Type StrategyType `json:"type"`
UpdateType StrategyUpdateType `json:"update_type"`
UpdatedAt string `json:"updated_at"`
ProductsCount int64 `json:"products_count"`
CompetitorsCount int64 `json:"competitors_count"`
Enabled bool `json:"enabled"`
} `json:"strategies"`
Strategies []ListStrategiesStrategy `json:"strategies"`
Total int32 `json:"total"`
}
type ListStrategiesStrategy struct {
Id string `json:"id"`
Name string `json:"name"`
Type StrategyType `json:"type"`
UpdateType StrategyUpdateType `json:"update_type"`
UpdatedAt string `json:"updated_at"`
ProductsCount int64 `json:"products_count"`
CompetitorsCount int64 `json:"competitors_count"`
Enabled bool `json:"enabled"`
}
func (c Strategies) List(params *ListStrategiesParams) (*ListStrategiesResponse, error) {
url := "/v1/pricing-strategy/list"
@@ -101,9 +105,11 @@ type CreateStrategyCompetitor struct {
type CreateStrategyResponse struct {
core.CommonResponse
Result struct {
StrategyId string `json:"strategy_id"`
} `json:"result"`
Result CreateStrategyResult `json:"result"`
}
type CreateStrategyResult struct {
StrategyId string `json:"strategy_id"`
}
func (c Strategies) Create(params *CreateStrategyParams) (*CreateStrategyResponse, error) {
@@ -127,17 +133,19 @@ type InfoStrategyParams struct {
type InfoStrategyResponse struct {
core.CommonResponse
Result struct {
Competitors []CreateStrategyCompetitor `json:"competitors"`
Result InfoStrategyResult `json:"result"`
}
Enabled bool `json:"enabled"`
type InfoStrategyResult struct {
Competitors []CreateStrategyCompetitor `json:"competitors"`
Name string `json:"name"`
Enabled bool `json:"enabled"`
Type StrategyType `json:"type"`
Name string `json:"name"`
UpdateType StrategyUpdateType `json:"update_type"`
} `json:"result"`
Type StrategyType `json:"type"`
UpdateType StrategyUpdateType `json:"update_type"`
}
func (c Strategies) Info(params *InfoStrategyParams) (*InfoStrategyResponse, error) {
@@ -189,17 +197,21 @@ type AddProductsToStrategyParams struct {
type AddProductsToStrategyResponse struct {
core.CommonResponse
Result struct {
Errors []struct {
Code string `json:"code"`
Result AddProductsToStrategyResult `json:"result"`
}
Error string `json:"error"`
type AddProductsToStrategyResult struct {
Errors []AddProductsToStrategyResultError `json:"errors"`
ProductId int64 `json:"product_id"`
} `json:"errors"`
FailedProductCount int32 `json:"failed_product_count"`
}
FailedProductCount int32 `json:"failed_product_count"`
} `json:"result"`
type AddProductsToStrategyResultError struct {
Code string `json:"code"`
Error string `json:"error"`
ProductId int64 `json:"product_id"`
}
func (c Strategies) AddProducts(params *AddProductsToStrategyParams) (*AddProductsToStrategyResponse, error) {
@@ -223,13 +235,17 @@ type GetStrategiesByProductIdsParams struct {
type GetStrategiesByProductIdsResponse struct {
core.CommonResponse
Result struct {
ProductsInfo []struct {
ProductId int64 `json:"product_id"`
Result GetStrategiesByProductIdsResult `json:"result"`
}
StrategyId string `json:"strategy_id"`
} `json:"products_info"`
} `json:"result"`
type GetStrategiesByProductIdsResult struct {
ProductsInfo []GetStrategiesByProductIdsResultProductInfo `json:"products_info"`
}
type GetStrategiesByProductIdsResultProductInfo struct {
ProductId int64 `json:"product_id"`
StrategyId string `json:"strategy_id"`
}
func (c Strategies) GetByProductIds(params *GetStrategiesByProductIdsParams) (*GetStrategiesByProductIdsResponse, error) {
@@ -253,9 +269,11 @@ type ListProductsInStrategyParams struct {
type ListProductsInStrategyResponse struct {
core.CommonResponse
Result struct {
ProductId []string `json:"product_id"`
} `json:"result"`
Result ListProductsInStrategyResult `json:"result"`
}
type ListProductsInStrategyResult struct {
ProductId []string `json:"product_id"`
}
func (c Strategies) ListProducts(params *ListProductsInStrategyParams) (*ListProductsInStrategyResponse, error) {
@@ -279,19 +297,21 @@ type GetCompetitorPriceParams struct {
type GetCompetitorPriceResponse struct {
core.CommonResponse
Result struct {
StrategyId string `json:"strategy_id"`
Result GetCompetitorPriceResult `json:"result"`
}
IsEnabled bool `json:"is_enabled"`
type GetCompetitorPriceResult struct {
StrategyId string `json:"strategy_id"`
StrategyProductPrice int32 `json:"strategy_product_price"`
IsEnabled bool `json:"is_enabled"`
PriceDownloadedAt string `json:"price_downloaded_at"`
StrategyProductPrice int32 `json:"strategy_product_price"`
StrategyCompetitorId int64 `json:"strategy_competitor_id"`
PriceDownloadedAt string `json:"price_downloaded_at"`
StrategyCompetitorProductURL string `json:"strategy_competitor_product_url"`
} `json:"result"`
StrategyCompetitorId int64 `json:"strategy_competitor_id"`
StrategyCompetitorProductURL string `json:"strategy_competitor_product_url"`
}
func (c Strategies) GetCompetitorPrice(params *GetCompetitorPriceParams) (*GetCompetitorPriceResponse, error) {
@@ -315,9 +335,11 @@ type RemoveProductsFromStrategyParams struct {
type RemoveProductsFromStrategyResponse struct {
core.CommonResponse
Result struct {
FailedProductCount int32 `json:"failed_product_count"`
} `json:"result"`
Result RemoveProductsFromStrategyResult `json:"result"`
}
type RemoveProductsFromStrategyResult struct {
FailedProductCount int32 `json:"failed_product_count"`
}
func (c Strategies) RemoveProducts(params *RemoveProductsFromStrategyParams) (*RemoveProductsFromStrategyResponse, error) {

152
ozon/warehouses.go
View File

@@ -14,70 +14,74 @@ type Warehouses struct {
type GetListOfWarehousesResponse struct {
core.CommonResponse
Result []struct {
// Trusted acceptance attribute. `true` if trusted acceptance is enabled in the warehouse
HasEntrustedAcceptance bool `json:"has_entrusted_acceptance"`
Result []GetListOfWarehousesResult `json:"result"`
}
// Indication that the warehouse works under the rFBS scheme:
// - true — the warehouse works under the rFBS scheme;
// - false — the warehouse does not work under the rFBS scheme.
IsRFBS bool `json:"is_rfbs"`
type GetListOfWarehousesResult struct {
// Trusted acceptance attribute. `true` if trusted acceptance is enabled in the warehouse
HasEntrustedAcceptance bool `json:"has_entrusted_acceptance"`
// Warehouse name
Name string `json:"name"`
// Indication that the warehouse works under the rFBS scheme:
// - true — the warehouse works under the rFBS scheme;
// - false — the warehouse does not work under the rFBS scheme.
IsRFBS bool `json:"is_rfbs"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// Warehouse name
Name string `json:"name"`
// Possibility to print an acceptance certificate in advance. `true` if printing in advance is possible
CanPrintActInAdvance bool `json:"can_print_act_in_advance"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
// FBS first mile
FirstMileType struct {
// DropOff point identifier
DropoffPointId string `json:"dropoff_point_id"`
// Possibility to print an acceptance certificate in advance. `true` if printing in advance is possible
CanPrintActInAdvance bool `json:"can_print_act_in_advance"`
// DropOff timeslot identifier
DropoffTimeslotId int64 `json:"dropoff_timeslot_id"`
// FBS first mile
FirstMileType GetListOfWarehousesResultFirstMile `json:"first_mile_type"`
// Indication that the warehouse settings are being updated
FirstMileIsChanging bool `json:"first_mile_is_changing"`
// Indication if there is a limit on the minimum number of orders. `true` if there is such a limit
HasPostingsLimit bool `json:"has_postings_limit"`
// First mile type:
//
// Enum: "DropOff" "Pickup"
// - DropOff
// - Pickup
FirstMileType string `json:"first_mile_type"`
} `json:"first_mile_type"`
// Indication that the warehouse is not working due to quarantine
IsKarantin bool `json:"is_karantin"`
// Indication if there is a limit on the minimum number of orders. `true` if there is such a limit
HasPostingsLimit bool `json:"has_postings_limit"`
// Indication that the warehouse accepts bulky products
IsKGT bool `json:"is_kgt"`
// Indication that the warehouse is not working due to quarantine
IsKarantin bool `json:"is_karantin"`
// Indication that warehouse schedule can be changed
IsTimetableEditable bool `json:"is_timetable_editable"`
// Indication that the warehouse accepts bulky products
IsKGT bool `json:"is_kgt"`
// Minimum limit value: the number of orders that can be brought in one shipment
MinPostingsLimit int32 `json:"min_postings_limit"`
// Indication that warehouse schedule can be changed
IsTimetableEditable bool `json:"is_timetable_editable"`
// Limit value. -1 if there is no limit
PostingsLimit int32 `json:"postings_limit"`
// Minimum limit value: the number of orders that can be brought in one shipment
MinPostingsLimit int32 `json:"min_postings_limit"`
// Number of warehouse working days
MinWorkingDays int64 `json:"min_working_days"`
// Limit value. -1 if there is no limit
PostingsLimit int32 `json:"postings_limit"`
// Warehouse status
Status string `json:"status"`
// Number of warehouse working days
MinWorkingDays int64 `json:"min_working_days"`
// Warehouse working days
WorkingDays []WorkingDay `json:"working_days"`
}
// Warehouse status
Status string `json:"status"`
type GetListOfWarehousesResultFirstMile struct {
// DropOff point identifier
DropoffPointId string `json:"dropoff_point_id"`
// Warehouse working days
WorkingDays []WorkingDay `json:"working_days"`
} `json:"resulCommonResponse"`
// DropOff timeslot identifier
DropoffTimeslotId int64 `json:"dropoff_timeslot_id"`
// Indication that the warehouse settings are being updated
FirstMileIsChanging bool `json:"first_mile_is_changing"`
// First mile type:
//
// Enum: "DropOff" "Pickup"
// - DropOff
// - Pickup
FirstMileType string `json:"first_mile_type"`
}
// You do not need to specify any parameters in the request. Your company will be identified by the Warehouses ID
@@ -131,41 +135,43 @@ type GetListOfDeliveryMethodsResponse struct {
HasNext bool `json:"has_next"`
// Method result
Result []struct {
// Company identifier
CompanyId int64 `json:"company_id"`
Result []GetListOfDeliveryMethodsResult `json:"result"`
}
// Date and time of delivery method creation
CreatedAt time.Time `json:"created_at"`
type GetListOfDeliveryMethodsResult struct {
// Company identifier
CompanyId int64 `json:"company_id"`
// Time before an order must be packaged
Cutoff string `json:"cutoff"`
// Date and time of delivery method creation
CreatedAt time.Time `json:"created_at"`
// Delivery method identifier
Id int64 `json:"id"`
// Time before an order must be packaged
Cutoff string `json:"cutoff"`
// Delivery method name
Name string `json:"name"`
// Delivery method identifier
Id int64 `json:"id"`
// Delivery service identifier
ProviderId int64 `json:"provider_id"`
// Delivery method name
Name string `json:"name"`
// Delivery method status:
// - NEW—created,
// - EDITED—being edited,
// - ACTIVE—active,
// - DISABLED—inactive
Status string `json:"status"`
// Delivery service identifier
ProviderId int64 `json:"provider_id"`
// Order delivery service identifier
TemplateId int64 `json:"template_id"`
// Delivery method status:
// - NEW—created,
// - EDITED—being edited,
// - ACTIVE—active,
// - DISABLED—inactive
Status string `json:"status"`
// Date and time when the delivery method was last updated
UpdatedAt time.Time `json:"updated_at"`
// Order delivery service identifier
TemplateId int64 `json:"template_id"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
} `json:"result"`
// Date and time when the delivery method was last updated
UpdatedAt time.Time `json:"updated_at"`
// Warehouse identifier
WarehouseId int64 `json:"warehouse_id"`
}
// This methods allows you to get list of all delivery methods that can be applied for this warehouse