flat structures

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

View File

@@ -22,16 +22,7 @@ type GetAnalyticsDataParams struct {
Dimension []GetAnalyticsDataDimension `json:"dimension"` Dimension []GetAnalyticsDataDimension `json:"dimension"`
// Filters // Filters
Filters []struct { Filters []GetAnalyticsDataFilter `json:"filters"`
// 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"`
// Number of items in the respones: // Number of items in the respones:
// - maximum is 1000, // - maximum is 1000,
@@ -48,6 +39,17 @@ type GetAnalyticsDataParams struct {
Sort []GetAnalyticsDataSort `json:"sort"` 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 // Report sorting settings
type GetAnalyticsDataSort struct { type GetAnalyticsDataSort struct {
// Metric by which the method result will be sorted // Metric by which the method result will be sorted
@@ -61,30 +63,36 @@ type GetAnalyticsDataResponse struct {
core.CommonResponse core.CommonResponse
// Method result // Method result
Result struct { Result GetAnalyticsDataResult `json:"result"`
// 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"`
// Report creation time // Report creation time
Timestamp string `json:"timestamp"` 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. // 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) { func (c Analytics) GetAnalyticsData(params *GetAnalyticsDataParams) (*GetAnalyticsDataResponse, error) {
url := "/v1/analytics/data" url := "/v1/analytics/data"
@@ -117,31 +125,35 @@ type GetStocksOnWarehousesResponse struct {
core.CommonResponse core.CommonResponse
// Method result // Method result
Result struct { Result GetStocksOnWarehousesResult `json:"result"`
// Information about products and stocks }
Rows []struct {
// Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Product identifier in the seller's system type GetStocksOnWarehousesResult struct {
ItemCode string `json:"item_code"` // Information about products and stocks
Rows []GetStocksOnWarehousesResultRow `json:"rows"`
}
// Product name in the Ozon system type GetStocksOnWarehousesResultRow struct {
ItemName string `json:"item_name"` // Product identifier in the Ozon system, SKU
SKU int64 `json:"sku"`
// Product amount available for sale on Ozon // Product identifier in the seller's system
FreeToSellAmount int64 `json:"free_to_sell_amount"` ItemCode string `json:"item_code"`
// Product amount specified for confirmed future supplies // Product name in the Ozon system
PromisedAmount int64 `json:"promised_amount"` ItemName string `json:"item_name"`
// Product amount reserved for purchase, returns, and transportation between warehouses // Product amount available for sale on Ozon
ReservedAmount int64 `json:"reserved_amount"` FreeToSellAmount int64 `json:"free_to_sell_amount"`
// Name of the warehouse where the products are stored // Product amount specified for confirmed future supplies
WarehouseName string `json:"warehouse_name"` PromisedAmount int64 `json:"promised_amount"`
} `json:"rows"`
} `json:"result"` // 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 // Report on stocks and products movement at Ozon warehouses

View File

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

View File

@@ -31,13 +31,7 @@ type CancellationInfo struct {
PostingNumber string `json:"posting_number"` PostingNumber string `json:"posting_number"`
// Cancellation reason // Cancellation reason
CancellationReason struct { CancellationReason CancellationInfoReason `json:"cancellation_reason"`
// Cancellation reason identifier
Id int64 `json:"id"`
// Cancellation reason name
Name string `json:"name"`
} `json:"cancellation_reason"`
// Cancellation request creation date // Cancellation request creation date
CancelledAt time.Time `json:"cancelled_at"` CancelledAt time.Time `json:"cancelled_at"`
@@ -49,16 +43,7 @@ type CancellationInfo struct {
TPLIntegrationType string `json:"tpl_integration_type"` TPLIntegrationType string `json:"tpl_integration_type"`
// Cancellation request status // Cancellation request status
State struct { State CancellationInfoState `json:"state"`
// Status identifier
Id int64 `json:"id"`
// Status name
Name string `json:"name"`
// Request status
State string `json:"state"`
} `json:"state"`
// Cancellation initiator // Cancellation initiator
CancellationInitiator string `json:"cancellation_initiator"` CancellationInitiator string `json:"cancellation_initiator"`
@@ -76,6 +61,25 @@ type CancellationInfo struct {
AutoApproveDate time.Time `json:"auto_approve_date"` 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 // Method for getting information about a rFBS cancellation request
func (c Cancellations) GetInfo(params *GetCancellationInfoParams) (*GetCancellationInfoResponse, error) { func (c Cancellations) GetInfo(params *GetCancellationInfoParams) (*GetCancellationInfoResponse, error) {
url := "/v1/delivery-method/list" url := "/v1/delivery-method/list"
@@ -134,16 +138,18 @@ type ListCancellationsResponse struct {
Total int32 `json:"total"` Total int32 `json:"total"`
// Counter of requests in different statuses // Counter of requests in different statuses
Counters struct { Counters ListCancellationResponseCounters `json:"counters"`
// Number of requests for approval }
OnApproval int64 `json:"on_approval"`
// Number of approved requests type ListCancellationResponseCounters struct {
Approved int64 `json:"approved"` // Number of requests for approval
OnApproval int64 `json:"on_approval"`
// Number of rejected requests // Number of approved requests
Rejected int64 `json:"rejected"` Approved int64 `json:"approved"`
} `json:"counters"`
// Number of rejected requests
Rejected int64 `json:"rejected"`
} }
// Method for getting a list of rFBS cancellation requests // Method for getting a list of rFBS cancellation requests

View File

@@ -22,16 +22,18 @@ type GetProductTreeResponse struct {
core.CommonResponse core.CommonResponse
// Category list // Category list
Result []struct { Result []GetProductTreeResult `json:"result"`
// Category identifier }
CategoryId int64 `json:"category_id"`
// Subcategory tree type GetProductTreeResult struct {
Children []GetProductTreeResponse `json:"children"` // Category identifier
CategoryId int64 `json:"category_id"`
// Category name // Subcategory tree
Title string `json:"title"` Children []GetProductTreeResponse `json:"children"`
} `json:"result"`
// Category name
Title string `json:"title"`
} }
// Returns product categories in the tree view. // Returns product categories in the tree view.
@@ -67,58 +69,62 @@ type GetCategoryAttributesResponse struct {
core.CommonResponse core.CommonResponse
// Method result // Method result
Result []struct { Result []GetCategoryAttributesResult `json:"result"`
// 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"`
// Characteristic description type GetCategoryAttributesResult struct {
Description string `json:"description"` // Array of product characteristics
Attributes []GetCategoryAttributesResultAttribute `json:"attributes"`
// Directory identifier // Category identifier
DictionaryId int64 `json:"dictionary_id"` CategoryId int64 `json:"category_id"`
}
// Characteristics group identifier type GetCategoryAttributesResultAttribute struct {
GroupId int64 `json:"group_id"` // 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 // Characteristic description
GroupName string `json:"group_name"` Description string `json:"description"`
// Document generation task number // Directory identifier
Id int64 `json:"id"` DictionaryId int64 `json:"dictionary_id"`
// Indicates that the attribute is aspect. An aspect attribute is a characteristic that distinguishes products of the same model. // Characteristics group identifier
// GroupId int64 `json:"group_id"`
// 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"`
// Indicates that the characteristic is a set of values: // Characteristics group name
// - true — the characteristic is a set of values, GroupName string `json:"group_name"`
// - false — the characteristic consists of a single value
IsCollection bool `json:"is_collection"`
// Indicates that the characteristic is mandatory: // Document generation task number
// - true — a mandatory characteristic, Id int64 `json:"id"`
// - false — you can leave the characteristic out
IsRequired bool `json:"is_required"`
// Name // Indicates that the attribute is aspect. An aspect attribute is a characteristic that distinguishes products of the same model.
Name string `json:"name"` //
// 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 // Indicates that the characteristic is a set of values:
Type string `json:"type"` // - true — the characteristic is a set of values,
} `json:"attributes"` // - false — the characteristic consists of a single value
IsCollection bool `json:"is_collection"`
// Category identifier // Indicates that the characteristic is mandatory:
CategoryId int64 `json:"category_id"` // - true — a mandatory characteristic,
} `json:"result"` // - 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. // Getting characteristics for specified product category.
@@ -167,14 +173,16 @@ type GetAttributeDictionaryResponse struct {
HasNext bool `json:"has_next"` HasNext bool `json:"has_next"`
// Method result // Method result
Result []struct { Result []GetAttributeDictionaryResult `json:"result"`
Id int64 `json:"id"` }
Info string `json:"info"`
Picture string `json:"picture"`
// Product characteristic value type GetAttributeDictionaryResult struct {
Value string `json:"value"` Id int64 `json:"id"`
} `json:"result"` 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. // You can use the `/v3/category/attribute` method to check if an attribute has a nested directory.

View File

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

View File

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

View File

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

File diff suppressed because it is too large Load Diff

View File

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

View File

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

File diff suppressed because it is too large Load Diff

View File

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

View File

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

View File

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

View File

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

View File

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

View File

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