PHPackages                             kalimeromk/crm - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. kalimeromk/crm

ActiveLibrary[API Development](/categories/api)

kalimeromk/crm
==============

The CRM package is designed to enable secure communication between the client and the Central Register, providing access to data on legal entities. The service offers two main products: LEOSSCurrentView and AAListing, which provide access to the entity's current data and annual financial reports, respectively.

v1.0(1y ago)63MITPHPPHP ^8.1|^8.2

Since Nov 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/KalimeroMK/crm)[ Packagist](https://packagist.org/packages/kalimeromk/crm)[ Docs](https://github.com/kalimeromk/crm)[ RSS](/packages/kalimeromk-crm/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

CRM Web Service Package
=======================

[](#crm-web-service-package)

[![CRM Logo](https://raw.githubusercontent.com/KalimeroMK/crm/refs/heads/master/crlogo2mk.png)](https://raw.githubusercontent.com/KalimeroMK/crm/refs/heads/master/crlogo2mk.png)

CRM пакетот е дизајниран за да овозможи безбедна комуникација помеѓу клиентот и Централниот Регистар, овозможувајќи пристап до податоци за правни лица. Сервисот нуди два главни продукти: `LEOSSCurrentView` и `AAListing`, кои овозможуваат пристап до тековни податоци за ентитетот и годишни финансиски извештаи, соодветно.

Инсталација
-----------

[](#инсталација)

```
composer require kalimeromk/crm

```

Автентикација и Сертификација
-----------------------------

[](#автентикација-и-сертификација)

### Барања за Дигитален Сертификат

[](#барања-за-дигитален-сертификат)

- Секое барање кон сервисот мора да содржи **квалификуван дигитален потпис**.
- Сертификатот мора да биде **2048-битен RSA** и издаден од овластени сертификациски тела во Македонија, како што се **КИБС АД Скопје** или **Македонски Телеком**.
- Сертификатот треба да се користи за **автентикација на клиентот**, а јавните клучеви на клиентот и коренските сертификати мора да бидат доставени до Централниот Регистар пред почетокот на размената на податоци.

### Автентикација Базирана на Сертификат

[](#автентикација-базирана-на-сертификат)

- Автентикацијата се врши преку проверка на јавниот клуч на дигиталниот потпис вклучен во секое барање.
- Дигиталниот потпис мора да биде генериран со валиден, признат сертификат, кој мора да се ажурира во случај на било какви промени.
- EOSSCurrentView се користи за да се добијат тековни податоци за правно лице користејќи го неговиот **LEID**(уникатен идентификациски број на ентитетот).
- AAListing се користи за да се добијат годишни финансиски извештаи за правно лице користејќи го неговиот **LEID**(уникатен идентификациски број на ентитетот) и **годината** за која се бараат податоците.

Ракување со Грешки
------------------

[](#ракување-со-грешки)

Веб сервисот враќа различни предефинирани пораки за ракување со грешки. Подолу се наведени некои од најчестите пораки за грешки:

Порака за ГрешкаОпис**Client certificate is not valid!**Сертификатот прикачен на барањето е невалиден.**Error converting client certificate!**Сертификатот не може да се конвертира во X509 формат за валидација.**Authentication failed!**Јавниот клуч не се совпаѓа со регистрираниот клуч на сертификатот.**Request is not valid!**Валидацијата на параметрите во барањето не успеа.**Authorization for the request failed!**Можни причини вклучуваат неактивен клиент или неовластен пристап до продуктот.**Daily transaction limit exceeded!**Надминат е дозволениот број на дневни трансакции.**Request is not digitally signed!**Барањето нема дигитален потпис.**Signature verification failed!**Верификацијата на дигиталниот потпис не успеа.**System error when signing output data!**Се појави проблем при потпишувањето на одговорот во XML. Контактирајте со Централниот Регистар.Конфигурација
-------------

[](#конфигурација)

```