Przejdź do głównej zawartości

Generyczny Profil Księgowy

  • Zaktualizowano

Dodatkowe informacje do funkcji przekazywanych w API

1. Zakładanie firmy

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

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

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

Właściwość na kategorii Typ API XML
Odliczenie VAT

lista do wyboru:

  • pełne odliczenie - 1
  • brak odliczenia - 0
  • częściowe 50% -  2
 VAT_DEDUCTION_RATE

Odliczenie kosztu

liczba całkowita

NKUP_PERCENT

Konto księgowe (kwota brutto)

tekst

BRUTTO_ACCOUNT

Konto księgowe (kwota netto)

tekst

NETTO_ACCOUNT

Konto księgowe (kwota VAT)

tekst

VAT_ACCOUNT

Konto księgowe (kwota NKUP)

tekst

NKUP_ACCOUNT

 

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 -).

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.