1. Token
W panelu przejdź do Ustawienia -> Konto i wygeneruj token API. API jest dostępne od pakietu PRO.
Demo i sandbox API.
Najkrótsza ścieżka testu: wygeneruj token API w panelu, sprawdź health-check, a potem utwórz fakturę z testowego zamówienia.
2. Health-check
Najpierw sprawdź konto, token, webhooki i gotowość schematu projektu.
3. Faktura
Użyj external_id, aby integracja była idempotentna i nie tworzyła duplikatów.
OpenAPI/api/openapi.php - import do Swagger UI, Insomnia i generatorów klientów.
Postman/api/postman.php - gotowa kolekcja z folderami dla faktur, bulk, klientów, produktów i automatyzacji PRO.
DokumentacjaStartuj od
api/health.php, potem api/faktury/create.php albo endpointów bulk dla sklepów.Przykłady curl
Podmień {{account_id}} i {{api_token}} na dane z panelu.
curl -H "Authorization: Bearer {{api_token}}" \
"https://faktury.pro/api/health.php?id_konta={{account_id}}"curl -X POST "https://faktury.pro/api/faktury/create.php" \
-H "Authorization: Bearer {{api_token}}" \
-H "Content-Type: application/json" \
-d '{
"id_konta": "{{account_id}}",
"external_id": "order-1001",
"client": {
"nazwa": "Testowy klient",
"email": "klient@example.com"
},
"items": [
{
"nazwa": "Usługa testowa",
"ilosc": "1",
"cena_netto": "100.00",
"vat": "23"
}
]
}'curl -X POST "https://faktury.pro/api/faktury/bulk-create.php" \
-H "Authorization: Bearer {{api_token}}" \
-H "Content-Type: application/json" \
-d '{
"id_konta": "{{account_id}}",
"invoices": [
{
"external_id": "order-1001",
"client": {
"nazwa": "Testowy klient",
"email": "klient@example.com"
},
"items": [
{
"nazwa": "Usługa testowa",
"ilosc": "1",
"cena_netto": "100.00",
"vat": "23"
}
]
}
]
}'Chcesz podpiąć sklep?
Najpierw przetestuj health-check i jedną fakturę, potem przejdź na bulk oraz webhooki statusów.