Merge pull request #100 from dendd1/master

fix for clear cart method

.github/workflows/ci.yml

@@ -20,10 +20,10 @@ jobs:
     steps:
       - name: Check out code into the Go module directory
         uses: actions/checkout@v2
-      - name: Set up Go 1.17
+      - name: Set up Go 1.23
-        uses: actions/setup-go@v2
+        uses: actions/setup-go@v3
         with:
-          go-version: '1.17'
+          go-version: '1.23'
       - name: Get dependencies
         run: |
           go mod tidy
@@ -31,21 +31,22 @@ jobs:
       - name: Lint code with golangci-lint
         uses: golangci/golangci-lint-action@v3
         with:
-          version: v1.45.2
+          version: v1.62.2
           only-new-issues: true
           skip-pkg-cache: true
+          args: --build-tags=testutils
   tests:
     name: Tests
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go-version: ['1.13', '1.14', '1.15', '1.16', '1.17']
+        go-version: ['1.19', '1.20', '1.21', '1.22', '1.23', 'stable']
         include:
-          - go-version: '1.17'
+          - go-version: '1.23'
             coverage: 1
     steps:
       - name: Set up Go ${{ matrix.go-version }}
-        uses: actions/setup-go@v2
+        uses: actions/setup-go@v3
         with:
           go-version: ${{ matrix.go-version }}
       - name: Check out code into the Go module directory
@@ -58,17 +59,21 @@ jobs:
         env:
           COVERAGE: ${{ matrix.coverage }}
         if: env.COVERAGE != 1
-        run: go test ./...
+        run: |
+          go install gotest.tools/gotestsum@latest
+          gotestsum --format testdox ./... -tags=testutils -v -cpu 2 -timeout 60s -race
       - name: Tests with coverage
         env:
           COVERAGE: ${{ matrix.coverage }}
         if: env.COVERAGE == 1
         run: |
-          go test ./... -race -coverprofile=coverage.txt -covermode=atomic "$d"
+          go install gotest.tools/gotestsum@latest
+          gotestsum --format testdox ./... -tags=testutils -v -cpu 2 -timeout 60s -race -cover -coverprofile=coverage.txt -covermode=atomic "$d"
       - name: Coverage
         env:
           COVERAGE: ${{ matrix.coverage }}
         if: env.COVERAGE == 1
         run: |
+          go install github.com/axw/gocov/gocov@latest
+          gocov convert ./coverage.txt | gocov report
           bash <(curl -s https://codecov.io/bash)
-          rm coverage.txt

.golangci.yml

@@ -2,29 +2,69 @@ run:
   skip-dirs-use-default: true
   allow-parallel-runners: true
 
+issues:
+  exclude-files:
+    - testutils.go
+  exclude-rules:
+    - path: _test\.go
+      linters:
+        - lll
+        - errcheck
+        - misspell
+        - ineffassign
+        - whitespace
+        - makezero
+        - errcheck
+        - funlen
+        - goconst
+        - gocognit
+        - gocyclo
+        - godot
+        - unused
+        - errchkjson
+        - varnamelen
+  exclude-use-default: true
+  exclude-case-sensitive: false
+  max-issues-per-linter: 0
+  max-same-issues: 0
+  fix: true
+
 output:
-  format: colored-line-number
+  formats:
+    - format: colored-line-number
   sort-results: true
 
+# Linters below do not support go1.18 yet because of generics.
+# See https://github.com/golangci/golangci-lint/issues/2649
+#    - bodyclose
+#    - sqlclosecheck
+
 linters:
   disable-all: true
   enable:
-    - deadcode
+    - asciicheck
+    - asasalint
+    - varnamelen
+    - reassign
+    - nilnil
+    - nilerr
+    - nakedret
+    - goprintffuncname
+    - typecheck
+    - errchkjson
     - errcheck
     - gosimple
     - govet
     - ineffassign
     - staticcheck
-    - structcheck
     - unused
     - unparam
-    - varcheck
-    - bodyclose
     - dogsled
     - dupl
     - errorlint
     - exhaustive
     - exportloopref
+    - copyloopvar
     - funlen
     - gocognit
     - goconst
@@ -33,16 +73,13 @@ linters:
     - godot
     - goimports
     - revive
-    - gomnd
     - gosec
-    - ifshort
     - lll
     - makezero
     - misspell
     - nestif
     - prealloc
     - predeclared
-    - sqlclosecheck
     - unconvert
     - whitespace
 
@@ -53,6 +90,7 @@ linters-settings:
     enable:
       - assign
       - atomic
+      - atomicalign
       - bools
       - buildtag
       - copylocks
@@ -67,7 +105,6 @@ linters-settings:
       - unmarshal
       - unreachable
       - unsafeptr
-      - unused
     settings:
       printf:
         funcs:
@@ -135,11 +172,13 @@ linters-settings:
     threshold: 200
   errorlint:
     errorf: true
+    asserts: false
+    comparison: false
   exhaustive:
     check-generated: false
     default-signifies-exhaustive: false
   funlen:
-    lines: 60
+    lines: 90
     statements: 40
   gocognit:
     min-complexity: 25
@@ -149,8 +188,6 @@ linters-settings:
     local-prefixes: github.com/retailcrm/api-client-go/v2
   lll:
     line-length: 160
-  maligned:
-    suggest-new: true
   misspell:
     locale: US
   nestif:
@@ -158,40 +195,19 @@ linters-settings:
   whitespace:
     multi-if: false
     multi-func: false
-
+  varnamelen:
-issues:
+    max-distance: 10
-  exclude-rules:
+    ignore-map-index-ok: true
-    - path: _test\.go
+    ignore-type-assert-ok: true
-      linters:
+    ignore-chan-recv-ok: true
-        - gomnd
+    ignore-decls:
-        - lll
+      - t *testing.T
-        - bodyclose
+      - e error
-        - errcheck
+      - i int
-        - sqlclosecheck
-        - misspell
-        - ineffassign
-        - whitespace
-        - makezero
-        - maligned
-        - ifshort
-        - errcheck
-        - funlen
-        - goconst
-        - gocognit
-        - gocyclo
-        - godot
-        - gocritic
-        - gosec
-        - staticcheck
-  exclude-use-default: true
-  exclude-case-sensitive: false
-  max-issues-per-linter: 0
-  max-same-issues: 0
-  fix: true
 
 severity:
   default-severity: error
   case-sensitive: false
 
 service:
-  golangci-lint-version: 1.36.x
+  golangci-lint-version: 1.62.x

enum.go

@@ -0,0 +1,8 @@
+package retailcrm
+
+var UserGroupSuperadmins UserGroupType = "superadmins"
+
+var (
+	NotificationTypeError NotificationType = "api.error"
+	NotificationTypeInfo  NotificationType = "api.info"
+)

error.go

@@ -9,6 +9,8 @@ import (
 
 var missingParameterMatcher = regexp.MustCompile(`^Parameter \'([\w\]\[\_\-]+)\' is missing$`)
 var (
+	// ErrRateLimited will be returned if request was rate limited.
+	ErrRateLimited = NewAPIError("rate limit exceeded")
 	// ErrMissingCredentials will be returned if no API key was provided to the API.
 	ErrMissingCredentials = NewAPIError(`apiKey is missing`)
 	// ErrInvalidCredentials will be returned if provided API key is invalid.

filters.go

@@ -199,6 +199,7 @@ type OrdersFilter struct {
 	PaymentStatuses                []string          `url:"paymentStatuses,omitempty,brackets"`
 	PaymentTypes                   []string          `url:"paymentTypes,omitempty,brackets"`
 	DeliveryTypes                  []string          `url:"deliveryTypes,omitempty,brackets"`
+	DeliveryServices               []string          `url:"deliveryServices,omitempty,brackets"`
 	OrderMethods                   []string          `url:"orderMethods,omitempty,brackets"`
 	ShipmentStores                 []string          `url:"shipmentStores,omitempty,brackets"`
 	Couriers                       []string          `url:"couriers,omitempty,brackets"`
@@ -207,6 +208,8 @@ type OrdersFilter struct {
 	Sites                          []string          `url:"sites,omitempty,brackets"`
 	CreatedAtFrom                  string            `url:"createdAtFrom,omitempty"`
 	CreatedAtTo                    string            `url:"createdAtTo,omitempty"`
+	PaidAtFrom                     string            `url:"paidAtFrom,omitempty"`
+	PaidAtTo                       string            `url:"paidAtTo,omitempty"`
 	FullPaidAtFrom                 string            `url:"fullPaidAtFrom,omitempty"`
 	FullPaidAtTo                   string            `url:"fullPaidAtTo,omitempty"`
 	DeliveryDateFrom               string            `url:"deliveryDateFrom,omitempty"`
@@ -349,6 +352,7 @@ type ProductsFilter struct {
 	ExternalID       string            `url:"externalId,omitempty"`
 	Manufacturer     string            `url:"manufacturer,omitempty"`
 	URL              string            `url:"url,omitempty"`
+	URLLike          string            `url:"urlLike,omitempty"`
 	PriceType        string            `url:"priceType,omitempty"`
 	OfferExternalID  string            `url:"offerExternalId,omitempty"`
 	Sites            []string          `url:"sites,omitempty,brackets"`
@@ -377,22 +381,22 @@ type ShipmentFilter struct {
 
 // CostsFilter type.
 type CostsFilter struct {
-	MinSumm          string   `url:"minSumm,omitempty"`
+	MinSumm          int      `url:"minSumm,omitempty"`
-	MaxSumm          string   `url:"maxSumm,omitempty"`
+	MaxSumm          int      `url:"maxSumm,omitempty"`
 	OrderNumber      string   `url:"orderNumber,omitempty"`
 	Comment          string   `url:"orderNumber,omitempty"`
-	Ids              []string `url:"ids,omitempty,brackets"`
+	IDs              []int    `url:"ids,omitempty,brackets"`
 	Sites            []string `url:"sites,omitempty,brackets"`
-	CreatedBy        []string `url:"createdBy,omitempty,brackets"`
+	CreatedBy        []int    `url:"createdBy,omitempty,brackets"`
 	CostGroups       []string `url:"costGroups,omitempty,brackets"`
 	CostItems        []string `url:"costItems,omitempty,brackets"`
-	Users            []string `url:"users,omitempty,brackets"`
+	Users            []int    `url:"users,omitempty,brackets"`
 	DateFrom         string   `url:"dateFrom,omitempty"`
 	DateTo           string   `url:"dateTo,omitempty"`
 	CreatedAtFrom    string   `url:"createdAtFrom,omitempty"`
 	CreatedAtTo      string   `url:"createdAtTo,omitempty"`
-	OrderIds         []string `url:"orderIds,omitempty,brackets"`
+	OrderIDs         []int    `url:"orderIds,omitempty,brackets"`
-	OrderExternalIds []string `url:"orderIds,omitempty,brackets"`
+	OrderExternalIDs []string `url:"orderExternalIds,omitempty,brackets"`
 }
 
 // FilesFilter type.
@@ -427,3 +431,67 @@ type CustomDictionariesFilter struct {
 	Name string `url:"name,omitempty"`
 	Code string `url:"code,omitempty"`
 }
+
+// BonusOperationsFilter type.
+type BonusOperationsFilter struct {
+	Loyalties []int `url:"loyalties,omitempty,brackets"`
+}
+
+type AccountBonusOperationsFilter struct {
+	CreatedAtFrom string `url:"createdAtFrom,omitempty"`
+	CreatedAtTo   string `url:"createdAtTo,omitempty"`
+}
+
+type LoyaltyBonusAPIFilterType struct {
+	Date string `url:"date,omitempty"`
+}
+
+type LoyaltyAccountAPIFilter struct {
+	ID                 string   `url:"id,omitempty"`
+	Status             string   `url:"status,,omitempty"`
+	Customer           string   `url:"customer,omitempty"`
+	MinOrderSum        string   `url:"minOrdersSum,omitempty"`
+	MaxOrderSum        string   `url:"maxOrdersSum,omitempty"`
+	MinAmount          string   `url:"minAmount,omitempty"`
+	MaxAmount          string   `url:"maxAmount,omitempty"`
+	PhoneNumber        string   `url:"phoneNumber,omitempty"`
+	CardNumber         string   `url:"cardNumber,omitempty"`
+	Ids                []int    `url:"ids,omitempty,brackets"`
+	Loyalties          []int    `url:"loyalties,omitempty,brackets"`
+	Sites              []string `url:"sites,omitempty,brackets"`
+	Level              int      `url:"level,omitempty"`
+	CreatedAtFrom      string   `url:"createdAtFrom,omitempty"`
+	CreatedAtTo        string   `url:"createdAtTo,omitempty"`
+	BurnDateFrom       string   `url:"burnDateFrom,omitempty"`
+	BurnDateTo         string   `url:"burnDateTo,omitempty"`
+	CustomFields       []string `url:"customFields,omitempty,brackets"`
+	CustomerID         string   `url:"customerId,omitempty"`
+	CustomerExternalID string   `url:"customerExternalId,omitempty"`
+}
+
+type LoyaltyAPIFilter struct {
+	Active  *int     `url:"active,omitempty"`
+	Blocked *int     `url:"blocked,omitempty"`
+	Ids     []int    `url:"ids,omitempty,brackets"`
+	Sites   []string `url:"sites,omitempty,brackets"`
+}
+
+type OffersFilter struct {
+	Ids    []int `url:"ids,omitempty,brackets"`
+	Active *int  `url:"active,omitempty"`
+}
+
+type SiteFilter struct {
+	// SiteBy contains information about what is betrayed site id or site code.
+	// id|code, default is code.
+	SiteBy string `url:"siteBy,omitempty"`
+}
+
+type GetCartFilter struct {
+	// SiteBy contains information about what is betrayed site id or site code.
+	// id|code, default is code.
+	SiteBy string `url:"siteBy,omitempty"`
+	// By contains information about what is betrayed: customer id or customer externalId.
+	// id|externalId, default is externalId.
+	By string `url:"by,omitempty"`
+}

marshaling.go

@@ -58,6 +58,30 @@ func (l *StringMap) UnmarshalJSON(data []byte) error {
 	return nil
 }
 
+func (l *CustomFieldMap) UnmarshalJSON(data []byte) error {
+	var i interface{}
+	var items CustomFieldMap
+	if err := json.Unmarshal(data, &i); err != nil {
+		return err
+	}
+
+	switch e := i.(type) {
+	case map[string]interface{}:
+		items = make(CustomFieldMap, len(e))
+		for idx, val := range e {
+			items[idx] = val
+		}
+	case []interface{}:
+		items = make(CustomFieldMap, len(e))
+		for idx, val := range e {
+			items[strconv.Itoa(idx)] = val
+		}
+	}
+
+	*l = items
+	return nil
+}
+
 func (p *OrderPayments) UnmarshalJSON(data []byte) error {
 	var i interface{}
 	var m OrderPayments

marshaling_test.go

@@ -44,7 +44,7 @@ func TestAPIErrorsList_UnmarshalJSON(t *testing.T) {
 }
 
 func TestCustomFieldsList_UnmarshalJSON(t *testing.T) {
-	var list StringMap
+	var list CustomFieldMap
 
 	require.NoError(t, json.Unmarshal([]byte(`["first", "second"]`), &list))
 	assert.Len(t, list, 2)
@@ -56,6 +56,13 @@ func TestCustomFieldsList_UnmarshalJSON(t *testing.T) {
 	assert.Equal(t, list["a"], "first")
 	assert.Equal(t, list["b"], "second")
 
+	require.NoError(t, json.Unmarshal([]byte(`{"a": ["first", "second"], "b": "second"}`), &list))
+	assert.Len(t, list, 2)
+	assert.Len(t, list["a"].([]interface{}), 2)
+	assert.Equal(t, list["a"].([]interface{})[0], "first")
+	assert.Equal(t, list["a"].([]interface{})[1], "second")
+	assert.Equal(t, list["b"], "second")
+
 	require.NoError(t, json.Unmarshal([]byte(`[]`), &list))
 	assert.Len(t, list, 0)
 }

request.go

@@ -194,6 +194,22 @@ type DeliveryShipmentsRequest struct {
 	Page   int            `url:"page,omitempty"`
 }
 
+// ClearCartRequest type.
+type ClearCartRequest struct {
+	ClearedAt string         `url:"clearedAt,omitempty"`
+	Customer  CartCustomer   `url:"customer,omitempty"`
+	Order     ClearCartOrder `url:"order,omitempty"`
+}
+
+// SetCartRequest type.
+type SetCartRequest struct {
+	ExternalID string        `url:"externalId,omitempty"`
+	DroppedAt  string        `url:"droppedAt,omitempty"`
+	Link       string        `url:"link,omitempty"`
+	Customer   CartCustomer  `url:"customer,omitempty"`
+	Items      []SetCartItem `url:"items,omitempty"`
+}
+
 // CostsRequest type.
 type CostsRequest struct {
 	Filter CostsFilter `url:"filter,omitempty"`
@@ -232,6 +248,63 @@ type ConnectRequest struct {
 	URL string `json:"systemUrl"`
 }
 
+// BonusOperationsRequest type.
+type BonusOperationsRequest struct {
+	Filter BonusOperationsFilter `url:"filter,omitempty"`
+	Limit  int                   `url:"limit,omitempty"`
+	Cursor string                `url:"cursor,omitempty"`
+}
+
+// AccountBonusOperationsRequest type.
+type AccountBonusOperationsRequest struct {
+	Filter AccountBonusOperationsFilter `url:"filter,omitempty"`
+	Limit  int                          `url:"limit,omitempty"`
+	Page   int                          `url:"page,omitempty"`
+}
+
+type LoyaltyBonusCreditRequest struct {
+	Amount         float64 `url:"amount"`
+	ActivationDate string  `url:"activationDate,omitempty"`
+	ExpiredDate    string  `url:"expireDate,omitempty"`
+	Comment        string  `url:"comment,omitempty"`
+}
+
+type LoyaltyBonusStatusDetailsRequest struct {
+	Limit  int                       `url:"limit,omitempty"`
+	Page   int                       `url:"page,omitempty"`
+	Filter LoyaltyBonusAPIFilterType `url:"filter,omitempty"`
+}
+
+type LoyaltyAccountsRequest struct {
+	Limit  int                     `url:"limit,omitempty"`
+	Page   int                     `url:"page,omitempty"`
+	Filter LoyaltyAccountAPIFilter `url:"filter,omitempty"`
+}
+
+type LoyaltyCalculateRequest struct {
+	Site    string
+	Order   Order
+	Bonuses float32
+}
+
+type LoyaltiesRequest struct {
+	Limit  int              `url:"limit,omitempty"`
+	Page   int              `url:"page,omitempty"`
+	Filter LoyaltyAPIFilter `url:"filter,omitempty"`
+}
+
+type NotificationsSendRequest struct {
+	UserGroups []UserGroupType  `json:"userGroups,omitempty"`
+	Type       NotificationType `json:"type"`
+	Message    string           `json:"message"`
+	UserIDs    []string         `json:"userIds,omitempty"`
+}
+
+type EditMGChannelTemplateRequest struct {
+	Templates []MGChannelTemplate `json:"templates"`
+	Removed   []int               `json:"removed"`
+}
+
 // SystemURL returns system URL from the connection request without trailing slash.
 func (r ConnectRequest) SystemURL() string {
 	if r.URL == "" {
@@ -253,3 +326,7 @@ func (r ConnectRequest) Verify(secret string) bool {
 	}
 	return hmac.Equal([]byte(r.Token), []byte(hex.EncodeToString(mac.Sum(nil))))
 }
+
+type OffersRequest struct {
+	OffersFilter `url:"filter,omitempty"`
+}

response.go

@@ -2,7 +2,18 @@ package retailcrm
 
 // SuccessfulResponse type.
 type SuccessfulResponse struct {
-	Success bool `json:"success,omitempty"`
+	Success bool `json:"success"`
+}
+
+type CreateLoyaltyAccountResponse struct {
+	SuccessfulResponse
+	LoyaltyAccount LoyaltyAccount `json:"loyaltyAccount,omitempty"`
+	Warnings       []string       `json:"warnings,omitempty"`
+}
+
+type EditLoyaltyAccountResponse struct {
+	SuccessfulResponse
+	LoyaltyAccount LoyaltyAccount `json:"loyaltyAccount,omitempty"`
 }
 
 // CreateResponse type.
@@ -112,6 +123,7 @@ type CorporateCustomerChangeResponse CustomerChangeResponse
 type CustomersUploadResponse struct {
 	Success           bool              `json:"success"`
 	UploadedCustomers []IdentifiersPair `json:"uploadedCustomers,omitempty"`
+	FailedCustomers   []ExternalID      `json:"failedCustomers,omitempty"`
 }
 
 // CorporateCustomersUploadResponse type.
@@ -156,6 +168,7 @@ type OrdersStatusesResponse struct {
 type OrdersUploadResponse struct {
 	Success        bool              `json:"success"`
 	UploadedOrders []IdentifiersPair `json:"uploadedOrders,omitempty"`
+	FailedOrders   []ExternalID      `json:"failedOrders,omitempty"`
 }
 
 // OrdersHistoryResponse type.
@@ -370,6 +383,23 @@ type ProductsResponse struct {
 	Products   []Product   `json:"products,omitempty"`
 }
 
+type ProductEditNotFoundResponse struct {
+	ID         string `json:"id"`
+	ExternalID string `json:"externalId,omitempty"`
+}
+
+type ProductsBatchEditResponse struct {
+	SuccessfulResponse
+	ProcessedProductsCount int                           `json:"processedProductsCount,omitempty"`
+	NotFoundProducts       []ProductEditNotFoundResponse `json:"notFoundProducts,omitempty"`
+}
+
+type ProductsBatchCreateResponse struct {
+	SuccessfulResponse
+	ProcessedProductsCount int   `json:"processedProductsCount,omitempty"`
+	AddedProducts          []int `json:"addedProducts,omitempty"`
+}
+
 // ProductsPropertiesResponse type.
 type ProductsPropertiesResponse struct {
 	Success    bool        `json:"success"`
@@ -377,6 +407,12 @@ type ProductsPropertiesResponse struct {
 	Properties []Property  `json:"properties,omitempty"`
 }
 
+// CartResponse type.
+type CartResponse struct {
+	SuccessfulResponse
+	Cart Cart `json:"cart"`
+}
+
 // DeliveryShipmentsResponse type.
 type DeliveryShipmentsResponse struct {
 	Success           bool               `json:"success"`
@@ -417,9 +453,10 @@ type IntegrationModuleEditResponse struct {
 
 // ResponseInfo type.
 type ResponseInfo struct {
-	MgTransportInfo MgInfo       `json:"mgTransport,omitempty"`
+	MgTransportInfo  MgInfo           `json:"mgTransport,omitempty"`
-	MgBotInfo       MgInfo       `json:"mgBot,omitempty"`
+	MgBotInfo        MgInfo           `json:"mgBot,omitempty"`
-	BillingInfo     *BillingInfo `json:"billingInfo,omitempty"`
+	BillingInfo      *BillingInfo     `json:"billingInfo,omitempty"`
+	DeliveryTypeInfo DeliveryTypeInfo `json:"deliveryType,omitempty"`
 }
 
 type BillingInfo struct {
@@ -550,3 +587,113 @@ func NewConnectResponse(accountURL string) ConnectResponse {
 		AccountURL:         accountURL,
 	}
 }
+
+// BonusOperationsResponse type.
+type BonusOperationsResponse struct {
+	Success         bool              `json:"success"`
+	Pagination      *CursorPagination `json:"pagination,omitempty"`
+	BonusOperations []BonusOperation  `json:"bonusOperations,omitempty"`
+}
+
+// AccountBonusOperationsResponse type.
+type AccountBonusOperationsResponse struct {
+	Success         bool             `json:"success"`
+	Pagination      *Pagination      `json:"pagination,omitempty"`
+	BonusOperations []BonusOperation `json:"bonusOperations,omitempty"`
+}
+
+// ClientIDResponse type.
+type ClientIDResponse struct {
+	ErrorMsg        string            `json:"errorMsg,omitempty"`
+	Errors          map[string]string `json:"errors,omitempty"`
+	FailedClientIds []ClientID        `json:"failed_client_ids,omitempty"`
+	Success         bool              `json:"success"`
+}
+
+// SourcesResponse type.
+type SourcesResponse struct {
+	ErrorMsg      string            `json:"errorMsg,omitempty"`
+	Errors        map[string]string `json:"errors,omitempty"`
+	FailedSources []Source          `json:"failed_sources,omitempty"`
+	Success       bool              `json:"success"`
+}
+
+// CurrencyResponse type.
+type CurrencyResponse struct {
+	Currencies []Currency `json:"currencies,omitempty"`
+	Success    bool       `json:"success"`
+}
+
+// CurrencyCreateResponse type.
+type CurrencyCreateResponse struct {
+	Success bool `json:"success"`
+	ID      int  `json:"id,omitempty"`
+}
+
+type LoyaltyAccountResponse struct {
+	SuccessfulResponse
+	LoyaltyAccount `json:"loyaltyAccount"`
+}
+
+type LoyaltyAccountActivateResponse struct {
+	SuccessfulResponse
+	LoyaltyAccount `json:"loyaltyAccount"`
+	Verification   SmsVerification `json:"verification,omitempty"`
+}
+
+type LoyaltyBonusCreditResponse struct {
+	SuccessfulResponse
+	LoyaltyBonus LoyaltyBonus `json:"loyaltyBonus"`
+}
+
+type LoyaltyBonusDetailsResponse struct {
+	SuccessfulResponse
+	Pagination `json:"pagination"`
+	Statistic  LoyaltyBonusStatisticResponse `json:"statistic"`
+	Bonuses    []BonusDetail                 `json:"bonuses,omitempty"`
+}
+
+type LoyaltyBonusStatisticResponse struct {
+	TotalAmount float64 `json:"totalAmount"`
+}
+
+type LoyaltyAccountsResponse struct {
+	SuccessfulResponse
+	Pagination      *Pagination      `json:"pagination"`
+	LoyaltyAccounts []LoyaltyAccount `json:"loyaltyAccounts,omitempty"`
+}
+
+type LoyaltyCalculateResponse struct {
+	SuccessfulResponse
+	Order        SerializedLoyaltyOrder `json:"order,omitempty"`
+	Calculations []LoyaltyCalculation   `json:"calculations,omitempty"`
+	Loyalty      SerializedLoyalty      `json:"loyalty,omitempty"`
+}
+
+type LoyaltiesResponse struct {
+	SuccessfulResponse
+	Pagination *Pagination `json:"pagination"`
+	Loyalties  []Loyalty   `json:"loyalties,omitempty"`
+}
+
+type LoyaltyResponse struct {
+	SuccessfulResponse
+	Loyalty Loyalty `json:"loyalty"`
+}
+
+type ActionProductsGroupResponse struct {
+	SuccessfulResponse
+	ID int `json:"id"`
+}
+
+type MGChannelTemplatesResponse struct {
+	Pagination *Pagination         `json:"pagination"`
+	Templates  []MGChannelTemplate `json:"templates"`
+	SuccessfulResponse
+}
+
+type StoreOffersResponse struct {
+	Pagination *Pagination `json:"pagination"`
+	SuccessfulResponse
+	Offers []Offer `json:"offers,omitempty"`
+}

system_time.go

@@ -0,0 +1,30 @@
+package retailcrm
+
+import (
+	"fmt"
+	"strings"
+	"time"
+)
+
+type SystemTime time.Time
+
+const systemTimeLayout = "2006-01-02 15:04:05"
+
+// UnmarshalJSON parses time.Time from system format.
+func (st *SystemTime) UnmarshalJSON(b []byte) (err error) {
+	s := strings.Trim(string(b), `"`)
+	nt, err := time.Parse(systemTimeLayout, s)
+	*st = SystemTime(nt)
+	return
+}
+
+// MarshalJSON will marshal time.Time to system format.
+func (st SystemTime) MarshalJSON() ([]byte, error) {
+	return []byte(st.String()), nil
+}
+
+// String returns the time in the custom format.
+func (st *SystemTime) String() string {
+	t := time.Time(*st)
+	return fmt.Sprintf("%q", t.Format(systemTimeLayout))
+}

template.go

@@ -0,0 +1,122 @@
+package retailcrm
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+)
+
+const (
+	// TemplateItemTypeText is a type for text chunk in template.
+	TemplateItemTypeText uint8 = iota
+	// TemplateItemTypeVar is a type for variable in template.
+	TemplateItemTypeVar
+	QuickReply  ButtonType = "QUICK_REPLY"
+	PhoneNumber ButtonType = "PHONE_NUMBER"
+	URL         ButtonType = "URL"
+)
+
+const (
+	// TemplateVarCustom is a custom variable type.
+	TemplateVarCustom = "custom"
+	// TemplateVarName is a name variable type.
+	TemplateVarName = "name"
+	// TemplateVarFirstName is a first name variable type.
+	TemplateVarFirstName = "first_name"
+	// TemplateVarLastName is a last name variable type.
+	TemplateVarLastName = "last_name"
+)
+
+// templateVarAssoc for checking variable validity, only for internal use.
+var templateVarAssoc = map[string]interface{}{
+	TemplateVarCustom:    nil,
+	TemplateVarName:      nil,
+	TemplateVarFirstName: nil,
+	TemplateVarLastName:  nil,
+}
+
+type Text struct {
+	Parts   []TextTemplateItem `json:"parts"`
+	Example []string           `json:"example,omitempty"`
+}
+
+type Media struct {
+	Example string `json:"example,omitempty"`
+}
+
+type Header struct {
+	Text     *Text  `json:"text,omitempty"`
+	Document *Media `json:"document,omitempty"`
+	Image    *Media `json:"image,omitempty"`
+	Video    *Media `json:"video,omitempty"`
+}
+
+type TemplateItemList []TextTemplateItem
+
+// TextTemplateItem is a part of template.
+type TextTemplateItem struct {
+	Text    string
+	VarType string
+	Type    uint8
+}
+
+// MarshalJSON controls how TextTemplateItem will be marshaled into JSON.
+func (t TextTemplateItem) MarshalJSON() ([]byte, error) {
+	switch t.Type {
+	case TemplateItemTypeText:
+		return json.Marshal(t.Text)
+	case TemplateItemTypeVar:
+		return json.Marshal(map[string]interface{}{
+			"var": t.VarType,
+		})
+	}
+
+	return nil, errors.New("unknown TextTemplateItem type")
+}
+
+// UnmarshalJSON will correctly unmarshal TextTemplateItem.
+func (t *TextTemplateItem) UnmarshalJSON(b []byte) error {
+	var obj interface{}
+	err := json.Unmarshal(b, &obj)
+	if err != nil {
+		return err
+	}
+
+	switch bodyPart := obj.(type) {
+	case string:
+		t.Type = TemplateItemTypeText
+		t.Text = bodyPart
+	case map[string]interface{}:
+		// {} case
+		if len(bodyPart) == 0 {
+			t.Type = TemplateItemTypeText
+			t.Text = "{}"
+			return nil
+		}
+
+		if varTypeCurr, ok := bodyPart["var"].(string); ok {
+			if _, ok := templateVarAssoc[varTypeCurr]; !ok {
+				return fmt.Errorf("invalid placeholder var '%s'", varTypeCurr)
+			}
+
+			t.Type = TemplateItemTypeVar
+			t.VarType = varTypeCurr
+		} else {
+			return errors.New("invalid TextTemplateItem")
+		}
+	default:
+		return errors.New("invalid TextTemplateItem")
+	}
+
+	return nil
+}
+
+type ButtonType string
+
+type Button struct {
+	Type        ButtonType `json:"type"`
+	URL         string     `json:"url,omitempty"`
+	Text        string     `json:"text,omitempty"`
+	PhoneNumber string     `json:"phoneNumber,omitempty"`
+	Example     []string   `json:"example,omitempty"`
+}

testutils.go

@@ -0,0 +1,565 @@
+//go:build testutils
+// +build testutils
+
+package retailcrm
+
+func getProductsCreate() []ProductCreate {
+	products := []ProductCreate{
+		{
+			CatalogID: 3,
+			BaseProduct: BaseProduct{
+				Name:         "Product 1",
+				URL:          "https://example.com/p/1",
+				Article:      "p1",
+				ExternalID:   "ext1",
+				Manufacturer: "man1",
+				Description:  "Description 1",
+				Popular:      true,
+				Stock:        true,
+				Novelty:      true,
+				Recommended:  true,
+				Active:       true,
+				Markable:     true,
+			},
+			Groups: []ProductEditGroupInput{{ID: 19}},
+		},
+		{
+			CatalogID: 3,
+			BaseProduct: BaseProduct{
+				Name:         "Product 2",
+				URL:          "https://example.com/p/2",
+				Article:      "p2",
+				ExternalID:   "ext2",
+				Manufacturer: "man2",
+				Description:  "Description 2",
+				Popular:      true,
+				Stock:        true,
+				Novelty:      true,
+				Recommended:  true,
+				Active:       true,
+				Markable:     true,
+			},
+			Groups: []ProductEditGroupInput{{ID: 19}},
+		},
+	}
+
+	return products
+}
+
+func getProductsCreateResponse() ProductsBatchCreateResponse {
+	return ProductsBatchCreateResponse{
+		SuccessfulResponse:     SuccessfulResponse{Success: true},
+		ProcessedProductsCount: 2,
+		AddedProducts:          []int{1, 2},
+	}
+}
+
+func getProductsEdit() []ProductEdit {
+	products := []ProductEdit{
+		{
+			BaseProduct: getProductsCreate()[0].BaseProduct,
+			ID:          194,
+			CatalogID:   3,
+			Site:        "second",
+		},
+		{
+			BaseProduct: getProductsCreate()[1].BaseProduct,
+			ID:          195,
+			CatalogID:   3,
+			Site:        "second",
+		},
+	}
+
+	return products
+}
+
+func getProductsEditResponse() ProductsBatchEditResponse {
+	return ProductsBatchEditResponse{
+		SuccessfulResponse:     SuccessfulResponse{Success: true},
+		ProcessedProductsCount: 2,
+		NotFoundProducts:       nil,
+	}
+}
+
+func getLoyaltyAccountCreate() SerializedCreateLoyaltyAccount {
+	return SerializedCreateLoyaltyAccount{
+		SerializedBaseLoyaltyAccount: SerializedBaseLoyaltyAccount{
+			PhoneNumber:  "89151005004",
+			CustomFields: []interface{}{"dog"},
+		},
+		Customer: SerializedEntityCustomer{
+			ID: 123,
+		},
+	}
+}
+
+func getLoyaltyAccountCreateResponse() CreateLoyaltyAccountResponse {
+	return CreateLoyaltyAccountResponse{
+		SuccessfulResponse: SuccessfulResponse{Success: true},
+		LoyaltyAccount: LoyaltyAccount{
+			Active:       true,
+			ID:           13,
+			PhoneNumber:  "89151005004",
+			LoyaltyLevel: LoyaltyLevel{},
+			CreatedAt:    "2022-11-24 12:39:37",
+			ActivatedAt:  "2022-11-24 12:39:37",
+			CustomFields: map[string]interface{}{
+				"animal": "dog",
+			},
+		},
+	}
+}
+
+func getLoyaltyAccountEditResponse() EditLoyaltyAccountResponse {
+	return EditLoyaltyAccountResponse{
+		SuccessfulResponse: SuccessfulResponse{Success: true},
+		LoyaltyAccount: LoyaltyAccount{
+			Active:       true,
+			ID:           13,
+			PhoneNumber:  "89142221020",
+			LoyaltyLevel: LoyaltyLevel{},
+			CreatedAt:    "2022-11-24 12:39:37",
+			ActivatedAt:  "2022-11-24 12:39:37",
+			CustomFields: map[string]interface{}{
+				"animal": "dog",
+			},
+		},
+	}
+}
+
+func getLoyaltyAccountResponse() string {
+	return `{
+		"success": true,
+		"loyaltyAccount": {
+			"active": true,
+			"id": 13,
+			"loyalty": {
+				"id": 2
+			},
+			"customer": {
+				"id": 123,
+				"customFields": {},
+				"firstName": "Руслан1",
+				"lastName": "Ефанов",
+				"patronymic": ""
+			},
+			"phoneNumber": "89142221020",
+			"amount": 0,
+			"ordersSum": 0,
+			"nextLevelSum": 10000,
+			"level": {
+				"type": "bonus_percent",
+				"id": 5,
+				"name": "Новичок",
+				"sum": 0,
+				"privilegeSize": 5,
+				"privilegeSizePromo": 3
+			},
+			"createdAt": "2022-11-24 12:39:37",
+			"activatedAt": "2022-11-24 12:39:37",
+			"status": "activated",
+			"customFields": {
+				"custom_multiselect": ["test1", "test3"],
+				"custom_select": "test2",
+				"custom_integer": 456,
+				"custom_float": 8.43
+			}
+		}
+	}`
+}
+
+func getBonusDetailsResponse() string {
+	return `{
+		"success": true,
+		"pagination": {
+			"limit": 20,
+			"totalCount": 41,
+			"currentPage": 3,
+			"totalPageCount": 3
+		},
+		"statistic": {
+			"totalAmount": 240
+		},
+		"bonuses": [
+			{
+				"date": "2022-12-08",
+				"amount": 240
+			}
+		]
+	}`
+}
+
+func getLoyaltyAccountsResponse() string {
+	return `{
+		"success": true,
+		"pagination": {
+			"limit": 20,
+			"totalCount": 1,
+			"currentPage": 1,
+			"totalPageCount": 1
+		},
+		"loyaltyAccounts": [
+			{
+				"active": true,
+				"id": 14,
+				"loyalty": {
+					"id": 2
+				},
+				"customer": {
+					"id": 109,
+					"firstName": "Казимир",
+					"lastName": "Эльбрусов"
+				},
+				"phoneNumber": "89185556363",
+				"amount": 0,
+				"ordersSum": 0,
+				"nextLevelSum": 10000,
+				"level": {
+					"type": "bonus_percent",
+					"id": 5,
+					"name": "Новичок",
+					"sum": 0,
+					"privilegeSize": 5,
+					"privilegeSizePromo": 3
+				},
+				"createdAt": "2022-12-07 15:27:04",
+				"activatedAt": "2022-12-07 15:27:04",
+				"status": "activated"
+			}
+		]
+	}`
+}
+
+func getLoyaltyCalculateReq() LoyaltyCalculateRequest {
+	return LoyaltyCalculateRequest{
+		Site: "main",
+		Order: Order{
+			PrivilegeType: "loyalty_level",
+			Customer: &Customer{
+				ID: 123,
+			},
+			Items: []OrderItem{
+				{
+					InitialPrice: 10000,
+					Quantity:     1,
+					Offer:        Offer{ID: 214},
+					PriceType:    &PriceType{Code: "base"},
+				},
+			},
+		},
+		Bonuses: 10,
+	}
+}
+
+func getLoyaltyCalculateResponse() string {
+	return `{
+		"success": true,
+		"order": {
+			"bonusesCreditTotal": 999,
+			"bonusesChargeTotal": 10,
+			"privilegeType": "loyalty_level",
+			"totalSumm": 9990,
+			"loyaltyAccount": {
+				"id": 13,
+				"amount": 240
+			},
+			"loyaltyLevel": {
+				"id": 6,
+				"name": "Любитель"
+			},
+			"customer": {
+				"id": 123,
+				"personalDiscount": 0
+			},
+			"delivery": {
+				"cost": 0
+			},
+			"site": "main",
+			"items": [
+				{
+					"bonusesChargeTotal": 10,
+					"bonusesCreditTotal": 999,
+					"priceType": {
+						"code": "base"
+					},
+					"initialPrice": 10000,
+					"discounts": [
+						{
+							"type": "bonus_charge",
+							"amount": 10
+						}
+					],
+					"discountTotal": 10,
+					"prices": [
+						{
+							"price": 9990,
+							"quantity": 1
+						}
+					],
+					"quantity": 1,
+					"offer": {
+						"xmlId": "696999ed-bc8d-4d0f-9627-527acf7b1d57"
+					}
+				}
+			]
+		},
+		"calculations": [
+			{
+				"privilegeType": "loyalty_level",
+				"discount": 10,
+				"creditBonuses": 999,
+				"maxChargeBonuses": 240,
+				"maximum": true
+			},
+			{
+				"privilegeType": "none",
+				"discount": 10,
+				"creditBonuses": 0,
+				"maxChargeBonuses": 240,
+				"maximum": false
+			}
+		],
+		"loyalty": {
+			"name": "Бонусная программа",
+			"chargeRate": 1
+		}
+	}`
+}
+
+func getLoyaltiesResponse() string {
+	return `{
+		"success": true,
+		"pagination": {
+			"limit": 20,
+			"totalCount": 1,
+			"currentPage": 1,
+			"totalPageCount": 1
+		},
+		"loyalties": [
+			{
+				"levels": [
+					{
+						"type": "bonus_percent",
+						"id": 5,
+						"name": "Новичок",
+						"sum": 0,
+						"privilegeSize": 5,
+						"privilegeSizePromo": 3
+					},
+					{
+						"type": "bonus_percent",
+						"id": 6,
+						"name": "Любитель",
+						"sum": 10000,
+						"privilegeSize": 10,
+						"privilegeSizePromo": 5
+					},
+					{
+						"type": "bonus_percent",
+						"id": 7,
+						"name": "Продвинутый покупатель",
+						"sum": 25000,
+						"privilegeSize": 15,
+						"privilegeSizePromo": 7
+					},
+					{
+						"type": "bonus_percent",
+						"id": 8,
+						"name": "Мастер шоппинга",
+						"sum": 50000,
+						"privilegeSize": 20,
+						"privilegeSizePromo": 10
+					}
+				],
+				"active": true,
+				"blocked": false,
+				"id": 2,
+				"name": "Бонусная программа",
+				"confirmSmsCharge": false,
+				"confirmSmsRegistration": false,
+				"createdAt": "2022-01-18 15:40:22",
+				"activatedAt": "2022-12-08 12:05:45"
+			}
+		]
+	}`
+}
+
+func getLoyaltyResponse() string {
+	return `{
+    "success": true,
+    "loyalty": {
+        "levels": [
+            {
+                "type": "bonus_percent",
+                "id": 5,
+                "name": "Новичок",
+                "sum": 0,
+                "privilegeSize": 5,
+                "privilegeSizePromo": 3
+            },
+            {
+                "type": "bonus_percent",
+                "id": 6,
+                "name": "Любитель",
+                "sum": 10000,
+                "privilegeSize": 10,
+                "privilegeSizePromo": 5
+            },
+            {
+                "type": "bonus_percent",
+                "id": 7,
+                "name": "Продвинутый покупатель",
+                "sum": 25000,
+                "privilegeSize": 15,
+                "privilegeSizePromo": 7
+            },
+            {
+                "type": "bonus_percent",
+                "id": 8,
+                "name": "Мастер шоппинга",
+                "sum": 50000,
+                "privilegeSize": 20,
+                "privilegeSizePromo": 10
+            }
+        ],
+        "active": true,
+        "blocked": false,
+        "id": 2,
+        "name": "Бонусная программа",
+        "confirmSmsCharge": false,
+        "confirmSmsRegistration": false,
+        "createdAt": "2022-01-18 15:40:22",
+        "activatedAt": "2022-12-08 12:05:45"
+    }
+}`
+}
+
+func getMGTemplatesResponse() string {
+	return `{
+    "success": true,
+    "pagination": {
+        "limit": 10,
+        "totalCount": 100,
+        "currentPage": 5,
+        "totalPageCount": 10
+    },
+    "templates": [
+        {
+            "id": 1,
+            "externalId": 0,
+            "channel": {
+                "allowedSendByPhone": false,
+                "id": 1,
+                "externalId": 1,
+                "type": "fbmessenger",
+                "active": true,
+                "name": "fbmessenger"
+            },
+            "code": "namespace#NAMEAAA#ru",
+            "name": "NAMEAAA",
+            "active": true,
+            "template": [
+                "Text_0",
+                {
+                    "var": "custom"
+                }
+            ],
+			"templateExample": ["Text_1"],
+            "namespace": "namespace_0",
+            "lang": "en",
+            "category": "test_0",
+            "header": {
+                "text": {
+                    "parts": [
+						"JABAAA",
+						{
+							"var": "custom"
+						}
+					],
+                    "example": [
+                        "AAAAAA"
+                    ]
+                },
+                "image": {
+                    "example": "https://example.com/file/123.png"
+                },
+                "document": {
+                    "example": "https://example.com/file/123.pdf"
+                },
+                "video": {
+                    "example": "https://example.com/file/123.mp4"
+                }
+            },
+            "footer": "footer_0",
+            "buttons": [
+                {
+                    "type": "PHONE_NUMBER",
+                    "text": "your-phone-button-text",
+                    "phoneNumber": "+79895553535"
+                },
+                {
+                    "type": "QUICK_REPLY",
+                    "text": "Yes"
+                },
+                {
+                    "type": "URL",
+                    "url": "https://example.com/file/{{1}}",
+                    "text": "button",
+                    "example": [
+                        "https://www.website.com/dynamic-url-example"
+                    ]
+                }
+            ],
+            "verificationStatus": "APPROVED"
+        }
+    ]
+}`
+}
+
+func getMGTemplatesForEdit() string {
+	return `[{"header":{"text":{"parts":["Hello,",{"var":"custom"}],"example":["Henry"]},"document":{"example":"https://example.com/file/123.pdf"},"image":{"example":"https://example.com/file/123.png"},"video":{"example":"https://example.com/file/123.mp4"}},"lang":"en","category":"test_0","code":"namespace#name_0#ru","name":"name_0","namespace":"namespace","footer":"footer_0","verificationStatus":"REJECTED","template":["Text_0",{"var":"custom"}],"buttons":[{"type":"PHONE_NUMBER","text":"your-phone-button-text","phoneNumber":"+79895553535"},{"type":"QUICK_REPLY","text":"Yes"},{"type":"URL","url":"https://example.com/file/{{1}}","text":"button","example":["https://www.website.com/dynamic-url-example"]}],"templateExample":["WIU"],"id":1,"externalId":10,"mgChannelId":110,"active":true}]`
+}
+
+func getStoreOfferResponse() string {
+	return `{
+    "success": true,
+    "pagination": {
+        "limit": 20,
+        "totalCount": 1,
+        "currentPage": 1,
+        "totalPageCount": 1
+    },
+    "offers": [
+        {
+            "images": [
+                "https://s3-s1.retailcrm.tech/ru-central1/retailcrm/dev-vega-d32aea7f9a5bc26eba6ad986077cea03/product/65a92fa0bb737-test.jpeg"
+            ],
+            "id": 76,
+            "site": "main",
+            "name": "Название\nПеревод строки",
+            "article": "Артикул",
+            "product": {
+                "type": "product",
+                "catalogId": 2,
+                "id": 222
+            },
+            "prices": [
+                {
+                    "priceType": "base",
+                    "price": 10000,
+                    "ordering": 991,
+                    "currency": "RUB"
+                }
+            ],
+            "purchasePrice": 10,
+            "quantity": 5,
+            "active": true,
+            "unit": {
+                "code": "pc",
+                "name": "Штука",
+                "sym": "шт."
+            }
+        }
+    ]
+}`
+}