README

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

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

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

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

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

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

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

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

Конфигурација

<?php

return [

    'CRM' => env('CRM_WSDL_PATH', storage_path('public/wsdl/crm-wsdl.xml')),

    'keys' => [
        'PRIVATE_KEY' => env('CRM_PRIVATE_KEY_PATH', storage_path('keys/private_key.pem')),
        'PUBLIC_CERT' => env('CRM_PUBLIC_CERT_PATH', storage_path('keys/public_cert.pem')),
        'PRODUCT_NAME' => env('CRM_PRODUCT_NAME', 'LEOSSCurrentView'),
        'AA_LISTING' => env('CRM_AA_LISTING', 'AAListing'),
    ],
];

Инсталација

RESFull API Basics #blueprint

This collection provides a set of API endpoints to perform basic CRUD operations. Below are the details about each request, including the URL and payload structure.

API Endpoints and Payloads

1. LEOSSCurrentView

URL: domain/api/v1/leoss-current-view
Method: POST
Description: This endpoint allows you to submit data via the request body. A successful request typically returns a 200 OK or 201 Created response code.
Payload:
```
{
  "number": "5484561"
}
```

response:

{
    "data": {
        "CrmResultItems": [
            {
                "@attributes": {
                    "TemplateName": "CVLEInfo"
                },
                "CrmResultItem": {
                    "InfoMessage": {},
                    "IsLETerminated": "True",
                    "LEID": "5484561",
                    "LEFullName": "Друштво за трговија на големо и мало,услуги и шпедиција МАП Пивара ДООЕЛ Скопје",
                    "TaxPayerNumber": "4030000431924",
                    "ShortName": "МАП Пивара ДООЕЛ Скопје",
                    "TerminationTypeID": "5",
                    "TerminationTypeDesc": "По пат на ликвидација",
                    "TerminationBasis": {},
                    "DateDeletedInCR": "11.09.2007 11:20",
                    "LETypeID": "4",
                    "LETypeDesc": "ДООЕЛ",
                    "LESizeID": "2",
                    "LESizeDesc": "мал",
                    "Municipality": "ГАЗИ БАБА",
                    "MunicipalityCode": "27",
                    "Place": "СКОПЈЕ - ГАЗИ БАБА",
                    "PlaceCode": "491012",
                    "Street": "810",
                    "StreetCode": "49101208100",
                    "HouseNo": "3А",
                    "EntranceNo": {},
                    "FlatNo": {},
                    "OrganisationTypeCode": "05.4",
                    "OrganisationTypeDesc": "друштво со ограничена одговорност основано од едно лице",
                    "AuthorisedRegisterID": "1",
                    "AuthorisedRegister": "Трговски Регистар",
                    "OwnershipTypeID": "4",
                    "OwnershipTypeDesc": "Приватна",
                    "IsForeignAct": "True",
                    "IsActivityNoLicence": "False",
                    "CoreActivityCode": "60.24/0",
                    "CoreActivityDesc": "Превоз на стоки во друмскиот сообраќај",
                    "Licence": {},
                    "ForeignActivity": "Регистрирани дејности во надворешно-трговскиот промет",
                    "Email": {},
                    "AdditionalInfo": "НОВО со РАЗДВОЈУВАЊЕ од 04186583 од 28.12.2000 година\nБРИШЕЊЕ:на субјектот од Трговскиот регистар по спроведена ликвидациона постапка согласно чл.657 од ЗТД(Сл.в.на РМ 28/96)по Решение П.Трег.бр.5504/2002 од 6.12.2002 година од Основен суд Скопје I во Скопје ",
                    "IsDataConfirmed": "True",
                    "IsAAActive": "0",
                    "PKDStatus": {},
                    "ActingPeriod": {},
                    "LEStatus": {},
                    "LEStatusDateFrom": {},
                    "LEStatusDateUntil": {},
                    "CourtRegion": {}
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVUnits"
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVActors"
                },
                "CrmResultItem": {
                    "LEID": "5484561",
                    "UnitNo": "0",
                    "PersonOrLEID": "1",
                    "PersonOrLEDesc": "Физичко лице",
                    "ActorID": "1501947450037",
                    "ActorTypeID": "1",
                    "ActorTypeDesc": "Овластено лице",
                    "ActorName": "РАТКО",
                    "ActorSurname": "ЧАДИКОВСКИ",
                    "CountryCode": "MK",
                    "Country": "МАКЕДОНИЈА",
                    "Municipality": "КИСЕЛА ВОДА",
                    "Place": "СКОПЈЕ",
                    "Street": "БУЛ.ЈАНЕ САНДАНСКИ",
                    "HouseNo": "90",
                    "EntranceNo": "5",
                    "FlatNo": "5",
                    "Email": {},
                    "Description": {},
                    "Restrictions": {},
                    "AuthorisationTypeID": {},
                    "AuthorisationTypeDesc": {},
                    "PKDStatus": {}
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVOwners"
                },
                "CrmResultItem": {
                    "LEID": "5484561",
                    "Note": {},
                    "PersonOrLEID": "2",
                    "PersonOrLEDesc": "правно лице",
                    "OwnerID": "4053974",
                    "OwnerTypeID": "6",
                    "OwnerTypeDesc": "Основач/сопственик",
                    "LiabilityID": "1",
                    "LiabilityDesc": "Не одговара",
                    "OwnerName": "\"ПИВАРА СКОПЈЕ\"",
                    "OwnerSurname": {},
                    "CountryCode": "MK",
                    "Country": "МАКЕДОНИЈА",
                    "Municipality": "ГАЗИ БАБА",
                    "Place": "СКОПЈЕ",
                    "Street": "808",
                    "HouseNo": "12",
                    "EntranceNo": {},
                    "FlatNo": {},
                    "Email": {},
                    "FCCode": "MKD",
                    "ParticipationFC_Cash": {},
                    "ParticipationFC_NonCash": "52332031.00",
                    "ParticipationFC_Payd": {},
                    "ParticipationFC_Total": "52332031.00",
                    "PKDStatus": {}
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVActivities"
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVMembership"
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVFounding"
                },
                "CrmResultItem": {
                    "LEID": "5484561",
                    "FoundingDate": "23.11.2000 00:00",
                    "CapitalOriginID": {},
                    "CapitalOriginDesc": {},
                    "FCCode": "MKD",
                    "CapitalFC_Cash": {},
                    "CapitalFC_NonCash": "52332031.00",
                    "CapitalFC_Payd": {},
                    "SharesTotal": {},
                    "SharesPayd": {},
                    "TypeOfShares": {},
                    "SharesPayment": {},
                    "CapitalFC_Total": "52332031.00"
                }
            },
            {
                "@attributes": {
                    "TemplateName": "CVLECourt"
                }
            }
        ],
        "Signature": {
            "SignedInfo": {
                "CanonicalizationMethod": {
                    "@attributes": {
                        "Algorithm": "http://www.w3.org/TR/2001/REC-xml-c14n-20010315"
                    }
                },
                "SignatureMethod": {
                    "@attributes": {
                        "Algorithm": "http://www.w3.org/2000/09/xmldsig#rsa-sha1"
                    }
                },
                "Reference": {
                    "@attributes": {
                        "URI": ""
                    },
                    "Transforms": {
                        "Transform": {
                            "@attributes": {
                                "Algorithm": "http://www.w3.org/2000/09/xmldsig#enveloped-signature"
                            }
                        }
                    },
                    "DigestMethod": {
                        "@attributes": {
                            "Algorithm": "http://www.w3.org/2000/09/xmldsig#sha1"
                        }
                    },
                    "DigestValue": "94zmfGBPxyEE+Zfpqcf1kJzR7/c="
                }
            },
            "SignatureValue": "",
            "KeyInfo": {
                "X509Data": {
                    "X509Certificate": ""
                }
            }
        }
    }
}

2. AAListing

URL: domain/api/v1/laa-listing
Method: POST
Description: This endpoint allows you to submit data via the request body. A successful request typically returns a 200 OK or 201 Created response code.

Payload:

{
  "number": "5484561",
  "date": "2023"
}