API - Account - Companies¶

Companies list¶

URL: /account/companies/
Method: GET

Code sample:¶

$api_id = 1;
$api_key = 'testpass';
$hostname = 'https://example.com'; // no trailing slash

# fetch data
$url = '/account/companies/';
$post_data = array();
$user_token = 'xxx'; // is required here. Get it from Your DB after Token generation
$extra_headers = array(
    'X-API-ID: ' . $api_id,
    'X-API-Hash: ' . md5($api_key . $url. http_build_query($post_data)),
    'X-User-Token: ' . $user_token
);

header('Content-Type: application/json; charset=utf-8');
echo sendRequest($hostname . $url, $post_data, $extra_headers);

Succes message:

{
    has_error: false,
    messages: [ ],
    results: {
        12345: {},
        56789: {}
    }
}

Company details¶

URL: /api/account/companies/?company_id=1234
Method: GET

Code sample:¶

# fetch data
$url = '/api/account/companies/?company_id=1234';
$post_data = array();

Succes message:

{
    has_error: false,
    messages: [ ],
    results: {}
}

Company edit/add¶

URL: /api/account/companies/
Method: POST

Code sample:¶

# fetch data
$url = '/api/account/companies/';
$post_data = array(
    'current_company' => 1234,
    'type' => 'company',
    'name' => 'ACME Company LTD',
    'code_letters' => 'ro',
    'code_numbers' => '12345678',
    'reg_number' => 'J40/1234/2010',
    'bank' => 'Some Bank',
    'bankaccount' => 'a-valid-IBAN',
    'contact_name' => 'John Doe',
    'address' => 'Sesame Street',
    'country' => 181,
    'state' => 9,
    'city' => 13820,
    'zipcode' => '012345',
    'telephone' => '0123456789',
    'fax' => '',
    'financial_email' => ''
);

Succes message: request_message contains the company ID

{
    has_error: false,
    messages: [ ],
    results: {
        request_status: "ok",
        request_message: "1234" 
    }
}

Error message:

{
    has_error: true,
    messages: {
        reg_number: "Numarul de inregistrare la Registrul Comertului este incorect" 
    },
    results: [ ]
}

Company delete¶

URL: /account/companies/?deletecompany=1234
Method: GET

Code sample:¶

# fetch data
$url = '/account/companies/?deletecompany=1234';
$post_data = array();

Succes message: request_message contains the company ID

{
    has_error: false,
    messages: [ ],
    results: {
        request_status: "ok",
        request_message: "1234" 
    }
}

Error message:

{
    has_error: true,
    messages: [
        "Invalid company" 
    ],
    results: [ ]
}