1. Sučelje mora primati zahtjeve putem HTTPS-a iz IP adresa podmreža:
   • 79.142.16.0, maska \u200b\u200b255.255.240.0 (20)
   • 91.232.230.0, maska \u200b\u200b255.255.254.0 (23)
2. Sučelje mora obraditi parametre koji prenosi HTTP get sistem.
3. Sučelje mora formirati sustav odgovora u xML format U kodiranju UTF-8.
4. Razmjena informacija se vrši u režimu odgovora u upitu, dok brzina odgovora ne smije biti veća od 60 sekundi, u protivnom, sustav prekida naslov putem istek vremena.
5. Ako se očekuje da će procijenjeni broj plaćanja za dobavljača usluga biti intenzivan (do 10 plaćanja u minuti ili više), potrebno je da sučelje podržava komunikaciju s više navoja na 10-15 istodobnih veza.
6. Sučelje mora dobiti zahtjeve za HTTPS protokol na jedan od sljedećih TCP portova: 80, 81, 443, 8008, 8080, 8081, 8090, 8443, 4433. Korištenje ostalih portova nije dopušteno.

Osnovni principi sučelja

Svi zahtjevi prenose se dobivanjem metode, parametri se prenose na stazi za zahtjev.

Prijenos informacija o pružatelju plaćanja izrađuje sistem Qiwi novčanika u dvije faze - provjeravanje statusa pretplatnika i uplatu direktno. Preliminarna faza pribavljanja dodatnih parametara plaćanja od dobavljača koji pruža pretplatnik može se dodati da bi obavijestio platitelja i dodao parametre plaćanja na izbor platitelja.

Vrsta upita prenosi Qiwi sistem novčanika u kvarskoj varijabli - provjeru niza, platite ili getinfo vrijednosti:

Parametri upita

Svi parametri su potrebni u onim upitima u kojima se koriste.

Parametar	Format	Opis	U koji se koriste zahtjevi
Txn_id.	Cijeli broj do 20 znakova	Jedinstveni identifikator plaćanja u Qiwi sistemu. Postoji i rezolucija kontroverznih pitanja o ovom identifikatoru.	Provjerite, platite.
SUMA.	Frakcijski broj s tačnošću za stotinu koristi se kao separator. (tačka). Ako iznos predstavlja cijeli broj, još uvijek se nadopunjuje tačkom i nulama, na primjer - 152.00.	Iznos plaćanja	Provjerite, platite.
CCY.	Alpha-3 Kod valute ISO 4217	Valuta plaćanja	Provjerite, platite.
Txn_date.	Gghymmddchchms	Datum plaćanja (u datumu plaćanja sustav podrazumijeva datum primanja zahtjeva od klijenta). U ovom datumu postoji daljnje usklađivanje međusobnih doseljenika između novčanika Qiwi i dobavljača. Na primjer, klijent je poslao zahtjev Qiwija novčanika 31.12.2010 u 23:59:59, a sistem Qiwija novčanika poslao je svoj zahtjev za pružatelj usluga 01/01/2011 u 00:00:00. To može dovesti do problema sa usklađivanjem plaćanja, ako sistem pružatelja usluga stavi transakciju u narednom procijenjenom periodu. Da bi se izbjegli takvi problemi, Qiwi Novčanik pruža pružatelju prvobitnog datuma plaćanja.	Platite.
Račun	Niz koji sadrži slova, brojeve i posebne mješavine, dugačak do 200 znakova	ID pretplatnika. Dobavljač identificira svoj pretplatnik na jedinstveni identifikator (broj ličnog računa, telefon, prijava itd.). Prije slanja davatelja usluga, identifikator se prolazi kroz provjeru ispravnosti u skladu sa redovnim izrazom, koji.	Provjerite, platite, genInfo
Dodatni	Dozvoljeni brojevi (0-9), naglašavajući (_) i mala slova latinske abecede (A-Z)	Dodatne podatke o plaćanju (dodatna polja). Ovi se parametri mogu koristiti ako se plaćanje ne može provesti bez dodatnih podataka (jedan korisnički ID u sustavu pružatelja usluga nije dovoljan). Na primjer, identifikator korisnika - broj kreditna karticaAli za uplatu morate odrediti valjanost kartice. Popis potrebnih polja za prijenos pružatelja usluga mora biti navedena.	Provjerite, platite.
Prvid.	Cijeli broj	Identifikator usluge u općem sustavu dobavljača.	Genginfo.
Ime parametra.	Format imena i vrijednosti parametara označava dobavljač u.	Dodatni parametri za identifikaciju pretplatnika	Genginfo.

Da bi podržali proširivost i održavanje performansi dobavljača u periodu uključivanja različitih funkcija predviđenih protokolom (na primjer, uključivanje prenosa novih detalja o plaćanju), pretpostavlja se da provajder ne sprečava pojavu novih HTTP parametara u zahtjevu.

Garantovano je da pojava novih parametara u upitu neće dovesti do potrebe za promjenom zahtjeva za traženje od pružatelja usluga, osim u slučajevima kada je takva promjena logike dogovorena s pružateljem usluga.

Format odgovora

Dobavljač mora vratiti odgovor na sistemski zahtjevi u XML formatu. Ukupna struktura odgovora daje se na desnoj kartici.

123323498 12369bdkj9. 100.00 643 2012-04-05T12: 00: 07 0

U slučaju da bilo koji od zahtjeva pružatelja usluga završava greškom, dobavljač vraća kôd pogreške u skladu s tim.

U informacioni sistem Dobavljač ne bi trebao sadržavati dvije uspješno izvršene uplate istim TXN_ID brojem. Ako sustav ne radi zahtjev s već postojećim TXN_ID identifikatorom u informacijskom sistemu pružatelja usluga, pružatelj usluga mora vratiti rezultat obrade prethodnog upita.

U odgovoru mogu biti prisutne sljedeće oznake:

Na primjer, postoji situacija: klijent je zahtjev poslao na sistem 31.12.2010 u 23:59:59. S obzirom na kašnjenje u preradi podataka i otpreme informacija o komunikacijskim kanalima, plaćanje pružatelja usluga bit će primljeno 01.01.2011. 00:00:05 i u skladu s tim, račun u sustavu pružatelja usluga u drugom izvještajnom periodu. Da bi se izvršili problemi s različitim izvještajnim razdobljima, potrebno je davac vrati datum na koji račune u svom sistemu.

Primjer zahtjeva za provjeru statusa računa pretplatnika i registracije plaćanja

Uvjeti primjera:

Primjena plaćanja PLATNE_App provajdera nalazi se na tvojoj liviji.PRV.ru, poslužitelj podržava HTTPS veze po priključku 8443.

Da biste provjerili status pretplatnika, sistem Qiwi novčanika generira upit (vidi karticu s desne strane).

Dođite. / plaćanje_App? Command \u003d Check & TXN_ID \u003d 1234567 & Račun \u003d 4957835959 & Sum \u003d 10,45 i CCY \u003d RUB 1234567 2016AB. 10.45 Trljanje. 0 UREDU.

Zahtjev sadrži parametre:

• naredba \u003d provjera - identifikator za provjeru stanja pretplatnika;

Uspješan odgovor provajdera (pogledajte ispravnu karticu).

Rezultat povratka \u003d 0 Da biste zatražili provjeru ukazuje na to da se osobni račun pretplatnika u odgovarajućem broju u polju računa može nadopuniti za iznos naveden u upitu u polju Sum. Nakon uspješnog provjere statusa računa pretplatnika, sustav se nastavlja u formiranje i slanje zahtjeva za nadopunu ravnoteže (zahtjev za plaćanje).

Primjer zahtjeva za popunjavanje ličnog računa

Uvjeti primjera:

Da biste potvrdili plaćanje, sistem Qiwi novčanika generira upit (vidi desnu karticu).

Dođite. / plaćanje_app? Command \u003d Pay & TXN_ID \u003d 1234567 & txn_date \u003d 201108151201333 & account \u003d 4957835959 i suma \u003d 10,45 i CCY \u003d RUB HTTP / 1.1 Domaćin: tvoj REVICE.PRV.RU:8443 Odgovor dobavljača 1234567 2016AB. 10.45 Trljanje. 0 UREDU. 2011-08-15T12: 06: 45

Zahtjev sadrži parametre:

• naredba \u003d plati - identifikator zahtjeva za bilans stanja pretplatnika;
• tXN_ID \u003d 1234567 - Interni broj plaćanja u Qiwi sistemu;
• txn_date \u003d 20090815120133 - Datum računovodstva plaćanja u Qiwi sistemu;
• račun \u003d 4957835959 - identifikator pretplatnika u informacionom sistemu pružatelja usluga;
• sum \u003d 10,45 - iznos za upis na lični račun pretplatnika;
• cCY \u003d RUB - valuta kredita za kreditiranje na lični račun pretplatnika.

Rezultat povratka \u003d 0 Da biste platili, dobavljač izvještava o uspješnom završetku postupka napunjenosti. Sistem u potpunosti dovršava obradu ove transakcije.

U opcionalnom polju komentara sadrži komentar usluge.

Primjer zahtjeva za dodatne podatke o plaćanju

Uvjeti primjera:

Primjena plaćanja PLATNE_App provajdera nalazi se na tvojoj livici.PRV.ru, poslužitelj podržava HTTPS veze na port 8443.

Da biste dobili dodatne podatke o plaćanju, Qiwi sistem novčanika generira upit (vidi desnu karticu).

Dođite. / plaćanje_app? Komanda \u003d genginfo & prvid \u003d 12345 ° Ccount \u003d 4957835959 & name1 \u003d% 26% 30Ab & women2 \u003d 0 HTTP / 1.1 Domaćin: tvoj REVICE.PRV.RU:8443 Odgovor dobavljača Na računu1. Termin2. 0 UREDU.

Zahtjev sadrži parametre:

• command \u003d GetInfo - Identifikator zahtjeva za dodatne podatke o plaćanju pretplatnika;
• prvid \u003d 12345 - Identifikator za određivanje davatelja usluga;
• račun \u003d 4957835959 - identifikator pretplatnika u informacionom sistemu pružatelja usluga;
• name1, Name2 - Dodatni identifikatori pretplatnika.

Za odgovor dobavljača pogledajte karticu s desne strane.

Rezultat povratka \u003d 0 Da biste dobili zahtjev Getinfo sugerira da je zahtjev uspješan i dobiveni su dodatni podaci za pretplatnički prikaz.

U opcionalnom polju komentara sadrži komentar usluge.

Svakodnevno pomirenje

Do 10:00 Moskovsko vrijeme, sustav generira i šalje elektronički registar prihvaćenih plaćanja na navedenoj adresi za prethodni dan.

Registar ima sljedeću strukturu:

Datum transakcije (Moskva); Datum izvještaja; tip; Broj transakcije; Karakcijski broj transakcija; Trgovački komentar; Trgovački komentar; Broj transakcije / fakture; QW ID; račun; račun; račun

;; Plaćanje; ;;;;;;;;

;; Plaćanje; ;;;;;;;;

Polja su odvojena znakom; , Frakcijski dio iznosa odvojen je poantu, datum / vrijeme je Moskva, prijevod niza može se sastojati od X0D X0A znakova i jednostavno iz X0D.

Na primjer:

31.02.2005 00:04:00;31.02.2005

00: 00: 00; plaćanje; 3464968222; USD; 5,00 ;;;;;; 0957835959 ;;

31.02. 2005 00: 04: 00; 31.02. 00: 00: 00; plaćanje; 3464968912; trljanje; 10.34 ;;;;; [Zaštićen e-poštom];;

31.02. 2005 00: 11: 00; 31.02. 2005 00: 00: 00; plaćanje; 3464974548; EUR; 4,72 ;;;;; abc-12345 ;;

Sistem uključuje samo uspješnu uplatu u registru.

Plaćanja su potvrđena, koja je došla i na internetsku poruku i registar.

Ako u registru nema plaćanja, koji su održani u bazi podataka dobavljača ili sadrže plaćanja koja nisu u davatelju usluga u bazi podataka ili kada se registar ne poveća, potrebno je kontaktirati navedenu kontaktnu osobu QIWI u ugovoru, do 12:00 da saznate situaciju i donošenje odluka.

Dodatne mogućnosti za autorizaciju upita

Aplikacija pružatelja usluga zahtijeva identifikator (prijava) i tajnu lozinku za njega korištena za autorizaciju kada se upita iz Qiwi-a.

Ovi podaci o autorizaciji prenosi se prema standardnoj osnovnoj pravilima za provjeru autentičnosti kada su upiti HTTP (i). Autorizacija HTTP zaglavlje se dodaje u upit. Naslov označava osnovni niz (sa kraja na kraju) i par "Prijava: Lozinka", kodirana u bazi64:

Autorizacija: Basic ***

Base64 ("Prijava: Lozinka") \u003d "***"

Priključna aplikacija (uzorak)

Lista kompletnih kodova

Prilikom obrade zahtjeva iz sistema, pružatelj usluga mora uporediti sve pogreške u svojoj aplikaciji s donjem popisom i vratiti odgovarajuće kodove u elementu.

Sigurnika + stup u stupcu ukazuje na znak smrtnosti pogreške. Za sistem novčanika Qiwi, fatalna greška znači da će ponovo slati upit istim parametrima rezultirati 100% ponavljanjem iste greške - stoga sustav prestaje obrađivati \u200b\u200bzahtjev za klijenta i prekinuti ga s greškom.

Neinfaarna greška znači sistem koji ponavljanje upita s istim parametrima nakon određenog vremenskog perioda može rezultirati uspjehom. Sistem će ponoviti zahtjeve koji završavaju nepoznata greška, neprestano povećavajući interval dok se operacija ne završi s uspjehom ili fatalnom greškom, ili dok se život upita ne istekne - 24 sata.

Nedostatak komunikacije s poslužiteljem pružatelja usluga je nerazumljiva greška.

Nepostojanje odgovora elemenata (netačan XML, usluga privremeno nedostupna stranica, itd.) Takođe je nerazumljiva greška.

Kod

Jedinstveni identifikator plaćanja - šta je to? Za šta je to potrebno? Ovo su najčešća pitanja koja se postavljaju poduzetnici prilikom plaćanja poreza u banci kada zaposlenik banke zahtijeva naznačiti to uzrokuje zbunjenost. Gdje saznati kako da dobijem i mogu li bez njega? Dakle, alat kreiran za pojednostavljenje postupka dovelo je do činjenice da su postojala nova pitanja koja treba objasniti.

Koji je jedinstveni identifikator?

Jedinstveni identifikator plaćanja je 20-znamenkasti kôd koji je potrebno odrediti u otplati poreznog duga u njega omogućava slobodno i brzo plaćanje poreza sa ličnog računa na web mjestu poreznih usluga. Takav pristup uvelike pojednostavljuje i ubrzava postupak izvršenja operacije. Plaćanje se javlja brzo, pa, stoga, pravovremeno, što izbjegava kašnjenja, što znači da su kazne i kazne.

Upotreba jedinstvenog identifikatora omogućava poduzetnicima, pravnim osobama i pojedincima da plaćaju porez prikladne za sebe. Ali dobivanje i popunjavanje oblika porezne dokumentacije u ovom slučaju ima svoje karakteristike koje morate uzeti u obzir. Problem je ujedno i sama državne informativne službe ima složenu zbunjujuću strukturu u kojoj se uvijek može razumjeti čak i iskusni korisnik.

Za šta je to potrebno?

Potreban je da bi se znao u FTS-u kada i iz koje osobe su dobili novac. Milioni korisnika registrovani su u GIS-u, određuju od koga i koji se ciljevi novac prenosi teško. Zato je naredba Ministarstva finansija br. 107N od 12.11.13, pravila su promijenjena, u skladu s kojom se pojavljuje identifikator plaćanja u jedinstvenom naplatu.

Za poreznoj službi potrebno je da bi se efikasnije držalo fiskalne politike i identificirali zlonamjerne neplaćanje. Pravne i pojedince su potrebni kao najpovoljniji i brz način plaćanja poreza. Kao rezultat toga, Vlada može kontrolirati postupke poreskih vlasti i spriječiti slučajeve kada njihove akcije premašuju ovlaštenja prenesene na njih, što se često dogodilo ranije. Privrednici su manje ovisni o volji pojedinca i pate od ilegalnih optužbi. Broj izvršenih inspekcija.

Ko bi trebao naznačiti?

Navedite jedinstveni identifikator plaćanja mogu i obični građani, poduzetnici (pojedinci) i pravne osobe. To možete učiniti prilikom plaćanja poreza direktno u uredu informacionog sistema ili putem banke. Prilikom prenosa treba imati na umu da plaćanje putem Sberbanke ima svoje karakteristike. Oni imaju svoj poseban oblik, prilikom popunjavanja jedinstvenog identifikatora ne bi trebao odrediti. Pobjeda je naznačena prilikom plaćanja poreza, državne carine kroz državnu službu službi ili kancelarije Banke.

Ako fizička ili pravna osoba ispunjava platne dokumente za plaćanje poreza i naknada, čiji se platni period još nije istekao, tada ne može ući u jedinstveni identifikator, a u trajanju komisije za ubacite nulu. Iako je zakon dopušten zakon da popuni liniju, prilikom plaćanja putem banke, zaposlenik može zahtijevati popunjavanje linije 20-znamenkastim brojem plaćanja i imati pravo da prihvati plaćanje. Stoga je važno znati u kojim slučajevima se mora navesti, a u onome što nije potrebno.

U kojim slučajevima treba biti naveden?

Treba napomenuti da identifikator ne bude uvijek naznačen, ali samo u određenim slučajevima koji su opisani u pravilima i odredbama Banke Rusije (posebno uredbu br. 383-P). Pobjeda - jedinstveni identifikator označen je u dva slučaja:

1. Ako je pokazao primatelja sredstava i dodjeljuje se fizičkom ili pravnom licu, dužan je platiti u skladu s uvjetima ugovora. U ovom slučaju identifikator se dodjeljuje automatski.
2. Kada prenose sredstva poreznim vlastima. Poduzetnik ili pojedinac ispunjava posebna polja (linije) plaćanja u papiru ili elektroničkom obliku. U ovom slučaju, punjenje uzrokuje neke poteškoće. Uostalom, poduzetnik ne zna uvijek njegov broj jedinstvenog identifikatora plaćanja, gdje ga treba.

U drugom slučaju većina poreskih obveznika je teška, jer ne znaju gdje možete uzeti i gdje ćete odrediti u dokumentu. A pogrešno određeni podaci dovode do kašnjenja u plaćanju, kaznama i novčanim kaznama.

Gdje i kako mogu dobiti identifikator?

O jedinstvenom identifikatoru plaćanja Kako saznati informacije, kao i da li je izvršena plaćanja? To možete provjeriti kao na GIS ličnom računu nakon registracije u sustavu i prilikom primanja naloga za plaćanje u slučaju kašnjenja u plaćanjima. Ali ovo je ekstremni slučaj. Poduzetnik će biti svjestan broja dokumenata koji ukazuju na prisustvo duga ili kazne poreznih vlasti.

Ako nema zakašnjelih plaćanja, a uin treba odrediti, onda je dovoljno da pošaljete zahtjev poreznom službi da biste dobili sobu.

Kako popuniti?

Ako plaćanja plaćanja plaćaju u budžetskom sistemu Ruske Federacije, ispunjavaju nalog za plaćanje. Pored toga, pored jedinstvenog identifikatora, poduzetnik mora navesti:

• Bicikl te institucije putem koje će se izvršiti plaćanje;
• naziv banke, njegova pravna adresa;
• tekući račun iz kojeg će biti izvršen prijevod;
• vrsta plaćanja (kod);
• datum rada.

Broj se ubrizgava u liniju jedinstvenog identifikatora plaćanja - 22 (polje). Nije ispunjeno samo ako se plaćanje nastavi pravovremeno. U ovom se slučaju ova linija uključuje "0" (nula).

Što ako dokument već sadrži pobjedu?

Ponekad, posebno prilikom plaćanja putem specijaliziranih informacionih sistema, prilikom popunjavanja elektronskog naloga u nizu (njegov kod 22), jedinstveni identifikator plaćanja se pojavljuje sam. Kako se liječiti? Da li se to smatra greškom ako se gotovina donosi pravovremeno? Zapravo nema greške. Možete platiti kao što ukazuje na broj identifikatora i obloge u liniji "0". Samo identifikator zahtijeva odrediti je li plaćanje odgođeno, odnosno na zahtjev poreza.

Iako je moguće platiti bez razgraničenja, ali ovaj je pristup nepoželjan. Kompanija mora razlikovati obične porezne isplate i one koje su isplaćene na zahtjev poreskih vlasti. To će pomoći u izbjegavanju zbrke u izvještavanju.

Ali čak i ako ne bih mogao naučiti i odrediti identifikator u ime, ne daje pravo bankama da ga odbiju. Banka je dužna da prihvati i prevode sredstva, čak i ako UIP nije naveden (jedinstveni identifikator plaćanja). Pravilo se navodi u službenim poreznim tačkima. Sasvim je jasno naznačeno da je dovoljno da naznačite svoju gostiju, a u liniji (kod 22) jedinstvenog identifikatora plaćanja unesite "0". U ovom slučaju banka nema pravo napustiti prijenos plaćanja. Ali poduzetnik mora uzeti u obzir da u slučaju pogreške ili kašnjenja, banka nije odgovorna.

Što znači kod: Identifikator dešifriranja

Identifikator se dekodira na sljedeći način:

1. Brojevi od 1 do 3 označavaju kodeks poreznog podjela u koji će fondovi dobiti.
2. Slika 4 označava vrstu plaćanja. Uvijek postoji nula na ovom mjestu.
3. Brojevi od 5 do 19. označavaju kodeks dokumenta u poreznom sistemu. Svaki se platitelj dodjeljuje vlastiti poseban kod na osnovu prethodne verzije indeksa dokumenata.
4. Slika 20. Prema njegovom broju, određuje se na kojima se državna vlast vrši provjerom plaćanja. Izračunato sa preostalih 19 cifara koda.

Jedinstveni identifikator plaćanja identičan je indeksu dokumenata samo ako se indeks sastoji od 20 znamenki.

Šta će se dogoditi ako ga ne navodite?

Pobednički broj, porezi i druga plaćanja u proračunu automatski se uzimaju u obzir. Informacije o uplatama u proračunu prenose se u jednu bazu podataka. Ako navedete pogrešan kôd ili ne odredite, sustav ne prepoznaje plaćanje, a novac se neće prevesti. Ovo je prepuno takvih problema kao:

• kompanija ima dug za budžet i fondove;
• nastavite sa prikupljanjem kazne;
• bit će potrebno pojasniti plaćanje i saznati njegovu sudbinu;
• novac će kasno ići na budžet ili temelje.

Ako biznismen nema ili ne zna jedinstveni identifikator plaćanja, gdje treba uzeti, može koristiti uslugu podrške u GIS-u u bilo kojem trenutku, a ne čekati da porezne vlasti poduzmu. Ako poduzetnik nema pristup internetu i elektroničkom sustavu "državnih usluga", može poslati redovno pismo najbližoj grani porezne službe ili se lično pojaviti za dobivanje identifikatora.

Koji su dokumenti potrebni za dobivanje identifikatora?

Sve ovisi o tome koji će se formirati dokument biti sastavljen i kako platiti. Ako je ovo papirni dokument, onda trebate poslati pismeni zahtjev poreznom tijelu. U pismu navedite detalje o pasošu, gostionicu i braniteljski broj. Jedinstveni identifikator plaćanja bit će poslat u pismu odgovora. Ako je legalna ili pojedinac lično u odjelu za dobivanje ovih detalja, tada bi ti dokumenti trebali biti pod njim. Potrebni su im za popunjavanje obrazaca.

Da biste dobili detalje u elektroničkom obliku, prvo se morate registrirati sa jedinstvenim informacionim sistemom na web stranici "Državne službe", navodeći iste podatke kao u pisanom zahtjevu. Nakon toga, pismo dolazi na adresu smještaja s pristupnim ključem. I tek nakon toga možete podnijeti zahtjev za jedinstveni identifikator. Obično je ova usluga u roku od nekoliko sati nakon primjene. Dokumenti nisu potrebni.

Kao što se vidi, ne postoji ništa složeno kada se koristi identifikator. Nije teško saznati. Za to ne trebate sakupljati gomilu dokumenata ili referenci. Ali porezi se mogu uplatiti u ugodnom obliku i u bilo koje vrijeme. Ako su raniji pravni subjekti i pojedinci morali provesti vrijeme i sredstva za poređenje, a zatim s njim mogu biti plaćene, bez napuštanja kuće ili ureda, bez odvajanja od posla.

Opći

Opis ulaznih parametara

Ulaz: XML dokument prema WS_ULIPZAPRID_2_311_11_04_02 _01_01.xsd.

1. Opis izlaznih parametara

Izlaz: XML dokument prema schemews_otvvipulxsd_2_311_14_04_02_01.xsd

ili

Izlaz:XML dokument prema WS_ULIPOTVID_2_311_09_04_02_01.xsd shemi

Parametri složenog tipa opisani su u Dodatku "Opis općih struktura podataka" (u paragrafima 10, 6, 9).

1. Povratni kodovi

№	Povratni kod	Opis Kod povrat	Uslovi pojave	Komentar
1	01	Tražene informacije nisu pronađene	Nastaje, pod uslovom da informacije o Yulu nisu pronađene u registru
2	51	Zahtjev je prihvaćen u obradu	Javlja se u slučaju uspješnog zahtjeva za prijem za obradu
3	52	Odgovor nije spreman	Javlja se u slučaju nespremnosti odgovora na uspješno prihvaćen zahtjev	Koristi se u asinhronom zahtjevu
4	53	Informacije o pravnom subjektu / pojedinim poduzetnikom ne mogu se osigurati u elektroničkom obliku	Javlja se ako je nemoguće formirati odgovor na zahtjev elektroničkim obrascem
5	82	Formatiranje logičke kontrole Greška	Javlja se pod uvjetom neuspjeha dokumenta (upit) XSD sheme	Rezerva se ne može koristiti
6	83	Ne postoji zahtjev sa navedenim identifikatorom upita i vrsti traženih informacija od ovog tijela.	Javlja se u situaciji u kojoj je u zahtjevu za zahtjev za ekstrakt za sjaj, netačan (nepoznat) identifikator upita i (ili) zahtjev s takvim identifikatorom nije primio od ovog tijela	Koristi se u asinhronom zahtjevu (po primitku rezultata zahtjeva ECD-a)
9	99	Sistemska greska	Postoji u prisustvu unutrašnjih grešaka na IP savezne porezne službe Rusije

1. Kontrolni primeri

Zahtjev za dobivanje rezultata zahtjeva za ekstrakt za Yul

Odgovor na zahtjev za dobijanje rezultata zahtjeva za ekstrakt za VL, u slučaju, zahtjev još nije obrađen

Odgovor na zahtjev za dobijanje upita za dobivanje ekstrakta za HD sa povratom koda 53

Odgovor na zahtjev za primanje rezultata zahtjeva za ekstrakt za SHA s pogreškom (kôd za obradu nije rezerviran)
(vrijednosti atributa i)

Napomena: Uvjeri za pojavu ove pogreške u testnom okruženju u početku su pokrenute. Ovaj primjer opisuje cjelokupnu logiku i strukturu odziva greške. Prilikom provođenja testova na produktivnom okruženju, vraćajući se potpuno isti odgovor bez osiguravanja potrebnih uvjeta nisu mogući.

Provjera se vrši kako bi se osiguralo da se rezultat i naknadno plaćanje može pravilno obraditi na strani projekta.

S pojednostavljenom integracijom provjeravanje korisničkog ID-a i narudžbe potrebno je dva puta: pri prebacivanju na obrazac za plaćanje i pri odabiru načina plaćanja.

Projekt je potreban:

• URL provjera identifikatora ili korisnički nalog (Navedite u tehničkim postavkama na ličnom računu);
• Rukovatelj koji je sposoban da prihvati i prepoznaje parametre upita iz sistema i reagiraju kako sustav čeka.

Ako provjera identifikatora nakon što se faktura završi s pogreškom, tada se račun neće izlagati, a korisnik je preusmjeren na stranicu za plaćanje na stranici koja je navedena pomoću parametra return_url_fail ili u tehničkim postavkama (ako stranica nije navedena - sustav je sličan sa strane). Stranica za obradu pogreške prilikom plaćanja automatski se šalje na dobivanje metode. err_msg. sa značenjem "Ne postoji takav karakter.".

Zatražite parametre iz sistema na projekt

Sistem se odnosi na projekt u URL provjere identifikatora ili korisničkog naloga navedenog u tehničkim postavkama na ličnom računu.

• metoda prijenosa - POŠTA.;
• kodiranje - UTF-8..

Parametar	Opis parametra	Parametar formata	Privremeni parametar
korisnički broj	Korisnički ID ili narudžbu (jednaka vrijednosti parametra nadimak. u)	string (256)	Da
userid_extra	Za više informacija potrebnih za izvršenje ili prikupljanje statistika na projektu (jednaka vrijednosti parametra nick_extra )	string (500)	Ne
ključ.	Zatražite referentni potpis. Formira se kao hash prema algoritmu MD5 iz spajanja sljedećih parametara: vrijednost parametra korisnički broj, tajni ključni projekat	mD5 (0UseriD0Sext projekt)	Da
iznos.		0	Da
pansion.	Provjerite zahtjev za provjeru. Uzima samo nultu vrijednost (iznos \u003d 0)	0	Da
naručite.	ID plaćanja na projektnom računu (jednak vrijednosti parametra red_id u)	varchar (64)	Ne

Parametri reakcije projekta

Odgovor na zahtjev sistema mora doći na sistemski zahtjev.

Sljedeća pravila koriste se za prijenos parametara zahtjeva:

• format - XML;
• kodiranje - UTF-8..

Parametar	Opis parametra	Parametar formata	Privremeni parametar
Šifra.	Kôd odgovora za zatraženje. Da- Identifikator postoji. Ne br.- Identifikator ne postoji	(ovisan o registru)	Da
komentar	Dešifriranje kôda odgovora na zahtjev. Uzorak teksta: userID parametar nije prošao; validacija je donesena naručivim parametrom; nije prošao ključnu validaciju	string (400)	Ne

Primjer odgovora na zahtjev za provjeru identifikatora korisnika ili nalog

Da

Primjer minimalnog upravljanja upita upita prilikom provjere korisničkog ID-a ili narudžbe

// generiranje funkcije odgovora SendResponse ($ status, $ messux \u003d "") ($ odgovor \u003d ""." \\ n "; $ odgovor. \u003d" "." \\ n "; $ odgovor. \u003d" "$ Status.""." \\ n "; $ odgovor. \u003d" "$ Poruka.""." \\ n "; $ odgovor. \u003d""; Die ($ odgovor);) // Provjera postojanja korisničkog ID-a ili funkcije narudžbe ($ user \u003d" Odaberite Prijava s korisnika u kojem je USR_ID \u003d ". $ Query \u003d mysql_query ($ SQL); IF (MySQL_Error ()) (Povratak FALSE;) IF (mysql_num_rows ($ upit) \u003d\u003d 0) (povratak FALSE;) $ secrekey \u003d "IT \\" s_a_project_secret_word "; $ Projecthash \u003d MD5 ($ _ Post ["iznos"]. $ _ Post ["Userid"]. $ _ Post ["Plati uređaj"]. $ Secrecy); if ($ projecthash \u003d $ _POST [ "NE"]!) (SendResponse ( "Ne", "Zahtjev Potpis za to potrebno.");) Ako (Floatval ($ _ POST [ "Iznos"]) \u003d\u003d 0 && intval ($ _POST ["PLATNIČKI"]) \u003d\u003d 0) (// Zahtjev za provjeru korisničkog ID-a ili ako naručite (Checkiner ($ _ Post ["Userid])) (" Da "," identifikator "); ) Drugo (SendResponse ("Ne", "Identifikator nije pronađen");)))