Witamy w usłudze web service Mogado Sp. z o.o.

Aby rozpocząć korzystanie z usługi należy uzyskać oddzielny dostęp(login i hasło), niezależny od danych używanych w celu autoryzacji na stronach www.mogado.pl. W tym celu prosimy o przesłanie maila na adres webservice@mogado.pl z prośbą o dostęp do usługi. W mailu prosimy o podanie nazwy firmy, numeru NIP, imienia i nazwiska oraz adresu e-mail osoby koordynującej wdrożenie usługi po Państwa stronie.

Jeśli chcesz zobaczyć plik WSDL kliknij: MogadoWS.wsdl.
Wszelkie pytania oraz uwagi dotyczące usługi prosimy kierować pod adres webservice@mogado.pl.

• Pobierz_produkt
• Pobierz_produkty
• Pobierz_kody_produkty
• Pobierz_zamowienie
• Pobierz_zamowienia
• Pobierz_pozycja_zamowienia
• Pobierz_pozycje_zamowienia
• Pobierz_fakture
• Pobierz_faktury
• Pobierz_pozycja_faktury
• Pobierz_pozycje_faktury
• Pobierz_adres
• Pobierz_adresV2
• Pobierz_adresy
• Pobierz_adresyV2
• Utworz_adres
• Utworz_adresV2
• Oblicz_koszty_dostawy
• Zloz_zamowienie
• Pobierz_numery_zamowienia
• Wyslij_polecenie_wystawienia_faktury
• Wyslij_zamowienie_do_realizacji
• Pobierz_liste_zamowien_do_faktury
• Wycofaj_zamowienie_z_realizacji
• Sprawdz_status_zamowienia
• Pobierz_kody_z_cennika

Pobierz_produkt

Pobiera informacje o pojedyńczym produkcie z oferty. Wejście:

ID	int
Login	string
Haslo	string
KodMogado	string

Wyjście:

KodMogado	string
KodProducenta	string
KodEAN	string
NazwaProduktu	string
Cena	float
Ilosc1M	int
Gwarancja	string
Producent	string
GrupaTowarowa	string
PodGrupaTowarowa	string
Opis	string
OpisTechniczny	string
LinkDoZdjecia	string

Pobierz_produkty

Pobiera informacje o wszystkich produktach z oferty. Wejście:

ID	int
Login	string
Haslo	string
TylkoMagazyn	string (jeżeli pusty to pokazuje wszystkie produkty, jeżeli wpisany numer magazynu to tylko produkty z tego magazynu)

Wyjście:

KodMogado	string
KodProducenta	string
KodEAN	string
NazwaProduktu	string
Cena	float
Ilosc1M	int
Gwarancja	string
Producent	string
GrupaTowarowa	string
PodGrupaTowarowa	string
Opis	string
OpisTechniczny	string
LinkDoZdjecia	string

Pobierz_kody_produktu

Pobiera informacje o dodatkowych kodach towaru na podstawie kodu Mogado. Wejście:

ID	int
Login	string
Haslo	string
KodMogado	string

Wyjście:

Pobrano	boolean
Tekst	string
Kody	obiekt typu KodyProduktu*

Obiekt typu *KodyProduktu:

KodMogado	string
IndeksCzesci	string
KodProducenta	string

Pobierz_zamowienie

Pobiera informacje o danym zamówieniu.
Warto wiedzieć że w przypadku parametru KodDostawy dostępne są następujące opcje:

• 1 - wysyłka towaru za pomocą spedytora krajowego, gdy nie zdefiniowana jego rodzaju
• 2 - w przypadku odbioru osobistego
• 4 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to GLS
• 6 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to SHENKER
• 7 - wysyłka towaru za pomocą spedytora miejskiego
• 15 - wysyłka towaru wielkogabarytowego za pomocą spedytora krajowego

W przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

Wejście:

ID	int
Login	string
Haslo	string
NumerZamowienia	string

Wyjście:

NumerZamowienia	string
NumerZamowieniaWgKlienta	string
DataWprowadzenia	date
OsobaTworzaca	string
OsobaModyfikujaca	string
TerminRealizacji	date
KodRodzajuZamowienia	string
NazwaRodzajuZamowienia	string
KodFormyDostawy	int (dostępne parametry podane są w opisie funkcji)
OpisFormyDostawy	string
KodSposobuPlatnosci	int (dostępne parametry podane są w opisie funkcji)
OpisSposobuPlatnosci	string
KodWaluty	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
DostawaKodPocztowy	string
DostawaMiejscowosc	string
DostawaUlica	string
DostawaNrDomu	string
DostawaNrLokalu	string
DostawaUwagi	string

Pobierz_zamowienia

Pobiera informacje o zamówieniach wprowadzonych w danym przedziale czasowym.
Warto wiedzieć że w przypadku parametru KodDostawy dostępne są następujące opcje:

• 1 - wysyłka towaru za pomocą spedytora krajowego, gdy nie zdefiniowana jego rodzaju
• 2 - w przypadku odbioru osobistego
• 4 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to GLS
• 6 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to SHENKER
• 7 - wysyłka towaru za pomocą spedytora miejskiego
• 15 - wysyłka towaru wielkogabarytowego za pomocą spedytora krajowego

W przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

Wejście:

ID	int
Login	string
Haslo	string
DataOd	date(YYYY-MM-DD)
DataDo	date(YYYY-MM-DD)

Wyjście:

NumerZamowienia	string
NumerZamowieniaWgKlienta	string
DataWprowadzenia	date
OsobaTworzaca	string
OsobaModyfikujaca	string
TerminRealizacji	date
KodRodzajuZamowienia	string
NazwaRodzajuZamowienia	string
KodFormyDostawy	int (dostępne parametry podane są w opisie funkcji)
OpisFormyDostawy	string
KodSposobuPlatnosci	int (dostępne parametry podane są w opisie funkcji)
OpisSposobuPlatnosci	string
KodWaluty	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
DostawaKodPocztowy	string
DostawaMiejscowosc	string
DostawaUlica	string
DostawaNrDomu	string
DostawaNrLokalu	string
DostawaUwagi	string

Pobierz_pozycja_zamowienia

Pobiera informacje o pojedynczej pozycji w wybranym zamówieniu. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowienia	string
NumerPozycji	int

Wyjście:

NumerZamowienia	string
NumerPozycji	int
KodMogado	string
NumerKatalogowy	string
Nazwa	string
IloscZamawiana	int
IloscPotwierdzona	int
IloscZrealizowana	int
JednostkaMiary	string
KodWaluty	string
Cena	float
CenaWWalucie	float
VAT	float
KodVAT	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
CzyUsluga	boolean

Pobierz_pozycje_zamowienia

Pobiera informacje o wszystkich pozycjach w wybranym zamówieniu. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowienia	string

Wyjście:

NumerZamowienia	string
NumerPozycji	int
KodMogado	string
NumerKatalogowy	string
Nazwa	string
IloscZamawiana	int
IloscPotwierdzona	int
IloscZrealizowana	int
JednostkaMiary	string
KodWaluty	string
Cena	float
CenaWWalucie	float
VAT	float
KodVAT	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
CzyUsluga	boolean

Pobierz_fakture

Pobiera informacje o wybranej fakturze.
Warto wiedzieć że w przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

Wejście:

ID	int
Login	string
Haslo	string
NumerFaktury	string

Wyjście:

NumerDokumentuSprzedazy	string
KodDokumentuSprzedazy	int
DataWprowadzenia	dateTime
DataWystawienia	dateTime
OsobaWystawiajaca	string
KodSposobuPlatnosci	int (dostępne parametry podane są w opisie funkcji)
OpisSposobuPlatnosci	string
Komentarz	string
KodWaluty	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
WartoscPodatkuVAT	float
WartoscPodatkuVATWWalucie	float
TerminPlatnosci	date
IdAdresu	int

Pobierz_faktury

Pobiera informacje o fakturach, które zostały wystawione w wybranym przedziale czasowym.
Warto wiedzieć że w przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

Wejście:

ID	int
Login	string
Haslo	string
DataOd	date(YYYY-MM-DD)
DataDo	date(YYYY-MM-DD)

Wyjście:

NumerDokumentuSprzedazy	string
KodDokumentuSprzedazy	int
DataWprowadzenia	dateTime
DataWystawienia	dateTime
OsobaWystawiajaca	string
KodSposobuPlatnosci	int (dostępne parametry podane są w opisie funkcji)
OpisSposobuPlatnosci	string
Komentarz	string
KodWaluty	string
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
WartoscPodatkuVAT	float
WartoscPodatkuVATWWalucie	float
TerminPlatnosci	date
IdAdresu	date

Pobierz_pozycja_faktury

Pobiera informacje o pojedynczej pozycji w wybranej fakturze. Wejście:

ID	int
Login	string
Haslo	string
NumerFaktury	string
NumerPozycji	int

Wyjście:

NumerDokumentuSprzedazy	string
NumerPozycji	int
KodMogado	string
Nazwa	string
IloscSprzedana	int
JednostkaMiary	string
CenaNetto	float
CenaBrutto	float
VAT	float
KodVAT	float
CenaNettoWWalucie	float
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
CzyUsluga	boolean

Pobierz_pozycje_faktury

Pobiera informacje o wszystkich pozycjach w wybranej fakturze. Wejście:

ID	int
Login	string
Haslo	string
NumerFaktury	string

Wyjście:

NumerDokumentuSprzedazy	string
NumerPozycji	int
KodMogado	string
Nazwa	string
IloscSprzedana	int
JednostkaMiary	string
CenaNetto	float
CenaBrutto	float
VAT	float
KodVAT	float
CenaNettoWWalucie	float
WartoscNetto	float
WartoscNettoWWalucie	float
WartoscBrutto	float
WartoscBruttoWWalucie	float
CzyUsluga	boolean

Pobierz_adres

Pobiera informacje o pojedyńczym adresie klienta. Wejście:

ID	int
Login	string
Haslo	string
IdAdresu	int

Wyjście:

IdAdresu	int
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string
AdresEmail	string
UwagiDoAdresu	string

Pobierz_adresV2

Pobiera informacje o pojedyńczym adresie klienta. V2 - możliwość pobrania numeru telefonu Wejście:

ID	int
Login	string
Haslo	string
IdAdresu	int

Wyjście:

IdAdresu	int
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string
AdresEmail	string
UwagiDoAdresu	string
NumerTelefonu	string

Pobierz_adresy

Pobiera informacje o wszystkich adresach klienta. Wejście:

ID	int
Login	string
Haslo	string

Wyjście:

IdAdresu	int
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string
AdresEmail	string
UwagiDoAdresu	string

Pobierz_adresyV2

Pobiera informacje o wszystkich adresach klienta. V2 - Pole "NumerTelefonu" Wejście:

ID	int
Login	string
Haslo	string

Wyjście:

IdAdresu	int
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string
AdresEmail	string
UwagiDoAdresu	string
NumerTelefonu	string

Utworz_adres

Tworzy nowy adres klienta. Wejście:

ID	int
Login	string
Haslo	string
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string (argument opcjonalny)
AdresEmail	string (argument opcjonalny)
UwagiDoAdresu	string (argument opcjonalny)

Wyjście:

IdAdresu	int

Utworz_adresV2

Tworzy nowy adres klienta. Dodatkowo możliwość podania numeru telefonu. Wejście:

ID	int
Login	string
Haslo	string
Opis	string
Miejscowosc	string
KodPocztowy	string
Poczta	string
Ulica	string
NumerDomu	string
NumerLokalu	string (argument opcjonalny)
AdresEmail	string (argument opcjonalny)
UwagiDoAdresu	string (argument opcjonalny)
NumerTelefonu	string. regex: "/^\+?[0-9\-\ ]+$/". Długość 7 do 15 znaków (argument opcjonalny)

Wyjście:

IdAdresu	int

Oblicz_koszty_dostawy

Oblicza koszt dostawy dla podanych indeksów oraz formy płatności i formy dostawy.
Warto wiedzieć że w przypadku parametru KodDostawy dostępne są następujące opcje:

• 1 - wysyłka towaru za pomocą spedytora krajowego, gdy nie zdefiniowana jego rodzaju
• 2 - w przypadku odbioru osobistego
• 4 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to GLS
• 6 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to SHENKER
• 7 - wysyłka towaru za pomocą spedytora miejskiego
• 15 - wysyłka towaru wielkogabarytowego za pomocą spedytora krajowego

W przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

W przypadku użycia kodu płatności 1, możliwe jest jego połączenie z dowolnym kodem dostawy.
W przypadku użycia kodu płatności 4, możliwe jest jego połączenie tylko i wyłącznie z kodami dostawy: 1 i 4.
W przypadku użycia kodu płatności 7, możliwe jest jego połączenie tylko i wyłącznie z kodami dostawy: 1, 4, 6, 7, 15.
W przypadku użycia kodu płatności 9, możliwe jest jego połączenie tylko i wyłącznie z kodem dostawy: 2.

Wejście:

ID	int
Login	string
Haslo	string
Indeksy	array (tablica obiektów typu PozycjaZamowienia)
IdAdresu	int (argument opcjonalny - parametr IdAdresu można uzyskać poprzez metodę Pobierz_adresy w przypadku nie podania wartości parametru, adresem dostawy będzie adres siedzimy firmy)
KodDostawy	int (dostępne wartości wskazane są w opisie metody)
KodPlatnosci	int (dostępne wartości wskazane są w opisie metody)

Obiekt typu PozycjaZamowienia:

KodMogado	string
Ilosc	int

Wyjście:

KosztDostawyCalosc	float
KosztDostawyDrobnica	float
KosztDostawyPaleta	float
KosztPobrania	float
KosztManipulacyjny	float

Zloz_zamowienie

Składa zamówienie na wybrany asortyment.
Warto wiedzieć że w przypadku parametru KodDostawy dostępne są następujące opcje:

• 1 - wysyłka towaru za pomocą spedytora krajowego, gdy nie zdefiniowana jego rodzaju
• 2 - w przypadku odbioru osobistego
• 4 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to GLS
• 6 - wysyłka towaru za pomocą spedytora krajowego, gdy zdefiniowano, że ma być to SHENKER
• 7 - wysyłka towaru za pomocą spedytora miejskiego
• 15 - wysyłka towaru wielkogabarytowego za pomocą spedytora krajowego

W przypadku parametru KodPlatnosci dostępne są następujące opcje:

• 1 - płatność przelewem
• 4 - płatność przy odbiorze przesyłki
• 7 - płatność przed wysłaniem przesyłki
• 9 - płatność w kasie firmy

W przypadku użycia kodu płatności 1, możliwe jest jego połączenie z dowolnym kodem dostawy.
W przypadku użycia kodu płatności 4, możliwe jest jego połączenie tylko i wyłącznie z kodami dostawy: 1 i 4.
W przypadku użycia kodu płatności 7, możliwe jest jego połączenie tylko i wyłącznie z kodami dostawy: 1, 4, 6, 7, 15.
W przypadku użycia kodu płatności 9, możliwe jest jego połączenie tylko i wyłącznie z kodem dostawy: 2.

Wejście:

ID	int
Login	string
Haslo	string
NumerZamowieniaWgKlienta	string
Indeksy	array (tablica obiektów typu PozycjaZamowienia)
IdAdresu	int (argument opcjonalny - parametr IdAdresu można uzyskać poprzez metodę Pobierz_adresy w przypadku nie podania wartości parametru, adresem dostawy będzie adres siedzimy firmy)
KodDostawy	int (dostępne wartości wskazane są w opisie metody)
KodPlatnosci	int (dostępne wartości wskazane są w opisie metody)
Uwagi	string (argument opcjonalny)
KodZamowienia	string (jeżeli nie wpisany to ZWS)
Magazyn	string (jeżeli nie wpisany to 1M)
TylkoDostepneIlosci	boolean (wartość domyślna to false)

Obiekt typu PozycjaZamowienia:

KodMogado	string
Ilosc	int

Wyjście:

NumerZamowienia	string
PozycjeZamowienia	(tablica obiektów typu ZamowieniePozycja)

Obiekt typu ZamowieniePozycja:

NumerZamowienia	string
NumerPozycji	int
KodMogado	string
NumerKatalogowy	string
Nazwa	string
IloscZamawiana	int
IloscPotwierdzona	int
IloscZrealizowana	int
JednostkaMiary	string
Cena	float
VAT	float
WartoscNetto	float
WartoscBrutto	float
CzyUsluga	boolean

Pobierz_numery_zamowienia

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowieniaWgKlienta	string

Wyjście:

Pobrano	boolean
Tekst	string
NumeryZamowienia	string

Obiekt typu *NumeryZamowienia:

NrZamowieniaWgKlienta	string
NrZamowieniaMogado	int
NrZamowieniaAction	int

Wyslij_zamowienie_do_realizacji

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowieniaWgKlienta	string

Wyjście:

Wyslano	boolean
Tekst	string
NumeryZamowienia	NumeryZamowienia

Pobierz_liste_zamowien_do_faktury

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
NrFaktury	string

Wyjście:

Pobrano	boolean
Tekst	string
Lista	tablica obiektów typu NumeryZamowienia*

Obiekt typu *NumeryZamowienia:

NrZamowieniaWgKlienta	string
NrZamowieniaMogado	int
NrZamowieniaAction	int

Wyslij_polecenie_wystawienia_faktury

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
Termin	int
TypZamowienia	string

Wyjście:

Wysłano	boolean
Tekst	string

Wycofaj_zamowienie_z_realizacji

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowienia	string
NumerZamowieniaWgKlienta	string

Wyjście:

Wycofano	boolean
Tekst	string

Sprawdz_status_zamowienia

Metoda dostępna dla wybranych klientów, po uprzednim ustaleniu zasad jej funkcjonowania. Wejście:

ID	int
Login	string
Haslo	string
NumerZamowieniaWgKlienta	string

Wyjście:

Sprawdzono	boolean
Tekst	string
Status	string

Pobierz_kody_z_cennika

Metoda umożliwia pobranie kodu mogado na podstawie indeksu dostępnego w cennikach na platformie B2B. Dzięki temu możliwe jest składanie zamówień metodą Zloz_zamowienie na podstawie listy produktów z cennika. Wejście:

ID	int
Login	string
Haslo	string
IndeksyCzesci	array (tablica obiektów typu string)

Wyjście:

IndeksyDoKoduMogado	array (tablica obiektów typu IndeksDoKoduMogado). Ilość elementów tablicy odpowiada ilości indeksów przekazanej na wejściu

Obiekt typu IndeksyDoKoduMogado:

Indeks	string. Odpowiada wartości przekazanej na wejściu w polu IndeksyCzesci
KodMogado	string. Kod który można wykorzystać do złożenia zamówienia