Companii

---

Documentație API pentru lucrul cu companii

Tabel cu descrierile câmpurilor:

Câmp	Tip	Necesar?	Descriere
id	int	Nu	Identificatorul unic al companiei (necesar la actualizare).
companiecodulproprietar	int	Da	ID de proprietar al companiei. https://admin.ecom.md/ru/admin/users/user/
manager_id	int	Nu	ID manager al companiei. https://admin.ecom.md/ru/admin/users/user/
numele_societății	sfoară	Da	Numele companiei.
vat_rate	zecimal	Nu	cota de TVA.
număr_cuva	sfoară	Nu	Numărul plătitorului de TVA.
adresa_legala	sfoară	Da	Adresa juridică a companiei.
adresa_fizica	sfoară	Nu	Adresa fizică a companiei.
nume_bancă	sfoară	Nu	Numele băncii companiei.
cod_fiscal	sfoară	Nu	Cod fiscal unic al companiei.
cod_banc	sfoară	Nu	Cod bancar.
iban	sfoară	Nu	Contul bancar al companiei (IBAN).
cif	sfoară	Nu	Cod CIF al companiei.
număr_înregistrare	sfoară	Nu	Număr de înregistrare a companiei.
regiune	sfoară	Nu	Regiunea companiei.
localitatea	sfoară	Nu	Localizarea companiei (de exemplu, oraș).
use_vat	boolean	Da	Compania folosește TVA?
limita_credit	zecimal	Nu	Limita de credit al companiei.
sold	zecimal	Nu	Bilanțul companiei.
grupcodid	sfoară	Nu	ID unic al companiei în sistemul clientului

1. Obținerea tuturor companiilor

Metodă: GET
URL: {domeniu}/extern/companie/

Descriere:
Returnează o listă cu toate companiile de pe site.
Un filtru este disponibil până la data ultimei actualizări last_update.

Exemplu de interogare cu un filtru:

GET {domain}/external/company/?last_update=1749798794

Exemplu de răspuns:

[
    {
        „id”: 1,
        „company_owner_id”: 177581,
        „codul_manager”: 177581,
        "company_name": "Test",
        "vat_rate": "55,55",
        "vat_number": "555555",
        "legal_address": "Socoleni 9",
        "physical_address": "",
        "bank_name": "MICB",
        "fiscal_code": "FISCAL_CODE_123",
        "bank_code": "BANK_CODE_123",
        "iban": "QWEWRTYU12345",
        "cif": "20000000000",
        "registration_number": "2900000000",
        "region": "Ciocana",
        „localitate”: „Chișinău”,
        „use_vat”: fals,
        "credit_limit": "555.00",
        "sold": "55555.00"
    }
]

2. Chitanța unei companii

Metodă: GET
URL: {domeniu}/extern/companie/{id}/

Descriere:
Returnează date pentru o companie prin identificatorul său unic.

Exemplu de interogare:

GET {domain}/external/company/1/

Exemplu de răspuns:

{
    „id”: 1,
    „company_owner_id”: 177581,
    „company_owner_id”: 33333,
    "company_name": "Test",
    "vat_rate": "55,55",
    "vat_number": "555555",
    "legal_address": "Socoleni 9",
    "physical_address": "",
    "bank_name": "MICB",
    "fiscal_code": "FISCAL_CODE_123",
    "bank_code": "BANK_CODE_123",
    "iban": "QWEWRTYU12345",
    "cif": "20000000000",
    "registration_number": "2900000000",
    "region": "Ciocana",
    „localitate”: „Chișinău”,
    „use_vat”: fals,
    "credit_limit": "555.00",
    "sold": "55555.00"
}

3. Crearea mai multor companii

Metodă: POST
URL: {domain}/external/company/bulk-create/

Descriere:
Creează mai multe companii în același timp.

Exemplu de interogare:

POST {domain}/external/company/bulk-create/
Tip de conținut: application/json

Corpul cererii:

[
    {
        „company_owner_id”: 177582,
        "company_name": "Companie nouă 1",
        "vat_rate": "50,00",
        "vat_number": "123456",
        "legal_address": "Str. Test 1",
        "physical_address": "Str. Test 1",
        "bank_name": "BANCA_1",
        "fiscal_code": "CODE_123",
        "bank_code": "BANK_CODE_1",
        "iban": "IBAN_1",
        "cif": "CIF_123",
        „registration_number”: „REG_1”,
        "region": "Buiucani",
        „localitate”: „Chișinău”,
        „use_vat”: adevărat,
        "credit_limit": "2000.00",
        „sold”: „100000.00”
    },
    {
        „company_owner_id”: 177583,

"companyname": "Companie nouă 2", "vatrate": "60.00", "vatnumber": "654321", "legaladdress": "Str. Test 2", "physicaladdress": "Str. Test 2", "bankname": "BANCA2", "fiscalcode": "CODE456", "bankcode": "BANKCODE2", "iban": "IBAN2", "cif": "CIF456", „registrationnumber”: „REG2”, "region": "Botanica", „localitate”: „Chișinău”, „usevat”: fals, "creditlimit": "3000.00", "sold": "200000.00" } ]

Exemplu de răspuns:

[
    {
        „id”: 2,
        „company_owner_id”: 177582,
        "company_name": "Companie nouă 1",
        "vat_rate": "50,00",
        "vat_number": "123456",
        "legal_address": "Str. Test 1",
        "physical_address": "Str. Test 1",
        "bank_name": "BANCA_1",
        "fiscal_code": "CODE_123",
        "bank_code": "BANK_CODE_1",
        "iban": "IBAN_1",
        "cif": "CIF_123",
        „registration_number”: „REG_1”,
        "region": "Buiucani",
        „localitate”: „Chișinău”,
        „use_vat”: adevărat,
        "credit_limit": "2000.00",
        „sold”: „100000.00”
    },
    {
        „id”: 3,
        „company_owner_id”: 177583,
        "company_name": "Companie nouă 2",
        "vat_rate": "60.00",
        "vat_number": "654321",
        "legal_address": "Str. Test 2",
        "physical_address": "Str. Test 2",
        "bank_name": "BANCA_2",
        "fiscal_code": "CODE_456",
        "bank_code": "BANK_CODE_2",
        "iban": "IBAN_2",
        "cif": "CIF_456",
        „registration_number”: „REG_2”,
        "region": "Botanica",
        „localitate”: „Chișinău”,
        „use_vat”: fals,
        "credit_limit": "3000.00",
        "sold": "200000.00"
    }
]

4. Actualizare pentru mai multe companii

Metodă: PUT
URL: {domeniu}/external/company/bulk-update/

Descriere:
Actualizează datele pentru mai multe companii simultan.

Exemplu de interogare:

PUT {domain}/external/company/bulk-update/
Tip de conținut: application/json

Corpul cererii:

[
    {
        „id”: 1,
        "company_name": "Compania 1 actualizată",
        "credit_limit": "7000.00",
        "sold": "150000.00"
    },
    {
        „id”: 2,
        "company_name": "Compania 2 actualizată",
        "credit_limit": "5000.20",
        "sold": "220000.00"
    }
]

Exemplu de răspuns:

[
    {
        „id”: 1,
        "company_name": "Compania 1 actualizată",
        "credit_limit": "7000.00",
        "sold": "150000.00"
    },
    {
        „id”: 2,
        "company_name": "Compania 2 actualizată",
        "credit_limit": "5000.20",
        "sold": "220000.00"
    }
]

---

A fost util articolul?

Da, multumesc! Din pacate nu