Dodatkowe informacje do funkcji przekazywanych w API

1. Ustawianie programu księgowego Generic Profile na firmie po API

Aby założona firma miała prawidłowo ustawiony profil księgowy, należy w węźle 

<ROOT><METAINF><PRODUCER>

w XML przekazywanym jako parametr command umieścić nazwę techniczną tego profilu tj.:

GENERIC_PROFILE_V1

Poniżej przykładowy XML przekazywany w parametrze command:

<ROOT>

<METAINF>

<PRODUCER>GENERIC_PROFILE_V1</PRODUCER>

</METAINF>

<COMPANIES>

<COMPANY>

<COMPANY_PROGRAM_ID>FINKA-XYZ-12893721789321TEST</COMPANY_PROGRAM_ID>

<USERNAME>ps-gpk</USERNAME>

<EMAIL>no-reply@saldeosmart.pl</EMAIL>

<SHORT_NAME>GPK</SHORT_NAME>

<FULL_NAME>Brainshare - GPK</FULL_NAME>

<VAT_NUMBER>5130231812</VAT_NUMBER>

<CITY>Kraków</CITY>

<POSTCODE>00-000</POSTCODE>

<STREET>-</STREET>

</COMPANY>

</COMPANIES>

</ROOT>

2. Synchronizacja kontrahentów po API

Możliwe jest przekazanie unikalnego identyfikatora z programu księgowego. Może to być przykładowo jego numer z analityki kont lub jakikolwiek inny GUID (WYMÓG UNIKALNY) stosowany w programie FK. Przykładowy request zawierający przykładowego kontrahenta znajduje się poniżej. Warto zwrócić uwagę na następujące węzły:

1. CONTRACTOR_PROGRAM_ID - unikalny identyfikator kontrahenta w obrębie programu FK, może to być jakiś nadany ID, analityka konta, czy też nazwa skrócona.
2. AREA - określa typ kontrahenta dopuszczalne wartości:
1. COUNTRY - krajowy
2. EU - unijny
3. NON_EU - poza unijny
4. EU_3 - unijna trójstronna
5. NO_VAT - bez VAT
6. NON_EU_TRAVEL - pozaunijny podróżny
7. REVERSE_CHARGE - podatnik jest nabywcą
3. INACTIVE - kontrahent aktywny/nieaktywny - przy późniejszej aktualizacji.

<ROOT>

<CONTRACTORS>

<CONTRACTOR>

<CONTRACTOR_PROGRAM_ID>1</CONTRACTOR_PROGRAM_ID>

<SHORT_NAME>ORLEN</SHORT_NAME>

<FULL_NAME>POLSKI KONCERN NAFTOWY ORLEN S.A.</FULL_NAME>

<VAT_NUMBER>7740001454</VAT_NUMBER>

<CITY>Płock</CITY>

<POSTCODE>09-411</POSTCODE>

<STREET>ul. Chemików 7</STREET>

<COUNTRY_ISO3166A2>PL</COUNTRY_ISO3166A2>

<PROGRAM_PARAMETERS>

<AREA>COUNTRY</AREA>

</PROGRAM_PARAMETERS>

<INACTIVE>FALSE</INACTIVE>

</CONTRACTOR>

</CONTRACTORS>

</ROOT>

3. Synchronizacja kategorii po API

Możliwe jest ustawienie i przekazanie do XML następujących właściwości:

Przykładowy XML, do funkcji synchronizacji kategorii:

<ROOT>

<CATEGORIES>

    <CATEGORY>

        <CATEGORY_PROGRAM_ID>1111</CATEGORY_PROGRAM_ID>

        <NAME>apiowa1</NAME>

        <DESCRIPTION>Kategria z api3</DESCRIPTION>

        <PROGRAM_PARAMETERS>

            <VAT_DEDUCTION_RATE>50</VAT_DEDUCTION_RATE>

            <NKUP_PERCENT>70</NKUP_PERCENT>

            <BRUTTO_ACCOUNT>brutto</BRUTTO_ACCOUNT>

            <NETTO_ACCOUNT>netto</NETTO_ACCOUNT>

            <VAT_ACCOUNT>vat</VAT_ACCOUNT>

            <NKUP_ACCOUNT>nkup</NKUP_ACCOUNT>

        </PROGRAM_PARAMETERS>

    </CATEGORY>

</CATEGORIES>

</ROOT>

Dla wszystkich pól typu “konto księgowe”  możliwe jest jego budowanie przy użyciu kilku wymiarów tj., gdy zdefiniujemy (czy też zsynchronizujemy przez API) przykładowe wymiary o nazwach [WYMIAR_1] oraz [WYMIAR_2] możemy na kategorii w polach kont księgowych wpisać:

[WYMIAR_1]-[WYMIAR_2]

Wracając do dokumentu, gdy zostanie wybrany ten wymiar i jednocześnie wartości dla tych wymiarów do pliku XML zostanie przekazany złączony ciąg wartości tych obydwu wartości wymiarów (rozdzielony znakiem -).