{"id":33970789,"url":"https://github.com/serj1chen/nova-poshta-sdk-php","last_synced_at":"2026-04-08T13:31:20.109Z","repository":{"id":26592110,"uuid":"30046837","full_name":"serj1chen/nova-poshta-sdk-php","owner":"serj1chen","description":null,"archived":false,"fork":false,"pushed_at":"2022-04-22T12:46:13.000Z","size":162,"stargazers_count":50,"open_issues_count":2,"forks_count":23,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-12-14T13:27:05.582Z","etag":null,"topics":["api-sdk","php"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/serj1chen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-29T23:37:37.000Z","updated_at":"2025-12-08T14:51:24.000Z","dependencies_parsed_at":"2022-09-01T19:21:49.080Z","dependency_job_id":null,"html_url":"https://github.com/serj1chen/nova-poshta-sdk-php","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/serj1chen/nova-poshta-sdk-php","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serj1chen%2Fnova-poshta-sdk-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serj1chen%2Fnova-poshta-sdk-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serj1chen%2Fnova-poshta-sdk-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serj1chen%2Fnova-poshta-sdk-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serj1chen","download_url":"https://codeload.github.com/serj1chen/nova-poshta-sdk-php/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serj1chen%2Fnova-poshta-sdk-php/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31558380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-sdk","php"],"created_at":"2025-12-13T00:39:34.996Z","updated_at":"2026-04-08T13:31:20.101Z","avatar_url":"https://github.com/serj1chen.png","language":"PHP","readme":"# Новая Почта. SDK для личного кабинета API 2\n\n[Статья на habrahabr]\n\nДля быстрого оформления большого количества отправлений используется способ электронного обмена данными между\nинформационной системой компании «Новая Почта» и программным комплексом Партнера/Клиента. Обмен данными\nосуществляется путем передачи информации через программную среду АРІ.\n\nДля начала работы с функционалом АРІ компании «Новая Почта» необходимо создать ключ на странице настройки в личном\nкабинете my.novaposhta.ua. Ключ АРІ обязательно включается в каждый запрос.\nВажно! Все создаваемые ключи ограничены во времени действия, настоятельно рекомендуется учитывать данное ограничение.\n\nSDK разработана по официальной документации. За более детальной информацией по описанию моделей и методов обращайтесь\nна страницу официальной документации API 2 личного кабинета: [Новой Почты]. SDK не является официальным SDK Новой\nПочты, я его разработал в личных целях.\n\n## Подключить SDK\n\n### Способ 1 (composer)\n\nСамый простой способ установить SDK через composer.\n\nСоздайте файл `composer.json` в корне Вашего проекта:\n \n      {\n          \"require\": {\n              \"serj1chen/nova-poshta-sdk-php\": \"2.0.*\"\n          }\n      }\n\nУстановить composer:\n\n      $ curl -sS https://getcomposer.org/installer | php\n      $ php composer.phar install\n\nПодключить автолоадер composer:\n\n      include_once \"vendor/autoload.php\";\n      \n      \n### Способ 2 (git)\n\nКлонировать репозиторий\n\n      git clone git://github.com/serj1chen/nova-poshta-sdk-php\n      \nПодключить автолоадер SDK:\n\n      include_once \"nova-poshta-sdk-php/lib/NovaPoshta/bootstrap.php\";\n\n## Структура SDK\n\n### Настройка файла конфигурации ([Config])\nПеред тем как начать работать с API, нужно настроить файл конфигурации:\n\n       Use NovaPoshta\\Config;\n       \n       Config::setApiKey('\u003cВаш ключ\u003e');\n       Config::setFormat(Config::FORMAT_JSONRPC2);\n       Config::setLanguage(Config::LANGUAGE_UA);\n      \nПример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Config_example.php]\n\nВозможные форматы передачи данных (формат указывать  в метод setFormat):\n\n- FORMAT_JSON\n- FORMAT_JSONRPC2 (рекомендую)\n- FORMAT_XML\n\n### Работа с моделями SDK ([ApiModels])\n\nВсе модели лежат в папке [ApiModels].\n\nМодели:\n\n- Address: Модель для работы с адресами. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Address_example.php]\n- Common: Модель для работы со справочниками. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Common_example.php]\n- ContactPerson: Модель для создания контактного лица. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ContactPerson_example.php]\n- Counterparty: Модель для работы с данными контрагента. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Counterparty_example.php]\n- InternetDocument: Модель для оформления отправлений. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/InternetDocument_example.php]\n- ScanSheet: Модель для работы с реестрами приема-передачи отправлений. Пример: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ScanSheet_example.php]\n\nВ классах моделей описаны все методы в комментариях.\n\n### Работа с методами моделей\n\n\u003cb\u003eРабота с методами модели: save, update, delete.\u003c/b\u003e Заполнить модель нужными значениями и вызвать нужный метод. Пример:\n\n      use NovaPoshta\\ApiModels\\Counterparty;\n      \n      $counterparty = new Counterparty();\n      $counterparty-\u003esetCounterpartyProperty('Recipient');\n      $counterparty-\u003esetCityRef('db5c88d0-391c-11dd-90d9-001a92567626');\n      $counterparty-\u003esetCounterpartyType('PrivatePerson');\n      $counterparty-\u003esetFirstName('Пилипко');\n      $counterparty-\u003esetLastName('Вася');\n      $counterparty-\u003esetMiddleName('Сергеевич');\n      $counterparty-\u003esetPhone('+380661122333');\n      $counterparty-\u003esetEmail('test@i.ua');\n      \n      $result = $counterparty-\u003esave();\n\n\u003cb\u003eРабота с статическими методами.\u003c/b\u003e В методы передавать объект MethodParameters:\n\n      use NovaPoshta\\ApiModels\\Counterparty;\n      use NovaPoshta\\MethodParameters\\MethodParameters;\n      \n      $data = new MethodParameters();\n      $data-\u003eCounterpartyProperty = 'Recipient';\n      $data-\u003ePage = 1;\n      $data-\u003eCityRef = '8d5a980d-391c-11dd-90d9-001a92567626';\n      $data-\u003eFindByString = 'Петр';\n   \n      $result = Counterparty::getCounterparties($data);\n  \nИли можно использовать классы [MethodParameters], которые наследуются от класса MethodParameters.\nКлассы имеют сеттеры параметров, которые можно передать статическому методу модели. Названия классов с параметрами \nскладываются с двух частей, с названия модели ([ApiModels]) и названия статического метода модели. Пример использования:\n\n      use NovaPoshta\\ApiModels\\Counterparty;\n      use NovaPoshta\\MethodParameters\\MethodParameters;\n      use NovaPoshta\\MethodParameters\\Counterparty_getCounterparties;\n      \n      $data = new Counterparty_getCounterparties();\n      $data-\u003esetCounterpartyProperty('Recipient');\n      $data-\u003esetPage(1);\n      $data-\u003esetCityRef('8d5a980d-391c-11dd-90d9-001a92567626');\n      $data-\u003esetFindByString('Петр');\n   \n      $result = Counterparty::getCounterparties($data);\n\n### Модели хелперы для работы с моделями ([Models])\n\nДанные классы нужны для заполнения моделей ([ApiModels])\n\n### Логирования ([Logger])\n\nЕсли Вам нужно логировать данные отправки/получения запросов. Нужно создать класс который наследуется от [Logger.php]\nи передать экземпляр этого класса в метод setClassLogger файла [Config.php].\n\n      use NovaPoshta\\Config;\n      \n      Config::setClassLogger(new Logger_example());  \n\nПример класса логирования: [https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Logger_example.php].\n(Соответственно у Вас будут данные куда-то записываться)\n\nМетод \u003cb\u003esetOriginalData\u003c/b\u003e: запрос/ответ API Новой Почты.\nПараметры: toData - запрос (тип: string); fromData - ответ (тип: string).\n\nМетод \u003cb\u003esetData\u003c/b\u003e: запрос/ответ API Новой Почты у формате SDK.\nПараметры: toData - запрос (объект: [DataContainer]); fromData - ответ (объект: [DataContainerResponse]).\n\n\n\n** SDK не является официальным SDK Новой Почты\n\n\nLicense\n----\n\nMIT\n\n\n\n\n\n[Статья на habrahabr]:https://habrahabr.ru/post/264209/\n[Новой Почты]:https://my.novaposhta.ua\n[ApiModels]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/tree/master/lib/NovaPoshta/ApiModels\n[MethodParameters]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/tree/master/lib/NovaPoshta/MethodParameters\n[Config]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Config.php\n[Config.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Config.php\n[Models]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/tree/master/lib/NovaPoshta/Models\n[Logger]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Logger.php\n[Logger.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Logger.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Config_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Config_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Logger_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Logger_example.php\n[DataContainer]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Models/DataContainer.php\n[DataContainerResponse]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/lib/NovaPoshta/Models/DataContainerResponse.php\n\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/InternetDocument_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/InternetDocument_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Address_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Address_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Common_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Common_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ContactPerson_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ContactPerson_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Counterparty_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/Counterparty_example.php\n[https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ScanSheet_example.php]:https://github.com/serj1chen/NovaPoshta-SDK-PHP/blob/master/example/ScanSheet_example.php\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserj1chen%2Fnova-poshta-sdk-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserj1chen%2Fnova-poshta-sdk-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserj1chen%2Fnova-poshta-sdk-php/lists"}