Akcja „Utwórz fakturę”
Tworzy nową fakturę w Autofaktury z danymi dostawcy, pozycjami, walutą i płatnością. Użyj wzorca numeracji skonfigurowanego w Ustawieniach lub podaj własny tytuł.
Kiedy używać tej akcji
Gdy chcesz automatycznie generować faktury w Autofaktury z innych aplikacji (np. formularze, zamówienia, zadania cykliczne) i mapować dane wyzwalacza do pól faktury.
Dobre praktyki
- Mapuj pola dokładnie wg nazw i formatów z referencji (daty
YYYY-MM-DD, waluta – 3 litery). - Podaj tylko jedno z:
Invoice Pattern ID(z Ustawień) lub własneTitle. - Kwoty zapisuj z kropką jako separatorem dziesiętnym (np.
100.00); VAT jest liczbą całkowitą (0,5,8,23). - Jeśli
Payment Type=TRANSFER, podaj poprawnyRequested Account Number(same cyfry). - Gdy używasz nowego dostawcy (bez
Id), uzupełnij wymagane pola: Name, NIP, City, Postal Code, Number, Country Code.
Pola konfiguracyjne konta
| Pole | Wymagane | Opis |
|---|---|---|
| Client API ID | Tak | Aby uzyskać identyfikator, napisz na [email protected] i podaj NIP |
| Invoice Type | Tak | Dozwolone: VAT, PRO_FORMA |
| Invoice Pattern ID | Nie | Predefiniowany schemat numeracji. Gdy podany, pole Title jest ignorowane. |
Pola wymagane
| Pole | Typ | Opis | Przykład |
|---|---|---|---|
| Main Language | String | Język faktury | PL, EN |
| Invoice Type | String | Typ faktury | VAT, PRO_FORMA, CORRECTION |
| Invoice Date | Date | Data wystawienia (YYYY-MM-DD) | 2024-01-15 |
| Sell Date | Date | Data sprzedaży/wykonania usługi (YYYY-MM-DD) | 2024-01-15 |
| Created By | String | Nazwa na fakturze (1-64 znaki) | IT Corp |
| Invoice City | String | Miasto na fakturze (1-128 znaków) | Warsaw |
| Supplier | Object | Dane dostawcy | patrz Struktura dostawcy |
| Line Items | Array | Pozycje (min. jedna) | patrz Struktura pozycji |
| Currency | String | Kod waluty (3 znaki) | PLN, EUR, USD |
| Payment Status | String | Status płatności | TO_PAID, IN_PAYMENT, PAID, NOT_PAYABLE, NEW |
| Payment Date | Date | Termin płatności (YYYY-MM-DD) | 2024-02-15 |
| Payment Type | String | Metoda płatności | CASH, TRANSFER, CARD, CREDIT_CARD, ONLINE |
Pola opcjonalne
| Pole | Typ | Opis | Przykład |
|---|---|---|---|
| Second Language | String | Drugi język faktury | PL, EN |
| Title | String | Tytuł/numer własny (1-254 znaki) | INV/13/09/2025 |
| Comments | String | Dodatkowe uwagi (0-255 znaków) | Payment within 14 days |
| Requested Account Number | String | Numer rachunku do przelewów | 12345678901234567890123456 |
Struktura dostawcy
| Pole | Wym. | Typ | Opis | Przykład |
|---|---|---|---|---|
| Id | Nie | String | ID istniejącego dostawcy (1-64) | supplier_123 |
| Supplier Firstname | Nie | String | Imię (0-64) | John |
| Supplier Name | Tak* | String | Nazwa firmy/osoby (1-255) | IT Corporation |
| NIP | Tak* | String | Numer NIP (1-20) | 1234567890 |
| City | Tak* | String | Miasto (1-128) | Warsaw |
| Street | Nie | String | Ulica (0-128) | Main Street |
| Postal Code | Tak* | String | Kod pocztowy (1-64) | 00-001 |
| Number | Tak* | String | Numer (1-64) | 123 |
| Country Code | Tak* | String | Kod kraju ISO (2) | PL |
| Business | Nie | Boolean | Czy firma | true, false |
| Nie | String | E-mail (0-255) | [email protected] | |
| Phone | Nie | String | Telefon (0-64) | +48123456789 |
| Update Supplier By Nip | Nie | Boolean | Aktualizuj istniejącego dostawcę po NIP | true, false |
*Wymagane, jeśli Id nie jest podane
Struktura pozycji
Każda pozycja musi zawierać:
| Pole | Wym. | Typ | Opis | Przykład |
|---|---|---|---|---|
| Name | Tak | String | Nazwa produktu/usługi (1-1000) | Web Development |
| Unit | Tak | String | Jednostka (1-64) | h, szt, kg, m2 |
| Quantity | Tak | Decimal | Ilość (dodatnia, 2 miejsca) | 10.00, 1.50 |
| Unit Price Netto | Tak | Decimal | Cena netto (dodatnia, 2 miejsca) | 100.00, 25.50 |
| VAT | Tak | Integer | Stawka VAT (0 lub dodatnia) | 0, 5, 8, 23 |
| Discount Value | Nie | Decimal | Rabat kwotowy (dodatnia, 2 miejsca) | 50.00, 10.25 |
| Discount Percentage | Nie | Decimal | Rabat procentowy (dodatnia, 2 miejsca) | 10.00, 15.50 |
Wymagania płatności
Przelew
Gdy Payment Type = TRANSFER, wymagane jest podanie:
- Requested Account Number: Numer rachunku bankowego (wyłącznie cyfry, IBAN zostanie znormalizowany)
Zasady biznesowe
- Podaj dokładnie JEDNO z:
Invoice Pattern ID(z konfiguracji konta) LUB- własne pole
Title
- Kwoty – liczby dziesiętne z 2 miejscami po przecinku (np.
100.00) - Daty – format
YYYY-MM-DD - VAT – wartości całkowite (np.
23, nie"23%") - Waluta – dokładnie 3 znaki
- Jeśli podasz
Iddostawcy, pozostałe pola dostawcy są ignorowane - Tablica pozycji nie może być pusta
- Ilości i ceny muszą być dodatnie