README

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. Контактирајте со Централниот Регистар.

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

<?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"
}

response:

{
  "data": {
    "CrmResultItems": [
      {
        "@attributes": {
          "TemplateName": "CVLEInfo"
        },
        "CrmResultItem": {
          "InfoMessage": "OK",
          "Year": "2022",
          "LEID": "5484561",
          "LEFullName": "Друштво за трговија на големо и мало,услуги и шпедиција МАП Пивара ДООЕЛ Скопје",
          "Place": "СКОПЈЕ - ГАЗИ БАБА",
          "SubProductID": "3",
          "SubProductInfo": "Субјектот нема доставено годишна сметка или нема доставено известување дека нема деловна активност во 2022 година."
        }
      },
      {
        "@attributes": {
          "TemplateName": "AAListingInfo"
        },
        "CrmResultItem": {
          "InfoMessage": "Производот не е достапен за дадените влезни параметри",
          "Year": "2022",
          "LEID": "5484561",
          "OperationID": {},
          "AccountNo": {},
          "AccountName": {},
          "Previous": {},
          "CurrentYear": {}
        }
      }
    ],
    "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": "F7K45hzvyBF3YClWGLbh4R1r4N0="
        }
      },
      "SignatureValue": "",
      "KeyInfo": {
        "X509Data": {
          "X509Certificate": ""
        }
      }
    }
  }
}

kalimeromk / crm

Maintainers

Details

README

Инсталација

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

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

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

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

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

Инсталација

RESFull API Basics #blueprint

API Endpoints and Payloads

1. LEOSSCurrentView

2. AAListing