Rejestracja podmiotu gospodarczego
Przykład
POST https://idissuer.pl/api/v3/registries/economic-operators/requests/registration
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
{
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": "",
"nip": "12345678901",
"exciseNumber": ""
},
"foreignIssuerIds": null,
"registrantType": "Self",
"thirdPartyId": "",
"optionalId": "",
"extensibility": ""
}
Odpowiedź
HTTP/1.1 201 Created
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"economicOperatorRegisterRequestId": 4
}
Przykład 2
POST https://idissuer.pl/api/v3/registries/economic-operators/requests/registration
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
{
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": "",
"nip": "12345678901",
"exciseNumber": ""
},
"foreignIssuerIds": [
"OtherEOIdentifier"
],
"registrantType": "ThirdParty",
"thirdPartyId": "ThirdPartyId",
"optionalId": "Optional",
"extensibility": "additionalInfo"
}
Pobranie szczegółów wniosku o rejestrację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/registration/5
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"requestId": 5,
"status": "Accepted",
"economicOperatorId": "DEV10000005",
"createdOn": "2024-01-12T14:42:34.4923552+00:00",
"createdBy": "user@test.pl",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [
"OtherEOIdentifier"
],
"registrant": {
"type": "ThirdParty",
"thirdPartyId": "ThirdPartyId"
},
"optionalId": "Optional",
"extensibility": "additionalInfo"
}
Wyszukanie wniosków o rejestrację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/registration?status=Accepted
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Dopuszczalne parametry wyszukiwania
economicOperatorId - identyfikator podmiotu
status - Status wniosku
createdBy - użytkownik składający wniosek
createdOnFrom - Data rejestracji "od"
createdOnTo - Data rejestracji "do"
pageNumber - numer wybranej strony
pageSize - ilość rekordów na stronę (max 100)
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"items": [
{
"requestId": 5,
"status": "Accepted",
"economicOperatorId": "DEV10000005",
"createdOn": "2024-01-12T14:42:34.4923552+00:00",
"createdBy": "user@test.pl",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [
"OtherEOIdentifier"
],
"registrant": {
"type": "ThirdParty",
"thirdPartyId": "ThirdPartyId"
},
"optionalId": "Optional",
"extensibility": "additionalInfo"
},
{
"requestId": 4,
"status": "Accepted",
"economicOperatorId": "DEV10000004",
"createdOn": "2024-01-12T14:07:06.8156794+00:00",
"createdBy": "user@test.pl",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [],
"registrant": {
"type": "Self",
"thirdPartyId": null
},
"optionalId": null,
"extensibility": null
}
],
"totalItemsCount": 2,
"pagesCount": 1,
"pageNumber": 1,
"pageSize": 25
}
Pobranie szczegółów podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/api/v3/registries/economic-operators/DEV10000005
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [
"OtherEOIdentifier"
],
"registrant": {
"type": "ThirdParty",
"thirdPartyId": "ThirdPartyId"
},
"extensibility": "additionalInfo",
"optionalId": "Optional"
}
Wyszukanie podmiotów gospodarczych
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators?countryCode=PL
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Dopuszczalne parametry wyszukiwania
primaryName - nazwa podmiotu
alternativeName - nazwa alternatywna
nip - numer NIP
vatUE - numer VAT UE
address - adres podmiotu
countryCode - kraj podmiotu
status - Status
createdOnFrom - Data rejestracji "od"
createdOnTo - Data rejestracji "do"
pageNumber - numer wybranej strony
pageSize - ilość rekordów na stronę (max 100)
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"items": [
{
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [
"OtherEOIdentifier"
],
"registrant": {
"type": "ThirdParty",
"thirdPartyId": "ThirdPartyId"
},
"status": "Active",
"extensibility": "additionalInfo",
"optionalId": "Optional"
},
{
"economicOperatorId": "DEV10000004",
"confirmationCode": "56f7112a",
"name": {
"primary": "Primary name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [],
"registrant": {
"type": "Self",
"thirdPartyId": null
},
"status": "Active",
"extensibility": null,
"optionalId": null
}
],
"totalItemsCount": 2,
"pagesCount": 1,
"pageNumber": 1,
"pageSize": 25
}
Aktualizacja podmiotu gospodarczego
Przykład
POST https://idissuer.pl/api/v3/registries/economic-operators/requests/edit
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
{
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"name": {
"primary": "Changed name",
"alternative": "Alternative name"
},
"address": {
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": "",
"nip": "12345678901",
"exciseNumber": ""
},
"foreignIssuerIds": null,
"registrantType": "Self",
"thirdPartyId": "",
"optionalId": "",
"extensibility": ""
}
Odpowiedź
HTTP/1.1 201 Created
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"economicOperatorEditRequestId": 7
}
Pobranie szczegółów wniosku o aktualizację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/edit/7
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"requestId": 7,
"status": "Accepted",
"cancellationReason": null,
"createdOn": "2024-01-15T10:18:16.7163818+00:00",
"createdBy": "user@test.pl",
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"name": {
"primary": "Changed name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [],
"registrant": {
"type": "Self",
"thirdPartyId": null
},
"extensibility": null,
"optionalId": null
}
Wyszukanie wniosków o aktualizację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/edit?status=Accepted
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Dopuszczalne parametry wyszukiwania
economicOperatorId - identyfikator podmiotu
status - Status wniosku
createdBy - użytkownik składający wniosek
createdOnFrom - Data rejestracji "od"
createdOnTo - Data rejestracji "do"
pageNumber - numer wybranej strony
pageSize - ilość rekordów na stronę (max 100)
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"items": [
{
"requestId": 7,
"status": "Accepted",
"cancellationReason": null,
"createdOn": "2024-01-15T10:18:16.7163818+00:00",
"createdBy": "user@test.pl",
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"name": {
"primary": "Changed name",
"alternative": "Alternative name"
},
"address": {
"hasSingleValueOnly": false,
"singleValue": "Street 1 City 123456",
"street": "Street",
"houseNumber": "1",
"city": "City",
"postalCode": "123456",
"countryCode": "PL",
"additionalInfo": ""
},
"email": "test@test.pl",
"taxData": {
"vatUE": null,
"nip": "12345678901",
"exciseNumber": null
},
"foreignIssuerIds": [],
"registrant": {
"type": "Self",
"thirdPartyId": null
},
"extensibility": null,
"optionalId": null
}
],
"totalItemsCount": 1,
"pagesCount": 1,
"pageNumber": 1,
"pageSize": 25
}
Dezaktywacja podmiotu gospodarczego
Przykład
POST https://idissuer.pl/api/v3/registries/economic-operators/requests/deregistration
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
{
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"registrantType": "Self",
"thirdPartyId": "",
"extensibility": ""
}
Odpowiedź
HTTP/1.1 201 Created
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"economicOperatorDeregisterRequestId": 9
}
Pobranie szczegółów wniosku o derejestrację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/deregistration/7
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"requestId": 9,
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"requestStatus": "Accepted",
"cancellationReason": null,
"createdOn": "2024-01-15T11:24:06.481702+00:00",
"createdBy": "user@test.pl",
"extensibility": null,
"registrant": {
"type": "Self",
"thirdPartyId": null
}
}
Wyszukanie wniosków o derejestrację podmiotu gospodarczego
Przykład
GET https://idissuer.pl/api/v3/registries/economic-operators/requests/deregistration?status=Accepted
Content-Type: application/json
Authorization: Bearer {{AUTH_TOKEN}}
Dopuszczalne parametry wyszukiwania
economicOperatorId - identyfikator podmiotu
status - Status wniosku
createdBy - użytkownik składający wniosek
createdOnFrom - Data rejestracji "od"
createdOnTo - Data rejestracji "do"
pageNumber - numer wybranej strony
pageSize - ilość rekordów na stronę (max 100)
Odpowiedź
HTTP/1.1 200 OK
Connection: close
Date: Mon, 15 Jan 2024 11:29:20 GMT
Content-Type: application/json; charset=utf-8
{
"items": [
{
"requestId": 9,
"economicOperatorId": "DEV10000005",
"confirmationCode": "f01fbefb",
"requestStatus": "Accepted",
"cancellationReason": null,
"createdOn": "2024-01-15T11:24:06.481702+00:00",
"createdBy": "user@test.pl",
"extensibility": null,
"registrant": {
"type": "Self",
"thirdPartyId": null
}
}
],
"totalItemsCount": 1,
"pagesCount": 1,
"pageNumber": 1,
"pageSize": 25
}