dokumentacja

API Fakturowni

Zintegruj Fakturownię z własnym systemem: wystawiaj faktury, paragony i dokumenty magazynowe, zarządzaj klientami, produktami i płatnościami. Poniżej znajdziesz gotowe wywołania, które wystarczy wkleić do terminala i podmienić adres konta oraz token.

Sprawdź za darmo Pełna dokumentacja na GitHubie

Zanim zaczniesz

Wszystkie przykłady pokazujemy w cURL, bo łatwo je przełożyć na dowolny język programowania. Każde wywołanie działa w dwóch formatach: JSON i XML - wystarczy zmienić rozszerzenie w adresie.

W adresach podmień YOUR_DOMAIN na prefiks swojego konta, a API_TOKEN na token wygenerowany w aplikacji. Wywołania działają wyłącznie po HTTPS.

Pełna dokumentacja, z kompletem parametrów i przykładami w kilku językach, jest na github.com/fakturownia/api. Brakuje wywołania, którego potrzebujesz? Napisz na wsparcie@fakturownia.pl - postaramy się je dodać.

Token API

Token wygenerujesz w aplikacji: Ustawienia → Ustawienia konta → Integracja → Kod autoryzacyjny API. Token daje dostęp do danych konta, więc traktuj go jak hasło: nie wysyłaj mailem, nie wrzucaj do repozytorium i nie publikuj w kodzie strony.

Token przekazuj w nagłówku Authorization:

Nagłówek
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.json" \
  -H "Authorization: Bearer API_TOKEN"
Starsza forma, czyli token w adresie (?api_token=API_TOKEN), nadal działa, ale jej nie zalecamy: adres z tokenem zapisuje się w logach serwera, w historii przeglądarki i w nagłówku Referer. Jeśli używasz jej w swojej integracji, przenieś token do nagłówka i wygeneruj nowy.

Faktury

Pobranie wszystkich faktur z danego okresu

pobranie faktur z aktualnego miesiąca:

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.json?period=this_month&page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.xml?period=this_month&page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"

można przekazywać takie same parametry jakie są przekazywane w aplikacji (na stronie listy faktur), np. "income=no" dla wydatków

Pobranie wybranej faktury po ID

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices/100.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Pobieranie faktury w PDF

PDF
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices/100.pdf" \
  -H "Authorization: Bearer API_TOKEN"

Wysłanie faktury do klienta e-mailem

JSON
curl -X POST "https://YOUR_DOMAIN.fakturownia.pl/invoices/100/send_by_email.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl -X POST "https://YOUR_DOMAIN.fakturownia.pl/invoices/100/send_by_email.xml" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie faktury po Id zamówienia

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.json?oid=nr_zam" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.xml?oid=nr_zam" \
  -H "Authorization: Bearer API_TOKEN"

Pobieranie faktur, na podstawie których został wygenerowany dokument o podanym Id

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.json?invoice_id=id" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.xml?invoice_id=id" \
  -H "Authorization: Bearer API_TOKEN"

Pobieranie faktur, które zostały wygenerowane na podstawie dokumentu o podanym Id

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.json?from_invoice_id=id" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/invoices.xml?from_invoice_id=id" \
  -H "Authorization: Bearer API_TOKEN"

Dodanie nowej faktury

JSON (zalecany)
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "kind": "vat",
      "number": null,
      "sell_date": "2026-10-19",
      "issue_date": "2026-10-19",
      "payment_to": "2026-10-26",
      "seller_name": "Seller SA",
      "seller_tax_no": "6272616681",
      "buyer_name": "Client1 SA",
      "buyer_tax_no": "6272616681",
      "positions": [
        {
          "name": "Produkt A1",
          "tax": 23,
          "total_price_gross": 10.23,
          "quantity": 1
        },
        {
          "name": "Produkt A2",
          "tax": 0,
          "total_price_gross": 50,
          "quantity": 2
        }
      ]
    }
  }'

Z danymi domyślnego działu

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "kind": "vat",
      "number": null,
      "sell_date": "2026-10-19",
      "issue_date": "2026-10-19",
      "payment_to": "2026-10-26",
      "buyer_name": "Client1 SA",
      "buyer_tax_no": "6272616681",
      "positions": [
        {
          "name": "Produkt A1",
          "tax": 23,
          "total_price_gross": 10.23,
          "quantity": 1
        },
        {
          "name": "Produkt A2",
          "tax": 0,
          "total_price_gross": 50,
          "quantity": 2
        }
      ]
    }
  }'
XML
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.xml \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/xml' \
  -H 'Content-Type: application/xml' \
  -d '<invoice>
    <kind>vat</kind>
    <sell_date>2026-10-19</sell_date>
    <issue_date>2026-10-19</issue_date>
    <payment_to>2026-10-26</payment_to>
    <seller_name>Seller SA</seller_name>
    <seller_tax_no>6272616681</seller_tax_no>
    <buyer_name>Client1 SA</buyer_name>
    <buyer_tax_no>6272616681</buyer_tax_no>
    <positions>
      <position>
        <name>Produkt X1</name>
        <tax>23</tax>
        <total_price_gross>20</total_price_gross>
        <quantity>1</quantity>
      </position>
      <position>
        <name>Produkt X2</name>
        <tax>0</tax>
        <total_price_gross>10</total_price_gross>
        <quantity>3</quantity>
      </position>
    </positions>
</invoice>'
Przykład w Ruby
endpoint = 'https://YOUR_DOMAIN.fakturownia.pl/invoices.json'
uri = URI.parse(endpoint)

json_params = {
"invoice" => {
  "kind" =>"vat",
  "number" => nil,
  "sell_date" => "2026-10-19",
  "issue_date" => "2026-10-19",
  "payment_to" => "2026-10-26",
  "buyer_name" => "Client1 SA",
  "buyer_tax_no" => "6272616681",
  "positions" =>[
    {"name" =>"Produkt A1", "tax" =>23, "total_price_gross" =>10.23, "quantity" =>1},
    {"name" =>"Produkt A2", "tax" =>0, "total_price_gross" =>50, "quantity" =>2}
  ]
}}

request = Net::HTTP::Post.new(uri.path)
request.body = JSON.generate(json_params)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer API_TOKEN"

http = Net::HTTP.new(uri.host, uri.port)
response = http.start {|h| h.request(request)}

if response.code == '201'
  ret = JSON.parse(response.body)
else
  ret = response.body
end

puts ret.to_json
Javascript / Ajax jQuery
json_params = {
"invoice": {
  "kind":"vat",
  "number": null,
  "sell_date": "2026-10-19",
  "issue_date": "2026-10-19",
  "payment_to": "2026-10-26",
  "buyer_name": "Client1 SA",
  "buyer_tax_no": "6272616681",
  "positions":[
    {"name":"Produkt A1", "tax":23, "total_price_gross":10.23, "quantity":1},
    {"name":"Produkt A2", "tax":0, "total_price_gross":50, "quantity":2}
  ]
}}
//alert(JSON.stringify(json_params))
endpoint = 'https://YOUR_DOMAIN.fakturownia.pl/invoices.json'

$.ajax({
  type: "POST",
  headers: { "Authorization": "Bearer API_TOKEN" },
  url: endpoint,
  data: json_params,
  dataType: 'json',
  success: function(data) { alert('invoice created! ' + data['number'])},
});

Dodanie faktury z rabatem procentowym

UWAGA: przed wywołaniem należy sprawdzić czy w Ustawieniach Konta pole: 'Jak obliczać rabat' ustawione jest na 'procentowo od ceny jednostkowej netto'
JSON
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "kind": "vat",
      "number": null,
      "sell_date": "2026-10-19",
      "issue_date": "2026-10-19",
      "payment_to": "2026-10-26",
      "seller_name": "Seller SA",
      "seller_tax_no": "6272616681",
      "buyer_name": "Client1 SA",
      "buyer_tax_no": "6272616681",
      "show_discount": true,
      "discount_kind": "percent_unit",
      "positions": [
        {
          "name": "Produkt A1",
          "tax": 23,
          "total_price_gross": 10.23,
          "quantity": 1,
          "discount_percent": 50
        },
        {
          "name": "Produkt A2",
          "tax": 0,
          "total_price_gross": 50,
          "quantity": 2,
          "discount_percent": 10
        }
      ]
    }
  }'

Dodanie faktury z rabatem kwotowym

UWAGA: przed wywołaniem należy sprawdzić czy w Ustawieniach Konta pole: 'Jak obliczać rabat' ustawione jest na 'kwotowo'
JSON
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "kind": "vat",
      "number": null,
      "sell_date": "2026-10-19",
      "issue_date": "2026-10-19",
      "payment_to": "2026-10-26",
      "seller_name": "Seller SA",
      "seller_tax_no": "6272616681",
      "buyer_name": "Client1 SA",
      "buyer_tax_no": "6272616681",
      "show_discount": true,
      "discount_kind": "amount",
      "positions": [
        {
          "name": "Produkt A1",
          "tax": 23,
          "total_price_gross": 10.23,
          "quantity": 1,
          "discount": 5
        },
        {
          "name": "Produkt A2",
          "tax": 0,
          "total_price_gross": 50,
          "quantity": 2,
          "discount": 25
        }
      ]
    }
  }'

Dodanie faktury dla istniejącego klienta i produktu

Jeśli masz ID danego klienta (client_id), sprzedawcę (department_id) lub produkt (product_id) to nie musisz przekazywać większej ilości danych. Faktura wystawi się z aktualnym dniem i z 5 dniowym terminem płatności.

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/invoices.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "payment_to_kind": 5,
      "department_id": 222,
      "client_id": 111,
      "positions": [
        {
          "product_id": 333,
          "quantity": 2
        }
      ]
    }
  }'

Aktualizacja faktury

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/invoices/444.json \
  -H "Authorization: Bearer API_TOKEN" \
  -X PUT \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "buyer_name": "New buyer name SA"
    }
  }'

Usunięcie faktury

JSON
curl -X DELETE "https://YOUR_DOMAIN.fakturownia.pl/invoices/100.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl -X DELETE "https://YOUR_DOMAIN.fakturownia.pl/invoices/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Dokumenty magazynowe

Wszystkie dokumenty magazynowe

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents.json?page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"

można przekazywać takie same parametry jakie są przekazywane w aplikacji (na stronie listy faktur), np. "income=no" dla wydatków

Pobranie wybranego dokumentu po ID

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents/555.json" \
  -H "Authorization: Bearer API_TOKEN"

Dodanie dokumentu magazynowego PZ

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "warehouse_document": {
      "kind": "pz",
      "number": null,
      "warehouse_id": "1",
      "issue_date": "2026-10-19",
      "department_name": "Department1 SA",
      "client_name": "Client1 SA",
      "warehouse_actions": [
        {
          "product_name": "Produkt A1",
          "purchase_tax": 23,
          "purchase_price_net": 10.23,
          "quantity": 1
        },
        {
          "product_name": "Produkt A2",
          "purchase_tax": 0,
          "purchase_price_net": 50,
          "quantity": 2
        }
      ]
    }
  }'

Dodanie dokumentu magazynowego WZ

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "warehouse_document": {
      "kind": "wz",
      "number": null,
      "warehouse_id": "1",
      "issue_date": "2026-10-19",
      "department_name": "Department1 SA",
      "client_name": "Client1 SA",
      "warehouse_actions": [
        {
          "product_id": "333",
          "tax": 23,
          "price_net": 10.23,
          "quantity": 1
        },
        {
          "product_id": "333",
          "tax": 0,
          "price_net": 50,
          "quantity": 2
        }
      ]
    }
  }'

Dodanie dokumentu magazynowego PZ dla istniejącego klienta, działu i produktu

Aby ustawić domyślny dział, pomiń klucz department_id (oraz department_name)

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "warehouse_document": {
      "kind": "pz",
      "number": null,
      "warehouse_id": "1",
      "issue_date": "2026-10-19",
      "department_id": "222",
      "client_id": "111",
      "warehouse_actions": [
        {
          "product_id": "333",
          "purchase_tax": 23,
          "price_net": 10.23,
          "quantity": 1
        },
        {
          "product_id": "333",
          "purchase_tax": 0,
          "price_net": 50,
          "quantity": 2
        }
      ]
    }
  }'

Aktualizacja dokumentu

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents/555.json \
  -H "Authorization: Bearer API_TOKEN" \
  -X PUT \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "warehouse_document": {
      "client_name": "New client name SA"
    }
  }'

Usunięcie dokumentu

JSON
curl -X DELETE "https://YOUR_DOMAIN.fakturownia.pl/warehouse_documents/100.json" \
  -H "Authorization: Bearer API_TOKEN"

Produkty i usługi

Wszystkie produkty

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/products.json?page=1&per_page=25&page=1" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/products.xml?page=1&per_page=25&page=1" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie wybranego produktu po ID

XML
curl "https://YOUR_DOMAIN.fakturownia.pl/products/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Dodanie produktu

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/products.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "product": {
      "name": "PoroductAA",
      "code": "A001",
      "price_net": "100",
      "tax": "23"
    }
  }'

Aktualizacja produktu

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/products/333.json \
  -H "Authorization: Bearer API_TOKEN" \
  -X PUT \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "product": {
      "name": "PoroductAA2",
      "code": "A0012",
      "price_gross": "102"
    }
  }'

Widget

Aby pobrać formatkę płatności (w postaci JS) należy wywołać URL:

curl
curl "https://app.fakturownia.pl/a/YOUR_DOMAIN/p/{{token}}.js" \
  -H "Authorization: Bearer API_TOKEN"

gdzie {{token}} to wartość pola token z danego produktu

Klienci

Wszyscy klienci

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/clients.json?page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/clients.xml?page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie wybranego klienta po ID

XML
curl "https://YOUR_DOMAIN.fakturownia.pl/clients/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie wybranego klienta po zewnętrznym ID

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/clients.json?external_id=100" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/clients.xml?external_id=100" \
  -H "Authorization: Bearer API_TOKEN"

Dodanie klienta

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/clients.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "client": {
      "name": "Client1",
      "tax_no": "6272616681",
      "bank": "bank1",
      "bank_account": "bank_account1",
      "city": "city1",
      "country": "",
      "email": "example@email.com",
      "person": "person1",
      "post_code": "post-code1",
      "phone": "phone1",
      "street": "street1"
    }
  }'

Aktualizacja klienta

JSON
curl https://YOUR_DOMAIN.fakturownia.pl/clients/111.json \
  -H "Authorization: Bearer API_TOKEN" \
  -X PUT \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "client": {
      "name": "Klient2",
      "tax_no": "62726166812",
      "bank": "bank2",
      "bank_account": "bank_account2",
      "city": "city2",
      "country": "PL",
      "email": "example2@email.com",
      "person": "person2",
      "post_code": "post-code2",
      "phone": "phone2",
      "street": "street2"
    }
  }'

Płatności

Wszystkie płatności

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/banking/payments.json?page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/banking/payments.xml?page=1&per_page=25" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie wybranej płatności po ID

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/banking/payment/100.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/banking/payments/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Dodawanie nowej płatności

minimal JSON (zalecany)
curl https://YOUR_DOMAIN.fakturownia.pl/banking/payments.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "banking_payment": {
      "name": "Payment 001",
      "price": 100.05,
      "invoice_id": null,
      "paid": true,
      "kind": "api"
    }
  }'
full JSON (zalecany)
curl https://YOUR_DOMAIN.fakturownia.pl/banking/payments.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "banking_payment": {
      "city": null,
      "client_id": null,
      "comment": null,
      "country": null,
      "currency": "PLN",
      "deleted": false,
      "department_id": null,
      "description": "abonament roczny",
      "email": "email@email.pl",
      "first_name": "Jan",
      "generate_invoice": true,
      "invoice_city": "Warszawa",
      "invoice_comment": "",
      "invoice_country": null,
      "invoice_id": null,
      "invoice_name": "Company name",
      "invoice_post_code": "00-112",
      "invoice_street": "street 52",
      "invoice_tax_no": "6272616681",
      "last_name": "Kowalski",
      "name": "Plantnosc za produkt1",
      "oid": "",
      "paid": true,
      "paid_date": null,
      "phone": null,
      "post_code": null,
      "price": "100.00",
      "product_id": 1,
      "promocode": "",
      "provider": "transfer",
      "provider_response": null,
      "provider_status": null,
      "provider_title": null,
      "quantity": 1,
      "street": null,
      "kind": "api"
    }
  }'

Kategorie

Tworzenie nowej kategorii

JSON (zalecany)
curl https://YOUR_DOMAIN.fakturownia.pl/categories.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "category": {
      "name": "my_category",
      "description": null
    }
  }'

Lista kategorii

XML
curl "https://YOUR_DOMAIN.fakturownia.pl/categories.xml" \
  -H "Authorization: Bearer API_TOKEN"
JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/categories.json" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie informacji o pojedynczej kategorii po ID

XML
curl "https://YOUR_DOMAIN.fakturownia.pl/categories/100.xml" \
  -H "Authorization: Bearer API_TOKEN"
JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/categories/100.json" \
  -H "Authorization: Bearer API_TOKEN"

Inne przykłady:

https://github.com/fakturownia/api

Magazyny

Stworzenie nowego magazynu

JSON (zalecany)
curl https://YOUR_DOMAIN.fakturownia.pl/warehouses.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "warehouse": {
      "name": "my_warehouse",
      "kind": null,
      "description": null
    }
  }'

Pobranie listy magazynów

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouses.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouses.xml" \
  -H "Authorization: Bearer API_TOKEN"

Pobranie informacji o magazynie po ID

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouses/100.json" \
  -H "Authorization: Bearer API_TOKEN"
XML
curl "https://YOUR_DOMAIN.fakturownia.pl/warehouses/100.xml" \
  -H "Authorization: Bearer API_TOKEN"

Integracje

Dodawanie nowego użytkownika

JSON
curl -X POST https://app.fakturownia.pl/users.json \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "email": "email73991@fakturowytmail.pl",
      "password": "your_secret_password"
    },
    "integration_token": "email-us-for-this-token"
  }'

Pobranie informacji o użytkowniku (wraz z kodem dostępu API)

JSON
curl -X POST https://app.fakturownia.pl/login.json \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "login": "email73991@fakturowytmail.pl",
    "password": "your_secret_password",
    "integration_token": "email-us-for-this-token"
  }'

Tworzenie nowego konta

JSON
curl -X POST https://app.fakturownia.pl/account.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "account": {
      "prefix": "ftprefix"
    },
    "integration_token": "email-us-for-this-token"
  }'

Tworzenie nowego konta wraz z właścicielem tego konta i danymi firmy

JSON
curl https://app.fakturownia.pl/account.json \
  -H "Authorization: Bearer API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "account": {
      "prefix": "prefix1"
    },
    "user": {
      "login": "login1",
      "email": "email1@email.pl",
      "password": "password1",
      "from_partner": "PARTNER_CODE"
    },
    "company": {
      "name": "Company1",
      "tax_no": "5252445700",
      "post_code": "00-112",
      "city": "Warsaw",
      "street": "Street 1/10",
      "person": "Jan Nowak",
      "bank": "Bank1",
      "bank_account": "111222333444555666111"
    },
    "integration_token": "email-us-for-this-token"
  }'

Pobranie informacji o koncie

JSON
curl "https://YOUR_DOMAIN.fakturownia.pl/account.json?integration_token=email-us-for-this-token" \
  -H "Authorization: Bearer API_TOKEN"

Działy

JSON
curl -X PUT https://YOUR_DOMAIN.fakturownia.pl/departments/222.json \
  -H "Authorization: Bearer API_TOKEN" \
  -F 'department[logo]=@/file_path/logo.png'

Inne przykłady:

https://github.com/fakturownia/api

Potrzebujesz czegoś więcej?

Komplet wywołań wraz z opisem wszystkich parametrów znajdziesz na GitHubie. Jeśli integracja wymaga funkcji, której tu nie ma, napisz na wsparcie@fakturownia.pl.

Załóż darmowe konto