Dokumentacja

Dokumentacja przedstawia krok po kroku jak w prosty i szybki sposób skomunikować
Twój sklep z Comfino.

Spis treści

Integracja Sklepu

  1. Wprowadzenie
  2. Uwierzytelnienie użytkownika API
  3. Pobieranie produktów finansowych
  4. Pobieranie parametrów najlepszej oferty
  5. Składanie wniosku kredytowego
  6. Notyfikowanie statusu do sklepu
  7. Zmiana kwoty zamówienia
  8. Anulowanie wniosku
  9. Zlecenie wypłaty środków
  10. Dodawanie punktu sprzedaży usług
  11. Aktualizacja danych punktu sprzedaży usług
  12. Pobieranie punktu sprzedaży usług
  13. Pobieranie listy wszystkich punktów sprzedaży usług
  14. Wartości słownikowe
  15. Rejestracja nowego sklepu
  16. Rejestracja nowego sklepu - pobieranie zgód
  17. Rejestracja nowego sklepu - sprawdzanie statusu aktywacji
  18. Widgety

Dodawanie punktu sprzedaży usług

Dodaje nowy punkt sprzedaży usług. Każdy wpis o danym numerze NIP jest unikalny. Nie można dodać do bazy kilku wpisów o takim samym numerze NIP.

Zapytanie: | Zapytanie jest sprawdzane pod kątem poprawności przesyłanych wartości

curl -X POST 'http://{HOST_API}/v1/sale-points' \
--header 'API-KEY: {API-KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "name": "{nazwa dostawcy usługi}",
  "taxId": "{NIP usługodawcy}",
  "city": "{miejscowość usługodawcy}",
  "accountNumber": "{numer konta usługodawcy}",
  "contactPerson": "{dane osoby do kontaktu}",
  "productTypes": [{lista typów produktów dostępnych dla punktu sprzedaży}]
}'

Definicja pól:

Nazwa pola Typ Wymagane Format
name string tak Znaki alfanumeryczne (max. 100)
taxId string tak Znaki alfanumeryczne (max. 10)
city string tak Znaki alfanumeryczne (max. 50)
accountNumber string tak Znaki alfanumeryczne (max. 50)
contactPerson string nie Znaki alfanumeryczne (max. 50)
productTypes string[] nie Tablica wartosci slownikowych - zobacz sekcje typy produktow finansowych w dokumentacji wartosci slownikowych.

Odpowiedź:

{
    "name": "{nazwa dostawcy usługi}",
    "taxId": "{NIP usługodawcy}",
    "active": true,
    "city": "{miejscowość usługodawcy}",
    "accountNumber": "{numer konta usługodawcy}",
    "contactPerson": "{dane osoby do kontaktu}",
    "productTypes": [{lista typów produktów dostępnych dla punktu sprzedaży}]
}

Kody odpowiedzi:

  • 201 Created
  • 400 Bad Request
  • 401 Unauthorized
  • 403 Http Forbidden
  • 404 Http Not Found
  • 405 Method Not Allowed
  • 500 Internal Server Error