Inköpsfaktura hämtning getpurchaseinvoice.nv

Resurs: getpurchaseinvoice.nv

HTTP-metod: GET
Hämtar detaljerade uppgifter om önskad inköpsfaktura.

Parametrar som används i frågan:

| Parameter | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- |
| netvisorkey | 1 | Fakturans identifierare i Netvisor. | 123 |
| netvisorkeylist | 0...1 | Returnerar i en enda begäran fullständiga uppgifter om inköpsfakturor, max. 500 ID:n.
Maximal längd för begärans URI är 2115 tecken. | 1,2,3 |
| version | 0...1 | Returnerar en enskild fakturarads (PurchaseInvoiceLine) Kostnadsobjekt inne i fakturradselementet
1 = Kostnadsobjekt utanför fakturraderna, används som standard eller om parametern inte anges
2 = Kostnadsobjekt inne i fakturraderna
​ | 2 |
| include | 0...1 | - actions = Returnerar vad som kan göras med inköpsfakturan (sakgranskare, godkänna, avvisa, betalningsklar)
​- handlinghistory = Returnerar inköpsfakturans hanteringshistorik
- previewimage = Returnerar en förhandsgranskningsbild av inköpsfakturan
- invoiceimage = Returnerar inköpsfakturans ursprungliga PDF-bilaga eller, om den saknas, en PDF genererad från e-faktura-meddelandet
- circulationlist = Returnerar fakturaspecifik cirkulationslista
- finvoice - Returnerar inköpsfakturans Finvoice-material. Returnerar materialet endast om inköpsfakturan har anlänt som e-faktura | actions |
| omitattachments | 0...1 | True = Inga bilagor för inköpsfakturan returneras
​False = Bilagor för inköpsfakturan returneras
Om parametern inte anges eller värdet är tomt = False
​ | true |

Svar:

| Nivå | Element | Format | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| root | Root | Aggregat | 1 | | |
| 1 | PurchaseInvoice | Aggregat | 1 | | |
| 2 | PurchaseInvoiceNetvisorKey | Sträng | 1 | Fakturans Netvisor ID | 1025 |
| 2 | PurchaseInvoiceNumber | Sträng | 1 | Fakturanummer | 345 |
| 2 | PurchaseInvoiceDate | Datum | 1 | Fakturadatum | 2021-10-02 |
| Attr. | format | Sträng | 1 | Datumformat, alltid ansi | ansi |
| 2 | PurchaseInvoiceEventDate | Datum | 1 | Fakturans bokföringsdatum | 2021-10-02 |
| Attr. | format | Sträng | 1 | Bokföringsdatumets format, alltid ansi | ansi |
| 2 | PurchaseInvoiceDeliveryDate | Datum | 1 | Fakturans leveransdatum | 2021-10-04 |
| Attr. | format | Sträng | 1 | Leveransdatumets format, alltid ansi | ansi |
| 2 | PurchaseInvoiceDueDate | Datum | 1 | Fakturans förfallodag | 2021-10-31 |
| Attr. | format | Sträng | 1 | Förfallodagens format, alltid ansi | ansi |
| 2 | PurchaseInvoiceValueDate | Datum | 1 | Fakturans valutadag | 2021-10-15 |
| Attr. | format | Sträng | 1 | Valutadagens format, alltid ansi | ansi |
| 2 | PurchaseInvoiceReferencenumber | Sträng | 1 | Fakturans referensnummer | 12594 |
| 2 | PurchaseInvoiceAgreementIdentifier | Sträng | 1 | Avtalsidentifierare | 123 |
| 2 | PurchaseInvoiceVendorBankAccountNumber | Sträng | 1 | Leverantörens bankkontonummer | ​ |
| 2 | IsPurchaseInvoiceVendorBankAccountDeleted | Sträng | 1 | True eller False. Anger om bankkontot har raderats. | False |
| 2 | IsPurchaseInvoiceVendorBankAccountFromSEPARegion | Sträng | 1 | True eller False. Anger om bankkontot är från SEPA-området. | True |
| 2 | PurchaseInvoiceAmount | Numerisk | 1 | Fakturabeloppet med två decimaler | 123,45 |
| 2 | PurchaseInvoicePaidAmount | Numerisk | 1 | Belopp betalt på fakturan med två decimaler | 100,00 |
| 2 | ForeignCurrencyAmount | Numerisk | 1 | Fakturans valutabelopp | 123,45 |
| 2 | ForeignCurrencyNameID | Sträng | 1 | Valutakod | EUR |
| 2 | InvoiceStatus | Sträng | 1 | Fakturans status
Öppen,Betald,Förfallen,Allokerad
Inte allokerad
​ | Öppen |
| 2 | ApprovalStatus | Sträng | 1 | Fakturans godkännandestatus:
ny faktura = open
i sakgranskning = infactualverification
i godkännande = approved
godkänd = accepted
avvisad = acceptorrejected | open |
| 2 | PurchaseInvoiceOurReference | Sträng | 1 | Vår referens | 012594 |
| 2 | PurchaseInvoiceYourReference | Sträng | 1 | Er referens | 112594 |
| 2 | PurchaseInvoiceDescription | Sträng | 1 | Ytterligare information om fakturan | |
| 2 | VendorNetvisorKey | Numerisk | 1 | Leverantörens NetvisorKey | 123 |
| 2 | VendorOrganizationIdentifier | Sträng | 1 | Leverantörens fo-nummer | 1234567-8 |
| 2 | VendorCode | Sträng | 1 | Leverantörskod | 23 |
| 2 | VendorName | Sträng | 1 | Leverantörens namn | Vendor Oy Ab |
| 2 | VendorAddressLine | Sträng | 1 | Leverantörens adress | |
| 2 | VendorPostNumber | Sträng | 1 | Leverantörens postadress | |
| 2 | VendorTown | Sträng | 1 | Leverantörens postanstalt | |
| 2 | VendorCountry | Sträng | 1 | Leverantörens landskod | |
| 2 | Fingerprint | Sträng | 1 | Fakturans identifierare | 606F6527D9CAF4BB7B69E4D616FAA78637552960A810FD3B5CC04BFEB6757D4C |
| 2 | VoucherID | Numerisk | 1 | Inköpsfakturans verifikats NetvisorKey. Returnerar en tom tagg om fakturan ännu inte har konterats och verifikat inte har skapats. | 1123 |
| 2 | IsAccounted | Sträng | 1 | Om inköpsfakturan är konterad | True |
| 2 | PreviewImage | Sträng | 0...n | När parametern include = previewimage används
​ | |
| Attr. | AttachmentNetvisorKey | Numerisk | 1 | Bilageidentifierare för fakturabilden | 123 |
| 2 | InvoiceImage | Sträng | 0..n | Base64-kodad fakturabild i PDF-format, när parametern include = invoiceimage används | ​ |
| Attr. | AttachmentNetvisorKey | Numerisk | 1 | Bilageidentifierare för fakturabilden | 123 |
| 2 | Attachments | Aggregat | 0...1 | | |
| 3 | Attachment | Aggregat | 1...n | | |
| 4 | AttachmentBase64Data | Sträng | 1 | Bilagans Base64-kodade data | |
| 4 | FileName | Sträng | 1 | Filnamn för bilagan | Faktura12594.pdf |
| 4 | ContentType | Sträng | 1 | Bilagans MIME-typ | Application/pdf |
| 4 | Comment | Sträng | 1 | Kommentar till bilagan | |
| 2 | InvoiceLines | Aggregat | 0...1 | | Hämtar inköpsfakturans konteringsrader |
| 3 | PurchaseInvoiceLine | Aggregat | 1...n | | |
| 4 | NetvisorKey | Numerisk | 1 | Radens NetvisorKey | |
| 4 | LineSum | Numerisk | 1 | Radsumma inklusive moms
​ | |
| 4 | LineNetSum | Numerisk | 1 | Radsumma exklusive moms | |
| 4 | UnitPrice | Numerisk | 1 | Enhetspris (inklusive moms) | |
| 4 | VatPercent | Numerisk | 1 | Momsprocent | |
| 4 | VatCode | Sträng | 1 | Moms-kod | |
| 4 | Description | Sträng | 0...1 | Radförklaring | |
| 4 | Unit | Sträng | 0...1 | Måttenhet | |
| 4 | OrderedAmount | Numerisk | 1 | Beställd mängd produkter | |
| 4 | PurchasePrice | Numerisk | 1 | Föråldrat element, returnerar ingenting | |
| 4 | DeliveredAmount | Numerisk | 1 | Levererad mängd produkter | |
| 4 | ProductCode | Sträng | 1 | Produktkod | |
| 4 | DiscountPercentage | Numerisk | 1 | Rabattprocent | |
| 4 | ProductName | Sträng | 1 | Benämning | |
| 4 | AccountingSuggestionBookkeeping
AccountNetvisorKey | Sträng | 0...1 | Konto för konteringsförslagets Netvisorkey | |
| 4 | AccountingSuggestionBookkeepingAccount | Sträng | 0...1 | Konto för konteringsförslag | |
| 4 | PurchaseInvoiceLineDimensions | Aggregat | 0...1 | Nivåer 4 -5 -6 när version-parametern är 2
Annars nivåer 3-4-5
​ | |
| 5 | Dimension | Aggregat | 1...n | | |
| 6 | DimensionName | Sträng | 1 | Kostnadsobjektrubrik | Project |
| 6 | DimensionNameNetvisorKey | Sträng | 1 | Kostnadsobjektrubrikens Netvisor ID | 2 |
| 6 | DimensionDetailName | Sträng | 1 | Kostnadsobjekt | Project 1 |
| 6 | DimensionDetailCode | Sträng | 0...1 | Kostnadsobjektets identifierare | P001 |
| 6 | DimensionDetailNetvisorKey | Sträng | 1 | Kostnadsobjektets Netvisor ID | 95 |
| 2 | LinkedPurchaseOrders | Aggregat | 0...1 | Om inköpsfakturan har kopplade inköpsorder returneras deras nummer och ID:n | |
| 3 | PurchaseOrder | Aggregat | 1...n | | |
| 4 | OrderNumber | Sträng | 1 | Inköpsorderns nummer | 123 |
| 4 | NetvisorKey | Sträng | 0...1 | Inköpsorderns NetvisorID
Obs. Om inköpsorderns nummer har matats in i inköpsfakturan i förväg finns inköpsordern ännu inte i systemet | 10 |

När parametern actions används läggs följande struktur till i slutet av meddelandet:

| Nivå | Element | Format | Förekomster | Beskrivning | Exempel |
| --- | --- | --- | --- | --- | --- |
| 2 | PostingLinesAccess | Aggregat | 1 | Inköpsfakturans kontering | |
| 3 | CanEditPostingLines | Sträng | 1 | | True |
| 3 | CanUserPostInvoice | Sträng | 1 | | False |
| 3 | SuggestPostingByDefault | Sträng | 1 | | True |
| 3 | CanEditAccountingSuggestion | Sträng | 1 | | False |
| 2 | Actions | Aggregat | 1 | Vad som kan göras med fakturan med användarens rättigheter
​ | |
| 3 | Action | Aggregat | 1...n | | |
| 4 | Id | Sträng | 1 | Möjliga värden:
approved
accepted
reject
pay
​ | accepted |
| 4 | Type | Sträng | 1 | Anger resursen som ska användas för att utföra action
​ | purchaseinvoicepostingdata |
| 4 | Description | Sträng | 1 | Förklaring av åtgärden | Godkänn faktura |
| 2 | Alerts | Aggregat | 1 | Om det inte finns några varningar visas endast taggen på översta nivån | |
| 3 | Alert | Aggregat | 1 | | |
| 4 | Heading | Sträng | 1 | Rubrik | Fakturan ligger på låst period |
| 4 | Description | Sträng | 1 | Förklaring | Godkännande av fakturan uppdaterar inte fakturans uppgifter eftersom fakturan tillhör en låst period |
| 2 | Notifications | Aggregat | 1 | Om det inte finns några notifieringar visas endast taggen på översta nivån | |
| 3 | Notification | Aggregat | 1 | | |
| 4 | Heading | Sträng | 1 | Rubrik | |
| 4 | Description | Sträng | 1 | Förklaring | Leverantörens bankkonto har raderats, uppdatera bankkontot |

När parametern handlinghistory används läggs följande struktur till i slutet av meddelandet:

​

*Om parametern netvisorkeylist används och svaret returnerar fler än en inköpsfaktura, får svaret ett extra PurchasesInvoices-aggregat, i övrigt följer svaret samma modell:

Denna artikel har översatts med hjälp av ett AI-baserat översättningsverktyg. Innehållet eller formuleringen i dessa instruktioner kan avvika från dem i andra instruktioner eller i programvaran.