Informacje

Uwierzytelnianie	wymagane
Format odpowiedzi	json
Metoda HTTP	POST

POST companies

Ostatnia modyfikacja 2024-04-17 13:18:20

Dodanie firmy do CRM.

URL

https://your-system-name.thulium.com/api/companies

Parametry

name wymagany	Nazwa firmy.
nip opcjonalny	Numer NIP firmy. Jeśli jest podany, ma być unikatowy.
email opcjonalny	Adres e-mail firmy.
phone_number opcjonalny	Numer lub numery telefonu firmy.
type opcjonalny	Tekstowa nazwa typu klienta zdefiniowana w systemie.
group opcjonalny	Tekstowa nazwa grupy klienta zdefiniowana w systemie.
identifier opcjonalny	Identyfikator firmy.
note opcjonalny	Notatka.
custom_fields opcjonalny	Obiekt z wartościami pól specjalnych. Przykładowa wartość: `"custom_fields":{"field_name_1":"value_1","field_name_2":"value_2"}`
fill_read_only_custom_fields opcjonalny	Flaga definiująca czy pola specjalne zostaną wypełnione pomimo posiadania typu READ ONLY. Przykładowa wartość: `true`
account_manager opcjonalny	Login opiekuna firmy
vip opcjonalny	VIP Przykładowa wartość: `true`
address opcjonalny	Adres firmy.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.
invoice_address opcjonalny	Adres do faktur.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.
mail_drop_address opcjonalny	Adres korespondencyjny.
street opcjonalny	Nazwa ulicy.
building opcjonalny	Numer budynku.
flat opcjonalny	Numer mieszkania.
postcode opcjonalny	Kod pocztowy.
city opcjonalny	Miasto.
country opcjonalny	Kraj.

Przykładowy request

POST	`https://your-system-name.thulium.com/api/companies`
Dane	`{"name":"company","nip":"6783144527","address":{"city":"Krakow","street":"Zlotej Jesieni"}}`

Przykładowy response

{
    "company_id": "21",
    "customer_id": "121"
}

Przykładowe wywołanie

PHP


<?php
$data = '{"name":"company","nip":"6783144527","address":{"city":"Krakow","street":"Zlotej Jesieni"}}';

$request = curl_init('https://your-system-name.thulium.com/api/companies');
curl_setopt($request, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json; charset=utf-8',
    'Content-Length: ' . mb_strlen($data)
));
curl_setopt($request, CURLOPT_USERPWD, 'api_user:api_pass');
curl_setopt($request, CURLOPT_TIMEOUT, 30);
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($request, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($request);
if ($response) {
    $httpCode = curl_getinfo($request, CURLINFO_HTTP_CODE);
    if ($httpCode == 200){
        print_r(json_decode($response));
    } else {
        echo $response;
    }
} else {
    trigger_error(curl_error($request), E_USER_WARNING);
}

curl_close($request);

JAVA


public class Example {
    public static void main(String[] args) throws Exception {
        ThuliumRestClient restClient = new ThuliumRestClient("api_user", "api_pass", true);

        ThuliumRestClient.ThuliumRestResponse response = restClient.post("https://your-system-name.thulium.com/api/companies", "{\"name\":\"company\",\"nip\":\"6783144527\",\"address\":{\"city\":\"Krakow\",\"street\":\"Zlotej Jesieni\"}}");
        System.out.println(response);
    }
}

ThuliumRestClient.java (Wymaga biblioteki httpclient w wersji 4.3.5, httpcore w wersji 4.3.2, commons-codec w wersji 1.9, commons-logging w wersji 1.2)

CURL


curl -u api_user:api_pass -k -X POST -H "Content-type: application/json" -d '{"name":"company","nip":"6783144527","address":{"city":"Krakow","street":"Zlotej Jesieni"}}' "https://your-system-name.thulium.com/api/companies"

HTTPie


echo '{"name":"company","nip":"6783144527","address":{"city":"Krakow","street":"Zlotej Jesieni"}}' | http -a api_user:api_pass POST https://your-system-name.thulium.com/api/companies