A mintákba a loginnév, jelszó, aláírás, token, számla adatok, és egyéb nem publikus adatok helyén 'x' karakter láthatunk.
A következő esetekre találunk minta kérést, és választ. Ahol nincs kérés xml, ott hasonló az előtte levő mintákkal.
4.Számla
5.Státusz lekérdezés, Nyugtázott (DONE)
6.Státusz lekérdezés, Visszautasított, hibás, (ABORTED)
7.Státusz lekérdezés, Nyugtázott, figyelmeztetéssel (DONE, WARN)
8.Számla beküldés, Formai/technikai hibás (ERROR)
10.Státusz lekérdezés, Technikai érvénytelenítés' után
Számla nyomtatás előtt lekérdezésre kerül a vevő adószáma.
<QueryTaxpayerRequest>
<header>
<requestId>sERPa_3_81_308_12617</requestId>
<timestamp>2018-07-10T13:02:07.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>x</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumber>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<taxNumber>26209010</taxNumber>
</QueryTaxpayerRequest>
<QueryTaxpayerResponse>
<header>
<requestId>sERPa_3_81_308_12617</requestId>
<timestamp>2018-07-10T13:02:07.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<taxpayerValidity>true</taxpayerValidity>
<taxpayerData>
<taxpayerName>KA&BA CARGO HUNGARY KORLÁTOLT FELELŐSSÉGŰ TÁRSASÁG</taxpayerName>
<taxpayerAddress>
<countryCode>HU</countryCode>
<postalCode>2220</postalCode>
<city>VECSÉS</city>
<streetName>ZRÍNYI</streetName>
<publicPlaceCategory>UTCA</publicPlaceCategory>
<number>28</number>
</taxpayerAddress>
</taxpayerData>
</QueryTaxpayerResponse>
Számla beküldés előtt token kérés történik.
<TokenExchangeRequest>
<header>
<requestId>sERPa_3_81_308_12618</requestId>
<timestamp>2018-07-10T13:02:40.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>x</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumber>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
</TokenExchangeRequest>
<TokenExchangeResponse>
<header>
<requestId>sERPa_3_81_308_12618</requestId>
<timestamp>2018-07-10T13:02:40.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<encodedExchangeToken>x</encodedExchangeToken>
<tokenValidityFrom>2018-07-10T15:01:02.859+02:00</tokenValidityFrom>
<tokenValidityTo>2018-07-10T15:06:02.859+02:00</tokenValidityTo>
</TokenExchangeResponse>
A számla beküldése, ekkor kerül befogadott állapotba, ha átment a validáláson.
<ManageInvoiceRequest>
<header>
<requestId>sERPa_3_81_308_12619</requestId>
<timestamp>2018-07-10T13:02:41.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>wnxq3p6etipwiro</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumber>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<exchangeToken>x</exchangeToken>
<invoiceOperations>
<technicalAnnulment>0</technicalAnnulment>
<compressedContent>0</compressedContent>
<invoiceOperation>
<index>1</index>
<operation>CREATE</operation>
<invoice>x</invoice>
</invoiceOperation>
</invoiceOperations>
</ManageInvoiceRequest>
<ManageInvoiceResponse>
<header>
<requestId>sERPa_3_81_308_12619</requestId>
<timestamp>2018-07-10T13:02:41.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<transactionId>281HQXFOE1ML</transactionId>
</ManageInvoiceResponse>
Két tételes számla, mindkét tétel 1.000.000 nettó egység árral, mennyiségi egység 1, valamint 27% áfával.
<Invoice>
<invoiceExchange>
<invoiceHead>
<supplierInfo>
<supplierTaxNumber>
<taxpayerId>10788110</taxpayerId>
<vatCode>2</vatCode>
<countyCode>43</countyCode>
</supplierTaxNumber>
<communityVatNumber>HU10788110</communityVatNumber>
<supplierName>sERPa Számítástechnikai Kft., Pécsi Kirendeltség</supplierName>
<supplierAddress>
<detailedAddress>
<countryCode>HU</countryCode>
<postalCode>7623</postalCode>
<city>Pécs</city>
<streetName>Szabadság </streetName>
<publicPlaceCategory>utca</publicPlaceCategory>
<number>34.</number>
</detailedAddress>
</supplierAddress>
<supplierBankAccountNumber>FL55101022370667130012345678</supplierBankAccountNumber>
</supplierInfo>
<customerInfo>
<customerTaxNumber>
<taxpayerId>26209010</taxpayerId>
<vatCode>2</vatCode>
<countyCode>13</countyCode>
</customerTaxNumber>
<customerName>KA&BA CARGO HUNGARY Kft.</customerName>
<customerAddress>
<detailedAddress>
<countryCode>HU</countryCode>
<postalCode>2220</postalCode>
<city>Vecsés</city>
<streetName>Zrínyi </streetName>
<publicPlaceCategory>utca</publicPlaceCategory>
<number>28.</number>
</detailedAddress>
</customerAddress>
</customerInfo>
<invoiceData>
<invoiceNumber>2018-A01/000320</invoiceNumber>
<invoiceCategory>AGGREGATE</invoiceCategory>
<invoiceIssueDate>2018-07-10</invoiceIssueDate>
<invoiceDeliveryDate>2018-07-10</invoiceDeliveryDate>
<invoiceAccountingDeliveryDate>2018-07-10</invoiceAccountingDeliveryDate>
<currencyCode>HUF</currencyCode>
<paymentMethod>TRANSFER</paymentMethod>
<cashAccountingIndicator>1</cashAccountingIndicator>
<invoiceAppearance>PAPER</invoiceAppearance>
</invoiceData>
</invoiceHead>
<invoiceLines>
<line>
<lineNumber>1</lineNumber>
<lineDescription>fű1</lineDescription>
<quantity>1.000000</quantity>
<unitOfMeasure> </unitOfMeasure>
<unitPrice>1000000.000000</unitPrice>
<lineAmountsNormal>
<lineNetAmount>1000000.00</lineNetAmount>
<lineVatRate>
<vatPercentage>0.270000</vatPercentage>
</lineVatRate>
<lineVatAmount>270000.00</lineVatAmount>
<lineVatAmountHUF>270000.00</lineVatAmountHUF>
<lineGrossAmountNormal>1270000.00</lineGrossAmountNormal>
</lineAmountsNormal>
<aggregateInvoiceLineData>
<lineDeliveryDate>2018-07-10</lineDeliveryDate>
</aggregateInvoiceLineData>
</line>
<line>
<lineNumber>2</lineNumber>
<lineDescription>fű2</lineDescription>
<quantity>1.000000</quantity>
<unitOfMeasure> </unitOfMeasure>
<unitPrice>1000000.000000</unitPrice>
<lineAmountsNormal>
<lineNetAmount>1000000.00</lineNetAmount>
<lineVatRate>
<vatPercentage>0.270000</vatPercentage>
</lineVatRate>
<lineVatAmount>270000.00</lineVatAmount>
<lineVatAmountHUF>270000.00</lineVatAmountHUF>
<lineGrossAmountNormal>1270000.00</lineGrossAmountNormal>
</lineAmountsNormal>
<aggregateInvoiceLineData>
<lineDeliveryDate>2018-07-11</lineDeliveryDate>
</aggregateInvoiceLineData>
</line>
</invoiceLines>
<invoiceSummary>
<summaryNormal>
<summaryByVatRate>
<vatRate>
<vatPercentage>0.270000</vatPercentage>
</vatRate>
<vatRateNetAmount>2000000.00</vatRateNetAmount>
<vatRateVatAmount>540000.00</vatRateVatAmount>
<vatRateVatAmountHUF>540000.00</vatRateVatAmountHUF>
</summaryByVatRate>
<invoiceNetAmount>2000000.00</invoiceNetAmount>
<invoiceVatAmount>540000.00</invoiceVatAmount>
<invoiceVatAmountHUF>540000.00</invoiceVatAmountHUF>
</summaryNormal>
<invoiceGrossAmount>2540000.00</invoiceGrossAmount>
</invoiceSummary>
</invoiceExchange>
</Invoice>
Hibátlan számla, amely DONE-t add vissza, vagyis Nyugtázott, nincs vele dolgunk.
<QueryInvoiceStatusRequest>
<header>
<requestId>sERPa_3_81_308_12620</requestId>
<timestamp>2018-07-10T13:02:57.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>wnxq3p6etipwiro</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumber>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<transactionId>281HQXFOE1ML</transactionId>
</QueryInvoiceStatusRequest>
<QueryInvoiceStatusResponse>
<header>
<requestId>sERPa_3_81_308_12620</requestId>
<timestamp>2018-07-10T13:02:57.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<processingResults>
<processingResult>
<index>1</index>
<invoiceStatus>DONE</invoiceStatus>
<compressedContentIndicator>false</compressedContentIndicator>
</processingResult>
</processingResults>
</QueryInvoiceStatusResponse>
Egy számlát duplán akarjuk beküldeni, pl másik programból, ugyan azt a számlát, bizonylatot.
-
<QueryInvoiceStatusResponse>
<header>
<requestId>sERPa_3_81_308_12638</requestId>
<timestamp>2018-07-10T13:34:15.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<processingResults>
<processingResult>
<index>1</index>
<invoiceStatus>ABORTED</invoiceStatus>
<businessValidationMessages>
<validationResultCode>ERROR</validationResultCode>
<validationErrorCode>INVOICE_NUMBER_NOT_UNIQUE</validationErrorCode>
<message>A megadott számla sorszámmal már történt adatszolgáltatás.</message>
</businessValidationMessages>
<compressedContentIndicator>false</compressedContentIndicator>
</processingResult>
</processingResults>
</QueryInvoiceStatusResponse>
Hibátlan számla, amely DONE+WARN-t add vissza, vagyis Nyugtázott, nincs vele dolgunk, de azért nézzünk rá.
-
<QueryInvoiceStatusResponse>
<header>
<requestId>sERPa_3_81_308_11833</requestId>
<timestamp>2018-07-01T09:26:56.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<processingResults>
<processingResult>
<index>1</index>
<invoiceStatus>DONE</invoiceStatus>
<businessValidationMessages>
<validationResultCode>WARN</validationResultCode>
<validationErrorCode>MISSING_PRODUCT_FEE_DATA_LINE_OBLIGATED_CONTENT_EMPTY</validationErrorCode>
<message>Tétel(ek) termékdíjra vonatkozó adata(i) nincs(enek) kitöltve.</message>
<pointer>
<tag>Invoice/invoiceExchange/invoiceLines/line/obligatedForProductFee</tag>
<value>true</value>
<line>1</line>
</pointer>
</businessValidationMessages>
<businessValidationMessages>
<validationResultCode>WARN</validationResultCode>
<validationErrorCode>MISSING_PRODUCT_FEE_DATA_LINE_OBLIGATED_SUMMARY_EMPTY</validationErrorCode>
<message>Termékdíj összesítő nincs kitöltve.</message>
<pointer>
<tag>Invoice/invoiceExchange/invoiceLines/line/obligatedForProductFee</tag>
<value>true</value>
<line>1</line>
</pointer>
</businessValidationMessages>
<compressedContentIndicator>false</compressedContentIndicator>
</processingResult>
</processingResults>
</QueryInvoiceStatusResponse>
Már beküldött számla amit a NAV az elsődleges ellenőrzéssel kiszűrt és így nem is fogadta be. A kérésben szereplő operációk típusa nem megengedett!
A példában szereplő válasz még a korai fejlesztési fázisban történ, ilyet már nem lehet generálni.
Ha ilyen küldés akarunk végezni akkor a jelszó helytelen megadása után is: válasz 2.
<GeneralErrorResponse>
<header>
<requestId>322_465</requestId>
<timestamp>2018-06-13T11:00:07.311Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>ERROR</funcCode>
<errorCode>INVALID_OPERATION</errorCode>
<message>A kérésben szereplő operációk típusa nem megengedett!</message>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
</GeneralErrorResponse>
<GeneralErrorResponse>
<result>
<funcCode>ERROR</funcCode>
<errorCode>INVALID_REQUEST</errorCode>
<message>Helytelen kérés!</message>
</result>
<technicalValidationMessages>
<validationResultCode>ERROR</validationResultCode>
<validationErrorCode>SCHEMA_VIOLATION</validationErrorCode>
<message>Field [login] contains error: [The value 'x' of element 'login' is not valid.]</message>
</technicalValidationMessages>
</GeneralErrorResponse>
Művelet: Online számla érvénytelenítése (Technikai érvénytelenítés típus)
<ManageInvoiceRequest>
<header>
<requestId>sERPa_3_81_308_12622</requestId>
<timestamp>2018-07-10T13:03:07.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>wnxq3p6etipwiro</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumber>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<exchangeToken>x</exchangeToken>
<invoiceOperations>
<technicalAnnulment>1</technicalAnnulment>
<compressedContent>0</compressedContent>
<invoiceOperation>
<index>1</index>
<operation>ANNUL</operation>
<invoice>x/invoice>
</invoiceOperation>
</invoiceOperations>
</ManageInvoiceRequest>
<ManageInvoiceResponse>
<header>
<requestId>sERPa_3_81_308_12622</requestId>
<timestamp>2018-07-10T13:03:07.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<transactionId>281HRHZQIKS8</transactionId>
</ManageInvoiceResponse>
<Invoice>
<invoiceAnnulment>
<annulmentReference>2018-A01/000320</annulmentReference>
<annulmentTimestamp>2018-07-10T13:03:07.596Z</annulmentTimestamp>
<annulmentCode>ERRATIC_DATA</annulmentCode>
<annulmentReason>Teszt</annulmentReason>
</invoiceAnnulment>
</Invoice>
Még nincs jóváhagyva a webes felületen. Info üzenet: Egyedi számla technikai érvénytelenítése.
<QueryInvoiceStatusRequest>
<header>
<requestId>sERPa_3_81_308_12635</requestId>
<timestamp>2018-07-10T13:32:52.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<user>
<login>wnxq3p6etipwiro</login>
<passwordHash>x</passwordHash>
<taxNumber>10788110</taxNumberx>
<requestSignature>x</requestSignature>
</user>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<transactionId>281ITLTJNQJ0</transactionId>
</QueryInvoiceStatusRequest>
<QueryInvoiceStatusResponse>
<header>
<requestId>sERPa_3_81_308_12635</requestId>
<timestamp>2018-07-10T13:32:52.000Z</timestamp>
<requestVersion>1.0</requestVersion>
<headerVersion>1.0</headerVersion>
</header>
<result>
<funcCode>OK</funcCode>
</result>
<software>
<softwareId>HU10788110SERPA003</softwareId>
<softwareName>sERPa</softwareName>
<softwareOperation>LOCAL_SOFTWARE</softwareOperation>
<softwareMainVersion>3.0</softwareMainVersion>
<softwareDevName>ProgEn</softwareDevName>
<softwareDevContact>serpasupport@progen.hu</softwareDevContact>
</software>
<processingResults>
<processingResult>
<index>1</index>
<invoiceStatus>DONE</invoiceStatus>
<businessValidationMessages>
<validationResultCode>INFO</validationResultCode>
<message>Egyedi számla technikai érvénytelenítése</message>
<pointer>
<tag>Invoice/invoiceExchange/invoiceHead/invoiceData/invoiceNumber</tag>
<value>2018-A01/000320</value>
</pointer>
</businessValidationMessages>
<compressedContentIndicator>false</compressedContentIndicator>
</processingResult>
</processingResults>
</QueryInvoiceStatusResponse>