n8n-nodes-erpxt

Node n8n do integracji z Comarch ERP XT (Betterfly).

Funkcjonalności

Faktury

• Utwórz - tworzenie nowej faktury sprzedaży
• Pobierz - pobranie faktury po ID
• Pobierz wszystkie - pobranie listy faktur (z opcjonalnym filtrem po numerze)
• Aktualizuj - aktualizacja istniejącej faktury
• Zatwierdź - zatwierdzenie faktury
• Usuń - usunięcie faktury

Instalacja

# W katalogu ~/.n8n/custom
npm install n8n-nodes-erpxt

# Lub globalnie
npm install -g n8n-nodes-erpxt

Konfiguracja

1. W Comarch ERP XT przejdź do: Moje konto → Zarządzaj kontem
2. Wygeneruj Client ID i Client Secret
3. W n8n dodaj credentials typu ERP XT API i wprowadź wygenerowane dane

Wymagane pola przy tworzeniu faktury

• ID Nabywcy (PurchasingPartyId) - identyfikator kontrahenta
• ID Formy Płatności (PaymentTypeId) - identyfikator formy płatności

Struktura pozycji faktury

Każda pozycja wymaga:

• ProductId - identyfikator produktu
• Quantity - ilość
• ProductCurrencyPrice - cena jednostkowa

Opcjonalnie:

• ProductDescription - opis produktu
• VatRateId - stawka VAT (wymagane dla OSS)

Przykład użycia

Tworzenie faktury

{
  "PurchasingPartyId": "123",
  "PaymentTypeId": "1",
  "InvoiceType": 0,
  "Items": [
    {
      "ProductId": "456",
      "Quantity": 2,
      "ProductCurrencyPrice": 100.00
    }
  ]
}

Dokumentacja API

• Uwierzytelnianie
• Faktury sprzedaży