wildberries-sdk 0.1.9__py3-none-any.whl

wildberries_sdk/orders_fbw/exceptions.py

@@ -0,0 +1,219 @@
+# coding: utf-8
+
+"""
+    Поставки FBW
+
+    <div class=\"description_important\">     Узнать больше о поставках FBW можно в <a href=\"https://seller.wildberries.ru/instructions/subcategory/5a8e1202-0865-45b7-acae-5d0afc7add56?goBackOption=prevRoute&categoryId=479385c6-de01-4b4d-ad4e-ed941e65582e\">справочном центре</a> </div>  В разделе описаны методы получения:   - [информации для формирования поставок](/openapi/orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok)   - [информации о поставках](/openapi/orders-fbw#tag/Informaciya-o-postavkah) 
+
+    The version of the OpenAPI document: ordersfbw
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+from typing import Any, Optional
+from typing_extensions import Self
+
+class OpenApiException(Exception):
+    """The base exception class for all OpenAPIExceptions"""
+
+
+class ApiTypeError(OpenApiException, TypeError):
+    def __init__(self, msg, path_to_item=None, valid_classes=None,
+                 key_type=None) -> None:
+        """ Raises an exception for TypeErrors
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list): a list of keys an indices to get to the
+                                 current_item
+                                 None if unset
+            valid_classes (tuple): the primitive classes that current item
+                                   should be an instance of
+                                   None if unset
+            key_type (bool): False if our value is a value in a dict
+                             True if it is a key in a dict
+                             False if our item is an item in a list
+                             None if unset
+        """
+        self.path_to_item = path_to_item
+        self.valid_classes = valid_classes
+        self.key_type = key_type
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiTypeError, self).__init__(full_msg)
+
+
+class ApiValueError(OpenApiException, ValueError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (list) the path to the exception in the
+                received_data dict. None if unset
+        """
+
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiValueError, self).__init__(full_msg)
+
+
+class ApiAttributeError(OpenApiException, AttributeError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Raised when an attribute reference or assignment fails.
+
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiAttributeError, self).__init__(full_msg)
+
+
+class ApiKeyError(OpenApiException, KeyError):
+    def __init__(self, msg, path_to_item=None) -> None:
+        """
+        Args:
+            msg (str): the exception message
+
+        Keyword Args:
+            path_to_item (None/list) the path to the exception in the
+                received_data dict
+        """
+        self.path_to_item = path_to_item
+        full_msg = msg
+        if path_to_item:
+            full_msg = "{0} at {1}".format(msg, render_path(path_to_item))
+        super(ApiKeyError, self).__init__(full_msg)
+
+
+class ApiException(OpenApiException):
+
+    def __init__(
+        self, 
+        status=None, 
+        reason=None, 
+        http_resp=None,
+        *,
+        body: Optional[str] = None,
+        data: Optional[Any] = None,
+    ) -> None:
+        self.status = status
+        self.reason = reason
+        self.body = body
+        self.data = data
+        self.headers = None
+
+        if http_resp:
+            if self.status is None:
+                self.status = http_resp.status
+            if self.reason is None:
+                self.reason = http_resp.reason
+            if self.body is None:
+                try:
+                    self.body = http_resp.data.decode('utf-8')
+                except Exception:
+                    pass
+            self.headers = http_resp.headers
+
+    @classmethod
+    def from_response(
+        cls, 
+        *, 
+        http_resp, 
+        body: Optional[str], 
+        data: Optional[Any],
+    ) -> Self:
+        if http_resp.status == 400:
+            raise BadRequestException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 401:
+            raise UnauthorizedException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 403:
+            raise ForbiddenException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 404:
+            raise NotFoundException(http_resp=http_resp, body=body, data=data)
+
+        # Added new conditions for 409 and 422
+        if http_resp.status == 409:
+            raise ConflictException(http_resp=http_resp, body=body, data=data)
+
+        if http_resp.status == 422:
+            raise UnprocessableEntityException(http_resp=http_resp, body=body, data=data)
+
+        if 500 <= http_resp.status <= 599:
+            raise ServiceException(http_resp=http_resp, body=body, data=data)
+        raise ApiException(http_resp=http_resp, body=body, data=data)
+
+    def __str__(self):
+        """Custom error messages for exception"""
+        error_message = "({0})\n"\
+                        "Reason: {1}\n".format(self.status, self.reason)
+        if self.headers:
+            error_message += "HTTP response headers: {0}\n".format(
+                self.headers)
+
+        if self.body:
+            error_message += "HTTP response body: {0}\n".format(self.body)
+
+        if self.data:
+            error_message += "HTTP response data: {0}\n".format(self.data)
+
+        return error_message
+
+
+class BadRequestException(ApiException):
+    pass
+
+
+class NotFoundException(ApiException):
+    pass
+
+
+class UnauthorizedException(ApiException):
+    pass
+
+
+class ForbiddenException(ApiException):
+    pass
+
+
+class ServiceException(ApiException):
+    pass
+
+
+class ConflictException(ApiException):
+    """Exception for HTTP 409 Conflict."""
+    pass
+
+
+class UnprocessableEntityException(ApiException):
+    """Exception for HTTP 422 Unprocessable Entity."""
+    pass
+
+
+def render_path(path_to_item):
+    """Returns a string representation of a path"""
+    result = ""
+    for pth in path_to_item:
+        if isinstance(pth, int):
+            result += "[{0}]".format(pth)
+        else:
+            result += "['{0}']".format(pth)
+    return result

wildberries_sdk/orders_fbw/models/__init__.py

@@ -0,0 +1,35 @@
+# coding: utf-8
+
+# flake8: noqa
+"""
+    Поставки FBW
+
+    <div class=\"description_important\">     Узнать больше о поставках FBW можно в <a href=\"https://seller.wildberries.ru/instructions/subcategory/5a8e1202-0865-45b7-acae-5d0afc7add56?goBackOption=prevRoute&categoryId=479385c6-de01-4b4d-ad4e-ed941e65582e\">справочном центре</a> </div>  В разделе описаны методы получения:   - [информации для формирования поставок](/openapi/orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok)   - [информации о поставках](/openapi/orders-fbw#tag/Informaciya-o-postavkah) 
+
+    The version of the OpenAPI document: ordersfbw
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+# import models into model package
+from wildberries_sdk.orders_fbw.models.api_v1_acceptance_coefficients_get401_response import ApiV1AcceptanceCoefficientsGet401Response
+from wildberries_sdk.orders_fbw.models.models_acceptance_coefficient import ModelsAcceptanceCoefficient
+from wildberries_sdk.orders_fbw.models.models_box import ModelsBox
+from wildberries_sdk.orders_fbw.models.models_date_filter_request import ModelsDateFilterRequest
+from wildberries_sdk.orders_fbw.models.models_error_model import ModelsErrorModel
+from wildberries_sdk.orders_fbw.models.models_good import ModelsGood
+from wildberries_sdk.orders_fbw.models.models_good_in_box import ModelsGoodInBox
+from wildberries_sdk.orders_fbw.models.models_good_in_supply import ModelsGoodInSupply
+from wildberries_sdk.orders_fbw.models.models_handy_supply_status import ModelsHandySupplyStatus
+from wildberries_sdk.orders_fbw.models.models_options_result_model import ModelsOptionsResultModel
+from wildberries_sdk.orders_fbw.models.models_options_result_model_result_inner import ModelsOptionsResultModelResultInner
+from wildberries_sdk.orders_fbw.models.models_options_result_model_result_inner_error import ModelsOptionsResultModelResultInnerError
+from wildberries_sdk.orders_fbw.models.models_options_result_model_result_inner_warehouses_inner import ModelsOptionsResultModelResultInnerWarehousesInner
+from wildberries_sdk.orders_fbw.models.models_supplies_filters_request import ModelsSuppliesFiltersRequest
+from wildberries_sdk.orders_fbw.models.models_supply import ModelsSupply
+from wildberries_sdk.orders_fbw.models.models_supply_details import ModelsSupplyDetails
+from wildberries_sdk.orders_fbw.models.models_transit_tariff import ModelsTransitTariff
+from wildberries_sdk.orders_fbw.models.models_volume_tariff import ModelsVolumeTariff
+from wildberries_sdk.orders_fbw.models.models_warehouses_result_items import ModelsWarehousesResultItems
+

wildberries_sdk/orders_fbw/models/api_v1_acceptance_coefficients_get401_response.py

@@ -0,0 +1,102 @@
+# coding: utf-8
+
+"""
+    Поставки FBW
+
+    <div class=\"description_important\">     Узнать больше о поставках FBW можно в <a href=\"https://seller.wildberries.ru/instructions/subcategory/5a8e1202-0865-45b7-acae-5d0afc7add56?goBackOption=prevRoute&categoryId=479385c6-de01-4b4d-ad4e-ed941e65582e\">справочном центре</a> </div>  В разделе описаны методы получения:   - [информации для формирования поставок](/openapi/orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok)   - [информации о поставках](/openapi/orders-fbw#tag/Informaciya-o-postavkah) 
+
+    The version of the OpenAPI document: ordersfbw
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import datetime
+from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ApiV1AcceptanceCoefficientsGet401Response(BaseModel):
+    """
+    ApiV1AcceptanceCoefficientsGet401Response
+    """ # noqa: E501
+    title: Optional[StrictStr] = Field(default=None, description="Заголовок ошибки")
+    detail: Optional[StrictStr] = Field(default=None, description="Детали ошибки")
+    code: Optional[StrictStr] = Field(default=None, description="Внутренний код ошибки")
+    request_id: Optional[StrictStr] = Field(default=None, description="Уникальный ID запроса", alias="requestId")
+    origin: Optional[StrictStr] = Field(default=None, description="ID внутреннего сервиса WB")
+    status: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="HTTP статус-код")
+    status_text: Optional[StrictStr] = Field(default=None, description="Расшифровка HTTP статус-кода", alias="statusText")
+    timestamp: Optional[datetime] = Field(default=None, description="Дата и время запроса")
+    __properties: ClassVar[List[str]] = ["title", "detail", "code", "requestId", "origin", "status", "statusText", "timestamp"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ApiV1AcceptanceCoefficientsGet401Response from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ApiV1AcceptanceCoefficientsGet401Response from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "title": obj.get("title"),
+            "detail": obj.get("detail"),
+            "code": obj.get("code"),
+            "requestId": obj.get("requestId"),
+            "origin": obj.get("origin"),
+            "status": obj.get("status"),
+            "statusText": obj.get("statusText"),
+            "timestamp": obj.get("timestamp")
+        })
+        return _obj
+
+

wildberries_sdk/orders_fbw/models/models_acceptance_coefficient.py

@@ -0,0 +1,141 @@
+# coding: utf-8
+
+"""
+    Поставки FBW
+
+    <div class=\"description_important\">     Узнать больше о поставках FBW можно в <a href=\"https://seller.wildberries.ru/instructions/subcategory/5a8e1202-0865-45b7-acae-5d0afc7add56?goBackOption=prevRoute&categoryId=479385c6-de01-4b4d-ad4e-ed941e65582e\">справочном центре</a> </div>  В разделе описаны методы получения:   - [информации для формирования поставок](/openapi/orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok)   - [информации о поставках](/openapi/orders-fbw#tag/Informaciya-o-postavkah) 
+
+    The version of the OpenAPI document: ordersfbw
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictFloat, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ModelsAcceptanceCoefficient(BaseModel):
+    """
+    ModelsAcceptanceCoefficient
+    """ # noqa: E501
+    var_date: Optional[StrictStr] = Field(default=None, description="Дата начала действия коэффициента", alias="date")
+    coefficient: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="Коэффициент приёмки:   - `-1` — приёмка недоступна, вне зависимости от значения поля `allowUnload`   - `0` — бесплатная приёмка   - от `1` — множитель стоимости приёмки ")
+    warehouse_id: Optional[StrictInt] = Field(default=None, description="ID склада. По нему можно получить [информацию о складе](./orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok/paths/~1api~1v1~1warehouses/get)", alias="warehouseID")
+    warehouse_name: Optional[StrictStr] = Field(default=None, description="Название склада", alias="warehouseName")
+    allow_unload: Optional[StrictBool] = Field(default=None, description="Доступность приёмки для поставок данного типа, смотри значение поля `boxTypeID`:   - `true` — приёмка доступна  - `false` — приёмка не доступна ", alias="allowUnload")
+    box_type_id: Optional[StrictInt] = Field(default=None, description="ID типа поставки:   - `2` — Короба   - `5` — Монопаллеты   - `6` — Суперсейф <br>Для типа поставки **QR-поставка с коробами** поле не возвращается ", alias="boxTypeID")
+    storage_coef: Optional[StrictStr] = Field(default=None, description="Коэффициент хранения", alias="storageCoef")
+    delivery_coef: Optional[StrictStr] = Field(default=None, description="Коэффициент логистики", alias="deliveryCoef")
+    delivery_base_liter: Optional[StrictStr] = Field(default=None, description="Стоимость логистики первого литра", alias="deliveryBaseLiter")
+    delivery_additional_liter: Optional[StrictStr] = Field(default=None, description="Стоимость логистики каждого следующего литра", alias="deliveryAdditionalLiter")
+    storage_base_liter: Optional[StrictStr] = Field(default=None, description="Стоимость хранения:   - для паллет — стоимость за одну паллету   - для коробов — стоимость хранения за первый литр ", alias="storageBaseLiter")
+    storage_additional_liter: Optional[StrictStr] = Field(default=None, description="Стоимость хранения каждого последующего литра:   - для паллет — всегда будет `null`, т.к. стоимость хранения за единицу паллеты определяется в `StorageBaseLiter`   - для коробов — стоимость хранения за каждый последующий литр ", alias="storageAdditionalLiter")
+    is_sorting_center: Optional[StrictBool] = Field(default=None, description="Тип склада:   - `true` — сортировочный центр (СЦ)  - `false` — обычный ", alias="isSortingCenter")
+    __properties: ClassVar[List[str]] = ["date", "coefficient", "warehouseID", "warehouseName", "allowUnload", "boxTypeID", "storageCoef", "deliveryCoef", "deliveryBaseLiter", "deliveryAdditionalLiter", "storageBaseLiter", "storageAdditionalLiter", "isSortingCenter"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ModelsAcceptanceCoefficient from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if storage_coef (nullable) is None
+        # and model_fields_set contains the field
+        if self.storage_coef is None and "storage_coef" in self.model_fields_set:
+            _dict['storageCoef'] = None
+
+        # set to None if delivery_coef (nullable) is None
+        # and model_fields_set contains the field
+        if self.delivery_coef is None and "delivery_coef" in self.model_fields_set:
+            _dict['deliveryCoef'] = None
+
+        # set to None if delivery_base_liter (nullable) is None
+        # and model_fields_set contains the field
+        if self.delivery_base_liter is None and "delivery_base_liter" in self.model_fields_set:
+            _dict['deliveryBaseLiter'] = None
+
+        # set to None if delivery_additional_liter (nullable) is None
+        # and model_fields_set contains the field
+        if self.delivery_additional_liter is None and "delivery_additional_liter" in self.model_fields_set:
+            _dict['deliveryAdditionalLiter'] = None
+
+        # set to None if storage_base_liter (nullable) is None
+        # and model_fields_set contains the field
+        if self.storage_base_liter is None and "storage_base_liter" in self.model_fields_set:
+            _dict['storageBaseLiter'] = None
+
+        # set to None if storage_additional_liter (nullable) is None
+        # and model_fields_set contains the field
+        if self.storage_additional_liter is None and "storage_additional_liter" in self.model_fields_set:
+            _dict['storageAdditionalLiter'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ModelsAcceptanceCoefficient from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "date": obj.get("date"),
+            "coefficient": obj.get("coefficient"),
+            "warehouseID": obj.get("warehouseID"),
+            "warehouseName": obj.get("warehouseName"),
+            "allowUnload": obj.get("allowUnload"),
+            "boxTypeID": obj.get("boxTypeID"),
+            "storageCoef": obj.get("storageCoef"),
+            "deliveryCoef": obj.get("deliveryCoef"),
+            "deliveryBaseLiter": obj.get("deliveryBaseLiter"),
+            "deliveryAdditionalLiter": obj.get("deliveryAdditionalLiter"),
+            "storageBaseLiter": obj.get("storageBaseLiter"),
+            "storageAdditionalLiter": obj.get("storageAdditionalLiter"),
+            "isSortingCenter": obj.get("isSortingCenter")
+        })
+        return _obj
+
+

wildberries_sdk/orders_fbw/models/models_box.py

@@ -0,0 +1,99 @@
+# coding: utf-8
+
+"""
+    Поставки FBW
+
+    <div class=\"description_important\">     Узнать больше о поставках FBW можно в <a href=\"https://seller.wildberries.ru/instructions/subcategory/5a8e1202-0865-45b7-acae-5d0afc7add56?goBackOption=prevRoute&categoryId=479385c6-de01-4b4d-ad4e-ed941e65582e\">справочном центре</a> </div>  В разделе описаны методы получения:   - [информации для формирования поставок](/openapi/orders-fbw#tag/Informaciya-dlya-formirovaniya-postavok)   - [информации о поставках](/openapi/orders-fbw#tag/Informaciya-o-postavkah) 
+
+    The version of the OpenAPI document: ordersfbw
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from wildberries_sdk.orders_fbw.models.models_good_in_box import ModelsGoodInBox
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ModelsBox(BaseModel):
+    """
+    ModelsBox
+    """ # noqa: E501
+    package_code: Optional[StrictStr] = Field(default=None, description="Штрих-код упаковки", alias="packageCode")
+    quantity: Optional[StrictInt] = Field(default=None, description="Суммарное количество товара в упаковке, шт")
+    barcodes: Optional[List[ModelsGoodInBox]] = Field(default=None, description="Список упакованных товаров")
+    __properties: ClassVar[List[str]] = ["packageCode", "quantity", "barcodes"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ModelsBox from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in barcodes (list)
+        _items = []
+        if self.barcodes:
+            for _item_barcodes in self.barcodes:
+                if _item_barcodes:
+                    _items.append(_item_barcodes.to_dict())
+            _dict['barcodes'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ModelsBox from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "packageCode": obj.get("packageCode"),
+            "quantity": obj.get("quantity"),
+            "barcodes": [ModelsGoodInBox.from_dict(_item) for _item in obj["barcodes"]] if obj.get("barcodes") is not None else None
+        })
+        return _obj
+
+