Skip to content
logo
platformaerp.com

VAT API

VAT API sprawdza status polskiego kontrahenta w wykazie podmiotów zarejestrowanych jako podatnicy VAT, niezarejestrowanych oraz wykreślonych i przywróconych do rejestru VAT, https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka#

1. DB Objects

SQL
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
        CREATE TABLE [dbo].[vat] (
            [vat_id] [int] IDENTITY(1,1) NOT NULL,
            [vat_nip] [varchar](20) NULL,
            [vat_date] [date] NULL,
            [vat_status] [varchar](50) NULL,
            [vat_body] [xml] NULL,
         CONSTRAINT [PK_vat] PRIMARY KEY CLUSTERED
        (
            [vat_id] ASC
        ))

10 REST API

10.1 Weryfikacja status pojedynczego podatnika i opcjonalnie konta bankowego JSON

"vat_status":"INVALID Bank Account" - nieprawidłowe konto

Request

  • Wymagany obiekt [dbo].[vat] w paanda.db
  • jęsli app_name wtedy [dbo].[vat] wymagany w domyślnym połączeniu
  • zastepowane sa item.Replace(" ", "").Replace("-", "").Replace("PL", "")
HTTP
1
2
GET {{host}}/api/erp/vat/get-data/{VATNumber}/{AccountNumber?}?app_name={optional}
Authorization: Basic api:{{APItoken}}

Response

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
   "vat_nip":"7272351852",
   "vat_date":"2020-10-21",
   "vat_status":"Czynny",
   "vat_data":{
      "Subject":{
         "Name":"XXXXX XXXXX",
         "Nip":"7272351852",
         "StatusVat":"Czynny",
         "Regon":"100522920",
         "ResidenceAddress":"XXXXX XXXXX XXXXX, XXXXX-XXXXX XXXXX",
         "RegistrationLegalDate":null,
         "RestorationBasis":"Art. 96 ust. 9h",
         "RestorationDate":null,
         "AccountNumbers":{
            "string":"56114020040000310277283312"
         },
         "HasVirtualAccounts":"false"
      }
   }
}

10.2 Weryfikacja status pojedynczego podatnika i opcjonalnie konta bankowego BADGE

  • "vat_status":"INVALID Bank Account" - nieprawidłowe konto
  • "vat_status":"Czynny" - OK
  • Wymagany obiekt [dbo].[vat] w paanda.db

Request

Http

HTTP
1
2
GET {{host}}/api/erp/vat/get-badge/{VATNumber}/{AccountNumber?}
Authorization: Basic api:{{APItoken}}

HTML

HTML
1
<img src="/api/erp/vat/get-badge/{VATNumber}/{AccountNumber?}" class="w3-image"  alt="STATUS VAT">

Markdown

Markdown
1
![STATUS VAT](/api/erp/vat/get-badge/{VATNumber}/{AccountNumber?})

Response

IMAGE

10.3 Aktualizacja statusu VAT dla platformaERP

System weryfikuje status podatnika raz na 3 dni.

  • Wymagany obiekt [dbo].[vat] w połaczeniu
  • Wymagany obiekt [firm].[firm] w połączeniu

Request

Http

HTTP
1
2
GET {{host}}/api/erp/vat/check/{app_name}
Authorization: Basic api:{{APItoken}}

HTML

HTML
1
<img src="/api/erp/vat/check/{app_name}" class="w3-image"  alt="STATUS VAT">

Markdown

Markdown
1
2
3
4
![STATUS VAT](/api/erp/vat/check/{app_name})

Można używać w textarea
![STATUS VAT](/api/erp/vat/check/[[app_name]])

Request

Badge with information

  • VAT:OK - dane aktualne
  • VAT:OK(number) - ilość sprawdzonych podaczas sesji
  • VAT:(status błedu) - informacja o błedzie
HTML
1
<img src="/api/erp/vat/check/platformaerp" title="VAT API Status"/>

10.4 Pobieranie z rejestru REGON (nowy)

Request

HTTP
1
/api/erp/vat/get-data-gus/{VAT}

Response

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
   "Regon":"XXXX",
   "Nip":"XXXX",
   "Nazwa":"XXXX",
   "Wojewodztwo":"XXXX",
   "Powiat":"XXXX",
   "Gmina":"XXXX-XXXX",
   "Miejscowosc":"XXXX",
   "KodPocztowy":"00-000",
   "Ulica":"ul. XXX XXXX",
   "NrNieruchomosci":"111",
   "NrLokalu":"",
   "Typ":"F",
   "SilosID":1,
   "MiejscowoscPoczty":"XXXX"
}

10.5 UWAGA wycofany, obsolete / Pobieranie z rejestru REGON

Uwaga Wymagany dostęp do instancji master platformaerp

Request

HTTP
1
/api/regon/nip/{vat}
JSON
1
2
3
4
5
6
{"Name":"XXXXXXXx",
"Regon":"XXXX",
"Nip":"XXXX",
"City":"XXX",
"ZipCode":"00-000",
"Street":"ul. XXXXX"}